@qilin-agent/output-retention 3.1.4 → 3.1.6

package/lib/index.js

@@ -278,8 +278,20 @@ function describeOmitted(omitted, unit) {
 * @param recovery Tool-supplied guidance builder; receives the notice, returns a sentence (or `''`).
 * @returns The combined footer line.
 */
+/**
+* Truncate text to at most `maxChars` UTF-16 code units without splitting a
+* surrogate pair: a capped string ending in a leading surrogate drops it.
+* @param text - the text to cap.
+* @param maxChars - the maximum code units to keep.
+* @returns the capped text, unchanged when it already fits.
+*/
+function truncateWithoutSplittingSurrogatePair(text, maxChars) {
+	if (text.length <= maxChars) return text;
+	const capped = text.slice(0, maxChars);
+	return /[\uD800-\uDBFF]$/.test(capped) ? capped.slice(0, -1) : capped;
+}
 function formatRetentionNotice(notice, recovery) {
 	return [describeOmitted(notice.omitted, notice.unit), recovery(notice)].filter((part) => part.length > 0).join(" ");
 }
 //#endregion
-export { ItemRetainer, TextRetainer, describeOmitted, formatRetentionNotice };
+export { ItemRetainer, TextRetainer, describeOmitted, formatRetentionNotice, truncateWithoutSplittingSurrogatePair };

package/lib/types/index.d.ts

@@ -221,5 +221,13 @@ export declare function describeOmitted(omitted: Omitted, unit: RetentionNotice[
  * @param recovery Tool-supplied guidance builder; receives the notice, returns a sentence (or `''`).
  * @returns The combined footer line.
  */
+/**
+ * Truncate text to at most `maxChars` UTF-16 code units without splitting a
+ * surrogate pair: a capped string ending in a leading surrogate drops it.
+ * @param text - the text to cap.
+ * @param maxChars - the maximum code units to keep.
+ * @returns the capped text, unchanged when it already fits.
+ */
+export declare function truncateWithoutSplittingSurrogatePair(text: string, maxChars: number): string;
 export declare function formatRetentionNotice(notice: RetentionNotice, recovery: (notice: RetentionNotice) => string): string;
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/output-retention",
   "description": "Zero-dependency bounded-retention primitive: ItemRetainer/TextRetainer + neutral notice helpers (what did we keep, what did we omit)",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "publishConfig": {
     "access": "public"
   },
@@ -30,9 +30,9 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   }
 }