@canonmsg/backend-contracts 1.8.1 → 2.0.0

package/dist/schemas/update-disposition-request.schema.json

@@ -1,22 +0,0 @@
-{
-  "$id": "canon:UpdateDispositionRequestSchema",
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "inboundDisposition": {
-      "type": "string",
-      "enum": [
-        "queued",
-        "accepted_now",
-        "interleaved",
-        "trigger_suppressed",
-        "rejected",
-        "cancelled"
-      ]
-    }
-  },
-  "required": [
-    "inboundDisposition"
-  ],
-  "additionalProperties": false
-}

package/dist/schemas/upload-media-request.schema.json

@@ -1,25 +0,0 @@
-{
-  "$id": "canon:UploadMediaRequestSchema",
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "conversationId": {
-      "type": "string"
-    },
-    "mimeType": {
-      "type": "string"
-    },
-    "data": {
-      "type": "string"
-    },
-    "fileName": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "conversationId",
-    "mimeType",
-    "data"
-  ],
-  "additionalProperties": false
-}

package/dist/schemas/upload-media-response.schema.json

@@ -1,55 +0,0 @@
-{
-  "$id": "canon:UploadMediaResponseSchema",
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "url": {
-      "type": "string"
-    },
-    "attachment": {
-      "type": "object",
-      "properties": {
-        "kind": {
-          "type": "string",
-          "enum": [
-            "image",
-            "audio",
-            "video",
-            "file"
-          ]
-        },
-        "url": {
-          "type": "string"
-        },
-        "mimeType": {
-          "type": "string"
-        },
-        "fileName": {
-          "type": "string"
-        },
-        "sizeBytes": {
-          "type": "number"
-        },
-        "width": {
-          "type": "number"
-        },
-        "height": {
-          "type": "number"
-        },
-        "durationMs": {
-          "type": "number"
-        }
-      },
-      "required": [
-        "kind",
-        "url"
-      ],
-      "additionalProperties": false
-    }
-  },
-  "required": [
-    "url",
-    "attachment"
-  ],
-  "additionalProperties": false
-}

package/dist/sendContextual.d.ts

@@ -1,114 +0,0 @@
-import { z } from 'zod';
-export declare const SendContextualSelfContextSchema: z.ZodObject<{
-    type: z.ZodLiteral<"cross_session">;
-    context: z.ZodString;
-}, z.core.$strip>;
-export type SendContextualSelfContext = z.infer<typeof SendContextualSelfContextSchema>;
-/**
- * Request body. Exactly ONE of targetConversationId (existing conversation) or
- * targetUserId (open/reuse a direct conversation, contact-request fallback)
- * must be present — the refinement enforces the handler's rule.
- */
-export declare const SendContextualRequestSchema: z.ZodObject<{
-    sourceConversationId: z.ZodString;
-    targetConversationId: z.ZodOptional<z.ZodString>;
-    targetUserId: z.ZodOptional<z.ZodString>;
-    text: z.ZodOptional<z.ZodString>;
-    selfContext: z.ZodObject<{
-        type: z.ZodLiteral<"cross_session">;
-        context: z.ZodString;
-    }, z.core.$strip>;
-    sessionConfig: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    sessionSelection: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
-        mode: z.ZodEnum<{
-            new: "new";
-            continue_latest: "continue_latest";
-            continue_or_create: "continue_or_create";
-        }>;
-    }, z.core.$strip>, z.ZodObject<{
-        mode: z.ZodLiteral<"specific">;
-        conversationId: z.ZodString;
-    }, z.core.$strip>]>>;
-    requestMessage: z.ZodOptional<z.ZodString>;
-    messageOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
-export type SendContextualRequest = z.infer<typeof SendContextualRequestSchema>;
-/** HTTP 201 — message persisted (or idempotent replay) with self-context linked. */
-export declare const SendContextualMessagedResponseSchema: z.ZodObject<{
-    status: z.ZodLiteral<"messaged">;
-    messageId: z.ZodString;
-    conversationId: z.ZodString;
-    selfContextId: z.ZodString;
-    created: z.ZodOptional<z.ZodBoolean>;
-    reused: z.ZodOptional<z.ZodBoolean>;
-    sessionSelection: z.ZodOptional<z.ZodEnum<{
-        new: "new";
-        continue_latest: "continue_latest";
-        continue_or_create: "continue_or_create";
-        specific: "specific";
-    }>>;
-}, z.core.$strip>;
-export type SendContextualMessagedResponse = z.infer<typeof SendContextualMessagedResponseSchema>;
-/**
- * HTTP 202 — admission requires approval: a contact request was created
- * (`requested`) or already pending (`pending`); the message is deferred as a
- * contextual intent when a request id exists.
- */
-export declare const SendContextualDeferredResponseSchema: z.ZodObject<{
-    status: z.ZodEnum<{
-        pending: "pending";
-        requested: "requested";
-    }>;
-    requestId: z.ZodNullable<z.ZodString>;
-    deferredIntentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-export type SendContextualDeferredResponse = z.infer<typeof SendContextualDeferredResponseSchema>;
-/**
- * Terminal / retryable states:
- * - setup_required (HTTP 202) — agent session setup must complete first.
- * - blocked (HTTP 200)        — admission denied (block or policy).
- * - unavailable (HTTP 200)    — target cannot be reached right now.
- * - no_session (HTTP 404)     — session selection matched nothing.
- */
-export declare const SendContextualStateResponseSchema: z.ZodObject<{
-    status: z.ZodEnum<{
-        blocked: "blocked";
-        setup_required: "setup_required";
-        unavailable: "unavailable";
-        no_session: "no_session";
-    }>;
-    reason: z.ZodString;
-}, z.core.$strip>;
-export type SendContextualStateResponse = z.infer<typeof SendContextualStateResponseSchema>;
-export declare const SendContextualResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
-    status: z.ZodLiteral<"messaged">;
-    messageId: z.ZodString;
-    conversationId: z.ZodString;
-    selfContextId: z.ZodString;
-    created: z.ZodOptional<z.ZodBoolean>;
-    reused: z.ZodOptional<z.ZodBoolean>;
-    sessionSelection: z.ZodOptional<z.ZodEnum<{
-        new: "new";
-        continue_latest: "continue_latest";
-        continue_or_create: "continue_or_create";
-        specific: "specific";
-    }>>;
-}, z.core.$strip>, z.ZodObject<{
-    status: z.ZodEnum<{
-        pending: "pending";
-        requested: "requested";
-    }>;
-    requestId: z.ZodNullable<z.ZodString>;
-    deferredIntentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>, z.ZodObject<{
-    status: z.ZodEnum<{
-        blocked: "blocked";
-        setup_required: "setup_required";
-        unavailable: "unavailable";
-        no_session: "no_session";
-    }>;
-    reason: z.ZodString;
-}, z.core.$strip>]>;
-export type SendContextualResponse = z.infer<typeof SendContextualResponseSchema>;
-/** HTTP status the handler pairs with each response status. */
-export declare const SEND_CONTEXTUAL_HTTP_STATUS: Record<SendContextualResponse['status'], number>;

package/dist/sendContextual.js

@@ -1,89 +0,0 @@
-// Wire contract v1 — POST /messages/send-contextual as a FIRST-CLASS contract
-// (bridge-execution-plan Phase 3; owner decision 2026-07-03: the re-spec rides
-// contract v1, the transport stays as-is and the Bridge proxies it unchanged
-// in Phase 4).
-//
-// Grounded in functions/src/api/sendContextualMessage.ts (the handler's actual
-// parse + emissions) and @canonmsg/core's SendContextualMessageOptions/Result.
-// This mirrors CURRENT behavior — a re-spec, not a redesign.
-import { z } from 'zod';
-import { RestSessionSelectionSchema } from './restEndpoints.js';
-export const SendContextualSelfContextSchema = z.object({
-    type: z.literal('cross_session'),
-    /** Private agent self-context; server caps at 1000 chars. */
-    context: z.string(),
-});
-/**
- * Request body. Exactly ONE of targetConversationId (existing conversation) or
- * targetUserId (open/reuse a direct conversation, contact-request fallback)
- * must be present — the refinement enforces the handler's rule.
- */
-export const SendContextualRequestSchema = z.object({
-    sourceConversationId: z.string(),
-    /** Target arm 1: send into an existing conversation. */
-    targetConversationId: z.string().optional(),
-    /** Target arm 2: resolve/create a direct conversation with this user. */
-    targetUserId: z.string().optional(),
-    text: z.string().optional(),
-    selfContext: SendContextualSelfContextSchema,
-    /** Initial agent session config (agent targets) — opaque pass-through. */
-    sessionConfig: z.record(z.string(), z.unknown()).nullable().optional(),
-    sessionSelection: RestSessionSelectionSchema.optional(),
-    /** Contact-request message when admission requires approval. */
-    requestMessage: z.string().optional(),
-    /**
-     * SendMessageOptions passthrough (attachments, replyTo, metadata, …).
-     * May NOT carry selfContextId/selfContext — the handler rejects overrides
-     * of the self-context linkage fields.
-     */
-    messageOptions: z.record(z.string(), z.unknown()).optional(),
-}).refine((body) => (body.targetConversationId ? 1 : 0) + (body.targetUserId ? 1 : 0) === 1, { message: 'Provide exactly one targetConversationId or targetUserId' }).refine((body) => !body.messageOptions
-    || (!('selfContextId' in body.messageOptions) && !('selfContext' in body.messageOptions)), { message: 'messageOptions may not override self-context linkage fields' });
-// ── Response arms (exactly what the handler emits today) ───────────────
-/** HTTP 201 — message persisted (or idempotent replay) with self-context linked. */
-export const SendContextualMessagedResponseSchema = z.object({
-    status: z.literal('messaged'),
-    messageId: z.string(),
-    conversationId: z.string(),
-    selfContextId: z.string(),
-    /** Present when the target conversation was opened by this call. */
-    created: z.boolean().optional(),
-    reused: z.boolean().optional(),
-    sessionSelection: z.enum(['new', 'continue_latest', 'continue_or_create', 'specific']).optional(),
-});
-/**
- * HTTP 202 — admission requires approval: a contact request was created
- * (`requested`) or already pending (`pending`); the message is deferred as a
- * contextual intent when a request id exists.
- */
-export const SendContextualDeferredResponseSchema = z.object({
-    status: z.enum(['requested', 'pending']),
-    requestId: z.string().nullable(),
-    deferredIntentId: z.string().nullable().optional(),
-});
-/**
- * Terminal / retryable states:
- * - setup_required (HTTP 202) — agent session setup must complete first.
- * - blocked (HTTP 200)        — admission denied (block or policy).
- * - unavailable (HTTP 200)    — target cannot be reached right now.
- * - no_session (HTTP 404)     — session selection matched nothing.
- */
-export const SendContextualStateResponseSchema = z.object({
-    status: z.enum(['setup_required', 'blocked', 'unavailable', 'no_session']),
-    reason: z.string(),
-});
-export const SendContextualResponseSchema = z.union([
-    SendContextualMessagedResponseSchema,
-    SendContextualDeferredResponseSchema,
-    SendContextualStateResponseSchema,
-]);
-/** HTTP status the handler pairs with each response status. */
-export const SEND_CONTEXTUAL_HTTP_STATUS = {
-    messaged: 201,
-    requested: 202,
-    pending: 202,
-    setup_required: 202,
-    blocked: 200,
-    unavailable: 200,
-    no_session: 404,
-};