sakuracode 0.1.0 → 0.1.1

package/README.md

@@ -135,6 +135,7 @@ sakuracode providers                # providers and whether their key is set (ne
 |---|---|---|
 | Enter | send | **steer**: delivered before the agent's next model request |
 | Tab | complete a slash command | **queue**: handled when the agent would stop |
+| Shift-Tab | switch the review mode: auto, strict, read-only (`full-access` only with `/permissions`) | applied when the run ends |
 | Esc | close the popup | **cancel** the run |
 | Ctrl-C | clear the prompt; twice on an empty prompt leaves | cancel the run |
 | Ctrl-D | leave (empty prompt) | |

package/README.zh-CN.md

@@ -135,6 +135,7 @@ sakuracode providers                # 服务商以及它们的密钥是否已设
 |---|---|---|
 | Enter | 发送 | **引导**：在 Agent 的下一个模型请求之前送达 |
 | Tab | 补全斜杠命令 | **排队**：Agent 要停下时处理 |
+| Shift-Tab | 切换审查模式：auto、strict、read-only（`full-access` 只能用 `/permissions` 设置） | 运行结束后生效 |
 | Esc | 关闭弹出列表 | **取消**这次运行 |
 | Ctrl-C | 清空提示；在空提示上按两次退出 | 取消这次运行 |
 | Ctrl-D | 退出（提示为空时） | |

package/dist/code/src/context-estimate.js

@@ -0,0 +1,44 @@
+function messageCharacters(message) {
+    let characters = 0;
+    for (const part of message.content) {
+        if (part.type === "text")
+            characters += part.text.length;
+        else if (part.type === "tool_call")
+            characters += part.name.length + JSON.stringify(part.args ?? "").length;
+        else if (part.type === "image")
+            characters += 4000;
+        else
+            characters += JSON.stringify(part.data ?? "").length;
+    }
+    return characters;
+}
+/** Tokens of the log from the compaction on: the summary, the kept messages and everything after. */
+export function estimateAfterCompaction(branch) {
+    const compaction = branch.findLastIndex((entry) => entry.type === "compaction");
+    const entry = branch[compaction];
+    if (!entry || entry.type !== "compaction")
+        return undefined;
+    const kept = branch.findIndex((candidate) => candidate.id === entry.firstKeptEntryId);
+    const from = kept === -1 ? compaction + 1 : kept;
+    let characters = entry.summary.length;
+    for (let index = from; index < branch.length; index++) {
+        const candidate = branch[index];
+        if (candidate?.type === "message")
+            characters += messageCharacters(candidate.message);
+        else if (candidate?.type === "custom_message")
+            characters += candidate.content.reduce((sum, part) => sum + (part.type === "text" ? part.text.length : 0), 0);
+    }
+    return Math.ceil(characters / 4);
+}
+export async function measureContext(source) {
+    const status = await source.context();
+    const branch = await source.log.branch();
+    const compaction = branch.findLastIndex((entry) => entry.type === "compaction");
+    if (compaction === -1)
+        return { tokens: status.tokens, window: status.window, estimated: false };
+    const replied = branch.slice(compaction + 1).some((entry) => entry.type === "message" && entry.message.role === "assistant" && entry.message.usage !== undefined);
+    if (replied)
+        return { tokens: status.tokens, window: status.window, estimated: false };
+    const tokens = estimateAfterCompaction(branch) ?? status.tokens;
+    return { tokens, window: status.window, estimated: true };
+}

package/dist/code/src/permissions.js

@@ -7,6 +7,15 @@ export const PERMISSION_PRESETS = {
     strict: { name: "strict", summary: "reviewed; three refusals in a row pause the run", review: true, tools: undefined, breakerConsecutive: 3 },
     "full-access": { name: "full-access", summary: "nothing is reviewed", review: false, tools: undefined, breakerConsecutive: undefined },
 };
+/**
+ * What Shift+Tab switches to: auto, then strict, then read-only, then auto again. `full-access` is never reached by the key
+ * (it needs the explicit `/permissions full-access`); from it the key goes back to auto.
+ */
+export function nextPermission(current) {
+    const cycle = ["auto", "strict", "read-only"];
+    const index = cycle.indexOf(current);
+    return index === -1 ? "auto" : cycle[(index + 1) % cycle.length];
+}
 export function isPermissionName(value) {
     return PERMISSION_NAMES.includes(value);
 }

package/dist/code/src/reports.js

@@ -39,7 +39,7 @@ export function statusReport(input) {
         ["Model", `${input.model} via ${input.provider}${input.thinking ? `, thinking ${input.thinking}` : ""}`],
         ["Permissions", `${input.permissions}: ${PERMISSION_PRESETS[input.permissions].summary}`],
         ["Redaction", input.redaction ? "on" : "off"],
-        ["Context", `${number(input.context.tokens)} of ${number(input.context.window)} tokens used, ${free}% left${input.context.compactAt ? `, compacts at ${number(input.context.compactAt)}` : ""}`],
+        ["Context", `${input.contextEstimated ? "about " : ""}${number(input.context.tokens)} of ${number(input.context.window)} tokens used${input.contextEstimated ? " (estimate until the next reply)" : ""}, ${input.contextEstimated ? "~" : ""}${free}% left${input.context.compactAt ? `, compacts at ${number(input.context.compactAt)}` : ""}`],
         ...usageRows(input),
         ["Goal", input.goal ? `${input.goal.status}: ${input.goal.objective}` : "none"],
         ["Idle compaction", input.idleCompaction],

package/dist/code/src/session-controller.js

@@ -3,13 +3,14 @@
 // through the Transcript (what to show) and the Surface (what only a screen can do).
 import { openAgentSession } from "./agent-session.js";
 import { expandMentions } from "./mentions.js";
-import { isPermissionName } from "./permissions.js";
+import { isPermissionName, nextPermission } from "./permissions.js";
 import { allProviders, chooseProvider, listProviders } from "./providers.js";
 import { mcpReport, medianReplyHitRate, modelsReport, permissionsReport, statusReport } from "./reports.js";
 import { createRunDriver } from "./run-driver.js";
 import { sessionLabel, titleFromPrompt } from "./session-store.js";
 import { runShell } from "./shell.js";
 import { findCommand, helpMarkdown, parseSlash } from "./slash-commands.js";
+import { measureContext } from "./context-estimate.js";
 import { contextLeftPercent } from "./status-line.js";
 import { excerpt, replayLog } from "./transcript.js";
 import { imageMediaType } from "./images.js";
@@ -26,6 +27,13 @@ export function createController(deps) {
     let session;
     let meta;
     let contextPercent;
+    // a mode asked for during a run; the agent is not reopened while it works
+    let pendingPermissions;
+    let contextEstimated = false;
+    let contextEstimatedShown = false;
+    let contextWindow = 0;
+    // a newer measurement wins over an older one that finishes later
+    let contextVersion = 0;
     const firstImages = [...(deps.images ?? [])];
     let choice = {
         provider: deps.clients ? "scripted" : chooseProvider(deps.settings, deps.env),
@@ -35,6 +43,18 @@ export function createController(deps) {
         thinking: deps.settings.thinking,
     };
     driver.onChange(() => surface.changed());
+    // The percentage follows the run: each finished reply carries the provider-reported usage, and a compaction changes the size at once.
+    driver.onEvent((event) => {
+        if (event.type === "message_end" && event.message.role === "assistant" && event.message.usage && contextWindow > 0) {
+            const { input, output, cacheRead, cacheWrite } = event.message.usage;
+            contextVersion++;
+            contextEstimated = false;
+            setContextPercent(contextLeftPercent(contextWindow - (input + output + cacheRead + cacheWrite), contextWindow));
+        }
+        else if (event.type === "compaction") {
+            void refreshContext().catch(() => undefined);
+        }
+    });
     const notice = (level, text) => transcript.add({ kind: "notice", level, text });
     const requireSession = () => {
         if (!session)
@@ -105,11 +125,29 @@ export function createController(deps) {
         replayLog(transcript, entries);
         notice("info", `Resumed ${sessionLabel(meta ?? target)} (${target.id.slice(0, 8)}).`);
     }
+    async function statusContext(active) {
+        const status = await active.agent.context();
+        const measured = await measureContext(active.agent);
+        return { context: { ...status, tokens: measured.tokens, free: Math.max(0, measured.window - measured.tokens) }, contextEstimated: measured.estimated };
+    }
+    function setContextPercent(next) {
+        const flagChanged = contextEstimatedShown !== contextEstimated;
+        contextEstimatedShown = contextEstimated;
+        if (next === contextPercent && !flagChanged)
+            return;
+        contextPercent = next;
+        surface.changed();
+    }
     async function refreshContext() {
         if (!session)
             return;
-        const status = await session.agent.context();
-        contextPercent = contextLeftPercent(status.free, status.window);
+        const version = ++contextVersion;
+        const measured = await measureContext(session.agent);
+        if (version !== contextVersion)
+            return;
+        contextWindow = measured.window;
+        contextEstimated = measured.estimated;
+        setContextPercent(contextLeftPercent(measured.window - measured.tokens, measured.window));
     }
     // ---------- running ----------
     async function runInput(input, options) {
@@ -127,8 +165,18 @@ export function createController(deps) {
         }
         if (meta)
             meta = await store.update(meta.id, {});
+        await applyPendingPermissions();
         return outcome.result;
     }
+    async function applyPendingPermissions() {
+        const wanted = pendingPermissions;
+        pendingPermissions = undefined;
+        if (wanted === undefined || wanted === choice.permissions)
+            return surface.changed();
+        if (await reopen({ permissions: wanted }))
+            notice("info", `Permissions: ${wanted} (Shift+Tab to change)`);
+        surface.changed();
+    }
     function reportEnd(result) {
         if (result.reason === "error")
             notice("error", `The run failed: ${result.error ?? "unknown error"}`);
@@ -179,7 +227,7 @@ export function createController(deps) {
                 thinking: active.thinking,
                 permissions: active.permissions,
                 redaction: active.redaction,
-                context: await active.agent.context(),
+                ...(await statusContext(active)),
                 usage: await active.agent.usage(),
                 medianHitRate: medianReplyHitRate(await active.agent.log.branch()),
                 goal: await active.agent.goal(),
@@ -201,6 +249,7 @@ export function createController(deps) {
                 return host.print(permissionsReport(choice.permissions, choice.redaction));
             if (!isPermissionName(name))
                 return notice("error", `Unknown preset "${name}". Use auto, read-only, strict or full-access.`);
+            pendingPermissions = undefined;
             if (await reopen({ permissions: name }))
                 notice("info", `Permissions: ${name}.`);
         },
@@ -379,10 +428,22 @@ export function createController(deps) {
                 transcript.muteCompaction(false);
                 stop();
             }
-            const after = (await requireSession().agent.context()).tokens;
+            const after = (await measureContext(requireSession().agent)).tokens;
             notice("info", `compacted after ${idleMinutes} min idle, ${thousands(before)} to ${thousands(after)} tokens`);
             return true;
         },
+        async cyclePermissions() {
+            const next = nextPermission(pendingPermissions ?? choice.permissions);
+            if (driver.working || launching) {
+                pendingPermissions = next === choice.permissions ? undefined : next;
+                return surface.changed();
+            }
+            if (!session)
+                return;
+            if (await reopen({ permissions: next }))
+                notice("info", `Permissions: ${next} (Shift+Tab to change)`);
+            surface.changed();
+        },
         statusInfo: () => ({
             provider: choice.provider,
             model: choice.model ?? "",
@@ -390,7 +451,9 @@ export function createController(deps) {
             cwd: deps.cwd,
             home: deps.home,
             contextLeftPercent: contextPercent,
+            contextEstimated: contextEstimatedShown,
             permissions: choice.permissions,
+            pendingPermissions,
             redaction: choice.redaction,
             working: driver.working,
             queued: driver.pending().length,

package/dist/code/src/slash-commands.js

@@ -79,5 +79,5 @@ export function complete(input) {
 }
 export function helpMarkdown() {
     const rows = COMMANDS.map((command) => `| \`${command.usage}\` | ${command.summary} |`);
-    return ["| Command | What it does |", "|---|---|", ...rows, "", "While the agent works: **Enter** steers it, **Tab** queues a message, **Esc** cancels. `!cmd` runs a shell command yourself."].join("\n");
+    return ["| Command | What it does |", "|---|---|", ...rows, "", "While the agent works: **Enter** steers it, **Tab** queues a message, **Esc** cancels. **Shift+Tab** cycles the review mode (auto, strict, read-only; `/permissions full-access` is explicit). `!cmd` runs a shell command yourself."].join("\n");
 }

package/dist/code/src/status-line.js

@@ -11,12 +11,21 @@ export function shortenPath(path, home, width) {
 export function contextLeftPercent(free, window) {
     return window <= 0 ? 0 : Math.max(0, Math.min(100, Math.round((free / window) * 100)));
 }
+function contextText(info, pal) {
+    const text = `${info.contextEstimated ? "~" : ""}${info.contextLeftPercent}%`;
+    return (info.contextLeftPercent ?? 100) < 15 ? pal.red(text) : text;
+}
+function permissionsPiece(info, pal) {
+    const mode = info.pendingPermissions ?? info.permissions;
+    const paint = mode === "auto" ? pal.dim : mode === "full-access" ? pal.red : pal.yellow;
+    return info.pendingPermissions === undefined ? paint(mode) : paint(mode) + pal.dim(" (next turn)");
+}
 export function formatStatusLine(info, width, color) {
     const pal = createPalette(color);
     const pieces = [
         pal.bold(info.model) + (info.thinking ? pal.dim(` ${info.thinking}`) : ""),
-        info.contextLeftPercent === undefined ? "" : `${info.contextLeftPercent < 15 ? pal.red(`${info.contextLeftPercent}%`) : `${info.contextLeftPercent}%`} context left`,
-        info.permissions === "auto" ? "" : pal.yellow(info.permissions),
+        info.contextLeftPercent === undefined ? "" : `${contextText(info, pal)} context left`,
+        permissionsPiece(info, pal),
         info.redaction ? pal.magenta("redaction") : "",
         info.queued > 0 ? pal.cyan(`${info.queued} queued`) : "",
         shortenPath(info.cwd, info.home, Math.max(12, Math.floor(width / 3))),

package/dist/code/src/tui/app.js

@@ -163,6 +163,12 @@ export async function runTui(options) {
         // a dropped or pasted image file becomes an @mention, which attaches it
         const dropped = key.name === "paste" ? pastedImagePath(key.text ?? "", options.controller.cwd) : undefined;
         const action = editor.handle(dropped ? { name: "paste", text: `@${dropped} ` } : key);
+        if (action === "shift-tab") {
+            // the command popup uses Tab; Shift+Tab never changes the mode while it is open
+            if (commands.length === 0)
+                void controller.cyclePermissions().catch((error) => showHint(error.message));
+            return;
+        }
         if (action !== "none")
             popupIndex = action === "tab" ? popupIndex : 0;
         if (action === "submit")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sakuracode",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "license": "MIT",
   "type": "module",
   "description": "sakuracode: an open-source terminal coding agent (command-line AI coding assistant) with automatic review of every tool call. Works with DeepSeek, OpenCode Go and any OpenAI-compatible endpoint.",