@tencent-ai/agent-sdk 0.3.263-dev.90f0e98.202609190050 → 0.3.263

package/cli/dist-server/types/node/references/index.d.ts

@@ -0,0 +1,2 @@
+export * from './reference-protocol';
+export * from './reference-service';

package/cli/dist-server/types/node/settings/settings-controller.d.ts

@@ -0,0 +1,23 @@
+import { Settings, SettingsManager } from './settings-protocol';
+export interface SettingsOptions {
+    global: boolean;
+}
+export interface KeyRequest {
+    key: keyof Settings;
+}
+export interface KeyValueRequest extends SettingsOptions {
+    key: keyof Settings;
+    value: any;
+}
+export interface KeyValuesRequest extends SettingsOptions {
+    key: keyof Settings;
+    values: any[];
+}
+export declare class SettingsController {
+    protected readonly settingsManager: SettingsManager;
+    set(request: KeyValueRequest): Promise<void>;
+    get(request: KeyRequest): Promise<Settings[keyof Settings]>;
+    add(request: KeyValuesRequest): Promise<void>;
+    remove(request: KeyValuesRequest): Promise<void>;
+    list(): Promise<Settings>;
+}

package/cli/dist-server/types/node/settings/settings-validate-middleware.d.ts

@@ -0,0 +1,9 @@
+import { PathResolver } from '@celljs/web';
+import { Context, Middleware, RequestMatcher } from '@celljs/web/lib/node';
+export declare class SettingsValidateMiddleWare implements Middleware {
+    protected readonly requestMatcher: RequestMatcher;
+    protected readonly pathResolver: PathResolver;
+    readonly priority: number;
+    handle(ctx: Context, next: () => Promise<void>): Promise<void>;
+    private canHandle;
+}

package/cli/dist-server/types/node/utils/compress-path.source.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 工作空间路径归一算法 —— 全仓库唯一手写真源（Single Source of Truth）。
+ *
+ * 把一条绝对 `cwd` 归一成一个可作为**单段目录名**的字符串，用于
+ * `<configDir>/projects/<name>/<conversationId>.jsonl` 的 `<name>`。
+ *
+ * ⚠️ 这段逻辑在多个隔离边界（agent-cli 独立产品 / workbuddy-core /
+ * workbuddy-server / edge-sync extension / history-migration）都要用到，且
+ * **读侧必须与写侧字节一致**，否则读端找不到写端落盘的目录。由于 agent-cli
+ * 禁止依赖 workbuddy，无法用「一个共享包被所有人 import」根治。
+ *
+ * 已知保留独立手写副本、未接入本真源的边界（≤255B 时与真源字节一致；算法变更
+ * 需人工同步，不随 CI --check 守卫）：lamp-agent-pool 服务、sandbox-proxy Go 侧。
+ *
+ * 因此本文件是**唯一手写实现**，由 `scripts/generate-compress-path.mjs` 读取本
+ * 文件、生成 `compress-path.generated.ts` 分发到各消费方（仿
+ * `services/scripts/generate-lamp-error-codes.mjs`）。CI 用 `--check` 守卫漂移。
+ *
+ * 【修改须知】改这段算法**只改本文件**，然后跑
+ * `node scripts/generate-compress-path.mjs` 重新生成所有下游副本。
+ *
+ * 【实现约束】
+ * - 纯函数、零外部依赖（只用 `Buffer`，Node/Bun 都有），可被逐字节复制到任何目标。
+ * - hash 用 djb2→base36（对 UTF-8 字节做 hash，跨 runtime/进程稳定）；
+ *   **禁止** `Bun.hash`/`crypto`（跨 runtime 结果不一致，会导致读写错位）。
+ * - 阈值 255 字节：APFS/ext4/NTFS 单段文件名上限 NAME_MAX=255B。存量 ≤255B 的
+ *   目录走原算法**零漂移**；仅超限时才截断+hash。
+ * - 截断按 UTF-8 码点边界，避免把多字节字符（如中文 3B/码点）切成半个坏字节。
+ */
+/** 单段目录名字节上限（APFS/ext4/NTFS NAME_MAX）。 */
+export declare const WORKSPACE_PATH_NAME_MAX_BYTES = 255;
+/** 超限时截断前缀保留的最大字节数；给 `-` + hash 后缀留足空间。 */
+export declare const WORKSPACE_PATH_PREFIX_MAX_BYTES = 180;
+/**
+ * djb2 哈希（对 UTF-8 字节），输出 base36。与 web-ui mcp-app-handlers 的 djb2
+ * 同构，但这里对**字节**而非 UTF-16 char code 取 hash，保证跨编码/跨 runtime 稳定。
+ */
+export declare function djb2Base36(input: string): string;
+/**
+ * 把字符串按 UTF-8 字节数截断到 `maxBytes`，且不切坏任何码点。
+ * 逐码点累加字节长度，超过上限即停。
+ */
+export declare function truncateToByteLimitOnCodePoint(value: string, maxBytes: number): string;
+/**
+ * 路径归一为「基础串」（未做长度守卫）：`/` `\` `:` → `-`，去首尾 `-`，
+ * 连续 `-` 折叠。`compressWorkspacePathName` 与读侧 legacy 兜底共用，
+ * 避免归一逻辑在写侧/读侧各存一份副本导致算法漂移（见
+ * workbuddy-core 的 `tryResolveLegacyProjectDirByPrefix`）。
+ */
+export declare function normalizeWorkspacePathBase(dir: string): string;
+/**
+ * 把任意目录路径归一成一个安全的单段目录名。
+ *
+ * 例：'/Users/ericffan/my-project' → 'Users-ericffan-my-project'
+ *
+ * 超长（>255 字节）时：截断前缀（≤180B，码点边界）+ '-' + djb2Base36(完整归一串)，
+ * 总长 ≤ 180 + 1 + ~7 < 255B，且对同一输入稳定、可被读侧前缀扫描定位。
+ */
+export declare function compressWorkspacePathName(dir: string): string;

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-ai/codebuddy-code",
-  "version": "2.155.0-dev.90f0e98.202609190049",
+  "version": "2.155.0",
   "description": "Use CodeBuddy, Tencent's AI assistant, right from your terminal. CodeBuddy can understand your codebase, edit files, run terminal commands, and handle entire workflows for you.",
   "main": "lib/node/index.js",
   "typings": "lib/node/index.d.ts",
@@ -71,8 +71,7 @@
     "url": "https://cnb.cool/codebuddy/codebuddy-code/-/issues"
   },
   "publishConfig": {
-    "access": "public",
-    "tag": "dev"
+    "access": "public"
   },
   "scripts": {},
   "devDependencies": {}

package/cli/product.cloudhosted.json

@@ -798,6 +798,6 @@
     "SelectImage": true,
     "SkipToolCallSupportCheck": true
   },
-  "commit": "90f0e980f3e6bbf419c85b3264d90b4f0fab2f55",
-  "date": "2026-09-18T16:49:06.510Z"
+  "commit": "7325d8e7c32cc9f241726667fb3e3d5eb78c710a",
+  "date": "2026-09-19T00:08:24.903Z"
 }

package/cli/product.internal.json

@@ -832,6 +832,6 @@
       }
     }
   },
-  "commit": "90f0e980f3e6bbf419c85b3264d90b4f0fab2f55",
-  "date": "2026-09-18T16:49:06.574Z"
+  "commit": "7325d8e7c32cc9f241726667fb3e3d5eb78c710a",
+  "date": "2026-09-19T00:08:24.813Z"
 }

package/cli/product.ioa.json

@@ -1325,6 +1325,6 @@
       }
     }
   },
-  "commit": "90f0e980f3e6bbf419c85b3264d90b4f0fab2f55",
-  "date": "2026-09-18T16:49:06.512Z"
+  "commit": "7325d8e7c32cc9f241726667fb3e3d5eb78c710a",
+  "date": "2026-09-19T00:08:24.846Z"
 }

package/cli/product.json

@@ -2226,6 +2226,6 @@
       "description": "tool-a2acanceltask-description"
     }
   ],
-  "commit": "90f0e980f3e6bbf419c85b3264d90b4f0fab2f55",
-  "date": "2026-09-18T16:49:06.615Z"
+  "commit": "7325d8e7c32cc9f241726667fb3e3d5eb78c710a",
+  "date": "2026-09-19T00:08:24.926Z"
 }

package/cli/product.selfhosted.json

@@ -359,6 +359,6 @@
     "ScheduledTasks": true,
     "SkipToolCallSupportCheck": true
   },
-  "commit": "90f0e980f3e6bbf419c85b3264d90b4f0fab2f55",
-  "date": "2026-09-18T16:49:06.499Z"
+  "commit": "7325d8e7c32cc9f241726667fb3e3d5eb78c710a",
+  "date": "2026-09-19T00:08:24.811Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-ai/agent-sdk",
-  "version": "0.3.263-dev.90f0e98.202609190050",
+  "version": "0.3.263",
   "description": "CodeBuddy Code SDK for JavaScript/TypeScript",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -32,7 +32,6 @@
     "zod": "^4.0.0"
   },
   "publishConfig": {
-    "access": "public",
-    "tag": "dev"
+    "access": "public"
   }
 }

package/cli/dist-server/types/node/a2a/a2a-artifact-download-service.d.ts

@@ -1,51 +0,0 @@
-import type { Session } from '../../vendor/cbc-core/node/index.js';
-import { Logger } from '@genie/telemetry';
-import { A2aArtifactDownloadService, type A2aArtifactDownloadStatus, type A2aArtifactSummary } from './a2a-protocol';
-/**
- * Outbound A2A artifact download (issue #99451). All four knobs are read LIVE
- * from `process.env` on every call — never cached — matching this repo's
- * prewarm convention and letting tests flip them between calls.
- */
-export declare const ENV_ARTIFACT_MAX_SIZE_MB = "CODEBUDDY_A2A_ARTIFACT_MAX_SIZE_MB";
-export declare const ENV_ARTIFACT_DOWNLOAD_TIMEOUT_MS = "CODEBUDDY_A2A_ARTIFACT_DOWNLOAD_TIMEOUT_MS";
-export declare const ENV_ARTIFACT_AWAIT_MS = "CODEBUDDY_A2A_ARTIFACT_AWAIT_MS";
-export declare const ENV_ARTIFACT_DOWNLOAD_ENABLED = "CODEBUDDY_A2A_ARTIFACT_DOWNLOAD_ENABLED";
-export interface A2aArtifactDownloadConfig {
-    maxSizeBytes: number;
-    downloadTimeoutMs: number;
-    awaitMs: number;
-}
-/** Resolved fresh on every call — see module doc comment. */
-export declare function resolveArtifactDownloadConfig(): A2aArtifactDownloadConfig;
-/** Independent kill switch for the download side effect. */
-export declare function isArtifactDownloadEnabled(): boolean;
-/**
- * Process-scoped component with Session-owned records and workspace paths.
- * `startDownload` captures the exact sandbox/cwd before launching async work,
- * so a late completion cannot fall through into another session's backend.
- */
-export declare class A2aArtifactDownloadServiceImpl implements A2aArtifactDownloadService {
-    protected readonly logger: Logger;
-    private readonly recordsBySession;
-    startDownload(session: Session, artifact: A2aArtifactSummary): void;
-    getResult(session: Session, url: string): {
-        status: A2aArtifactDownloadStatus;
-        localPath?: string;
-        error?: string;
-    } | undefined;
-    awaitPending(session: Session, urls: string[], timeoutMs: number): Promise<void>;
-    private recordsFor;
-    private failRecord;
-    private download;
-    private writeArtifact;
-    private ensureHostDirectories;
-    private sandboxContentMatches;
-    private hostContentMatches;
-    private atomicWriteHostFile;
-}
-/** Fire-and-forget trigger for every URL-referenced artifact. */
-export declare function startArtifactDownloads(service: A2aArtifactDownloadService | undefined, session: Session, artifacts: A2aArtifactSummary[] | undefined): void;
-/** Wait briefly before a terminal result and add completed workspace paths. */
-export declare function awaitAndEnrichArtifacts(service: A2aArtifactDownloadService | undefined, session: Session, artifacts: A2aArtifactSummary[] | undefined): Promise<A2aArtifactSummary[] | undefined>;
-/** Append the existing model-visible download summary without rewriting text. */
-export declare function appendDownloadSummary(text: string, artifacts: A2aArtifactSummary[] | undefined, service: A2aArtifactDownloadService | undefined, session: Session): string;

package/cli/dist-server/types/node/a2a/a2a-context-store.d.ts

@@ -1,100 +0,0 @@
-import { Session } from '../../vendor/cbc-core/node/index.js';
-/**
- * Session-scoped continuation state for outbound A2A calls: continuation key
- * -> A2A contextId, so a follow-up `message/send` continues the same
- * conversation on the remote agent instead of opening a fresh one.
- *
- * Why it lives on `session.meta` rather than a module-level map (the shape
- * this replaces):
- *
- *  - **Session isolation.** A module-level map is process-global. One
- *    agent-cli process can serve several conversations (and `/clear` starts a
- *    new one in the same process), so a global map lets conversation B
- *    silently resume conversation A's remote context.
- *  - **Cross-process survival.** `A2A_CONTEXTS_META_KEY` is on
- *    `PERSISTED_SESSION_META_KEYS`, so it rides the off-tree `session-meta`
- *    line inside the session transcript and comes back on `--resume`. Without
- *    it, a resumed conversation looks continuous locally while the remote
- *    agent has lost every earlier turn.
- *  - **Lifecycle for free.** The session owns the data: deleting the session
- *    drops it, a new session starts empty, and nothing needs a separate
- *    cleanup pass.
- *
- * Served sessions (ACP / gateway) never write the `session-meta` line — the
- * store still works in memory for the process lifetime, it just doesn't
- * survive a restart there. Degrading, not breaking.
- *
- * The key is `(discovery source, agentId)` — see {@link a2aContinuationKey}.
- */
-export declare const A2A_CONTEXTS_META_KEY = "codebuddy.ai/a2aContexts";
-/**
- * Continuation key: discovery source + agent.
- *
- * The source participates because an agent name is only unique *within* a
- * directory — the same name served by a different source is a different
- * remote. That matters more here than for an in-memory map: this state is
- * persisted, so it outlives the process and can still be around after a
- * session re-points its discovery source.
- *
- * Deliberately NOT keyed by skill. A contextId identifies a conversation with
- * an agent; skills are routing *within* that agent. Splitting per skill would
- * cut one conversation into several remote contexts that cannot see each
- * other's history.
- */
-export declare function a2aContinuationKey(source: string | undefined, agentId: string): string;
-/** One remembered remote conversation. `updatedAt` is epoch ms, used for expiry only. */
-export interface A2aContextEntry {
-    contextId: string;
-    updatedAt: number;
-}
-/** The persisted value under {@link A2A_CONTEXTS_META_KEY}: continuation key -> entry. */
-export type A2aContextMap = Record<string, A2aContextEntry>;
-/**
- * How long a remembered contextId stays usable. The A2A spec lets a remote
- * agent expire and reclaim contexts, and requires it to REJECT an unknown
- * contextId rather than quietly substituting a new one — so a stale id turns
- * every later call into a hard failure. Expiring locally keeps that from
- * happening: past the TTL we simply open a fresh context.
- *
- * 24h is deliberately conservative. It comfortably covers "close the laptop,
- * resume tomorrow morning" while staying well inside any plausible remote
- * retention window.
- *
- * Expiry is the ONLY staleness defence here, on purpose. Reacting to the
- * remote's rejection instead would be more precise, but the spec defines no
- * distinct error for "unknown contextId" and this SDK surfaces failures as
- * free-text messages (see classifyA2AError), so a rejection cannot be told
- * apart from a transient network failure. Guessing wrong either discards a
- * healthy context or — if paired with an automatic retry — re-sends a task
- * the remote may already have started. A clock is not clever, but it is
- * deterministic.
- */
-export declare const DEFAULT_A2A_CONTEXT_TTL_MS: number;
-/**
- * Resolve the context TTL, allowing an ops override without a release.
- *
- * - unset / empty -> default
- * - positive integer -> that value
- * - zero / negative / non-numeric -> default (fail soft; a broken env var
- *   must not silently disable continuation)
- */
-export declare function resolveA2aContextTtlMs(envValue?: string | undefined, defaultValue?: number): number;
-/**
- * The contextId to continue with for `key` (see {@link a2aContinuationKey}),
- * or undefined to start a fresh remote context. Undefined covers all of: no
- * session, nothing remembered, malformed persisted data, and expired entries.
- *
- * Pure read — expired entries are pruned on the next write, not here, so that
- * reading never mutates the session behind the caller's back.
- */
-export declare function readA2aContextId(session: Session | undefined, key: string, now?: number, ttlMs?: number): string | undefined;
-/**
- * Remember `contextId` under `key` (see {@link a2aContinuationKey}) on this
- * session, pruning expired entries along the way.
- *
- * Returns whether anything actually changed, which is the caller's signal to
- * persist. A no-change result is the common case (same context, recently
- * touched) and must NOT trigger a write — every write appends a line to the
- * transcript.
- */
-export declare function rememberA2aContextId(session: Session | undefined, key: string, contextId: string, now?: number, ttlMs?: number): boolean;

package/cli/dist-server/types/node/a2a/a2a-remote-cancel.d.ts

@@ -1,111 +0,0 @@
-import type { Logger } from '@genie/telemetry';
-import type { A2aClientService, A2aRegisteredAgent, A2aTaskSnapshot } from './a2a-protocol';
-/**
- * Default bounded timeout for the best-effort user-cancel `tasks/cancel` RPC,
- * env-overridable via {@link ENV_A2A_CANCEL_TIMEOUT_MS}. Deliberately short
- * (issue #99451 follow-up, plan §3.4/§7): a user cancel should settle quickly
- * — a few seconds is far better than an undelivered cancel, but we don't want
- * the cancel path to hang on the full 120s client default.
- */
-export declare const DEFAULT_A2A_CANCEL_TIMEOUT_MS = 3000;
-/** Env override for the best-effort user-cancel timeout (ms). */
-export declare const ENV_A2A_CANCEL_TIMEOUT_MS = "CODEBUDDY_A2A_CANCEL_TIMEOUT_MS";
-/**
- * Bounded timeout for {@link cancelRemoteTaskForReport}'s RPCs, env-overridable
- * via {@link ENV_A2A_CANCEL_REPORT_TIMEOUT_MS}.
- *
- * Longer than {@link DEFAULT_A2A_CANCEL_TIMEOUT_MS} because this path must
- * REPORT the real outcome, not just fire and forget — 3s is too tight to
- * reliably read a slow remote's terminal state. Still far below the client's
- * own 120s default: the user is sitting in front of a card they just
- * dismissed, and both RPCs (cancel, plus the follow-up read when the task
- * turns out to be already terminal) are bounded by this, so the worst case
- * the user waits is twice this value rather than four minutes.
- */
-export declare const DEFAULT_A2A_CANCEL_REPORT_TIMEOUT_MS = 10000;
-/** Env override for {@link cancelRemoteTaskForReport}'s bounded timeout (ms). */
-export declare const ENV_A2A_CANCEL_REPORT_TIMEOUT_MS = "CODEBUDDY_A2A_CANCEL_REPORT_TIMEOUT_MS";
-/**
- * Best-effort remote `tasks/cancel` for a user-initiated cancel of an
- * in-flight outbound A2A poll (issue #99451 follow-up).
- *
- * When a user (not the model) cancels an `A2AGetTask` poll loop, the loop
- * simply throws and unwinds today, leaving the remote agent running an
- * orphaned task. This helper closes that gap by telling the remote agent to
- * stop the task it was polling.
- *
- * Two hard constraints (both plan traps):
- *
- * 1. **Never pass the session's already-aborted signal.** At user-cancel
- *    time `session.abortSignal` is already aborted, and
- *    `A2aClientServiceImpl.withAbortAndClient` aborts its own controller
- *    immediately if the passed signal is already aborted — firing ZERO
- *    network calls. So this deliberately passes NO `signal` and relies on the
- *    client's own bounded `timeoutMs`.
- * 2. **Swallow raced-completion errors.** A task that finished between the
- *    last poll and the cancel yields `TaskNotCancelable` / `TaskNotFound`; a
- *    cancel racing completion is a success, not an error to surface. Any
- *    failure is logged at debug and swallowed — this is invisible,
- *    best-effort cleanup with no user-facing error.
- */
-export declare function bestEffortCancelRemoteTask(client: A2aClientService, agent: A2aRegisteredAgent, taskId: string, logger?: Pick<Logger, 'info' | 'debug'>, timeoutMs?: number): Promise<void>;
-/**
- * Outcome of {@link cancelRemoteTaskForReport} — three distinguishable
- * results, because the caller has to tell the model which one happened.
- */
-export type CancelForReportOutcome = 
-/** `tasks/cancel` landed; `snapshot` is the resulting (canceled) task. */
-{
-    kind: 'canceled';
-    snapshot: A2aTaskSnapshot;
-}
-/**
- * The task was ALREADY terminal, so it could not be canceled — per the
- * A2A spec that surfaces as `TaskNotCancelable`/`TaskNotFound`. `snapshot`
- * is a follow-up `tasks/get` carrying the task's REAL terminal state.
- */
- | {
-    kind: 'already-terminal';
-    snapshot: A2aTaskSnapshot;
-}
-/** Neither call settled (transport failure); the remote task's fate is unknown. */
- | {
-    kind: 'unknown';
-    message: string;
-};
-/**
- * Cancel a remote task and report what actually happened (issue #107183).
- *
- * Distinct from {@link bestEffortCancelRemoteTask}, and deliberately not a
- * variant of it. That helper exists for USER-ABORT cleanup: the session is
- * already tearing down, nobody is listening, so it returns `void`, passes no
- * signal (the session's is already aborted, which would fire zero network
- * calls), and swallows every failure into a debug log.
- *
- * This one runs on a LIVE session, when a user declined (or did not answer)
- * an approval card and the result has to be reported back to the model. Here
- * the failure modes are load-bearing information, not noise:
- *
- * - `TaskNotCancelable`/`TaskNotFound` means the task is already terminal —
- *   very often because the approval was granted through the approving
- *   system's own UI while our card was open, and the task ran to completion.
- *   Reporting "task canceled" there would tell the model the opposite of the
- *   truth, so we re-read the task and report its real state instead.
- * - A transport failure means we genuinely don't know, and the model must be
- *   told the remote task may still be running rather than assume either way.
- *
- * Never throws: every path resolves to one of the three
- * {@link CancelForReportOutcome} variants.
- *
- * `options.timeoutMs` defaults to {@link DEFAULT_A2A_CANCEL_REPORT_TIMEOUT_MS}
- * and is applied to BOTH RPCs. Defaulting here rather than at the call site is
- * deliberate: omitting it would fall through to `A2aClientServiceImpl`'s 120s
- * default, and with the follow-up read that is a four-minute stall right after
- * the user dismissed a card. The bound belongs to this helper's contract, so a
- * future caller cannot reintroduce that by forgetting to pass one.
- */
-export declare function cancelRemoteTaskForReport(client: A2aClientService, agent: A2aRegisteredAgent, taskId: string, options?: {
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    logger?: Pick<Logger, 'info' | 'debug' | 'warn'>;
-}): Promise<CancelForReportOutcome>;

package/cli/dist-server/types/node/acp/usage-by-category-calculator.d.ts

@@ -1,45 +0,0 @@
-/**
- * 上下文消耗 5 类目细拆 · 字符分类 + 反向归一化分配。
- * 严格守恒：sum(usageByCategory) === input.totalTokens（即 ACP usage_update.used）。
- */
-/** 5 类目细拆结果。schema 版本字段 `version` 为后续扩展预留。 */
-export interface UsageByCategory {
-    systemPrompt: number;
-    conversation: number;
-    tools: number;
-    mcp: number;
-    skills: number;
-    /** schema 版本：未来扩展加字段时 +1，客户端按 version 兼容。 */
-    version: 1;
-}
-/** 单个 tool 定义的最小契约（仅消费 name + description；其它字段透传 JSON.stringify）。 */
-export interface ToolLike {
-    name: string;
-    description?: string;
-    /** OpenAI Agent SDK 的 tool 通常带 parameters/schema；calculator 不解析，只 JSON.stringify。 */
-    input_schema?: unknown;
-    parameters?: unknown;
-}
-/** 单条 history item 的结构松约束（结构不规范时 calculator 跳过，不抛错）。 */
-export interface HistoryItemLike {
-    type?: string;
-    role?: string;
-    content?: unknown;
-    callId?: string;
-    name?: string;
-    arguments?: unknown;
-    output?: unknown;
-}
-export interface UsageByCategoryInput {
-    /** 当前请求最终发给模型的 system prompt 渲染产物（已 resolve 为字符串）。 */
-    systemPrompt: string;
-    /** 当前请求装载的 tool 定义列表（用作字符代理：JSON.stringify 每个 tool）。 */
-    tools: ReadonlyArray<ToolLike>;
-    /** session.history（user/assistant 消息 + function_call / function_call_result）。 */
-    history: ReadonlyArray<HistoryItemLike>;
-    /** ACP usage_update.used，作为最终归一化的总分母。 */
-    totalTokens: number;
-}
-export declare class UsageByCategoryCalculator {
-    static compute(input: UsageByCategoryInput): UsageByCategory;
-}

package/cli/dist-server/types/node/acp/usage-by-category-char-weight.d.ts

@@ -1,9 +0,0 @@
-/**
- * 字符权重 · 上下文消耗 5 类目细拆专用。
- * CJK / ASCII 字母空白 / 其它字符分别按 1.2 / 0.25 / 0.7 折算。
- */
-/**
- * 按字符权重把字符串折算成「token 数」估算量（用于 5 类目反向归一化的相对比例）。
- * 真实 token 数由 ACP usage_update.used 决定；本函数仅用作类目分配权重。
- */
-export declare function weighted(text: string): number;

package/cli/dist-server/types/node/acp/usage-by-category-distribute.d.ts

@@ -1,6 +0,0 @@
-/**
- * 守恒分配函数 —— 把 totalTokens 按 5 类目权重分配到非负整数桶里，sum 严格守恒。
- * 算法：floor 分配 + 按余数从大到小补 1。
- */
-export type UsageByCategoryKey = 'systemPrompt' | 'conversation' | 'tools' | 'mcp' | 'skills';
-export declare function distributeWithConservation(estimates: Record<UsageByCategoryKey, number>, totalTokens: number): Record<UsageByCategoryKey, number>;

package/cli/dist-server/types/node/acp/usage-by-category-tools-split.d.ts

@@ -1,11 +0,0 @@
-/**
- * Skills / MCP 切分 · 上下文消耗 5 类目细拆专用。
- * Skill 的 `<available_skills>` 归 skills；ToolSearch 的 `mcp__` 行归 mcp。
- */
-import type { ToolLike } from './usage-by-category-calculator';
-export interface ToolsBuckets {
-    toolsChars: string;
-    mcpChars: string;
-    skillsChars: string;
-}
-export declare function collectToolsBuckets(tools: ReadonlyArray<ToolLike>): ToolsBuckets;

package/cli/dist-server/types/node/agent/agent-config-cli-fields.d.ts

@@ -1,57 +0,0 @@
-/**
- * CLI-only extensions to the product `Agent` definition, declared via TypeScript
- * module augmentation so `@genie/product` (owned by another team) stays untouched.
- *
- * These fields are parsed from `.codebuddy/agents/*.md` frontmatter (and plugin
- * agent frontmatter) by agent-cli's own loaders, and consumed only inside
- * agent-cli. Runtime-wise they are plain optional properties on the agent
- * config object; this file only teaches the type system about them.
- *
- * If the product team later adopts any of these fields into
- * `packages/product/src/common/types/agent.ts`, the corresponding line here
- * must be removed (duplicate declarations with different types fail to compile).
- */
-import '@genie/product';
-declare module '@genie/product' {
-    interface Agent {
-        /**
-         * 原始 Agent 定义中显式声明的 model。
-         *
-         * Product 模型关系层会把 custom/chat 模型自动追加到 `models`，仅看最终
-         * 数组无法区分“定义明确选择了 custom 模型”和“定义没有 model、仅被自动
-         * 追加”。保留该字段供运行时恢复真正的定义默认值。
-         */
-        readonly declaredModel?: string;
-        /**
-         * 子代理最大轮次（对齐 Claude subagent 的 maxTurns frontmatter）。
-         * 生效优先级：env CODEBUDDY_CODE_SUBAGENT_MAX_TURNS > Agent 工具 max_turns 入参 > 本字段。
-         */
-        readonly maxTurns?: number;
-        /**
-         * 定义层强制后台运行（对齐 Claude subagent 的 background frontmatter）。
-         * true = 该 agent 被 Agent 工具 spawn 时总是走后台，等同调用方传 run_in_background=true；
-         * 受 CODEBUDDY_CODE_DISABLE_BACKGROUND_TASKS 门控（禁用时降级为同步执行）。
-         */
-        readonly background?: boolean;
-        /**
-         * 主 agent 模式（--agent / settings.agent）下自动前置到首条用户消息的提示词
-         * （对齐 Claude subagent 的 initialPrompt frontmatter）。
-         * 仅主会话首轮生效；子代理 spawn / teammate / 恢复会话不注入。
-         */
-        readonly initialPrompt?: string;
-        /**
-         * agent 级持久记忆 scope（对齐 Claude subagent 的 memory frontmatter）。
-         * - 'user': <configDir>/agent-memory/<name>/，跨项目共享
-         * - 'project': <cwd>/.codebuddy/agent-memory/<name>/，随仓库提交
-         * - 'local': <cwd>/.codebuddy/agent-memory-local/<name>/，项目内私有
-         * 启用后子代理系统提示注入 MEMORY.md（截断 200 行/25KB），
-         * 且显式 tools 白名单自动补 Read/Write/Edit。
-         */
-        readonly memory?: 'user' | 'project' | 'local';
-        /**
-         * 选择器展示名（可含空格 / 中文）。缺省回退 `name`。
-         * 内置模式用它把稳定 id（cli/ptc/minimal/create）显示成「标准模式」等。
-         */
-        readonly displayName?: string;
-    }
-}