@sixb/core 0.1.20 → 0.1.22

package/dist/chunk-pgrf64hp.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/storage/ai-usage/errors.ts", "../src/storage/ai-usage/usage.ts", "../src/storage/ai-usage/record.ts"],
+  "sourcesContent": [
+    "export type AiUsageStorageErrorCode = \"duplicate_id\" | \"missing_execution\"\n\n/** Storage failure specific to the AI model-call usage ledger. */\nexport class AiUsageStorageError extends Error {\n  readonly name = \"AiUsageStorageError\"\n\n  constructor(\n    readonly code: AiUsageStorageErrorCode,\n    message: string\n  ) {\n    super(message)\n  }\n}\n",
+    "import type { AiModelCallUsage, AiModelCallUsageInput } from \"./types\"\n\n/** Every count a model call can report. */\nexport const AI_USAGE_FIELDS = [\n  \"inputTokens\",\n  \"outputTokens\",\n  \"uncachedInputTokens\",\n  \"cacheReadInputTokens\",\n  \"cacheWriteInputTokens\",\n  \"textOutputTokens\",\n  \"reasoningOutputTokens\",\n  \"audioDurationMs\",\n  \"imageOutputTokens\",\n  \"audioOutputTokens\",\n  \"outputImages\",\n  \"inputCharacters\",\n] as const\nconst USAGE_FIELDS = AI_USAGE_FIELDS\n\ntype AiUsageField = (typeof USAGE_FIELDS)[number]\n\n/** Validate provider-neutral counts and derive total/reporting fields without inventing zeroes. */\nexport function normalizeAiModelCallUsage(input: AiModelCallUsageInput): AiModelCallUsage {\n  for (const field of USAGE_FIELDS) {\n    assertUsageCount(input[field], field)\n  }\n\n  const totalTokens =\n    input.inputTokens === undefined || input.outputTokens === undefined\n      ? undefined\n      : addUsageCounts(input.inputTokens, input.outputTokens, \"totalTokens\")\n  const reportingStatus =\n    input.inputTokens !== undefined && input.outputTokens !== undefined\n      ? \"complete\"\n      : USAGE_FIELDS.some((field) => input[field] !== undefined)\n        ? \"partial\"\n        : \"unavailable\"\n\n  return {\n    ...(input.audioDurationMs === undefined ? {} : { audioDurationMs: input.audioDurationMs }),\n    ...(input.inputTokens === undefined ? {} : { inputTokens: input.inputTokens }),\n    ...(input.outputTokens === undefined ? {} : { outputTokens: input.outputTokens }),\n    ...(totalTokens === undefined ? {} : { totalTokens }),\n    ...(input.uncachedInputTokens === undefined\n      ? {}\n      : { uncachedInputTokens: input.uncachedInputTokens }),\n    ...(input.cacheReadInputTokens === undefined\n      ? {}\n      : { cacheReadInputTokens: input.cacheReadInputTokens }),\n    ...(input.cacheWriteInputTokens === undefined\n      ? {}\n      : { cacheWriteInputTokens: input.cacheWriteInputTokens }),\n    ...(input.textOutputTokens === undefined ? {} : { textOutputTokens: input.textOutputTokens }),\n    ...(input.reasoningOutputTokens === undefined\n      ? {}\n      : { reasoningOutputTokens: input.reasoningOutputTokens }),\n    ...(input.imageOutputTokens === undefined\n      ? {}\n      : { imageOutputTokens: input.imageOutputTokens }),\n    ...(input.audioOutputTokens === undefined\n      ? {}\n      : { audioOutputTokens: input.audioOutputTokens }),\n    ...(input.outputImages === undefined ? {} : { outputImages: input.outputImages }),\n    ...(input.inputCharacters === undefined ? {} : { inputCharacters: input.inputCharacters }),\n    reportingStatus,\n  }\n}\n\n/**\n * Aggregate model-call usage without treating a missing count as zero.\n *\n * A field is present only when every call reported it. This prevents a partial provider response\n * from becoming an apparently complete execution total. Zero remains a reported value.\n */\nexport function aggregateAiModelCallUsage(\n  usages: Iterable<AiModelCallUsageInput>\n): AiModelCallUsage {\n  const normalized = Array.from(usages, normalizeAiModelCallUsage)\n  const fields = Object.fromEntries(\n    USAGE_FIELDS.map((field) => [field, sumUsageField(normalized, field)])\n  ) as Record<AiUsageField, number | undefined>\n  const aggregate = normalizeAiModelCallUsage(fields)\n\n  if (\n    aggregate.reportingStatus === \"unavailable\" &&\n    normalized.some((usage) => usage.reportingStatus !== \"unavailable\")\n  ) {\n    return { ...aggregate, reportingStatus: \"partial\" }\n  }\n  return aggregate\n}\n\nfunction sumUsageField(\n  usages: readonly AiModelCallUsage[],\n  field: AiUsageField\n): number | undefined {\n  if (usages.length === 0) return undefined\n\n  let total = 0\n  for (const usage of usages) {\n    const value = usage[field]\n    if (value === undefined) return undefined\n    total = addUsageCounts(total, value, `aggregate ${field}`)\n  }\n  return total\n}\n\nfunction assertUsageCount(value: number | undefined, field: AiUsageField): void {\n  if (value !== undefined && (!Number.isSafeInteger(value) || value < 0)) {\n    throw new TypeError(`[Sixb] AI model-call usage ${field} must be a non-negative safe integer.`)\n  }\n}\n\nfunction addUsageCounts(left: number, right: number, field: string): number {\n  const result = left + right\n  if (!Number.isSafeInteger(result)) {\n    throw new TypeError(`[Sixb] AI model-call usage ${field} exceeds the safe integer range.`)\n  }\n  return result\n}\n",
+    "import { normalizeRequesterGroupIds } from \"../../auth/attribution\"\nimport { isValidFileRef } from \"../../blob-storage/validation\"\nimport { assertJsonValue, isPlainRecord } from \"../../json\"\nimport { MODEL_KINDS } from \"../../models/definitions\"\nimport { normalizeModelProviderIds } from \"../../models/events\"\nimport { isModelReasoning } from \"../../models/language-model\"\nimport { AiUsageStorageError } from \"./errors\"\nimport type {\n  AiModelCallFilesRecord,\n  AiModelCallUsageRecord,\n  RecordAiModelCallFilesInput,\n  RecordAiModelCallInput,\n} from \"./types\"\nimport { normalizeAiModelCallUsage } from \"./usage\"\n\n/** Validate and defensively snapshot one provider-neutral model-call ledger input. */\nexport function normalizeAiModelCallRecord(input: RecordAiModelCallInput): AiModelCallUsageRecord {\n  assertNonBlank(input.id, \"id\")\n  assertNonBlank(input.projectId, \"projectId\")\n  assertAiUsageExecutionId(input.executionId)\n  assertPositiveSafeInteger(input.attempt, \"attempt\")\n  assertNonBlank(input.callId, \"callId\")\n  assertNonBlank(input.providerId, \"providerId\")\n  assertNonBlank(input.requestedModelId, \"requestedModelId\")\n  if (input.responseModelId !== undefined) {\n    assertNonBlank(input.responseModelId, \"responseModelId\")\n  }\n  assertNonBlank(input.responseId, \"responseId\")\n\n  if (input.modelKind !== undefined && !MODEL_KINDS.includes(input.modelKind)) {\n    throw new TypeError(\"[Sixb] AI model kind is invalid.\")\n  }\n  const occurredAt = cloneValidDate(input.occurredAt, \"occurredAt\")\n  const recordedAt = cloneValidDate(input.recordedAt ?? new Date(), \"recordedAt\")\n  const requesterGroupIds = normalizeRequesterGroupIds(input.requesterGroupIds)\n  const requestedReasoning = cloneRequestedReasoning(input.requestedReasoning)\n  const rawUsage = cloneRawUsage(input.rawUsage)\n\n  return {\n    id: input.id,\n    projectId: input.projectId,\n    executionId: input.executionId,\n    attempt: input.attempt,\n    callId: input.callId,\n    requesterGroupIds,\n    providerId: input.providerId,\n    ...(input.providerIds === undefined\n      ? {}\n      : { providerIds: normalizeModelProviderIds(input.providerIds) }),\n    requestedModelId: input.requestedModelId,\n    ...(input.modelKind === undefined ? {} : { modelKind: input.modelKind }),\n    ...(requestedReasoning === undefined ? {} : { requestedReasoning }),\n    ...(input.responseModelId === undefined ? {} : { responseModelId: input.responseModelId }),\n    responseId: input.responseId,\n    usage: normalizeAiModelCallUsage(input.usage),\n    ...(rawUsage === undefined ? {} : { rawUsage }),\n    occurredAt,\n    recordedAt,\n  }\n}\n\n/** Validate and defensively snapshot the files one model call produced. */\nexport function normalizeAiModelCallFilesRecord(\n  input: RecordAiModelCallFilesInput\n): AiModelCallFilesRecord {\n  assertNonBlank(input.projectId, \"projectId\")\n  assertAiUsageExecutionId(input.executionId)\n  assertNonBlank(input.callId, \"callId\")\n  if (!Array.isArray(input.files) || input.files.length === 0) {\n    throw new TypeError(\"[Sixb] AI model-call files must be a nonempty array.\")\n  }\n  if (!input.files.every(isValidFileRef)) {\n    throw new TypeError(\"[Sixb] AI model-call files must be valid FileRefs.\")\n  }\n  return {\n    projectId: input.projectId,\n    executionId: input.executionId,\n    callId: input.callId,\n    files: structuredClone(input.files),\n    recordedAt: cloneValidDate(input.recordedAt ?? new Date(), \"recordedAt\"),\n  }\n}\n\n/** A call's files belong to the execution that first recorded them. */\nexport function assertSameCallExecution(\n  existing: AiModelCallFilesRecord,\n  input: Pick<AiModelCallFilesRecord, \"executionId\" | \"callId\">\n): AiModelCallFilesRecord {\n  if (existing.executionId === input.executionId) return existing\n  throw new AiUsageStorageError(\n    \"duplicate_id\",\n    `[Sixb] AI model call '${input.callId}' already has files from another execution.`\n  )\n}\n\nfunction cloneRequestedReasoning(\n  reasoning: RecordAiModelCallInput[\"requestedReasoning\"]\n): RecordAiModelCallInput[\"requestedReasoning\"] {\n  if (reasoning === undefined) return undefined\n  if (!isModelReasoning(reasoning)) {\n    throw new TypeError(\"[Sixb] AI usage requestedReasoning is invalid.\")\n  }\n  return typeof reasoning === \"string\" ? reasoning : { budgetTokens: reasoning.budgetTokens }\n}\n\n/** Validate a durable execution reference at storage and query boundaries. */\nexport function assertAiUsageExecutionId(executionId: string): void {\n  assertNonBlank(executionId, \"executionId\")\n}\n\nfunction cloneRawUsage(rawUsage: RecordAiModelCallInput[\"rawUsage\"]) {\n  if (rawUsage === undefined) return undefined\n  if (!isPlainRecord(rawUsage)) {\n    throw new TypeError(\"[Sixb] AI usage rawUsage must be a JSON object.\")\n  }\n  assertJsonValue(rawUsage, \"AI usage rawUsage\")\n  return structuredClone(rawUsage)\n}\n\nfunction assertNonBlank(value: string, field: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`[Sixb] AI usage ${field} must be nonblank.`)\n  }\n}\n\nfunction assertPositiveSafeInteger(value: number, field: string): void {\n  if (!Number.isSafeInteger(value) || value <= 0) {\n    throw new TypeError(`[Sixb] AI usage ${field} must be a positive safe integer.`)\n  }\n}\n\nfunction cloneValidDate(value: Date, field: string): Date {\n  if (!(value instanceof Date) || !Number.isFinite(value.getTime())) {\n    throw new TypeError(`[Sixb] AI usage ${field} must be a valid Date.`)\n  }\n  return new Date(value)\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAGO,MAAM,6BAA4B,MAAM;AAAA,EAIlC;AAAA,EAHF,OAAO;AAAA,EAEhB,WAAW,CACA,MACT,SACA;AAAA,IACA,MAAM,OAAO;AAAA,IAHJ;AAAA;AAKb;;;ACTO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AACA,IAAM,eAAe;AAKd,SAAS,0BAAyB,CAAC,OAAgD;AAAA,EACxF,WAAW,SAAS,cAAc;AAAA,IAChC,iBAAiB,MAAM,QAAQ,KAAK;AAAA,EACtC;AAAA,EAEA,MAAM,cACJ,MAAM,gBAAgB,aAAa,MAAM,iBAAiB,YACtD,YACA,eAAe,MAAM,aAAa,MAAM,cAAc,aAAa;AAAA,EACzE,MAAM,kBACJ,MAAM,gBAAgB,aAAa,MAAM,iBAAiB,YACtD,aACA,aAAa,KAAK,CAAC,UAAU,MAAM,WAAW,SAAS,IACrD,YACA;AAAA,EAER,OAAO;AAAA,OACD,MAAM,oBAAoB,YAAY,CAAC,IAAI,EAAE,iBAAiB,MAAM,gBAAgB;AAAA,OACpF,MAAM,gBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,MAAM,YAAY;AAAA,OACxE,MAAM,iBAAiB,YAAY,CAAC,IAAI,EAAE,cAAc,MAAM,aAAa;AAAA,OAC3E,gBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY;AAAA,OAC/C,MAAM,wBAAwB,YAC9B,CAAC,IACD,EAAE,qBAAqB,MAAM,oBAAoB;AAAA,OACjD,MAAM,yBAAyB,YAC/B,CAAC,IACD,EAAE,sBAAsB,MAAM,qBAAqB;AAAA,OACnD,MAAM,0BAA0B,YAChC,CAAC,IACD,EAAE,uBAAuB,MAAM,sBAAsB;AAAA,OACrD,MAAM,qBAAqB,YAAY,CAAC,IAAI,EAAE,kBAAkB,MAAM,iBAAiB;AAAA,OACvF,MAAM,0BAA0B,YAChC,CAAC,IACD,EAAE,uBAAuB,MAAM,sBAAsB;AAAA,OACrD,MAAM,sBAAsB,YAC5B,CAAC,IACD,EAAE,mBAAmB,MAAM,kBAAkB;AAAA,OAC7C,MAAM,sBAAsB,YAC5B,CAAC,IACD,EAAE,mBAAmB,MAAM,kBAAkB;AAAA,OAC7C,MAAM,iBAAiB,YAAY,CAAC,IAAI,EAAE,cAAc,MAAM,aAAa;AAAA,OAC3E,MAAM,oBAAoB,YAAY,CAAC,IAAI,EAAE,iBAAiB,MAAM,gBAAgB;AAAA,IACxF;AAAA,EACF;AAAA;AASK,SAAS,0BAAyB,CACvC,QACkB;AAAA,EAClB,MAAM,aAAa,MAAM,KAAK,QAAQ,0BAAyB;AAAA,EAC/D,MAAM,SAAS,OAAO,YACpB,aAAa,IAAI,CAAC,UAAU,CAAC,OAAO,cAAc,YAAY,KAAK,CAAC,CAAC,CACvE;AAAA,EACA,MAAM,YAAY,2BAA0B,MAAM;AAAA,EAElD,IACE,UAAU,oBAAoB,iBAC9B,WAAW,KAAK,CAAC,UAAU,MAAM,oBAAoB,aAAa,GAClE;AAAA,IACA,OAAO,KAAK,WAAW,iBAAiB,UAAU;AAAA,EACpD;AAAA,EACA,OAAO;AAAA;AAGT,SAAS,aAAa,CACpB,QACA,OACoB;AAAA,EACpB,IAAI,OAAO,WAAW;AAAA,IAAG;AAAA,EAEzB,IAAI,QAAQ;AAAA,EACZ,WAAW,SAAS,QAAQ;AAAA,IAC1B,MAAM,QAAQ,MAAM;AAAA,IACpB,IAAI,UAAU;AAAA,MAAW;AAAA,IACzB,QAAQ,eAAe,OAAO,OAAO,aAAa,OAAO;AAAA,EAC3D;AAAA,EACA,OAAO;AAAA;AAGT,SAAS,gBAAgB,CAAC,OAA2B,OAA2B;AAAA,EAC9E,IAAI,UAAU,cAAc,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ,IAAI;AAAA,IACtE,MAAM,IAAI,UAAU,8BAA8B,4CAA4C;AAAA,EAChG;AAAA;AAGF,SAAS,cAAc,CAAC,MAAc,OAAe,OAAuB;AAAA,EAC1E,MAAM,SAAS,OAAO;AAAA,EACtB,IAAI,CAAC,OAAO,cAAc,MAAM,GAAG;AAAA,IACjC,MAAM,IAAI,UAAU,8BAA8B,uCAAuC;AAAA,EAC3F;AAAA,EACA,OAAO;AAAA;;;ACtGF,SAAS,2BAA0B,CAAC,OAAuD;AAAA,EAChG,eAAe,MAAM,IAAI,IAAI;AAAA,EAC7B,eAAe,MAAM,WAAW,WAAW;AAAA,EAC3C,0BAAyB,MAAM,WAAW;AAAA,EAC1C,0BAA0B,MAAM,SAAS,SAAS;AAAA,EAClD,eAAe,MAAM,QAAQ,QAAQ;AAAA,EACrC,eAAe,MAAM,YAAY,YAAY;AAAA,EAC7C,eAAe,MAAM,kBAAkB,kBAAkB;AAAA,EACzD,IAAI,MAAM,oBAAoB,WAAW;AAAA,IACvC,eAAe,MAAM,iBAAiB,iBAAiB;AAAA,EACzD;AAAA,EACA,eAAe,MAAM,YAAY,YAAY;AAAA,EAE7C,IAAI,MAAM,cAAc,aAAa,CAAC,YAAY,SAAS,MAAM,SAAS,GAAG;AAAA,IAC3E,MAAM,IAAI,UAAU,kCAAkC;AAAA,EACxD;AAAA,EACA,MAAM,aAAa,eAAe,MAAM,YAAY,YAAY;AAAA,EAChE,MAAM,aAAa,eAAe,MAAM,cAAc,IAAI,MAAQ,YAAY;AAAA,EAC9E,MAAM,oBAAoB,2BAA2B,MAAM,iBAAiB;AAAA,EAC5E,MAAM,qBAAqB,wBAAwB,MAAM,kBAAkB;AAAA,EAC3E,MAAM,WAAW,cAAc,MAAM,QAAQ;AAAA,EAE7C,OAAO;AAAA,IACL,IAAI,MAAM;AAAA,IACV,WAAW,MAAM;AAAA,IACjB,aAAa,MAAM;AAAA,IACnB,SAAS,MAAM;AAAA,IACf,QAAQ,MAAM;AAAA,IACd;AAAA,IACA,YAAY,MAAM;AAAA,OACd,MAAM,gBAAgB,YACtB,CAAC,IACD,EAAE,aAAa,2BAA0B,MAAM,WAAW,EAAE;AAAA,IAChE,kBAAkB,MAAM;AAAA,OACpB,MAAM,cAAc,YAAY,CAAC,IAAI,EAAE,WAAW,MAAM,UAAU;AAAA,OAClE,uBAAuB,YAAY,CAAC,IAAI,EAAE,mBAAmB;AAAA,OAC7D,MAAM,oBAAoB,YAAY,CAAC,IAAI,EAAE,iBAAiB,MAAM,gBAAgB;AAAA,IACxF,YAAY,MAAM;AAAA,IAClB,OAAO,2BAA0B,MAAM,KAAK;AAAA,OACxC,aAAa,YAAY,CAAC,IAAI,EAAE,SAAS;AAAA,IAC7C;AAAA,IACA;AAAA,EACF;AAAA;AAIK,SAAS,gCAA+B,CAC7C,OACwB;AAAA,EACxB,eAAe,MAAM,WAAW,WAAW;AAAA,EAC3C,0BAAyB,MAAM,WAAW;AAAA,EAC1C,eAAe,MAAM,QAAQ,QAAQ;AAAA,EACrC,IAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,KAAK,MAAM,MAAM,WAAW,GAAG;AAAA,IAC3D,MAAM,IAAI,UAAU,sDAAsD;AAAA,EAC5E;AAAA,EACA,IAAI,CAAC,MAAM,MAAM,MAAM,cAAc,GAAG;AAAA,IACtC,MAAM,IAAI,UAAU,oDAAoD;AAAA,EAC1E;AAAA,EACA,OAAO;AAAA,IACL,WAAW,MAAM;AAAA,IACjB,aAAa,MAAM;AAAA,IACnB,QAAQ,MAAM;AAAA,IACd,OAAO,gBAAgB,MAAM,KAAK;AAAA,IAClC,YAAY,eAAe,MAAM,cAAc,IAAI,MAAQ,YAAY;AAAA,EACzE;AAAA;AAIK,SAAS,wBAAuB,CACrC,UACA,OACwB;AAAA,EACxB,IAAI,SAAS,gBAAgB,MAAM;AAAA,IAAa,OAAO;AAAA,EACvD,MAAM,IAAI,qBACR,gBACA,yBAAyB,MAAM,mDACjC;AAAA;AAGF,SAAS,uBAAuB,CAC9B,WAC8C;AAAA,EAC9C,IAAI,cAAc;AAAA,IAAW;AAAA,EAC7B,IAAI,CAAC,kBAAiB,SAAS,GAAG;AAAA,IAChC,MAAM,IAAI,UAAU,gDAAgD;AAAA,EACtE;AAAA,EACA,OAAO,OAAO,cAAc,WAAW,YAAY,EAAE,cAAc,UAAU,aAAa;AAAA;AAIrF,SAAS,yBAAwB,CAAC,aAA2B;AAAA,EAClE,eAAe,aAAa,aAAa;AAAA;AAG3C,SAAS,aAAa,CAAC,UAA8C;AAAA,EACnE,IAAI,aAAa;AAAA,IAAW;AAAA,EAC5B,IAAI,CAAC,cAAc,QAAQ,GAAG;AAAA,IAC5B,MAAM,IAAI,UAAU,iDAAiD;AAAA,EACvE;AAAA,EACA,iBAAgB,UAAU,mBAAmB;AAAA,EAC7C,OAAO,gBAAgB,QAAQ;AAAA;AAGjC,SAAS,cAAc,CAAC,OAAe,OAAqB;AAAA,EAC1D,IAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,WAAW,GAAG;AAAA,IAC1D,MAAM,IAAI,UAAU,mBAAmB,yBAAyB;AAAA,EAClE;AAAA;AAGF,SAAS,yBAAyB,CAAC,OAAe,OAAqB;AAAA,EACrE,IAAI,CAAC,OAAO,cAAc,KAAK,KAAK,SAAS,GAAG;AAAA,IAC9C,MAAM,IAAI,UAAU,mBAAmB,wCAAwC;AAAA,EACjF;AAAA;AAGF,SAAS,cAAc,CAAC,OAAa,OAAqB;AAAA,EACxD,IAAI,EAAE,iBAAiB,SAAS,CAAC,OAAO,SAAS,MAAM,QAAQ,CAAC,GAAG;AAAA,IACjE,MAAM,IAAI,UAAU,mBAAmB,6BAA6B;AAAA,EACtE;AAAA,EACA,OAAO,IAAI,KAAK,KAAK;AAAA;",
+  "debugId": "FB38052F1DE2E9BE64756E2164756E21",
+  "names": []
+}

package/dist/{chunk-z4m0yz8c.js → chunk-q4pmvkg0.js}

@@ -3,7 +3,7 @@ import {
   createPrincipalRuntimeAuthorization,
   createDisabledRuntimeAuthorization,
   createDelegatedRuntimeAuthorization
-} from "./chunk-d0bqz29d.js";
+} from "./chunk-yc9ners4.js";
 
 // src/execution/scopes.ts
 import { randomUUID } from "crypto";