@piagent/platform 1.5.4 → 1.6.0

package/packages/piagent-webui/shared/text-visibility.ts

@@ -0,0 +1,10 @@
+// Classification only: callers keep the original Unicode text unchanged.
+// A response needs at least one rendering code point; whitespace, controls and
+// Unicode default-ignorables alone cannot form a visible assistant answer.
+const NON_RENDERING_CODE_POINT = /^(?:\p{White_Space}|\p{Cc}|\p{Default_Ignorable_Code_Point})$/u;
+const ANSI_ESCAPE = /\u001b(?:\[[0-?]*[ -/]*[@-~]|[@-_])/g;
+
+export function hasVisibleText(value: string): boolean {
+  for (const codePoint of value.replace(ANSI_ESCAPE, "")) if (!NON_RENDERING_CODE_POINT.test(codePoint)) return true;
+  return false;
+}

package/schemas/piagent-webui/catalog-v1.json

@@ -218,6 +218,15 @@
       "supported": true,
       "current": true
     },
+    {
+      "name": "session-live-state-v1",
+      "file": "session-live-state-v1.schema.json",
+      "id": "https://piagent.io.vn/schemas/piagent-webui/session-live-state-v1.schema.json",
+      "documentVersion": 1,
+      "role": "read-model",
+      "supported": true,
+      "current": true
+    },
     {
       "name": "session-command-v1",
       "file": "session-command-v1.schema.json",

package/schemas/piagent-webui/gateway-protocol-v1.schema.json

@@ -269,7 +269,7 @@
         "sequence": { "$ref": "#/$defs/stateVersion" },
         "stateVersion": { "$ref": "#/$defs/stateVersion" },
         "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
-        "kind": { "enum": ["catalog.changed", "session.changed", "runtime.changed", "resync.required", "message.delta", "message.completed", "tool.started", "tool.completed"] },
+        "kind": { "enum": ["catalog.changed", "session.changed", "runtime.changed", "resync.required", "message.delta", "message.completed", "operation.settled", "tool.started", "tool.completed"] },
         "payload": { "type": "object" }
       }
     },
@@ -411,6 +411,54 @@
         }
       ]
     },
+    "operationCompletedPayload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sessionRef", "operationRef", "messageRef", "sessionRevision", "settlement", "reasonCode"],
+      "properties": {
+        "sessionRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "operationRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "messageRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "sessionRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "settlement": { "const": "completed" },
+        "reasonCode": { "type": "null" }
+      }
+    },
+    "operationIncompletePayload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sessionRef", "operationRef", "messageRef", "sessionRevision", "settlement", "reasonCode"],
+      "properties": {
+        "sessionRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "operationRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "messageRef": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" },
+        "sessionRevision": {
+          "anyOf": [
+            { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+            { "type": "null" }
+          ]
+        },
+        "settlement": { "enum": ["blocked", "aborted", "error", "unknown"] },
+        "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" }
+      }
+    },
+    "operationSettledEvent": {
+      "allOf": [
+        { "$ref": "#/$defs/eventBase" },
+        {
+          "type": "object",
+          "properties": {
+            "kind": { "const": "operation.settled" },
+            "payload": {
+              "oneOf": [
+                { "$ref": "#/$defs/operationCompletedPayload" },
+                { "$ref": "#/$defs/operationIncompletePayload" }
+              ]
+            }
+          }
+        }
+      ]
+    },
     "toolEvent": {
       "allOf": [
         { "$ref": "#/$defs/eventBase" },
@@ -421,13 +469,14 @@
             "payload": {
               "type": "object",
               "additionalProperties": false,
-              "required": ["sessionRef", "operationRef", "toolCallRef", "toolLabel", "isError"],
+              "required": ["sessionRef", "operationRef", "toolCallRef", "toolLabel", "isError", "reasonCode"],
               "properties": {
                 "sessionRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
                 "operationRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
                 "toolCallRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
                 "toolLabel": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[^\\u0000-\\u001F\\u007F]+$" },
-                "isError": { "type": ["boolean", "null"] }
+                "isError": { "type": ["boolean", "null"] },
+                "reasonCode": { "$ref": "common-v1.schema.json#/$defs/nullableReasonCode" }
               }
             }
           },
@@ -449,6 +498,7 @@
         { "$ref": "#/$defs/resyncRequiredEvent" },
         { "$ref": "#/$defs/messageDeltaEvent" },
         { "$ref": "#/$defs/messageCompletedEvent" },
+        { "$ref": "#/$defs/operationSettledEvent" },
         { "$ref": "#/$defs/toolEvent" }
       ]
     }

package/schemas/piagent-webui/session-live-state-v1.schema.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/session-live-state-v1.schema.json",
+  "title": "Piagent WebUI canonical volatile session operation state v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "version", "generatedAt", "gatewayInstanceRef", "eventSequence", "state", "operations", "settlements", "reasonCode"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-session-live-state-v1" },
+    "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+    "gatewayInstanceRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+    "eventSequence": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+    "state": { "enum": ["ready", "unavailable"] },
+    "operations": {
+      "type": "array",
+      "maxItems": 100,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/currentOperation" }
+    },
+    "settlements": {
+      "description": "Bounded, Gateway-epoch-local non-success terminal operation outcomes retained for Activity reconciliation.",
+      "type": "array",
+      "maxItems": 100,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/terminalSettlement" }
+    },
+    "reasonCode": { "$ref": "common-v1.schema.json#/$defs/nullableReasonCode" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "state": { "const": "ready" } }, "required": ["state"] },
+      "then": { "properties": { "reasonCode": { "type": "null" } } },
+      "else": {
+        "properties": {
+          "operations": { "type": "array", "maxItems": 0 },
+          "settlements": { "type": "array", "maxItems": 0 },
+          "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "currentOperation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sessionRef", "operationRef", "state", "abortable"],
+      "properties": {
+        "sessionRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "operationRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "state": { "enum": ["running", "waiting-approval", "settling"] },
+        "abortable": { "type": "boolean" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "state": { "const": "settling" } }, "required": ["state"] },
+          "then": { "properties": { "abortable": { "const": false } } },
+          "else": { "properties": { "abortable": { "const": true } } }
+        }
+      ]
+    },
+    "terminalSettlement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sessionRef", "operationRef", "settlement", "reasonCode", "settledAt", "sequence"],
+      "properties": {
+        "sessionRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "operationRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "settlement": { "enum": ["blocked", "aborted", "error", "unknown"] },
+        "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" },
+        "settledAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "sequence": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }
+      }
+    }
+  }
+}

package/schemas/task-contract.schema.json

@@ -469,6 +469,12 @@
         "read-only"
       ]
     },
+    "mutationPolicy": {
+      "enum": [
+        "required",
+        "forbidden"
+      ]
+    },
     "attempt": {
       "type": "integer",
       "minimum": 1,
@@ -570,7 +576,8 @@
           "$ref": "#/$defs/stringList"
         },
         {
-          "minItems": 1
+          "minItems": 1,
+          "maxItems": 2000
         }
       ]
     },
@@ -863,6 +870,10 @@
     }
   },
   "allOf": [
+    {
+      "if": { "properties": { "changeMode": { "const": "read-only" } }, "required": ["changeMode"] },
+      "then": { "properties": { "mutationPolicy": { "const": "forbidden" } } }
+    },
     {
       "if": { "properties": { "workingTreeDigestAlgorithm": { "const": "legacy-untrusted" } }, "required": ["workingTreeDigestAlgorithm"] },
       "then": {