@oxy.so/contracts 4.11.0-oxy-one.0 → 4.12.0

package/dist/cjs/inference/decisions.js

@@ -14,30 +14,24 @@ const probability = zod_1.z.number().finite().min(0).max(1);
 const text = zod_1.z.string().min(1).max(65536);
 const id = zod_1.z.string().min(1).max(128);
 const tolerance = 1e-6;
-exports.decisionEffortSchema = zod_1.z.enum([
-    "instant",
-    "low",
-    "medium",
-    "high",
-    "xhigh",
-]);
+exports.decisionEffortSchema = zod_1.z.enum(['instant', 'low', 'medium', 'high', 'xhigh']);
 const common = { id, question: text, criteria: text.optional() };
-exports.decisionQuestionSchema = zod_1.z.discriminatedUnion("kind", [
+exports.decisionQuestionSchema = zod_1.z.discriminatedUnion('kind', [
     zod_1.z
         .object({
         ...common,
-        kind: zod_1.z.literal("choice"),
+        kind: zod_1.z.literal('choice'),
         options: zod_1.z.array(text).min(2).max(255),
     })
         .strict(),
     zod_1.z
         .object({
         ...common,
-        kind: zod_1.z.literal("score"),
+        kind: zod_1.z.literal('score'),
         levels: zod_1.z.array(text).min(2).max(10),
     })
         .strict(),
-    zod_1.z.object({ ...common, kind: zod_1.z.literal("noul") }).strict(),
+    zod_1.z.object({ ...common, kind: zod_1.z.literal('noul') }).strict(),
 ]);
 const payloadFields = {
     state: zod_1.z.string().max(65536),
@@ -53,23 +47,38 @@ const payloadFields = {
  * Kaana must also check its final serialized body before sending it.
  */
 function decisionInputBudget(payload) {
-    const bytes = (value) => new TextEncoder().encode(JSON.stringify(value).replace(/[<>&\u2028\u2029]/g, (char) => `\\u${char.charCodeAt(0).toString(16).padStart(4, "0")}`)).length;
-    const model = "x".repeat(255);
+    const bytes = (value) => new TextEncoder().encode(JSON.stringify(value).replace(/[<>&\u2028\u2029]/g, (char) => `\\u${char.charCodeAt(0).toString(16).padStart(4, '0')}`)).length;
+    const model = 'x'.repeat(255);
     const measure = (questions) => {
-        const wireQuestions = Object.fromEntries(questions.map((q) => [q.id, {
+        const wireQuestions = Object.fromEntries(questions.map((q) => [
+            q.id,
+            {
                 type: q.kind,
                 instructions: {
                     question: q.question,
                     ...(payload.instructions === undefined ? {} : { instructions: payload.instructions }),
                     ...(q.criteria === undefined ? {} : { criteria: q.criteria }),
                 },
-                ...(q.kind === "choice" ? { criteria: Object.fromEntries(q.options.map((label) => [label, null])) } :
-                    q.kind === "score" ? { criteria: q.levels } : {}),
-            }]));
-        return Math.max(bytes({ ...payload, model, questions }), bytes({ model, state: payload.state, questions: wireQuestions, ...(payload.effort === undefined ? {} : { effort: payload.effort }) }));
+                ...(q.kind === 'choice'
+                    ? { criteria: Object.fromEntries(q.options.map((label) => [label, null])) }
+                    : q.kind === 'score'
+                        ? { criteria: q.levels }
+                        : {}),
+            },
+        ]));
+        return Math.max(bytes({ ...payload, model, questions }), bytes({
+            model,
+            state: payload.state,
+            questions: wireQuestions,
+            ...(payload.effort === undefined ? {} : { effort: payload.effort }),
+        }));
     };
     const total = measure(payload.questions);
-    return { total, context: Math.max(...payload.questions.map((q) => measure([q]))), gateway: total + 4096 };
+    return {
+        total,
+        context: Math.max(...payload.questions.map((q) => measure([q]))),
+        gateway: total + 4096,
+    };
 }
 /** OpenRouter's TOTAL limit is separate from direct state-plus-longest context. */
 function decisionFitsGateway(payload) {
@@ -92,18 +101,18 @@ function hasUnpairedSurrogate(value) {
 }
 function validateInput(payload, ctx) {
     const fields = [
-        { value: payload.state, path: ["state"] },
-        { value: payload.instructions, path: ["instructions"] },
+        { value: payload.state, path: ['state'] },
+        { value: payload.instructions, path: ['instructions'] },
     ];
     for (const [index, question] of payload.questions.entries()) {
-        for (const field of ["id", "question", "criteria"]) {
-            fields.push({ value: question[field], path: ["questions", index, field] });
+        for (const field of ['id', 'question', 'criteria']) {
+            fields.push({ value: question[field], path: ['questions', index, field] });
         }
-        if (question.kind === "choice" || question.kind === "score") {
-            const field = question.kind === "choice" ? "options" : "levels";
-            const labels = question.kind === "choice" ? question.options : question.levels;
+        if (question.kind === 'choice' || question.kind === 'score') {
+            const field = question.kind === 'choice' ? 'options' : 'levels';
+            const labels = question.kind === 'choice' ? question.options : question.levels;
             for (const [labelIndex, value] of labels.entries()) {
-                fields.push({ value, path: ["questions", index, field, labelIndex] });
+                fields.push({ value, path: ['questions', index, field, labelIndex] });
             }
         }
     }
@@ -111,57 +120,57 @@ function validateInput(payload, ctx) {
     for (const { value, path } of fields) {
         if (value !== undefined && hasUnpairedSurrogate(value)) {
             invalidUnicode = true;
-            ctx.addIssue({ code: "custom", path, message: "Decisions require paired UTF-16 surrogates." });
+            ctx.addIssue({
+                code: 'custom',
+                path,
+                message: 'Decisions require paired UTF-16 surrogates.',
+            });
         }
     }
     // Reject before measuring/reserving text that the execution runtime would change.
     if (invalidUnicode)
         return;
-    if (new Set(payload.questions.map((q) => q.id)).size !==
-        payload.questions.length)
+    if (new Set(payload.questions.map((q) => q.id)).size !== payload.questions.length)
         ctx.addIssue({
-            code: "custom",
-            path: ["questions"],
-            message: "Question IDs must be unique.",
+            code: 'custom',
+            path: ['questions'],
+            message: 'Question IDs must be unique.',
         });
     for (const [index, question] of payload.questions.entries()) {
-        const labels = question.kind === "choice"
+        const labels = question.kind === 'choice'
             ? question.options
-            : question.kind === "score"
+            : question.kind === 'score'
                 ? question.levels
                 : [];
         if (new Set(labels).size !== labels.length)
             ctx.addIssue({
-                code: "custom",
-                path: ["questions", index],
-                message: "Options and levels must be unique.",
+                code: 'custom',
+                path: ['questions', index],
+                message: 'Options and levels must be unique.',
             });
     }
     const budget = decisionInputBudget(payload);
     if (budget.total > 64000 || budget.context > 32000)
         ctx.addIssue({
-            code: "custom",
-            path: ["state"],
-            message: "Decisions exceed the serialized 64000-byte total or 32000-byte per-question context budget.",
+            code: 'custom',
+            path: ['state'],
+            message: 'Decisions exceed the serialized 64000-byte total or 32000-byte per-question context budget.',
         });
 }
-exports.decisionInputSchema = zod_1.z
-    .object(payloadFields)
-    .strict()
-    .superRefine(validateInput);
+exports.decisionInputSchema = zod_1.z.object(payloadFields).strict().superRefine(validateInput);
 exports.decisionRequestSchema = zod_1.z
     .object({
-    model: identifiers_1.modelReferenceSchema.refine((model) => model.includes("@"), "Decisions require a revision-pinned model."),
+    model: identifiers_1.modelReferenceSchema.refine((model) => model.includes('@'), 'Decisions require a revision-pinned model.'),
     ...payloadFields,
 })
     .strict()
     .superRefine(validateInput);
 exports.decisionAnswerSchema = zod_1.z
-    .discriminatedUnion("kind", [
+    .discriminatedUnion('kind', [
     zod_1.z
         .object({
         id,
-        kind: zod_1.z.literal("choice"),
+        kind: zod_1.z.literal('choice'),
         /** Actual provider-selected option. Never reconstructed from probabilities. */
         reply: text,
         /** Provider-returned confidence, not a correctness probability. */
@@ -172,7 +181,7 @@ exports.decisionAnswerSchema = zod_1.z
     zod_1.z
         .object({
         id,
-        kind: zod_1.z.literal("score"),
+        kind: zod_1.z.literal('score'),
         /** Actual provider score. Kept separate from the validated expected index. */
         reply: zod_1.z.number().finite().min(0).max(9),
         confidence: probability,
@@ -180,42 +189,45 @@ exports.decisionAnswerSchema = zod_1.z
         distribution: zod_1.z.array(probability).min(2).max(10),
     })
         .strict(),
-    zod_1.z.object({ id, kind: zod_1.z.literal("noul"), probability }).strict(),
+    zod_1.z.object({ id, kind: zod_1.z.literal('noul'), probability }).strict(),
 ])
     .superRefine((answer, ctx) => {
-    if (answer.kind === "noul")
+    if (answer.kind === 'noul')
         return;
-    if (answer.kind === "score" && Math.abs(answer.reply - answer.mean) > tolerance) {
-        ctx.addIssue({ code: "custom", path: ["reply"], message: "Provider score must match the expected level index." });
+    if (answer.kind === 'score' && Math.abs(answer.reply - answer.mean) > tolerance) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['reply'],
+            message: 'Provider score must match the expected level index.',
+        });
     }
-    const distribution = answer.kind === "choice" ? answer.probabilities : answer.distribution;
-    if (Math.abs(distribution.reduce((sum, value) => sum + value, 0) - 1) >
-        tolerance)
+    const distribution = answer.kind === 'choice' ? answer.probabilities : answer.distribution;
+    if (Math.abs(distribution.reduce((sum, value) => sum + value, 0) - 1) > tolerance)
         ctx.addIssue({
-            code: "custom",
-            message: "Probabilities must sum to one.",
+            code: 'custom',
+            message: 'Probabilities must sum to one.',
         });
-    if (answer.kind === "score" &&
-        Math.abs(distribution.reduce((sum, value, index) => sum + index * value, 0) -
-            answer.mean) > tolerance)
+    if (answer.kind === 'score' &&
+        Math.abs(distribution.reduce((sum, value, index) => sum + index * value, 0) - answer.mean) >
+            tolerance)
         ctx.addIssue({
-            code: "custom",
-            path: ["mean"],
-            message: "Mean must equal the expected zero-based level index.",
+            code: 'custom',
+            path: ['mean'],
+            message: 'Mean must equal the expected zero-based level index.',
         });
 });
 const resultFields = {
     schemaVersion: zod_1.z.literal(1),
     requestId: identifiers_1.requestIdSchema,
-    model: identifiers_1.modelReferenceSchema.refine((model) => model.includes("@"), "Decisions require an immutable model revision."),
+    model: identifiers_1.modelReferenceSchema.refine((model) => model.includes('@'), 'Decisions require an immutable model revision.'),
     data: zod_1.z.array(exports.decisionAnswerSchema).min(1).max(255),
 };
 function uniqueAnswers(result, ctx) {
     if (new Set(result.data.map((answer) => answer.id)).size !== result.data.length)
         ctx.addIssue({
-            code: "custom",
-            path: ["data"],
-            message: "Answer IDs must be unique.",
+            code: 'custom',
+            path: ['data'],
+            message: 'Answer IDs must be unique.',
         });
 }
 exports.decisionResultSchema = zod_1.z
@@ -225,11 +237,11 @@ exports.decisionResultSchema = zod_1.z
     .superRefine((result, ctx) => {
     if (result.usage.requestId !== result.requestId ||
         result.usage.resolvedModelReference !== result.model ||
-        result.usage.outcome !== "completed") {
+        result.usage.outcome !== 'completed') {
         ctx.addIssue({
-            code: "custom",
-            path: ["usage"],
-            message: "Decision usage must describe this completed request and immutable model.",
+            code: 'custom',
+            path: ['usage'],
+            message: 'Decision usage must describe this completed request and immutable model.',
         });
     }
 });
@@ -248,11 +260,19 @@ exports.decisionFailureSchema = zod_1.z
     .strict()
     .superRefine((failure, ctx) => {
     if (failure.error.requestId !== failure.requestId) {
-        ctx.addIssue({ code: "custom", path: ["error", "requestId"], message: "The error must answer this request." });
+        ctx.addIssue({
+            code: 'custom',
+            path: ['error', 'requestId'],
+            message: 'The error must answer this request.',
+        });
     }
     if (failure.usage !== undefined &&
-        (failure.usage.requestId !== failure.requestId || failure.usage.outcome === "completed")) {
-        ctx.addIssue({ code: "custom", path: ["usage"], message: "Failure usage must describe this request and an incomplete outcome." });
+        (failure.usage.requestId !== failure.requestId || failure.usage.outcome === 'completed')) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['usage'],
+            message: 'Failure usage must describe this request and an incomplete outcome.',
+        });
     }
 });
 exports.decisionSuccessSchema = zod_1.z
@@ -270,17 +290,16 @@ function decisionAnswersMatch(input, answers) {
         return false;
     return input.questions.every((question) => {
         const answer = answers.find((candidate) => candidate.id === question.id);
-        if (!answer ||
-            !exports.decisionAnswerSchema.safeParse(answer).success ||
-            answer.kind !== question.kind)
+        if (!answer || !exports.decisionAnswerSchema.safeParse(answer).success || answer.kind !== question.kind)
             return false;
-        if (question.kind === "choice" && answer.kind === "choice") {
+        if (question.kind === 'choice' && answer.kind === 'choice') {
             const index = question.options.indexOf(answer.reply);
-            return question.options.length === answer.probabilities.length && index >= 0 &&
-                answer.probabilities[index] + tolerance >= Math.max(...answer.probabilities);
+            return (question.options.length === answer.probabilities.length &&
+                index >= 0 &&
+                answer.probabilities[index] + tolerance >= Math.max(...answer.probabilities));
         }
-        if (question.kind === "score" && answer.kind === "score")
+        if (question.kind === 'score' && answer.kind === 'score')
             return question.levels.length === answer.distribution.length;
-        return question.kind === "noul";
+        return question.kind === 'noul';
     });
 }

package/dist/cjs/inference/economics.js

@@ -107,7 +107,8 @@ exports.costCenterUsageSchema = zod_1.z
 })
     .strict();
 /** A technical generation record for an internal request, never a financial receipt. */
-exports.meteredGenerationSchema = zod_1.z.object({
+exports.meteredGenerationSchema = zod_1.z
+    .object({
     schemaVersion: zod_1.z.literal(2),
     kind: zod_1.z.literal('metered_usage'),
     meteredUsageId: zod_1.z.string().min(1),
@@ -126,10 +127,19 @@ exports.meteredGenerationSchema = zod_1.z.object({
     resolvedModelReference: identifiers_1.modelReferenceSchema,
     servingProvider: zod_1.z.string().min(1),
     tariff: zod_1.z.discriminatedUnion('status', [
-        zod_1.z.object({ status: zod_1.z.literal('quoted'), amount: money_1.exactDecimalSchema, currency: money_1.currencyCodeSchema,
-            priceVersionId: zod_1.z.string().min(1) }).strict(),
-        zod_1.z.object({ status: zod_1.z.literal('unpriced'), priceVersionId: zod_1.z.string().min(1).nullable() }).strict(),
+        zod_1.z
+            .object({
+            status: zod_1.z.literal('quoted'),
+            amount: money_1.exactDecimalSchema,
+            currency: money_1.currencyCodeSchema,
+            priceVersionId: zod_1.z.string().min(1),
+        })
+            .strict(),
+        zod_1.z
+            .object({ status: zod_1.z.literal('unpriced'), priceVersionId: zod_1.z.string().min(1).nullable() })
+            .strict(),
     ]),
     customerCharge: zod_1.z.object({ status: zod_1.z.literal('not_charged') }).strict(),
     settledAt: zod_1.z.string().datetime(),
-}).strict();
+})
+    .strict();

package/dist/cjs/inference/embeddings.js

@@ -3,17 +3,55 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.embeddingResponseSchema = exports.embeddingFailureSchema = exports.embeddingSuccessSchema = exports.embeddingUsageSchema = exports.embeddingVectorSchema = void 0;
 const zod_1 = require("zod");
 const errors_1 = require("./errors");
-exports.embeddingVectorSchema = zod_1.z.object({ index: zod_1.z.number().int().nonnegative(), embedding: zod_1.z.array(zod_1.z.number().finite()).min(1).max(1024) }).strict();
-exports.embeddingUsageSchema = zod_1.z.object({ inputTokens: zod_1.z.number().int().nonnegative(), totalTokens: zod_1.z.number().int().nonnegative() }).strict().refine((usage) => usage.totalTokens >= usage.inputTokens, { message: 'totalTokens must be greater than or equal to inputTokens', path: ['totalTokens'] });
-exports.embeddingSuccessSchema = zod_1.z.object({ schemaVersion: zod_1.z.literal(1), requestId: zod_1.z.string().min(1).max(128), model: zod_1.z.string().min(1).max(255), dimension: zod_1.z.number().int().positive().max(1024), data: zod_1.z.array(exports.embeddingVectorSchema).min(1).max(2048), usage: exports.embeddingUsageSchema }).strict().superRefine((result, context) => {
+exports.embeddingVectorSchema = zod_1.z
+    .object({
+    index: zod_1.z.number().int().nonnegative(),
+    embedding: zod_1.z.array(zod_1.z.number().finite()).min(1).max(1024),
+})
+    .strict();
+exports.embeddingUsageSchema = zod_1.z
+    .object({
+    inputTokens: zod_1.z.number().int().nonnegative(),
+    totalTokens: zod_1.z.number().int().nonnegative(),
+})
+    .strict()
+    .refine((usage) => usage.totalTokens >= usage.inputTokens, {
+    message: 'totalTokens must be greater than or equal to inputTokens',
+    path: ['totalTokens'],
+});
+exports.embeddingSuccessSchema = zod_1.z
+    .object({
+    schemaVersion: zod_1.z.literal(1),
+    requestId: zod_1.z.string().min(1).max(128),
+    model: zod_1.z.string().min(1).max(255),
+    dimension: zod_1.z.number().int().positive().max(1024),
+    data: zod_1.z.array(exports.embeddingVectorSchema).min(1).max(2048),
+    usage: exports.embeddingUsageSchema,
+})
+    .strict()
+    .superRefine((result, context) => {
     const indexes = new Set();
     for (const [position, vector] of result.data.entries()) {
         if (vector.embedding.length !== result.dimension)
-            context.addIssue({ code: zod_1.z.ZodIssueCode.custom, path: ['data', position, 'embedding'], message: 'embedding length must equal dimension' });
+            context.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: ['data', position, 'embedding'],
+                message: 'embedding length must equal dimension',
+            });
         if (indexes.has(vector.index))
-            context.addIssue({ code: zod_1.z.ZodIssueCode.custom, path: ['data', position, 'index'], message: 'embedding indexes must be unique' });
+            context.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: ['data', position, 'index'],
+                message: 'embedding indexes must be unique',
+            });
         indexes.add(vector.index);
     }
 });
-exports.embeddingFailureSchema = zod_1.z.object({ schemaVersion: zod_1.z.literal(1), requestId: zod_1.z.string().min(1).max(128), error: errors_1.inferenceErrorSchema }).strict();
+exports.embeddingFailureSchema = zod_1.z
+    .object({
+    schemaVersion: zod_1.z.literal(1),
+    requestId: zod_1.z.string().min(1).max(128),
+    error: errors_1.inferenceErrorSchema,
+})
+    .strict();
 exports.embeddingResponseSchema = zod_1.z.union([exports.embeddingSuccessSchema, exports.embeddingFailureSchema]);

package/dist/cjs/inference/identifiers.js

@@ -19,7 +19,7 @@
  * Decided in: docs/adr/0007-canonical-request-attribution.md, docs/adr/0008-catalogue-concept-separation.md.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESERVED_ALIA_PUBLISHER = exports.inferenceRegionSchema = exports.deploymentIdSchema = exports.inferenceProviderSlugSchema = exports.routingProfileIdSchema = exports.routingProfileSlugSchema = exports.modelReferenceSchema = exports.modelRevisionLabelSchema = exports.modelIdSchema = exports.modelSlugSchema = exports.publisherSlugSchema = exports.PADDED_BASE64_PATTERN = exports.sha256DigestSchema = exports.inferenceHttpsUrlSchema = exports.inferenceDateSchema = exports.inferenceTimestampSchema = exports.inferenceEnvironmentSchema = exports.idempotencyKeySchema = exports.generationIdSchema = exports.requestIdSchema = exports.oxyCredentialIdSchema = exports.oxyApplicationIdSchema = exports.delegatedUserIdSchema = exports.oxyAccountIdSchema = void 0;
+exports.inferenceFundingTierSchema = exports.RESERVED_ALIA_PUBLISHER = exports.inferenceRegionSchema = exports.deploymentIdSchema = exports.inferenceProviderSlugSchema = exports.routingProfileIdSchema = exports.routingProfileSlugSchema = exports.modelReferenceSchema = exports.modelRevisionLabelSchema = exports.modelIdSchema = exports.modelSlugSchema = exports.publisherSlugSchema = exports.PADDED_BASE64_PATTERN = exports.sha256DigestSchema = exports.inferenceHttpsUrlSchema = exports.inferenceDateSchema = exports.inferenceTimestampSchema = exports.inferenceEnvironmentSchema = exports.idempotencyKeySchema = exports.generationIdSchema = exports.requestIdSchema = exports.oxyCredentialIdSchema = exports.oxyApplicationIdSchema = exports.delegatedUserIdSchema = exports.oxyAccountIdSchema = void 0;
 const zod_1 = require("zod");
 /* -------------------------------------------------------------------------- */
 /*  Principal identifiers                                                     */
@@ -224,3 +224,16 @@ exports.inferenceRegionSchema = zod_1.z
  * this constant exists to be checked against.
  */
 exports.RESERVED_ALIA_PUBLISHER = 'alia';
+/**
+ * The economic tier of the provider capacity that funds a request, in the
+ * order Kaana spends it: `free` (costs nothing), `credit` (a promotional or
+ * trial grant, or a prepaid balance), `paid` (ordinary metered spend).
+ *
+ * Kaana owns provider keys, their economics and which key serves (Oxy ADR
+ * 0038, Kaana ADR 0001); Oxy owns what a customer may spend. The tier is the
+ * one economic fact the two exchange: Oxy BOUNDS a route by it
+ * (`maxFundingTier`), and Kaana REPORTS the tier that served
+ * (`normalizedUsageReportSchema.fundingTier`). No key id, label or price
+ * travels with it.
+ */
+exports.inferenceFundingTierSchema = zod_1.z.enum(['free', 'credit', 'paid']);

package/dist/cjs/inference/inbox.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.inboxInferenceStreamEventSchema = exports.inboxThreadSummaryResponseSchema = exports.inboxSmartRepliesResponseSchema = exports.inboxNaturalSearchResponseSchema = exports.inboxInferenceTextResponseSchema = exports.inboxMessageInferenceParamsSchema = exports.inboxNaturalSearchRequestSchema = exports.inboxDailyBriefRequestSchema = exports.inboxComposeRequestSchema = void 0;
+exports.inboxInferenceStreamEventSchema = exports.inboxThreadSummaryResponseSchema = exports.inboxSmartRepliesResponseSchema = exports.inboxDailyBriefResponseSchema = exports.INBOX_DAILY_BRIEF_SECTIONS = exports.inboxNaturalSearchResponseSchema = exports.inboxInferenceTextResponseSchema = exports.inboxMessageInferenceParamsSchema = exports.inboxNaturalSearchRequestSchema = exports.inboxDailyBriefRequestSchema = exports.inboxComposeRequestSchema = void 0;
 const zod_1 = require("zod");
 const errors_1 = require("./errors");
 const inboxTextSchema = zod_1.z.string().trim().min(1).max(20000);
@@ -40,7 +40,8 @@ exports.inboxComposeRequestSchema = zod_1.z.discriminatedUnion('operation', [
 exports.inboxDailyBriefRequestSchema = zod_1.z.object({
     startAt: inboxUtcTimestampSchema,
     endAt: inboxUtcTimestampSchema,
-    stream: zod_1.z.boolean().optional(),
+    /** BCP 47 tag of the language the brief is written in; English when absent. */
+    locale: zod_1.z.string().regex(/^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/).max(35).optional(),
 }).strict().superRefine((value, context) => {
     const durationMs = Date.parse(value.endAt) - Date.parse(value.startAt);
     if (!Number.isFinite(durationMs) || durationMs <= 0) {
@@ -82,6 +83,36 @@ exports.inboxNaturalSearchResponseSchema = zod_1.z.object({
     }).strict(),
     interpretation: zod_1.z.string().max(1000),
 }).strict();
+/** Where the brief puts a message: it asks something of the owner, it is today's news, or it is still unread from before. */
+exports.INBOX_DAILY_BRIEF_SECTIONS = ['needs_you', 'today', 'earlier'];
+/**
+ * The Daily Brief as data, so a client draws it rather than printing a wall of
+ * text: a short summary, then the messages it mentions — each with the
+ * server's own copy of its sender, subject, time and unread state, so a client
+ * can show and open it, and a one-line note of why it matters.
+ */
+exports.inboxDailyBriefResponseSchema = zod_1.z.object({
+    schemaVersion: zod_1.z.literal(1),
+    requestId: zod_1.z.string().min(1).max(128),
+    generationId: zod_1.z.string().min(1).max(128).optional(),
+    summary: zod_1.z.string().max(400),
+    counts: zod_1.z.object({
+        received: zod_1.z.number().int().nonnegative(),
+        unread: zod_1.z.number().int().nonnegative(),
+        starred: zod_1.z.number().int().nonnegative(),
+        earlierUnread: zod_1.z.number().int().nonnegative(),
+    }).strict(),
+    items: zod_1.z.array(zod_1.z.object({
+        messageId: inboxMessageIdSchema,
+        section: zod_1.z.enum(exports.INBOX_DAILY_BRIEF_SECTIONS),
+        note: zod_1.z.string().max(200),
+        from: zod_1.z.object({ name: zod_1.z.string().max(998).nullable(), address: zod_1.z.string().max(320) }).strict(),
+        subject: zod_1.z.string().max(998),
+        receivedAt: zod_1.z.string().datetime(),
+        unread: zod_1.z.boolean(),
+        hasAttachments: zod_1.z.boolean(),
+    }).strict()).max(20),
+}).strict();
 exports.inboxSmartRepliesResponseSchema = zod_1.z.object({
     replies: zod_1.z.array(zod_1.z.string().trim().min(1).max(500)).max(3),
 }).strict();

package/dist/cjs/inference/providerConnection.js

@@ -95,8 +95,7 @@ function isVisibleASCIIProviderCredential(value) {
             return false;
         const finalQuartet = offset + 4 === value.length;
         if (finalQuartet &&
-            ((padding === 2 && (second & 0x0f) !== 0) ||
-                (padding === 1 && (third & 0x03) !== 0))) {
+            ((padding === 2 && (second & 0x0f) !== 0) || (padding === 1 && (third & 0x03) !== 0))) {
             return false;
         }
         const packed = (first << 18) | (second << 12) | (third << 6) | fourth;
@@ -134,7 +133,11 @@ exports.kaanaCredentialRotateMutationSchema = exports.kaanaCredentialIdentitySch
     operationId: exports.kaanaCredentialOperationIdSchema,
     operationActor: kaanaCredentialOperationActorSchema,
     credentialHandle: exports.kaanaCredentialHandleSchema,
-    expectedRevision: zod_1.z.number().int().positive().max(Number.MAX_SAFE_INTEGER - 1),
+    expectedRevision: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .max(Number.MAX_SAFE_INTEGER - 1),
     secretBase64: kaanaCredentialSecretBase64Schema,
 })
     .strict();
@@ -145,7 +148,11 @@ exports.kaanaCredentialRevokeMutationSchema = exports.kaanaCredentialIdentitySch
     operationId: exports.kaanaCredentialOperationIdSchema,
     operationActor: kaanaCredentialOperationActorSchema,
     credentialHandle: exports.kaanaCredentialHandleSchema,
-    expectedRevision: zod_1.z.number().int().positive().max(Number.MAX_SAFE_INTEGER - 1),
+    expectedRevision: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .max(Number.MAX_SAFE_INTEGER - 1),
 })
     .strict();
 exports.kaanaCredentialMutationSchema = zod_1.z.discriminatedUnion('action', [
@@ -166,7 +173,11 @@ exports.kaanaCredentialRotateOutcomeRequestSchema = exports.kaanaCredentialIdent
     action: zod_1.z.literal('rotate'),
     operationId: exports.kaanaCredentialOperationIdSchema,
     credentialHandle: exports.kaanaCredentialHandleSchema,
-    expectedRevision: zod_1.z.number().int().positive().max(Number.MAX_SAFE_INTEGER - 1),
+    expectedRevision: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .max(Number.MAX_SAFE_INTEGER - 1),
 })
     .strict();
 exports.kaanaCredentialRevokeOutcomeRequestSchema = exports.kaanaCredentialIdentitySchema
@@ -175,7 +186,11 @@ exports.kaanaCredentialRevokeOutcomeRequestSchema = exports.kaanaCredentialIdent
     action: zod_1.z.literal('revoke'),
     operationId: exports.kaanaCredentialOperationIdSchema,
     credentialHandle: exports.kaanaCredentialHandleSchema,
-    expectedRevision: zod_1.z.number().int().positive().max(Number.MAX_SAFE_INTEGER - 1),
+    expectedRevision: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .max(Number.MAX_SAFE_INTEGER - 1),
 })
     .strict();
 exports.kaanaCredentialOutcomeRequestSchema = zod_1.z.discriminatedUnion('action', [