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

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

@@ -514,20 +514,12 @@ export declare enum ProductFeature {
     /**
      * 是否禁用积分入口（用户菜单「积分」项 + 设置页账户「积分」区块）
      * 设置为 true 时，完全隐藏积分入口（不展示菜单项与账户面板积分区块）。
-     * 用于无积分体系的发行版（如海外版 workbuddy-ai）。
+     * 用于无积分体系的发行版（如私有化、云托管和 Custom 产品）。
      * 注意与 ShowCreditsBalance 区分：ShowCreditsBalance 控制「是否展示积分数值」，
      * 本 flag 控制「积分入口是否存在」。
      * @default false（默认有积分入口）
      */
     DisableCreditsEntry = "DisableCreditsEntry",
-    /**
-     * 是否禁用设置页「订阅和用量」入口
-     * 设置为 true 时隐藏该导航项，并禁止通过 Settings hash 直达该页面。
-     * 积分入口仍可保留；点击后回落到设置页「个人主页」。
-     * 用于海外版等保留积分体系、但不开放订阅管理页的发行版。
-     * @default false（默认显示）
-     */
-    DisableSubscriptionUsageEntry = "DisableSubscriptionUsageEntry",
     /**
      * 是否禁用侧栏「邀请好友」入口
      * 设置为 true 时隐藏入口及邀请积分弹窗。
@@ -911,6 +903,10 @@ export declare enum ProductFeature {
      * 是否启用文生视频功能
      */
     VideoGen = "VideoGen",
+    /**
+     * 是否启用录音文件识别（长音频转文本）功能
+     */
+    AudioTranscribe = "AudioTranscribe",
     /**
      * 是否开启 Artifact（本地 HTML/Markdown → 上传 → 可分享公网链接）能力。
      * issue #81031：ShareLink 工具更名为 Artifact 后的新规范 key；
@@ -1056,6 +1052,41 @@ export declare enum ProductFeature {
      * @default false
      */
     QuickQa = "QuickQa",
+    /**
+     * 首页「快速问答」入口开关。issue #124324
+     *
+     * 与 `QuickQa` **相互独立，不做 AND**：`QuickQa` 管能力本体（划词入口、推荐胶囊、
+     * embed 空视图、会话内 mode 展示），本 key 只管首页那条新建链路 —— 场景 Tab
+     * （设计创意之后的第 4 项）、`Meta/Ctrl+Shift+N`、首页输入框的 quick 模式项。
+     *
+     * ⚠️ **缺省值按账号算，不是固定布尔**：IOA 企业（`IOA_ENTERPRISE_IDS`）缺省开启，
+     * 其余（个人账号 / 非 IOA 企业 / 未登录）缺省关闭。因此 **`product.json` 里故意
+     * 不登记这个 key** —— 注入快照里一旦有 key 就走不到 `missingKeyEnabled`，写成全局
+     * 布尔会把 IOA 判定整个压掉。远端 `v3/config` 显式下发时以远端为准。
+     *
+     * 实现见 `agent-ui` 的 `useHomeQuickAskEntryFeatureEnabled`。
+     * @default IOA 为 true，其余为 false
+     */
+    QuickAskEntry = "QuickAskEntry",
+    /**
+     * 侧栏一级入口收敛开关。issue #124324
+     *
+     * 启用后：宿主入口文案与图标从「更多」改为「发现」，下拉按分组补分割线；且对**没配置过
+     * 自定义菜单**的用户，一级栏收到「新建任务 / 定时任务 / 资料库」+ 末位「发现」共 4 项，
+     * 助理、项目、专家、运营自建菜单、其余 sidebar extension 默认下沉进「发现」。
+     * 关闭后：一级栏与下拉维持收敛前的原样（入口不下沉、宿主入口仍叫「更多」、无分割线）。
+     *
+     * ⚠️ 两个粒度不同，见 `useSidebarPrimaryCollapse`：
+     *   1. 「发现」外观与分割线**只看本 flag**，与用户有没有拖过菜单无关。
+     *   2. **下沉**额外要求用户没配置过自定义菜单 —— 已存配置里的 id 会被
+     *      `restoreCustomMenuDialogValue` 按存档分区放回去，下沉对这些用户只能半生效，
+     *      所以条目位置一律听用户的配置。
+     *
+     * 缺省值按账号算（IOA 开、其余关），因此 **`product.json` 故意不登记这个 key** —— 与
+     * `QuickAskEntry` 同理，注入快照里一旦有 key 就走不到 `missingKeyEnabled`。
+     * @default IOA 为 true，其余为 false
+     */
+    SidebarPrimaryCollapse = "SidebarPrimaryCollapse",
     /**
      * 主任务新引擎的**远端灰度/紧急回滚**开关。
      * - 远端缺 key → 解析为 true（不阻断）；显式 false → 强制回退 MainContentCore
@@ -1128,7 +1159,7 @@ export declare enum ProductFeature {
      */
     TencentDocsCloudSandboxBridge = "TencentDocsCloudSandboxBridge",
     /**
-     * 内置 tencent-pptx 插件首次 seed 时默认开启。
+     * 内置 workbuddy-pptx 插件首次 seed 时默认开启。
      * 设置为 false 时跳过默认写入 enabledPlugins（kill-switch）。
      * @default true
      */
@@ -1715,6 +1746,11 @@ export declare enum ProductFeature {
      * @see Issue #96599
      */
     ModelRateLimitCap = "ModelRateLimitCap",
+    /**
+     * 模型 Preview 试用期常驻 Banner 的结构化规则配置。
+     * 配置位于 `productFeaturesConfig[ModelTrialBanner].banners`，缺失即关闭。
+     */
+    ModelTrialBanner = "ModelTrialBanner",
     /**
      * Agent CLI 出站 A2A（Agent2Agent）能力总开关（issue #99451）。
      *
@@ -1825,7 +1861,23 @@ export declare enum ProductFeature {
      *
      * @default true
      */
-    TuringDeviceToken = "TuringDeviceToken"
+    TuringDeviceToken = "TuringDeviceToken",
+    /**
+     * 统一资产管理总开关（#92015，对齐 feature/unified-asset-mgmt 分支）。
+     * 打开即完整执法（拦截 / 执行 / 删除 / 付费），关闭时完全保持既有
+     * Expert/Skill/Connector 行为。消费方为 `@genie/unified-asset` 的
+     * `isUnifiedAssetEnabled`（CLI 侧 Skill Guard Hooks 与 server 侧门控共用）。
+     * @default false
+     */
+    UnifiedAsset = "UnifiedAsset",
+    /**
+     * 技能订阅门控（付费技能 pre-call 拦截）。
+     * check 链路已 fail-close，门控默认生效（缺省开）是更安全方向。
+     * 当前无云端开关设计，仅登记 key 预留口子——后续接灰度开关时经
+     * productFeatures 下发（消费方 skill-subscription-gate.isEnabled）。
+     * @default true
+     */
+    SkillSubscriptionGate = "SkillSubscriptionGate"
 }
 /**
  * 功能配置开关

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

@@ -32,6 +32,24 @@ export interface ModelContextWindow {
      */
     defaultLength?: number;
 }
+/**
+ * 视频生成能力声明（VideoGen 使用）。
+ *
+ * 分辨率未声明时按通用缺省处理：支持 720P / 1080P，默认 1080P。
+ * 时长未声明时仅使用通用默认值，且不接受调用方指定时长。
+ */
+export interface ModelVideoGeneration {
+    /** 支持的分辨率档位，如 ['480P', '720P'] */
+    resolutions?: ReadonlyArray<string>;
+    /** 默认分辨率档位，如 '720P'；应落在 resolutions 内 */
+    defaultResolution?: string;
+    /** 支持的最短视频时长（秒），如 4；与 maxSeconds 成对声明 */
+    minSeconds?: number;
+    /** 支持的最长视频时长（秒），如 30；与 minSeconds 成对声明 */
+    maxSeconds?: number;
+    /** 默认视频时长（秒），如 5；应落在 minSeconds 与 maxSeconds 之间 */
+    defaultSeconds?: number;
+}
 export interface ModelReasoning {
     /**
      * @deprecated 使用 {@link defaultEffort} 替代；保留仅为向后兼容旧 product config。
@@ -148,6 +166,52 @@ export interface ModelGroup {
     readonly trailingActions?: readonly string[];
     readonly order?: number;
 }
+/**
+ * 用户会员类型（Issue #87302），供 {@link ModelTier.requiredUserType} 引用。
+ *
+ * ⚠️ 这是 `@genie/agent-provider.UserType` 的镜像，字段必须保持一致。
+ * 不在此处直接 import `@genie/agent-provider`（product 是上层，会引入反向依赖），
+ * 与 {@link ModelPromotion} 同款处理。
+ */
+export type UserType = 'free' | 'standard' | 'youth' | 'advanced' | 'flagship';
+/** 模型会员权益档位级别（Issue #87302）：flagship > advanced > standard > trial。 */
+export type ModelTierLevel = 'flagship' | 'advanced' | 'standard' | 'trial';
+/** 档位徽章（Issue #87302），本期只下发文案，颜色由客户端按 tier 写死。 */
+export interface ModelTierBadge {
+    readonly label: string;
+}
+/** 档位 hover 底部说明 + 升级 CTA（Issue #87302）。 */
+export interface ModelTierHover {
+    readonly textZh?: string;
+    readonly textEn?: string;
+    readonly action?: {
+        readonly type: 'upgrade';
+        readonly labelZh?: string;
+        readonly labelEn?: string;
+    };
+}
+/**
+ * 模型会员权益档位展示配置（Issue #87302）。
+ *
+ * 由 product config 顶层 `modelTiers` 下发，按 `modelIds` 命中模型后附加到模型元数据的
+ * `tier` 上（多档位命中同一模型时按 `priority` 选主）。与 {@link ModelPromotion}（按时间
+ * 窗口生效的运营活动）语义不同：tier 表示「按会员等级的长期权益档位」。
+ *
+ * ⚠️ 此类型与 `@genie/agent-provider.ModelTier`、以及
+ * `packages/workbuddy-server/src/config/contract.ts` 引用的 canonical 定义互为镜像，
+ * 字段必须保持一致（同款处理见 {@link ModelPromotion}）。任一处改动需同步其余各处。
+ */
+export interface ModelTier {
+    readonly id: string;
+    readonly tier: ModelTierLevel;
+    readonly enabled?: boolean;
+    readonly priority?: number;
+    readonly modelIds: readonly string[];
+    readonly badge?: ModelTierBadge;
+    readonly hover?: ModelTierHover;
+    readonly requiredUserType?: UserType;
+    readonly trackKey?: string;
+}
 /**
  * 语言模型的定义接口，描述模型的基本属性和能力。
  */
@@ -206,6 +270,8 @@ export interface LanguageModel {
     readonly reasoning?: ModelReasoning;
     /** 上下文窗口预算配置（Issue #57413）；maxInputTokens 仍表示物理上限。 */
     readonly contextWindow?: ModelContextWindow;
+    /** 视频生成能力（VideoGen 使用）：支持的分辨率档位与默认档位。 */
+    readonly videoGeneration?: ModelVideoGeneration;
     /**
      * effort 级别到上游字面量的映射表。来自模型目录，
      * 由请求层在拼装 reasoning_effort 时按需翻译。

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

@@ -15,7 +15,7 @@ import { GalileoConfig } from './galileo.js';
 import { Instruction } from './instruction.js';
 import { IntegrationOverridesConfiguration } from './integrations.js';
 import { KnowledgeBaseConfiguration } from './knowledge-base.js';
-import { LanguageModel, ModelGroup, ModelPromotion, ModelRelatedModels } from './language-model.js';
+import { LanguageModel, ModelGroup, ModelPromotion, ModelRelatedModels, ModelTier } from './language-model.js';
 import { LinkConfiguration } from './links.js';
 import { LogConfiguration } from './log.js';
 import { LSPExtensionConfig } from './lsp.js';
@@ -290,6 +290,12 @@ export interface ProductConfiguration {
      * `/v3/config` 顶层下发；前端按 `group.modelIds` 组装二级面板，不再按 id 前缀隐式筛选。
      */
     modelGroups?: ModelGroup[];
+    /**
+     * 模型会员权益档位展示配置（Issue #87302）。顶层下发，按 `modelIds` 命中模型后附加
+     * 徽章 / hover 档位标签。白名单式返回（daemon config RPC）必须显式透传该字段，
+     * 否则 renderer 侧读不到、档位徽章不展示（回归见 Issue #126934）。
+     */
+    modelTiers?: ModelTier[];
     /**
      * 默认关联模型配置
      * 当模型自身没有配置 relatedModels 时，使用此默认配置作为兜底
@@ -394,6 +400,21 @@ export interface ProductConfiguration {
     marketplaceVersionCheckIntervalMs?: number;
     /** 内置插件配置，用于初始化时自动安装 */
     builtInMarketPlugins?: BuiltInPluginConfig[];
+    /**
+     * 专享版/私有化插件变体映射（占位符渲染方案）。
+     *
+     * key 为 marketplace 内 plugin name，value 为同 marketplace 下变体目录名（与原插件
+     * source 目录同级）。**构建期**消费：`apps/workbuddy-desktop` 的
+     * `syncBundledRuntimeAssets()`（`scripts/exclusive-plugin-build-render.mjs`）在
+     * 拷贝 resources → dist 之后渲染变体内的 `${TENCENT_DOCS_DOMAIN}` 占位符为
+     * `privateHost.docHost ?? endpoint -docs 派生`（域名不可得时构建失败，不回填
+     * 默认域），再用变体内容覆盖原插件目录。运行时物化链零感知。
+     *
+     * 仅专享版/私有化打包配置写入（`build/patches/workbuddy-custom/product.json`，
+     * 私有化构建自动继承 base）；旗舰版/C 端不写 → 字段 undefined → 构建期
+     * 零触发（fail-safe）。
+     */
+    exclusivePluginVariants?: Record<string, string>;
     /**
      * 内置插件合并配置（通过 Unleash 远程下发）
      * 与 product.json 和 /v3/config 的 builtInMarketPlugins 结果合并

package/cli/dist-server/types/workspace/sandbox-cli/lib/common/backup-policy.d.ts

@@ -1,9 +1,18 @@
 export declare const FILE_BACKUP_DEFAULT_MAX_SIZE_MB = 3000;
 export declare const FILE_BACKUP_MIN_SIZE_MB = 1000;
+/**
+ * 备份总大小上限的最大允许值（MB）。
+ *
+ * Rust 侧（sandbox-center）使用 u32 反序列化 `fileBackupMaxSizeMB`，
+ * 超过 u32 上限（4294967295）会导致 serde 报错、整条 EnableModifyBackup
+ * 失败，进而使当轮文件备份静默关闭。1_000_000 MB ≈ 1 TB，远超实际需求
+ * 且安全落在 u32 范围内。
+ */
+export declare const FILE_BACKUP_MAX_SIZE_MB = 1000000;
 export interface FileBackupConfig {
     /** 是否启用文件备份 */
     enabled?: boolean;
-    /** 备份总大小上限（MB），不小于 1000 */
+    /** 备份总大小上限（MB），有效范围 [1000, 1000000] */
     maxSizeMB?: number;
 }
 export declare const DEFAULT_MODIFY_BACKUP_EXCLUDED_DIRS: readonly ["~/.cache/", "~/.local/", "~/.npm/", "~/.pnpm-store/", "~/.cargo/", "~/.rustup/", "~/go/", "~/.gradle/", "~/.m2/", "~/.nuget/", "~/.bun/", "~/.deno/", "~/.npm-global/", "~/.pyenv/", "~/appdata/local/temp/", "~/appdata/local/npm-cache/", "~/appdata/local/pnpm/", "~/appdata/local/yarn/", "~/appdata/local/fnm_multishells/", "~/.yarn/", "~/.nvm/", "~/.fnm/", "~/appdata/local/pip/", "~/appdata/local/conda/", "~/appdata/local/uv/", "~/appdata/roaming/uv/", "~/.pyenv/", "~/.conda/", "~/miniconda3/", "~/miniforge3/", "~/appdata/local/go-build/", "~/appdata/roaming/go/", "~/.sdkman/", "~/.dotnet/", "~/appdata/local/nuget/", "~/.docker/", "~/.asdf/", "~/appdata/roaming/npm/", "~/appdata/local/microsoft/windowsapps/", "~/appdata/roaming/code/", "~/appdata/roaming/trae/", "~/appdata/roaming/microsoft/windows/powershell/", "~/appdata/local/microsoft/windows/powershell/", "~/appdata/roaming/microsoft/windows/recent/", "~/appdata/local/microsoft/windows/recent/", "C:\\openclaw\\openclaw\\", "~/Library/Caches/", "~/Library/Developer/Xcode/DerivedData/", "~/Library/Developer/CoreSimulator/Caches/", "~/.pub-cache/", "~/.ivy2/cache/", "~/.sbt/boot/", "~/.gem/specs/", "~/.cabal/packages/", "~/.cabal/store/", "~/.stack/pantry/", "~/appdata/local/pub/cache/", "~/appdata/local/pypa/virtualenv/", "**/node_modules/**", "**/.pnpm-store/**", "**/.venv/**", "**/.tox/**", "**/.nox/**", "**/__pycache__/**", "**/.pytest_cache/**", "**/.mypy_cache/**", "**/.ruff_cache/**", "**/.next/**", "**/.nuxt/**", "**/.svelte-kit/**", "**/.parcel-cache/**", "**/.turbo/**", "**/.vite/**", "**/.vite-temp/**", "**/.sass-cache/**", "**/.dart_tool/**", "**/.gradle/**", "**/.cxx/**", "**/.externalNativeBuild/**", "~/.codebuddy/debug/", "~/.codebuddy/statsig/", "~/.workbuddy/plugins/", "~/.workbuddy/skills-marketplace/", "~/.workbuddy/connectors/", "~/.workbuddy/connectors-marketplace/", "~/.workbuddy/binaries/", "~/appdata/local/codex/", "~/appdata/local/hermes/", "~/appdata/roaming/python/", "~/appdata/roaming/pip/", "~/appdata/roaming/npm-cache/", "~/appdata/roaming/nuget/", "~/appdata/local/pnpm-store/", "~/appdata/local/ms-playwright/", "~/appdata/local/google/chrome/", "~/appdata/local/google/chrome for testing/", "~/appdata/local/microsoft/windows/caches/", "~/appdata/local/microsoft/powershell/", "~/appdata/local/packages/", "C:\\Windows\\System32\\lxss\\", "**\\$RECYCLE.BIN\\**", "**\\.git\\**", "**\\.githooks\\**"];