@talqing/sdk 0.15.2 → 0.16.1

package/src/gen/types.gen.ts

@@ -776,6 +776,20 @@ export type AssistantStartedEvent = {
     trigger_item_id: string;
 };
 
+/**
+ * AttachmentNotKept
+ *
+ * A file the person sent that could not be stored.
+ */
+export type AttachmentNotKept = {
+    /**
+     * Reason
+     *
+     * Why, as a sentence for a person.
+     */
+    reason: string;
+};
+
 /**
  * AvatarCatalogEntryResponse
  */
@@ -1921,9 +1935,11 @@ export type ChatMessageRequest = {
      */
     client_message_id: string;
     /**
-     * Images
+     * Files
+     *
+     * Any type; photos, PDFs and Word files are read by the agent.
      */
-    images?: Array<InboundImage>;
+    files?: Array<InboundFile>;
     /**
      * Message
      */
@@ -2174,11 +2190,117 @@ export type ConversationActivity = {
 };
 
 /**
- * ConversationAttachment
+ * ConversationDocument
+ *
+ * A PDF or Word file the person sent, and whether the agent could read it.
+ */
+export type ConversationDocument = {
+    /**
+     * Bytes
+     */
+    bytes: number;
+    /**
+     * Filename
+     */
+    filename: string | null;
+    /**
+     * Id
+     */
+    id: string;
+    /**
+     * Kind
+     */
+    kind?: 'document';
+    /**
+     * Mime Type
+     */
+    mime_type: string;
+    /**
+     * Pages
+     *
+     * A PDF's page count; null for Word files.
+     */
+    pages: number | null;
+    /**
+     * Status
+     *
+     * `pending` until the agent's next turn reads it.
+     */
+    status: 'pending' | 'read' | 'unreadable';
+    /**
+     * Unreadable Reason
+     *
+     * Why the agent could not read it.
+     */
+    unreadable_reason: string | null;
+    /**
+     * Url
+     *
+     * Signed download link; valid until `url_expires_at`.
+     */
+    url: string;
+    /**
+     * Url Expires At
+     */
+    url_expires_at: string;
+};
+
+/**
+ * ConversationFile
  *
- * One image as the API returns it: the same record, signed, minus the key.
+ * Any other file the person sent, stored for you; the agent cannot open it.
  */
-export type ConversationAttachment = {
+export type ConversationFile = {
+    /**
+     * Bytes
+     */
+    bytes: number;
+    /**
+     * Extension
+     *
+     * The type read from its bytes, e.g. `xlsx`; `bin` if unknown.
+     */
+    extension: string;
+    /**
+     * Filename
+     */
+    filename: string | null;
+    /**
+     * Id
+     */
+    id: string;
+    /**
+     * Kind
+     */
+    kind?: 'file';
+    /**
+     * Mime Type
+     */
+    mime_type: string;
+    /**
+     * Playable
+     *
+     * Set when `url` plays in an `<audio>` or `<video>` element.
+     */
+    playable: 'audio' | 'video' | null;
+    /**
+     * Url
+     *
+     * Signed link; valid until `url_expires_at`.
+     */
+    url: string;
+    /**
+     * Url Expires At
+     */
+    url_expires_at: string;
+};
+
+/**
+ * ConversationImage
+ *
+ * A photo the person sent, with a short-lived link to it.
+ */
+export type ConversationImage = {
     /**
      * Bytes
      */
@@ -2205,6 +2327,8 @@ export type ConversationAttachment = {
     mime_type: string;
     /**
      * Url
+     *
+     * Signed; valid until `url_expires_at`.
      */
     url: string;
     /**
@@ -2232,7 +2356,13 @@ export type ConversationItemResponse = {
     /**
      * Attachments
      */
-    attachments: Array<ConversationAttachment>;
+    attachments: Array<ConversationImage | ConversationDocument | ConversationFile>;
+    /**
+     * Attachments Not Kept
+     *
+     * Files the person sent that could not be stored.
+     */
+    attachments_not_kept: Array<AttachmentNotKept>;
     /**
      * Who at your business posted this.
      */
@@ -2280,12 +2410,6 @@ export type ConversationItemResponse = {
      * Idempotency Key
      */
     idempotency_key: string | null;
-    /**
-     * Images Not Kept
-     *
-     * Images the person sent that were not stored, and why.
-     */
-    images_not_kept: Array<ImageNotKept>;
     latency: ReplyLatency | null;
     /**
      * Metadata
@@ -5415,16 +5539,6 @@ export type IfOperation = {
     then?: Array<HttpOperation | CodeOperation | FrontendRpcOperation | IfOperation | SetVariableOperation | SayOperation | GenerateReplyOperation | AddMessageOperation | EndCallOperation | HandoffOperation | TransferOperation | SendDtmfOperation> | null;
 };
 
-/**
- * ImageNotKept
- */
-export type ImageNotKept = {
-    /**
-     * Reason
-     */
-    reason: string;
-};
-
 /**
  * ImportPhoneNumbersRequest
  */
@@ -5506,13 +5620,15 @@ export type InboundContent = {
 };
 
 /**
- * InboundImage
+ * InboundFile
  *
- * One image on an inbound text message: the bytes, and what to call them.
+ * One file on an inbound text message: the bytes, and what to call them.
  */
-export type InboundImage = {
+export type InboundFile = {
     /**
      * Data Url
+     *
+     * `data:<mime>;base64,<bytes>`, up to 20 MB decoded.
      */
     data_url: string;
     /**
@@ -6076,7 +6192,13 @@ export type ItemCreatedEvent = {
     /**
      * Attachments
      */
-    attachments: Array<ConversationAttachment>;
+    attachments: Array<ConversationImage | ConversationDocument | ConversationFile>;
+    /**
+     * Attachments Not Kept
+     *
+     * Files the person sent that could not be stored.
+     */
+    attachments_not_kept: Array<AttachmentNotKept>;
     /**
      * Who at your business posted this.
      */
@@ -6128,12 +6250,6 @@ export type ItemCreatedEvent = {
      * Idempotency Key
      */
     idempotency_key: string | null;
-    /**
-     * Images Not Kept
-     *
-     * Images the person sent that were not stored, and why.
-     */
-    images_not_kept: Array<ImageNotKept>;
     latency: ReplyLatency | null;
     /**
      * Metadata
@@ -6392,7 +6508,7 @@ export type LLMModelSpec = {
     /**
      * Priority
      *
-     * Run this model in its provider's priority (low-latency) lane, where its catalog entry declares one. Steadies the worst case rather than the average, and costs 1.75x-2.5x per token.
+     * Run this model in its provider's priority (low-latency) lane, where its catalog entry declares one; on OpenRouter, any model (standard where no host sells one). Steadies the worst case rather than the average, and costs more per token.
      */
     priority?: boolean;
     /**
@@ -6430,7 +6546,7 @@ export type LLMModelSpecOverride = {
     /**
      * Priority
      *
-     * Run this model in its provider's priority (low-latency) lane, where its catalog entry declares one. Steadies the worst case rather than the average, and costs 1.75x-2.5x per token.
+     * Run this model in its provider's priority (low-latency) lane, where its catalog entry declares one; on OpenRouter, any model (standard where no host sells one). Steadies the worst case rather than the average, and costs more per token.
      */
     priority?: boolean | null;
     /**
@@ -6540,7 +6656,7 @@ export type LLMSpec = {
     /**
      * Priority
      *
-     * Run this model in its provider's priority (low-latency) lane, where its catalog entry declares one. Steadies the worst case rather than the average, and costs 1.75x-2.5x per token.
+     * Run this model in its provider's priority (low-latency) lane, where its catalog entry declares one; on OpenRouter, any model (standard where no host sells one). Steadies the worst case rather than the average, and costs more per token.
      */
     priority?: boolean;
     /**
@@ -6579,7 +6695,7 @@ export type LLMSpecOverride = {
     /**
      * Priority
      *
-     * Run this model in its provider's priority (low-latency) lane, where its catalog entry declares one. Steadies the worst case rather than the average, and costs 1.75x-2.5x per token.
+     * Run this model in its provider's priority (low-latency) lane, where its catalog entry declares one; on OpenRouter, any model (standard where no host sells one). Steadies the worst case rather than the average, and costs more per token.
      */
     priority?: boolean | null;
     /**
@@ -6781,6 +6897,10 @@ export type ModelHostResponse = {
      * Quantization
      */
     quantization: string | null;
+    /**
+     * Service Tier
+     */
+    service_tier: 'priority' | 'ultrafast' | null;
     /**
      * Throughput P50
      */
@@ -17391,6 +17511,60 @@ export type ConversationsUpdateResults = {
 
 export type ConversationsUpdateResult = ConversationsUpdateResults[keyof ConversationsUpdateResults];
 
+export type ConversationsAttachmentsGetData = {
+    body?: never;
+    path: {
+        /**
+         * Conversation Id
+         */
+        conversation_id: string;
+        /**
+         * Attachment Id
+         */
+        attachment_id: string;
+    };
+    query?: never;
+    url: '/v1/conversations/{conversation_id}/attachments/{attachment_id}';
+};
+
+export type ConversationsAttachmentsGetErrors = {
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * No such resource in this organization.
+     */
+    404: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+
+export type ConversationsAttachmentsGetError = ConversationsAttachmentsGetErrors[keyof ConversationsAttachmentsGetErrors];
+
+export type ConversationsAttachmentsGetResults = {
+    /**
+     * Response Conversations.Attachments.Get
+     *
+     * Successful Response
+     */
+    200: ({
+        kind: 'image';
+    } & ConversationImage) | ({
+        kind: 'document';
+    } & ConversationDocument) | ({
+        kind: 'file';
+    } & ConversationFile);
+};
+
+export type ConversationsAttachmentsGetResult = ConversationsAttachmentsGetResults[keyof ConversationsAttachmentsGetResults];
+
 export type ConversationsEventsData = {
     body?: never;
     path: {

package/src/vocabulary.ts

@@ -89,6 +89,8 @@ export type ConversationItemRole = NonNullable<ConversationItemResponse["role"]>
 /** Which way the row travelled, and whether the end customer saw it. */
 export type ConversationItemDirection = ConversationItemResponse["direction"];
 export type ConversationItemVisibility = ConversationItemResponse["visibility"];
+/** A file a person sent: a photo, a document, or any other file, by `kind`. */
+export type ConversationAttachment = ConversationItemResponse["attachments"][number];
 
 /** One item on a CoPilot rail: a message, a tool call, or its output. A union
  *  alias has no schema of its own, so this is the only one of the three that