@tencent-ai/agent-harness 0.2.0-beta.3 → 0.2.0-beta.4

package/cli/dist-server/types/workspace/cbc-core/lib/node/message-queue/steer-input-buffer-protocol.d.ts

@@ -28,6 +28,8 @@ export declare const SteerInputBuffer: unique symbol;
  * drain 返回的一组：待插入内容 + 独立对账 id + 客户端不透明 metadata。
  */
 export interface SteerDrainedGroup {
+    /** Set only after the host validates a one-time mod prompt receipt. */
+    readonly modsPromptSubmitted?: true;
     readonly blocks: unknown[];
     /** Native, already reviewed messages. Kept by reference for in-memory admission markers. */
     readonly messages?: readonly UserMessageItem[];
@@ -49,6 +51,8 @@ export interface SteerDrainedGroup {
  * push 的归属 + 客户端不透明 metadata 入参（合并为一个对象，避免 push 参数过多）。
  */
 export interface SteerPushInput {
+    /** Server-only provenance, independent of untrusted clientMeta. */
+    readonly modsPromptSubmitted?: true;
     /**
      * 这组消息归属的请求 id（当前正在执行的 turn 的 requestId）；
      * `undefined` 表示无归属信息（drain 时按「当前也无归属」放行，退化为旧行为）。

package/cli/dist-server/types/workspace/cbc-core/lib/node/session/can-use-tool.d.ts

@@ -40,6 +40,8 @@ export type PermissionResult = {
     updatedPermissions?: PermissionUpdate[];
     toolUseID?: string;
     decisionClassification?: PermissionDecisionClassification;
+    /** Optional host response metadata; interpreted only by the requesting tool. */
+    metadata?: Record<string, unknown>;
 } | {
     behavior: 'deny';
     message: string;
@@ -68,6 +70,8 @@ export interface CanUseToolOptions {
     displayName?: string;
     /** 桥端渲染的副标题说明。 */
     description?: string;
+    /** Tool-provided display/context metadata for host permission UIs. Not an authorization grant. */
+    metadata?: Record<string, unknown>;
     /** 本次工具调用在 assistant 消息内的唯一 id。 */
     toolUseID: string;
     /** 子代理上下文中触发时，子代理的 id。 */

package/cli/dist-server/types/workspace/cbc-core/lib/node/session/session-manager.d.ts

@@ -32,6 +32,7 @@ export declare class SessionManagerImpl implements SessionManager, ApplicationLi
     private skipHistoryContext;
     private sessionStartTimes;
     private addHistoryLocks;
+    private promptAdmissions;
     private resultSubscriptions;
     private readonly resultSubscriptionOwners;
     /**
@@ -108,6 +109,7 @@ export declare class SessionManagerImpl implements SessionManager, ApplicationLi
     private readonly loadedSessionIds;
     private resetIdleTimer;
     addHistory(session: Session, input: string | AgentInputItem[]): Promise<void>;
+    private writeHistory;
     /**
      * Record a UserPromptSubmit hook block as an in-band assistant message
      * (issue #71907, cc-aligned: cc surfaces a warning system message and ends the
@@ -125,6 +127,34 @@ export declare class SessionManagerImpl implements SessionManager, ApplicationLi
      * (use-message-sender). chalk=false because ACP does not strip ANSI codes.
      */
     private recordHookBlockedMessage;
+    /**
+     * 把一条 mod 打出来的 `$.ui.log` 落到当前 session 的可见消息流里。
+     *
+     * ## 与 `recordHookBlockedMessage` 的关系
+     *
+     * 二者走**同一条落地路径**（history + inputSubject + combineSubject +
+     * sessionStore.appendHistory），因此 TUI / ACP / persisted transcript 都用
+     * 既有渲染，不必新增 sessionUpdate 类型（对齐根 CODEBUDDY.md 的 ACP 约束）。
+     *
+     * ## 与 hook 阻断消息刻意不同的三点
+     *
+     * 1. **不动 `session.lastMessageId`**：hook-block 是回合终点，需要挂上 replay
+     *    分支；mod-log 是**装饰性**通知，如果推进 lastMessageId 会让 `/rewind`
+     *    退到"一条 log 中间"，语义混乱。
+     * 2. **不挂 `parentId`**：同样出于 replay 分支洁净。
+     * 3. **`chalk: false`**：ACP 侧不剥 ANSI，chalk 转义码会露出到 Web UI；此外
+     *    宿主已在 `<plugin>: <text>` 里给足了归属信号，terminal 也不再需要额外
+     *    颜色包装（TUI 侧后续可按 `hookStatus === 'mod-log'` 做专属渲染）。
+     *
+     * ## 失败语义
+     *
+     * 与 hook-block 同款：写盘失败只记日志，不向外抛 —— mod 打日志不该把 CLI 弄挂。
+     *
+     * @param session 目标 session（宿主取当前 session 后传入）
+     * @param text 已由宿主前缀成 `<plugin>: <text>` 的完整行文
+     * @param plugin 发起本次调用的 mod 名（`origin.plugin`），用于前端识别
+     */
+    recordModLogMessage(session: Session, text: string, plugin: string): Promise<void>;
     private readonly inflightSessionStarts;
     emitSessionStart(session: Session, source: SessionStartSource): Promise<void>;
     create(options?: Partial<Session>, needHandleRunResult?: boolean, parentSession?: Session): Promise<Session>;

package/cli/dist-server/types/workspace/cbc-core/lib/node/session/session-protocol.d.ts

@@ -1117,6 +1117,18 @@ export interface SessionManager {
      * before injecting `additionalContext`.
      */
     emitSessionStart(session: Session, source: SessionStartSource): Promise<void>;
+    /**
+     * Record a mod-plugin `$.ui.log` line as a user-visible message on the
+     * session transcript (mirrors `recordHookBlockedMessage` — same
+     * inputSubject / combineSubject / sessionStore path — but leaves
+     * `lastMessageId` and `parentId` untouched because mod logs are
+     * decorative and must not become anchors on the replay branch).
+     *
+     * @param session target session (host resolves current session and passes it in)
+     * @param text already prefixed as `<plugin>: <text>` by the host bridge
+     * @param plugin the calling mod's name (`origin.plugin`), for provider metadata
+     */
+    recordModLogMessage(session: Session, text: string, plugin: string): Promise<void>;
     addHistory(session: Session, input: string | AgentInputItem[]): Promise<void>;
     save(session: Session): Promise<void>;
     /** Initialize an immutable full snapshot for a new fork; target must be absent or empty. */

package/cli/dist-server/types/workspace/cbc-core/lib/node/utils/input-item-utils.d.ts

@@ -1,6 +1,6 @@
 import { type AcpTerminalStateItem, type AgentInputItem, type AssistantMessageItem, type CustomTitleItem, type FileHistorySnapshotItem, type FunctionCallItem, type FunctionCallResultItem, type HookBlockingDetail, HookEvent, type ResendForkNoticeItem, type UserMessageItem } from '../../../../cbc-shared/lib/node/index.js';
 type ItemStatus = 'in_progress' | 'completed' | 'incomplete';
-export type HookStatus = 'success' | 'blocked' | 'warning' | 'error';
+export type HookStatus = 'success' | 'blocked' | 'warning' | 'error' | 'mod-log';
 interface ItemOptions {
     readonly skipRun?: boolean;
     readonly status?: ItemStatus;

package/cli/dist-server/types/workspace/product/lib/common/types/features.d.ts

@@ -340,6 +340,7 @@ export declare enum ProductFeature {
     SkillSecurityScan = "SkillSecurityScan",
     SkillRecommend = "SkillRecommend",
     BeforeConversationRecommend = "BeforeConversationRecommend",
+    AfterConversationRecommend = "AfterConversationRecommend",
     /**
      * 是否开启文本选择操作功能
      */
@@ -1420,6 +1421,21 @@ export declare enum ProductFeature {
      * @default false
      */
     EnableClawChannelControl = "EnableClawChannelControl",
+    /**
+     * 是否隐藏设置面板「助理设置 → 远程渠道」整个区块（含微信助理 / 企微机器人 /
+     * QQ 机器人等通道卡片与定时任务企微 bot 推送卡片）。
+     *
+     * 仅隐藏 UI 入口，不影响「上下文管理」（Session Management）等其他区块。
+     * 专享版（Cloud-Hosted）与私有化（Self-Hosted）定制渠道不支持远程助理渠道，
+     * 在 workbuddy-custom base 的 productFeatures 配置 true（私有化构建自动继承）；
+     * 运行期也可经 /v3/config 下发覆盖（如放开某个已部署网关的租户）。
+     *
+     * - 旗舰版（标准渠道）：不配置该 key → 不禁用，远程渠道照常展示（fail-open）
+     * - 专享版 / 私有化：配置 true → 隐藏区块；缺省（未配置）同旗舰版展示
+     *
+     * @default false
+     */
+    DisableClawRemoteChannels = "DisableClawRemoteChannels",
     /**
      * 是否启用 AI 代码入库率统计能力
      *

package/cli/dist-server/types/workspace/prompts/lib/common/product-prompt-provider.d.ts

@@ -1,9 +1,11 @@
 import { Application, ApplicationLifecycle } from '@celljs/core';
-import { ProductManager } from '../../../product/lib/common/index.js';
+import { ProductConfigurationContext, ProductManager } from '../../../product/lib/common/index.js';
 import { BehaviorSubject } from 'rxjs';
 import { PromptProvider, PromptTemplate } from './prompt-protocol.js';
 export declare class ProductPromptProvider implements PromptProvider, ApplicationLifecycle<Application> {
     protected readonly productManager: ProductManager;
+    protected readonly executionConfiguration?: ProductConfigurationContext;
     productTemplateSubject: BehaviorSubject<PromptTemplate[]>;
+    getScopedTemplates(): PromptTemplate[] | undefined;
     initialize(): void;
 }

package/cli/dist-server/types/workspace/prompts/lib/common/prompt-protocol.d.ts

@@ -39,6 +39,12 @@ export interface PromptManager {
 }
 export interface PromptProvider {
     productTemplateSubject: BehaviorSubject<PromptTemplate[]>;
+    /**
+     * Replace this provider's process templates for the current execution.
+     * undefined uses the process snapshot; [] explicitly supplies no templates.
+     * The result must never be published to the shared template map.
+     */
+    getScopedTemplates?(): PromptTemplate[] | undefined;
 }
 export interface PromptEvaluator {
     priority(context: PromptRenderContext): Promise<number>;