@opengeni/contracts 5.5.0 → 5.5.2-canary.40656248492001

package/dist/insights-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/insights-usage.ts"],"sourcesContent":["import * as primitives from \"./primitives\";\nimport { defineSchema } from \"./define-schema\";\nimport { ModelProcessingGeography } from \"./model-residency\";\n// Deliberately exported only from @opengeni/contracts/insights-usage. Importing\n// these schemas must not pull in the root contracts index or its browser graph.\nimport { z } from \"zod\";\n\nconst SafeCount = /* @__PURE__ */ defineSchema(() =>\n  primitives.nonnegativeInteger.max(Number.MAX_SAFE_INTEGER),\n);\nconst UtcDateTime = /* @__PURE__ */ defineSchema(() => primitives.dateTime);\nconst Identifier = /* @__PURE__ */ defineSchema(() => primitives.uuid);\nconst OpaqueKey = /* @__PURE__ */ defineSchema(() => primitives.nonEmptyString);\n\nexport const InsightsUsageRange = /* @__PURE__ */ defineSchema(() =>\n  z.enum([\"today\", \"week\", \"month\", \"30d\", \"90d\", \"ytd\", \"custom\"]),\n);\nexport type InsightsUsageRange = z.infer<typeof InsightsUsageRange>;\n\n/** Aggregate Site accounting only: no viewer, session, turn or prompt identities. */\nexport const InsightsSiteUsageQuery = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({ range: z.enum([\"today\", \"week\", \"month\", \"30d\", \"90d\", \"ytd\"]).default(\"month\") })\n    .strict(),\n);\nexport type InsightsSiteUsageQuery = z.infer<typeof InsightsSiteUsageQuery>;\nexport const InsightsSiteUsageRow = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      siteId: Identifier.nullable(),\n      title: primitives.string,\n      kind: z.enum([\"site\", \"restricted\", \"other\"]),\n      calls: SafeCount,\n      pricedCalls: SafeCount,\n      /** Settled negative model-usage ledger entries, not a provider price. */\n      chargedMicros: SafeCount,\n      /** Recorded API-equivalent estimates across all payment paths. */\n      apiEquivalentMicros: SafeCount,\n      subscriptionApiEquivalentMicros: SafeCount,\n      ownKeyApiEquivalentMicros: SafeCount,\n    })\n    .strict(),\n);\nexport type InsightsSiteUsageRow = z.infer<typeof InsightsSiteUsageRow>;\nexport const InsightsSiteUsageResponse = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      workspaceId: Identifier,\n      range: InsightsSiteUsageQuery.shape.range,\n      windowStart: UtcDateTime,\n      windowEnd: UtcDateTime,\n      rows: z.array(InsightsSiteUsageRow).max(201),\n    })\n    .strict(),\n);\nexport type InsightsSiteUsageResponse = z.infer<typeof InsightsSiteUsageResponse>;\n\nexport const InsightsUsageGroupBy = /* @__PURE__ */ defineSchema(() =>\n  z.enum([\n    \"model\",\n    \"provider\",\n    \"payer\",\n    \"plan\",\n    \"workspace\",\n    \"project\",\n    \"session\",\n    \"rootSession\",\n    \"person\",\n    \"schedule\",\n    \"source\",\n  ]),\n);\nexport type InsightsUsageGroupBy = z.infer<typeof InsightsUsageGroupBy>;\n\n/** Recorded entry surface only; API includes SDK/embed. Missing provenance is other. */\nexport const InsightsUsageSource = /* @__PURE__ */ defineSchema(() =>\n  z.enum([\"web\", \"api\", \"slack\", \"schedule\", \"agent\", \"other\"]),\n);\nexport type InsightsUsageSource = z.infer<typeof InsightsUsageSource>;\n\nconst UtcDay = /* @__PURE__ */ defineSchema(() =>\n  primitives.string.regex(/^\\d{4}-\\d{2}-\\d{2}$/).refine((value) => {\n    const instant = Date.parse(`${value}T00:00:00Z`);\n    return (\n      !value.startsWith(\"0000-\") &&\n      Number.isFinite(instant) &&\n      new Date(instant).toISOString().slice(0, 10) === value\n    );\n  }, \"Expected a real UTC calendar date in years 0001 through 9999 (YYYY-MM-DD)\"),\n);\nconst CustomUtcDateTime = /* @__PURE__ */ defineSchema(() =>\n  UtcDateTime.refine(\n    (value) => !value.startsWith(\"0000-\"),\n    \"Custom UTC boundaries must use years 0001 through 9999\",\n  ),\n);\nconst DAY_MS = 86_400_000;\nconst CUSTOM_MAX_DAYS = 370;\n\nfunction customWindow(from: string, to: string) {\n  if (!UtcDay.safeParse(from).success || !UtcDay.safeParse(to).success) return undefined;\n  const start = Date.parse(`${from}T00:00:00Z`);\n  const end = Date.parse(`${to}T00:00:00Z`) + DAY_MS;\n  if (start >= end || end - start > CUSTOM_MAX_DAYS * DAY_MS) return undefined;\n  const priorStart = start - (end - start);\n  const windows = {\n    windowStart: new Date(start).toISOString(),\n    windowEnd: new Date(end).toISOString(),\n    priorWindowStart: new Date(priorStart).toISOString(),\n    priorWindowEnd: new Date(start).toISOString(),\n  };\n  // Four-digit AD years must also represent the prior and exclusive end.\n  // PostgreSQL has no year zero even though ISO/Zod datetime permits it.\n  if (!Object.values(windows).every((value) => CustomUtcDateTime.safeParse(value).success))\n    return undefined;\n  return { ...windows, bucket: end - start <= 2 * DAY_MS ? (\"hour\" as const) : (\"day\" as const) };\n}\n\nconst CustomDates = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({ from: UtcDay, to: UtcDay })\n    .strict()\n    .refine(\n      (value) => customWindow(value.from, value.to) !== undefined,\n      \"Custom days must be ordered, span at most 370 days and have representable current/prior windows\",\n    ),\n);\n\n/** At most 370 inclusive UTC days; exclusive end and equally long immediate prior. */\nexport function resolveInsightsUsageCustomWindow(dates: { from: string; to: string }) {\n  const parsed = CustomDates.parse(dates);\n  return customWindow(parsed.from, parsed.to)!;\n}\n\nfunction validateWindowQuery(\n  value: { range: InsightsUsageRange; from?: string | undefined; to?: string | undefined },\n  context: z.RefinementCtx,\n) {\n  if (value.range === \"custom\") {\n    if (value.from === undefined || value.to === undefined) {\n      context.addIssue({\n        code: \"custom\",\n        path: [value.from === undefined ? \"from\" : \"to\"],\n        message: \"Custom range requires both from and to\",\n      });\n    } else if (customWindow(value.from, value.to) === undefined) {\n      context.addIssue({\n        code: \"custom\",\n        path: [\"to\"],\n        message:\n          \"Custom days must be ordered, span at most 370 days and have representable current/prior windows\",\n      });\n    }\n  } else if (value.from !== undefined || value.to !== undefined) {\n    context.addIssue({\n      code: \"custom\",\n      path: [\"range\"],\n      message: \"from/to are only valid with range=custom\",\n    });\n  }\n}\n\n// Literal union avoids replacing existing, structurally identical named enum\n// fingerprints in the additive public-API inventory.\nexport const InsightsUsagePayer = /* @__PURE__ */ defineSchema(() =>\n  z.union([z.literal(\"opengeni_credits\"), z.literal(\"subscription\"), z.literal(\"own_key\")]),\n);\nexport type InsightsUsagePayer = z.infer<typeof InsightsUsagePayer>;\n\n/** Split at the FIRST slash: model IDs themselves may contain slashes. */\nexport const InsightsUsageModelKey = /* @__PURE__ */ defineSchema(() =>\n  primitives.string.regex(/^[^/\\s]+\\/\\S+$/),\n);\nexport type InsightsUsageModelKey = z.infer<typeof InsightsUsageModelKey>;\n\nfunction repeated<T extends z.ZodType>(item: T) {\n  return z\n    .union([primitives.string, z.array(primitives.string).min(1)])\n    .transform((value, context) => {\n      const entries = (Array.isArray(value) ? value : [value]).flatMap((part) =>\n        part.split(\",\").map((entry) => entry.trim()),\n      );\n      const parsed = z.array(item).min(1).safeParse(entries);\n      if (!parsed.success) {\n        for (const issue of parsed.error.issues) {\n          context.addIssue({ code: \"custom\", path: issue.path, message: issue.message });\n        }\n        return z.NEVER;\n      }\n      return parsed.data;\n    })\n    .optional();\n}\n\nfunction queryLimit(max: number) {\n  return z\n    .union([z.number(), primitives.string.regex(/^\\d+$/).transform(Number)])\n    .pipe(SafeCount.min(1).max(max))\n    .default(50);\n}\n\nconst QueryBoolean = /* @__PURE__ */ defineSchema(() =>\n  z\n    .union([primitives.boolean, z.enum([\"true\", \"false\"])])\n    .transform((value) => value === true || value === \"true\"),\n);\n\n// Repeated, comma-separated, and mixed values: AND across fields, OR within a\n// field. Empty segments are rejected, never silently widened to all records.\nconst Filters = {\n  range: InsightsUsageRange.default(\"week\"),\n  from: UtcDay.optional(),\n  to: UtcDay.optional(),\n  /** At workspace scope this intersects the path workspace; it never expands scope. */\n  workspaceId: repeated(Identifier),\n  provider: repeated(OpaqueKey),\n  model: repeated(InsightsUsageModelKey),\n  payer: repeated(InsightsUsagePayer),\n  /** Recorded opaque plan key; missing historical snapshots use unknown, not today's plan. */\n  plan: repeated(OpaqueKey),\n  source: repeated(InsightsUsageSource),\n  projectId: repeated(z.union([Identifier, z.literal(\"unfiled\")])),\n  /** Authorized owner/member facet key, not a hidden causal initiator. */\n  person: repeated(OpaqueKey),\n  /** Leaf session and root chat selectors are deliberately separate. */\n  sessionId: repeated(Identifier),\n  rootSessionId: repeated(Identifier),\n  scheduleId: repeated(Identifier),\n};\n\nexport const WorkspaceInsightsUsageQuery = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      ...Filters,\n      groupBy: InsightsUsageGroupBy.default(\"model\"),\n      seriesGroups: QueryBoolean.optional(),\n      limit: queryLimit(200),\n    })\n    .strict()\n    .superRefine(validateWindowQuery),\n);\nexport type WorkspaceInsightsUsageQuery = z.infer<typeof WorkspaceInsightsUsageQuery>;\nexport type WorkspaceInsightsUsageQueryInput = z.input<typeof WorkspaceInsightsUsageQuery>;\n\nexport const OrganizationInsightsUsageQuery = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      ...Filters,\n      groupBy: InsightsUsageGroupBy.default(\"model\"),\n      seriesGroups: QueryBoolean.optional(),\n      limit: queryLimit(200),\n    })\n    .strict()\n    .superRefine(validateWindowQuery),\n);\nexport type OrganizationInsightsUsageQuery = z.infer<typeof OrganizationInsightsUsageQuery>;\nexport type OrganizationInsightsUsageQueryInput = z.input<typeof OrganizationInsightsUsageQuery>;\n\n/** Organization-capable shared shape; use the workspace parser at workspace scope. */\nexport const InsightsUsageQuery = OrganizationInsightsUsageQuery;\nexport type InsightsUsageQuery = OrganizationInsightsUsageQuery;\nexport type InsightsUsageQueryInput = OrganizationInsightsUsageQueryInput;\n\nexport const WorkspaceInsightsCallsQuery = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      ...Filters,\n      cursor: OpaqueKey.optional(),\n      limit: queryLimit(100),\n    })\n    .strict()\n    .superRefine(validateWindowQuery),\n);\nexport type WorkspaceInsightsCallsQuery = z.infer<typeof WorkspaceInsightsCallsQuery>;\nexport type WorkspaceInsightsCallsQueryInput = z.input<typeof WorkspaceInsightsCallsQuery>;\n\nexport const OrganizationInsightsCallsQuery = WorkspaceInsightsCallsQuery;\nexport type OrganizationInsightsCallsQuery = z.infer<typeof OrganizationInsightsCallsQuery>;\nexport type OrganizationInsightsCallsQueryInput = z.input<typeof OrganizationInsightsCallsQuery>;\nexport const InsightsCallsQuery = OrganizationInsightsCallsQuery;\nexport type InsightsCallsQuery = OrganizationInsightsCallsQuery;\nexport type InsightsCallsQueryInput = OrganizationInsightsCallsQueryInput;\n\n/** Missing historical token classes are represented by known-call counters, not guessed zeroes. */\nexport const InsightsUsageTokens = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      uncachedInput: SafeCount,\n      cacheRead: SafeCount,\n      cacheWrite: SafeCount,\n      output: SafeCount,\n      reasoning: SafeCount,\n    })\n    .strict(),\n);\nexport type InsightsUsageTokens = z.infer<typeof InsightsUsageTokens>;\n\n/**\n * List-price classes only: exact write-time snapshots or flagged historical\n * allocations of each call's recorded total, never repricing that total.\n * chargedMicros is the actual debit-ledger total and has no class split.\n */\nexport const InsightsUsageClassMicros = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      uncachedInput: SafeCount,\n      cacheRead: SafeCount,\n      cacheWrite: SafeCount,\n      output: SafeCount,\n    })\n    .strict(),\n);\nexport type InsightsUsageClassMicros = z.infer<typeof InsightsUsageClassMicros>;\n\nconst PayerMeasures = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      calls: SafeCount,\n      chargedMicros: SafeCount,\n      listMicros: SafeCount,\n    })\n    .strict(),\n);\n\nfunction classTotal(value: InsightsUsageClassMicros): bigint {\n  return (\n    BigInt(value.uncachedInput) +\n    BigInt(value.cacheRead) +\n    BigInt(value.cacheWrite) +\n    BigInt(value.output)\n  );\n}\n\nexport const InsightsUsageMeasures = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      calls: SafeCount,\n      tokenKnownCalls: SafeCount,\n      cacheKnownCalls: SafeCount,\n      cacheWriteKnownCalls: SafeCount,\n      /** Priced calls covered by exact snapshots OR flagged recorded-total allocations. */\n      listClassKnownCalls: SafeCount,\n      tokens: InsightsUsageTokens,\n      /** Actual debit ledger, not a model price that may exceed a clipped debit. */\n      chargedMicros: SafeCount,\n      listMicros: SafeCount,\n      listByClassMicros: InsightsUsageClassMicros.nullable(),\n      /** True when any covered class values allocate a historical recorded total. */\n      listByClassApprox: primitives.boolean,\n      pricedCalls: SafeCount,\n      byPayer: z\n        .object({\n          opengeni_credits: PayerMeasures,\n          subscription: PayerMeasures,\n          own_key: PayerMeasures,\n        })\n        .strict(),\n    })\n    .strict()\n    .superRefine((value, context) => {\n      for (const field of [\n        \"tokenKnownCalls\",\n        \"cacheKnownCalls\",\n        \"cacheWriteKnownCalls\",\n        \"pricedCalls\",\n      ] as const) {\n        if (value[field] > value.calls) {\n          context.addIssue({\n            code: \"custom\",\n            path: [field],\n            message: \"Known calls cannot exceed calls\",\n          });\n        }\n      }\n      if (value.listClassKnownCalls > value.pricedCalls) {\n        context.addIssue({\n          code: \"custom\",\n          path: [\"listClassKnownCalls\"],\n          message: \"Class coverage cannot exceed priced calls\",\n        });\n      }\n      if (value.listByClassMicros !== null) {\n        const coveredTotal = classTotal(value.listByClassMicros);\n        if (\n          coveredTotal > BigInt(value.listMicros) ||\n          (value.listClassKnownCalls === value.pricedCalls &&\n            coveredTotal !== BigInt(value.listMicros))\n        ) {\n          context.addIssue({\n            code: \"custom\",\n            path: [\"listByClassMicros\"],\n            message:\n              \"Covered classes cannot exceed the recorded total; complete coverage must preserve it exactly\",\n          });\n        }\n      }\n      for (const field of [\"calls\", \"chargedMicros\", \"listMicros\"] as const) {\n        const total = Object.values(value.byPayer).reduce(\n          (sum, payer) => sum + BigInt(payer[field]),\n          0n,\n        );\n        if (total !== BigInt(value[field])) {\n          context.addIssue({\n            code: \"custom\",\n            path: [\"byPayer\"],\n            message: `Payer ${field} must sum to the total`,\n          });\n        }\n      }\n    }),\n);\nexport type InsightsUsageMeasures = z.infer<typeof InsightsUsageMeasures>;\n\nexport const InsightsUsageScope = /* @__PURE__ */ defineSchema(() =>\n  z.discriminatedUnion(\"kind\", [\n    z\n      .object({ kind: z.literal(\"workspace\"), accountId: Identifier, workspaceId: Identifier })\n      .strict(),\n    z\n      .object({ kind: z.literal(\"organization\"), accountId: Identifier, workspaceId: z.null() })\n      .strict(),\n  ]),\n);\nexport type InsightsUsageScope = z.infer<typeof InsightsUsageScope>;\n\nexport const InsightsUsageGroup = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      /** Private/personal keys remain kind-scoped; named source keys are the source value. */\n      key: OpaqueKey,\n      kind: z.enum([\n        \"item\",\n        \"other\",\n        \"deleted\",\n        \"private\",\n        \"personal\",\n        \"unfiled\",\n        \"service\",\n        \"restricted\",\n      ]),\n      label: primitives.string,\n      provider: OpaqueKey.optional(),\n      model: OpaqueKey.optional(),\n      workspaceId: Identifier.optional(),\n      /** Only an already-authorized people facet key; permits person-only amount selection. */\n      personKey: OpaqueKey.optional(),\n      you: primitives.optionalBoolean,\n      measures: InsightsUsageMeasures,\n    })\n    .strict(),\n);\nexport type InsightsUsageGroup = z.infer<typeof InsightsUsageGroup>;\n\nconst SeriesGroup = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      chargedMicros: SafeCount,\n      listMicros: SafeCount,\n      tokens: InsightsUsageTokens,\n      calls: SafeCount,\n      byPayer: InsightsUsageMeasures.shape.byPayer,\n    })\n    .strict()\n    .superRefine((value, context) => {\n      for (const field of [\"calls\", \"chargedMicros\", \"listMicros\"] as const) {\n        const total = Object.values(value.byPayer).reduce(\n          (sum, payer) => sum + BigInt(payer[field]),\n          0n,\n        );\n        if (total !== BigInt(value[field])) {\n          context.addIssue({\n            code: \"custom\",\n            path: [\"byPayer\"],\n            message: `Payer ${field} must sum to the total`,\n          });\n        }\n      }\n    }),\n);\n\nexport const InsightsUsageSeriesPoint = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      start: UtcDateTime,\n      measures: InsightsUsageMeasures,\n      /** Top six active groups plus remainder; source uses other:folded to avoid other collisions. */\n      groups: z\n        .record(primitives.string, SeriesGroup)\n        .refine(\n          (value) =>\n            Object.keys(value).length <= 7 &&\n            Object.keys(value).filter((key) => key !== \"other\" && key !== \"other:folded\").length <=\n              6,\n          {\n            message: \"Series may include at most six groups plus other\",\n          },\n        )\n        .optional(),\n    })\n    .strict(),\n);\nexport type InsightsUsageSeriesPoint = z.infer<typeof InsightsUsageSeriesPoint>;\n\n/** Range/scope-only authorized metadata, not hidden row IDs or unconditional profile hydration. */\nexport const InsightsUsageFacets = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      workspaces: z.array(\n        z\n          .object({ id: Identifier, name: primitives.string, personal: primitives.boolean })\n          .strict(),\n      ),\n      providers: z.array(OpaqueKey),\n      models: z.array(z.object({ provider: OpaqueKey, model: OpaqueKey }).strict()),\n      payers: z.array(OpaqueKey),\n      /** Recorded opaque plan keys, with unknown for absent snapshots. */\n      plans: z.array(OpaqueKey).default([]),\n      /** Capability marker: omit until source/custom support is actually implemented. */\n      sources: z.array(InsightsUsageSource).optional(),\n      projects: z.array(z.object({ id: Identifier, name: primitives.string }).strict()),\n      people: z.array(\n        z\n          .object({ key: OpaqueKey, name: primitives.nullableString, you: primitives.boolean })\n          .strict(),\n      ),\n      schedules: z.array(z.object({ id: Identifier, name: primitives.string }).strict()),\n    })\n    .strict(),\n);\nexport type InsightsUsageFacets = z.infer<typeof InsightsUsageFacets>;\n\nexport const InsightsUsageResponse = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      scope: InsightsUsageScope,\n      range: InsightsUsageRange,\n      windowStart: UtcDateTime,\n      windowEnd: UtcDateTime,\n      priorWindowStart: UtcDateTime,\n      priorWindowEnd: UtcDateTime,\n      bucket: z.enum([\"hour\", \"day\"]),\n      generatedAt: UtcDateTime,\n      dataThrough: UtcDateTime.nullable(),\n      totals: InsightsUsageMeasures,\n      /** Null for truly empty prior windows; ledger-only money survives missing call facts. */\n      prior: InsightsUsageMeasures.nullable(),\n      groupBy: InsightsUsageGroupBy,\n      groups: z.array(InsightsUsageGroup),\n      groupCount: SafeCount,\n      groupsTruncated: primitives.boolean,\n      series: z.array(InsightsUsageSeriesPoint),\n      facets: InsightsUsageFacets,\n    })\n    .strict()\n    .superRefine((value, context) => {\n      const windowStart = Date.parse(value.windowStart);\n      const windowEnd = Date.parse(value.windowEnd);\n      const priorWindowStart = Date.parse(value.priorWindowStart);\n      const priorWindowEnd = Date.parse(value.priorWindowEnd);\n      if (windowStart > windowEnd) {\n        context.addIssue({\n          code: \"custom\",\n          path: [\"windowEnd\"],\n          message: \"Window end must not precede start\",\n        });\n      }\n      if (priorWindowStart > priorWindowEnd) {\n        context.addIssue({\n          code: \"custom\",\n          path: [\"priorWindowEnd\"],\n          message: \"Prior window end must not precede start\",\n        });\n      }\n      // At an exact UTC range boundary, elapsed current/prior windows can be\n      // zero-length. Preserve that canonical window instead of inventing a future end.\n      if (windowStart === windowEnd) {\n        if (\n          value.totals.calls !== 0 ||\n          value.totals.chargedMicros !== 0 ||\n          value.totals.listMicros !== 0 ||\n          Object.values(value.totals.tokens).some((tokens) => tokens !== 0)\n        ) {\n          context.addIssue({\n            code: \"custom\",\n            path: [\"totals\"],\n            message: \"Zero-length windows must have empty measures\",\n          });\n        }\n        if (value.groups.length !== 0 || value.groupCount !== 0 || value.groupsTruncated) {\n          context.addIssue({\n            code: \"custom\",\n            path: [\"groups\"],\n            message: \"Zero-length windows must have no groups\",\n          });\n        }\n        if (value.series.length !== 0) {\n          context.addIssue({\n            code: \"custom\",\n            path: [\"series\"],\n            message: \"Zero-length windows must have no series points\",\n          });\n        }\n      }\n      if (priorWindowStart === priorWindowEnd && value.prior !== null) {\n        context.addIssue({\n          code: \"custom\",\n          path: [\"prior\"],\n          message: \"Zero-length prior windows must have null measures\",\n        });\n      }\n      const expectedBucket =\n        value.range === \"custom\"\n          ? windowEnd - windowStart <= 2 * DAY_MS\n            ? \"hour\"\n            : \"day\"\n          : value.range === \"today\"\n            ? \"hour\"\n            : \"day\";\n      if (value.bucket !== expectedBucket) {\n        context.addIssue({\n          code: \"custom\",\n          path: [\"bucket\"],\n          message: \"Bucket is automatic for the range\",\n        });\n      }\n      // Model-call facts can soft-fail after money is recorded. Preserve those\n      // amounts without inventing calls or known token/class coverage.\n      if (\n        value.prior?.calls === 0 &&\n        value.prior.chargedMicros === 0 &&\n        value.prior.listMicros === 0\n      ) {\n        context.addIssue({\n          code: \"custom\",\n          path: [\"prior\"],\n          message: \"Prior without recorded calls or money must be null\",\n        });\n      }\n      if (value.range === \"custom\") {\n        for (const field of [\n          \"windowStart\",\n          \"windowEnd\",\n          \"priorWindowStart\",\n          \"priorWindowEnd\",\n        ] as const) {\n          if (!CustomUtcDateTime.safeParse(value[field]).success) {\n            context.addIssue({\n              code: \"custom\",\n              path: [field],\n              message: \"Custom UTC boundaries must use years 0001 through 9999\",\n            });\n          }\n        }\n        if (\n          windowStart === windowEnd ||\n          windowEnd - windowStart > CUSTOM_MAX_DAYS * DAY_MS ||\n          windowStart % DAY_MS !== 0 ||\n          windowEnd % DAY_MS !== 0 ||\n          priorWindowStart !== windowStart - (windowEnd - windowStart) ||\n          priorWindowEnd !== windowStart\n        ) {\n          context.addIssue({\n            code: \"custom\",\n            path: [\"windowEnd\"],\n            message:\n              \"Custom windows must span at most 370 complete UTC days with an immediate equal-duration prior\",\n          });\n        }\n      }\n      if (value.groupBy === \"source\") {\n        for (const [index, group] of value.groups.entries()) {\n          if (group.kind === \"item\" && !InsightsUsageSource.safeParse(group.key).success) {\n            context.addIssue({\n              code: \"custom\",\n              path: [\"groups\", index, \"key\"],\n              message: \"Named source keys must equal their source value\",\n            });\n          }\n          if (group.kind === \"other\" && group.key !== \"other:folded\") {\n            context.addIssue({\n              code: \"custom\",\n              path: [\"groups\", index, \"key\"],\n              message: \"Source remainder must use other:folded, distinct from the other source\",\n            });\n          }\n        }\n        for (const [index, point] of value.series.entries()) {\n          if (\n            point.groups &&\n            Object.keys(point.groups).filter((key) => key !== \"other:folded\").length > 6\n          ) {\n            context.addIssue({\n              code: \"custom\",\n              path: [\"series\", index, \"groups\"],\n              message: \"Source series permits six named groups plus other:folded\",\n            });\n          }\n        }\n      }\n      const peopleKeys = new Set(value.facets.people.map((person) => person.key));\n      for (const [index, group] of value.groups.entries()) {\n        if (group.personKey !== undefined && !peopleKeys.has(group.personKey)) {\n          context.addIssue({\n            code: \"custom\",\n            path: [\"groups\", index, \"personKey\"],\n            message: \"Person amount keys must come from the authorized people facets\",\n          });\n        }\n      }\n    }),\n);\nexport type InsightsUsageResponse = z.infer<typeof InsightsUsageResponse>;\n\n/** Backend must omit unreadable calls entirely; this schema grants no access. */\nexport const InsightsCall = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      id: Identifier,\n      occurredAt: UtcDateTime,\n      workspaceId: Identifier,\n      sessionId: Identifier.nullable(),\n      sessionTitle: primitives.nullableString,\n      sessionKind: z.enum([\"visible\", \"private\", \"deleted\"]),\n      personKey: OpaqueKey.nullable(),\n      provider: OpaqueKey,\n      model: OpaqueKey,\n      payer: InsightsUsagePayer,\n      tokens: InsightsUsageTokens.nullable(),\n      chargedMicros: SafeCount,\n      listMicros: SafeCount.nullable(),\n      listByClassMicros: InsightsUsageClassMicros.nullable(),\n      /**\n       * Where the route that served the call processed it. Null for calls\n       * recorded before calls carried a processing residency; unknown is never EU.\n       * Undefined in responses from servers older than this release.\n       */\n      processingGeography: ModelProcessingGeography.nullable(),\n    })\n    .strict()\n    .superRefine((value, context) => {\n      if (\n        value.sessionKind === \"private\" &&\n        (value.sessionId !== null || value.sessionTitle !== null)\n      ) {\n        context.addIssue({\n          code: \"custom\",\n          path: [\"sessionKind\"],\n          message: \"Private calls expose no session id or title\",\n        });\n      }\n      if (\n        value.listByClassMicros !== null &&\n        (value.listMicros === null ||\n          classTotal(value.listByClassMicros) !== BigInt(value.listMicros))\n      ) {\n        context.addIssue({\n          code: \"custom\",\n          path: [\"listByClassMicros\"],\n          message: \"Call list classes must sum to its recorded listMicros\",\n        });\n      }\n    }),\n);\nexport type InsightsCall = z.infer<typeof InsightsCall>;\n\nexport const InsightsCallsResponse = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      calls: z.array(InsightsCall).max(100),\n      nextCursor: OpaqueKey.nullable(),\n    })\n    .strict(),\n);\nexport type InsightsCallsResponse = z.infer<typeof InsightsCallsResponse>;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAKA,SAAS,SAAS;AAElB,IAAM,YAA4B;AAAA,EAAa,MAClC,mBAAmB,IAAI,OAAO,gBAAgB;AAC3D;AACA,IAAM,cAA8B,6BAAa,MAAiB,QAAQ;AAC1E,IAAM,aAA6B,6BAAa,MAAiB,IAAI;AACrE,IAAM,YAA4B,6BAAa,MAAiB,cAAc;AAEvE,IAAM,qBAAqC;AAAA,EAAa,MAC7D,EAAE,KAAK,CAAC,SAAS,QAAQ,SAAS,OAAO,OAAO,OAAO,QAAQ,CAAC;AAClE;AAIO,IAAM,yBAAyC;AAAA,EAAa,MACjE,EACG,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,QAAQ,SAAS,OAAO,OAAO,KAAK,CAAC,EAAE,QAAQ,OAAO,EAAE,CAAC,EAC1F,OAAO;AACZ;AAEO,IAAM,uBAAuC;AAAA,EAAa,MAC/D,EACG,OAAO;AAAA,IACN,QAAQ,WAAW,SAAS;AAAA,IAC5B,OAAkB;AAAA,IAClB,MAAM,EAAE,KAAK,CAAC,QAAQ,cAAc,OAAO,CAAC;AAAA,IAC5C,OAAO;AAAA,IACP,aAAa;AAAA;AAAA,IAEb,eAAe;AAAA;AAAA,IAEf,qBAAqB;AAAA,IACrB,iCAAiC;AAAA,IACjC,2BAA2B;AAAA,EAC7B,CAAC,EACA,OAAO;AACZ;AAEO,IAAM,4BAA4C;AAAA,EAAa,MACpE,EACG,OAAO;AAAA,IACN,aAAa;AAAA,IACb,OAAO,uBAAuB,MAAM;AAAA,IACpC,aAAa;AAAA,IACb,WAAW;AAAA,IACX,MAAM,EAAE,MAAM,oBAAoB,EAAE,IAAI,GAAG;AAAA,EAC7C,CAAC,EACA,OAAO;AACZ;AAGO,IAAM,uBAAuC;AAAA,EAAa,MAC/D,EAAE,KAAK;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAIO,IAAM,sBAAsC;AAAA,EAAa,MAC9D,EAAE,KAAK,CAAC,OAAO,OAAO,SAAS,YAAY,SAAS,OAAO,CAAC;AAC9D;AAGA,IAAM,SAAyB;AAAA,EAAa,MAC/B,OAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,UAAU;AAC/D,UAAM,UAAU,KAAK,MAAM,GAAG,KAAK,YAAY;AAC/C,WACE,CAAC,MAAM,WAAW,OAAO,KACzB,OAAO,SAAS,OAAO,KACvB,IAAI,KAAK,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,MAAM;AAAA,EAErD,GAAG,2EAA2E;AAChF;AACA,IAAM,oBAAoC;AAAA,EAAa,MACrD,YAAY;AAAA,IACV,CAAC,UAAU,CAAC,MAAM,WAAW,OAAO;AAAA,IACpC;AAAA,EACF;AACF;AACA,IAAM,SAAS;AACf,IAAM,kBAAkB;AAExB,SAAS,aAAa,MAAc,IAAY;AAC9C,MAAI,CAAC,OAAO,UAAU,IAAI,EAAE,WAAW,CAAC,OAAO,UAAU,EAAE,EAAE,QAAS,QAAO;AAC7E,QAAM,QAAQ,KAAK,MAAM,GAAG,IAAI,YAAY;AAC5C,QAAM,MAAM,KAAK,MAAM,GAAG,EAAE,YAAY,IAAI;AAC5C,MAAI,SAAS,OAAO,MAAM,QAAQ,kBAAkB,OAAQ,QAAO;AACnE,QAAM,aAAa,SAAS,MAAM;AAClC,QAAM,UAAU;AAAA,IACd,aAAa,IAAI,KAAK,KAAK,EAAE,YAAY;AAAA,IACzC,WAAW,IAAI,KAAK,GAAG,EAAE,YAAY;AAAA,IACrC,kBAAkB,IAAI,KAAK,UAAU,EAAE,YAAY;AAAA,IACnD,gBAAgB,IAAI,KAAK,KAAK,EAAE,YAAY;AAAA,EAC9C;AAGA,MAAI,CAAC,OAAO,OAAO,OAAO,EAAE,MAAM,CAAC,UAAU,kBAAkB,UAAU,KAAK,EAAE,OAAO;AACrF,WAAO;AACT,SAAO,EAAE,GAAG,SAAS,QAAQ,MAAM,SAAS,IAAI,SAAU,SAAoB,MAAgB;AAChG;AAEA,IAAM,cAA8B;AAAA,EAAa,MAC/C,EACG,OAAO,EAAE,MAAM,QAAQ,IAAI,OAAO,CAAC,EACnC,OAAO,EACP;AAAA,IACC,CAAC,UAAU,aAAa,MAAM,MAAM,MAAM,EAAE,MAAM;AAAA,IAClD;AAAA,EACF;AACJ;AAGO,SAAS,iCAAiC,OAAqC;AACpF,QAAM,SAAS,YAAY,MAAM,KAAK;AACtC,SAAO,aAAa,OAAO,MAAM,OAAO,EAAE;AAC5C;AAEA,SAAS,oBACP,OACA,SACA;AACA,MAAI,MAAM,UAAU,UAAU;AAC5B,QAAI,MAAM,SAAS,UAAa,MAAM,OAAO,QAAW;AACtD,cAAQ,SAAS;AAAA,QACf,MAAM;AAAA,QACN,MAAM,CAAC,MAAM,SAAS,SAAY,SAAS,IAAI;AAAA,QAC/C,SAAS;AAAA,MACX,CAAC;AAAA,IACH,WAAW,aAAa,MAAM,MAAM,MAAM,EAAE,MAAM,QAAW;AAC3D,cAAQ,SAAS;AAAA,QACf,MAAM;AAAA,QACN,MAAM,CAAC,IAAI;AAAA,QACX,SACE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,WAAW,MAAM,SAAS,UAAa,MAAM,OAAO,QAAW;AAC7D,YAAQ,SAAS;AAAA,MACf,MAAM;AAAA,MACN,MAAM,CAAC,OAAO;AAAA,MACd,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF;AAIO,IAAM,qBAAqC;AAAA,EAAa,MAC7D,EAAE,MAAM,CAAC,EAAE,QAAQ,kBAAkB,GAAG,EAAE,QAAQ,cAAc,GAAG,EAAE,QAAQ,SAAS,CAAC,CAAC;AAC1F;AAIO,IAAM,wBAAwC;AAAA,EAAa,MACrD,OAAO,MAAM,gBAAgB;AAC1C;AAGA,SAAS,SAA8B,MAAS;AAC9C,SAAO,EACJ,MAAM,CAAY,QAAQ,EAAE,MAAiB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAC5D,UAAU,CAAC,OAAO,YAAY;AAC7B,UAAM,WAAW,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,GAAG;AAAA,MAAQ,CAAC,SAChE,KAAK,MAAM,GAAG,EAAE,IAAI,CAAC,UAAU,MAAM,KAAK,CAAC;AAAA,IAC7C;AACA,UAAM,SAAS,EAAE,MAAM,IAAI,EAAE,IAAI,CAAC,EAAE,UAAU,OAAO;AACrD,QAAI,CAAC,OAAO,SAAS;AACnB,iBAAW,SAAS,OAAO,MAAM,QAAQ;AACvC,gBAAQ,SAAS,EAAE,MAAM,UAAU,MAAM,MAAM,MAAM,SAAS,MAAM,QAAQ,CAAC;AAAA,MAC/E;AACA,aAAO,EAAE;AAAA,IACX;AACA,WAAO,OAAO;AAAA,EAChB,CAAC,EACA,SAAS;AACd;AAEA,SAAS,WAAW,KAAa;AAC/B,SAAO,EACJ,MAAM,CAAC,EAAE,OAAO,GAAc,OAAO,MAAM,OAAO,EAAE,UAAU,MAAM,CAAC,CAAC,EACtE,KAAK,UAAU,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,EAC9B,QAAQ,EAAE;AACf;AAEA,IAAM,eAA+B;AAAA,EAAa,MAChD,EACG,MAAM,CAAY,SAAS,EAAE,KAAK,CAAC,QAAQ,OAAO,CAAC,CAAC,CAAC,EACrD,UAAU,CAAC,UAAU,UAAU,QAAQ,UAAU,MAAM;AAC5D;AAIA,IAAM,UAAU;AAAA,EACd,OAAO,mBAAmB,QAAQ,MAAM;AAAA,EACxC,MAAM,OAAO,SAAS;AAAA,EACtB,IAAI,OAAO,SAAS;AAAA;AAAA,EAEpB,aAAa,SAAS,UAAU;AAAA,EAChC,UAAU,SAAS,SAAS;AAAA,EAC5B,OAAO,SAAS,qBAAqB;AAAA,EACrC,OAAO,SAAS,kBAAkB;AAAA;AAAA,EAElC,MAAM,SAAS,SAAS;AAAA,EACxB,QAAQ,SAAS,mBAAmB;AAAA,EACpC,WAAW,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,SAAS,CAAC,CAAC,CAAC;AAAA;AAAA,EAE/D,QAAQ,SAAS,SAAS;AAAA;AAAA,EAE1B,WAAW,SAAS,UAAU;AAAA,EAC9B,eAAe,SAAS,UAAU;AAAA,EAClC,YAAY,SAAS,UAAU;AACjC;AAEO,IAAM,8BAA8C;AAAA,EAAa,MACtE,EACG,OAAO;AAAA,IACN,GAAG;AAAA,IACH,SAAS,qBAAqB,QAAQ,OAAO;AAAA,IAC7C,cAAc,aAAa,SAAS;AAAA,IACpC,OAAO,WAAW,GAAG;AAAA,EACvB,CAAC,EACA,OAAO,EACP,YAAY,mBAAmB;AACpC;AAIO,IAAM,iCAAiD;AAAA,EAAa,MACzE,EACG,OAAO;AAAA,IACN,GAAG;AAAA,IACH,SAAS,qBAAqB,QAAQ,OAAO;AAAA,IAC7C,cAAc,aAAa,SAAS;AAAA,IACpC,OAAO,WAAW,GAAG;AAAA,EACvB,CAAC,EACA,OAAO,EACP,YAAY,mBAAmB;AACpC;AAKO,IAAM,qBAAqB;AAI3B,IAAM,8BAA8C;AAAA,EAAa,MACtE,EACG,OAAO;AAAA,IACN,GAAG;AAAA,IACH,QAAQ,UAAU,SAAS;AAAA,IAC3B,OAAO,WAAW,GAAG;AAAA,EACvB,CAAC,EACA,OAAO,EACP,YAAY,mBAAmB;AACpC;AAIO,IAAM,iCAAiC;AAGvC,IAAM,qBAAqB;AAK3B,IAAM,sBAAsC;AAAA,EAAa,MAC9D,EACG,OAAO;AAAA,IACN,eAAe;AAAA,IACf,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,WAAW;AAAA,EACb,CAAC,EACA,OAAO;AACZ;AAQO,IAAM,2BAA2C;AAAA,EAAa,MACnE,EACG,OAAO;AAAA,IACN,eAAe;AAAA,IACf,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,QAAQ;AAAA,EACV,CAAC,EACA,OAAO;AACZ;AAGA,IAAM,gBAAgC;AAAA,EAAa,MACjD,EACG,OAAO;AAAA,IACN,OAAO;AAAA,IACP,eAAe;AAAA,IACf,YAAY;AAAA,EACd,CAAC,EACA,OAAO;AACZ;AAEA,SAAS,WAAW,OAAyC;AAC3D,SACE,OAAO,MAAM,aAAa,IAC1B,OAAO,MAAM,SAAS,IACtB,OAAO,MAAM,UAAU,IACvB,OAAO,MAAM,MAAM;AAEvB;AAEO,IAAM,wBAAwC;AAAA,EAAa,MAChE,EACG,OAAO;AAAA,IACN,OAAO;AAAA,IACP,iBAAiB;AAAA,IACjB,iBAAiB;AAAA,IACjB,sBAAsB;AAAA;AAAA,IAEtB,qBAAqB;AAAA,IACrB,QAAQ;AAAA;AAAA,IAER,eAAe;AAAA,IACf,YAAY;AAAA,IACZ,mBAAmB,yBAAyB,SAAS;AAAA;AAAA,IAErD,mBAA8B;AAAA,IAC9B,aAAa;AAAA,IACb,SAAS,EACN,OAAO;AAAA,MACN,kBAAkB;AAAA,MAClB,cAAc;AAAA,MACd,SAAS;AAAA,IACX,CAAC,EACA,OAAO;AAAA,EACZ,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY;AAC/B,eAAW,SAAS;AAAA,MAClB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,GAAY;AACV,UAAI,MAAM,KAAK,IAAI,MAAM,OAAO;AAC9B,gBAAQ,SAAS;AAAA,UACf,MAAM;AAAA,UACN,MAAM,CAAC,KAAK;AAAA,UACZ,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AAAA,IACF;AACA,QAAI,MAAM,sBAAsB,MAAM,aAAa;AACjD,cAAQ,SAAS;AAAA,QACf,MAAM;AAAA,QACN,MAAM,CAAC,qBAAqB;AAAA,QAC5B,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AACA,QAAI,MAAM,sBAAsB,MAAM;AACpC,YAAM,eAAe,WAAW,MAAM,iBAAiB;AACvD,UACE,eAAe,OAAO,MAAM,UAAU,KACrC,MAAM,wBAAwB,MAAM,eACnC,iBAAiB,OAAO,MAAM,UAAU,GAC1C;AACA,gBAAQ,SAAS;AAAA,UACf,MAAM;AAAA,UACN,MAAM,CAAC,mBAAmB;AAAA,UAC1B,SACE;AAAA,QACJ,CAAC;AAAA,MACH;AAAA,IACF;AACA,eAAW,SAAS,CAAC,SAAS,iBAAiB,YAAY,GAAY;AACrE,YAAM,QAAQ,OAAO,OAAO,MAAM,OAAO,EAAE;AAAA,QACzC,CAAC,KAAK,UAAU,MAAM,OAAO,MAAM,KAAK,CAAC;AAAA,QACzC;AAAA,MACF;AACA,UAAI,UAAU,OAAO,MAAM,KAAK,CAAC,GAAG;AAClC,gBAAQ,SAAS;AAAA,UACf,MAAM;AAAA,UACN,MAAM,CAAC,SAAS;AAAA,UAChB,SAAS,SAAS,KAAK;AAAA,QACzB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,CAAC;AACL;AAGO,IAAM,qBAAqC;AAAA,EAAa,MAC7D,EAAE,mBAAmB,QAAQ;AAAA,IAC3B,EACG,OAAO,EAAE,MAAM,EAAE,QAAQ,WAAW,GAAG,WAAW,YAAY,aAAa,WAAW,CAAC,EACvF,OAAO;AAAA,IACV,EACG,OAAO,EAAE,MAAM,EAAE,QAAQ,cAAc,GAAG,WAAW,YAAY,aAAa,EAAE,KAAK,EAAE,CAAC,EACxF,OAAO;AAAA,EACZ,CAAC;AACH;AAGO,IAAM,qBAAqC;AAAA,EAAa,MAC7D,EACG,OAAO;AAAA;AAAA,IAEN,KAAK;AAAA,IACL,MAAM,EAAE,KAAK;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,IACD,OAAkB;AAAA,IAClB,UAAU,UAAU,SAAS;AAAA,IAC7B,OAAO,UAAU,SAAS;AAAA,IAC1B,aAAa,WAAW,SAAS;AAAA;AAAA,IAEjC,WAAW,UAAU,SAAS;AAAA,IAC9B,KAAgB;AAAA,IAChB,UAAU;AAAA,EACZ,CAAC,EACA,OAAO;AACZ;AAGA,IAAM,cAA8B;AAAA,EAAa,MAC/C,EACG,OAAO;AAAA,IACN,eAAe;AAAA,IACf,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,SAAS,sBAAsB,MAAM;AAAA,EACvC,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY;AAC/B,eAAW,SAAS,CAAC,SAAS,iBAAiB,YAAY,GAAY;AACrE,YAAM,QAAQ,OAAO,OAAO,MAAM,OAAO,EAAE;AAAA,QACzC,CAAC,KAAK,UAAU,MAAM,OAAO,MAAM,KAAK,CAAC;AAAA,QACzC;AAAA,MACF;AACA,UAAI,UAAU,OAAO,MAAM,KAAK,CAAC,GAAG;AAClC,gBAAQ,SAAS;AAAA,UACf,MAAM;AAAA,UACN,MAAM,CAAC,SAAS;AAAA,UAChB,SAAS,SAAS,KAAK;AAAA,QACzB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,CAAC;AACL;AAEO,IAAM,2BAA2C;AAAA,EAAa,MACnE,EACG,OAAO;AAAA,IACN,OAAO;AAAA,IACP,UAAU;AAAA;AAAA,IAEV,QAAQ,EACL,OAAkB,QAAQ,WAAW,EACrC;AAAA,MACC,CAAC,UACC,OAAO,KAAK,KAAK,EAAE,UAAU,KAC7B,OAAO,KAAK,KAAK,EAAE,OAAO,CAAC,QAAQ,QAAQ,WAAW,QAAQ,cAAc,EAAE,UAC5E;AAAA,MACJ;AAAA,QACE,SAAS;AAAA,MACX;AAAA,IACF,EACC,SAAS;AAAA,EACd,CAAC,EACA,OAAO;AACZ;AAIO,IAAM,sBAAsC;AAAA,EAAa,MAC9D,EACG,OAAO;AAAA,IACN,YAAY,EAAE;AAAA,MACZ,EACG,OAAO,EAAE,IAAI,YAAY,MAAiB,QAAQ,UAAqB,QAAQ,CAAC,EAChF,OAAO;AAAA,IACZ;AAAA,IACA,WAAW,EAAE,MAAM,SAAS;AAAA,IAC5B,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,WAAW,OAAO,UAAU,CAAC,EAAE,OAAO,CAAC;AAAA,IAC5E,QAAQ,EAAE,MAAM,SAAS;AAAA;AAAA,IAEzB,OAAO,EAAE,MAAM,SAAS,EAAE,QAAQ,CAAC,CAAC;AAAA;AAAA,IAEpC,SAAS,EAAE,MAAM,mBAAmB,EAAE,SAAS;AAAA,IAC/C,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,YAAY,MAAiB,OAAO,CAAC,EAAE,OAAO,CAAC;AAAA,IAChF,QAAQ,EAAE;AAAA,MACR,EACG,OAAO,EAAE,KAAK,WAAW,MAAiB,gBAAgB,KAAgB,QAAQ,CAAC,EACnF,OAAO;AAAA,IACZ;AAAA,IACA,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,YAAY,MAAiB,OAAO,CAAC,EAAE,OAAO,CAAC;AAAA,EACnF,CAAC,EACA,OAAO;AACZ;AAGO,IAAM,wBAAwC;AAAA,EAAa,MAChE,EACG,OAAO;AAAA,IACN,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,IACb,WAAW;AAAA,IACX,kBAAkB;AAAA,IAClB,gBAAgB;AAAA,IAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,KAAK,CAAC;AAAA,IAC9B,aAAa;AAAA,IACb,aAAa,YAAY,SAAS;AAAA,IAClC,QAAQ;AAAA;AAAA,IAER,OAAO,sBAAsB,SAAS;AAAA,IACtC,SAAS;AAAA,IACT,QAAQ,EAAE,MAAM,kBAAkB;AAAA,IAClC,YAAY;AAAA,IACZ,iBAA4B;AAAA,IAC5B,QAAQ,EAAE,MAAM,wBAAwB;AAAA,IACxC,QAAQ;AAAA,EACV,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY;AAC/B,UAAM,cAAc,KAAK,MAAM,MAAM,WAAW;AAChD,UAAM,YAAY,KAAK,MAAM,MAAM,SAAS;AAC5C,UAAM,mBAAmB,KAAK,MAAM,MAAM,gBAAgB;AAC1D,UAAM,iBAAiB,KAAK,MAAM,MAAM,cAAc;AACtD,QAAI,cAAc,WAAW;AAC3B,cAAQ,SAAS;AAAA,QACf,MAAM;AAAA,QACN,MAAM,CAAC,WAAW;AAAA,QAClB,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AACA,QAAI,mBAAmB,gBAAgB;AACrC,cAAQ,SAAS;AAAA,QACf,MAAM;AAAA,QACN,MAAM,CAAC,gBAAgB;AAAA,QACvB,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AAGA,QAAI,gBAAgB,WAAW;AAC7B,UACE,MAAM,OAAO,UAAU,KACvB,MAAM,OAAO,kBAAkB,KAC/B,MAAM,OAAO,eAAe,KAC5B,OAAO,OAAO,MAAM,OAAO,MAAM,EAAE,KAAK,CAAC,WAAW,WAAW,CAAC,GAChE;AACA,gBAAQ,SAAS;AAAA,UACf,MAAM;AAAA,UACN,MAAM,CAAC,QAAQ;AAAA,UACf,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AACA,UAAI,MAAM,OAAO,WAAW,KAAK,MAAM,eAAe,KAAK,MAAM,iBAAiB;AAChF,gBAAQ,SAAS;AAAA,UACf,MAAM;AAAA,UACN,MAAM,CAAC,QAAQ;AAAA,UACf,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AACA,UAAI,MAAM,OAAO,WAAW,GAAG;AAC7B,gBAAQ,SAAS;AAAA,UACf,MAAM;AAAA,UACN,MAAM,CAAC,QAAQ;AAAA,UACf,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AAAA,IACF;AACA,QAAI,qBAAqB,kBAAkB,MAAM,UAAU,MAAM;AAC/D,cAAQ,SAAS;AAAA,QACf,MAAM;AAAA,QACN,MAAM,CAAC,OAAO;AAAA,QACd,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AACA,UAAM,iBACJ,MAAM,UAAU,WACZ,YAAY,eAAe,IAAI,SAC7B,SACA,QACF,MAAM,UAAU,UACd,SACA;AACR,QAAI,MAAM,WAAW,gBAAgB;AACnC,cAAQ,SAAS;AAAA,QACf,MAAM;AAAA,QACN,MAAM,CAAC,QAAQ;AAAA,QACf,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AAGA,QACE,MAAM,OAAO,UAAU,KACvB,MAAM,MAAM,kBAAkB,KAC9B,MAAM,MAAM,eAAe,GAC3B;AACA,cAAQ,SAAS;AAAA,QACf,MAAM;AAAA,QACN,MAAM,CAAC,OAAO;AAAA,QACd,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AACA,QAAI,MAAM,UAAU,UAAU;AAC5B,iBAAW,SAAS;AAAA,QAClB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,GAAY;AACV,YAAI,CAAC,kBAAkB,UAAU,MAAM,KAAK,CAAC,EAAE,SAAS;AACtD,kBAAQ,SAAS;AAAA,YACf,MAAM;AAAA,YACN,MAAM,CAAC,KAAK;AAAA,YACZ,SAAS;AAAA,UACX,CAAC;AAAA,QACH;AAAA,MACF;AACA,UACE,gBAAgB,aAChB,YAAY,cAAc,kBAAkB,UAC5C,cAAc,WAAW,KACzB,YAAY,WAAW,KACvB,qBAAqB,eAAe,YAAY,gBAChD,mBAAmB,aACnB;AACA,gBAAQ,SAAS;AAAA,UACf,MAAM;AAAA,UACN,MAAM,CAAC,WAAW;AAAA,UAClB,SACE;AAAA,QACJ,CAAC;AAAA,MACH;AAAA,IACF;AACA,QAAI,MAAM,YAAY,UAAU;AAC9B,iBAAW,CAAC,OAAO,KAAK,KAAK,MAAM,OAAO,QAAQ,GAAG;AACnD,YAAI,MAAM,SAAS,UAAU,CAAC,oBAAoB,UAAU,MAAM,GAAG,EAAE,SAAS;AAC9E,kBAAQ,SAAS;AAAA,YACf,MAAM;AAAA,YACN,MAAM,CAAC,UAAU,OAAO,KAAK;AAAA,YAC7B,SAAS;AAAA,UACX,CAAC;AAAA,QACH;AACA,YAAI,MAAM,SAAS,WAAW,MAAM,QAAQ,gBAAgB;AAC1D,kBAAQ,SAAS;AAAA,YACf,MAAM;AAAA,YACN,MAAM,CAAC,UAAU,OAAO,KAAK;AAAA,YAC7B,SAAS;AAAA,UACX,CAAC;AAAA,QACH;AAAA,MACF;AACA,iBAAW,CAAC,OAAO,KAAK,KAAK,MAAM,OAAO,QAAQ,GAAG;AACnD,YACE,MAAM,UACN,OAAO,KAAK,MAAM,MAAM,EAAE,OAAO,CAAC,QAAQ,QAAQ,cAAc,EAAE,SAAS,GAC3E;AACA,kBAAQ,SAAS;AAAA,YACf,MAAM;AAAA,YACN,MAAM,CAAC,UAAU,OAAO,QAAQ;AAAA,YAChC,SAAS;AAAA,UACX,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF;AACA,UAAM,aAAa,IAAI,IAAI,MAAM,OAAO,OAAO,IAAI,CAAC,WAAW,OAAO,GAAG,CAAC;AAC1E,eAAW,CAAC,OAAO,KAAK,KAAK,MAAM,OAAO,QAAQ,GAAG;AACnD,UAAI,MAAM,cAAc,UAAa,CAAC,WAAW,IAAI,MAAM,SAAS,GAAG;AACrE,gBAAQ,SAAS;AAAA,UACf,MAAM;AAAA,UACN,MAAM,CAAC,UAAU,OAAO,WAAW;AAAA,UACnC,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,CAAC;AACL;AAIO,IAAM,eAA+B;AAAA,EAAa,MACvD,EACG,OAAO;AAAA,IACN,IAAI;AAAA,IACJ,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,WAAW,WAAW,SAAS;AAAA,IAC/B,cAAyB;AAAA,IACzB,aAAa,EAAE,KAAK,CAAC,WAAW,WAAW,SAAS,CAAC;AAAA,IACrD,WAAW,UAAU,SAAS;AAAA,IAC9B,UAAU;AAAA,IACV,OAAO;AAAA,IACP,OAAO;AAAA,IACP,QAAQ,oBAAoB,SAAS;AAAA,IACrC,eAAe;AAAA,IACf,YAAY,UAAU,SAAS;AAAA,IAC/B,mBAAmB,yBAAyB,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMrD,qBAAqB,yBAAyB,SAAS;AAAA,EACzD,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY;AAC/B,QACE,MAAM,gBAAgB,cACrB,MAAM,cAAc,QAAQ,MAAM,iBAAiB,OACpD;AACA,cAAQ,SAAS;AAAA,QACf,MAAM;AAAA,QACN,MAAM,CAAC,aAAa;AAAA,QACpB,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AACA,QACE,MAAM,sBAAsB,SAC3B,MAAM,eAAe,QACpB,WAAW,MAAM,iBAAiB,MAAM,OAAO,MAAM,UAAU,IACjE;AACA,cAAQ,SAAS;AAAA,QACf,MAAM;AAAA,QACN,MAAM,CAAC,mBAAmB;AAAA,QAC1B,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AACL;AAGO,IAAM,wBAAwC;AAAA,EAAa,MAChE,EACG,OAAO;AAAA,IACN,OAAO,EAAE,MAAM,YAAY,EAAE,IAAI,GAAG;AAAA,IACpC,YAAY,UAAU,SAAS;AAAA,EACjC,CAAC,EACA,OAAO;AACZ;","names":[]}

package/dist/integration-capability-id.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Agents recommend a deployment's reviewed integration definition (Outlook
+ * Mail, OneDrive, ...) with this capability id prefix; the rest is the
+ * definition id, which is also its Connect provider id.
+ */
+export declare const INTEGRATION_DEFINITION_CAPABILITY_PREFIX = "api:integration:";
+export declare function integrationDefinitionCapabilityId(definitionId: string): string;
+export declare function integrationDefinitionIdFromCapabilityId(capabilityId: string): string | null;

package/dist/interaction-action-deadline.d.ts

@@ -0,0 +1,48 @@
+import type { BrowserAction, BrowserActionBatch, ComputerAction, ComputerActionBatch } from "./interaction.js";
+/**
+ * Declared bounds of the waits a controller runs inside one action. The
+ * controllers use these exact values, and every layer that carries an action
+ * request (the API's request to the controller, the connected-machine runner,
+ * the runner's reply timer) derives its deadline from them, so a batch that
+ * stays within its own declared waits is never cut off by a transport timer.
+ */
+/** A browser locator waits this long for its element to appear or enable. */
+export declare const BROWSER_LOCATOR_WAIT_MS = 10000;
+/** An explicit browser wait without timeoutMs, the document-ready wait after a
+ * navigation or history step, and an upload's file-chooser wait. */
+export declare const BROWSER_DEFAULT_WAIT_MS = 30000;
+/** A navigation waits this long for its server to answer before it stops. */
+export declare const BROWSER_NAVIGATION_COMMIT_TIMEOUT_MS = 20000;
+/** After page input, a navigation the input started is waited for this long
+ * to show its new document. */
+export declare const BROWSER_ACTION_NAVIGATION_SETTLE_MS = 10000;
+/** After page input, requests the input started are waited for this long. */
+export declare const BROWSER_ACTION_REQUEST_SETTLE_MS = 1500;
+/** After page input, finite animations are waited for this long. */
+export declare const BROWSER_ANIMATION_SETTLE_MS = 750;
+/** A named (non-ref) computer locator waits this long to appear and enable. */
+export declare const COMPUTER_LOCATOR_WAIT_MS = 10000;
+/** No action request gets less than the transport's historical default, so a
+ * single action keeps exactly the budget it always had. */
+export declare const INTERACTION_ACTION_DEADLINE_FLOOR_MS = 60000;
+/** Fixed allowance per request for reading the target before the actions and
+ * observing it for the receipt, which run once per request whatever its length. */
+export declare const INTERACTION_ACTION_DEADLINE_MARGIN_MS = 30000;
+/** The longest any controller request may run. */
+export declare const INTERACTION_ACTION_DEADLINE_MAX_MS: number;
+/** The settle after a request's last action (or after a failure): one pass,
+ * then one frame for late-starting requests and a second pass for those. */
+export declare const BROWSER_ACTION_SETTLE_MAX_MS: number;
+/** The longest one browser action's own waits can take. */
+export declare function browserActionMaxWaitMs(action: BrowserAction): number;
+/** The longest one computer action's own waits can take. */
+export declare function computerActionMaxWaitMs(action: ComputerAction): number;
+/**
+ * The request deadline for one browser action or batch: the sum of each
+ * action's declared maximum wait, the settle after the last action, and a
+ * fixed margin, never below the historical single-request default and never
+ * above the controller maximum.
+ */
+export declare function browserActionDeadlineMs(action: BrowserAction | BrowserActionBatch): number;
+/** The request deadline for one computer action or batch; see browserActionDeadlineMs. */
+export declare function computerActionDeadlineMs(action: ComputerAction | ComputerActionBatch): number;

package/dist/interaction-driver-diagnostic.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Operator-only context for an interaction driver failure (`driver_failed`):
+ * which error class failed and in which function. The controller sends it
+ * beside, never inside, the interaction error, so it reaches server logs
+ * without changing what a caller or model is shown. Both are code names, never
+ * message text.
+ */
+export type InteractionDriverDiagnostic = {
+    errorClass: string;
+    /** The innermost named function on the failing stack, when there is one. */
+    frame?: string;
+};
+export declare const INTERACTION_DRIVER_DIAGNOSTIC_MESSAGE_MAX_CHARS = 200;
+/** A code identifier, or null for anything that could carry data. */
+export declare function interactionDriverErrorClass(value: unknown): string | null;
+/**
+ * A driver-written error message for logs. Such messages are code templates
+ * whose variable parts (window titles, page text, paths, URLs, a driver's own
+ * free-text reason) are quoted or follow a colon, so this keeps the template
+ * head and redacts those parts. Not for arbitrary exception text.
+ */
+export declare function redactInteractionDriverMessage(message: string): string;
+/** A function name as code, or null for anything else. */
+export declare function interactionDriverFrame(value: unknown): string | null;
+/** The diagnostic for a thrown value; reads only its name and stack frames. */
+export declare function interactionDriverDiagnostic(error: unknown): InteractionDriverDiagnostic;
+/** Validates a diagnostic received from another process. */
+export declare function parseInteractionDriverDiagnostic(value: unknown): InteractionDriverDiagnostic | null;