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

package/.build-stamp

@@ -1 +1 @@
-171ce01d24fb85578a6a0d8092afa7851ebc872608d4b93f3fcee8e760e82352
+7bcd4fe279524ed2759e02783eb078a66b8ee0e6acee19a817c2f751ecba695a

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

@@ -1,8 +1,8 @@
 // @bun
 import {
   CodeAgent2
-} from "./index-8fp3b47h.js";
-import"./index-20bxxyvn.js";
+} from "./index-1djcjcre.js";
+import"./index-dye8pnxx.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-fnm9ft4d.js}

@@ -3,8 +3,9 @@ import {
   SubagentPool2,
   McpServerConfig,
   McpTokenStore,
-  McpSignIn
-} from "./index-20bxxyvn.js";
+  McpSignIn,
+  AkanCodeCompaction2
+} from "./index-dye8pnxx.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-1djcjcre.js";
 import {
   akanCodeDefaultModel2,
   akanCodeModel2,
@@ -38,12 +38,13 @@ import {
 } from "./index-c6eggbee.js";
 import {
   SubagentPool2,
-  akanCodePaths2
-} from "./index-20bxxyvn.js";
+  akanCodePaths2,
+  AkanCodeCompaction2
+} from "./index-dye8pnxx.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-130bdmhe.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-n3tzjm91.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-n3tzjm91.js"),
+      import("./CodeTui-fnm9ft4d.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-n3tzjm91.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-8fp3b47h.js → index-1djcjcre.js}

@@ -3,8 +3,9 @@ import {
   SubagentPool2,
   akanCodePaths2,
   McpServerConfig,
-  McpSignIn
-} from "./index-20bxxyvn.js";
+  McpSignIn,
+  AkanCodeCompaction2
+} from "./index-dye8pnxx.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) {
@@ -318,7 +319,7 @@ import {
   DefaultResourceLoader
 } from "@earendil-works/pi-coding-agent";
 import {
-  codeAgentClip as codeAgentClip5,
+  codeAgentClip as codeAgentClip6,
   codeAgentLabelChars as codeAgentLabelChars2,
   codeAgentRenderAnswer,
   codeAgentSessionName as codeAgentSessionName2
@@ -1395,11 +1396,120 @@ class SessionToolPack2 {
 }
 
 // pkgs/@akanjs/devkit/codeAgent/tools/WebToolPack.ts
-import { codeAgentClip as codeAgentClip3, codeAgentOutputChars as codeAgentOutputChars3 } from "akanjs/common";
+import { isIP } from "net";
+import { codeAgentClip as codeAgentClip4 } from "akanjs/common";
 import { Type as Type6 } from "typebox";
 
+// pkgs/@akanjs/devkit/codeAgent/tools/DeepSeekWeb.ts
+import { codeAgentClip as codeAgentClip3 } from "akanjs/common";
+
+class DeepSeekWeb {
+  static baseUrl = "https://api.deepseek.com/v1/tools";
+  static maxQueryChars = 128;
+  static summaryChars = 600;
+  static #retryable = {
+    search: [408, 429, 500, 502, 503, 504],
+    fetch: [429]
+  };
+  static #attempts = 3;
+  #key;
+  #baseUrl;
+  constructor(key, baseUrl = DeepSeekWeb.baseUrl) {
+    this.#key = key;
+    this.#baseUrl = baseUrl;
+  }
+  static async fromRuntime(runtime, proxied) {
+    if (proxied)
+      return;
+    const key = (await runtime.getAuth("deepseek").catch(() => {
+      return;
+    }))?.auth.apiKey;
+    return key ? new DeepSeekWeb(key) : undefined;
+  }
+  async search(query, count, signal) {
+    if ([...query].length > DeepSeekWeb.maxQueryChars)
+      throw new Error(`DeepSeek search takes at most ${DeepSeekWeb.maxQueryChars} characters; shorten the query.`);
+    const body = await this.#call("search", { query, count }, 20000, signal);
+    const byUrl = new Map;
+    for (const result of body.results ?? []) {
+      const url = DeepSeekWeb.#cleanUrl(result.url);
+      if (!byUrl.has(url))
+        byUrl.set(url, { ...result, url });
+    }
+    return [...byUrl.values()].map((result) => {
+      const date = result.date ? ` \xB7 ${result.date.slice(0, 10)}` : "";
+      const summary = DeepSeekWeb.unescape(result.summary || result.snippet || "").replace(/\s+/g, " ").trim();
+      return `- ${result.title}
+  ${result.url}${date}
+  ${codeAgentClip3(summary, DeepSeekWeb.summaryChars)}`;
+    }).join(`
+`);
+  }
+  async fetch(url, signal) {
+    const page = await this.#call("fetch", { url }, 30000, signal);
+    return { title: page.title ?? "", content: DeepSeekWeb.unescape(page.content ?? "") };
+  }
+  static unescape(markdown) {
+    const escaped = markdown.match(/\\[!-/:-@[-`{-~]/g)?.length ?? 0;
+    const punctuation = markdown.match(/[!-/:-@[-`{-~]/g)?.length ?? 0;
+    if (!escaped || escaped < (punctuation - escaped) / 2)
+      return markdown;
+    return markdown.replace(/\\([!-/:-@[-`{-~])/g, "$1");
+  }
+  async#call(tool, body, timeoutMs, signal) {
+    for (let attempt = 1;; attempt++) {
+      const response = await fetch(`${this.#baseUrl}/${tool}`, {
+        method: "POST",
+        headers: { authorization: `Bearer ${this.#key}`, "content-type": "application/json" },
+        body: JSON.stringify(body),
+        signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(timeoutMs)]) : AbortSignal.timeout(timeoutMs)
+      });
+      if (response.ok)
+        return await response.json();
+      if (!DeepSeekWeb.#retryable[tool].includes(response.status) || attempt >= DeepSeekWeb.#attempts) {
+        const error = await response.json().catch(() => {
+          return;
+        });
+        throw new Error(`DeepSeek ${tool} answered ${response.status}: ${error?.error?.message ?? response.statusText}`);
+      }
+      await DeepSeekWeb.#wait(DeepSeekWeb.#delayOf(response, attempt), signal);
+    }
+  }
+  static #delayOf(response, attempt) {
+    const retryAfter = Number(response.headers.get("retry-after"));
+    return Number.isFinite(retryAfter) && retryAfter > 0 ? Math.min(retryAfter, 5) * 1000 : 1000 * 2 ** (attempt - 1);
+  }
+  static #wait(ms, signal) {
+    return new Promise((resolve) => {
+      const timer = setTimeout(resolve, ms);
+      signal?.addEventListener("abort", () => {
+        clearTimeout(timer);
+        resolve();
+      }, { once: true });
+    });
+  }
+  static #cleanUrl(url) {
+    try {
+      const parsed = new URL(url);
+      for (const name of [...parsed.searchParams.keys()])
+        if (name.startsWith("utm_"))
+          parsed.searchParams.delete(name);
+      if (/^#\d+$/.test(parsed.hash))
+        parsed.hash = "";
+      return parsed.toString();
+    } catch {
+      return url;
+    }
+  }
+}
+
+// pkgs/@akanjs/devkit/codeAgent/tools/WebToolPack.ts
 class WebToolPack2 {
+  static pageChars = 1e4;
+  static maxResults = 10;
+  static #rememberedPages = 16;
   #options;
+  #pages = new Map;
   constructor(options) {
     this.#options = options;
   }
@@ -1438,7 +1548,7 @@ class WebToolPack2 {
     const names = [];
     if (this.#options.profile.tools.web.fetch)
       names.push("web_fetch");
-    if (this.#options.profile.tools.web.search && WebToolPack2.#provider())
+    if (this.#options.profile.tools.web.search && this.#searcher())
       names.push("web_search");
     return names;
   }
@@ -1450,58 +1560,124 @@ class WebToolPack2 {
   #register(pi) {
     if (this.#options.profile.tools.web.fetch)
       this.#registerFetch(pi);
-    const provider = WebToolPack2.#provider();
-    if (this.#options.profile.tools.web.search && provider)
-      this.#registerSearch(pi, provider);
+    const searcher = this.#searcher();
+    if (this.#options.profile.tools.web.search && searcher)
+      this.#registerSearch(pi, searcher);
   }
   #registerFetch(pi) {
     const allowHosts = this.#options.profile.network.allowHosts;
     pi.registerTool({
       name: "web_fetch",
       label: "Fetch",
-      description: "Fetch a URL and return its readable text. HTML is stripped to text; the result is truncated.",
+      description: `Fetch a URL and return its readable text, ${WebToolPack2.pageChars} characters at a time. A longer page ends with the offset that continues it.`,
       promptSnippet: "web_fetch: fetch a URL and return its readable text",
-      parameters: Type6.Object({ url: Type6.String({ description: "Absolute http(s) URL." }) }),
-      execute: async (_id, params) => {
+      parameters: Type6.Object({
+        url: Type6.String({ description: "Absolute http(s) URL." }),
+        offset: Type6.Optional(Type6.Number({ description: "Character offset a previous call named, to read on." }))
+      }),
+      execute: async (_id, params, signal) => {
         const refusal = WebToolPack2.#refuseHost(params.url, allowHosts);
         if (refusal)
           return { content: [{ type: "text", text: refusal }], details: undefined, isError: true };
-        const response = await fetch(params.url, { signal: AbortSignal.timeout(20000), redirect: "follow" });
-        const text = WebToolPack2.#readable(await response.text());
+        const offset = Math.max(0, Math.floor(params.offset ?? 0));
+        const cached = offset ? this.#pages.get(params.url) : undefined;
+        const page = cached ?? await this.#read(params.url, signal);
+        if (page.ok)
+          this.#remember(params.url, page);
         return {
-          content: [
-            { type: "text", text: `${response.status} ${params.url}
-
-${codeAgentClip3(text, codeAgentOutputChars3)}` }
-          ],
+          content: [{ type: "text", text: WebToolPack2.#window(params.url, page, offset) }],
           details: undefined,
-          isError: !response.ok
+          isError: !page.ok
         };
       }
     });
   }
-  #registerSearch(pi, provider) {
+  #registerSearch(pi, searcher) {
+    const hint = searcher.name === "deepseek" ? ` Keep the query within ${DeepSeekWeb.maxQueryChars} characters; site:, -site: and quoted phrases work.` : "";
     pi.registerTool({
       name: "web_search",
       label: "Search",
-      description: `Search the web (${provider.name}) and return the top results as title, url and snippet.`,
+      description: `Search the web (${searcher.name}) and return the top results as title, url and summary.${hint}`,
       promptSnippet: "web_search: search the web and return titles, urls and snippets",
       parameters: Type6.Object({
         query: Type6.String(),
-        count: Type6.Optional(Type6.Number({ description: "How many results, default 5." }))
+        count: Type6.Optional(Type6.Number({ description: `How many results, default 5, at most ${WebToolPack2.maxResults}.` }))
       }),
-      execute: async (_id, params) => {
-        const key = process.env[provider.envKey] ?? "";
-        const results = await provider.search(key, params.query, params.count ?? 5);
-        return {
-          content: [{ type: "text", text: codeAgentClip3(results || "(no results)", codeAgentOutputChars3) }],
-          details: undefined
-        };
+      execute: async (_id, params, signal) => {
+        const count = Math.min(Math.max(Math.round(params.count ?? 5), 1), WebToolPack2.maxResults);
+        try {
+          const results = await searcher.search(params.query, count, signal);
+          return {
+            content: [{ type: "text", text: codeAgentClip4(results || "(no results)", WebToolPack2.pageChars) }],
+            details: undefined
+          };
+        } catch (error) {
+          const message = error instanceof Error ? error.message : String(error);
+          return { content: [{ type: "text", text: message }], details: undefined, isError: true };
+        }
       }
     });
   }
-  static #provider() {
-    return WebToolPack2.providers.find((provider) => !!process.env[provider.envKey]);
+  #searcher() {
+    const provider = WebToolPack2.providers.find((entry) => !!process.env[entry.envKey]);
+    if (provider)
+      return {
+        name: provider.name,
+        search: (query, count) => provider.search(process.env[provider.envKey] ?? "", query, count)
+      };
+    const deepseek = this.#options.deepseek;
+    return deepseek ? { name: "deepseek", search: (query, count, signal) => deepseek.search(query, count, signal) } : undefined;
+  }
+  async#read(url, signal) {
+    const deepseek = this.#options.deepseek;
+    if (deepseek && !WebToolPack2.#isLocal(new URL(url).hostname)) {
+      try {
+        const page = await deepseek.fetch(url, signal);
+        return { status: 200, ok: true, title: page.title, text: page.content };
+      } catch (error) {
+        if (signal?.aborted)
+          throw error;
+      }
+    }
+    const response = await fetch(url, {
+      signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(20000)]) : AbortSignal.timeout(20000),
+      redirect: "follow"
+    });
+    return { status: response.status, ok: response.ok, title: "", text: WebToolPack2.#readable(await response.text()) };
+  }
+  #remember(url, page) {
+    this.#pages.delete(url);
+    this.#pages.set(url, page);
+    const oldest = this.#pages.keys().next().value;
+    if (this.#pages.size > WebToolPack2.#rememberedPages && oldest)
+      this.#pages.delete(oldest);
+  }
+  static #window(url, page, offset) {
+    const head = [`${page.status} ${url}`, page.title].filter(Boolean).join(`
+`);
+    const total = page.text.length;
+    if (offset && offset >= total)
+      return `${head}
+
+Offset ${offset} is past the end; the page has ${total} characters.`;
+    const end = Math.min(offset + WebToolPack2.pageChars, total);
+    const rest = end < total ? `
+
+[characters ${offset}\u2013${end} of ${total}; offset ${end} reads on]` : "";
+    return `${head}
+
+${page.text.slice(offset, end)}${rest}`;
+  }
+  static #isLocal(hostname) {
+    const host = hostname.replace(/^\[|\]$/g, "").toLowerCase();
+    const family = isIP(host);
+    if (family === 6)
+      return host === "::1" || /^(f[cd]|fe[89ab])/.test(host);
+    if (family === 4) {
+      const [a = 0, b = 0] = host.split(".").map(Number);
+      return a === 0 || a === 10 || a === 127 || a === 100 && b >= 64 && b <= 127 || a === 169 && b === 254 || a === 172 && b >= 16 && b <= 31 || a === 192 && b === 168;
+    }
+    return !host.includes(".") || /\.(localhost|local|internal|lan|home\.arpa)$/.test(host);
   }
   static #refuseHost(url, allowHosts) {
     let parsed;
@@ -1533,7 +1709,7 @@ class AkanCodePlugins2 {
     });
     const dispose = () => mcp?.close();
     const mcpStatus = mcp?.status ?? [];
-    const web = new WebToolPack2({ profile: options.profile });
+    const web = new WebToolPack2({ profile: options.profile, deepseek: options.deepseek });
     const sessions = new SessionToolPack2({
       workspaceRoot: options.workspace.workspaceRoot,
       cwd: options.cwd,
@@ -1668,9 +1844,9 @@ class CodeAgentAsks2 {
 
 // pkgs/@akanjs/devkit/codeAgent/agent/CodeAgentEventMapper.ts
 import {
-  codeAgentClip as codeAgentClip4,
+  codeAgentClip as codeAgentClip5,
   codeAgentLabelChars,
-  codeAgentOutputChars as codeAgentOutputChars4
+  codeAgentOutputChars as codeAgentOutputChars3
 } from "akanjs/common";
 
 // pkgs/@akanjs/devkit/codeAgent/agent/stringArg.ts
@@ -1730,7 +1906,7 @@ class CodeAgentEventMapper2 {
             type: "tool_progress",
             turnId: this.#turnId,
             toolCallId: event.toolCallId,
-            text: codeAgentClip4(CodeAgentEventMapper2.#renderToolText(event.partialResult), codeAgentLabelChars)
+            text: codeAgentClip5(CodeAgentEventMapper2.#renderToolText(event.partialResult), codeAgentLabelChars)
           }
         ];
       case "tool_execution_end":
@@ -1801,8 +1977,8 @@ class CodeAgentEventMapper2 {
       turnId: this.#turnId,
       tool,
       outcome: reason ? "blocked" : event.isError ? "error" : "ok",
-      output: codeAgentClip4(full, codeAgentOutputChars4),
-      truncated: full.length > codeAgentOutputChars4
+      output: codeAgentClip5(full, codeAgentOutputChars3),
+      truncated: full.length > codeAgentOutputChars3
     };
   }
   noteOutcome(reason) {
@@ -1831,7 +2007,7 @@ class CodeAgentEventMapper2 {
       name,
       op: toolOps[name] ?? "other",
       ...path ? { path } : {},
-      title: codeAgentClip4(`${name}${CodeAgentEventMapper2.#renderArgs(args)}`, codeAgentLabelChars)
+      title: codeAgentClip5(`${name}${CodeAgentEventMapper2.#renderArgs(args)}`, codeAgentLabelChars)
     };
   }
   #mapDelta(event) {
@@ -1858,7 +2034,7 @@ class CodeAgentEventMapper2 {
     if (!entries.length)
       return "";
     const rendered = entries.map(([key, value]) => `${key}=${CodeAgentEventMapper2.#renderArgValue(value)}`).join(" ");
-    return `(${codeAgentClip4(rendered, 120)})`;
+    return `(${codeAgentClip5(rendered, 120)})`;
   }
   static #renderArgValue(value) {
     if (Array.isArray(value))
@@ -1867,7 +2043,7 @@ class CodeAgentEventMapper2 {
       const keys = Object.keys(value).length;
       return `{${keys} key${keys === 1 ? "" : "s"}}`;
     }
-    return codeAgentClip4(String(value), 60);
+    return codeAgentClip5(String(value), 60);
   }
   static #renderContent(content) {
     if (typeof content === "string")
@@ -2308,6 +2484,7 @@ class CodeAgent2 {
   #replay = [];
   #replayFrom = 0;
   #lastContextTokens;
+  #autoCompactAt;
   constructor(profile) {
     this.#profile = profile;
     this.#gate = new CodeAgentGate2(profile);
@@ -2316,8 +2493,10 @@ 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 proxy = CodeAgentProxy.fromEnv(options.profile);
+    const modelRuntime = await AkanCodeServices2.runtime(workspaceRoot, proxy);
     const model = await akanCodeModel2(modelRuntime, options.model);
     const compaction = settingsManager.getCompactionSettings(model);
     const modelWarnings = akanCodeModelWarnings2(model, compaction.reserveTokens + compaction.keepRecentTokens);
@@ -2327,6 +2506,7 @@ class CodeAgent2 {
       profile: options.profile,
       apps: options.apps ?? [],
       canSeeImages: akanCodeModelSupportsImages2(model),
+      deepseek: await DeepSeekWeb.fromRuntime(modelRuntime, !!proxy),
       depth: options.depth ?? 0,
       ...options.subagentSpend ? { subagentSpend: options.subagentSpend } : {},
       currentSessionId: () => agent.sessionId,
@@ -2365,10 +2545,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 +2614,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 +2763,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();
   }
@@ -2689,7 +2901,7 @@ Continue the task.`);
       approvalId,
       toolCallId,
       name,
-      summary: codeAgentClip5(summary, codeAgentLabelChars2),
+      summary: codeAgentClip6(summary, codeAgentLabelChars2),
       policy: this.#profile.approval
     };
     this.#emit({ type: "approval", request });

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-dye8pnxx.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-n3tzjm91.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.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-130bdmhe.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.13",
   "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.13",
     "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>`.