@proteos/sdk 0.59.1 → 0.60.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.59.1",
+  "version": "0.60.0",
   "license": "Apache-2.0",
   "description": "TypeScript SDK for the Proteos platform",
   "repository": {
@@ -66,8 +66,8 @@
     "tsup": "^8.3.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0",
-    "@proteos/biome-config": "0.0.0",
-    "@proteos/tsconfig": "0.0.0"
+    "@proteos/tsconfig": "0.0.0",
+    "@proteos/biome-config": "0.0.0"
   },
   "scripts": {
     "build": "tsup",

package/src/conversation/index.ts

@@ -1249,7 +1249,10 @@ export interface ConversationTagService {
     conversationId: string,
     query?: ListConversationTagEvaluationsQuery,
   ): Promise<ListResponse<ConversationTagEvaluation>>
-  /** Flip a tag between active and dismissed (the feedback loop) and/or annotate why. */
+  /**
+   * Flip a tag between active and dismissed (the feedback loop), annotate why,
+   * and/or correct its value and anchors (a correction makes it a user tag).
+   */
   update(id: string, request: UpdateConversationTagRequest): Promise<ConversationTag>
   delete(id: string): Promise<void>
   /** Org-wide tag stream (filter by definition, value, channel, contact, time window). */

package/src/conversation/types.ts

@@ -1370,12 +1370,26 @@ export interface CreateConversationTagRequest {
 }
 
 /**
- * Flips a tag between `active` and `dismissed` (the feedback loop) and lets a
- * person annotate why.
+ * Patches a tag: `status` flips it between `active` and `dismissed` (the
+ * feedback loop), `why` annotates it, and `value` / the anchors correct it —
+ * absent fields keep the stored value and the merged tag is validated against
+ * its definition like a manual tag. `definition_key` is immutable. A value or
+ * anchor change turns the tag into a user tag (confidence 1, no
+ * probabilities, no evaluation) so a later evaluation no longer replaces it;
+ * a corrected `pending` tag becomes `active` unless `status` says otherwise.
  */
 export interface UpdateConversationTagRequest {
   status?: ConversationTagStatus
   why?: string
+  /** `"true"` | choice option key | score level index as a string. */
+  value?: string
+  /** Anchors are tri-state: omit = keep, `null` = clear, a value = set. */
+  start_message_id?: string | null
+  /** Unicode code-point index, inclusive. */
+  start_offset?: number | null
+  end_message_id?: string | null
+  /** Unicode code-point index, exclusive. */
+  end_offset?: number | null
 }
 
 /**