@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.11

package/dist/ai/runtime/ai-tool-loop.js

@@ -0,0 +1,207 @@
+"use strict";
+// =============================================================================
+// The function-calling agent loop (issue #432, epic #419)
+// =============================================================================
+//
+// `AiUserClient.runTools()` is this function bound to the facade's gated
+// `respond`, so every round-trip passes every gate and records its own usage
+// row. The loop:
+//
+//   1. call the model with the tools;
+//   2. no `function_call` in the output -> done (`completed`);
+//   3. otherwise, for each call: validate the arguments with the tool's own
+//      Zod schema, run it (per-tool timeout, the caller's signal), and turn
+//      the outcome into a `function_call_output` string. NOTHING THROWS
+//      HERE: invalid arguments, an unknown tool, a tool that throws or times
+//      out are all fed back to the model as text, so it can correct itself;
+//   4. send the outputs back so the provider sees the calls it made, one of
+//      two ways, decided per round by the provider that answered (#446):
+//        - CHAINED (the default): only the new `function_call_output`s, with
+//          `previousResponseId` naming the response that asked for them —
+//          the provider already holds everything before it;
+//        - FULL HISTORY, for a provider declaring
+//          `supportsPreviousResponseId: false` (Anthropic, which stores
+//          nothing): the original input, then every round's model output
+//          replayed as input (`message` as an assistant message,
+//          `function_call` and `reasoning` as themselves — the latter with
+//          its opaque provider state, see `AI_PROVIDER_STATE`), then its
+//          tool outputs. Hosted-tool items are not replayed: the provider ran
+//          them, and a stateless provider has none of ours to run;
+//   5. stop after `maxSteps` round-trips (`steps_exhausted`), leaving the
+//      last round's calls unexecuted: there is no round-trip left to hand
+//      their results to.
+//
+// Tool arguments are UNTRUSTED model output. `execute` only ever sees values
+// its schema accepted, plus the `userId` it must scope every access to.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_TOOL_OUTPUT_MAX_CHARS = void 0;
+exports.runToolLoop = runToolLoop;
+const ai_error_1 = require("../core/ai-error");
+const conversation_1 = require("../core/conversation");
+const ai_runtime_types_1 = require("./ai-runtime.types");
+/** A tool's result is fed back as this much text at most. */
+exports.AI_TOOL_OUTPUT_MAX_CHARS = 32_000;
+async function runToolLoop(respond, req, ctx) {
+    const { tools, maxSteps: requestedSteps, toolTimeoutMs, onStep, ...base } = req;
+    const maxSteps = requestedSteps ?? ai_runtime_types_1.AI_TOOL_LOOP_DEFAULT_MAX_STEPS;
+    const timeoutMs = toolTimeoutMs ?? ai_runtime_types_1.AI_TOOL_DEFAULT_TIMEOUT_MS;
+    if (!Number.isInteger(maxSteps) || maxSteps < 1 || maxSteps > ai_runtime_types_1.AI_TOOL_LOOP_MAX_STEPS) {
+        throw new ai_error_1.AiError('AI_INVALID_REQUEST', `maxSteps must be an integer between 1 and ${ai_runtime_types_1.AI_TOOL_LOOP_MAX_STEPS}.`, { details: { maxSteps } });
+    }
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new ai_error_1.AiError('AI_INVALID_REQUEST', 'toolTimeoutMs must be a positive number.', {
+            details: { toolTimeoutMs },
+        });
+    }
+    if (tools.length === 0) {
+        throw new ai_error_1.AiError('AI_INVALID_REQUEST', 'runTools needs at least one tool.');
+    }
+    const byName = new Map();
+    for (const tool of tools) {
+        if (byName.has(tool.tool.name)) {
+            throw new ai_error_1.AiError('AI_INVALID_REQUEST', `Duplicate tool name "${tool.tool.name}".`, {
+                details: { tool: tool.tool.name },
+            });
+        }
+        byName.set(tool.tool.name, tool);
+    }
+    const steps = [];
+    const chains = ctx.supportsPreviousResponseId ?? (() => true);
+    let next = { ...base, tools: tools.map((tool) => tool.tool) };
+    // Everything said so far, as input — only sent for a provider that cannot chain.
+    let history = (0, conversation_1.asInputItems)(base.input);
+    for (let step = 1;; step += 1) {
+        const response = await respond(next, { signal: ctx.signal });
+        const calls = response.output.filter((item) => item.type === 'function_call');
+        if (calls.length === 0) {
+            emit(steps, { step, response, calls: [] }, onStep);
+            return { final: response, steps, stopReason: 'completed' };
+        }
+        if (step >= maxSteps) {
+            emit(steps, { step, response, calls: [] }, onStep);
+            return { final: response, steps, stopReason: 'steps_exhausted' };
+        }
+        const records = [];
+        // Sequential on purpose: a tool may depend on an earlier one's side
+        // effect, and a model that asked for N calls gets them in its order.
+        for (const call of calls) {
+            records.push(await executeCall(byName, call, ctx, timeoutMs));
+        }
+        emit(steps, { step, response, calls: records }, onStep);
+        const outputs = records.map((record) => ({
+            type: 'function_call_output',
+            callId: record.callId,
+            output: record.output,
+        }));
+        if (chains(response.provider)) {
+            next = { ...next, input: outputs, previousResponseId: response.id };
+        }
+        else {
+            history = [...history, ...(0, conversation_1.replayOutput)(response.output), ...outputs];
+            const { previousResponseId: _chained, ...rest } = next;
+            next = { ...rest, input: history };
+        }
+    }
+}
+function emit(steps, step, onStep) {
+    steps.push(step);
+    onStep?.(step);
+}
+async function executeCall(byName, call, ctx, timeoutMs) {
+    const started = Date.now();
+    const base = { callId: call.callId, name: call.name, arguments: call.arguments };
+    const tool = byName.get(call.name);
+    if (!tool) {
+        return {
+            ...base,
+            status: 'unknown_tool',
+            output: `Error: there is no tool named "${call.name}".`,
+            durationMs: Date.now() - started,
+        };
+    }
+    const parsed = tool.parseArguments(call.arguments);
+    if (!parsed.success) {
+        return {
+            ...base,
+            status: 'invalid_arguments',
+            output: `Error: ${parsed.error}`,
+            durationMs: Date.now() - started,
+        };
+    }
+    if (ctx.signal?.aborted) {
+        throw new ai_error_1.AiError('AI_PROVIDER_UNAVAILABLE', 'The AI request was cancelled.', {
+            details: { aborted: true },
+        });
+    }
+    // Each tool gets its own controller: aborted by the timeout, and by the
+    // caller's signal, so a slow tool stops with the request that wanted it.
+    const controller = new AbortController();
+    const onAbort = () => controller.abort(ctx.signal?.reason);
+    ctx.signal?.addEventListener('abort', onAbort, { once: true });
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            controller.abort();
+            reject(new ToolTimeoutError(timeoutMs));
+        }, timeoutMs);
+    });
+    try {
+        const result = await Promise.race([
+            tool.execute(parsed.data, { userId: ctx.userId, signal: controller.signal }),
+            timeout,
+        ]);
+        return { ...base, status: 'ok', output: serialise(result), durationMs: Date.now() - started };
+    }
+    catch (err) {
+        if (ctx.signal?.aborted) {
+            throw new ai_error_1.AiError('AI_PROVIDER_UNAVAILABLE', 'The AI request was cancelled.', {
+                cause: err,
+                details: { aborted: true },
+            });
+        }
+        const timedOut = err instanceof ToolTimeoutError;
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            ...base,
+            status: timedOut ? 'timeout' : 'error',
+            output: timedOut
+                ? `Error: tool "${call.name}" timed out after ${timeoutMs} ms.`
+                : `Error: tool "${call.name}" failed: ${message}`,
+            error: message,
+            durationMs: Date.now() - started,
+        };
+    }
+    finally {
+        clearTimeout(timer);
+        ctx.signal?.removeEventListener('abort', onAbort);
+    }
+}
+class ToolTimeoutError extends Error {
+    constructor(timeoutMs) {
+        super(`Tool timed out after ${timeoutMs} ms`);
+        this.name = 'ToolTimeoutError';
+    }
+}
+/** A tool result as the text a `function_call_output` carries. */
+function serialise(result) {
+    let text;
+    if (typeof result === 'string') {
+        text = result;
+    }
+    else if (result === undefined) {
+        text = 'null';
+    }
+    else {
+        try {
+            text = JSON.stringify(result) ?? 'null';
+        }
+        catch {
+            text = String(result);
+        }
+    }
+    return text.length > exports.AI_TOOL_OUTPUT_MAX_CHARS
+        ? `${text.slice(0, exports.AI_TOOL_OUTPUT_MAX_CHARS)}… (truncated)`
+        : text;
+}
+//# sourceMappingURL=ai-tool-loop.js.map

package/dist/ai/runtime/ai-tool-loop.js.map

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

package/dist/ai/runtime/ai-transcription-extras.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { type AiTranscriptionExtras } from '../core/types/media.types';
+/** The shape a transcript's extras must have. Extra keys pass through. */
+export declare const aiTranscriptionExtrasSchema: z.ZodObject<{
+    segments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        text: z.ZodString;
+        speaker: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    language: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Why extras were dropped (a constant, safe to log). */
+export type AiTranscriptionExtrasRejection = 'not_json' | 'too_large' | 'malformed';
+/**
+ * The extras to keep, or why they cannot be kept.
+ *
+ * @param extras - whatever the adapter returned in `AiTranscriptionResult.extras`.
+ * @returns `{ extras }` (a plain JSON copy) or `{ rejected }`; `{}` for none.
+ */
+export declare function boundTranscriptionExtras(extras: unknown): {
+    extras?: AiTranscriptionExtras;
+    rejected?: AiTranscriptionExtrasRejection;
+};
+//# sourceMappingURL=ai-transcription-extras.d.ts.map

package/dist/ai/runtime/ai-transcription-extras.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-transcription-extras.d.ts","sourceRoot":"","sources":["../../../src/ai/runtime/ai-transcription-extras.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAqC,KAAK,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAE1G,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B;;;;;;;;iBAYtC,CAAC;AAEH,yDAAyD;AACzD,MAAM,MAAM,8BAA8B,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAEpF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,GACd;IAAE,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,EAAE,8BAA8B,CAAA;CAAE,CAkB/E"}

package/dist/ai/runtime/ai-transcription-extras.js

@@ -0,0 +1,66 @@
+"use strict";
+// =============================================================================
+// Transcription extras: the bounded, validated tail of a transcript
+// (PP-14.17, issue #935)
+// =============================================================================
+//
+// `AiTranscriptionResult.extras` is where a provider reports what the neutral
+// result has no field for: speaker-labelled segments (diarization), a language,
+// anything else JSON. It crosses a trust boundary on the way out of an adapter
+// (a third party's adapter, with a vendor's response behind it) and ends up in
+// `ai_runs.output` and in the HTTP run view, so it is checked here, once:
+//
+//   - JSON-serialisable (a cycle, a function or a bigint is refused);
+//   - at most `AI_TRANSCRIPTION_EXTRAS_MAX_BYTES` serialised;
+//   - `segments`, when present, entries of `{ start, end, text, speaker? }`
+//     with finite numbers (their count is bounded by the size cap);
+//   - `language`, when present, a short string.
+//
+// A result that fails any of it KEEPS ITS TRANSCRIPT and loses only the
+// extras: the provider call already happened and was billed, so refusing the
+// whole result would throw away what the user paid for. Nothing about the
+// rejected value is logged (it is the user's transcript); the caller logs the
+// reason, a short constant.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aiTranscriptionExtrasSchema = void 0;
+exports.boundTranscriptionExtras = boundTranscriptionExtras;
+const zod_1 = require("zod");
+const media_types_1 = require("../core/types/media.types");
+/** The shape a transcript's extras must have. Extra keys pass through. */
+exports.aiTranscriptionExtrasSchema = zod_1.z.looseObject({
+    segments: zod_1.z
+        .array(zod_1.z.object({
+        start: zod_1.z.number().finite(),
+        end: zod_1.z.number().finite(),
+        text: zod_1.z.string(),
+        speaker: zod_1.z.string().max(128).optional(),
+    }))
+        .optional(),
+    language: zod_1.z.string().max(64).optional(),
+});
+/**
+ * The extras to keep, or why they cannot be kept.
+ *
+ * @param extras - whatever the adapter returned in `AiTranscriptionResult.extras`.
+ * @returns `{ extras }` (a plain JSON copy) or `{ rejected }`; `{}` for none.
+ */
+function boundTranscriptionExtras(extras) {
+    if (extras === undefined || extras === null)
+        return {};
+    let serialised;
+    try {
+        serialised = JSON.stringify(extras);
+    }
+    catch {
+        return { rejected: 'not_json' };
+    }
+    if (serialised === undefined || typeof extras !== 'object' || Array.isArray(extras))
+        return { rejected: 'not_json' };
+    if (Buffer.byteLength(serialised, 'utf8') > media_types_1.AI_TRANSCRIPTION_EXTRAS_MAX_BYTES)
+        return { rejected: 'too_large' };
+    // Parse the serialised copy: what is kept is plain JSON, never the adapter's live object.
+    const parsed = exports.aiTranscriptionExtrasSchema.safeParse(JSON.parse(serialised));
+    return parsed.success ? { extras: parsed.data } : { rejected: 'malformed' };
+}
+//# sourceMappingURL=ai-transcription-extras.js.map

package/dist/ai/runtime/ai-transcription-extras.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-transcription-extras.js","sourceRoot":"","sources":["../../../src/ai/runtime/ai-transcription-extras.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oEAAoE;AACpE,yBAAyB;AACzB,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,0EAA0E;AAC1E,EAAE;AACF,sEAAsE;AACtE,8DAA8D;AAC9D,4EAA4E;AAC5E,oEAAoE;AACpE,gDAAgD;AAChD,EAAE;AACF,wEAAwE;AACxE,6EAA6E;AAC7E,0EAA0E;AAC1E,8EAA8E;AAC9E,4BAA4B;AAC5B,gFAAgF;;;AA8BhF,4DAoBC;AAhDD,6BAAwB;AAExB,2DAA0G;AAE1G,0EAA0E;AAC7D,QAAA,2BAA2B,GAAG,OAAC,CAAC,WAAW,CAAC;IACvD,QAAQ,EAAE,OAAC;SACR,KAAK,CACJ,OAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;QAC1B,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;QACxB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;KACxC,CAAC,CACH;SACA,QAAQ,EAAE;IACb,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAKH;;;;;GAKG;AACH,SAAgB,wBAAwB,CACtC,MAAe;IAEf,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAEvD,IAAI,UAA8B,CAAC;IAEnC,IAAI,CAAC;QACH,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IACrH,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,+CAAiC;QAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAEhH,0FAA0F;IAC1F,MAAM,MAAM,GAAG,mCAA2B,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IAE7E,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAA6B,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACvG,CAAC"}

package/dist/ai/runtime/ai-usage.recorder.d.ts

@@ -0,0 +1,69 @@
+import type { AiPrisma } from '../data/ai-db';
+import { type AiMetrics } from '../ports';
+import type { AiUsage } from '../core/types/responses.types';
+import type { AiKeySource } from '../keys/ai-key-resolver.service';
+/**
+ * The kinds of provider call the platform records. Permanent strings.
+ *
+ * @stability experimental
+ */
+export type BuiltinAiUsageOperation = 'responses' | 'images' | 'audio.transcribe' | 'audio.speech' | 'embeddings' | 'realtime';
+/**
+ * The kind of provider call a usage row records: a built-in one
+ * (autocompleted) or the id of an operation an app registered with
+ * `registerAiOperation` (PP-14.17, #935). The column is plain text, so a new
+ * kind costs no migration.
+ *
+ * @stability experimental
+ */
+export type AiUsageOperation = BuiltinAiUsageOperation | (string & {});
+/** A round-trip's outcome. `cancelled` — the caller aborted it. */
+export type AiUsageStatus = 'succeeded' | 'failed' | 'cancelled';
+/** Non-token units of one round-trip, e.g. `{ images: 2 }`. */
+export type AiUsageUnits = Record<string, number>;
+export interface AiUsageRecord {
+    userId: string | null;
+    /**
+     * The organization that incurred the call (`ai_usage_events` is under
+     * row-level security, #725). Absent: the single-mode default organization;
+     * in multi mode the row cannot be written and a warning is logged, like any
+     * other failure to record. A deployment-wide event (a catalogue sync) is
+     * written by `AiCatalogService` through the system client instead.
+     */
+    orgId?: string;
+    provider: string;
+    modelId: string;
+    operation: AiUsageOperation;
+    keySource: AiKeySource;
+    usage?: AiUsage;
+    /** Non-token units — see the file header. */
+    units?: AiUsageUnits;
+    latencyMs: number;
+    status: AiUsageStatus;
+    errorCode?: string | null;
+    providerRequestId?: string | null;
+    jobId?: string | null;
+    /**
+     * The registered AI feature the call was made for (#739): a metric label
+     * and, since PP-14.17 (#935), the row's `feature` column. Only a well-formed
+     * feature id is written; anything else is stored as no feature.
+     */
+    feature?: string;
+}
+/**
+ * Exported for the reference app's wiring and tests (route discovery, contract
+ * and egress suites); not part of the slice's documented surface.
+ *
+ * @internal
+ */
+export declare class AiUsageRecorder {
+    private readonly prisma;
+    private readonly metrics;
+    private readonly logger;
+    constructor(prisma: AiPrisma, metrics?: AiMetrics);
+    /** Writes one row. Never throws — see the file header. */
+    record(event: AiUsageRecord): Promise<void>;
+}
+/** The storable units: finite, non-negative numbers under a plain name only; `null` when none are left. */
+export declare function usageUnits(units: AiUsageUnits | undefined): AiUsageUnits | null;
+//# sourceMappingURL=ai-usage.recorder.d.ts.map

package/dist/ai/runtime/ai-usage.recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.recorder.d.ts","sourceRoot":"","sources":["../../../src/ai/runtime/ai-usage.recorder.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAC/B,WAAW,GACX,QAAQ,GACR,kBAAkB,GAClB,cAAc,GACd,YAAY,GAEZ,UAAU,CAAC;AAEf;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEvE,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEjE,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBACa,eAAe;IAIC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;gBAGf,MAAM,EAAE,QAAQ,EAET,OAAO,GAAE,SAA2B;IAGvF,0DAA0D;IACpD,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAkDlD;AAaD,2GAA2G;AAC3G,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI,CAW/E"}

package/dist/ai/runtime/ai-usage.recorder.js

@@ -0,0 +1,143 @@
+"use strict";
+// =============================================================================
+// AiUsageRecorder — one `ai_usage_events` row per provider round-trip
+// (issue #432, epic #419; docs/specs/ai-platform.md §2.21)
+// =============================================================================
+//
+// Success AND failure: a failed call can still have been billed, and "how
+// often does this model fail for us" is an accounting question too.
+//
+// BEST EFFORT — `record` NEVER THROWS. The usage row is written after the
+// provider answered; failing the caller's request because the ledger insert
+// failed would throw away a response the user has already paid for. A lost
+// row is logged at `warn` instead.
+//
+// ⚠ Only ids, counts, codes and a duration. No prompt, no output, no key —
+// the table has no column able to hold any of them.
+//
+// `feature` (PP-14.17, #935) is the registered AI feature the call was made
+// for, persisted so usage can be filtered and grouped per feature from the
+// database. A bounded id the feature registry validated (re-checked against
+// the id pattern here), never free text.
+//
+// `units` (#437) is the count for an operation that is not (only) token-
+// metered: `{ images: 2 }` for image generation, and — for the audio stories
+// next — `{ audioSeconds: 31.4 }` or `{ characters: 1200 }`. A flat record of
+// finite, non-negative numbers; anything else in it is dropped, and an empty
+// record is stored as no units at all (`null`), so the #443 aggregates never
+// sum a key that carries nothing.
+// =============================================================================
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var AiUsageRecorder_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiUsageRecorder = void 0;
+exports.usageUnits = usageUnits;
+const common_1 = require("@nestjs/common");
+const ai_1 = require("@marinoscar/platform-contract/ai");
+const index_1 = require("../../identity/index");
+const index_2 = require("../../core/index");
+const ports_1 = require("../ports");
+const ai_feature_registry_1 = require("../features/ai-feature.registry");
+/**
+ * Exported for the reference app's wiring and tests (route discovery, contract
+ * and egress suites); not part of the slice's documented surface.
+ *
+ * @internal
+ */
+let AiUsageRecorder = AiUsageRecorder_1 = class AiUsageRecorder {
+    prisma;
+    metrics;
+    logger = new common_1.Logger(AiUsageRecorder_1.name);
+    constructor(prisma, metrics = ports_1.NOOP_AI_METRICS) {
+        this.prisma = prisma;
+        this.metrics = metrics;
+    }
+    /** Writes one row. Never throws — see the file header. */
+    async record(event) {
+        const units = usageUnits(event.units);
+        // #600. Recorded whether or not the ledger insert below succeeds — the
+        // round-trip happened either way. Low-cardinality fields only (no user,
+        // no job, no request id, no error text); the service never throws.
+        this.metrics.aiUsage({
+            provider: event.provider,
+            model: event.modelId,
+            operation: event.operation,
+            status: event.status,
+            keySource: event.keySource,
+            inputTokens: tokenCount(event.usage?.inputTokens),
+            outputTokens: tokenCount(event.usage?.outputTokens),
+            latencyMs: event.latencyMs,
+            // Bounded by the feature registry: a run row's recorded feature that is no longer registered adds no label.
+            ...(event.feature && (0, ai_feature_registry_1.getAiFeature)(event.feature) ? { feature: event.feature } : {}),
+        });
+        try {
+            const orgId = await (0, index_1.resolveOrgId)(this.prisma, event.orgId, 'AI usage event');
+            await this.prisma.forOrg(orgId, { ...(event.userId ? { userId: event.userId } : {}) }).aiUsageEvent.create({
+                data: {
+                    orgId,
+                    userId: event.userId,
+                    provider: event.provider,
+                    modelId: event.modelId,
+                    operation: event.operation,
+                    keySource: event.keySource,
+                    inputTokens: tokenCount(event.usage?.inputTokens),
+                    outputTokens: tokenCount(event.usage?.outputTokens),
+                    reasoningTokens: tokenCount(event.usage?.reasoningTokens),
+                    cachedInputTokens: tokenCount(event.usage?.cachedInputTokens),
+                    ...(units ? { units } : {}),
+                    latencyMs: Math.max(0, Math.round(event.latencyMs)),
+                    status: event.status,
+                    errorCode: event.errorCode ?? null,
+                    providerRequestId: event.providerRequestId ?? null,
+                    jobId: event.jobId ?? null,
+                    feature: featureColumn(event.feature),
+                },
+            });
+        }
+        catch (error) {
+            this.logger.warn(`Could not record AI usage (${event.provider}/${event.modelId}, ${event.status}): ` +
+                (error instanceof Error ? error.message : String(error)));
+        }
+    }
+};
+exports.AiUsageRecorder = AiUsageRecorder;
+exports.AiUsageRecorder = AiUsageRecorder = AiUsageRecorder_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(index_2.PLATFORM_PRISMA)),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(ports_1.AI_METRICS)),
+    __metadata("design:paramtypes", [Object, Object])
+], AiUsageRecorder);
+/** The `feature` column value: a well-formed feature id, else null. */
+function featureColumn(feature) {
+    return typeof feature === 'string' && ai_1.AI_FEATURE_ID_PATTERN.test(feature) ? feature : null;
+}
+/** A unit name: letters, digits and underscores (`images`, `audioSeconds`), so a custom operation's callback cannot smuggle text into a row. */
+const UNIT_NAME = /^[A-Za-z][A-Za-z0-9_]{0,31}$/;
+/** The most unit names one row keeps. */
+const UNITS_MAX = 8;
+/** The storable units: finite, non-negative numbers under a plain name only; `null` when none are left. */
+function usageUnits(units) {
+    if (!units)
+        return null;
+    const clean = Object.entries(units)
+        .filter(([key, value]) => UNIT_NAME.test(key) && typeof value === 'number' && Number.isFinite(value) && value >= 0)
+        .slice(0, UNITS_MAX);
+    return clean.length > 0 ? Object.fromEntries(clean) : null;
+}
+/** A provider-reported count as an `Int` column value, or null when unusable. */
+function tokenCount(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? Math.round(value) : null;
+}
+//# sourceMappingURL=ai-usage.recorder.js.map

package/dist/ai/runtime/ai-usage.recorder.js.map

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