@akanjs/cli 3.1.0-rc.11 → 3.1.0-rc.12

package/.build-stamp

@@ -1 +1 @@
-171ce01d24fb85578a6a0d8092afa7851ebc872608d4b93f3fcee8e760e82352
+45dc4be5e34b35b9eaac8daa987756f8464382b61a5afdc7f0d60d658b487b2f

package/{CodeAgent-rkjyxgec.js → CodeAgent-fhrb6xyw.js}

@@ -1,8 +1,8 @@
 // @bun
 import {
   CodeAgent2
-} from "./index-8fp3b47h.js";
-import"./index-20bxxyvn.js";
+} from "./index-zjgs0t7s.js";
+import"./index-ht15pm08.js";
 import"./index-7md2g9vw.js";
 export {
   CodeAgent2 as CodeAgent

package/{CodeAgentRpcHost-p7h6n2hp.js → CodeAgentRpcHost-9g27hmer.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   CodeAgentRpcHost2
-} from "./index-d2242ksy.js";
+} from "./index-at7bz0xq.js";
 export {
   CodeAgentRpcHost2 as CodeAgentRpcHost
 };

package/{CodeTui-h7pyj6xa.js → CodeTui-ntnda5dn.js}

@@ -3,8 +3,9 @@ import {
   SubagentPool2,
   McpServerConfig,
   McpTokenStore,
-  McpSignIn
-} from "./index-20bxxyvn.js";
+  McpSignIn,
+  AkanCodeCompaction2
+} from "./index-ht15pm08.js";
 import {
   CodeTuiLines2,
   CodeTuiAgents2,
@@ -14,7 +15,7 @@ import {
   CodeTuiFiles2,
   CodeTuiMarkdown2,
   CodeTuiParts2
-} from "./index-wa5jbxj1.js";
+} from "./index-2mrn1mrg.js";
 import {
   openBrowser
 } from "./index-9dp031by.js";
@@ -345,6 +346,34 @@ var CodeTuiApp = ({ actions }) => {
   }, undefined, true, undefined, this);
 };
 
+// pkgs/@akanjs/cli/code/CodeTuiAutoCompact.ts
+class CodeTuiAutoCompact {
+  static parse(argument) {
+    const percent = Number(argument.trim().replace(/%$/, ""));
+    return argument.trim() && AkanCodeCompaction2.isStep(percent) ? percent : undefined;
+  }
+  static describe(info) {
+    const percent = info?.autoCompactAt;
+    const label = `autocompact ${percent ? `${percent}%` : "default"}`;
+    const window = info?.contextTokens;
+    if (!window)
+      return label;
+    const threshold = AkanCodeCompaction2.thresholdOf(window, percent);
+    const k = (tokens) => `${Math.round(tokens / 1000)}k`;
+    const capped = percent && threshold < Math.floor(window * percent / 100) ? `, the latest that still leaves ${k(window - threshold)} for the reply` : "";
+    return `${label} \xB7 compacts above ${k(threshold)} of ${k(window)}${capped}`;
+  }
+  static usage(info) {
+    return [
+      "Usage: /autocompact <percent>",
+      "",
+      `now: ${CodeTuiAutoCompact.describe(info)}`,
+      `${AkanCodeCompaction2.steps.join(" \xB7 ")} \u2014 100 is the default`
+    ].join(`
+`);
+  }
+}
+
 // pkgs/@akanjs/cli/code/CodeTuiMcp.ts
 class CodeTuiMcp {
   static namePattern = /^[a-zA-Z0-9_-]+$/;
@@ -897,7 +926,8 @@ class CodeTui {
     const context = this.#transcript.context;
     const window = info.contextTokens ? `${Math.round(info.contextTokens / 1000)}k` : "";
     const used = context?.max ? `${Math.round(context.used / context.max * 100)}% of ${window}` : "";
-    return [info.model?.name ?? "no model", used || window && `${window} ctx`, info.profile, info.effort].filter((part) => !!part).join(" \xB7 ");
+    const compactsAt = info.autoCompactAt ? `compacts at ${info.autoCompactAt}%` : "";
+    return [info.model?.name ?? "no model", used || window && `${window} ctx`, compactsAt, info.profile, info.effort].filter((part) => !!part).join(" \xB7 ");
   }
   #status() {
     if (this.#transcript.compacting)
@@ -1248,6 +1278,8 @@ class CodeTui {
         return this.#say("screen cleared \xB7 the model still remembers \xB7 /compact shortens what it carries");
       case "compact":
         return void this.#agent.compact(argument || undefined).catch((error) => this.#fail(error));
+      case "autocompact":
+        return this.#setAutoCompact(argument);
       case "thinking":
         this.#thinking = !this.#thinking;
         return this.#say(this.#thinking ? "showing the model's reasoning" : "reasoning folded back to one line");
@@ -1410,6 +1442,17 @@ ${levels.join(" \xB7 ")}`);
       this.#fail(error);
     }
   }
+  #setAutoCompact(argument) {
+    const percent = CodeTuiAutoCompact.parse(argument);
+    if (percent === undefined)
+      return this.#open("autocompact", CodeTuiAutoCompact.usage(this.#transcript.info));
+    try {
+      this.#agent.setAutoCompactAt(percent);
+      this.#say(CodeTuiAutoCompact.describe(this.#transcript.info));
+    } catch (error) {
+      this.#fail(error);
+    }
+  }
   #setModel(argument) {
     const wanted = argument.trim();
     const [provider, ...rest] = wanted.split("/");

package/akanCode.js

@@ -28,7 +28,7 @@ import {
   CodeMailbox2,
   CodeSessionFork2,
   CodeAgent2
-} from "./index-8fp3b47h.js";
+} from "./index-zjgs0t7s.js";
 import {
   akanCodeDefaultModel2,
   akanCodeModel2,
@@ -38,12 +38,13 @@ import {
 } from "./index-c6eggbee.js";
 import {
   SubagentPool2,
-  akanCodePaths2
-} from "./index-20bxxyvn.js";
+  akanCodePaths2,
+  AkanCodeCompaction2
+} from "./index-ht15pm08.js";
 import"./index-7md2g9vw.js";
 import {
   CodeAgentRpcHost2
-} from "./index-d2242ksy.js";
+} from "./index-at7bz0xq.js";
 import {
   CodeTuiLines2,
   CodeTuiAgents2,
@@ -53,9 +54,10 @@ import {
   CodeTuiFiles2,
   CodeTuiMarkdown2,
   CodeTuiParts2
-} from "./index-wa5jbxj1.js";
+} from "./index-2mrn1mrg.js";
 export {
   AkanCli2 as AkanCli,
+  AkanCodeCompaction2 as AkanCodeCompaction,
   AkanCodePlugins2 as AkanCodePlugins,
   AkanCodeServices2 as AkanCodeServices,
   AkanEditScope2 as AkanEditScope,

package/{code.command-0ad6gw2a.js → code.command-3sxektnr.js}

@@ -19,8 +19,8 @@ class CodeRunner extends runner("code") {
   async serve(options, listen) {
     await import("./consoleToStderr-h5bryj94.js");
     const [{ CodeAgent }, { CodeAgentRpcHost }, { CodeAgentRpcListener }] = await Promise.all([
-      import("./CodeAgent-rkjyxgec.js"),
-      import("./CodeAgentRpcHost-p7h6n2hp.js"),
+      import("./CodeAgent-fhrb6xyw.js"),
+      import("./CodeAgentRpcHost-9g27hmer.js"),
       import("./CodeAgentRpcListener-7p7z5dd7.js")
     ]);
     const address = listen ? CodeAgentRpcListener.parse(listen) : null;
@@ -34,21 +34,28 @@ class CodeRunner extends runner("code") {
   }
   async tui(options, seed) {
     const [{ CodeAgent }, { CodeTui }] = await Promise.all([
-      import("./CodeAgent-rkjyxgec.js"),
-      import("./CodeTui-h7pyj6xa.js")
+      import("./CodeAgent-fhrb6xyw.js"),
+      import("./CodeTui-ntnda5dn.js")
     ]);
     const agentOptions = await CodeRunner.#agentOptions(options, false);
     let resume = options.resume;
+    let autoCompactAt = agentOptions.autoCompactAt;
     let prompt = seed;
     let notice;
     for (;; ) {
-      const agent = await CodeAgent.create({ ...agentOptions, mode: "tui", ...resume ? { resume } : {} });
+      const agent = await CodeAgent.create({
+        ...agentOptions,
+        mode: "tui",
+        ...resume ? { resume } : {},
+        ...autoCompactAt ? { autoCompactAt } : {}
+      });
       let next;
       try {
         next = await new CodeTui(agent, {
           thinking: options.thinking,
           ...notice ? { notice } : {}
         }).run(prompt);
+        autoCompactAt = agent.info.autoCompactAt;
       } finally {
         agent.dispose();
       }
@@ -60,7 +67,7 @@ class CodeRunner extends runner("code") {
     }
   }
   async run(prompt, options) {
-    const { CodeAgent } = await import("./CodeAgent-rkjyxgec.js");
+    const { CodeAgent } = await import("./CodeAgent-fhrb6xyw.js");
     const agent = await CodeAgent.create(await CodeRunner.#agentOptions(options, false));
     const printer = new CodeAgentStreamPrinter2({ json: options.json, thinking: options.thinking });
     agent.on((event) => printer.print(event));
@@ -80,7 +87,8 @@ class CodeRunner extends runner("code") {
       cwd: profile.paths.root,
       profile,
       apps: options.app ? [options.app] : await options.workspace.getApps(),
-      model: CodeRunner.modelOf(options.model)
+      model: CodeRunner.modelOf(options.model),
+      ...options.compactAt !== undefined ? { autoCompactAt: options.compactAt } : {}
     };
   }
   static profileOf(options, { hostAttached }) {
@@ -116,6 +124,7 @@ class CodeScript extends script("code", [CodeRunner]) {
       ...options.app ? { app: options.app } : {},
       profile: options.profile,
       ...options.model ? { model: options.model } : {},
+      ...options.compactAt !== null ? { compactAt: options.compactAt } : {},
       json: options.json,
       thinking: options.thinking,
       ...options.resume ? { resume: options.resume } : {}
@@ -135,7 +144,11 @@ class CodeScript extends script("code", [CodeRunner]) {
 
 // pkgs/@akanjs/cli/code/code.command.ts
 class CodeCommand extends command("code", [CodeScript], ({ public: target }) => ({
-  code: target({ desc: "Run the akan coding agent on a prompt" }).arg("prompt", String, { desc: "what the agent should do", nullable: true }).option("app", String, { desc: "narrow the agent to one app instead of the whole repo", nullable: true }).option("profile", String, { desc: "local, pod, review, or web", default: "local" }).option("model", String, { desc: "<provider>/<id>, e.g. deepseek/deepseek-flash", nullable: true }).option("json", Boolean, { desc: "print one event per line as JSON", default: false }).option("thinking", Boolean, { desc: "print the model's reasoning", default: false }).option("rpc", Boolean, { desc: "serve the agent over stdio for another process to drive", default: false }).option("rpcListen", String, {
+  code: target({ desc: "Run the akan coding agent on a prompt" }).arg("prompt", String, { desc: "what the agent should do", nullable: true }).option("app", String, { desc: "narrow the agent to one app instead of the whole repo", nullable: true }).option("profile", String, { desc: "local, pod, review, or web", default: "local" }).option("model", String, { desc: "<provider>/<id>, e.g. deepseek/deepseek-flash", nullable: true }).option("compactAt", Number, {
+    desc: "compact once the context window is this full, in percent: 10, 20, \u2026 100",
+    flag: "c",
+    nullable: true
+  }).option("json", Boolean, { desc: "print one event per line as JSON", default: false }).option("thinking", Boolean, { desc: "print the model's reasoning", default: false }).option("rpc", Boolean, { desc: "serve the agent over stdio for another process to drive", default: false }).option("rpcListen", String, {
     desc: "serve the RPC wire on unix:<path> or tcp:[host:]<port> instead of stdio",
     flag: "L",
     nullable: true
@@ -143,8 +156,8 @@ class CodeCommand extends command("code", [CodeScript], ({ public: target }) =>
     desc: "open the full-screen session even when a prompt is given",
     flag: "i",
     default: false
-  }).with(Workspace).exec(async function(prompt, app, profile, model, json, thinking, rpc, rpcListen, resume, interactive, workspace) {
-    const options = { app, profile, model, json, thinking, rpc, rpcListen, interactive, resume };
+  }).with(Workspace).exec(async function(prompt, app, profile, model, compactAt, json, thinking, rpc, rpcListen, resume, interactive, workspace) {
+    const options = { app, profile, model, compactAt, json, thinking, rpc, rpcListen, interactive, resume };
     await this.codeScript.run(workspace, prompt ?? "", options);
   })
 })) {

package/guidelines/conventions/conventions.instruction.md

@@ -445,7 +445,9 @@ orchestration in `service`, client state in `store`; `Template` is forms, `Unit`
 - Import `Int`, `Float`, `ID`, `Any`, `Binary`, `Upload`, `ImageResult`, `enumOf`, `dayjs` from `akanjs/base`;
   `String` / `Boolean` / `Date` are globals. No `JSON` scalar (use `Any`), no `Number`, and `Binary` / `Upload` are
   never fields — a file is `field(File).optional()` / `field([File])`, uploaded by the generated
-  `upload<Field>On<Model>`.
+  `upload<Field>On<Model>` (which `Field.Img` / `Files` and siblings use when handed the generated setter); it marks
+  the field in `<model>FormUploading` while the request runs and drops a result whose form was set whole meanwhile
+  (or, on a single field, re-picked) — gate a hand-written submit on it.
 - Defaults: a literal for scalars, a thunk for anything constructed (`default: () => dayjs()`). Arrays
   `field([T])`; optional `.optional()`.
 - **`field.hidden` / `field.secret` read `null` on the client while the type declares them** — guard with `??` or

package/guidelines/fieldRule/fieldRule.instruction.md

@@ -64,6 +64,18 @@ Use this whenever generating constants or scalar constants. It defines the curre
   field as a relation to `File`: `image: field(File).optional()` for one, `images: field([File])` for many.
 - The store then auto-generates an `upload<Field>On<Model>(fileList)` action that calls the framework upload
   mutation and polls file status until it leaves `"uploading"` (`pkgs/akanjs/store/action.ts`).
+- **An upload is scoped to the form that started it.** `Field.Img` / `Imgs` / `File` / `Files` handed the generated
+  `set<Field>On<Model>` upload through `upload<Field>On<Model>` (any other `onChange` keeps the plain slice upload).
+  While the request runs, `<model>FormUploading` holds a ticket under the field's name (`{}` when idle);
+  `check<Model>Submitable`, `Model.EditModal` and `Model.ViewEditModal` keep submit disabled, and
+  `create` / `update<Model>InForm` (so `submit<Model>`) save nothing. A written result runs `_postSet<Field>` like
+  any setter. The result is dropped when the form was set whole meanwhile (`new` / `edit` / `reset`, a save, a
+  draft restore, `set<Model>Form`, an edit shell's hydration — the store clears the key on every
+  `set({ <model>Form })` — or another record's id) or, on a single field, when a newer upload or a
+  `set<Field>On<Model>` superseded it; an array field inserts into the list as it is when the result lands. A form
+  replaced inside an immer updater (`set((state) => { state.<model>Form = … })`) is not seen, so its uploads stay
+  valid. A hand-written submit reads `Object.keys(st.use.<model>FormUploading()).length` rather than tracking uploads
+  itself.
 - Storage is wired through the `StorageAdaptor` DI role (default `BlobStorage`,
   `pkgs/akanjs/service/predefinedAdaptor/storage.adaptor.ts`); the reference implementation is the `file` module.
   Do not hand-roll data-URL fallbacks. `{ cascade: "removeRef" }` on the field removes the file with its owner

package/guidelines/queryRule/queryRule.instruction.md

@@ -221,7 +221,9 @@ shape, so `cascade` never means "related" — it means one of exactly these:
   and an unmounted `removeRef` target or `removeWith` owner fails the boot rather than the first removal. An
   unmounted `refPath` candidate only warns, since that list spans optional modules by design.
 - **Nothing checks whether another document still references the same target.** `File` in particular is deduped
-  by `origin`, so two parents can share one row; `removeRef` claims the field owns its target exclusively.
+  by `origin`, so two parents can share one row; `removeRef` claims the field owns its target exclusively. Removing
+  the first parent removes the shared row; the second parent's cascade later skips it, since a live-row lookup per
+  edge (200 ids at a time) drops a target that is already gone, and still runs the rest of its edges.
 - **A reference no cascade removes keeps pointing at the removed row, and a response reads it live-only**: a list
   leaves the target out, an optional field reads `null`, and a required one answers 404
   `base.error.relationNotFound` naming the model and the field path. Make a reference whose target can go first

package/{index-wa5jbxj1.js → index-2mrn1mrg.js}

@@ -250,6 +250,7 @@ class CodeTuiCommands2 {
     { name: "effort", desc: "how hard the model thinks before it answers", arg: "<level>" },
     { name: "thinking", desc: "show the model's reasoning, or fold it away again" },
     { name: "compact", desc: "summarise the conversation to free the window", arg: "[notes]" },
+    { name: "autocompact", desc: "how full the window gets before it is summarised", arg: "[<percent>]" },
     { name: "abort", desc: "stop the running turn" },
     { name: "clear", desc: "wipe the screen; the model keeps the conversation" },
     { name: "name", desc: "name this session", arg: "<text>" },

package/{index-d2242ksy.js → index-at7bz0xq.js}

@@ -77,6 +77,9 @@ class CodeAgentRpcHost2 {
       case "set_model":
         await this.#agent.setModel({ provider: command.provider, id: command.modelId });
         return await this.#agent.state();
+      case "set_auto_compact":
+        this.#agent.setAutoCompactAt(command.percent);
+        return await this.#agent.state();
       case "get_state":
         return await this.#agent.state(command.sinceSeq === undefined ? {} : { sinceSeq: command.sinceSeq });
       case "shutdown":

package/{index-20bxxyvn.js → index-ht15pm08.js}

@@ -3,6 +3,44 @@ import {
   ConfigLock
 } from "./index-bqbf654f.js";
 
+// pkgs/@akanjs/devkit/codeAgent/agent/AkanCodeCompaction.ts
+class AkanCodeCompaction2 {
+  static reserveFloor = 32768;
+  static steps = [10, 20, 30, 40, 50, 60, 70, 80, 90, 100];
+  static isStep(percent) {
+    return AkanCodeCompaction2.steps.some((step) => step === percent);
+  }
+  static normalize(percent) {
+    if (percent === undefined)
+      return;
+    if (!AkanCodeCompaction2.isStep(percent))
+      throw new Error(`Autocompact takes a percent in steps of 10: ${AkanCodeCompaction2.steps.join(", ")}.`);
+    return percent === 100 ? undefined : percent;
+  }
+  static thresholdOf(contextWindow, percent) {
+    const share = percent ? Math.floor(contextWindow * percent / 100) : contextWindow;
+    return Math.min(share, contextWindow - AkanCodeCompaction2.reserveFloor);
+  }
+  static apply(settings, model, percent) {
+    const threshold = AkanCodeCompaction2.thresholdOf(model.contextWindow, percent);
+    settings.applyOverrides({
+      compaction: {
+        modelOverrides: { [`${model.provider}/${model.id}`]: { reserveTokens: model.contextWindow - threshold } }
+      }
+    });
+  }
+  static problemOf(model, percent, keepRecentTokens) {
+    const name = `${model.provider}/${model.id}`;
+    if (model.contextWindow <= 0)
+      return `${name} declares no context window, so it has no share to compact at.`;
+    const threshold = AkanCodeCompaction2.thresholdOf(model.contextWindow, percent);
+    if (threshold >= keepRecentTokens)
+      return;
+    const k = (tokens) => `${Math.round(tokens / 1000)}k`;
+    return `Compacting at ${percent}% of the ${k(model.contextWindow)} window of ${name} starts at ${k(threshold)}, under the ${k(keepRecentTokens)} of recent turns every compaction keeps, so every turn would compact again.`;
+  }
+}
+
 // pkgs/@akanjs/devkit/codeAgent/agent/akanCodePaths.ts
 import { existsSync } from "fs";
 import { homedir } from "os";
@@ -141,7 +179,7 @@ class SubagentPool2 {
     }
   }
   async#run(id, kind, prompt, signal) {
-    const { CodeAgent } = await import("./CodeAgent-rkjyxgec.js");
+    const { CodeAgent } = await import("./CodeAgent-fhrb6xyw.js");
     const budget = this.#options.parent.tools.subagent;
     const child = SubagentPool2.childOf(this.#options.parent, kind);
     const agent = await CodeAgent.create({
@@ -697,4 +735,4 @@ ${stored.refreshToken}`;
   }
 }
 
-export { SubagentPool2, akanCodePaths2, McpServerConfig, McpTokenStore, McpSignIn };
+export { SubagentPool2, akanCodePaths2, McpServerConfig, McpTokenStore, McpSignIn, AkanCodeCompaction2 };

package/{index-8fp3b47h.js → index-zjgs0t7s.js}

@@ -3,8 +3,9 @@ import {
   SubagentPool2,
   akanCodePaths2,
   McpServerConfig,
-  McpSignIn
-} from "./index-20bxxyvn.js";
+  McpSignIn,
+  AkanCodeCompaction2
+} from "./index-ht15pm08.js";
 import {
   stripAnsi
 } from "./index-7md2g9vw.js";
@@ -254,7 +255,7 @@ class AkanCodeServices2 {
       enableInstallTelemetry: false,
       enableAnalytics: false,
       quietStartup: true,
-      compaction: { reserveTokens: 32768 }
+      compaction: { reserveTokens: AkanCodeCompaction2.reserveFloor }
     });
   }
   static async runtime(workspaceRoot, proxy = null) {
@@ -2308,6 +2309,7 @@ class CodeAgent2 {
   #replay = [];
   #replayFrom = 0;
   #lastContextTokens;
+  #autoCompactAt;
   constructor(profile) {
     this.#profile = profile;
     this.#gate = new CodeAgentGate2(profile);
@@ -2316,6 +2318,7 @@ class CodeAgent2 {
     const workspaceRoot = options.workspace.workspaceRoot;
     const cwd = options.cwd ?? workspaceRoot;
     const agent = new CodeAgent2(options.profile);
+    const autoCompactAt = AkanCodeCompaction2.normalize(options.autoCompactAt);
     const settingsManager = AkanCodeServices2.settings();
     const modelRuntime = await AkanCodeServices2.runtime(workspaceRoot, CodeAgentProxy.fromEnv(options.profile));
     const model = await akanCodeModel2(modelRuntime, options.model);
@@ -2365,10 +2368,11 @@ class CodeAgent2 {
     if (options.profile.session.store !== "memory")
       agent.#sessionDir = akanCodePaths2.sessionsDir(workspaceRoot);
     await agent.#attach(session, options.mode ?? "print");
+    const autoCompactWarning = agent.#fitAutoCompact(autoCompactAt);
     agent.#suspended = new CodeAgentSuspended(CodeAgentSuspended.fileOf(agent.#sessionDir, agent.sessionId));
     if (agent.#sessionDir && options.profile.session.store === "file")
       agent.#openMail(akanCodePaths2.mailDir(workspaceRoot), cwd);
-    for (const message of modelWarnings)
+    for (const message of [...modelWarnings, ...autoCompactWarning])
       agent.#emit({ type: "notice", level: "warning", message });
     return agent;
   }
@@ -2433,6 +2437,7 @@ ${mail.text}`).catch((error) => this.#emit({ type: "notice", level: "error", mes
       tools: session.getActiveToolNames(),
       contextTokens: model?.contextWindow,
       effort: session.supportsThinking() ? session.thinkingLevel : undefined,
+      autoCompactAt: this.#autoCompactAt,
       name: session.sessionName,
       interaction: this.#profile.interaction
     };
@@ -2581,8 +2586,38 @@ Continue the task.`);
     if (!model)
       throw new Error(`Unknown model: ${ref.provider}/${ref.id}`);
     await session.setModel(model);
+    for (const message of this.#fitAutoCompact(this.#autoCompactAt))
+      this.#emit({ type: "notice", level: "warning", message });
     this.#emit({ type: "session", info: this.info });
   }
+  setAutoCompactAt(percent) {
+    const wanted = AkanCodeCompaction2.normalize(percent);
+    const problem = this.#autoCompactProblem(wanted);
+    if (problem)
+      throw new Error(problem);
+    this.#autoCompactAt = wanted;
+    this.#applyAutoCompact();
+    this.#emit({ type: "session", info: this.info });
+  }
+  #fitAutoCompact(percent) {
+    const problem = this.#autoCompactProblem(percent);
+    this.#autoCompactAt = problem ? undefined : percent;
+    this.#applyAutoCompact();
+    return problem ? [`${problem} Autocompact is back to the default.`] : [];
+  }
+  #autoCompactProblem(percent) {
+    const session = this.#require();
+    const model = session.model;
+    if (!model || !percent)
+      return;
+    const { keepRecentTokens } = session.settingsManager.getCompactionSettings(model);
+    return AkanCodeCompaction2.problemOf(model, percent, keepRecentTokens);
+  }
+  #applyAutoCompact() {
+    const session = this.#require();
+    if (session.model)
+      AkanCodeCompaction2.apply(session.settingsManager, session.model, this.#autoCompactAt);
+  }
   async waitForIdle() {
     await this.#require().waitForIdle();
   }

package/index.js

@@ -15,7 +15,7 @@ import path from "path";
 var commandModules = {
   workspace: async () => (await import("./workspace.command-6qfgq4b4.js")).WorkspaceCommand,
   agent: async () => (await import("./agent.command-3qxf4xcj.js")).AgentCommand,
-  code: async () => (await import("./code.command-0ad6gw2a.js")).CodeCommand,
+  code: async () => (await import("./code.command-3sxektnr.js")).CodeCommand,
   application: async () => (await import("./application.command-m1kcd7jf.js")).ApplicationCommand,
   library: async () => (await import("./library.command-erp2f56n.js")).LibraryCommand,
   localRegistry: async () => (await import("./localRegistry.command-y176p558.js")).LocalRegistryCommand,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "3.1.0-rc.11",
+  "version": "3.1.0-rc.12",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -39,7 +39,7 @@
     "@earendil-works/pi-tui": "1.3.0",
     "@inquirer/prompts": "^8.7.3",
     "@tailwindcss/node": "^4.3.3",
-    "akanjs": "3.1.0-rc.11",
+    "akanjs": "3.1.0-rc.12",
     "chalk": "^6.0.1",
     "commander": "^15.0.0",
     "dayjs": "^1.11.23",

package/skills/akan-code/SKILL.md

@@ -78,6 +78,9 @@ Stored under `.akan/code/sessions` — project history, so a second checkout of
 - `/peers` lists other `akan code` sessions running in this workspace; `/msg <peer> <text>` hands one a
   message.
 - `/clear` wipes the screen and keeps the conversation; `/compact [notes]` shortens what the model carries.
+- `/autocompact <percent>` compacts on its own once the window is that full, in steps of 10 (`/autocompact 60`);
+  `100` is the default, which waits until 32k remain for the reply. `akan code --compact-at 60` (`-c`) starts
+  with it, and a share under the 20k every compaction keeps is refused.
 
 ## Model, effort, keys
 
@@ -119,6 +122,7 @@ akan code -i "<prompt>"         open the session with the prompt already sent
 --app <name>                    narrow the agent to one app
 --profile local|pod|review|web  what it may do (default local)
 --model <provider>/<id>         --thinking, --json, --rpc, --resume <id>
+--compact-at <percent>          compact once the window is this full (10, 20, … 100)
 ```
 
 `review` reads and never writes, loads no project context files, and keeps no session on disk. `pod` has

package/skills/akan-store/SKILL.md

@@ -26,7 +26,8 @@ For a model `comment` (`<Slice>` is a signal slice suffix, e.g. `InPublic`):
 
 ## Generated state — `st.use.*`
 
-`comment`, `commentLoading`, `commentForm`, `commentFormLoading`, `commentSubmit`, `commentModal`,
+`comment`, `commentLoading`, `commentForm`, `commentFormLoading`, `commentFormUploading` (uploads in flight, per
+`File` field — non-empty means do not submit), `commentSubmit`, `commentModal`,
 `commentViewAt`, `commentOperation`; per slice `commentList<Slice>`, `commentListLoading<Slice>`,
 `commentInitList<Slice>`, `commentSelection<Slice>`, `commentInsight<Slice>`, `pageOfComment<Slice>`,
 `lastPageOfComment<Slice>`, `hasMoreOfComment<Slice>`, `limitOfComment<Slice>`, `sortOfComment<Slice>`.