@punica/editor 1.25.1 → 1.26.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punica/editor",
-  "version": "1.25.1",
+  "version": "1.26.1",
   "description": "Punica Editor",
   "private": false,
   "type": "module",
@@ -56,8 +56,8 @@
   "dependencies": {
     "@punica/common": "^1.0.2",
     "highlight.js": "^11.11.1",
-    "markdown-it": "^14.2.0",
-    "yaml": "^2.4.5"
+    "yaml": "^2.4.5",
+    "markdown-it": "^14.2.0"
   },
   "devDependencies": {
     "@eslint/config-array": "^0.17.0",

package/types/punica.module.kernel.llm.d.ts

@@ -150,6 +150,18 @@ declare module 'punica' {
            * from disk.
            */
           promptVersion?: string;
+          /**
+           * The model stopped because it reached its output budget.
+           *
+           * True when `outputTokens >= maxTokens`, which is the only
+           * signal available here: `runtime.LlmChatResponse` carries no
+           * finish reason. The text is a PARTIAL answer, so this stays on
+           * a successful result — a caller that can use a partial one
+           * still gets it, and a caller that cannot now has the field to
+           * check. An answer that was truncated to NOTHING is a
+           * `CapabilityError` with `LLM_EMPTY_ANSWER` instead.
+           */
+          truncated?: boolean;
         };
       }
 
@@ -165,6 +177,20 @@ declare module 'punica' {
         blocked?: boolean;
         /**
          * Stable reason code for blocked operations (e.g., 'LLM_PROFILE_NOT_REGISTERED').
+         *
+         * Two of them describe a call that reached a model and came back
+         * unusable, rather than one that never ran:
+         * - `LLM_EMPTY_ANSWER` — the model returned no text and no tool
+         *   calls. A reasoning model that spends its whole output budget
+         *   thinking answers exactly this way, and the provider reports no
+         *   error, so nothing below this layer can tell it from success.
+         * - `LLM_STRUCTURED_PARSE_FAILED` — text arrived but the instruction
+         *   class declared `json_object` and it did not parse.
+         *
+         * Both carry the call's `metadata` diagnostics, because the tokens
+         * were spent and the difference between "no model" and "a model
+         * that answered nothing after 2000 output tokens" is the whole
+         * question a reader has.
          */
         reasonCode?: string;
         metadata: {
@@ -173,6 +199,19 @@ declare module 'punica' {
           originExtension?: string;
           productId?: string;
           cacheHit?: boolean;
+          /**
+           * Present when the failure happened AFTER a model answered.
+           * Absent when the call never reached one (unknown instruction
+           * class, inactive origin extension, provider chain exhausted).
+           */
+          tokensUsed?: number;
+          inputTokens?: number;
+          outputTokens?: number;
+          latencyMs?: number;
+          modelId?: string;
+          provider?: string;
+          promptVersion?: string;
+          truncated?: boolean;
         };
       }