@canonmsg/backend-contracts 1.8.1 → 2.0.0

package/dist/cjs/controlSignals.js

@@ -1,44 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ControlPrimitiveEventSchema = exports.ControlSessionEventSchema = exports.ControlSignalEventSchema = exports.ControlPrimitiveMapSchema = exports.ControlSessionNodeSchema = exports.ControlSignalNodeSchema = exports.ControlChannelKeySchema = exports.ControlSignalTypeSchema = void 0;
-// Wire contract v1 — RTDB control-channel signal + session-control records.
-//
-// Grounded in @canonmsg/core's ControlChannelPoller (the consumer every host
-// uses for `/control/{conversationId}/{agentId}` reads) and stream-service's
-// `runtime.control` mirror. Three channel keys, read in order:
-//   session   — human changed a runtime control (model/effort/permission …)
-//   signal    — interrupt / stop_and_drop / new_session
-//   primitive — keyed request map (requestId → value)
-const zod_1 = require("zod");
-exports.ControlSignalTypeSchema = zod_1.z.enum(['interrupt', 'stop_and_drop', 'new_session']);
-exports.ControlChannelKeySchema = zod_1.z.enum(['session', 'signal', 'primitive']);
-// ── RTDB node records (what is written at /control/{convo}/{agent}/…) ──
-/** `/control/{convo}/{agent}/signal` node. Consumed by writing null. */
-exports.ControlSignalNodeSchema = zod_1.z.looseObject({
-    type: exports.ControlSignalTypeSchema,
-    updatedAt: zod_1.z.number().optional(),
-});
-/** `/control/{convo}/{agent}/session` node — the session-control primitive record. */
-exports.ControlSessionNodeSchema = zod_1.z.looseObject({
-    updatedAt: zod_1.z.number().optional(),
-});
-/** `/control/{convo}/{agent}/primitive` — map of requestId → request value. */
-exports.ControlPrimitiveMapSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()));
-// ── Dispatched events (what a runtime's handler receives) ──────────────
-exports.ControlSignalEventSchema = zod_1.z.object({
-    conversationId: zod_1.z.string(),
-    type: exports.ControlSignalTypeSchema,
-    updatedAt: zod_1.z.number(),
-    raw: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
-});
-exports.ControlSessionEventSchema = zod_1.z.object({
-    conversationId: zod_1.z.string(),
-    updatedAt: zod_1.z.number(),
-    control: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
-});
-exports.ControlPrimitiveEventSchema = zod_1.z.object({
-    conversationId: zod_1.z.string(),
-    requestId: zod_1.z.string(),
-    updatedAt: zod_1.z.number(),
-    value: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
-});

package/dist/cjs/endpointRegistry.js

@@ -1,264 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CANON_MEDIA_UPLOAD_ENDPOINT = exports.CANON_REST_ENDPOINTS = void 0;
-const restEndpoints_js_1 = require("./restEndpoints.js");
-const sendContextual_js_1 = require("./sendContextual.js");
-exports.CANON_REST_ENDPOINTS = [
-    // ── Identity ─────────────────────────────────────────────────────────
-    {
-        method: 'POST',
-        path: '/agents/register',
-        section: 'identity',
-        note: 'Public registration request. No API key required.',
-    },
-    {
-        method: 'GET',
-        path: '/agents/status/:requestId',
-        section: 'identity',
-        note: 'Poll approval status. Requires `x-canon-poll-token` with the `pollToken` returned by registration. After approval, the response includes the `apiKey` plaintext until the request is acknowledged.',
-    },
-    {
-        method: 'POST',
-        path: '/agents/status/:requestId/ack',
-        section: 'identity',
-        note: 'Acknowledge delivery. Requires `x-canon-poll-token`; clears the plaintext key from the registration request record so subsequent GET reads return `apiKeyDelivered: true`. Unacked plaintext keys are also auto-scrubbed 48 hours after approval; subsequent GET reads then return `apiKeyExpired: true` and the registrant must re-register (or the owner re-issues via key rotation).',
-    },
-    {
-        method: 'GET',
-        path: '/agents/me',
-        section: 'identity',
-        note: 'Authenticated agent identity and context.',
-    },
-    {
-        method: 'PATCH',
-        path: '/agents/profile',
-        section: 'identity',
-        note: 'Update agent profile fields.',
-    },
-    {
-        method: 'POST',
-        path: '/agents/auth-token',
-        section: 'identity',
-        note: 'Exchange API key for live agent-channel access when needed.',
-    },
-    {
-        method: 'POST',
-        path: '/agents/keys/rotate',
-        section: 'identity',
-        note: 'Agent-initiated key rotation. Returns the new plaintext key once.',
-    },
-    // ── Messaging ────────────────────────────────────────────────────────
-    {
-        method: 'POST',
-        path: '/messages/send',
-        section: 'messaging',
-        note: 'Send a durable message into a conversation.',
-        request: restEndpoints_js_1.SendMessageRequestSchema,
-        response: restEndpoints_js_1.SendMessageResponseSchema,
-    },
-    {
-        method: 'POST',
-        path: '/messages/send-contextual',
-        section: 'messaging',
-        note: 'Cross-conversation message with private agent self-context.',
-        request: sendContextual_js_1.SendContextualRequestSchema,
-        response: sendContextual_js_1.SendContextualResponseSchema,
-    },
-    {
-        method: 'POST',
-        path: '/messages/react',
-        section: 'messaging',
-        note: 'Toggle an emoji reaction.',
-        request: restEndpoints_js_1.ReactRequestSchema,
-        response: restEndpoints_js_1.ReactResponseSchema,
-    },
-    {
-        method: 'POST',
-        path: '/messages/forward',
-        section: 'messaging',
-        note: 'Forward an existing message.',
-        request: restEndpoints_js_1.ForwardMessageRequestSchema,
-        response: restEndpoints_js_1.ForwardMessageResponseSchema,
-    },
-    {
-        method: 'DELETE',
-        path: '/conversations/:conversationId/messages/:messageId',
-        section: 'messaging',
-        note: "Soft-delete the agent's own message.",
-    },
-    {
-        method: 'PATCH',
-        path: '/conversations/:conversationId/messages/:messageId/disposition',
-        section: 'messaging',
-        note: 'Update message disposition metadata.',
-        request: restEndpoints_js_1.UpdateDispositionRequestSchema,
-    },
-    {
-        method: 'POST',
-        path: '/typing',
-        section: 'messaging',
-        note: 'Publish typing state.',
-        request: restEndpoints_js_1.SetTypingRequestSchema,
-    },
-    {
-        method: 'POST',
-        path: '/streaming',
-        section: 'messaging',
-        note: 'Publish live streaming/progress state through REST. Most current runtimes prefer shared live-state helpers.',
-        request: restEndpoints_js_1.SetStreamingRequestSchema,
-    },
-    // ── Conversations ────────────────────────────────────────────────────
-    {
-        method: 'GET',
-        path: '/conversations',
-        section: 'conversations',
-        note: 'List conversations the agent participates in.',
-        response: restEndpoints_js_1.ConversationsResponseSchema,
-    },
-    {
-        method: 'GET',
-        path: '/conversations/:conversationId/messages',
-        section: 'conversations',
-        note: 'Fetch recent messages.',
-        request: restEndpoints_js_1.GetMessagesQuerySchema,
-        response: restEndpoints_js_1.MessagesPageResponseSchema,
-    },
-    {
-        method: 'POST',
-        path: '/conversations/create',
-        section: 'conversations',
-        note: 'Create or find a direct/group conversation when allowed.',
-        request: restEndpoints_js_1.CreateConversationRequestSchema,
-        response: restEndpoints_js_1.CreateConversationResponseSchema,
-    },
-    {
-        method: 'PATCH',
-        path: '/conversations/:conversationId/topic',
-        section: 'conversations',
-        note: 'Update the topic.',
-    },
-    {
-        method: 'PATCH',
-        path: '/conversations/:conversationId/name',
-        section: 'conversations',
-        note: 'Update group name when allowed.',
-    },
-    {
-        method: 'PATCH',
-        path: '/conversations/:conversationId/avatar',
-        section: 'conversations',
-        note: 'Update group avatar when allowed.',
-    },
-    {
-        method: 'POST',
-        path: '/conversations/:conversationId/read',
-        section: 'conversations',
-        note: 'Mark read.',
-    },
-    {
-        method: 'POST',
-        path: '/conversations/:conversationId/mute',
-        section: 'conversations',
-        note: 'Mute for the agent.',
-    },
-    {
-        method: 'POST',
-        path: '/conversations/:conversationId/unmute',
-        section: 'conversations',
-        note: 'Unmute for the agent.',
-    },
-    {
-        method: 'POST',
-        path: '/conversations/:conversationId/hide',
-        section: 'conversations',
-        note: 'Hide until new inbound activity.',
-    },
-    {
-        method: 'POST',
-        path: '/conversations/:conversationId/leave',
-        section: 'conversations',
-        note: 'Leave a group.',
-    },
-    {
-        method: 'POST',
-        path: '/conversations/:conversationId/members',
-        section: 'conversations',
-        note: 'Add a member when allowed.',
-    },
-    {
-        method: 'DELETE',
-        path: '/conversations/:conversationId/members/:userId',
-        section: 'conversations',
-        note: 'Remove a member when allowed.',
-    },
-    // ── Contacts and access ──────────────────────────────────────────────
-    {
-        method: 'POST',
-        path: '/contacts/request',
-        section: 'contacts',
-        note: 'Agent-side request for access.',
-        request: restEndpoints_js_1.CreateContactRequestRequestSchema,
-        response: restEndpoints_js_1.CreateContactRequestResponseSchema,
-    },
-    {
-        method: 'GET',
-        path: '/contacts/requests',
-        section: 'contacts',
-        note: 'Read-only awareness surface for requests involving the agent.',
-    },
-    {
-        method: 'GET',
-        path: '/contacts',
-        section: 'contacts',
-        note: "List the authenticated agent's contacts.",
-        response: restEndpoints_js_1.ContactsResponseSchema,
-    },
-    {
-        method: 'GET',
-        path: '/contacts/:contactId',
-        section: 'contacts',
-        note: 'Fetch a single contact entry; 404 if missing.',
-        response: restEndpoints_js_1.RestContactSchema,
-    },
-    {
-        method: 'DELETE',
-        path: '/contacts/:contactId',
-        section: 'contacts',
-        note: 'Remove a contact.',
-    },
-    {
-        method: 'POST',
-        path: '/users/block',
-        section: 'contacts',
-        note: 'Block a user.',
-    },
-    {
-        method: 'POST',
-        path: '/users/unblock',
-        section: 'contacts',
-        note: 'Unblock a user.',
-    },
-    {
-        method: 'POST',
-        path: '/admission/resolve',
-        section: 'contacts',
-        note: 'Resolve live admission state for a target user (used by `agent.reachOut` and contact-card CTAs to avoid acting on stale snapshots).',
-        request: restEndpoints_js_1.ResolveAdmissionRequestSchema,
-        response: restEndpoints_js_1.ResolveAdmissionResponseSchema,
-    },
-    {
-        method: 'POST',
-        path: '/admission/resolve-group',
-        section: 'contacts',
-        note: 'Resolve live group-join admission state (reads `groupJoinPolicy`).',
-    },
-];
-// Referenced for completeness of the registry import surface.
-exports.CANON_MEDIA_UPLOAD_ENDPOINT = {
-    method: 'POST',
-    path: '/media/upload',
-    section: 'messaging',
-    note: 'Upload media; returns a Storage URL plus a normalized attachment.',
-    request: restEndpoints_js_1.UploadMediaRequestSchema,
-    response: restEndpoints_js_1.UploadMediaResponseSchema,
-};

package/dist/cjs/inboundFrame.js

@@ -1,92 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InboundFrameV1Schema = exports.InboundFrameGroupContextV1Schema = exports.InboundFrameReplyContextV1Schema = exports.InboundFrameContactCardV1Schema = exports.InboundFrameAttachmentV1Schema = exports.InboundFrameShapeV1Schema = exports.INBOUND_FRAME_SCHEMA_V1 = void 0;
-// Wire contract v1 — the canon.inbound_frame.v1 schema.
-//
-// Mirrors @canonmsg/core's CanonInboundFrameV1 (core/src/inbound-frame.ts),
-// the structured projection every host/adapter renders its inbound prompt
-// from. core keeps building the frame; a follow-up (post-P2 merge) flips core
-// to infer its type from this schema. A compile-time assignability guard
-// between core's type and this schema lives in @canonmsg/test-fixtures.
-const zod_1 = require("zod");
-const message_js_1 = require("./message.js");
-const sseEvents_js_1 = require("./sseEvents.js");
-exports.INBOUND_FRAME_SCHEMA_V1 = 'canon.inbound_frame.v1';
-exports.InboundFrameShapeV1Schema = zod_1.z.enum([
-    'direct_owner',
-    'direct_human',
-    'direct_agent',
-    'group',
-    'unknown',
-]);
-exports.InboundFrameAttachmentV1Schema = zod_1.z.object({
-    index: zod_1.z.number(),
-    kind: zod_1.z.enum(['image', 'audio', 'video', 'file']),
-    placeholder: zod_1.z.string(),
-    fileName: zod_1.z.string().nullable(),
-    mimeType: zod_1.z.string().nullable(),
-    sizeBytes: zod_1.z.number().nullable(),
-    width: zod_1.z.number().nullable(),
-    height: zod_1.z.number().nullable(),
-    durationMs: zod_1.z.number().nullable(),
-});
-exports.InboundFrameContactCardV1Schema = zod_1.z.object({
-    userId: zod_1.z.string(),
-    canonContactId: zod_1.z.string().nullable(),
-    displayName: zod_1.z.string(),
-    userType: zod_1.z.enum(['human', 'ai_agent']),
-    ownerName: zod_1.z.string().nullable(),
-    about: zod_1.z.string().nullable(),
-});
-/** CanonTurnContextReplyContextV2 — the reply-to summary carried by the frame. */
-exports.InboundFrameReplyContextV1Schema = zod_1.z.object({
-    messageId: zod_1.z.string(),
-    found: zod_1.z.boolean(),
-    senderId: zod_1.z.string().nullable(),
-    senderName: zod_1.z.string().nullable(),
-    senderType: zod_1.z.enum(['human', 'ai_agent']).nullable(),
-    contentType: message_js_1.SerializedContentTypeSchema.nullable(),
-    text: zod_1.z.string().nullable(),
-    body: zod_1.z.string(),
-    replyToPosition: zod_1.z.number().nullable(),
-    attachments: zod_1.z.array(exports.InboundFrameAttachmentV1Schema),
-    contactCard: exports.InboundFrameContactCardV1Schema.nullable(),
-});
-exports.InboundFrameGroupContextV1Schema = zod_1.z.object({
-    memberCount: zod_1.z.number(),
-    memberIds: zod_1.z.array(zod_1.z.string()),
-    ownerId: zod_1.z.string(),
-    ownerName: zod_1.z.string(),
-    ownerPresent: zod_1.z.boolean(),
-    knownRecentParticipants: zod_1.z.array(zod_1.z.object({
-        id: zod_1.z.string(),
-        name: zod_1.z.string(),
-        userType: zod_1.z.enum(['human', 'ai_agent', 'unknown']),
-        isOwner: zod_1.z.boolean(),
-        isSelf: zod_1.z.boolean(),
-    })),
-    membershipChange: sseEvents_js_1.SseMembershipChangeSchema.optional(),
-});
-exports.InboundFrameV1Schema = zod_1.z.object({
-    schema: zod_1.z.literal(exports.INBOUND_FRAME_SCHEMA_V1),
-    shape: exports.InboundFrameShapeV1Schema,
-    sender: zod_1.z.object({
-        name: zod_1.z.string(),
-        type: zod_1.z.enum(['human', 'ai_agent']),
-        isOwner: zod_1.z.boolean(),
-    }),
-    conversation: zod_1.z.object({
-        type: zod_1.z.enum(['direct', 'group', 'unknown']),
-        memberCount: zod_1.z.number().nullable(),
-    }),
-    addressed: zod_1.z.boolean(),
-    message: zod_1.z.object({
-        text: zod_1.z.string(),
-        contentType: message_js_1.SerializedContentTypeSchema.nullable(),
-    }),
-    replyContext: exports.InboundFrameReplyContextV1Schema.nullable(),
-    groupContext: exports.InboundFrameGroupContextV1Schema.nullable(),
-    groupContextMode: zod_1.z.enum(['initial', 'membership_change']).optional(),
-    selfContexts: zod_1.z.array(zod_1.z.string()),
-    behaviorInstructions: zod_1.z.array(zod_1.z.string()),
-});

package/dist/cjs/restEndpoints.js

@@ -1,237 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UploadMediaResponseSchema = exports.UploadMediaRequestSchema = exports.SetStreamingRequestSchema = exports.SetTypingRequestSchema = exports.ResolveAdmissionResponseSchema = exports.ResolveAdmissionRequestSchema = exports.ContactsResponseSchema = exports.CreateContactRequestResponseSchema = exports.CreateContactRequestRequestSchema = exports.CreateConversationResponseSchema = exports.CreateConversationRequestSchema = exports.MessagesPageResponseSchema = exports.GetMessagesQuerySchema = exports.ConversationsResponseSchema = exports.UpdateDispositionRequestSchema = exports.MarkReadResponseSchema = exports.DeleteMessageResponseSchema = exports.ForwardMessageResponseSchema = exports.ForwardMessageRequestSchema = exports.ReactResponseSchema = exports.ReactRequestSchema = exports.SendMessageResponseSchema = exports.SendMessageRequestSchema = exports.RestSessionSelectionSchema = exports.RestContactSchema = exports.RestConversationSchema = exports.RestConversationLastMessageSchema = exports.RestMessageSchema = exports.RestOkResponseSchema = void 0;
-// Wire contract v1 — request/response schemas for the agent-facing "Canon op"
-// REST surface the bridge proxies (bridge-local-api.md §B).
-//
-// Grounded in the Functions handlers (functions/src/api/*) and the canonical
-// consumer (@canonmsg/core CanonClient) — request bodies mirror what clients
-// send today, response schemas mirror what the handlers emit. This is a
-// re-expression of current behavior, not a redesign.
-const zod_1 = require("zod");
-const media_js_1 = require("./media.js");
-const message_js_1 = require("./message.js");
-const turnProtocol_js_1 = require("./turnProtocol.js");
-// ── Shared fragments ───────────────────────────────────────────────────
-exports.RestOkResponseSchema = zod_1.z.looseObject({
-    success: zod_1.z.boolean().optional(),
-});
-/** GET …/messages items — the serialized message plus the soft-delete flag. */
-exports.RestMessageSchema = message_js_1.SerializedMessageSchema.extend({
-    deleted: zod_1.z.boolean().optional(),
-});
-/**
- * STRICT WRITES, TOLERANT READS: this is a READ schema over live production
- * data, so it must describe what Firestore actually holds — not what today's
- * writers produce. The GET /conversations serializer
- * (functions/src/api/getConversations.ts) passes `lastMessage` fields through
- * from the conversation doc, and legacy rows (pre-refactor writes,
- * deleted-message repair) hold explicit nulls:
- * - `text` is serialized `?? null` and `timestamp` as
- *   `?.toDate?.()?.toISOString() ?? null` — both emit null by construction.
- * - `senderId` / `senderType` / `contentType` are raw pass-throughs; live
- *   rows exist with all three null (the getConversations "ghost fix" comment
- *   acknowledges null senderId).
- * - conversation `createdAt` is also serialized `?? null`.
- * Writers (onMessageCreated / deletedMessageRepair) stay strict — they always
- * produce the full shape; only the read contract admits the legacy nulls.
- */
-exports.RestConversationLastMessageSchema = zod_1.z.looseObject({
-    text: zod_1.z.string().nullable(),
-    messageId: zod_1.z.string().optional(),
-    senderId: zod_1.z.string().nullable().optional(),
-    senderType: zod_1.z.enum(['human', 'ai_agent']).nullable().optional(),
-    contentType: message_js_1.SerializedContentTypeSchema.nullable().optional(),
-    timestamp: zod_1.z.string().nullable(),
-});
-exports.RestConversationSchema = zod_1.z.looseObject({
-    id: zod_1.z.string(),
-    type: zod_1.z.enum(['direct', 'group']),
-    name: zod_1.z.string().nullable().optional(),
-    topic: zod_1.z.string().nullable().optional(),
-    memberIds: zod_1.z.array(zod_1.z.string()),
-    isAgentChat: zod_1.z.boolean().optional(),
-    /** Resolved agent behavior policy — opaque pass-through. */
-    behavior: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
-    hasUnread: zod_1.z.boolean().optional(),
-    lastMessage: exports.RestConversationLastMessageSchema.nullable(),
-    createdAt: zod_1.z.string().nullable().optional(),
-});
-exports.RestContactSchema = zod_1.z.object({
-    id: zod_1.z.string(),
-    source: zod_1.z.string(),
-    addedAt: zod_1.z.string().nullable(),
-    displayNameOverride: zod_1.z.string().nullable(),
-});
-exports.RestSessionSelectionSchema = zod_1.z.union([
-    zod_1.z.object({ mode: zod_1.z.enum(['new', 'continue_latest', 'continue_or_create']) }),
-    zod_1.z.object({ mode: zod_1.z.literal('specific'), conversationId: zod_1.z.string() }),
-]);
-// ── POST /messages/send ────────────────────────────────────────────────
-exports.SendMessageRequestSchema = zod_1.z.object({
-    conversationId: zod_1.z.string(),
-    text: zod_1.z.string().optional(),
-    /** Client-supplied idempotency id. */
-    messageId: zod_1.z.string().optional(),
-    contentType: message_js_1.SerializedContentTypeSchema.optional(),
-    replyTo: zod_1.z.string().optional(),
-    replyToPosition: zod_1.z.number().optional(),
-    attachments: zod_1.z.array(media_js_1.MediaAttachmentSchema).optional(),
-    contactCardUserId: zod_1.z.string().optional(),
-    mentions: zod_1.z.array(zod_1.z.string()).optional(),
-    selfContextId: zod_1.z.string().nullable().optional(),
-    /** Structured metadata (turn protocol, approval cards, …). */
-    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
-});
-exports.SendMessageResponseSchema = zod_1.z.object({
-    messageId: zod_1.z.string(),
-});
-// ── POST /messages/react ───────────────────────────────────────────────
-exports.ReactRequestSchema = zod_1.z.object({
-    conversationId: zod_1.z.string(),
-    messageId: zod_1.z.string(),
-    emoji: zod_1.z.string(),
-});
-exports.ReactResponseSchema = zod_1.z.object({
-    success: zod_1.z.boolean(),
-    action: zod_1.z.enum(['added', 'removed']),
-    reactions: message_js_1.SerializedReactionsSchema,
-});
-// ── POST /messages/forward ─────────────────────────────────────────────
-exports.ForwardMessageRequestSchema = zod_1.z.object({
-    sourceConversationId: zod_1.z.string(),
-    targetConversationId: zod_1.z.string(),
-    messageId: zod_1.z.string(),
-    text: zod_1.z.string().optional(),
-});
-exports.ForwardMessageResponseSchema = zod_1.z.object({
-    messageId: zod_1.z.string(),
-    targetConversationId: zod_1.z.string(),
-    forwardedFrom: zod_1.z.object({
-        sourceConversationId: zod_1.z.string(),
-        messageId: zod_1.z.string(),
-    }),
-});
-// ── DELETE /conversations/:id/messages/:id, POST …/read, PATCH …/disposition ──
-exports.DeleteMessageResponseSchema = exports.RestOkResponseSchema;
-exports.MarkReadResponseSchema = exports.RestOkResponseSchema;
-exports.UpdateDispositionRequestSchema = zod_1.z.object({
-    inboundDisposition: turnProtocol_js_1.InboundDispositionSchema,
-});
-// ── GET /conversations + GET …/messages ────────────────────────────────
-exports.ConversationsResponseSchema = zod_1.z.object({
-    conversations: zod_1.z.array(exports.RestConversationSchema),
-});
-/** Query params: limit, before, includeBehavior. */
-exports.GetMessagesQuerySchema = zod_1.z.object({
-    limit: zod_1.z.string().optional(),
-    before: zod_1.z.string().optional(),
-    includeBehavior: zod_1.z.string().optional(),
-});
-exports.MessagesPageResponseSchema = zod_1.z.looseObject({
-    messages: zod_1.z.array(exports.RestMessageSchema),
-    /** Present with includeBehavior=1. */
-    behavior: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
-    activeSelfContextIdByMessageId: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
-    selfContexts: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())).optional(),
-});
-// ── POST /conversations/create ─────────────────────────────────────────
-exports.CreateConversationRequestSchema = zod_1.z.object({
-    type: zod_1.z.enum(['direct', 'group']),
-    targetUserId: zod_1.z.string().optional(),
-    memberIds: zod_1.z.array(zod_1.z.string()).optional(),
-    name: zod_1.z.string().optional(),
-    /** Initial session config for first-party coding agents — opaque pass-through. */
-    sessionConfig: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable().optional(),
-    sessionSelection: exports.RestSessionSelectionSchema.optional(),
-});
-exports.CreateConversationResponseSchema = zod_1.z.object({
-    conversationId: zod_1.z.string(),
-    created: zod_1.z.boolean().optional(),
-    reused: zod_1.z.boolean().optional(),
-    sessionSelection: zod_1.z.enum(['new', 'continue_latest', 'continue_or_create', 'specific']).optional(),
-});
-// ── Contacts / admission ───────────────────────────────────────────────
-exports.CreateContactRequestRequestSchema = zod_1.z.object({
-    targetId: zod_1.z.string(),
-    message: zod_1.z.string().optional(),
-});
-exports.CreateContactRequestResponseSchema = zod_1.z.union([
-    zod_1.z.looseObject({ status: zod_1.z.literal('open') }),
-    zod_1.z.looseObject({ status: zod_1.z.enum(['created', 'duplicate']), requestId: zod_1.z.string() }),
-    /** Legacy "already a contact" body. */
-    zod_1.z.looseObject({ message: zod_1.z.string() }),
-]);
-exports.ContactsResponseSchema = zod_1.z.object({
-    contacts: zod_1.z.array(exports.RestContactSchema),
-});
-exports.ResolveAdmissionRequestSchema = zod_1.z.union([
-    zod_1.z.object({ targetUserId: zod_1.z.string() }),
-    zod_1.z.object({ canonContactId: zod_1.z.string() }),
-]);
-exports.ResolveAdmissionResponseSchema = zod_1.z.looseObject({
-    resolvedTargetUserId: zod_1.z.string().nullable().optional(),
-    target: zod_1.z.looseObject({
-        id: zod_1.z.string(),
-        canonContactId: zod_1.z.string().optional(),
-        displayName: zod_1.z.string().optional(),
-        avatarUrl: zod_1.z.string().nullable().optional(),
-        about: zod_1.z.string().optional(),
-        userType: zod_1.z.enum(['human', 'ai_agent']).optional(),
-        discoverable: zod_1.z.boolean().optional(),
-        inboundPolicy: zod_1.z.enum(['open', 'approval-required', 'owner-only']).optional(),
-        groupJoinPolicy: zod_1.z.enum(['open', 'approval-required', 'owner-only']).optional(),
-    }).nullable(),
-    admission: zod_1.z.looseObject({
-        state: zod_1.z.enum([
-            'self',
-            'not-found',
-            'allowed',
-            'request-required',
-            'pending-outbound',
-            'blocked',
-            'inactive',
-            'owner-only',
-        ]),
-        canMessage: zod_1.z.boolean(),
-        canRequestContact: zod_1.z.boolean(),
-        isContact: zod_1.z.boolean(),
-        pendingRequestId: zod_1.z.string().optional(),
-        blockedByViewer: zod_1.z.boolean().optional(),
-        blockedByTarget: zod_1.z.boolean().optional(),
-    }),
-});
-// ── Typing / streaming ─────────────────────────────────────────────────
-exports.SetTypingRequestSchema = zod_1.z.object({
-    conversationId: zod_1.z.string(),
-    typing: zod_1.z.boolean(),
-    status: zod_1.z.enum(['thinking', 'typing']).optional(),
-});
-/** POST /streaming — the legacy REST facade over the RTDB streaming bubble. */
-exports.SetStreamingRequestSchema = zod_1.z.union([
-    zod_1.z.object({
-        conversationId: zod_1.z.string(),
-        text: zod_1.z.string(),
-        status: zod_1.z.string(),
-        messageId: zod_1.z.string(),
-        turnId: zod_1.z.string().nullable().optional(),
-        /** TurnOutputBlock[] — opaque pass-through. */
-        blocks: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())).optional(),
-    }),
-    zod_1.z.object({
-        conversationId: zod_1.z.string(),
-        streaming: zod_1.z.literal(false),
-    }),
-]);
-// ── Media upload ───────────────────────────────────────────────────────
-exports.UploadMediaRequestSchema = zod_1.z.object({
-    conversationId: zod_1.z.string(),
-    mimeType: zod_1.z.string(),
-    /** Base64-encoded file content. */
-    data: zod_1.z.string(),
-    fileName: zod_1.z.string().optional(),
-});
-exports.UploadMediaResponseSchema = zod_1.z.object({
-    url: zod_1.z.string(),
-    attachment: media_js_1.MediaAttachmentSchema,
-});