@sema-agent/settings-schema 1.8.0 → 1.9.0

package/CHANGELOG.md

@@ -6,6 +6,15 @@
 > `@sema-agent/registry-core`(更早还曾是 `@sema-ai/registry-core`)。本档 `0.19.0` 以下各节里的
 > 包名是**历史记录**,如实保留不追改。
 
+## 1.9.0 — 2026-09-08 — `mcp.servers[].toolFaces` 覆盖层声明面(core 7.8.0 design/388 片 1 F7;新键=minor)
+
+- core 7.8.0 起 `McpServerSpec.toolFaces?: Record<remoteToolName, { family?, pathTarget?: {param, aliases?, access, skillScopeEligible?}, renderHints?, ruleFace? }>`
+  是工具名册的 face 覆盖层。本仓只加**解析透明**的键(`z.unknown().optional()`),与 1.7.2 `source` 同一条规矩:形的校验属 core 摄入侧
+  (不合 schema 的工具**不挂**并通告一次 `config.tool_face_invalid`),本仓不复述那张表——这一域 all-or-nothing,任一字段解析拒都会让整套
+  mcp 服务器静默消失(S-144 类病)。缺席 = 不铸键。
+- 红先:`test/mcp-tool-faces-1.9.test.ts`(1.8.0 上「带 toolFaces 的 server 键原样到消费方」红)。
+- 消费方:sema-server(MCP 配置面三腿透传,随 7.66.0)、cli(settings 面)。
+
 ## 1.8.0 — 2026-09-07 — `ModelRole` 闭集对齐 core:加 `classifier` / `consolidate`(新词=minor)
 
 - cli [6554] 真案:core `ModelRole` 早有 `classifier`(auto 权限分类器,FALLBACK classifier→summarize→default、tier 缺省 flash)

package/dist/types.d.ts

@@ -7334,6 +7334,12 @@ export declare const McpServerSpec: z.ZodObject<{
      *  both legs stripped it (default-strip object); this is the declaration half of the consumer-side fix
      *  (ticket B-036 / S-143), the projection half lives in the consumer. */
     source: z.ZodOptional<z.ZodUnknown>;
+    /** 1.9.0 —— core 7.8.0(design/388 片 1 F7)`toolFaces` 覆盖层:按远端工具名 key 的 face 声明
+     *  (`{ family?, pathTarget?: {param, aliases?, access, skillScopeEligible?}, renderHints?, ruleFace? }`)。
+     *  与 `source` 同一条规矩:**解析透明**(`z.unknown()`),形的校验属 core 摄入侧(不合 schema 的工具**不挂**并
+     *  通告一次 `config.tool_face_invalid`);本仓不复述那张表 —— 这一域 all-or-nothing,任一字段解析拒都会
+     *  让整套 mcp 服务器静默消失。缺席 = 不铸键。 */
+    toolFaces: z.ZodOptional<z.ZodUnknown>;
     notes: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -7356,6 +7362,7 @@ export declare const McpServerSpec: z.ZodObject<{
     allowTools?: string[] | undefined;
     contentOrigin?: "local" | "execution" | "external" | undefined;
     source?: unknown;
+    toolFaces?: unknown;
 }, {
     name: string;
     transport: {
@@ -7377,6 +7384,7 @@ export declare const McpServerSpec: z.ZodObject<{
     elicitation?: boolean | undefined;
     contentOrigin?: "local" | "execution" | "external" | undefined;
     source?: unknown;
+    toolFaces?: unknown;
 }>;
 export type McpServerSpec = z.infer<typeof McpServerSpec>;
 export declare const McpConfig: z.ZodEffects<z.ZodObject<{
@@ -7465,6 +7473,12 @@ export declare const McpConfig: z.ZodEffects<z.ZodObject<{
          *  both legs stripped it (default-strip object); this is the declaration half of the consumer-side fix
          *  (ticket B-036 / S-143), the projection half lives in the consumer. */
         source: z.ZodOptional<z.ZodUnknown>;
+        /** 1.9.0 —— core 7.8.0(design/388 片 1 F7)`toolFaces` 覆盖层:按远端工具名 key 的 face 声明
+         *  (`{ family?, pathTarget?: {param, aliases?, access, skillScopeEligible?}, renderHints?, ruleFace? }`)。
+         *  与 `source` 同一条规矩:**解析透明**(`z.unknown()`),形的校验属 core 摄入侧(不合 schema 的工具**不挂**并
+         *  通告一次 `config.tool_face_invalid`);本仓不复述那张表 —— 这一域 all-or-nothing,任一字段解析拒都会
+         *  让整套 mcp 服务器静默消失。缺席 = 不铸键。 */
+        toolFaces: z.ZodOptional<z.ZodUnknown>;
         notes: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         name: string;
@@ -7487,6 +7501,7 @@ export declare const McpConfig: z.ZodEffects<z.ZodObject<{
         allowTools?: string[] | undefined;
         contentOrigin?: "local" | "execution" | "external" | undefined;
         source?: unknown;
+        toolFaces?: unknown;
     }, {
         name: string;
         transport: {
@@ -7508,6 +7523,7 @@ export declare const McpConfig: z.ZodEffects<z.ZodObject<{
         elicitation?: boolean | undefined;
         contentOrigin?: "local" | "execution" | "external" | undefined;
         source?: unknown;
+        toolFaces?: unknown;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     servers: {
@@ -7531,6 +7547,7 @@ export declare const McpConfig: z.ZodEffects<z.ZodObject<{
         allowTools?: string[] | undefined;
         contentOrigin?: "local" | "execution" | "external" | undefined;
         source?: unknown;
+        toolFaces?: unknown;
     }[];
 }, {
     servers?: {
@@ -7554,6 +7571,7 @@ export declare const McpConfig: z.ZodEffects<z.ZodObject<{
         elicitation?: boolean | undefined;
         contentOrigin?: "local" | "execution" | "external" | undefined;
         source?: unknown;
+        toolFaces?: unknown;
     }[] | undefined;
 }>, {
     servers: {
@@ -7577,6 +7595,7 @@ export declare const McpConfig: z.ZodEffects<z.ZodObject<{
         allowTools?: string[] | undefined;
         contentOrigin?: "local" | "execution" | "external" | undefined;
         source?: unknown;
+        toolFaces?: unknown;
     }[];
 }, {
     servers?: {
@@ -7600,6 +7619,7 @@ export declare const McpConfig: z.ZodEffects<z.ZodObject<{
         elicitation?: boolean | undefined;
         contentOrigin?: "local" | "execution" | "external" | undefined;
         source?: unknown;
+        toolFaces?: unknown;
     }[] | undefined;
 }>;
 export type McpConfig = z.infer<typeof McpConfig>;
@@ -10138,6 +10158,12 @@ export declare const DOMAIN_SCHEMAS: {
              *  both legs stripped it (default-strip object); this is the declaration half of the consumer-side fix
              *  (ticket B-036 / S-143), the projection half lives in the consumer. */
             source: z.ZodOptional<z.ZodUnknown>;
+            /** 1.9.0 —— core 7.8.0(design/388 片 1 F7)`toolFaces` 覆盖层:按远端工具名 key 的 face 声明
+             *  (`{ family?, pathTarget?: {param, aliases?, access, skillScopeEligible?}, renderHints?, ruleFace? }`)。
+             *  与 `source` 同一条规矩:**解析透明**(`z.unknown()`),形的校验属 core 摄入侧(不合 schema 的工具**不挂**并
+             *  通告一次 `config.tool_face_invalid`);本仓不复述那张表 —— 这一域 all-or-nothing,任一字段解析拒都会
+             *  让整套 mcp 服务器静默消失。缺席 = 不铸键。 */
+            toolFaces: z.ZodOptional<z.ZodUnknown>;
             notes: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             name: string;
@@ -10160,6 +10186,7 @@ export declare const DOMAIN_SCHEMAS: {
             allowTools?: string[] | undefined;
             contentOrigin?: "local" | "execution" | "external" | undefined;
             source?: unknown;
+            toolFaces?: unknown;
         }, {
             name: string;
             transport: {
@@ -10181,6 +10208,7 @@ export declare const DOMAIN_SCHEMAS: {
             elicitation?: boolean | undefined;
             contentOrigin?: "local" | "execution" | "external" | undefined;
             source?: unknown;
+            toolFaces?: unknown;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         servers: {
@@ -10204,6 +10232,7 @@ export declare const DOMAIN_SCHEMAS: {
             allowTools?: string[] | undefined;
             contentOrigin?: "local" | "execution" | "external" | undefined;
             source?: unknown;
+            toolFaces?: unknown;
         }[];
     }, {
         servers?: {
@@ -10227,6 +10256,7 @@ export declare const DOMAIN_SCHEMAS: {
             elicitation?: boolean | undefined;
             contentOrigin?: "local" | "execution" | "external" | undefined;
             source?: unknown;
+            toolFaces?: unknown;
         }[] | undefined;
     }>, {
         servers: {
@@ -10250,6 +10280,7 @@ export declare const DOMAIN_SCHEMAS: {
             allowTools?: string[] | undefined;
             contentOrigin?: "local" | "execution" | "external" | undefined;
             source?: unknown;
+            toolFaces?: unknown;
         }[];
     }, {
         servers?: {
@@ -10273,6 +10304,7 @@ export declare const DOMAIN_SCHEMAS: {
             elicitation?: boolean | undefined;
             contentOrigin?: "local" | "execution" | "external" | undefined;
             source?: unknown;
+            toolFaces?: unknown;
         }[] | undefined;
     }>;
     readonly plugins: z.ZodEffects<z.ZodObject<{

package/dist/types.js

@@ -1912,6 +1912,12 @@ export const McpServerSpec = z.object({
      *  both legs stripped it (default-strip object); this is the declaration half of the consumer-side fix
      *  (ticket B-036 / S-143), the projection half lives in the consumer. */
     source: z.unknown().optional(),
+    /** 1.9.0 —— core 7.8.0(design/388 片 1 F7)`toolFaces` 覆盖层:按远端工具名 key 的 face 声明
+     *  (`{ family?, pathTarget?: {param, aliases?, access, skillScopeEligible?}, renderHints?, ruleFace? }`)。
+     *  与 `source` 同一条规矩:**解析透明**(`z.unknown()`),形的校验属 core 摄入侧(不合 schema 的工具**不挂**并
+     *  通告一次 `config.tool_face_invalid`);本仓不复述那张表 —— 这一域 all-or-nothing,任一字段解析拒都会
+     *  让整套 mcp 服务器静默消失。缺席 = 不铸键。 */
+    toolFaces: z.unknown().optional(),
     notes: z.string().optional(),
 });
 export const McpConfig = z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/settings-schema",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Sema settings schema — pure config contract (zod domains + effective-config + roster resolution + ref-integrity + remoteExec) shared by sema-registry, sema-server, and the TOC desktop/CLI. One source of truth. (Renamed at 1.0.0 from @sema-agent/registry-core — name and docs only, no behavior change; note the range moves 0.19.0 -> 1.0.0, so a dependency must become ^1.0.0. The old names @sema-agent/registry-core <=0.19.0 and @sema-ai/registry-core remain published, frozen, for migration.)",
   "type": "module",
   "license": "BUSL-1.1",