@vincemakes/kiso-core 0.1.5 → 0.1.6

package/dist/kernel/loop.d.ts

@@ -69,6 +69,7 @@ export interface LoopConfig {
      */
     readonly microcompact?: {
         readonly thresholdTokens: number;
+        readonly keepResults?: number;
     };
     readonly signal?: AbortSignalLike;
     readonly temperature?: number;

package/dist/kernel/loop.js

@@ -151,7 +151,7 @@ export async function* loop(config) {
         }
         // ── C 区: one-shot microcompact boundary when over the threshold ──
         if (config.microcompact !== undefined && estimateTokens(messages) > config.microcompact.thresholdTokens) {
-            const beforeSeq = microcompactBoundarySeq(log.all);
+            const beforeSeq = microcompactBoundarySeq(log.all, config.microcompact.keepResults ?? KEEP_COMPACTABLE_RESULTS);
             if (beforeSeq !== undefined) {
                 const full = log.append({ type: "microcompacted", beforeSeq });
                 if (hooks.onEvent)
@@ -867,23 +867,24 @@ function sleep(ms, signal) {
     });
 }
 /**
- * C 区 (自举 #3): how many of the NEWEST compactable tool results survive a
- * microcompact boundary — the model must keep reasoning over the recent
- * results, whatever turn they belong to.
+ * C 区 (自举 #3): the DEFAULT for how many of the NEWEST compactable tool
+ * results survive a microcompact boundary (overridable per config via
+ * microcompact.keepResults) — the model must keep reasoning over the
+ * recent results, whatever turn they belong to.
  */
 const KEEP_COMPACTABLE_RESULTS = 4;
 /**
  * C 区: the boundary seq for a microcompact — drawn by COMPACTABLE-RESULT
  * recentness, never user turns: a SINGLE user turn that reads several big
  * files (the coding agent's main overflow shape) crosses the threshold and
- * must trigger. The newest KEEP_COMPACTABLE_RESULTS still-visible
- * compactable tool results stay intact; the boundary points AT the
- * (K+1)th-newest of them, so it and everything older is cleared. Results
- * already cleared by an earlier boundary do not count toward the kept
- * window — each new boundary makes progress. Undefined when fewer than
- * K+1 compactable results remain (the kept window is the whole context).
+ * must trigger. The newest `keepResults` still-visible compactable tool
+ * results stay intact; the boundary points AT the (K+1)th-newest of them,
+ * so it and everything older is cleared. Results already cleared by an
+ * earlier boundary do not count toward the kept window — each new boundary
+ * makes progress. Undefined when fewer than keepResults+1 compactable
+ * results remain (the kept window is the whole context).
  */
-function microcompactBoundarySeq(events) {
+function microcompactBoundarySeq(events, keepResults) {
     const callName = new Map();
     let lastCleared = -1;
     for (const ev of events) {
@@ -900,9 +901,9 @@ function microcompactBoundarySeq(events) {
         if (name !== undefined && MICROCOMPACTABLE.has(name))
             visible.push(ev.seq);
     }
-    if (visible.length <= KEEP_COMPACTABLE_RESULTS)
+    if (visible.length <= keepResults)
         return undefined;
-    return visible[visible.length - KEEP_COMPACTABLE_RESULTS - 1];
+    return visible[visible.length - keepResults - 1];
 }
 /** A signal that never aborts — for executions outside any abort scope. */
 const NEVER_ABORT = {

package/dist/protocol/extension.d.ts

@@ -39,4 +39,24 @@ export interface KisoExtension {
     readonly hooks?: HookHost;
     readonly tools?: readonly Tool[];
     readonly approvals?: readonly ApprovalPolicy[];
+    /**
+     * E2: the extension's compaction config — supplies the loop's microcompact
+     * parameters (threshold + optional keepResults) when the session config
+     * does not set its own microcompact.
+     */
+    readonly compaction?: {
+        readonly thresholdTokens?: number;
+        readonly keepResults?: number;
+    };
+    /**
+     * E2: EXTEND the system prompt — append-only, never replace (a replace
+     * is a footgun; appends guarantee "adding an extension never removes
+     * existing guidance" — the monotonicity family of the approval chain's
+     * deny>ask>allow and the veto short-circuit). The session's own
+     * systemPrompt comes first, then each extension's append in load order,
+     * \n\n-joined.
+     */
+    readonly systemPrompt?: {
+        readonly append: string;
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincemakes/kiso-core",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "kiso(基礎) core — protocol, event log, loop, hooks, modes, permissions, compaction, delivery truth. The 2,000-line kernel at the bottom of the kiso framework.",
   "type": "module",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "openai"
   ],
   "devDependencies": {
-    "@vincemakes/kiso-evals": "0.1.5",
+    "@vincemakes/kiso-evals": "0.1.6",
     "@types/node": "^26.1.2",
     "typescript": "^5.7.2",
     "vitest": "^3.0.0"