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

package/dist/types/accountGraph.d.ts

@@ -118,7 +118,7 @@ export declare function isOperatorSwitchTargetKind(kind: AccountKind | null | un
  * Narrow an unknown value to an {@link AccountKind}.
  *
  * The user-DTO serializers read from structurally-permissive `unknown` sources
- * (a Drizzle row, a Mongo document, an already-formatted object), so each one
+ * (a Drizzle row, a raw document, an already-formatted object), so each one
  * would otherwise hand-roll this check and they would drift on what counts.
  */
 export declare function isAccountKind(value: unknown): value is AccountKind;

package/dist/types/commonsSignIn.d.ts

@@ -30,8 +30,8 @@
 import { z } from 'zod';
 /**
  * The closed set, as a value — consumed directly where a runtime list is
- * required (e.g. the Mongoose `enum` of `AuthSession.deniedReason`, which is
- * the storage-level guarantee that an unauthenticated caller can never write
+ * required (e.g. the `enum` of the `auth_sessions.denied_reason` column, which
+ * is the storage-level guarantee that an unauthenticated caller can never write
  * free-form text into the field).
  */
 export declare const COMMONS_DENY_REASONS: readonly ["declined", "not_me"];

package/dist/types/email/messages.d.ts

@@ -35,6 +35,29 @@ export type EmailFilterActionType = (typeof EMAIL_FILTER_ACTION_TYPES)[number];
 /** Lifecycle of a durable outbound delivery. */
 export declare const EMAIL_OUTBOX_STATUSES: readonly ["pending", "processing", "sent", "failed", "cancelled"];
 export type EmailOutboxStatus = (typeof EMAIL_OUTBOX_STATUSES)[number];
+/**
+ * Where a message the user sent stands, as its Sent copy reports it.
+ *
+ * A send is filed in Sent the moment the API accepts it and handed to the relay
+ * afterwards, so being in Sent no longer means having left. `sent` means the
+ * relay took it; `retrying` means an attempt failed and another is scheduled;
+ * `failed` means nothing more will happen on its own.
+ */
+export declare const EMAIL_DELIVERY_STATES: readonly ["sending", "retrying", "sent", "failed"];
+export type EmailDeliveryState = (typeof EMAIL_DELIVERY_STATES)[number];
+/**
+ * Why a delivery is retrying or failed, in words a client can translate.
+ *
+ * - `relay_unavailable`: the relay did not answer or answered 4xx (transient).
+ * - `relay_unconfigured`: this server has no relay; an operator must fix it.
+ * - `relay_auth`: the relay rejected Oxy's credential; an operator must fix it.
+ * - `rejected`: the relay refused this message with a 5xx.
+ * - `retries_exhausted`: it stayed `relay_unavailable` for the whole budget.
+ * - `bounced`: the relay took it, then a recipient's server refused it.
+ * - `cancelled`: the sender stopped it.
+ */
+export declare const EMAIL_DELIVERY_ERROR_CODES: readonly ["relay_unavailable", "relay_unconfigured", "relay_auth", "rejected", "retries_exhausted", "bounced", "cancelled"];
+export type EmailDeliveryErrorCode = (typeof EMAIL_DELIVERY_ERROR_CODES)[number];
 /** One addressee. A header without a display name carries `name: ''`. */
 export declare const emailMessageAddressSchema: z.ZodObject<{
     name: z.ZodString;
@@ -130,6 +153,39 @@ export declare const emailMessageHighlightSchema: z.ZodObject<{
     label: string;
 }>;
 export type EmailMessageHighlightWire = z.infer<typeof emailMessageHighlightSchema>;
+/**
+ * The delivery of a message the user sent. `error` is the relay's own words;
+ * `errorCode` is the same failure in the vocabulary above, and is `null` when
+ * there is nothing to explain — or when a newer server names a reason this
+ * client does not know yet, which then still reads as a delivery.
+ * `nextAttemptAt` is set only while `retrying`.
+ */
+export declare const emailMessageDeliverySchema: z.ZodObject<{
+    state: z.ZodEnum<["sending", "retrying", "sent", "failed"]>;
+    attempts: z.ZodNumber;
+    maxAttempts: z.ZodNumber;
+    nextAttemptAt: z.ZodNullable<z.ZodString>;
+    error: z.ZodNullable<z.ZodString>;
+    errorCode: z.ZodCatch<z.ZodNullable<z.ZodEnum<["relay_unavailable", "relay_unconfigured", "relay_auth", "rejected", "retries_exhausted", "bounced", "cancelled"]>>>;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    updatedAt: string;
+    state: "failed" | "sent" | "sending" | "retrying";
+    error: string | null;
+    attempts: number;
+    maxAttempts: number;
+    nextAttemptAt: string | null;
+    errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+}, {
+    updatedAt: string;
+    state: "failed" | "sent" | "sending" | "retrying";
+    error: string | null;
+    attempts: number;
+    maxAttempts: number;
+    nextAttemptAt: string | null;
+    errorCode?: unknown;
+}>;
+export type EmailMessageDeliveryWire = z.infer<typeof emailMessageDeliverySchema>;
 /**
  * A stored message as every `/email` read returns it.
  *
@@ -294,6 +350,36 @@ export declare const emailMessageSchema: z.ZodObject<{
     /** Present only on list reads that walked the thread. */
     threadCount: z.ZodOptional<z.ZodNumber>;
     threadParticipants: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Present only on a message the user sent through Oxy since delivery was
+     * tracked; absent on received mail. A delivery this client cannot read is
+     * dropped rather than allowed to drop the message with it.
+     */
+    delivery: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        state: z.ZodEnum<["sending", "retrying", "sent", "failed"]>;
+        attempts: z.ZodNumber;
+        maxAttempts: z.ZodNumber;
+        nextAttemptAt: z.ZodNullable<z.ZodString>;
+        error: z.ZodNullable<z.ZodString>;
+        errorCode: z.ZodCatch<z.ZodNullable<z.ZodEnum<["relay_unavailable", "relay_unconfigured", "relay_auth", "rejected", "retries_exhausted", "bounced", "cancelled"]>>>;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        updatedAt: string;
+        state: "failed" | "sent" | "sending" | "retrying";
+        error: string | null;
+        attempts: number;
+        maxAttempts: number;
+        nextAttemptAt: string | null;
+        errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+    }, {
+        updatedAt: string;
+        state: "failed" | "sent" | "sending" | "retrying";
+        error: string | null;
+        attempts: number;
+        maxAttempts: number;
+        nextAttemptAt: string | null;
+        errorCode?: unknown;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     date: string;
     id: string;
@@ -373,6 +459,15 @@ export declare const emailMessageSchema: z.ZodObject<{
     senderAvatarPath?: string | null | undefined;
     threadCount?: number | undefined;
     threadParticipants?: string[] | undefined;
+    delivery?: {
+        updatedAt: string;
+        state: "failed" | "sent" | "sending" | "retrying";
+        error: string | null;
+        attempts: number;
+        maxAttempts: number;
+        nextAttemptAt: string | null;
+        errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+    } | undefined;
 }, {
     date: string;
     id: string;
@@ -452,6 +547,7 @@ export declare const emailMessageSchema: z.ZodObject<{
     senderAvatarPath?: string | null | undefined;
     threadCount?: number | undefined;
     threadParticipants?: string[] | undefined;
+    delivery?: unknown;
 }>;
 export type EmailMessageWire = z.infer<typeof emailMessageSchema>;
 export declare const emailMailboxSchema: z.ZodObject<{
@@ -898,6 +994,36 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
         /** Present only on list reads that walked the thread. */
         threadCount: z.ZodOptional<z.ZodNumber>;
         threadParticipants: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * Present only on a message the user sent through Oxy since delivery was
+         * tracked; absent on received mail. A delivery this client cannot read is
+         * dropped rather than allowed to drop the message with it.
+         */
+        delivery: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            state: z.ZodEnum<["sending", "retrying", "sent", "failed"]>;
+            attempts: z.ZodNumber;
+            maxAttempts: z.ZodNumber;
+            nextAttemptAt: z.ZodNullable<z.ZodString>;
+            error: z.ZodNullable<z.ZodString>;
+            errorCode: z.ZodCatch<z.ZodNullable<z.ZodEnum<["relay_unavailable", "relay_unconfigured", "relay_auth", "rejected", "retries_exhausted", "bounced", "cancelled"]>>>;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            updatedAt: string;
+            state: "failed" | "sent" | "sending" | "retrying";
+            error: string | null;
+            attempts: number;
+            maxAttempts: number;
+            nextAttemptAt: string | null;
+            errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+        }, {
+            updatedAt: string;
+            state: "failed" | "sent" | "sending" | "retrying";
+            error: string | null;
+            attempts: number;
+            maxAttempts: number;
+            nextAttemptAt: string | null;
+            errorCode?: unknown;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
         date: string;
         id: string;
@@ -977,6 +1103,15 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
         senderAvatarPath?: string | null | undefined;
         threadCount?: number | undefined;
         threadParticipants?: string[] | undefined;
+        delivery?: {
+            updatedAt: string;
+            state: "failed" | "sent" | "sending" | "retrying";
+            error: string | null;
+            attempts: number;
+            maxAttempts: number;
+            nextAttemptAt: string | null;
+            errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+        } | undefined;
     }, {
         date: string;
         id: string;
@@ -1056,6 +1191,7 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
         senderAvatarPath?: string | null | undefined;
         threadCount?: number | undefined;
         threadParticipants?: string[] | undefined;
+        delivery?: unknown;
     }>, "many">;
     bundles: z.ZodArray<z.ZodObject<{
         bundle: z.ZodObject<{
@@ -1255,6 +1391,36 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             /** Present only on list reads that walked the thread. */
             threadCount: z.ZodOptional<z.ZodNumber>;
             threadParticipants: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /**
+             * Present only on a message the user sent through Oxy since delivery was
+             * tracked; absent on received mail. A delivery this client cannot read is
+             * dropped rather than allowed to drop the message with it.
+             */
+            delivery: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                state: z.ZodEnum<["sending", "retrying", "sent", "failed"]>;
+                attempts: z.ZodNumber;
+                maxAttempts: z.ZodNumber;
+                nextAttemptAt: z.ZodNullable<z.ZodString>;
+                error: z.ZodNullable<z.ZodString>;
+                errorCode: z.ZodCatch<z.ZodNullable<z.ZodEnum<["relay_unavailable", "relay_unconfigured", "relay_auth", "rejected", "retries_exhausted", "bounced", "cancelled"]>>>;
+                updatedAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                updatedAt: string;
+                state: "failed" | "sent" | "sending" | "retrying";
+                error: string | null;
+                attempts: number;
+                maxAttempts: number;
+                nextAttemptAt: string | null;
+                errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+            }, {
+                updatedAt: string;
+                state: "failed" | "sent" | "sending" | "retrying";
+                error: string | null;
+                attempts: number;
+                maxAttempts: number;
+                nextAttemptAt: string | null;
+                errorCode?: unknown;
+            }>>>;
         }, "strip", z.ZodTypeAny, {
             date: string;
             id: string;
@@ -1334,6 +1500,15 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: {
+                updatedAt: string;
+                state: "failed" | "sent" | "sending" | "retrying";
+                error: string | null;
+                attempts: number;
+                maxAttempts: number;
+                nextAttemptAt: string | null;
+                errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+            } | undefined;
         }, {
             date: string;
             id: string;
@@ -1413,6 +1588,7 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: unknown;
         }>, "many">;
         unreadCount: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
@@ -1495,6 +1671,15 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: {
+                updatedAt: string;
+                state: "failed" | "sent" | "sending" | "retrying";
+                error: string | null;
+                attempts: number;
+                maxAttempts: number;
+                nextAttemptAt: string | null;
+                errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+            } | undefined;
         }[];
         bundle: {
             name: string;
@@ -1591,6 +1776,7 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: unknown;
         }[];
         bundle: {
             name: string;
@@ -1690,6 +1876,15 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
         senderAvatarPath?: string | null | undefined;
         threadCount?: number | undefined;
         threadParticipants?: string[] | undefined;
+        delivery?: {
+            updatedAt: string;
+            state: "failed" | "sent" | "sending" | "retrying";
+            error: string | null;
+            attempts: number;
+            maxAttempts: number;
+            nextAttemptAt: string | null;
+            errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+        } | undefined;
     }[];
     bundles: {
         messages: {
@@ -1771,6 +1966,15 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: {
+                updatedAt: string;
+                state: "failed" | "sent" | "sending" | "retrying";
+                error: string | null;
+                attempts: number;
+                maxAttempts: number;
+                nextAttemptAt: string | null;
+                errorCode: "rejected" | "cancelled" | "relay_unavailable" | "relay_unconfigured" | "relay_auth" | "retries_exhausted" | "bounced" | null;
+            } | undefined;
         }[];
         bundle: {
             name: string;
@@ -1869,6 +2073,7 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
         senderAvatarPath?: string | null | undefined;
         threadCount?: number | undefined;
         threadParticipants?: string[] | undefined;
+        delivery?: unknown;
     }[];
     bundles: {
         messages: {
@@ -1950,6 +2155,7 @@ export declare const emailBundledInboxSchema: z.ZodObject<{
             senderAvatarPath?: string | null | undefined;
             threadCount?: number | undefined;
             threadParticipants?: string[] | undefined;
+            delivery?: unknown;
         }[];
         bundle: {
             name: string;
@@ -2035,8 +2241,8 @@ export declare const emailOutboxSchema: z.ZodObject<{
     messageId: string;
     attempts: number;
     maxAttempts: number;
-    terminal: boolean;
     nextAttemptAt: string;
+    terminal: boolean;
     lastError: string | null;
     sentAt: string | null;
 }, {
@@ -2047,8 +2253,8 @@ export declare const emailOutboxSchema: z.ZodObject<{
     messageId: string;
     attempts: number;
     maxAttempts: number;
-    terminal: boolean;
     nextAttemptAt: string;
+    terminal: boolean;
     lastError: string | null;
     sentAt: string | null;
 }>;

package/dist/types/identity.d.ts

@@ -417,7 +417,7 @@ export declare const exportFinancialSectionSchema: z.ZodType<ExportFinancialSect
  * `proof` when the user signed the bundle with their own key.
  */
 export interface ExportBundle {
-    '$schema': string;
+    $schema: string;
     exportedAt: string;
     did: string;
     didDocument: DidDocument;

package/dist/types/index.d.ts

@@ -106,8 +106,8 @@ export { catalogInvocationPathParameters, catalogInvocationsOverlap, catalogInvo
 export type { CatalogInvocationMatch, CatalogInvocationTemplate, ResolvedCatalogInvocation, } from './capabilityInvocation';
 export { emailContextAddressSchema, emailContextMailboxSchema, emailContextMessageSchema, emailAgentContextSchema, } from './emailAgentContext';
 export type { EmailContextAddress, EmailContextMailbox, EmailContextMessage, EmailAgentContext, } from './emailAgentContext';
-export { inboxComposeRequestSchema, inboxDailyBriefRequestSchema, inboxNaturalSearchRequestSchema, inboxMessageInferenceParamsSchema, inboxInferenceTextResponseSchema, inboxNaturalSearchResponseSchema, inboxSmartRepliesResponseSchema, inboxThreadSummaryResponseSchema, inboxInferenceStreamEventSchema, } from './inference/inbox';
-export type { InboxComposeRequest, InboxDailyBriefRequest, InboxInferenceTextResponse, InboxNaturalSearchResponse, InboxSmartRepliesResponse, InboxThreadSummaryResponse, InboxInferenceStreamEvent, } from './inference/inbox';
+export { inboxComposeRequestSchema, inboxDailyBriefRequestSchema, inboxDailyBriefResponseSchema, INBOX_DAILY_BRIEF_SECTIONS, inboxNaturalSearchRequestSchema, inboxMessageInferenceParamsSchema, inboxInferenceTextResponseSchema, inboxNaturalSearchResponseSchema, inboxSmartRepliesResponseSchema, inboxThreadSummaryResponseSchema, inboxInferenceStreamEventSchema, } from './inference/inbox';
+export type { InboxComposeRequest, InboxDailyBriefRequest, InboxDailyBriefResponse, InboxDailyBriefSection, InboxInferenceTextResponse, InboxNaturalSearchResponse, InboxSmartRepliesResponse, InboxThreadSummaryResponse, InboxInferenceStreamEvent, } from './inference/inbox';
 export * from './externalIdentity';
 export * from './linkedAccounts';
 export * from './federationInstanceFetch';
@@ -116,19 +116,19 @@ export * from './email/messages';
 export * from './stickers';
 export { decisionEffortSchema, decisionQuestionSchema, decisionInputSchema, decisionRequestSchema, decisionAnswerSchema, decisionResultSchema, decisionSuccessSchema, decisionFailureSchema, decisionInputBudget, decisionFitsGateway, decisionAnswersMatch, } from './inference/decisions';
 export type { DecisionQuestion, DecisionInput, DecisionRequest, DecisionAnswer, DecisionFailure, DecisionResult, DecisionSuccess, } from './inference/decisions';
-export { SCOPED_EXECUTION_CONTRACT_VERSION, SCOPED_REQUEST_ENVELOPE_VERSION, scopedExecutionAudienceSchema, scopedExecutionSchema, canonicalScopedExecutionJson } from './inference/scopedExecution';
+export { SCOPED_EXECUTION_CONTRACT_VERSION, SCOPED_REQUEST_ENVELOPE_VERSION, scopedExecutionAudienceSchema, scopedExecutionSchema, canonicalScopedExecutionJson, } from './inference/scopedExecution';
 export type { ScopedExecutionAudience, ScopedExecution } from './inference/scopedExecution';
 export { scopedInferenceRequestSchema } from './inference/request';
 export type { ScopedInferenceRequest } from './inference/request';
 export { PRIVATE_AUTO_EXECUTION_CONTRACT_VERSION, PRIVATE_AUTO_REQUEST_ENVELOPE_VERSION, PRIVATE_AUTO_LIMITS, PRIVATE_AUTO_INSTRUCTIONS, PRIVATE_AUTO_QUESTION, privateAutoPrincipalSchema, privateAutoSourceApprovalSchema, privateAutoExecutionSchema, privateAutoInputSchema, privateAutoOperationId, } from './inference/privateAutoExecution';
-export type { PrivateAutoPrincipal, PrivateAutoSourceApproval, PrivateAutoExecution } from './inference/privateAutoExecution';
+export type { PrivateAutoPrincipal, PrivateAutoSourceApproval, PrivateAutoExecution, } from './inference/privateAutoExecution';
 export { privateAutoInferenceRequestSchema } from './inference/request';
 export type { PrivateAutoInferenceRequest } from './inference/request';
 export { productDefinitionSchema, subjectProductAccessQuerySchema, productBenefitSchema, productOfferSchema, productSubscriptionSourceSchema, productAccessGrantSchema, subjectProductGrantSnapshotSchema, productOfferSegmentSchema, subjectProductAccessSchema, } from './products/access';
 export type { ProductDefinition, SubjectProductAccessQuery, SubjectProductGrantSnapshot, ProductBenefit, ProductOffer, ProductSubscriptionSource, ProductAccessGrant, ProductOfferSegment, SubjectProductAccess, } from './products/access';
-export { meteredGenerationSchema, type MeteredGeneration } from "./inference/economics";
-export { canonicalCapabilityJson, inputSatisfiesCapabilityLimits, isLoopbackOrigin } from './capabilityBindings';
+export { meteredGenerationSchema, type MeteredGeneration } from './inference/economics';
+export { canonicalCapabilityJson, inputSatisfiesCapabilityLimits, isLoopbackOrigin, } from './capabilityBindings';
 export * from './agentKeys';
-export { productSubscriptionSummarySchema, productSubscriptionsResponseSchema, subscriptionCreditGrantSchema, subscriptionCreditGrantsResponseSchema, cancelProductSubscriptionSchema, productSubscriptionCancellationResultSchema, type ProductSubscriptionSummary, type SubscriptionCreditGrant, type ProductSubscriptionCancellationResult } from './products/billing';
-export { personalPlanDisplayPriceSchema, personalPlanCatalogueSchema, type PersonalPlanCatalogue } from './products/plans';
+export { productSubscriptionSummarySchema, productSubscriptionsResponseSchema, subscriptionCreditGrantSchema, subscriptionCreditGrantsResponseSchema, cancelProductSubscriptionSchema, productSubscriptionCancellationResultSchema, type ProductSubscriptionSummary, type SubscriptionCreditGrant, type ProductSubscriptionCancellationResult, } from './products/billing';
+export { personalPlanDisplayPriceSchema, personalPlanCatalogueSchema, type PersonalPlanCatalogue, } from './products/plans';
 export * from './products/checkout';

package/dist/types/inference/decisions.d.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from 'zod';
 export declare const decisionEffortSchema: z.ZodEnum<["instant", "low", "medium", "high", "xhigh"]>;
 export declare const decisionQuestionSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"choice">;

package/dist/types/inference/inbox.d.ts

@@ -66,23 +66,24 @@ export declare const inboxComposeRequestSchema: z.ZodDiscriminatedUnion<"operati
 export declare const inboxDailyBriefRequestSchema: z.ZodEffects<z.ZodObject<{
     startAt: z.ZodEffects<z.ZodString, string, string>;
     endAt: z.ZodEffects<z.ZodString, string, string>;
-    stream: z.ZodOptional<z.ZodBoolean>;
+    /** BCP 47 tag of the language the brief is written in; English when absent. */
+    locale: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     startAt: string;
     endAt: string;
-    stream?: boolean | undefined;
+    locale?: string | undefined;
 }, {
     startAt: string;
     endAt: string;
-    stream?: boolean | undefined;
+    locale?: string | undefined;
 }>, {
     startAt: string;
     endAt: string;
-    stream?: boolean | undefined;
+    locale?: string | undefined;
 }, {
     startAt: string;
     endAt: string;
-    stream?: boolean | undefined;
+    locale?: string | undefined;
 }>;
 export declare const inboxNaturalSearchRequestSchema: z.ZodObject<{
     query: z.ZodString;
@@ -179,6 +180,127 @@ export declare const inboxNaturalSearchResponseSchema: z.ZodObject<{
     };
     interpretation: string;
 }>;
+/** Where the brief puts a message: it asks something of the owner, it is today's news, or it is still unread from before. */
+export declare const INBOX_DAILY_BRIEF_SECTIONS: readonly ["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.
+ */
+export declare const inboxDailyBriefResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    generationId: z.ZodOptional<z.ZodString>;
+    summary: z.ZodString;
+    counts: z.ZodObject<{
+        received: z.ZodNumber;
+        unread: z.ZodNumber;
+        starred: z.ZodNumber;
+        earlierUnread: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        received: number;
+        starred: number;
+        unread: number;
+        earlierUnread: number;
+    }, {
+        received: number;
+        starred: number;
+        unread: number;
+        earlierUnread: number;
+    }>;
+    items: z.ZodArray<z.ZodObject<{
+        messageId: z.ZodString;
+        section: z.ZodEnum<["needs_you", "today", "earlier"]>;
+        note: z.ZodString;
+        from: z.ZodObject<{
+            name: z.ZodNullable<z.ZodString>;
+            address: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            name: string | null;
+            address: string;
+        }, {
+            name: string | null;
+            address: string;
+        }>;
+        subject: z.ZodString;
+        receivedAt: z.ZodString;
+        unread: z.ZodBoolean;
+        hasAttachments: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        subject: string;
+        messageId: string;
+        from: {
+            name: string | null;
+            address: string;
+        };
+        receivedAt: string;
+        unread: boolean;
+        section: "needs_you" | "today" | "earlier";
+        note: string;
+        hasAttachments: boolean;
+    }, {
+        subject: string;
+        messageId: string;
+        from: {
+            name: string | null;
+            address: string;
+        };
+        receivedAt: string;
+        unread: boolean;
+        section: "needs_you" | "today" | "earlier";
+        note: string;
+        hasAttachments: boolean;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: 1;
+    requestId: string;
+    summary: string;
+    counts: {
+        received: number;
+        starred: number;
+        unread: number;
+        earlierUnread: number;
+    };
+    items: {
+        subject: string;
+        messageId: string;
+        from: {
+            name: string | null;
+            address: string;
+        };
+        receivedAt: string;
+        unread: boolean;
+        section: "needs_you" | "today" | "earlier";
+        note: string;
+        hasAttachments: boolean;
+    }[];
+    generationId?: string | undefined;
+}, {
+    schemaVersion: 1;
+    requestId: string;
+    summary: string;
+    counts: {
+        received: number;
+        starred: number;
+        unread: number;
+        earlierUnread: number;
+    };
+    items: {
+        subject: string;
+        messageId: string;
+        from: {
+            name: string | null;
+            address: string;
+        };
+        receivedAt: string;
+        unread: boolean;
+        section: "needs_you" | "today" | "earlier";
+        note: string;
+        hasAttachments: boolean;
+    }[];
+    generationId?: string | undefined;
+}>;
 export declare const inboxSmartRepliesResponseSchema: z.ZodObject<{
     replies: z.ZodArray<z.ZodString, "many">;
 }, "strict", z.ZodTypeAny, {
@@ -367,6 +489,8 @@ export declare const inboxInferenceStreamEventSchema: z.ZodDiscriminatedUnion<"t
 }>]>;
 export type InboxComposeRequest = z.infer<typeof inboxComposeRequestSchema>;
 export type InboxDailyBriefRequest = z.infer<typeof inboxDailyBriefRequestSchema>;
+export type InboxDailyBriefResponse = z.infer<typeof inboxDailyBriefResponseSchema>;
+export type InboxDailyBriefSection = (typeof INBOX_DAILY_BRIEF_SECTIONS)[number];
 export type InboxInferenceTextResponse = z.infer<typeof inboxInferenceTextResponseSchema>;
 export type InboxNaturalSearchResponse = z.infer<typeof inboxNaturalSearchResponseSchema>;
 export type InboxSmartRepliesResponse = z.infer<typeof inboxSmartRepliesResponseSchema>;

package/dist/types/inference/realtime.d.ts

@@ -83,7 +83,7 @@
  *
  * Decided in: OxyHQ/Kaana#90.
  */
-import { z } from "zod";
+import { z } from 'zod';
 /**
  * The most base64 characters one audio frame may carry: 49 152 bytes of audio,
  * about one second of 24 kHz mono PCM16. Bounded so no frame is large enough to

package/dist/types/inference/scopedExecution.d.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from 'zod';
 /** Explicit extension negotiation; never replaces the legacy 3.5 handshake. */
 export declare const SCOPED_EXECUTION_CONTRACT_VERSION: "3.6.0";
 /** Scoped only; normal envelope v2 and metadata 3.5 remain unchanged. */

package/dist/types/moderationReputation.d.ts

@@ -273,7 +273,7 @@ export declare const reverseModerationEffectSchema: z.ZodType<ReverseModerationE
  * are reported so the figure is explainable without re-running the engine.
  */
 export interface ModerationEffect {
-    /** The effect's own id (its Mongo `_id` as a string). */
+    /** The effect's own id, as a string. */
     id: string;
     incidentId: string;
     caseId: string;

package/dist/types/oxyRecordTypes.d.ts

@@ -7,8 +7,8 @@
  * is rejected as `invalid_envelope`.
  *
  * `oxySignedRecordTypeSchema` is that runtime gate (the API's `verifyEnvelope`
- * re-narrows with it; the Mongoose `SignedRecord.type` enum and the Postgres
- * CHECK on `signed_records.type` are both derived from `.options`);
+ * re-narrows with it; the Postgres CHECK on `signed_records.type` is derived
+ * from `.options`);
  * `OxySignedRecordType` is the matching compile-time union the SDK
  * identity/civic mixins type against.
  *