@osovv/vv-opencode 1.2.7 → 1.2.10

package/dist/plugins/tool-history-compaction/transform.js

@@ -0,0 +1,93 @@
+// FILE: src/plugins/tool-history-compaction/transform.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Apply tool-history compaction to the in-memory message list the model is about to receive: walk messages newest-first, protect the recent tail, dispatch retained/read/other tools to the right compaction layer, and mutate only completed tool part outputs.
+//   SCOPE: Completed-tool-part detection, protected-tail accounting, retention dispatch, read-slim and prune application, and idempotent in-place output rewrites.
+//   DEPENDS: [src/plugins/tool-history-compaction/config.ts, src/plugins/tool-history-compaction/retention.ts, src/plugins/tool-history-compaction/prune.ts, src/plugins/tool-history-compaction/read-slim.ts]
+//   LINKS: [M-PLUGIN-TOOL-HISTORY-COMPACTION]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   TransformMessage - One message entry in the transform hook output.
+//   compactMessages - Deterministically rewrite eligible tool part outputs in place.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v0.1.0 - Established the transform core with protected tail, retention dispatch, and idempotence.]
+// END_CHANGE_SUMMARY
+import { pruneOutput } from "./prune.js";
+import { slimReadOutput } from "./read-slim.js";
+import { isRetainedTool } from "./retention.js";
+function isCompletedToolPart(part) {
+    return part.type === "tool" && part.state.status === "completed";
+}
+function isCompactedByOpencode(part) {
+    const time = part.state.time;
+    return (typeof time === "object" && time !== null && "compacted" in time && time.compacted !== undefined);
+}
+function isReadTool(tool) {
+    return tool.toLowerCase() === "read";
+}
+// END_BLOCK_GUARDS
+// START_BLOCK_COMPACT
+/**
+ * Deterministically rewrite eligible tool part outputs in place.
+ * Model-agnostic: the current model is not needed. Non-destructive to inputs,
+ * part structure, and ordering. Idempotent: already-compacted parts are skipped
+ * by their markers, so a second pass is a no-op.
+ * @param messages - the transform hook's in-memory message list.
+ * @param config - resolved compaction config.
+ */
+export function compactMessages(messages, config) {
+    let remainingProtection = config.protectLastCalls;
+    let firstMessage = true;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const message = messages[i];
+        if (!message)
+            continue;
+        for (let j = message.parts.length - 1; j >= 0; j--) {
+            const part = message.parts[j];
+            if (!part || part.type !== "tool")
+                continue;
+            if (!isCompletedToolPart(part))
+                continue;
+            if (isCompactedByOpencode(part))
+                continue;
+            const withinTail = firstMessage || remainingProtection > 0;
+            if (withinTail) {
+                if (!firstMessage)
+                    remainingProtection -= 1;
+                continue;
+            }
+            if (isRetainedTool(part.tool, config.retainTools))
+                continue;
+            const output = part.state.output;
+            let rewritten;
+            if (config.readSlim && isReadTool(part.tool)) {
+                const slim = slimReadOutput(part.state.input, output, config);
+                if (slim) {
+                    rewritten = slim.output;
+                }
+                else {
+                    const pruned = pruneOutput(output, config);
+                    if (pruned)
+                        rewritten = pruned.output;
+                }
+            }
+            else {
+                const pruned = pruneOutput(output, config);
+                if (pruned)
+                    rewritten = pruned.output;
+            }
+            if (rewritten !== undefined && rewritten !== output) {
+                part.state.output = rewritten;
+            }
+        }
+        if (firstMessage)
+            firstMessage = false;
+    }
+}
+// END_BLOCK_COMPACT
+//# sourceMappingURL=transform.js.map

package/dist/plugins/tool-history-compaction/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/plugins/tool-history-compaction/transform.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osovv/vv-opencode",
-  "version": "1.2.7",
+  "version": "1.2.10",
   "description": "A curated, opinionated set of OpenCode plugins for spec-first, review-driven, safer agentic development.",
   "type": "module",
   "main": "./dist/index.js",
@@ -73,6 +73,10 @@
     "./plugins/web-tools": {
       "types": "./dist/plugins/web-tools/index.d.ts",
       "import": "./dist/plugins/web-tools/index.js"
+    },
+    "./plugins/tool-history-compaction": {
+      "types": "./dist/plugins/tool-history-compaction/index.d.ts",
+      "import": "./dist/plugins/tool-history-compaction/index.js"
     }
   },
   "scripts": {

package/schemas/vvoc/v3.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cdn.jsdelivr.net/npm/@osovv/vv-opencode@1.2.7/schemas/vvoc/v3.json",
+  "$id": "https://cdn.jsdelivr.net/npm/@osovv/vv-opencode@1.2.10/schemas/vvoc/v3.json",
   "title": "vvoc config",
   "description": "Canonical vvoc configuration document.",
   "type": "object",
@@ -136,7 +136,48 @@
       "type": "object",
       "propertyNames": { "minLength": 1 },
       "additionalProperties": {
-        "type": "boolean"
+        "anyOf": [
+          { "type": "boolean" },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "enabled": { "type": "boolean" },
+              "routing": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "default": {
+                    "type": "string",
+                    "enum": ["hashline", "replace", "str_replace_editor", "passthrough"]
+                  },
+                  "rules": {
+                    "type": "object",
+                    "propertyNames": { "minLength": 1 },
+                    "additionalProperties": {
+                      "type": "string",
+                      "enum": ["hashline", "replace", "str_replace_editor", "passthrough"]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "enabled": { "type": "boolean" },
+              "protectLastCalls": { "type": "integer", "minimum": 0 },
+              "minSavingsChars": { "type": "integer", "minimum": 0 },
+              "outputMaxChars": { "type": "integer", "minimum": 0 },
+              "headChars": { "type": "integer", "minimum": 0 },
+              "tailChars": { "type": "integer", "minimum": 0 },
+              "readSlim": { "type": "boolean" },
+              "retainTools": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+            }
+          }
+        ]
       }
     },
     "web": {