@tbox.cn/app-toolkit 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @tbox.cn/app-toolkit
 
-tbox 应用**工具面**包（与 `@tbox.cn/app-sdk` 运行面/工具面对仗：sdk 给运行的应用用，toolkit 给操作应用的工具用——22 个工厂方法全部以 appDir 为首参）。
+tbox 应用**工具面**包（与 `@tbox.cn/app-sdk` 运行面/工具面对仗：sdk 给运行的应用用，toolkit 给操作应用的工具用——24 个工厂方法全部以 appDir 为首参（v4.4））。
 
 模块解析、集成配置求值/校验/写入内核。**contracts 求值与校验语义由应用自己的 `@tbox.cn/app-contracts` 版本动态驱动**（`core/contracts-resolver`）——沙箱镜像内 toolkit 与目标应用版本节奏解耦，呈现给用户的求值结果与写出的文件恒由应用自身 contracts 求值/校验。
 
@@ -41,7 +41,7 @@ views/         视图装配：modules / app / service-detail / service-resolutio
 | 层 | 载体 | 覆盖 |
 |---|---|---|
 | ① src 态守卫 | `tests/error-name-safety.test.ts` + 全测试矩阵（随 `pnpm -r test` 进根 verify 链） | 导出面/字面量约定/行为矩阵 |
-| ② minified dist 冒烟 | `pnpm --filter @tbox.cn/app-toolkit smoke:dist`（`scripts/smoke-dist.mjs`——纯 node：22 方法 typeof + AppToolkitError.name + resolver 命中 + file-cache 快测） | dist 产物直调（mangle 后） |
+| ② minified dist 冒烟 | `pnpm --filter @tbox.cn/app-toolkit smoke:dist`（`scripts/smoke-dist.mjs`——纯 node：24 方法 typeof + AppToolkitError.name + resolver 命中 + file-cache 快测） | dist 产物直调（mangle 后） |
 | ③ 发布形态门禁 | `pnpm --filter @tbox.cn/app-toolkit pack --check`（prepack 内建 build，tgz 内即 minified dist） | 打包完整性 |
 | ④ 跨仓 file: tgz 联调 | agtcodingbox 联调（`file:` tgz 消费——真实宿主） | 消费面全链路 |
 

package/dist/{chunk-VV3ERZXS.js → chunk-KPD3LUH4.js}

@@ -1 +1 @@
-import{existsSync as l,readdirSync as F,realpathSync as m}from"fs";import{join as c}from"path";import{pathToFileURL as w}from"url";import{existsSync as T,readFileSync as k,statSync as x}from"fs";function p(){let e=new Map,n=0;function r(t){if(!T(t))return null;let i=x(t);return`${i.mtimeMs}:${i.size}`}return{read(t,i){let o=r(t);if(o===null){e.delete(t);return}let s=e.get(t);if(s&&s.fingerprint===o)return s.value;n+=1;let a=i(k(t,"utf8"));return e.set(t,{fingerprint:o,value:a}),a},invalidate(t){if(t===void 0){e.clear();return}for(let i of t)e.delete(i)},get parseCount(){return n}}}var g=["resolveEffectiveService","buildSupplyLookup","moduleDomainOf","normalizeInstances","RESOURCE_TYPE_IDS"],M="parseIntegrationsConfig",v={version:null,evaluation:!1,strictValidation:!1,module:{},notes:[]};function C(e){let n=[e];for(let r of["apps","packages"]){let t=c(e,r);if(!l(t))continue;let i=F(t,{withFileTypes:!0}).filter(o=>o.isDirectory()).map(o=>o.name);r==="apps"?i.sort((o,s)=>o==="server"?-1:s==="server"?1:o.localeCompare(s)):i.sort((o,s)=>o.localeCompare(s));for(let o of i)n.push(c(t,o))}return n}var d=new Map,h=p();function y(e){return h.read(e,n=>{let r=JSON.parse(n);return typeof r.version=="string"?r.version:null})??null}function b(e){if(!l(e))return"gone";let n;try{n=m(e)}catch{n=e}return l(c(n,"dist","runtime.js"))?"dist":l(c(n,"src","runtime.ts"))?"src":"none"}function R(e){let n=c(e,"package.json");return{pkgPath:n,candidateDir:e,version:y(n),artifact:b(e)}}function E(e){for(let n of C(e)){let r=c(n,"node_modules","@tbox.cn","app-contracts"),t=c(r,"package.json");if(l(t))return{pkgPath:t,candidateDir:r,version:y(t),artifact:b(r)}}return null}function u(e){return e===null?"none":`${e.pkgPath}|${e.version??"null"}|${e.artifact}`}function $(e,n){let r=E(e);if(u(r)!==u(n.first))return!1;if(n.resolved===null)return!0;let t=r!==null&&r.candidateDir===n.resolved.candidateDir?r:R(n.resolved.candidateDir);return u(t)===u(n.resolved)}async function O(e,n){if(!l(e))return null;let r;try{r=m(e)}catch{return null}let i=[c(r,"dist","runtime.js"),c(r,"src","runtime.ts")].find(s=>l(s)),o=h.read(c(e,"package.json"),s=>{let a=JSON.parse(s);return typeof a.version=="string"?a.version:null})??null;if(i===void 0)return n.push(`contracts ${o??"(版本未知)"} 探测命中但无构建产物（dist/runtime.js 缺失）——workspace 源码态未构建：执行 pnpm --filter @tbox.cn/app-contracts build 后重试`),null;try{let s=o!==null?`?v=${encodeURIComponent(o)}`:"",a=await import(w(i).href+s),f=g.every(S=>a[S]!==void 0),P=a[M]!==void 0;return{version:o,evaluation:f,strictValidation:P,module:a,notes:f?[]:[`${i} 命中但求值面具名导出缺席（${g.join("/")}）——契约包形态异常`]}}catch(s){return n.push(`contracts ${o??"(版本未知)"} 构建产物导入失败（${s instanceof Error?s.message:String(s)}）——workspace 源码态未构建或产物损坏：执行 pnpm --filter @tbox.cn/app-contracts build 后重试`),null}}function U(e){let n=d.get(e);if(n&&$(e,n))return n.promise;let r=E(e),t={promise:Promise.resolve({...v}),first:r,resolved:r};return t.promise=(async()=>{let i=[];for(let o of C(e)){let s=c(o,"node_modules","@tbox.cn","app-contracts"),a=await O(s,i);if(a)return a.version!==null&&!a.strictValidation&&a.notes.push(`contracts ${a.version} 无严格校验面（需 ≥0.9）——升级应用 @tbox.cn/app-contracts 依赖后可用`),t.resolved=R(s),a}return t.resolved=null,i.length===0&&i.push("contracts 不可解析（未安装）——检查应用依赖安装后重试"),{...v,notes:i}})(),d.set(e,t),t.promise}function L(e){e===void 0?d.clear():d.delete(e)}export{p as a,U as b,L as c};
+import{existsSync as l,readdirSync as F,realpathSync as m}from"fs";import{join as c}from"path";import{pathToFileURL as w}from"url";import{existsSync as T,readFileSync as k,statSync as x}from"fs";function p(){let e=new Map,n=0;function r(t){if(!T(t))return null;let i=x(t);return`${i.mtimeMs}:${i.size}`}return{read(t,i){let o=r(t);if(o===null){e.delete(t);return}let s=e.get(t);if(s&&s.fingerprint===o)return s.value;n+=1;let a=i(k(t,"utf8"));return e.set(t,{fingerprint:o,value:a}),a},invalidate(t){if(t===void 0){e.clear();return}for(let i of t)e.delete(i)},get parseCount(){return n}}}var g=["resolveEffectiveService","buildSupplyLookup","moduleDomainOf","normalizeInstances","RESOURCE_TYPE_IDS"],M="parseIntegrationsConfig",v={version:null,evaluation:!1,strictValidation:!1,module:{},notes:[]};function C(e){let n=[e];for(let r of["apps","packages"]){let t=c(e,r);if(!l(t))continue;let i=F(t,{withFileTypes:!0}).filter(o=>o.isDirectory()).map(o=>o.name);r==="apps"?i.sort((o,s)=>o==="server"?-1:s==="server"?1:o.localeCompare(s)):i.sort((o,s)=>o.localeCompare(s));for(let o of i)n.push(c(t,o))}return n}var d=new Map,h=p();function y(e){return h.read(e,n=>{let r=JSON.parse(n);return typeof r.version=="string"?r.version:null})??null}function b(e){if(!l(e))return"gone";let n;try{n=m(e)}catch{n=e}return l(c(n,"dist","runtime.js"))?"dist":l(c(n,"src","runtime.ts"))?"src":"none"}function R(e){let n=c(e,"package.json");return{pkgPath:n,candidateDir:e,version:y(n),artifact:b(e)}}function E(e){for(let n of C(e)){let r=c(n,"node_modules","@tbox.cn","app-contracts"),t=c(r,"package.json");if(l(t))return{pkgPath:t,candidateDir:r,version:y(t),artifact:b(r)}}return null}function u(e){return e===null?"none":`${e.pkgPath}|${e.version??"null"}|${e.artifact}`}function $(e,n){let r=E(e);if(u(r)!==u(n.first))return!1;if(n.resolved===null)return!0;let t=r!==null&&r.candidateDir===n.resolved.candidateDir?r:R(n.resolved.candidateDir);return u(t)===u(n.resolved)}async function O(e,n){if(!l(e))return null;let r;try{r=m(e)}catch{return null}let i=[c(r,"dist","runtime.js"),c(r,"src","runtime.ts")].find(s=>l(s)),o=h.read(c(e,"package.json"),s=>{let a=JSON.parse(s);return typeof a.version=="string"?a.version:null})??null;if(i===void 0)return n.push(`contracts ${o??"(版本未知)"} 探测命中但无构建产物（dist/runtime.js 缺失）——workspace 源码态未构建：执行 pnpm --filter @tbox.cn/app-contracts build 后重试`),null;try{let s=o!==null?`?v=${encodeURIComponent(o)}`:"",a=await import(w(i).href+s),f=g.every(S=>a[S]!==void 0),P=a[M]!==void 0;return{version:o,evaluation:f,strictValidation:P,module:a,notes:f?[]:[`${i} 命中但求值面具名导出缺席（${g.join("/")}）——契约包形态异常`]}}catch(s){return n.push(`contracts ${o??"(版本未知)"} 构建产物导入失败（${s instanceof Error?s.message:String(s)}）——workspace 源码态未构建或产物损坏：执行 pnpm --filter @tbox.cn/app-contracts build 后重试`),null}}function U(e){let n=d.get(e);if(n&&$(e,n))return n.promise;let r=E(e),t={promise:Promise.resolve({...v}),first:r,resolved:r};return t.promise=(async()=>{let i=[];for(let o of C(e)){let s=c(o,"node_modules","@tbox.cn","app-contracts"),a=await O(s,i);if(a)return a.version!==null&&!a.strictValidation&&a.notes.push(`contracts ${a.version} 无严格校验面（需 ≥0.9.0）——升级应用 @tbox.cn/app-contracts 依赖后可用`),t.resolved=R(s),a}return t.resolved=null,i.length===0&&i.push("contracts 不可解析（未安装）——检查应用依赖安装后重试"),{...v,notes:i}})(),d.set(e,t),t.promise}function L(e){e===void 0?d.clear():d.delete(e)}export{p as a,U as b,L as c};

package/dist/contracts-resolver-E4SECBOG.js

@@ -0,0 +1 @@
+import{b as a,c as b}from"./chunk-KPD3LUH4.js";export{b as invalidateContractsResolver,a as resolveContractsForApp};

package/dist/index.d.ts

@@ -1171,6 +1171,7 @@ interface WalkCatalog {
     }>;
     credentialTypes: Record<string, {
         owner: string;
+        packageDir: string;
         credentialSchema?: string;
     }>;
 }
@@ -1463,14 +1464,12 @@ interface WriteCore {
     warmup(): Promise<void>;
     /** PUT /app/integration（root 节点全集） */
     applyApp(node: Record<string, unknown>, opts?: WriteOptions): SaveResult;
-    /** PUT /modules/:module/integration（domains 换算；N1 {} 删域键） */
+    /** PUT /modules/:module/integration（domains 换算；N1 {} 删域键；v4.4 D34 写守卫单源） */
     applyModule(moduleId: string, node: Record<string, unknown>, opts?: WriteOptions): SaveResult;
-    /** PUT /services/:service/integration（整节点含 instances map；N3 {} 不归一化） */
+    /** PUT /services/:service/integration（整节点含 instances map；N3 {} 不归一化；v4.4 A2 身份判据） */
     applyService(service: string, node: Record<string, unknown>, opts?: WriteOptions): SaveResult;
-    /** DELETE /services/:service/integration（恒整节点；幂等；无预演） */
+    /** DELETE /services/:service/integration（恒整节点；幂等仅判据内成员；无预演） */
     deleteService(service: string): SaveResult;
-    /** 模块服务域键（module → domains 键 = 服务集派生域键集 upsert 位） */
-    moduleDomainKey(moduleId: string): string | undefined;
 }
 declare function createWriteCore(appDir: string, opts?: WriteCoreOptions): WriteCore;
 
@@ -1511,7 +1510,10 @@ declare class AppToolkitError extends Error {
     readonly fields?: string[];
     constructor(code: AppToolkitErrorCode, httpStatus: number, message: string, fields?: string[]);
 }
-/** CONTRACTS_NOT_RESOLVED 三分支 message（N1 构建指引——api.md 错误信封示例） */
+/** CONTRACTS_NOT_RESOLVED message（N1 构建指引——api.md 错误信封示例）。
+ *  P-4：notes 优先——resolver 在全部不可解析路径均已 push 携带操作指引的 notes（导入失败/
+ *  产物缺失/未安装/<0.9 升级）；现行 version===null 分支会把 notes 内细分指引吞成通用文案。
+ *  三分支保留为兜底（防御性——正常路径 notes 恒非空）。 */
 declare function contractsNotResolvedMessage(contracts: {
     version: string | null;
     strictValidation: boolean;
@@ -1540,28 +1542,61 @@ interface ModuleDeclaration {
     title: string;
     description: string;
 }
-/** 服务需求声明（模块 demand 单元；defaults 唯一落位 ServiceDetail） */
+/** 服务需求声明（模块 demand 单元 / 平台服务条目——v4.4 D29 双端点同型；defaults 唯一落位 ServiceDetail） */
 interface ServiceDemand {
     service: string;
     /** manifest demand meta；缺席 UI 回退 service id */
     title?: string;
     description?: string;
-    /** demand optional !== false（多模块 OR 聚合见 resolution echo） */
+    /** demand optional === false（多模块 OR 聚合见 resolution echo；平台服务条目恒 false） */
     required: boolean;
 }
 /** GET /modules/:module（模块静态一站式 · PUT 读对偶） */
 interface ModuleDetailView {
-    /** domains[换算键] 节点原值；未配置 = null */
+    /** v4.4 D34：demand 服务首段去重（排序；1..N；零域 = []） */
+    domainKeys: string[];
+    /** domains[换算键] 节点原值；未配置 = null；v4.4 D34：仅单域（writable）时在场——多域/零域/共享键无单键落点 */
     integration: ModuleIntegrationNode | null;
+    /** v4.4 D34：每域一条厂商绑定解析（单域 = 单元素；零域 = []；resolveDomainBinding 单源） */
+    providerBindings: ProviderBinding[];
+    /** v4.4 D34：单域 && 域键无跨模块共享（moduleDomainWritable 单源——读标志与写守卫共用） */
+    configEditable: boolean;
     /** 本模块 demand（卡片展开 + 编辑器静态上下文自足） */
     services: ServiceDemand[];
+    /** v4.4 D31：include=serviceResolutions 内嵌（demand 服务过滤 ≡ 批量 ?service= 语义；<0.9/形态异常 → null——永不 503） */
+    serviceResolutions?: ServiceResolutionsView | null;
+    /** v4.4 D32：include=integrationSchemas 层级富化（多域/零域/共享键/未绑定 → null） */
+    integrationSchemas?: LayerIntegrationSchemas | null;
+}
+/** 模块域厂商绑定解析（v4.4 D34——静态文件事实；规则 ≡ 谓词 #7 域级，resolveDomainBinding 单源） */
+interface ProviderBinding {
+    /** 域键（= domainKeys 成员；多域模块每域一条） */
+    domain: string;
+    /** domains[domain].provider ?? root.provider（双缺 = null） */
+    effective: string | null;
+    /** 生效来源层（双缺 = null） */
+    layer: 'module' | 'app' | null;
+}
+/** 层级 config schema 计算（v4.4 D32——静态轴富化，零 contracts） */
+interface LayerIntegrationSchemas {
+    /** 层生效厂商（resolveDomainBinding 单源） */
+    provider: string;
+    /** 模块级 = 本模块 demand ∩ 该厂商供给；应用级 = 供给足迹全量（configSchema = raw draft 2020-12 原文；供给在场未声明 = null） */
+    services: Record<string, {
+        configSchema: object | null;
+    }>;
 }
 /** GET /app（应用静态视图：平台服务 + root 原值） */
 interface AppView {
-    /** 平台服务 id（服务词汇 − 模块占用；owner/标题 UI 按首点段派生） */
-    services: string[];
+    /** 平台服务（v4.4 D29：服务词汇 − 模块占用——与模块 demand 同型 ServiceDemand[]；
+     *  title/description 缺席 = UI 回退 service id；required 恒 false——平台服务无 demand 源） */
+    services: ServiceDemand[];
     /** root 节点原值；文件缺席 = null */
     integration: AppIntegrationNode | null;
+    /** v4.4 D31：include=serviceResolutions 内嵌（全量键集 ≡ 批量无参；<0.9/形态异常 → null——永不 503） */
+    serviceResolutions?: ServiceResolutionsView | null;
+    /** v4.4 D32：include=integrationSchemas 层级富化（root.provider 缺席 → null） */
+    integrationSchemas?: LayerIntegrationSchemas | null;
 }
 /** GET /services/:service（服务静态单体） */
 interface ServiceDetail extends ServiceDemand {
@@ -1591,6 +1626,9 @@ interface ServiceResolutionEntry {
     statusMessage?: string;
     /** 最特异声明层厂商名（跨层事实） */
     provider?: string;
+    /** v4.4：provider 来源声明层（默认实例口径，与 status 同轴）；恒 = provider 字段来源层
+     *  （ok/binding-unresolved 取声明层；未配置双缺席）；≡ 单体 inheritance 链逆序首个有 provider 的层 */
+    layer?: BindingLayer;
     /** provider 在场时在场：(provider, service) ∈ 供给关系 */
     supplied?: boolean;
     /** owner 模块 install id；平台服务/孤儿缺席 */
@@ -1678,8 +1716,6 @@ interface ResolvedInstance {
     statusMessage?: string;
     /** 该实例合并结果 */
     effective?: EffectiveBinding;
-    /** 掩码回显 */
-    credential?: CredentialEcho;
 }
 /** GET /providers：厂商基本信息 */
 interface ProvidersView {
@@ -1704,24 +1740,53 @@ interface ProviderDetail {
             implementation: string;
             credentialType: string;
         }>;
+        /** v4.4 F5：include=integrationSchemas 切换态批量（纯 config——凭据结构归 /credential-types） */
+        integrationSchemas?: {
+            configSchema: object | null;
+        };
     }>;
 }
 /** GET /providers/:p/services/:s：表单 schema 唯一暴露面 */
 interface ProviderServiceDetail {
     provider: string;
     service: string;
-    /** ★ 恒数组（通常 1） */
+    /** ★ 恒数组（通常 1）；credentialType 保留（/credential-types 寻址键） */
     implementations: Array<{
         implementation: string;
         credentialType: string;
     }>;
-    /** 厂商集成该服务的表单 schema（integration 域专属） */
+    /** 厂商集成该服务的表单 schema（integration 域专属）——v4.4 D33 纯 config（credentialSchema 删净） */
     integrationSchemas: {
         /** raw draft 2020-12 原文零转换；供给在场未声明 = null（mock 合法）；解析自默认 impl */
         configSchema: object | null;
-        credentialSchema: object | null;
     };
 }
+/** GET /credentials：绑定位全量掩码回显（应用状态轴；GET 永无真值） */
+interface CredentialsView {
+    /** root 位；byInstance 键集 = 注册表 ids ∩ 有 ref（无 ref 的注册实例不出现；未注册 ref 跳过不虚报） */
+    app: CredentialBindingEcho;
+    /** 键集 = 已配置服务；byInstance 键集 = 节点 instances map 全键（含 '*'）——键域不对称 = 文件语义忠实镜像 */
+    services: Record<string, CredentialBindingEcho>;
+}
+/** 一个形状两处（镜像文件层「标量 + ByInstance」模式） */
+interface CredentialBindingEcho {
+    /** 本位 credentialRef（root.credentialRef / services[s].credentialRef）；ref 缺席/文件缺失 → null */
+    credential: CredentialEcho | null;
+    /** 覆盖位（credentialRefByInstance / instances[k].credentialRef） */
+    byInstance: Record<string, CredentialEcho | null>;
+}
+/** GET /credential-types[?provider=]：凭据结构清单（供给轴静态；?provider= 过滤语义 ≡ ?service=） */
+interface CredentialTypesView {
+    types: CredentialTypeEntry[];
+}
+interface CredentialTypeEntry {
+    /** '-' = 无凭据语义（mock/local——UI 判 '-' 不渲染凭据表单） */
+    credentialType: string;
+    /** 声明来源包名 */
+    owner: string;
+    /** raw draft 2020-12 原文；未声明 = null（ExtraFields 自由键值同轨） */
+    credentialSchema: object | null;
+}
 interface EffectiveBinding {
     /** custom 时 provider = 内联声明厂商名 */
     provider: string;
@@ -1761,7 +1826,7 @@ interface IntegrationIssue {
 
 /**
  * 视图装配共享上下文（五投影共用；目录枚举零缓存——walkManifests 每次调用执行）。
- * 域前缀换算（service → 首点段）= 本地一行 helper（文件格式词汇，静态面零 contracts 依赖）。
+ * 域前缀换算（service → 首点段）自 v4.4 F1 迁 integrations/domain-binding.ts（本文件 re-export 保导入路径）。
  */
 interface ViewContext {
     appDir: string;
@@ -1778,20 +1843,21 @@ interface ViewSnapshot {
 /**
  * 需求轴/模块静态投影（views/modules；C4）。静态端点结构性零求值（铁律 #3——
  * 无 resolution/issues/contracts 键，永不 503）。
+ * v4.4 D34：domainKeys/providerBindings/configEditable 显式化；integration 仅单域
+ * （writable）时在场——多域/零域/共享键无单键落点；多域回退兜底键机器拆除
+ * （派生统一 = domainOfService 去重集合，moduleDomainWritable 单源）。
  */
 /** GET /modules：纯模块清单（demand 不在——卡片展开 = GET /modules/:m） */
 declare function loadModulesView(snapshot: ViewSnapshot): {
     modules: ModuleDeclaration[];
 };
-/** 域键换算（模块服务集派生域键集；单域 = 该域，多域/零域 = 模块 id——与 write.moduleDomainKey 同约定） */
-declare function moduleDomainKeyOf(services: ServiceDemand[], moduleId: string): string;
 /** GET /modules/:module：模块静态一站式（integration 节点原值 + demand；PUT 读对偶） */
 declare function loadModuleDetailView(snapshot: ViewSnapshot, moduleId: string): ModuleDetailView;
 
 /**
- * 应用静态投影（views/app；C4；FX-1c B10——root 节点投影修）。
- * /app = 平台服务 + root 节点原值（纯静态，D12）：
- * services = 服务词汇 − 模块占用（裸 string[]——owner/标题 UI 按首点段派生，F2）；
+ * 应用静态投影（views/app；C4；FX-1c B10——root 节点投影修；v4.4 D29——services 双端点同型）。
+ * /app = 平台服务 + root 节点原值（纯静态）：services = 服务词汇 − 模块占用
+ * （ServiceDemand[]——平台条目 required 恒 false、title/description 缺席，D29）；
  * 平台服务状态不在此（→ /service-resolutions）；模块服务不在此（→ /modules/:m）。
  * integration = **root 节点投影**（APP_INTEGRATION_NODE_KEYS——D21/L1：GET 预填 ≡ PUT body；
  * 文件另含 services/domains/modules 域键，不进 root 节点投影——原实现整文件透传，
@@ -1813,8 +1879,9 @@ declare function loadServiceDetailView(snapshot: ViewSnapshot, service: string):
  */
 /** GET /providers：厂商基本信息（供给足迹不在本端点 → /providers/:p） */
 declare function loadProvidersView(snapshot: ViewSnapshot): ProvidersView;
-/** GET /providers/:provider：供给足迹（implementations 恒数组——H1 多实现钉版数据源） */
-declare function loadProviderDetailView(snapshot: ViewSnapshot, provider: string): ProviderDetail;
+/** GET /providers/:provider：供给足迹（implementations 恒数组——H1 多实现钉版数据源；
+ *  v4.4 F5：include=integrationSchemas 切换态批量——services[s] += { configSchema }（纯 config）） */
+declare function loadProviderDetailView(snapshot: ViewSnapshot, provider: string, include?: ReadonlySet<string>): ProviderDetail;
 /** 组合单体（GET /providers/:p/services/:s）：catalog 供给与槽级内联声明统一解析（P10/P11） */
 declare function loadProviderServiceDetailView(snapshot: ViewSnapshot, provider: string, service: string): ProviderServiceDetail;
 
@@ -1826,15 +1893,63 @@ declare function loadServiceResolutionsView(snapshot: ViewSnapshot, issues: Inte
 declare function loadServiceResolutionDetail(service: string, snapshot: ViewSnapshot, allIssues: IntegrationIssue[]): ServiceResolutionDetail;
 
 /**
- * createAppToolkit（C4 工厂）：22 方法 = 9 读（HTTP 直通）+ 4 写（HTTP 直通）+ 9 迁移面（Internals）。
+ * 层级 config schema 计算视图（v4.4 D32——静态轴富化，零 contracts 求值）。
+ * config 表单结构三形态同源（P10）：槽级组合单体（providers.ts）/ 层级内嵌（本文件——
+ * /app、/modules/:m include）/ 供给轴批量（providers.ts include——切换态）。
+ *
+ * 计算规则（D32 裁决）：禁交集——config 五层浅合并下「部分服务认识的字段」合法（谓词 #7
+ * 并集键集同依据）；禁合成单一 schema——required/title 冲突的有损代数；产物 = 扁平映射，
+ * 分组归客户端纯呈现。层级 schema = 表单引导**非写入门禁**（P16——写路径校验权威恒在谓词
+ * #7 键集 + ajv 凭据链；root 级口径差：#7 = 引用厂商并集，表单 = 层生效厂商单厂商作用域）。
+ */
+/** 核心纯函数：显式作用域（provider null → 整字段 null；services 逐项 serviceSchemas 复合键 +
+ *  readSchemaRef——既有解析路径零新读；供给在场未声明 = null，mock 合法） */
+declare function resolveLayerIntegrationSchemas(snapshot: ViewSnapshot, provider: string | null, services: readonly string[]): LayerIntegrationSchemas | null;
+/** app 级 loader：生效厂商 = root.provider（非空字符串，缺席 → 整字段 null——D32「未绑定」）；
+ *  作用域 = 该厂商供给足迹全量（≠ AppView.services——root.config 流向包括模块服务在内的所有服务） */
+declare function loadAppIntegrationSchemas(snapshot: ViewSnapshot): LayerIntegrationSchemas | null;
+/** module 级 loader：仅 writable 单域；生效厂商 = resolveDomainBinding（D32/R4 单源）；
+ *  作用域 = demand ∩ 该厂商供给；多域/零域/共享键/未绑定 → 整字段 null（表单降级 = ExtraFields） */
+declare function loadModuleIntegrationSchemas(snapshot: ViewSnapshot, moduleId: string): LayerIntegrationSchemas | null;
+
+/**
+ * 凭据状态轴投影（views/credentials；v4.4 D33 独立端点 GET /credentials）：
+ * 绑定位全量掩码回显——应用状态轴（随配置失效、零求值零 contracts、永不 503）。
+ * GET 永无真值（仅 ref/masked）；掩码单源 maskCredentialValues；echoForRef 自
+ * service-resolutions 迁入共享（求值单体 instances[].credential 已删净——求值路径零凭据 I/O）。
+ *
+ * 键集 = 文件语义忠实镜像（api.md §0「键域不对称」）：
+ *   app.byInstance        = 注册表 ids ∩ 有 ref（无 ref 的注册实例不出现；未注册 ref 跳过不虚报）
+ *   services[s].byInstance = 节点 instances map 全键（含 '*'，无 ref 亦在场 → null）
+ * null 语义：credential/byInstance 值 = 「未就绪」（ref 缺席或文件缺失）——缺失诊断归谓词 #1
+ * （CREDENTIAL_FILE_MISSING），echo = 状态回显、issues = 诊断定位（P16 分工）。
+ */
+/** 凭据文件掩码回显（ref 非 secret:// 或文件缺席 → undefined——调用方映射 null） */
+declare function echoForRef(appDir: string, ref: string | undefined): CredentialEcho | undefined;
+declare function loadCredentialsView(snapshot: ViewSnapshot): CredentialsView;
+
+/**
+ * 供给轴凭据结构清单（views/credential-types；v4.4 D33 独立端点 GET /credential-types[?provider=]）：
+ * 结构按 credentialType 键（wanda 全部槽共享同一 type 同一 schema 文件——(provider, service)
+ * 组合寻址是错位键）；源 = catalog.credentialTypes（既有聚合产物零新读取路径，聚合条目携
+ * packageDir 供 schema 文件解析）。静态轴（稳定可缓存、永不 503）。
+ * ?provider= 过滤 ≡ ?service= 先例（过滤非寻址；未知 provider → 空 types 不 404）。
+ * '-' = 无凭据语义（mock/local——UI 判 '-' 不渲染凭据表单）；credentialSchema null = 未声明。
+ */
+declare function loadCredentialTypesView(snapshot: ViewSnapshot, provider?: string): CredentialTypesView;
+
+/**
+ * createAppToolkit（C4 工厂；v4.4——24 方法 = 11 读（含 credentials/credential-types 双端点）
+ * + 4 写 + 9 迁移面；loadApp/loadModule/loadProvider 增 include 选项）。
  * AppToolkit = AppToolkitRead & AppToolkitWrite & AppToolkitInternals——
  * Read+Write = HTTP 直通面 additive 冻结（L1 端点↔方法 1:1，L3 命名镜像：Integration=节点级 /
  * Config=文件级）；Internals = CLI/doctor/桥消费（自由演进）。
  *
  * **门控断言单点（policy at edge）**：求值（2）+ 写（4）+ ensureMockBindings / writeIntegrationsConfig /
  * evaluateIntegrationServices 入口 assertContractsUsable——strictValidation === false → 503
- * CONTRACTS_NOT_RESOLVED（message 三分支）；静态方法不门控（永不 503——铁律 #3）；
- * integrations/ views/ 机制层保持纯函数。
+ * CONTRACTS_NOT_RESOLVED；静态方法不门控（永不 503——铁律 #3）；**include 装配为条件分支非门控**
+ * （D31——serviceResolutions 按 evaluation && strictValidation 双条件装配，<0.9/形态异常 → null，
+ * 静态端点永不 503；integrationSchemas 纯静态轴零 contracts）；integrations/ views/ 机制层保持纯函数。
  *
  * 并发：进程内写串行（per-factory promise chain）+ 原子写 + 写后本实例缓存即刻失效（D26）。
  * onApplied（D7）：toolkit 判定「需要重启」（实际落盘且非 dryRun/no-diff）→ 调用一次 +
@@ -1844,17 +1959,27 @@ interface AppToolkitOptions {
     /** 写成功（实际落盘且非 dryRun/no-diff）→ 调用一次（宿主闭包内防抖/守卫）；CLI 不传恒 false */
     onApplied?: () => void;
 }
-/** ── HTTP 直通面（9 读；L1 镜像律：方法名 = load + URL 资源段）── */
+/** ── HTTP 直通面（11 读；L1 镜像律：方法名 = load + URL 资源段；query → 选项字段 L4）── */
 interface AppToolkitRead {
     loadModules(): Promise<ModulesView>;
-    loadModule(moduleId: string): Promise<ModuleDetailView>;
-    loadApp(): Promise<AppView>;
+    loadModule(moduleId: string, o?: {
+        include?: string[];
+    }): Promise<ModuleDetailView>;
+    loadApp(o?: {
+        include?: string[];
+    }): Promise<AppView>;
     loadService(service: string): Promise<ServiceDetail>;
     loadServiceResolutions(services?: string[]): Promise<ServiceResolutionsView>;
     loadServiceResolution(service: string): Promise<ServiceResolutionDetail>;
     loadProviders(): Promise<ProvidersView>;
-    loadProvider(provider: string): Promise<ProviderDetail>;
+    loadProvider(provider: string, o?: {
+        include?: string[];
+    }): Promise<ProviderDetail>;
     loadProviderService(provider: string, service: string): Promise<ProviderServiceDetail>;
+    /** GET /credentials（v4.4 D33——应用状态轴；零门控，永不 503） */
+    loadCredentials(): Promise<CredentialsView>;
+    /** GET /credential-types[?provider=]（v4.4 D33——供给轴静态；零门控，永不 503） */
+    loadCredentialTypes(provider?: string): Promise<CredentialTypesView>;
 }
 /** ── HTTP 直通面（4 写；body ≡ 文件节点全量替换；DELETE 无 dryRun/无 options）── */
 interface AppToolkitWrite {
@@ -1906,4 +2031,4 @@ interface AppToolkitInternals {
 type AppToolkit = AppToolkitRead & AppToolkitWrite & AppToolkitInternals;
 declare function createAppToolkit(appDir: string, options?: AppToolkitOptions): AppToolkit;
 
-export { APP_INTEGRATION_NODE_KEYS, type AppIntegrationNode, type AppManifest, type AppManifestFull, type AppToolkit, AppToolkitError, type AppToolkitErrorCode, type AppToolkitInternals, type AppToolkitOptions, type AppToolkitRead, type AppToolkitWrite, type AppView, type AppliedCredential, type BindingLayer, type BridgeProviderCatalog, type CardContrib, type ContractsResolution, type CredentialEcho, type CredentialFile, type CredentialInput, type CredentialValues, type DeclaredModuleInfo, type EffectiveBinding, type EnvExpansionResult, type EvaluationExports, type FileCache, type InlineVendorDeclaration, type IntegrationIssue, type IntegrationServiceIssue, type IntegrationServicePredicateInput, type MiniappContainerEntry, type MockBindingsResult, type ModuleDeclaration, type ModuleDescriptor, type ModuleDetailView, type ModuleIntegrationNode, type ModuleMode, type ModulesView, type NpmModuleEntry, type OrphanIssue, type ParseModuleResult, type PlannedCredential, type PredicateAssembly, type PredicateContracts, type PredicateIoInputs, type ProviderDetail, type ProviderEntry, type ProviderServiceDetail, type ProviderServiceSchemas, type ProviderServiceSchemasResult, type ProviderSlotContrib, type ProvidersView, type ReadIntegrationsResult, type ResolvedContracts, type ResolvedInstance, type ResolvedModule, type ResourceNeedContrib, SAFE_NAME_PATTERN, type SaveResult, type ServiceDemand, type ServiceDetail, type ServiceInstanceNode, type ServiceIntegrationNode, type ServiceNeedContrib, type ServiceResolution, type ServiceResolutionDetail, type ServiceResolutionEntry, type ServiceResolutionsView, type ServiceStatus, type StemInput, type SupplyLookup, type ViewContext, type ViewSnapshot, type WalkCatalog, type WalkManifestsResult, type WalkModuleInfo, type WalkProviderEntry, type WriteCore, type WriteCoreOptions, type WriteOptions, assertValidModuleId, buildPredicateAssembly, checkInstanceKeys, collectDeclaredModules, contractsNotResolvedMessage, createAppToolkit, createFileCache, createWriteCore, credentialArtifactExists, deepEqual, deriveStem, ensureDir, ensureMockBindings, evaluateIntegrationServices, expandEnvVars, extractModuleIdFromSource, invalidateContractsResolver, isControlledInlineProvider, isValidModuleId, loadAppView, loadModuleDetailView, loadModulesView, loadProviderCatalog, loadProviderCatalogRaw, loadProviderDetailView, loadProviderServiceDetailView, loadProvidersView, loadServiceDetailView, loadServiceResolutionDetail, loadServiceResolutionsView, manifestPath, maskCredentialValues, moduleDependencySchema, moduleDescriptorSchema, moduleDomainKeyOf, pageContribSchema, parseModuleDescriptor, providerSlotContribSchema, readAppManifest, readAppManifestFull, readCredentialFile, readIntegrationsConfig, readIntegrationsStrict, reconcileOrphanCredentials, refToEnvKey, removeNpmModule, resolveContractsForApp, resolveContractsForApp as resolveContractsForAppExport, resolveServiceSummary, resourceNeedContribSchema, serviceNeedContribSchema, stemToFilePath, stemToRef, tabContribSchema, updateNpmModule, upsertMiniappContainer, upsertNpmModule, walkManifests, writeAppManifest, writeAtomic, writeCredentialFile };
+export { APP_INTEGRATION_NODE_KEYS, type AppIntegrationNode, type AppManifest, type AppManifestFull, type AppToolkit, AppToolkitError, type AppToolkitErrorCode, type AppToolkitInternals, type AppToolkitOptions, type AppToolkitRead, type AppToolkitWrite, type AppView, type AppliedCredential, type BindingLayer, type BridgeProviderCatalog, type CardContrib, type ContractsResolution, type CredentialBindingEcho, type CredentialEcho, type CredentialFile, type CredentialInput, type CredentialTypeEntry, type CredentialTypesView, type CredentialValues, type CredentialsView, type DeclaredModuleInfo, type EffectiveBinding, type EnvExpansionResult, type EvaluationExports, type FileCache, type InlineVendorDeclaration, type IntegrationIssue, type IntegrationServiceIssue, type IntegrationServicePredicateInput, type LayerIntegrationSchemas, type MiniappContainerEntry, type MockBindingsResult, type ModuleDeclaration, type ModuleDescriptor, type ModuleDetailView, type ModuleIntegrationNode, type ModuleMode, type ModulesView, type NpmModuleEntry, type OrphanIssue, type ParseModuleResult, type PlannedCredential, type PredicateAssembly, type PredicateContracts, type PredicateIoInputs, type ProviderBinding, type ProviderDetail, type ProviderEntry, type ProviderServiceDetail, type ProviderServiceSchemas, type ProviderServiceSchemasResult, type ProviderSlotContrib, type ProvidersView, type ReadIntegrationsResult, type ResolvedContracts, type ResolvedInstance, type ResolvedModule, type ResourceNeedContrib, SAFE_NAME_PATTERN, type SaveResult, type ServiceDemand, type ServiceDetail, type ServiceInstanceNode, type ServiceIntegrationNode, type ServiceNeedContrib, type ServiceResolution, type ServiceResolutionDetail, type ServiceResolutionEntry, type ServiceResolutionsView, type ServiceStatus, type StemInput, type SupplyLookup, type ViewContext, type ViewSnapshot, type WalkCatalog, type WalkManifestsResult, type WalkModuleInfo, type WalkProviderEntry, type WriteCore, type WriteCoreOptions, type WriteOptions, assertValidModuleId, buildPredicateAssembly, checkInstanceKeys, collectDeclaredModules, contractsNotResolvedMessage, createAppToolkit, createFileCache, createWriteCore, credentialArtifactExists, deepEqual, deriveStem, echoForRef, ensureDir, ensureMockBindings, evaluateIntegrationServices, expandEnvVars, extractModuleIdFromSource, invalidateContractsResolver, isControlledInlineProvider, isValidModuleId, loadAppIntegrationSchemas, loadAppView, loadCredentialTypesView, loadCredentialsView, loadModuleDetailView, loadModuleIntegrationSchemas, loadModulesView, loadProviderCatalog, loadProviderCatalogRaw, loadProviderDetailView, loadProviderServiceDetailView, loadProvidersView, loadServiceDetailView, loadServiceResolutionDetail, loadServiceResolutionsView, manifestPath, maskCredentialValues, moduleDependencySchema, moduleDescriptorSchema, pageContribSchema, parseModuleDescriptor, providerSlotContribSchema, readAppManifest, readAppManifestFull, readCredentialFile, readIntegrationsConfig, readIntegrationsStrict, reconcileOrphanCredentials, refToEnvKey, removeNpmModule, resolveContractsForApp, resolveContractsForApp as resolveContractsForAppExport, resolveLayerIntegrationSchemas, resolveServiceSummary, resourceNeedContribSchema, serviceNeedContribSchema, stemToFilePath, stemToRef, tabContribSchema, updateNpmModule, upsertMiniappContainer, upsertNpmModule, walkManifests, writeAppManifest, writeAtomic, writeCredentialFile };