maka-agent 0.2.0-dev.23.20260906 → 0.2.0-dev.25.20260908

package/README.md

@@ -24,7 +24,8 @@
 [简体中文](https://github.com/apache/maka/blob/main/packages/cli/README.zh-CN.md)
 
 Maka is a local-first agent workspace. The `maka-agent` npm package installs the interactive
-terminal UI, the non-interactive CLI, Runtime Host tooling, and the Eval command.
+terminal UI, the non-interactive CLI, Runtime Host tooling, and the Eval command. That package is
+published under the `nightly` dist-tag; `latest` holds an early alpha stub (see [Install](#install)).
 
 ## Apache Incubation Disclaimer
 
@@ -79,16 +80,24 @@ release gate. Real Eval executor validation currently runs on Linux x64 with Nod
 
 ## Install
 
-Install the current beta explicitly from the `next` dist-tag:
+Two dist-tags are live on npm, and they are not interchangeable:
 
-```sh
-npm install --global maka-agent@next
-maka --version
-maka --help
-```
+- `nightly` carries the complete CLI. The line moves daily — resolve the tag (or query its
+  current version) instead of copying a version number from any document:
+
+  ```sh
+  npm install --global maka-agent@nightly
+  maka --version
+  maka --help
+  ```
+
+- `latest` points at an early alpha (`0.0.0-alpha.0`) whose command surface is limited to
+  `doctor`, help, and version. Because of that split, do not use a bare
+  `npm update --global maka-agent`: it follows `latest` and may switch the installation to the
+  other release line.
 
 The public command is `maka`. For a one-off invocation, use
-`npx --yes --package maka-agent@next maka`; the unrelated `maka` package on npm is not this project.
+`npx --yes --package maka-agent@nightly maka`; the unrelated `maka` package on npm is not this project.
 `runtime-host service install` uses the persistent global installation above; `runtime-host setup`
 creates its own managed copy from the exact package invoked by `npx`.
 
@@ -124,26 +133,31 @@ modify.
 
 ## Upgrade
 
-While using prereleases, keep the `next` tag explicit:
+Update within the nightly line by pinning the exact release (`--target` accepts `latest`,
+`next`, or an exact Maka version — there is no `nightly` channel name). Resolve the current
+nightly version first and pass that exact value: the updater refuses downgrades, so a copied
+version number goes stale as soon as the nightly line moves on.
 
 ```sh
-maka update --target next
+version="$(npm view maka-agent@nightly version --registry=https://registry.npmjs.org)"
+maka update --target "$version"
 maka --version
 ```
 
+Do not use a bare `npm update --global maka-agent` to upgrade: it follows `latest`, which holds
+the early alpha stub, and may switch the installation to the other release line.
+
 The update stages and verifies the exact release before replacing the local Runtime Host or the
 npm-global package. It refuses to interrupt active or durable work by default. Use
 `--allow-interrupt-active-tasks` only after deciding that interruption is safe. A direct
-`npm install --global maka-agent@next` remains available for installation repair; do not use a bare
-`npm update --global maka-agent`, because it follows `latest` and may select a different release
-line. After a stable release is available, select it with `maka update --target latest`.
+`npm install --global maka-agent@nightly` remains available for installation repair.
 
 ## Remote Runtime Host setup
 
 To set up a persistent remote Runtime Host from an exact released package on Linux or macOS:
 
 ```sh
-npx --yes --package maka-agent@next maka runtime-host setup \
+npx --yes --package maka-agent@nightly maka runtime-host setup \
   --principal my-client \
   --preset terminal-client
 ```
@@ -151,10 +165,12 @@ npx --yes --package maka-agent@next maka runtime-host setup \
 Rerunning setup replaces that Client credential. The service no longer depends on the temporary
 `npx` cache after setup succeeds.
 
-Check a managed service against a release channel without changing the running Host:
+Check a managed service against the nightly release it should track, without changing the
+running Host — pass the exact version resolved above rather than `latest`, which holds the
+early alpha:
 
 ```sh
-maka runtime-host service check-update --target next --json
+maka runtime-host service check-update --target "$version" --json
 ```
 
 The result pins the selected channel to an exact version and package integrity. It also reports
@@ -165,10 +181,13 @@ to the existing exact-package update transaction, and does not mutate a candidat
 manual review.
 
 The installation owner can persist one update target and reconcile it with the same verified
-transaction:
+transaction. Pin the exact nightly version resolved above: there is no `nightly` target name,
+and `latest` holds the early alpha, which the reconciliation assesses as a downgrade for a
+nightly installation. Following successive nightlies therefore means resolving the current
+version again and re-running `update-policy` with the fresh value:
 
 ```sh
-maka runtime-host service update-policy --target latest \
+maka runtime-host service update-policy --target "$version" \
   --expected-service-id <service-id> \
   --expected-root-path <state-root> \
   --expected-root-id <root-id>
@@ -182,7 +201,7 @@ bounded one-shot command: it never interrupts active work and does not install a
 
 ```sh
 # When a managed Runtime Host service was installed on Linux or macOS
-npx --yes --package maka-agent@next maka runtime-host service uninstall
+npx --yes --package maka-agent@nightly maka runtime-host service uninstall
 
 # If Maka was installed globally
 npm uninstall --global maka-agent

package/README.zh-CN.md

@@ -24,7 +24,8 @@
 [English](./README.md)
 
 Maka 是一个本地优先的 Agent 工作空间。`maka-agent` npm 包包含交互式终端界面、非交互
-CLI、Runtime Host 工具和 Eval 命令。
+CLI、Runtime Host 工具和 Eval 命令。该包发布在 `nightly` dist-tag 上；`latest` 指向一个
+早期 alpha stub（见[安装](#安装)）。
 
 ## Apache 孵化免责声明
 
@@ -57,15 +58,21 @@ release commit 中的 [DISCLAIMER-WIP](https://github.com/apache/maka/blob/main/
 
 ## 安装
 
-Beta 阶段请明确从 `next` dist-tag 安装：
+npm 上有两条 dist-tag，且二者不可互换：
 
-```sh
-npm install --global maka-agent@next
-maka --version
-maka --help
-```
+- `nightly` 承载完整的 CLI。该发布线每日推进——请解析 tag 本身（或查询其当前版本），不要誊写任何文档里的版本号：
 
-公开命令只有 `maka`。一次性运行请使用 `npx --yes --package maka-agent@next maka`；npm 上与本项目
+  ```sh
+  npm install --global maka-agent@nightly
+  maka --version
+  maka --help
+  ```
+
+- `latest` 指向一个早期 alpha（`0.0.0-alpha.0`），命令面只有 `doctor`、帮助与版本命令。
+  因此不要使用裸的 `npm update --global maka-agent`：它跟随 `latest`，可能把安装切换到
+  另一条发布线。
+
+公开命令只有 `maka`。一次性运行请使用 `npx --yes --package maka-agent@nightly maka`；npm 上与本项目
 无关的 `maka` 包不是本项目。`runtime-host service install` 使用上面的持久全局安装；
 `runtime-host setup` 会从 `npx` 调用的精确 package 创建自己的托管副本。
 
@@ -98,35 +105,40 @@ Maka 默认会在执行高权限工具操作前询问。`maka run --yolo` 会授
 
 ## 升级
 
-使用预发布版本时，请继续明确指定 `next`：
+在 nightly 线内更新时固定精确版本（`--target` 只接受 `latest`、`next` 或精确的 Maka
+版本号——不存在 `nightly` 这个 channel 名）。先解析当前 nightly 版本再传入精确值：
+updater 拒绝降级，nightly 前进之后誊写的旧版本号会被直接拒绝。
 
 ```sh
-maka update --target next
+version="$(npm view maka-agent@nightly version --registry=https://registry.npmjs.org)"
+maka update --target "$version"
 maka --version
 ```
 
+不要使用裸的 `npm update --global maka-agent` 来升级：它跟随 `latest`（早期 alpha stub），
+可能把安装切换到另一条发布线。
+
 更新流程会先 stage 并验证精确 release，再替换本地 Runtime Host 与 npm-global package；
 默认不会中断 active 或 durable work。只有在你确认可以安全中断后，才使用
-`--allow-interrupt-active-tasks`。`npm install --global maka-agent@next` 仍可用于修复安装；
-不要使用不带 tag 的 `npm update --global maka-agent`，因为它会跟随 `latest`，可能选中
-不同的发布线。稳定版发布后，使用 `maka update --target latest`。
+`--allow-interrupt-active-tasks`。`npm install --global maka-agent@nightly` 仍可用于修复安装。
 
 ## 设置远程 Runtime Host
 
 在 Linux 或 macOS 上从精确的发布 package 设置持久 remote Runtime Host：
 
 ```sh
-npx --yes --package maka-agent@next maka runtime-host setup \
+npx --yes --package maka-agent@nightly maka runtime-host setup \
   --principal my-client \
   --preset terminal-client
 ```
 
 重复设置会替换该 Client credential。设置成功后，service 不再依赖临时 `npx` cache。
 
-可以在不改变当前 Host 的情况下检查 managed service 对应的发布频道：
+检查 managed service 应跟随的 nightly 发布，且不改变当前运行中的 Host——传入上面解析出的
+精确版本，而不是指向早期 alpha 的 `latest`：
 
 ```sh
-maka runtime-host service check-update --target next --json
+maka runtime-host service check-update --target "$version" --json
 ```
 
 结果会把频道固定为精确版本和 package integrity，并说明 package 是否提供足够的兼容性证据，
@@ -134,10 +146,13 @@ maka runtime-host service check-update --target next --json
 selector 传给 `service update --target`。该路径会先校验 archive 与解包后的 manifest，再委托给
 现有的精确 package 更新事务；需要人工审查的候选不会改变当前 Host。
 
-Installation owner 可以持久化一个更新目标，并通过同一套已验证事务执行 reconciliation：
+Installation owner 可以持久化一个更新目标，并通过同一套已验证事务执行 reconciliation。持久化
+上面解析出的精确 nightly 版本：不存在 `nightly` 这个 target 名，而 `latest` 指向早期 alpha，
+reconciliation 会把对一个 nightly 安装而言更旧的候选判为降级。因此要跟随每日推进的 nightly，
+就需要重新解析当前版本，并用新值再次运行 `update-policy`：
 
 ```sh
-maka runtime-host service update-policy --target latest \
+maka runtime-host service update-policy --target "$version" \
   --expected-service-id <service-id> \
   --expected-root-path <state-root> \
   --expected-root-id <root-id>
@@ -151,7 +166,7 @@ maka runtime-host service reconcile-update --json
 
 ```sh
 # 仅限安装过 managed Runtime Host service 的 Linux 或 macOS
-npx --yes --package maka-agent@next maka runtime-host service uninstall
+npx --yes --package maka-agent@nightly maka runtime-host service uninstall
 
 # 如果曾全局安装 Maka
 npm uninstall --global maka-agent

package/dist/acp/maka-acp-agent.js

@@ -26,5 +26,6 @@ export function createMakaAcpAgent(options) {
         agentInfo: { name: 'maka', title: 'Maka', version: options.version },
     }))
         .onRequest(methods.agent.session.new, ({ params }) => options.sessionRegistry.create(params))
-        .onRequest(methods.agent.session.list, ({ params }) => options.sessionRegistry.list(params));
+        .onRequest(methods.agent.session.list, ({ params }) => options.sessionRegistry.list(params))
+        .onRequest(methods.agent.session.setConfigOption, ({ params }) => options.sessionRegistry.setConfigOption(params));
 }

package/dist/acp/session-configuration.js

@@ -0,0 +1,143 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { COLLABORATION_MODES } from '@maka/core/collaboration';
+import { THINKING_LEVELS } from '@maka/core/model-thinking';
+import { ORCHESTRATION_MODES } from '@maka/core/orchestration';
+import { CHAT_DEFAULT_PERMISSION_MODES } from '@maka/core/settings';
+const PERMISSION_NAMES = {
+    explore: 'Explore',
+    ask: 'Ask',
+    bypass: 'Bypass',
+};
+const THINKING_NAMES = {
+    default: 'Default',
+    off: 'Off',
+    minimal: 'Minimal',
+    low: 'Low',
+    medium: 'Medium',
+    high: 'High',
+    xhigh: 'Extra high',
+    max: 'Max',
+};
+const COLLABORATION_NAMES = {
+    agent: 'Agent',
+    plan: 'Plan',
+};
+const ORCHESTRATION_NAMES = {
+    default: 'Default',
+    swarm: 'Swarm',
+    graph: 'Graph',
+};
+const PERMISSION_SPEC = {
+    id: 'permission_mode',
+    name: 'Permission mode',
+    category: '_maka/permission_mode',
+    options: namedOptions(CHAT_DEFAULT_PERMISSION_MODES, PERMISSION_NAMES),
+};
+const THINKING_SPEC = {
+    id: 'thinking_level',
+    name: 'Thinking level',
+    category: 'thought_level',
+    options: namedOptions(['default', ...THINKING_LEVELS], THINKING_NAMES),
+};
+const COLLABORATION_SPEC = {
+    id: 'collaboration_mode',
+    name: 'Collaboration mode',
+    category: 'mode',
+    options: namedOptions(COLLABORATION_MODES, COLLABORATION_NAMES),
+};
+const ORCHESTRATION_SPEC = {
+    id: 'orchestration_mode',
+    name: 'Orchestration mode',
+    category: '_maka/orchestration_mode',
+    options: namedOptions(ORCHESTRATION_MODES, ORCHESTRATION_NAMES),
+};
+const CONFIG_SPECS = [
+    PERMISSION_SPEC,
+    THINKING_SPEC,
+    COLLABORATION_SPEC,
+    ORCHESTRATION_SPEC,
+];
+export function projectAcpSessionConfigOptions(session, thinkingLevels) {
+    return [
+        configOption(PERMISSION_SPEC, session.permissionMode),
+        ...(thinkingLevels.length === 0
+            ? []
+            : [
+                configOption({
+                    ...THINKING_SPEC,
+                    options: namedOptions(['default', ...thinkingLevels], THINKING_NAMES),
+                }, session.thinkingLevel ?? 'default'),
+            ]),
+        configOption(COLLABORATION_SPEC, session.collaborationMode),
+        configOption(ORCHESTRATION_SPEC, session.orchestrationMode),
+    ];
+}
+function namedOptions(values, names) {
+    return values.map((value) => [value, names[value]]);
+}
+function configOption(spec, currentValue) {
+    return {
+        type: 'select',
+        id: spec.id,
+        name: spec.name,
+        category: spec.category,
+        currentValue,
+        options: spec.options.map(([value, name]) => ({ value, name })),
+    };
+}
+export class AcpSessionConfigInputError extends Error {
+    field;
+    reason;
+    name = 'AcpSessionConfigInputError';
+    constructor(field, reason) {
+        super(`Invalid ACP Session configuration ${field}`);
+        this.field = field;
+        this.reason = reason;
+    }
+}
+export function validateAcpSessionConfigOptionRequest(request) {
+    const spec = CONFIG_SPECS.find(({ id }) => id === request.configId);
+    if (!spec)
+        throw new AcpSessionConfigInputError('configId', 'unsupported');
+    if (typeof request.value !== 'string')
+        throw new AcpSessionConfigInputError('value', 'invalid_type');
+    if (!spec.options.some(([value]) => value === request.value)) {
+        throw new AcpSessionConfigInputError('value', 'unsupported');
+    }
+}
+export function createAcpSessionConfigPatch(request) {
+    validateAcpSessionConfigOptionRequest(request);
+    switch (request.configId) {
+        case 'permission_mode':
+            return { permissionMode: request.value };
+        case 'thinking_level':
+            return {
+                thinkingLevel: request.value === 'default'
+                    ? null
+                    : request.value,
+            };
+        case 'collaboration_mode':
+            return { collaborationMode: request.value };
+        case 'orchestration_mode':
+            return { orchestrationMode: request.value };
+        default:
+            throw new AcpSessionConfigInputError('configId', 'unsupported');
+    }
+}

package/dist/acp/session-registry.js

@@ -20,14 +20,17 @@ import { randomUUID } from 'node:crypto';
 import { realpath } from 'node:fs/promises';
 import { isAbsolute, normalize } from 'node:path';
 import { RequestError, } from '@agentclientprotocol/sdk';
-import { readRuntimeHostSessionCatalogPage, RuntimeHostCatalogReadError, RuntimeHostOperationError, RuntimeHostRequestInterruptedError, RuntimeHostSessionCatalogRevisionChangedError, } from '@maka/runtime-host/client';
+import { readRuntimeHostConnectionCatalog, readRuntimeHostSessionCatalogPage, RuntimeHostCatalogReadError, RuntimeHostOperationError, RuntimeHostRequestInterruptedError, RuntimeHostSessionCatalogRevisionChangedError, } from '@maka/runtime-host/client';
 import { SESSION_CATALOG_CURSOR_MAX_BYTES, SESSION_CATALOG_CWD_MAX_BYTES, } from '@maka/runtime-host/protocol';
+import { RuntimeHostSessionUpdateError, requireRuntimeHostSessionProjection, updateRuntimeHostSession, } from '../runtime-host-session-update.js';
+import { AcpSessionConfigInputError, createAcpSessionConfigPatch, projectAcpSessionConfigOptions, validateAcpSessionConfigOptionRequest, } from './session-configuration.js';
 const ACP_SESSION_CURSOR_MAX_BYTES = 8 * 1024;
 /** Owns all Runtime Host resources associated with one ACP connection. */
 export class AcpSessionRegistry {
     #connect;
     #newSessionId;
     #inFlightOperations = new Set();
+    #ownedSessionIds = new Set();
     #connection;
     #connectTask;
     #connectAbortController;
@@ -47,6 +50,19 @@ export class AcpSessionRegistry {
         this.#assertOpen('session.catalog.query');
         return this.#track(this.#list(params));
     }
+    async setConfigOption(params) {
+        this.#assertOpen('session.configuration.update');
+        if (!this.#ownedSessionIds.has(params.sessionId)) {
+            throw RequestError.invalidParams({ reason: 'unknown_session' }, 'Session is not owned by this ACP connection');
+        }
+        try {
+            validateAcpSessionConfigOptionRequest(params);
+        }
+        catch (error) {
+            throw requestErrorFromConfigInput(error);
+        }
+        return this.#track(this.#setConfigOption(params));
+    }
     dispose() {
         this.#closing = true;
         this.#connectAbortController?.abort();
@@ -56,8 +72,9 @@ export class AcpSessionRegistry {
     async #create(params) {
         const connection = await this.#getConnection('session.create');
         const sessionId = this.#newSessionId();
+        let result;
         try {
-            await connection.request('session.create', {
+            result = await connection.request('session.create', {
                 sessionId,
                 workspace: { kind: 'host_path', path: params.cwd },
                 modelTarget: { kind: 'default' },
@@ -66,7 +83,46 @@ export class AcpSessionRegistry {
         catch (error) {
             throw requestErrorFromRuntimeHost(error, 'session.create', { sessionId });
         }
-        return { sessionId };
+        let created;
+        try {
+            created = requireRuntimeHostSessionProjection(result, 'session.create');
+        }
+        catch (error) {
+            throw requestErrorFromSessionUpdate(error, 'session.create', { sessionId });
+        }
+        const configOptions = await this.#projectConfigOptions(connection, created);
+        this.#ownedSessionIds.add(sessionId);
+        return { sessionId, configOptions };
+    }
+    async #setConfigOption(params) {
+        const connection = await this.#getConnection('session.configuration.update');
+        let committed;
+        try {
+            committed = await updateRuntimeHostSession(connection, params.sessionId, (current) => connection.request('session.configuration.update', {
+                sessionId: params.sessionId,
+                expectedRevision: current.revision,
+                patch: createAcpSessionConfigPatch(params),
+            }), {
+                operation: 'session.configuration.update',
+                assertRequestAllowed: () => this.#assertOpen('session.configuration.update'),
+            });
+        }
+        catch (error) {
+            throw requestErrorFromSessionUpdate(error, 'session.configuration.update');
+        }
+        return { configOptions: await this.#projectConfigOptions(connection, committed) };
+    }
+    async #projectConfigOptions(connection, session) {
+        let catalog;
+        try {
+            catalog = await readRuntimeHostConnectionCatalog(connection);
+        }
+        catch (error) {
+            throw requestErrorFromRuntimeHost(error, 'connection.catalog.query');
+        }
+        const selectedConnection = catalog.connections.find(({ connectionId }) => connectionId === session.llmConnectionId);
+        const selectedModel = selectedConnection?.catalogEntries.find(({ id }) => id === session.model);
+        return projectAcpSessionConfigOptions(session, selectedModel?.thinkingLevels ?? []);
     }
     async #list(params) {
         const cursor = params.cursor == null ? undefined : decodeAcpSessionCursor(params.cursor);
@@ -110,6 +166,7 @@ export class AcpSessionRegistry {
         const connectionClose = this.#closeOwnedConnection();
         await Promise.allSettled([connectionClose]);
         await Promise.allSettled([...this.#inFlightOperations]);
+        this.#ownedSessionIds.clear();
     }
     #closeOwnedConnection() {
         const connection = this.#connection;
@@ -192,9 +249,38 @@ function validateNewSessionParams(params) {
         throw RequestError.invalidParams({ field: 'additionalDirectories', reason: 'unsupported' }, 'Additional directories are not supported by this ACP adapter yet');
     }
 }
+function requestErrorFromConfigInput(error) {
+    if (error instanceof AcpSessionConfigInputError) {
+        return RequestError.invalidParams({ field: error.field, reason: error.reason }, 'Invalid Session configuration option');
+    }
+    return RequestError.internalError({
+        source: 'adapter',
+        operation: 'session.configuration.update',
+        code: 'validation_failed',
+    }, 'Session configuration validation failed');
+}
+function requestErrorFromSessionUpdate(error, operation, extra = {}) {
+    if (error instanceof RequestError)
+        return error;
+    if (!(error instanceof RuntimeHostSessionUpdateError)) {
+        return requestErrorFromRuntimeHost(error, operation, extra);
+    }
+    const common = { source: 'runtime_host', operation: error.operation, ...extra };
+    switch (error.reason) {
+        case 'not_found':
+            return RequestError.invalidParams({ ...common, code: 'not_found' }, 'Runtime Host Session was not found');
+        case 'invalid_projection':
+            return RequestError.internalError({ ...common, code: 'catalog_read_failure', reason: 'invalid_projection' }, 'Runtime Host returned an invalid Session lookup');
+        case 'unsupported_session_projection':
+            return RequestError.internalError({ ...common, code: 'unsupported_session_projection' }, 'Runtime Host Session cannot be represented in ACP');
+        case 'revision_conflict':
+            return RequestError.internalError({ ...common, code: 'revision_conflict', attempts: error.attempts }, 'Session configuration kept changing');
+    }
+}
 function requestErrorFromRuntimeHost(error, operation, extra = {}) {
     const data = { ...runtimeHostErrorData(error, operation), ...extra };
-    if (error instanceof RuntimeHostOperationError && error.code === 'invalid_request') {
+    if (error instanceof RuntimeHostOperationError &&
+        (error.code === 'invalid_request' || error.code === 'not_found')) {
         return RequestError.invalidParams(data, 'Runtime Host rejected the request');
     }
     return RequestError.internalError(data, 'Runtime Host request failed');

package/dist/cli-core.js

@@ -338,6 +338,7 @@ export async function runMakaCli(argv = process.argv.slice(2), options = RELEASE
                         : { compatibility: command.targetCompatibility }),
                 },
                 allowInterruptActiveTasks: command.allowInterruptActiveTasks,
+                ...(command.expectedSource ? { expectedSource: command.expectedSource } : {}),
             });
         }
         case 'runtime-host-local-update-activate': {
@@ -422,6 +423,7 @@ export async function runMakaCli(argv = process.argv.slice(2), options = RELEASE
                 ...(command.expectedConfigFingerprint
                     ? { expectedConfigFingerprint: command.expectedConfigFingerprint }
                     : {}),
+                ...(command.expectedHost ? { expectedHost: command.expectedHost } : {}),
                 ...(command.retainManagedDeployment ? { retainManagedDeployment: true } : {}),
                 ...(command.allowInterruptActiveTasks ? { allowInterruptActiveTasks: true } : {}),
             });

package/dist/pi-transcript-tools.js

@@ -267,6 +267,12 @@ function compactToolSummary(entry) {
         isReadBodyResult(result)) {
         return { text: linesText(readBodyLineCount(text)), protect: true };
     }
+    const status = makaPiToolPresentationStatus(entry);
+    // Error-text size is not a successful read's size. Show only the outcome,
+    // including under NO_COLOR; the full reason remains in expanded details.
+    if (status === 'error' || status === 'failed' || status === 'aborted') {
+        return { text: status === 'error' ? 'failed' : status, protect: true };
+    }
     return textResultSummary(text);
 }
 function compactTerminalSummary(content) {

package/dist/pi-transcript.js

@@ -17,7 +17,7 @@
  * under the License.
  */
 import { Markdown, visibleWidth } from '@earendil-works/pi-tui';
-import { deriveTurnRecords, STEP_LIMIT_NOTICE_TEXT, } from '@maka/core/session';
+import { deriveTurnRecords, isRuntimeSystemNoteKind, STEP_LIMIT_NOTICE_TEXT, } from '@maka/core/session';
 import { providerRetryDisplaySeconds } from '@maka/core/provider-retry-countdown';
 import { defineUiMessageCatalog, resolveUiMessageCatalog, } from '@maka/core/ui-locale';
 import { TUI_COPY_RESOURCES } from './tui-copy-catalog.js';
@@ -931,14 +931,11 @@ function tokenDelta(before, after) {
     return Math.max(0, before - after);
 }
 function systemNoteText(message) {
+    // Retired kinds are still decoded off legacy transcript rows, and none of
+    // them ever had a line here worth reading.
+    if (!isRuntimeSystemNoteKind(message.kind))
+        return undefined;
     switch (message.kind) {
-        case 'session_start':
-        case 'session_resume':
-            return undefined;
-        case 'mode_change':
-            return 'Permission mode changed.';
-        case 'model_change':
-            return 'Model changed.';
         case 'context_compacted':
             return 'Context compacted to keep this task within the model window.';
         case 'context_compaction_failed_open':
@@ -984,10 +981,6 @@ function systemNoteText(message) {
         }
         case 'step_limit':
             return STEP_LIMIT_NOTICE_TEXT;
-        case 'error':
-            return 'Session recorded an error.';
-        case 'abort':
-            return 'Session was stopped.';
     }
 }
 export function renderMakaPiTranscript(state, metadata, width) {