@tbox.cn/app-toolkit 0.8.4 → 0.8.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1499,6 +1499,10 @@ interface IntegrationIssue {
1499
1499
  * 零声明厂商整体跳过——#7 同遍历双判定)
1500
1500
  * MALL_IDENTITY_IN_CONFIG_SCHEMA #18 warning 引用厂商 configSchema 声明商场身份键 mallId
1501
1501
  * (身份恒来自会话 scope——词表克制只拦精确键)
1502
+ * BINDING_SHADOWED v6.2 warning 槽级显式绑定与继承默认(modules[owner]/root)异值——
1503
+ * 槽级压过高层绑定(层序 inst > slot > modules > root),
1504
+ * 接入切换残留未剥离则高层绑定静默失效;同值 = 显式钉版
1505
+ * 静默;实例级覆盖零参与(per-instance 路由是设计特性)
1502
1506
  * ORPHANED_CREDENTIAL 写后对账 warning 凭据文件不再被引用(toolkit 写路径产出,非本谓词)
1503
1507
  * (v6 退役:DOMAIN_KEY_UNMATCHED #14——domains 键随归属模型退场)
1504
1508
  *
package/dist/index.js CHANGED
@@ -1,9 +1,9 @@
1
- import{a as Be,b as se,c as N,d as We}from"./chunk-K5FIGT5A.js";import{z as k}from"zod";var z=/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/,bt=k.object({cardType:k.string(),schemaVersion:k.number().optional()}),bn=k.object({route:k.string(),component:k.string()}),An=k.object({route:k.string(),label:k.string().optional(),icon:k.string().optional(),order:k.number().optional()}),Cn=k.object({id:k.string(),range:k.string().optional(),required:k.boolean().default(!0)}),En=k.object({service:k.string(),provider:k.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:k.string(),credentialType:k.string(),local:k.boolean().optional(),configSchema:k.string().optional(),credentialSchema:k.string().optional()}),On=k.object({service:k.string(),optional:k.boolean().default(!0),defaults:k.array(k.object({provider:k.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:k.string()})).default([]),name:k.string().optional(),description:k.string().optional()}),xn=k.object({service:k.string()}).strict(),Mn=k.object({id:k.string(),type:k.string()}),jn=k.object({$comment:k.union([k.string(),k.record(k.string(),k.unknown())]).optional(),$schema:k.string().optional(),schemaVersion:k.number().default(1),id:k.string(),name:k.string().optional(),description:k.string().optional(),hidden:k.boolean().optional(),version:k.string().default("0.0.0"),kind:k.enum(["platform","business","third-party"]).default("business"),risk:k.object({level:k.enum(["high","medium","low"]).default("low"),writeBoundary:k.enum(["sdk-enforced","source"]).default("source")}).default({}),distribution:k.object({defaultMode:k.enum(["hybrid","sdk","codegen","local"]).default("codegen")}).default({}),declare:k.object({handlers:k.array(k.string()).default([]),tools:k.array(k.string()).default([]),cards:k.array(bt).default([]),routes:k.array(k.string()).default([]),pages:k.array(bn).default([]),tabs:k.array(An).default([]),providers:k.object({id:k.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)").optional(),slots:k.array(En).default([])}).default({}),owns:k.array(xn).default([]),consumes:k.array(On).default([]),resources:k.array(Mn).default([])}).default({}),dependencies:k.object({modules:k.array(Cn).default([])}).default({}),env:k.array(k.string()).default([])}).strict();function At(e){if(!e||typeof e!="object"||Array.isArray(e))return[];let n=[],r=e;"contributes"in r&&n.push("(root): manifest 旧键 `contributes` 已更名 `declare`(v6 声明面)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let t=r.declare;t&&typeof t=="object"&&!Array.isArray(t)&&"services"in t&&n.push("declare: manifest 旧键 `declare.services` 已更名 `declare.consumes`(消费关系定向化)——同上三路径升级"),!("id"in r)&&"name"in r&&n.push("(root): manifest 标识键 `name` 已更名 `id`(v7 词汇统一)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let i=t&&typeof t=="object"&&!Array.isArray(t)?t:void 0,o=Array.isArray(i?.consumes)&&i.consumes.some(s=>s!==null&&typeof s=="object"&&"title"in s);return("title"in r||o)&&n.push("(root): manifest 展示名键 `title` 已更名 `name`(v7 词汇统一;declare.consumes[].title 同步改 name)——同上三路径升级"),n}function ae(e){let n=At(e);if(n.length>0)return{ok:!1,errors:n,legacy:!0};let r=jn.safeParse(e);return r.success?{ok:!0,value:r.data}:{ok:!1,errors:r.error.issues.map(t=>`${t.path.join(".")||"(root)"}: ${t.message}`)}}var Ct=/\$\$?\{([A-Z][A-Z0-9_]*)(?::-([^}]*))?\}/g;function Tn(e){return JSON.stringify(e).slice(1,-1)}function Ue(e,n=process.env){let r=[],t=e.replace(Ct,(i,o,s)=>{if(i.startsWith("$$"))return i.slice(1);let d=n[o];return d!==void 0?Tn(d):s!==void 0?Tn(s):(r.push(o),i)});return r.length>0?{missing:r}:{text:t,missing:[]}}import{mkdirSync as Et,existsSync as Nn,readFileSync as Ot,writeFileSync as xt}from"fs";import{dirname as Mt,join as Pn}from"path";function we(e){let n={};for(let[r,t]of Object.entries(e)){if(typeof t!="string"){n[r]=null;continue}n[r]=t.length<=4?"****":`${t.slice(0,2)}****`}return n}var E=class extends Error{code;httpStatus;fields;constructor(n,r,t,i){super(t),this.name="AppToolkitError",this.code=n,this.httpStatus=r,this.fields=i}};function B(e){return e.notes.length>0?e.notes[0]:e.version===null?"contracts 不可解析(未安装)——检查应用依赖安装后重试":e.strictValidation?e.ownershipBindingV6===!1?`contracts ${e.version??"(版本未知)"} 不支持 v6 modules 绑定形状(OWNERSHIP_BINDING_V6 标记缺席)——升级应用 @tbox.cn/app-contracts 依赖后可用`:"contracts workspace 源码态未构建——执行 pnpm --filter @tbox.cn/app-contracts build 后重试":`contracts ${e.version} 无严格校验面(需 ≥0.9.0)——升级应用 @tbox.cn/app-contracts 依赖后可用`}function he(e,n){if(n!==void 0&&(n.includes("/")||n.includes("\\")||n.includes("..")))throw new E("VALIDATION_FAILED",400,`凭据 stem 派生输入含路径敌对字符(${e})——拒绝派生`)}function Q(e){if(he("provider",e.provider),he("service",e.service),he("instanceId",e.instanceId),he("domain",e.domain),e.instanceId!==void 0){let n=e.domain??e.service??"global";return`${e.provider}-${e.instanceId}-${n}`}return e.service!==void 0?`${e.provider}-${e.service}`:`${e.provider}-global`}function jt(e){return`secret://${e}`}function W(e){return`config/credentials/${e}.json`}function ce(e,n){let r=Pn(e,W(n));if(!Nn(r))return null;try{let t=JSON.parse(Ot(r,"utf8"));if(typeof t.type!="string")return null;let{type:i,...o}=t,s={};for(let[d,y]of Object.entries(o))typeof y=="string"&&(s[d]=y);return{type:i,values:s}}catch{return null}}function Ke(e,n,r){let t=Pn(e,W(n)),i=Nn(t);return Et(Mt(t),{recursive:!0}),xt(t,`${JSON.stringify({type:r.type,...r.values},null,2)}
2
- `,"utf8"),i}import{mkdirSync as Tt,renameSync as Nt,writeFileSync as Pt}from"fs";import{dirname as Vt}from"path";function F(e,n){Vn(Vt(e));let r=`${e}.tmp-${process.pid}-${Date.now()}`;Pt(r,n,"utf8"),Nt(r,e)}function Vn(e){Tt(e,{recursive:!0})}import{existsSync as _,readdirSync as Ge,readFileSync as X}from"fs";import{join as V}from"path";import{existsSync as Dt,readFileSync as Dn,mkdirSync as _t,writeFileSync as Ft}from"fs";import _n from"path";function Re(e){return _n.join(e,".tbox","app.json")}function Fn(e){let n=Re(e);if(!Dt(n))return null;try{let r=JSON.parse(Dn(n,"utf8")),t=r?.templateVersion;return typeof t!="string"||t.trim().length===0?null:{templateVersion:t.trim(),npmModules:Array.isArray(r?.npmModules)?r.npmModules:[]}}catch{return null}}function $t(e,n){let r=Re(e);_t(_n.dirname(r),{recursive:!0}),Ft(r,`${JSON.stringify(n,null,2)}
3
- `,"utf8")}function ze(e){let n=Fn(e);if(n===null)return null;let r=Re(e);try{let t=JSON.parse(Dn(r,"utf8"));return{...n,miniappContainers:Array.isArray(t?.miniappContainers)?t.miniappContainers:[]}}catch{return{...n,miniappContainers:[]}}}function Lt(e,n){let r=e.npmModules.filter(t=>t.id!==n.id);return{...e,npmModules:[...r,n]}}function Bt(e,n){return{...e,npmModules:e.npmModules.filter(r=>r.id!==n)}}function Wt(e,n){let r=(e.miniappContainers??[]).filter(t=>t.id!==n.id);return{...e,miniappContainers:[...r,n]}}function Ut(e,n,r){return{...e,npmModules:e.npmModules.map(t=>t.id===n?{...t,...r}:t)}}function $n(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)&&!e.includes("..")}function Kt(e,n){if(!$n(e))throw new Error(`非法模块 id "${e}"(来自 ${n}):仅允许小写字母/数字/中划线`)}function Ln(e){try{let n=JSON.parse(e);if(!Array.isArray(n.slots))return null;let r=n.slots.filter(i=>typeof i=="string"),t={};if(n.meta&&typeof n.meta=="object"&&!Array.isArray(n.meta))for(let[i,o]of Object.entries(n.meta)){if(!o||typeof o!="object"||Array.isArray(o))continue;let{name:s,description:d}=o,y={};typeof s=="string"&&s.length>0&&(y.name=s),typeof d=="string"&&d.length>0&&(y.description=d),(y.name!==void 0||y.description!==void 0)&&(t[i]=y)}return{slots:r,meta:t}}catch{return null}}function Ie(e,n){let r=t=>{try{let i=JSON.parse(t),o=ae(i);if(o.ok)return{kind:"strict",id:o.value.id,version:o.value.version,descriptor:o.value,declare:o.value.declare};if(o.legacy)return{kind:"legacy",detail:o.errors.join("; ")};if(i&&typeof i=="object"&&"declare"in i){let s=i;return{kind:"loose",...typeof s.id=="string"?{id:s.id}:{},declare:{providers:s.declare?.providers,consumes:s.declare?.consumes}}}return null}catch{return null}};if(n)return n.read(e,r)??null;if(!_(e))return null;try{return r(X(e,"utf8"))}catch{return null}}function zt(e){let n=V(e,".tbox","app.json");if(!_(n))return[];try{let r=JSON.parse(X(n,"utf8"));return Array.isArray(r.npmModules)?r.npmModules.filter(t=>!!t&&typeof t=="object"&&typeof t.id=="string"&&typeof t.package=="string"):[]}catch{return[]}}function Gt(e){let n=V(e,".tbox-dev.local"),r=V(n,"dev-manifest.json");if(!_(r))return[];try{let t=JSON.parse(X(r,"utf8")),i=[];for(let[o,s]of Object.entries(t.redirects??{}))typeof s!="string"||!o.startsWith("@tbox.cn/app-")||i.push({pkg:o,dir:V(n,s)});return i}catch{return[]}}function Wn(e,n){let r=[],t=[e];for(let d of["apps","packages"]){let y=V(e,d);if(_(y))try{for(let l of Ge(y,{withFileTypes:!0}))l.isDirectory()&&t.push(V(y,l.name))}catch{}}let i=new Set,o=(d,y,l)=>{let f=n?n.read(y,Ln):Ln(X(y,"utf8"));f!=null&&r.push({dir:d,slots:f.slots,meta:f.meta,via:l})},s=V(e,"config","service-slots.json");_(s)&&o(e,s,"config-override");for(let d of t){let y=V(d,"node_modules","@tbox.cn");if(!_(y))continue;let l=[];try{l=Ge(y)}catch{continue}for(let f of l){let R=V(y,f);if(i.has(R))continue;i.add(R);let I=V(R,"service-slots.json"),g=V(R,"src","service-slots.json");_(I)?o(R,I,"package"):_(g)&&o(R,g,"package")}}for(let d of t)for(let y of[V(d,"service-slots.json"),V(d,"src","service-slots.json")])_(y)&&o(d,y,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{},vendorMeta:{}},i={},o=[],s={},d=new Set,y=(a,m,h,u,v)=>{for(let w of a){let c=v===void 0||v===w.provider;c&&(t.vendorMeta[w.provider]??={owner:m,...u?.name?{name:u.name}:{},...u?.description?{description:u.description}:{}});let S=t.providers[w.provider]??={},A=S[w.implementation];A?A.services.includes(w.service)||A.services.push(w.service):(S[w.implementation]={provider:w.provider,implementation:w.implementation,credentialType:w.credentialType,owner:m,...c&&u?.name?{name:u.name}:{},...c&&u?.description?{description:u.description}:{},...w.local?{local:!0}:{},...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},services:[w.service]},t.credentialTypes[w.credentialType]??={owner:m,packageDir:h,...w.credentialSchema?{credentialSchema:w.credentialSchema}:{}});let b=`${w.provider}\0${w.service}`;i[b]||(i[b]={...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},packageDir:h})}},l=(a,m,h)=>{t.providers[a]??={},t.vendorMeta[a]??={owner:m,...h?.name?{name:h.name}:{},...h?.description?{description:h.description}:{}}},f=a=>a.kind==="strict"?{name:a.descriptor.name,description:a.descriptor.description}:void 0,R=(a,m)=>{for(let h of a){let u=s[h];u===void 0?s[h]=m:u!==m&&o.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:m,message:`服务 ${h} 归属冲突:${u} 与 ${m} 均声明 owns(先声明 ${u} 胜出)——修正 manifest declare.owns 互斥`})}},I=(a,m)=>{a.kind==="legacy"&&o.push({severity:"error",code:"OLD_MANIFEST_KEY",module:m,message:`${m}:${a.detail}`})},g=a=>a.kind==="strict"||a.kind==="loose"?a.declare:null,C=(a,m)=>{let h=a.optional!==!1,u=a.defaults??[],v=t.services[a.service];if(v){v.optional=v.optional&&h;let w=new Set(v.defaults.map(c=>`${c.provider}\0${c.implementation}`));for(let c of u){let S=`${c.provider}\0${c.implementation}`;w.has(S)||(v.defaults.push(c),w.add(S))}v.owners.includes(m)||v.owners.push(m);return}t.services[a.service]={optional:h,defaults:[...u],...a.name?{name:a.name}:{},...a.description?{description:a.description}:{},owners:[m]}};for(let a of zt(e)){if(d.has(a.id))continue;let m=V(e,"packages",a.id),h=V(e,"node_modules",...a.package.split("/")),u=Ie(V(m,"tbox.module.json"),n)??Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){I(u,a.id),d.add(a.id);continue}if(!u)continue;d.add(a.id);let v=_(V(m,"tbox.module.json"))?m:h,w=g(u);u.kind==="strict"&&r.push({id:a.id,dir:v,pkg:a.mode==="sdk"?a.package:`@app/${a.id}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],S=w?.providers?.id;S&&l(S,a.package,f(u)),c.length&&y(c,a.package,v,f(u),S);let A=w?.consumes??[];for(let x of A)C(x,a.package);let b=u.kind==="strict"?u.descriptor.declare.owns:[];b.length&&R(b.map(x=>x.service),a.id)}for(let{pkg:a,dir:m}of Gt(e)){let h=Ie(V(m,"tbox.module.json"),n);if(h?.kind==="legacy"){I(h,a);continue}if(!h?.id||d.has(h.id))continue;d.add(h.id);let u=g(h),v=u?.providers?.slots??[],w=u?.providers?.id;w&&l(w,a,f(h)),v.length&&y(v,a,m,f(h),w);let c=u?.consumes??[];for(let A of c)C(A,a);let S=h.kind==="strict"?h.descriptor.declare.owns:[];S.length&&R(S.map(A=>A.service),h.id)}let O=V(e,"packages");if(_(O)){let a=[];try{a=Ge(O,{withFileTypes:!0}).filter(m=>m.isDirectory()).map(m=>m.name)}catch{}for(let m of a){if(d.has(m))continue;let h=V(O,m),u=Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){I(u,m),d.add(m);continue}if(!u)continue;let v=u.id??m;if(d.has(v))continue;d.add(v);let w=g(u);u.kind==="strict"&&r.push({id:v,dir:h,pkg:`@app/${v}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],S=w?.providers?.id;S&&l(S,`@app/${v}`,f(u)),c.length&&y(c,`@app/${v}`,h,f(u),S);let A=w?.consumes??[];for(let x of A)C(x,`@app/${v}`);let b=u.kind==="strict"?u.descriptor.declare.owns:[];b.length&&R(b.map(x=>x.service),v)}}let M=new Set,p={};for(let a of Wn(e,n)){for(let m of a.slots)M.add(m);for(let[m,h]of Object.entries(a.meta))p[m]===void 0&&(p[m]=h)}return{modules:r,catalog:t,serviceSchemas:i,vocabulary:[...M].sort(),slotMeta:p,ownership:s,declarationIssues:o}}function Bn(e,n,r){let t=V(e,"src",n,"index.ts");if(!_(t))return!1;try{let i=X(t,"utf8");return new RegExp(`export\\s+const\\s+${r}\\b`).test(i)}catch{return!1}}function Jt(e){let n=V(e,"src","server","index.ts");if(!_(n))return"";try{return X(n,"utf8")}catch{return""}}function Un(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function Yt(e){let n=[],r=D(e),t=ze(e),i=new Map;for(let o of t?.npmModules??[])i.set(o.id,o.mode);for(let o of r.modules){let s=i.get(o.id)??"local",d=Bn(o.dir,"server","serverModule"),y=o.descriptor.declare;n.push({id:o.id,pkg:s==="sdk"?o.pkg:`@app/${o.id}`,mode:s,hasServerEntry:d,hasClientEntry:Bn(o.dir,"client","clientModule"),hasCards:(y.cards?.length??0)>0,...d?{moduleId:Un(Jt(o.dir))}:{}})}return n.sort((o,s)=>o.id.localeCompare(s.id))}function Ht(e){return D(e).ownership}function $(e,n){let r=e?.modules?.[n]?.provider;if(typeof r=="string"&&r.length>0)return{provider:r,layer:"module"};let t=e?.provider;return typeof t=="string"&&t.length>0?{provider:t,layer:"app"}:{provider:null,layer:null}}function U(e,n){let r=(n.descriptor.declare.owns??[]).map(t=>t.service).sort();return r.length===0?{writable:!1,reason:"zero-ownership",ownedServices:[]}:{writable:!0,ownedServices:r}}function de(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(r=>r.services))].sort()}function K(e){if(!e||typeof e!="object")return!1;let n=Object.keys(e),r=new Set(["provider","credentialType","configSchema"]);if(!n.every(i=>r.has(i)))return!1;let t=e;return typeof t.provider=="string"&&t.provider.length>0&&typeof t.credentialType=="string"&&t.credentialType.length>0&&(t.configSchema===void 0||typeof t.configSchema=="string")}function Kn(e,n,r){return e==="*"||r.has(e)?null:{severity:"error",code:"INSTANCE_KEY_NOT_REGISTERED",instance:e,message:`integrations: ${n} 键 ${e} 不在 malls 白名单内(${[...r].join(", ")})`}}function Je(e,n){let r=new Set(n),t=[],i=(o,s)=>{let d=Kn(o,s,r);d&&t.push(d)};for(let o of Object.keys(e.configByInstance??{}))i(o,"configByInstance");for(let o of Object.keys(e.credentialRefByInstance??{}))i(o,"credentialRefByInstance");for(let[o,s]of Object.entries(e.services??{}))for(let d of Object.keys(s.instances??{}))i(d,`services.${o}.instances`);return t}function ee(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:i,demandedServices:o,supplies:s,malls:d,credentialSchemaMissing:y,vendorConfigKeys:l,vendorGlobalConfigKeys:f,vendorConfigSchemaMissing:R,credentialFileMissing:I,credentialFileType:g,realmSwitchHints:C,moduleResourceNeeds:O,ownership:M,installedModuleIds:p}=e,a=d?new Set(d):void 0;for(let c of C??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:c});let m=new Set(Object.keys(i).map(c=>c.slice(0,c.indexOf("\0"))).filter(c=>c.length>0)),h=(c,S,A,b)=>{if(typeof A?.provider=="string"&&typeof A.implementation=="string"&&A.provider&&A.implementation)return i[le(A.provider,A.implementation)]?.credentialType;if(typeof S.provider=="string"&&typeof S.implementation=="string")return i[le(S.provider,S.implementation)]?.credentialType;let x=S.provider?.credentialType;if(typeof x=="string")return x;if(!s)return;let T=b??Object.keys(S.instances??{})[0]??"",j=r.resolveEffectiveService(t,c,T,s,M);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return i[le(j.effective.provider,j.effective.implementation)]?.credentialType};if(I||g)for(let[c,S]of Object.entries(t.services))for(let[A,b]of Object.entries(S.instances??{})){if(b.enabled===!1)continue;let x=b.credentialRef??S.credentialRef??t.credentialRefByInstance?.[A]??t.credentialRef;if(typeof x!="string"||!x.startsWith("secret://"))continue;let T=x.slice(9);I?.[T]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:c,instance:A,message:`integrations: 凭据文件缺失 ${T}(${c}@${A} effective ref=${x};档内 config/credentials/ 无此文件)`});let j=g?.[T];if(j){let P=h(c,S,b,A);P&&j!==P&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:c,instance:A,message:`integrations: 凭据文件 ${T}.json type=${j} 与绑定 credentialType ${P} 不一致(${c}@${A}——transport 创建期将按 type 选策略)`})}}let u=(c,S)=>{if(!a)return;let A=Kn(c,S,a);A&&n.push(A)};for(let[c]of Object.entries(t.configByInstance??{}))u(c,"configByInstance");for(let[c]of Object.entries(t.credentialRefByInstance??{}))u(c,"credentialRefByInstance");let v=Object.entries(t.services).filter(([,c])=>c.instances==null||c.instances["*"]!=null).map(([c])=>c);if(v.length>0){let c=Object.entries(t.services).filter(([,S])=>S.instances!=null&&S.instances["*"]==null).map(([S])=>S);c.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${v.join(", ")};显式键集:${c.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let w=r.normalizeInstances({instances:t.instances,defaultInstanceId:t.defaultInstanceId});w.instances.length>=2&&w.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${w.instances.length} 个部署实例(${w.instances.map(c=>c.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[c,S]of Object.entries(t.services)){if(!o[c]&&M?.[c]===void 0&&n.push({severity:"warning",code:"SLOT_NOT_DECLARED",service:c,message:`integrations: 服务槽 ${c} 无消费方声明(拼写错误或需求方未安装)——若为拆分前旧槽位词汇(member.main/parking.main/promotion.read/shopping-guide.main),参照 cookbook·app-config 槽位迁移配方展开为新槽`}),typeof S.provider=="string"?typeof S.implementation=="string"&&!i[le(S.provider,S.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,message:`integrations: provider ${S.provider}/${S.implementation} 未命中已装供给(${c} 槽级)——装对应 provider 包或改绑`}):S.provider!==void 0&&!K(S.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,message:`integrations: 内联 provider 超受控形状(${c} 槽级;允许键 provider/credentialType/configSchema)`}),y){let b=h(c,S);b&&y[b]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:c,message:`integrations: credentialType ${b} 的 schema 引用不存在(${c};manifest 声明指向缺失文件)`})}typeof S.provider=="object"&&typeof S.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 内联厂商声明必须同时提供 implementation(${c} 槽级)`});for(let[b,x]of Object.entries(S.instances??{})){u(b,`services.${c}.instances`);let T=x.provider!==void 0,j=x.implementation!==void 0;if(j&&!T&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,instance:b,message:`integrations: 实例级 implementation 需伴随 provider(${c}@${b}——impl-only 禁止,provider 是绑定组头)`}),T&&j){let P=x.provider,L=x.implementation;typeof P=="string"&&typeof L=="string"?i[le(P,L)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,instance:b,message:`integrations: 实例级 provider 覆盖 ${P}/${L} 未命中已装供给(${c}@${b})`}):K(P)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,instance:b,message:`integrations: 实例级内联 provider 超受控形状(${c}@${b})`})}}}for(let[c,S]of[["root",t.provider],...Object.entries(t.modules??{}).map(([A,b])=>[`modules.${A}`,b?.provider])])typeof S!="string"||S.length===0||m.has(S)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:c.startsWith("modules.")?c.slice(8):void 0,message:`integrations: ${c} provider ${S} 未命中已装供给——装对应 provider 包或 provider use 改绑`});if(s)for(let[c,S]of Object.entries(t.services)){let A=S.instances?Object.keys(S.instances):[""];for(let b of A){let x=r.resolveEffectiveService(t,c,b,s,M);x.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:c,instance:b||void 0,message:`integrations: ${x.message}`})}}for(let[c,S]of Object.entries(t.services))S.implementation!==void 0&&S.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 槽级 implementation 需伴随 provider(${c}——impl-only 禁止,provider 是绑定组头)`});for(let[c,S]of Object.entries(t.modules??{})){if(!(S?.provider!==void 0||S?.config!==void 0))continue;let b=p?!p.has(c):!1,x=0;if(M)for(let j of Object.values(M))j===c&&(x+=1);if(b||!(M===void 0)&&x===0){let j=b?"未安装(键 = install id)":"未声明任何 owns(无模块级配置位)";n.push({severity:"error",code:"MODULE_CONFIG_DEAD",module:c,message:`integrations: modules.${c} 携带 provider/config 但模块${j}(MODULE_CONFIG_DEAD——模块级集成位作用于 declare.owns 服务,改 declare.owns 或删除该节点)`})}}if(l){let c=new Set,S=!1,A=b=>{typeof b!="string"||b.length===0||(l[b]&&c.add(b),!l[b]&&!R?.[b]&&(S=!0),R?.[b]&&(S=!0))};A(t.provider);for(let b of Object.values(t.modules??{}))A(b?.provider);for(let b of Object.values(t.services)){let x=b.provider;A(typeof b.provider=="string"?b.provider:x?.provider)}for(let b of c)l[b]?.has("mallId")&&n.push({severity:"warning",code:"MALL_IDENTITY_IN_CONFIG_SCHEMA",message:`integrations: 厂商 ${b} configSchema 声明商场身份键 mallId——商场身份恒来自会话 scope(mallId),不应作 config 键/参数模板;厂商独立编号用语义前缀键(如 parkingMallId)按实例差异化(见 npx --yes @tbox.cn/app-cli skills get provider-custom「商场身份单源」)`});if(c.size>0&&!S){let b=new Set;for(let j of c)for(let P of l[j]??[])b.add(P);let x=new Set;for(let j of c)for(let P of f?.[j]??[])x.add(P);let T=(j,P,L,Z)=>{for(let[q]of Object.entries(j??{}))(L??b).has(q)?Z&&Z.size>0&&!Z.has(q)&&n.push({severity:"warning",code:"GLOBAL_FIELD_UNDECLARED",message:`integrations: ${P} 键 ${q} 过 schema 校验但未声明 x-tbox-global(不进应用/模块全局表单;已配置值照常生效——如需全局编辑请在 provider schema 标记)`}):n.push({severity:"error",code:"DOMAIN_CONFIG_INVALID",message:`integrations: ${P} 键 ${q} 不在引用厂商(${[...c].join("/")})任何槽 schema properties 内(死配置)`})};T(t.config,"root.config",void 0,x);for(let[j,P]of Object.entries(t.configByInstance??{}))T(P,`root.configByInstance[${j}]`,void 0,x);for(let[j,P]of Object.entries(t.modules??{})){if(!P?.config)continue;let L=$(t,j).provider??void 0;if(L===void 0){T(P.config,`modules.${j}.config`,void 0,x);continue}let Z=l[L];if(!Z||R?.[L])continue;let q=f?.[L];T(P.config,`modules.${j}.config`,new Set(Z),q)}}}for(let[c,S]of Object.entries(o)){let A=t.services[c];if(!A){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:c,message:`integrations: 服务槽 ${c}(需求方 ${S.owners.join(", ")})未配置${S.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let b=Object.entries(A.instances??{}).filter(([,x])=>x.enabled===!1).map(([x])=>x);b.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:c,instance:b.join(", "),message:`integrations: ${c} 实例禁用(${b.join(", ")})`})}for(let[c,S]of Object.entries(t.modules??{})){let A=O?.[c];O&&!(c in O)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c} 未命中已装模块(键 = install id——检查 .tbox/app.json entry.id / packages/ 目录名)`});for(let[b,x]of Object.entries(S?.resources??{})){let T=x?.type;(typeof T!="string"||!r.RESOURCE_TYPE_IDS.includes(T))&&n.push({severity:"error",code:"RESOURCE_TYPE_UNKNOWN",module:c,message:`integrations: modules.${c}.resources.${b} type 非法(${String(T)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),A&&A.size>0&&!A.has(b)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c}.resources.${b} 未被模块 manifest declare.resources 声明`})}}return n}function le(e,n){return`${e}\0${n}`}import{existsSync as Ye,readFileSync as Zt,readdirSync as qt}from"fs";import{join as ke}from"path";function Gn(e){return e.replaceAll("-","_").toUpperCase()}function zn(e){if(!Ye(e))return null;try{let n=JSON.parse(Zt(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Qt(e){let n=new Set,r=e.properties;if(r&&typeof r=="object"&&!Array.isArray(r))for(let t of Object.keys(r))n.add(t);return n}function ue(e,n,r,t=process.env){let i={};for(let[u,v]of Object.entries(n.catalog.providers))for(let[w,c]of Object.entries(v))i[`${u}\0${w}`]={services:[...c.services],owner:c.owner,credentialType:c.credentialType};let o={};for(let[u,v]of Object.entries(n.catalog.services))o[u]={optional:v.optional,owners:[...v.owners]};let s={},d={},y={},l={},f={};for(let u of n.modules){f[u.id]=new Set((u.descriptor.declare.resources??[]).map(v=>v.id));for(let v of u.descriptor.declare.providers?.slots??[]){if(v.configSchema){let w=zn(ke(u.dir,v.configSchema));if(w){let c=s[v.provider]??=new Set,S=d[v.provider]??=new Set;for(let b of Qt(w))c.add(b);let A=w.properties;if(A&&typeof A=="object"&&!Array.isArray(A))for(let[b,x]of Object.entries(A))x&&typeof x=="object"&&x["x-tbox-global"]===!0&&S.add(b)}else y[v.provider]=!0}v.credentialSchema&&!Ye(ke(u.dir,v.credentialSchema))&&(l[v.credentialType]=!0)}}let R={},I=new Set,g=ke(e,"config","credentials");if(Ye(g))for(let u of qt(g)){if(!u.endsWith(".json"))continue;let v=u.slice(0,-5);I.add(v);let w=zn(ke(g,u));w&&typeof w.type=="string"&&(R[v]=w.type)}let C=r,O=[],M=u=>{typeof u=="string"&&u.startsWith("secret://")&&O.push(u)};for(let u of Object.values(C.services??{}))if(u&&typeof u=="object"){M(u.credentialRef);for(let v of Object.values(u.instances??{}))v&&typeof v=="object"&&M(v.credentialRef)}for(let u of Object.values(C.credentialRefByInstance??{}))M(u);M(C.credentialRef);let p={};for(let u of O){let v=u.slice(9);t[Gn(v)]===void 0&&(I.has(v)||(p[v]=!0))}let a=[];for(let[u,v]of Object.entries(C.services??{})){let w=v&&typeof v=="object"&&typeof v.provider=="string"?v.provider:void 0;for(let[c,S]of Object.entries((v&&typeof v=="object"?v.instances:void 0)??{})){let A=S&&typeof S=="object"&&typeof S.provider=="string"?S.provider:void 0;w&&A&&A!==w&&a.push(`integrations: ${u}@${c} 实现覆盖跨厂商(${w} → ${A})——凭据域切换,确认该 mall 对应凭据在场`)}}let h=((Array.isArray(C.instances)?C.instances:void 0)??[]).map(u=>u&&typeof u=="object"&&typeof u.id=="string"?u.id:void 0).filter(u=>typeof u=="string");return{suppliedProviders:i,demandedServices:o,credentialFileMissing:p,credentialFileType:R,credentialSchemaMissing:l,vendorConfigKeys:s,vendorGlobalConfigKeys:d,vendorConfigSchemaMissing:y,realmSwitchHints:a,moduleResourceNeeds:f,...h.length>0?{malls:h}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(u=>u.id),...new Set(Object.values(n.ownership))])}}import{existsSync as yi,readFileSync as Si}from"fs";import{join as hi,resolve as Ri}from"path";function He(e){return D(e).catalog}function be(e){let n=D(e).catalog,r={};for(let[o,s]of Object.entries(n.providers)){r[o]={};for(let[d,y]of Object.entries(s))r[o][d]={provider:y.provider,implementation:y.implementation,credentialType:y.credentialType,owner:y.owner,...y.local?{local:!0}:{},...y.configSchema?{configSchema:y.configSchema}:{},...y.credentialSchema?{credentialSchema:y.credentialSchema}:{},services:[...y.services]}}let t={};for(let[o,s]of Object.entries(n.services))t[o]={optional:s.optional,defaults:s.defaults.map(d=>({...d})),owners:[...s.owners]};let i={};for(let[o,s]of Object.entries(n.credentialTypes))i[o]={owner:s.owner,...s.credentialSchema?{credentialSchema:s.credentialSchema}:{}};return{providers:r,services:t,credentialTypes:i}}async function Ze(e,n,r,t=process.env){let i=r.module,o=D(e),s=i.buildSupplyLookup(be(e)),d=ue(e,o,n,t);return ee({contracts:i,integrations:n,supplies:s,...d})}import{existsSync as or,rmSync as sr}from"fs";import{join as ar}from"path";import{existsSync as Xt,readFileSync as er}from"fs";import{join as Jn}from"path";var nr=Jn("config","integrations.json");function G(e,n){let r=Jn(e,nr),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!Xt(r))return null;try{return t(er(r,"utf8"))}catch{return null}}async function Yn(e,n){let r=await N(e),t=G(e,n);if(t===null)return{config:null,strict:!1,contracts:r};if(r.strictValidation&&r.module.parseIntegrationsConfig)try{return{config:r.module.parseIntegrationsConfig(t),strict:!0,contracts:r}}catch(i){if(i instanceof Error&&Array.isArray(i.issues)){let o=i.issues.filter(s=>Array.isArray(s.path)).map(s=>s.path.map(String).join(".")).filter(s=>s.length>0);throw new E("VALIDATION_FAILED",400,"integrations.json 校验失败",o.length>0?o:void 0)}throw new E("VALIDATION_FAILED",400,i instanceof Error?i.message:String(i))}return{config:t,strict:!1,contracts:r}}function pe(e,n,r,t){return e.includes(r)||n.includes(r)||t.includes(r)}import{readdirSync as tr,existsSync as Ae,readFileSync as rr}from"fs";import{join as Ce}from"path";function Hn(e,n,r){let t=[];if(n){let i=Q({provider:e});t.push({stem:i,ref:`secret://${i}`,input:n})}for(let[i,o]of Object.entries(r??{})){let s=Q({provider:e,instanceId:i});t.push({instanceId:i,stem:s,ref:`secret://${s}`,input:o})}return t}function Zn(e,n,r,t,i){let o=[];if(t){let s=Q({provider:e,service:n});o.push({stem:s,ref:`secret://${s}`,input:t})}for(let[s,d]of Object.entries(i??{})){let y=Q({provider:e,instanceId:s,domain:r});o.push({instanceId:s,stem:y,ref:`secret://${y}`,input:d})}return o}function Qe(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ae(Ce(e,W(t.stem))):Ke(e,t.stem,t.input)}))}function ir(e,n){return Ae(Ce(e,W(n)))}function qe(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)qe(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))qe(r,n)}function ne(e){let n=Ce(e,"config","credentials"),r=new Set,t=Ce(e,"config","integrations.json");if(Ae(t))try{qe(JSON.parse(rr(t,"utf8")),r)}catch{}let i=[];if(!Ae(n))return i;let o=[];try{o=tr(n).filter(s=>s.endsWith(".json")).map(s=>s.slice(0,-5))}catch{return i}for(let s of o.sort()){if(r.has(s))continue;let d=ce(e,s);i.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${W(s)} 不再被引用(凭据文件保留,可手动清理)`})}return i}function Ee(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&K(e)){let n=e.provider;return n.length>0?n:void 0}}async function cr(e){let n=ar(e,"config","integrations.json"),r=G(e);if(r===null)return{removed:[],orphanCredentials:[],skipped:"not-configured"};let t=await N(e);if(!t.strictValidation)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};let i;try{let g=Ue(JSON.stringify(r),process.env);if(g.missing.length>0||g.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};i=JSON.parse(g.text)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let o;try{o=await Ze(e,i,t,process.env)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let s=D(e),d=new Set(Object.keys(s.catalog.providers)),y=s.ownership,l=structuredClone(r);l.services??={};let f=[];for(let g of o)if(g.severity==="error"){if(g.code==="VENDOR_NOT_INSTALLED")if(g.module){let O=(l.modules??{})[g.module];O?.provider&&(f.push(`modules.${g.module}.provider=${String(O.provider)}`),delete O.provider,Object.keys(O).length===0&&delete l.modules[g.module])}else l.provider&&(f.push(`root.provider=${l.provider}`),delete l.provider);else if(g.code==="MODULE_CONFIG_DEAD"&&g.module){let C=l.modules??{};if(C[g.module]){let O=C[g.module],M=[O.provider!==void 0?"provider":void 0,O.config!==void 0?"config":void 0,O.resources!==void 0?"resources":void 0].filter(Boolean);f.push(`modules.${g.module}(${M.join("+")} 整节点)`),delete l.modules[g.module]}}else if(g.code==="BINDING_UNRESOLVED"&&g.service){let C=l.services[g.service];if(!C)continue;let O=y[g.service];if([g.instance?Ee(C.instances?.[g.instance]?.provider):void 0,Ee(C.provider),O!==void 0?Ee(l.modules?.[O]?.provider):void 0,Ee(l.provider)].filter(p=>typeof p=="string").some(p=>d.has(p)))continue;if(g.instance){let p=C.instances;if(!p||!(g.instance in p))continue;delete p[g.instance],f.push(`services.${g.service}.instances.${g.instance}`),Object.keys(p).length===0&&delete C.instances,Object.keys(C).length===0&&delete l.services[g.service]}else delete l.services[g.service],f.push(`services.${g.service}`)}}if(Object.keys(l.services).length===0&&delete l.services,f.length===0)return{removed:f,orphanCredentials:[]};let R=!l.provider&&Object.keys(l.services??{}).length===0&&Object.keys(l.config??{}).length===0&&Object.keys(l.configByInstance??{}).length===0&&!l.credentialRef&&Object.keys(l.credentialRefByInstance??{}).length===0&&(l.instances??[]).length===0&&l.defaultInstanceId==null&&Object.keys(l.modules??{}).length===0;if(!R&&(l.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(l)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let I=[];return R?or(n)&&sr(n,{force:!0}):F(n,`${JSON.stringify(l,null,2)}
4
- `),I=ne(e).map(g=>g.message),{removed:f,orphanCredentials:I}}function Oe(e,n){let r=e.modules.find(i=>i.id===n);if(r)return r;let t=e.modules.filter(i=>(i.descriptor.name??i.descriptor.id)===n);if(t.length===1)return t[0];throw t.length>1?new E("MODULE_NOT_FOUND",404,`模块展示名「${n}」命中多个模块:${t.map(i=>`${i.descriptor.name}(id=${i.id})`).join(" / ")}——请改用模块 id 寻址`):new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块(id / 展示名均未命中)`)}function Y(e,n,r){let t=new Set;for(let s of Object.values(e.catalog.providers))for(let d of Object.values(s))for(let y of d.services)t.add(y);if(e.vocabulary.includes(r)||Object.hasOwn(e.catalog.services,r)||t.has(r)||n.includes(r)||Object.hasOwn(e.ownership,r))return r;let i=[],o=s=>{i.includes(s)||i.push(s)};for(let s of e.vocabulary)(e.slotMeta[s]?.name??e.catalog.services[s]?.name)===r&&o(s);for(let[s,d]of Object.entries(e.catalog.services))d.name===r&&o(s);if(i.length===1)return i[0];throw i.length>1?new E("SERVICE_NOT_FOUND",404,`服务展示名「${r}」命中多个服务:${i.join(" / ")}——请改用服务 id 寻址`):new E("SERVICE_NOT_FOUND",404,`服务 ${r} 不在服务词汇(已装契约包 ∪ 已配置)`)}import{existsSync as rt,readFileSync as it}from"fs";import{join as re,resolve as dr}from"path";import lr from"ajv";var te=["$comment","$schema","provider","config","configByInstance","credentialRef","credentialRefByInstance","instances","defaultInstanceId"],xe=["provider","config"],qn=["provider","implementation","config","credentialRef","instances"],Qn=["provider","implementation","config","credentialRef","enabled"];var H=re("config","integrations.json");function fe(e,n){if(e===n)return!0;if(Array.isArray(e)&&Array.isArray(n))return e.length!==n.length?!1:e.every((r,t)=>fe(r,n[t]));if(e&&n&&typeof e=="object"&&typeof n=="object"){let r=Object.keys(e),t=Object.keys(n);return r.length!==t.length?!1:r.every(i=>fe(e[i],n[i]))}return!1}var ot=["$comment","$schema"];function Me(e,n){if(n)for(let r of ot)!(r in e)&&r in n&&(e[r]=n[r])}function Xn(e){if(e===null)return null;let n={...e};for(let r of ot)delete n[r];return n}function et(e,n){return fe(Xn(e),Xn(n))}function Pe(e,n){if(typeof e!="string"&&e&&typeof e=="object")for(let[r,t]of Object.entries(e)){if((r==="provider"||r==="instanceId")&&typeof t=="string"&&!z.test(t))throw new E("VALIDATION_FAILED",400,`${r} 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`${n}.${r}`]);Pe(t,`${n}.${r}`)}}function je(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!(r&&(t==="*"||t==="**"))&&!z.test(t))throw new E("VALIDATION_FAILED",400,`${n} 键 ${t} 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)——进凭据 stem 派生,防路径逃逸`,[n])}}function nt(e,n,r){if(r==="root"){let t=e.instances;Array.isArray(t)&&t.forEach((i,o)=>{let s=i&&typeof i=="object"?i.id:void 0;if(typeof s=="string"&&!z.test(s))throw new E("VALIDATION_FAILED",400,`instances[${o}].id 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`root.instances[${o}].id`])}),je(e.configByInstance,"root.configByInstance",!1),je(e.credentialRefByInstance,"root.credentialRefByInstance",!1)}else je(e.instances,"services.instances",!0);je(n.credentialsByInstance,"credentialsByInstance",!1)}function Te(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!n.includes(t))throw new E("VALIDATION_FAILED",400,`${r} 仅接受 ${n.join("/")} 键(收到 ${t})`,[t])}}function Ne(e,n){let r=re(e,H),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!rt(r))return null;try{return t(it(r,"utf8"))}catch{return null}}function Xe(e){let n=(e.instances??[]).map(r=>r.id);return n.length===0?[]:Je(e,n)}function ur(e,n,r,t){let{catalog:i}=D(e,t),o=i.providers[n];if(!o)return;let s=new Set;for(let d of Object.values(o))(r===void 0||d.services.includes(r))&&s.add(d.credentialType);return s.size===1?[...s][0]:void 0}function tt(e,n,r,t,i,o){if(typeof t.type!="string"||t.type.length===0)throw new E("VALIDATION_FAILED",400,"凭据 type 缺失或为空字符串",["credentials.type"]);let s=i??ur(e,n,r,o);if(s!==void 0&&s!=="-"&&t.type!==s)throw new E("VALIDATION_FAILED",400,`凭据 type=${t.type} 与绑定 credentialType ${s} 不一致`,["credentials.type"]);if(r===void 0)return;let{serviceSchemas:d}=D(e,o),y=d[`${n}\0${r}`];if(!y?.credentialSchema)return;let l=dr(y.packageDir,y.credentialSchema);if(rt(l))try{let R=new lr({allErrors:!0}).compile(JSON.parse(it(l,"utf8")));if(!R({type:t.type,...t.values})){let I=(R.errors??[]).map(g=>`credentials.values.${String(g.instancePath||g.params?.missingProperty||"").replace(/^\//,"")}`);throw new E("VALIDATION_FAILED",400,"凭据字段校验失败(ajv 字段级)",I)}}catch(f){if(f instanceof E)throw f}}function en(e,n={}){let{onApplied:r,cache:t}=n;function i(l,f,R,I){let g=l!==null,C=f.length>0,O=!I&&g,M=!I&&C;O&&(F(re(e,H),`${JSON.stringify(l,null,2)}
5
- `),t?.invalidate([re(e,H)]));let p=O||M;p&&R.push(...ne(e));let a=p&&r!==void 0;a&&r?.();let m=[];return g&&m.push(H),C&&m.push(...f.map(h=>W(h.stem))),{written:p,restartScheduled:a,files:m,credentials:f,issues:R}}let o;async function s(){o=await N(e)}function d(l,f){return l.filter(R=>Array.isArray(R.path)).map(R=>{let I=R.path.map(String).join(".");return f!==""&&I.startsWith(f)&&I.length>f.length?I.slice(f.length):I}).filter(R=>R.length>0)}function y(l,f,R){if(!o)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用——写路径门控失败(工厂边缘断言应先行拦截)");let I=se(o);if(I==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(o));if(I==="degraded"){f.push({severity:"warning",code:"STRICT_VALIDATION_SKIPPED",message:B(o)});return}try{o.module.parseIntegrationsConfig(l)}catch(g){throw g instanceof Error&&Array.isArray(g.issues)?new E("VALIDATION_FAILED",400,"节点 schema 校验失败",d(g.issues,R)):new E("VALIDATION_FAILED",400,g instanceof Error?g.message:String(g))}}return{warmup:s,applyApp(l,f={}){Pe(l,"root"),nt(l,f,"root"),Te(l,te,"root");let R=[],I=Ne(e,t),g=I??{services:{}};I===null&&R.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let C={...g};for(let v of te)v in l||delete C[v];for(let[v,w]of Object.entries(l))C[v]=w;let O=typeof C.provider=="string"?C.provider:"app",M=Hn(O,f.credentials,f.credentialsByInstance);for(let v of M)tt(e,O,void 0,v.input,void 0,t);let p=M.find(v=>v.instanceId===void 0);if(f.credentials&&p&&(C.credentialRef=p.ref),f.credentialsByInstance){let v={...C.credentialRefByInstance??{}};for(let w of M)w.instanceId!==void 0&&(v[w.instanceId]=w.ref);C.credentialRefByInstance=v}Me(C,I);let a=f.credentials!==void 0||f.credentialsByInstance!==void 0,m=et(I,C);if(m&&!a)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:R};y(C,R,"");let h=f.dryRun===!0,u=Qe(e,M,h);return R.push(...Xe(C)),i(m?null:C,u,R,f.dryRun)},applyModule(l,f,R={}){Pe(f,"root");let{modules:I,catalog:g,ownership:C}=D(e,t),O=I.find(c=>c.id===l);if(!O)throw new E("MODULE_NOT_FOUND",404,`模块 ${l} 非已装模块`);if(!U({modules:I,catalog:g,ownership:C},O).writable)throw new E("VALIDATION_FAILED",400,`模块 ${l} 未声明任何 declare.owns——无模块级配置位(模块级 provider/config 作用于归属服务)`);let p=[],a=Ne(e,t);if(a===null&&Object.keys(f).length===0)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p};a===null&&p.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let m=a??{services:{}},h={...m.modules??{}},u={...h[l]??{}};Te(f,xe,`modules.${l}`);let v={...u};for(let c of xe){let S=f[c];S==null||S===""||typeof S=="object"&&!Array.isArray(S)&&Object.keys(S).length===0?delete v[c]:v[c]=S}Object.keys(v).length===0?delete h[l]:h[l]=v;let w={...m,modules:h};return Me(w,a),fe(a,w)?{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p}:(y(w,p,`modules.${l}.`),p.push(...Xe(w)),i(w,[],p,R.dryRun))},applyService(l,f,R={}){Pe(f,"root"),nt(f,R,"slot"),Te(f,qn,`services.${l}`);for(let[T,j]of Object.entries(f.instances??{}))Te(j,Qn,`services.${l}.instances.${T}`);let I=[],g=Ne(e,t),C=D(e,t);if(!pe(C.vocabulary,Object.keys(g?.services??{}),l,Object.keys(C.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${l} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);g===null&&I.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let O=g??{services:{}},M={...O.services??{}},p={...O,services:M};Me(p,g),M[l]={...f};let a=f.provider,m=a!==null&&typeof a=="object"?a:void 0,h=typeof a=="string"?a:typeof m?.provider=="string"?m.provider:"app",u=l.includes(".")?l.slice(0,l.indexOf(".")):l,v=Zn(h,l,u,R.credentials,R.credentialsByInstance);for(let T of v)tt(e,h,l,T.input,typeof m?.credentialType=="string"?m.credentialType:void 0,t);let w=M[l],c=v.find(T=>T.instanceId===void 0);if(R.credentials&&c&&(w.credentialRef=c.ref),R.credentialsByInstance){let T={...w.instances??{}};for(let j of v){if(j.instanceId===void 0)continue;let P={...T[j.instanceId]??{}};P.credentialRef=j.ref,T[j.instanceId]=P}w.instances=T}Me(p,g);let S=R.credentials!==void 0||R.credentialsByInstance!==void 0,A=et(g,p);if(A&&!S)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:I};y(p,I,`services.${l}.`);let b=R.dryRun===!0,x=Qe(e,v,b);return I.push(...Xe(p)),i(A?null:p,x,I,R.dryRun)},deleteService(l){let f=[],R=Ne(e,t),I=D(e,t);if(!pe(I.vocabulary,Object.keys(R?.services??{}),l,Object.keys(I.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${l} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let g={...R?.services??{}};if(!(l in g))return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:f};delete g[l];let C={...R??{services:{}},services:g};F(re(e,H),`${JSON.stringify(C,null,2)}
6
- `),t?.invalidate([re(e,H)]),f.push(...ne(e));let O=r!==void 0;return O&&r?.(),{written:!0,restartScheduled:O,files:[H],credentials:[],issues:f}}}}import{existsSync as pr,readFileSync as fr}from"fs";import{join as gr}from"path";var st=["$comment","$schema"];function mr(e){try{let n=JSON.parse(fr(e,"utf8"));if(!n||typeof n!="object"||Array.isArray(n))return{pristine:!1,meta:{}};let r=new Set(["services",...st]);if(Object.keys(n).some(o=>!r.has(o)))return{pristine:!1,meta:{}};let t=n.services;if(!t||typeof t!="object"||Array.isArray(t)||Object.keys(t).length>0)return{pristine:!1,meta:{}};let i={};for(let o of st)o in n&&(i[o]=n[o]);return{pristine:!0,meta:i}}catch{return{pristine:!1,meta:{}}}}function nn(e){let n=gr(e,"config","integrations.json"),r={};if(pr(n)){let s=mr(n);if(!s.pristine)return{generated:!1,reason:"in-place",services:[]};r=s.meta}let t=[];for(let s of D(e).modules)for(let d of s.descriptor.declare.providers?.slots??[])d.local===!0&&t.push({service:d.service,provider:d.provider,implementation:d.implementation});if(t.length===0)return{generated:!1,reason:"no-local-slots",services:[]};let i={},o=new Set(t.map(s=>s.provider));if(o.size===1){let[s]=o;for(let d of t)i[d.service]={};F(n,`${JSON.stringify({...r,provider:s,services:i},null,2)}
7
- `)}else{for(let s of t)i[s.service]={provider:s.provider,implementation:s.implementation};F(n,`${JSON.stringify({...r,services:i},null,2)}
8
- `)}return{generated:!0,reason:"generated",services:t.map(s=>s.service).sort()}}var tn={provider:null,layer:null};function rn(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:tn}function on(e){let n=rn(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:tn,inherited:tn}}function Ve(e,n){let r=e?.modules?.[n]?.provider,t=typeof r=="string"&&r.length>0?r:null,i=$(e,n),o={provider:i.provider,layer:i.layer};return{configured:t,effective:o,inherited:t!==null?rn(e):o}}function vr(e){return typeof e=="string"?e.length>0?e:null:K(e)?e.provider:null}function ge(e,n,r){let t=e?.services?.[r]?.provider,i=vr(t),o=n.ownership[r],s=o!==void 0?Ve(e,o).effective:rn(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as yr,readFileSync as Sr}from"fs";import{join as lt}from"path";function at(e,n){let r=D(e.appDir,e.cache),t=G(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function ct(e){let n=new Set;for(let r of e.modules){for(let t of r.descriptor.declare.owns??[])n.add(t.service);for(let t of r.descriptor.declare.consumes??[])n.add(t.service);for(let t of r.descriptor.declare.providers?.slots??[])n.add(t.service)}return n}function De(e,n,r){let t=e.providers[n];return t?Object.values(t).some(i=>i.services.includes(r)):!1}function J(e,n){let r=e.slotMeta[n],t=e.catalog.services[n],i=r?.name??t?.name??n,o=r?.description??t?.description;return{name:i,...o!==void 0?{description:o}:{}}}var wr=lt("config","knowledge.json");function hr(e,n,r){let i=r[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=lt(e.appDir,wr),s={};if(yr(o))try{s=(e.cache?.read(o,l=>JSON.parse(l))??JSON.parse(Sr(o,"utf8"))).knowledge_bases??{}}catch{s={}}let d={};for(let[y,l]of Object.entries(i)){if(!l||typeof l!="object"||Array.isArray(l))continue;let f=l,R=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),I=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,g=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,C=I??(g!==void 0&&typeof s[g]?.datasetId=="string"?s[g].datasetId:null),O={type:R,...I!==void 0?{datasetId:I}:{},...g!==void 0?{ref:g}:{},resolvedDatasetId:C,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};d[y]=O}return Object.keys(d).length>0?d:null}function dt(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function Rr(e){return dt(e.id).startsWith("provider-")||dt(e.pkg).startsWith("provider-")}function sn(e,n={}){return{modules:e.walk.modules.filter(t=>!Rr(t)).filter(t=>n.includeHidden===!0||t.descriptor.hidden!==!0).map(t=>({id:t.id,name:t.descriptor.name??t.descriptor.id,description:t.descriptor.description??"",...t.descriptor.hidden===!0?{hidden:!0}:{}})).sort((t,i)=>t.id.localeCompare(i.id))}}function an(e,n){let r=e.walk.modules.find(I=>I.id===n);if(!r)throw new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=U(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(I=>I.service)),o=(I,g)=>{let C=J(e.walk,I);return{service:I,name:C.name,...C.description!==void 0?{description:C.description}:{},required:g}},s=[...(r.descriptor.declare.consumes??[]).map(I=>o(I.service,I.optional===!1)),...[...new Set(t.ownedServices)].filter(I=>!i.has(I)).map(I=>o(I,!1))],d=e.integrations?.modules??{},y=d[n],l=y?{...typeof y.provider=="string"?{provider:y.provider}:{},...y.config&&typeof y.config=="object"&&!Array.isArray(y.config)?{config:y.config}:{}}:null,f=Ve(e.integrations,n),R={configured:f.configured,effective:f.effective,inherited:f.inherited,provider:f.effective.provider,layer:f.effective.layer};return{name:r.descriptor.name??r.descriptor.id,description:r.descriptor.description??"",...r.descriptor.hidden===!0?{hidden:!0}:{},ownedServices:t.ownedServices,integration:l,resources:hr(e,n,d),binding:R,configEditable:t.writable,services:s}}function cn(e){let n=ct(e.walk),r=e.walk.vocabulary.filter(o=>!n.has(o)).map(o=>{let s=J(e.walk,o);return{service:o,name:s.name,...s.description!==void 0?{description:s.description}:{},required:!1}}),t=e.integrations,i=null;if(t){let o={};for(let s of te)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i,binding:on(t)}}function dn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!pe(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let i=r[n]??null,o=J(e.walk,n);return{service:n,name:o.name,...o.description!==void 0?{description:o.description}:{},required:t?!t.optional:!1,integration:i,binding:ge(e.integrations,e.walk,n)}}import{existsSync as ft,readFileSync as gt,realpathSync as ut}from"fs";import{isAbsolute as Ir,join as kr,relative as br,resolve as pt,sep as Ar}from"path";function ln(e){let n=[];for(let[r,t]of Object.entries(e.catalog.providers)){let i=Object.values(t),o=e.catalog.vendorMeta[r];i.length===0&&!o||n.push({provider:r,local:i.length>0&&i.every(s=>s.local===!0),...o?.name?{name:o.name}:i[0]?.name?{name:i[0].name}:{}})}return{providers:n.sort((r,t)=>r.provider.localeCompare(t.provider))}}function un(e,n,r){let t=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(t)for(let l of Object.values(t))l.services.includes(r)&&o.push({implementation:l.implementation,credentialType:l.credentialType});let s=i[r]?.provider,d=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!d)throw t?new E("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&d&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:d.credentialType});let y=ie(e,n,r,d?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,configSchema:y,integrationSchemas:{configSchema:y}}}function ie(e,n,r,t){let i=e.walk.serviceSchemas[`${n}\0${r}`];return i?pn(e.appDir,i.packageDir,i.configSchema):typeof t=="string"?Cr(e.appDir,t):null}function pn(e,n,r){if(!r)return null;let t=kr(n,r);if(!ft(t))return null;try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function Cr(e,n){let r=pt(e,"config","schemas"),t=pt(e,n),i=br(r,t);if(i===""||i.startsWith("..")||Ir(i))throw new E("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!ft(t))return null;let o,s;try{o=ut(r),s=ut(t)}catch{return null}if(s!==o&&!s.startsWith(o+Ar))throw new E("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function _e(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,ownershipBindingV6:e.ownershipBindingV6,notes:[...e.notes]}}function mt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"];if(o&&o.provider!==void 0)return"instance";if(i?.provider!==void 0)return"service";let s=e.walk.ownership[n];return s!==void 0&&$(e.integrations,s).layer==="module"?"module":typeof t?.provider=="string"&&t.provider.length>0?"app":null}function vt(e,n,r,t,i){let o=n.resolveEffectiveService(e.integrations??{services:{}},r,t,i,e.walk.ownership);if(o.status==="ok"&&o.effective){let s=o.effective.provider,d=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:d,implementation:o.effective.implementation,effective:{provider:d,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:mt(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function yt(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function fn(e,n,r){let t=yt(n),{integrations:i,catalog:o}=n,s=r?.supplies??t.buildSupplyLookup(o),d=i,l=t.normalizeInstances({instances:d?.instances,defaultInstanceId:d?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??vt(n,t,e,l,s),R=mt(n,e,l),I=n.integrations?.services?.[e]?.provider,g=f.provider??(typeof I=="string"?I:typeof I=="object"&&I?String(I.provider):void 0),C={provider:g??null,layer:R??null},O=new Set(Object.keys(n.catalog.providers)),M=g!==void 0&&O.has(g)?Er(n.catalog,g,e):void 0,p=o.services[e],a=p!==void 0?!p.optional:void 0,m=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:C,...g!==void 0?{provider:g}:{},...g!==void 0&&R!==null?{layer:R}:{},...M!==void 0?{supplied:M}:{},...m!==void 0?{module:m}:{},...a!==void 0?{required:a}:{}}}function Er(e,n,r){return De(e,n,r)}function me(e){let n=new Set([...e.walk.vocabulary,...Object.keys(e.catalog.services),...Object.keys(e.walk.ownership)]),r=e.integrations?.services??{};for(let t of Object.keys(r))n.add(t);return[...n].sort()}function ve(e,n,r){let t={};for(let i of me(e))r&&!r.includes(i)||(t[i]=fn(i,e));return{contracts:_e(e.contracts),resolutions:t,issues:n}}function gn(e,n,r){let t=yt(n),i=t.buildSupplyLookup(n.catalog),o=n.integrations,s=t.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),d=s.instances.map(M=>M.id),y=n.integrations?.services?.[e],l=y?.instances?Object.keys(y.instances):void 0,f=St(l,d),R=new Map;for(let M of f)R.set(M,vt(n,t,e,M,i));let I=f.map(M=>{let p=R.get(M);return{instanceId:M,status:p.status,...p.statusMessage?{statusMessage:p.statusMessage}:{},...p.effective?{effective:p.effective}:{}}}),g=wt(n,e,s.defaultInstanceId??"*"),O={...fn(e,n,R.has(s.defaultInstanceId??"*")?{evaluation:R.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:I,inheritance:g};return{contracts:_e(n.contracts),resolution:O,issues:r.filter(M=>M.service===e)}}function St(e,n){if(n.length>0){let r=[...n];return e?.includes("*")&&r.push("*"),r}return e!==void 0&&e.length>0?e.includes("*")?["*"]:e:[]}function wt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"],s=e.walk.ownership[n],d=s!==void 0?$(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...d.layer==="module"&&d.provider?{provider:d.provider}:{}},{layer:"service",...typeof i?.provider=="string"?{provider:i.provider}:{},...i?.implementation?{implementation:i.implementation}:{}},{layer:"instance",...o?.provider?{provider:o.provider}:{},...o?.implementation?{implementation:o.implementation}:{}}]}function ye(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function ht(e,n,r){let t=e.catalog.services[n],i=e.walk.ownership[n];return{status:"evaluation-unavailable",statusMessage:r,binding:ge(e.integrations,e.walk,n).effective,...i!==void 0?{module:i}:{},...t!==void 0?{required:!t.optional}:{}}}function Fe(e,n,r){let t=B(n),i={};for(let o of me(e))r&&!r.includes(o)||(i[o]=ht(e,o,t));return{contracts:_e(n),resolutions:i,issues:[]}}function Rt(e,n,r){let t=B(r),i={...ht(n,e,t),instances:Or(n,e),inheritance:wt(n,e,xr(n))};return{contracts:_e(r),resolution:i,issues:[]}}function Or(e,n){let r=e.integrations?.services?.[n],t=e.integrations,i=Array.isArray(t?.instances)?t.instances.map(s=>s&&typeof s=="object"?s.id:void 0).filter(s=>typeof s=="string"):[],o=r?.instances?Object.keys(r.instances):void 0;return St(o,i).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function xr(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function mn(e,n,r){if(!(n in e.catalog.providers))throw new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 不 ∈ catalog(内联声明厂商无包级档案——判定归求值轴 resolution.supplied)`);let t;if(r.kind==="app")t=me(e);else if(r.kind==="module"){let o=e.walk.modules.find(s=>s.id===r.module);if(!o)throw new E("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=U(e.walk,o).ownedServices}else t=[r.service];let i=new Set(de(e.catalog,n));return{provider:n,scope:r,services:t.map(o=>({service:o,name:J(e.walk,o).name,supplied:i.has(o)}))}}function vn(e,n,r){if(n===null)return null;let t={};for(let i of r)t[i]={configSchema:ie(e,n,i)};return{provider:n,services:t}}function oe(e){return e===null||typeof e!="object"?JSON.stringify(e??null):Array.isArray(e)?`[${e.map(oe).join(",")}]`:`{${Object.keys(e).sort().map(r=>`${JSON.stringify(r)}:${oe(e[r])}`).join(",")}}`}var Mr="\0no-enum";function jr(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(oe))].sort().join(",")}]`:Mr}function Tr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:oe(n)}function Nr(e){let n=e.map(t=>Tr(t.subschema));if(n.some(t=>t===null)||new Set(n).size>1)return null;if(n[0]==='"object"'){let t=oe(e[0].subschema);return e.every(i=>oe(i.subschema)===t)?e[0].subschema:null}return new Set(e.map(t=>jr(t.subschema))).size===1?e[0].subschema:null}function $e(e){let n=[],r=!0,t=new Map;for(let[o,s]of Object.entries(e.services)){let d=s.configSchema;if(d===null){n.push(o);continue}if(!d||typeof d!="object"||Array.isArray(d))continue;let y=d;y.additionalProperties===!1&&(r=!1);let l=y.properties;if(!l||typeof l!="object"||Array.isArray(l))continue;let f=Array.isArray(y.required)?y.required:[];for(let R of Object.keys(l)){let I=t.get(R)??[];I.push({service:o,subschema:l[R],required:f.includes(R)}),t.set(R,I)}}let i=[];for(let[o,s]of t)i.push({key:o,schema:Nr(s),sources:s.map(({service:d,required:y})=>({service:d,required:y})),global:s.some(d=>!!d.subschema&&typeof d.subschema=="object"&&d.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:i}}function yn(e,n,r){if(e==="app"){let o=n.integrations?.provider;return typeof o=="string"&&o.length>0?o:null}let t=n.walk.modules.find(o=>o.id===r);return!t||!U(n.walk,t).writable?null:$(n.integrations,t.id).provider}var It={integrationSchemas:null,integrationFieldRegistry:null};function kt(e){return{...e,fields:e.fields.filter(n=>n.global)}}function Sn(e){let n=yn("app",e);if(n===null)return It;let r=vn(e,n,de(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:kt($e(r))}}function wn(e,n){let r=yn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return It;let i=(t.descriptor.declare.owns??[]).map(s=>s.service),o=vn(e,r,i.filter(s=>De(e.catalog,r,s)));return{integrationSchemas:o,integrationFieldRegistry:kt($e(o))}}function Pr(e){return Sn(e).integrationSchemas}function Vr(e,n){return wn(e,n).integrationSchemas}function Dr(e,n){let r=e.walk.ownership[n];if(r!==void 0)return $(e.integrations,r).provider;let t=e.integrations?.provider;return typeof t=="string"&&t.length>0?t:null}function Le(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=Dr(e,n);return t===null?null:{provider:t,configSchema:ie(e,t,n)}}if(typeof r=="string")return{provider:r,configSchema:ie(e,r,n)};if(K(r)){let t=r;return{provider:t.provider,configSchema:ie(e,t.provider,n,t.configSchema)}}return null}function hn(e,n){let r=Le(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return $e(t)}function Se(e,n){if(n===void 0||!n.startsWith("secret://"))return;let r=n.slice(9),t=ce(e,r);if(t)return{type:t.type,ref:n,masked:we(t.values)}}function Rn(e){let n=e.integrations,r={credential:Se(e.appDir,typeof n?.credentialRef=="string"?n.credentialRef:void 0)??null,byInstance:{}};for(let{id:i}of n?.instances??[]){let o=n?.credentialRefByInstance?.[i];o!==void 0&&(r.byInstance[i]=Se(e.appDir,o)??null)}let t={};for(let[i,o]of Object.entries(n?.services??{})){let s={credential:Se(e.appDir,o.credentialRef)??null,byInstance:{}};for(let[d,y]of Object.entries(o.instances??{}))s.byInstance[d]=Se(e.appDir,y.credentialRef)??null;t[i]=s}return{app:r,services:t}}function In(e,n){return{types:(n===void 0?Object.keys(e.catalog.credentialTypes):[...new Set(Object.values(e.catalog.providers[n]??{}).map(t=>t.credentialType))]).sort().map(t=>{let i=e.catalog.credentialTypes[t];return{credentialType:t,credentialSchema:i?pn(e.appDir,i.packageDir,i.credentialSchema):null}})}}import _r from"path";var Fr={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function kn(e,n){if(!n||n.length===0)return new Set;let r=Fr[e],t=[...new Set(n)].filter(i=>!r.includes(i));if(t.length>0)throw new E("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}function $r(e){let n=e?.kind;if(n!=="app"&&n!=="module"&&n!=="service")throw new E("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new E("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new E("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function Lr(e,n={}){let r=Be(),t=Promise.resolve(),i={appDir:e,cache:r};function o(p){if(se(p)==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function s(p){if(se(p)!=="ok")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function d(p){return at(i,p)}function y(p){let a=p.integrations?.services;return a&&typeof a=="object"?Object.keys(a):[]}async function l(){let p=await N(e),a=d(p),m=a.integrations;if(m===null)return[];let h={resolveEffectiveService:f(p.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(p.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(p.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:p.module.RESOURCE_TYPE_IDS??[]},u=ue(e,a.walk,m,process.env);return ee({contracts:h,integrations:m,supplies:h.buildSupplyLookup(a.catalog),...u})}function f(p,a){if(typeof p!="function")throw new E("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${a} 缺席(形态异常)`);return p}function R(p){let a=t.then(p,p);return t=a.catch(()=>{}),a}let I={async loadModules(p){let a=await N(e);return sn(d(a),p)},async loadModule(p,a){let m=kn("module",a?.include),h=await N(e),u=d(h),v=Oe(u.walk,p),w=an(u,v.id);if(m.has("serviceResolutions")){let c=[...new Set([...w.ownedServices,...w.services.map(S=>S.service)])];w.serviceResolutions=ye(h)?await l().then(S=>ve(u,S,c)):Fe(u,h,c)}if(m.has("integrationSchemas")||m.has("integrationFieldRegistry")){let c=wn(u,v.id);m.has("integrationSchemas")&&(w.integrationSchemas=c.integrationSchemas),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=c.integrationFieldRegistry)}return w},async loadApp(p){let a=kn("app",p?.include),m=await N(e),h=d(m),u=cn(h);if(a.has("serviceResolutions")&&(u.serviceResolutions=ye(m)?await l().then(v=>ve(h,v)):Fe(h,m)),a.has("integrationSchemas")||a.has("integrationFieldRegistry")){let v=Sn(h);a.has("integrationSchemas")&&(u.integrationSchemas=v.integrationSchemas),a.has("integrationFieldRegistry")&&(u.integrationFieldRegistry=v.integrationFieldRegistry)}return u},async loadService(p,a){let m=kn("service",a?.include),h=await N(e),u=d(h),v=Y(u.walk,y(u),p),w=dn(u,v);return m.has("integrationSchemas")&&(w.integrationSchemas=Le(u,v)),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=hn(u,v)),w},async loadServiceResolutions(p){let a=await N(e),m=d(a);if(!ye(a))return Fe(m,a,p);let h=await l();return ve(m,h,p)},async loadServiceResolution(p){let a=await N(e),m=d(a),h=Y(m.walk,y(m),p);if(!ye(a))return Rt(h,m,a);let u=await l();return gn(h,m,u)},async loadProviders(){let p=await N(e);return ln(d(p))},async loadProviderSupply(p,a){$r(a);let m=await N(e);return mn(d(m),p,a)},async loadProviderService(p,a){let m=await N(e),h=d(m),u=Y(h.walk,y(h),a);return un(h,p,u)},async loadCredentials(){let p=await N(e);return Rn(d(p))},async loadCredentialTypes(p){let a=await N(e);return In(d(a),p)}},g=en(e,{onApplied:n.onApplied,cache:r}),C={async writeAppIntegration(p,a){await g.warmup();let m=await N(e);return o(m),R(()=>g.applyApp(p,a))},async writeModuleIntegration(p,a,m){await g.warmup();let h=await N(e);return o(h),R(()=>{let u=Oe(d(h).walk,p);return g.applyModule(u.id,a,m)})},async writeServiceIntegration(p,a,m){await g.warmup();let h=await N(e);return o(h),R(()=>{let u=d(h),v=Y(u.walk,y(u),p);return g.applyService(v,a,m)})},async deleteServiceIntegration(p){await g.warmup();let a=await N(e);return o(a),R(()=>{let m=d(a),h=Y(m.walk,y(m),p);return g.deleteService(h)})}},O={invalidate(){r.invalidate(),We(e)},async resolveContracts(){return N(e)},walkManifests(){return M(e)},parseModuleDescriptor(p){return ae(p)},loadProviderCatalogRaw(){return He(e)},async readIntegrationsConfig(){return G(e,r)},async writeIntegrationsConfig(p){return R(()=>Br(e,p,r))},async ensureMockBindings(){return R(()=>nn(e))},async evaluateIntegrationServices(p){await g.warmup();let a=await N(e);s(a);let m={resolveEffectiveService:f(a.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(a.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(a.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:a.module.RESOURCE_TYPE_IDS??[]};return ee({...p,contracts:m})}};function M(p){return D(p,r)}return{...I,...C,...O}}function Br(e,n,r){let t=_r.join(e,"config","integrations.json");F(t,`${JSON.stringify(n,null,2)}
9
- `),r.invalidate([t])}export{te as APP_INTEGRATION_NODE_KEYS,E as AppToolkitError,xe as MODULE_INTEGRATION_NODE_KEYS,z as SAFE_NAME_PATTERN,on as appProviderBinding,Kt as assertValidModuleId,$e as buildIntegrationFieldRegistry,Ht as buildOwnershipMap,ue as buildPredicateAssembly,Je as checkInstanceKeys,Yt as collectDeclaredModules,B as contractsNotResolvedMessage,Lr as createAppToolkit,Be as createFileCache,en as createWriteCore,ir as credentialArtifactExists,fe as deepEqual,Q as deriveStem,Wn as discoverContractPackages,Se as echoForRef,Vn as ensureDir,nn as ensureMockBindings,Ze as evaluateAppIntegrationIssues,ee as evaluateIntegrationServices,Ue as expandEnvVars,Un as extractModuleIdFromSource,yn as formProviderOf,We as invalidateContractsResolver,K as isControlledInlineProvider,$n as isValidModuleId,Pr as loadAppIntegrationSchemas,cn as loadAppView,In as loadCredentialTypesView,Rn as loadCredentialsView,an as loadModuleDetailView,Vr as loadModuleIntegrationSchemas,sn as loadModulesView,be as loadProviderCatalog,He as loadProviderCatalogRaw,un as loadProviderServiceDetailView,mn as loadProviderSupplyView,ln as loadProvidersView,dn as loadServiceDetailView,hn as loadServiceFieldRegistry,Le as loadServiceIntegrationSchemas,gn as loadServiceResolutionDetail,ve as loadServiceResolutionsView,Re as manifestPath,we as maskCredentialValues,Cn as moduleDependencySchema,jn as moduleDescriptorSchema,U as moduleOwnershipWritable,Ve as moduleProviderBinding,bn as pageContribSchema,ae as parseModuleDescriptor,de as providerFootprint,En as providerSlotContribSchema,cr as pruneIntegrationBindings,Fn as readAppManifest,ze as readAppManifestFull,ce as readCredentialFile,G as readIntegrationsConfig,Yn as readIntegrationsStrict,ne as reconcileOrphanCredentials,Gn as refToEnvKey,Bt as removeNpmModule,me as resolutionKeys,N as resolveContractsForApp,N as resolveContractsForAppExport,vn as resolveLayerIntegrationSchemas,$ as resolveModuleBinding,Oe as resolveModuleKey,Y as resolveServiceKey,fn as resolveServiceSummary,Mn as resourceNeedContribSchema,On as serviceConsumeContribSchema,xn as serviceOwnContribSchema,ge as serviceProviderBinding,W as stemToFilePath,jt as stemToRef,An as tabContribSchema,Ut as updateNpmModule,Wt as upsertMiniappContainer,Lt as upsertNpmModule,D as walkManifests,$t as writeAppManifest,F as writeAtomic,Ke as writeCredentialFile};
1
+ import{a as Be,b as se,c as T,d as We}from"./chunk-K5FIGT5A.js";import{z as b}from"zod";var z=/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/,bt=b.object({cardType:b.string(),schemaVersion:b.number().optional()}),bn=b.object({route:b.string(),component:b.string()}),An=b.object({route:b.string(),label:b.string().optional(),icon:b.string().optional(),order:b.number().optional()}),Cn=b.object({id:b.string(),range:b.string().optional(),required:b.boolean().default(!0)}),En=b.object({service:b.string(),provider:b.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:b.string(),credentialType:b.string(),local:b.boolean().optional(),configSchema:b.string().optional(),credentialSchema:b.string().optional()}),On=b.object({service:b.string(),optional:b.boolean().default(!0),defaults:b.array(b.object({provider:b.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:b.string()})).default([]),name:b.string().optional(),description:b.string().optional()}),xn=b.object({service:b.string()}).strict(),Mn=b.object({id:b.string(),type:b.string()}),jn=b.object({$comment:b.union([b.string(),b.record(b.string(),b.unknown())]).optional(),$schema:b.string().optional(),schemaVersion:b.number().default(1),id:b.string(),name:b.string().optional(),description:b.string().optional(),hidden:b.boolean().optional(),version:b.string().default("0.0.0"),kind:b.enum(["platform","business","third-party"]).default("business"),risk:b.object({level:b.enum(["high","medium","low"]).default("low"),writeBoundary:b.enum(["sdk-enforced","source"]).default("source")}).default({}),distribution:b.object({defaultMode:b.enum(["hybrid","sdk","codegen","local"]).default("codegen")}).default({}),declare:b.object({handlers:b.array(b.string()).default([]),tools:b.array(b.string()).default([]),cards:b.array(bt).default([]),routes:b.array(b.string()).default([]),pages:b.array(bn).default([]),tabs:b.array(An).default([]),providers:b.object({id:b.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)").optional(),slots:b.array(En).default([])}).default({}),owns:b.array(xn).default([]),consumes:b.array(On).default([]),resources:b.array(Mn).default([])}).default({}),dependencies:b.object({modules:b.array(Cn).default([])}).default({}),env:b.array(b.string()).default([])}).strict();function At(e){if(!e||typeof e!="object"||Array.isArray(e))return[];let n=[],r=e;"contributes"in r&&n.push("(root): manifest 旧键 `contributes` 已更名 `declare`(v6 声明面)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let t=r.declare;t&&typeof t=="object"&&!Array.isArray(t)&&"services"in t&&n.push("declare: manifest 旧键 `declare.services` 已更名 `declare.consumes`(消费关系定向化)——同上三路径升级"),!("id"in r)&&"name"in r&&n.push("(root): manifest 标识键 `name` 已更名 `id`(v7 词汇统一)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let i=t&&typeof t=="object"&&!Array.isArray(t)?t:void 0,o=Array.isArray(i?.consumes)&&i.consumes.some(s=>s!==null&&typeof s=="object"&&"title"in s);return("title"in r||o)&&n.push("(root): manifest 展示名键 `title` 已更名 `name`(v7 词汇统一;declare.consumes[].title 同步改 name)——同上三路径升级"),n}function ae(e){let n=At(e);if(n.length>0)return{ok:!1,errors:n,legacy:!0};let r=jn.safeParse(e);return r.success?{ok:!0,value:r.data}:{ok:!1,errors:r.error.issues.map(t=>`${t.path.join(".")||"(root)"}: ${t.message}`)}}var Ct=/\$\$?\{([A-Z][A-Z0-9_]*)(?::-([^}]*))?\}/g;function Nn(e){return JSON.stringify(e).slice(1,-1)}function Ue(e,n=process.env){let r=[],t=e.replace(Ct,(i,o,s)=>{if(i.startsWith("$$"))return i.slice(1);let d=n[o];return d!==void 0?Nn(d):s!==void 0?Nn(s):(r.push(o),i)});return r.length>0?{missing:r}:{text:t,missing:[]}}import{mkdirSync as Et,existsSync as Tn,readFileSync as Ot,writeFileSync as xt}from"fs";import{dirname as Mt,join as Pn}from"path";function we(e){let n={};for(let[r,t]of Object.entries(e)){if(typeof t!="string"){n[r]=null;continue}n[r]=t.length<=4?"****":`${t.slice(0,2)}****`}return n}var E=class extends Error{code;httpStatus;fields;constructor(n,r,t,i){super(t),this.name="AppToolkitError",this.code=n,this.httpStatus=r,this.fields=i}};function B(e){return e.notes.length>0?e.notes[0]:e.version===null?"contracts 不可解析(未安装)——检查应用依赖安装后重试":e.strictValidation?e.ownershipBindingV6===!1?`contracts ${e.version??"(版本未知)"} 不支持 v6 modules 绑定形状(OWNERSHIP_BINDING_V6 标记缺席)——升级应用 @tbox.cn/app-contracts 依赖后可用`:"contracts workspace 源码态未构建——执行 pnpm --filter @tbox.cn/app-contracts build 后重试":`contracts ${e.version} 无严格校验面(需 ≥0.9.0)——升级应用 @tbox.cn/app-contracts 依赖后可用`}function he(e,n){if(n!==void 0&&(n.includes("/")||n.includes("\\")||n.includes("..")))throw new E("VALIDATION_FAILED",400,`凭据 stem 派生输入含路径敌对字符(${e})——拒绝派生`)}function Q(e){if(he("provider",e.provider),he("service",e.service),he("instanceId",e.instanceId),he("domain",e.domain),e.instanceId!==void 0){let n=e.domain??e.service??"global";return`${e.provider}-${e.instanceId}-${n}`}return e.service!==void 0?`${e.provider}-${e.service}`:`${e.provider}-global`}function jt(e){return`secret://${e}`}function W(e){return`config/credentials/${e}.json`}function ce(e,n){let r=Pn(e,W(n));if(!Tn(r))return null;try{let t=JSON.parse(Ot(r,"utf8"));if(typeof t.type!="string")return null;let{type:i,...o}=t,s={};for(let[d,S]of Object.entries(o))typeof S=="string"&&(s[d]=S);return{type:i,values:s}}catch{return null}}function Ke(e,n,r){let t=Pn(e,W(n)),i=Tn(t);return Et(Mt(t),{recursive:!0}),xt(t,`${JSON.stringify({type:r.type,...r.values},null,2)}
2
+ `,"utf8"),i}import{mkdirSync as Nt,renameSync as Tt,writeFileSync as Pt}from"fs";import{dirname as Vt}from"path";function $(e,n){Vn(Vt(e));let r=`${e}.tmp-${process.pid}-${Date.now()}`;Pt(r,n,"utf8"),Tt(r,e)}function Vn(e){Nt(e,{recursive:!0})}import{existsSync as _,readdirSync as Ge,readFileSync as X}from"fs";import{join as V}from"path";import{existsSync as Dt,readFileSync as Dn,mkdirSync as _t,writeFileSync as $t}from"fs";import _n from"path";function Re(e){return _n.join(e,".tbox","app.json")}function $n(e){let n=Re(e);if(!Dt(n))return null;try{let r=JSON.parse(Dn(n,"utf8")),t=r?.templateVersion;return typeof t!="string"||t.trim().length===0?null:{templateVersion:t.trim(),npmModules:Array.isArray(r?.npmModules)?r.npmModules:[]}}catch{return null}}function Ft(e,n){let r=Re(e);_t(_n.dirname(r),{recursive:!0}),$t(r,`${JSON.stringify(n,null,2)}
3
+ `,"utf8")}function ze(e){let n=$n(e);if(n===null)return null;let r=Re(e);try{let t=JSON.parse(Dn(r,"utf8"));return{...n,miniappContainers:Array.isArray(t?.miniappContainers)?t.miniappContainers:[]}}catch{return{...n,miniappContainers:[]}}}function Lt(e,n){let r=e.npmModules.filter(t=>t.id!==n.id);return{...e,npmModules:[...r,n]}}function Bt(e,n){return{...e,npmModules:e.npmModules.filter(r=>r.id!==n)}}function Wt(e,n){let r=(e.miniappContainers??[]).filter(t=>t.id!==n.id);return{...e,miniappContainers:[...r,n]}}function Ut(e,n,r){return{...e,npmModules:e.npmModules.map(t=>t.id===n?{...t,...r}:t)}}function Fn(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)&&!e.includes("..")}function Kt(e,n){if(!Fn(e))throw new Error(`非法模块 id "${e}"(来自 ${n}):仅允许小写字母/数字/中划线`)}function Ln(e){try{let n=JSON.parse(e);if(!Array.isArray(n.slots))return null;let r=n.slots.filter(i=>typeof i=="string"),t={};if(n.meta&&typeof n.meta=="object"&&!Array.isArray(n.meta))for(let[i,o]of Object.entries(n.meta)){if(!o||typeof o!="object"||Array.isArray(o))continue;let{name:s,description:d}=o,S={};typeof s=="string"&&s.length>0&&(S.name=s),typeof d=="string"&&d.length>0&&(S.description=d),(S.name!==void 0||S.description!==void 0)&&(t[i]=S)}return{slots:r,meta:t}}catch{return null}}function Ie(e,n){let r=t=>{try{let i=JSON.parse(t),o=ae(i);if(o.ok)return{kind:"strict",id:o.value.id,version:o.value.version,descriptor:o.value,declare:o.value.declare};if(o.legacy)return{kind:"legacy",detail:o.errors.join("; ")};if(i&&typeof i=="object"&&"declare"in i){let s=i;return{kind:"loose",...typeof s.id=="string"?{id:s.id}:{},declare:{providers:s.declare?.providers,consumes:s.declare?.consumes}}}return null}catch{return null}};if(n)return n.read(e,r)??null;if(!_(e))return null;try{return r(X(e,"utf8"))}catch{return null}}function zt(e){let n=V(e,".tbox","app.json");if(!_(n))return[];try{let r=JSON.parse(X(n,"utf8"));return Array.isArray(r.npmModules)?r.npmModules.filter(t=>!!t&&typeof t=="object"&&typeof t.id=="string"&&typeof t.package=="string"):[]}catch{return[]}}function Gt(e){let n=V(e,".tbox-dev.local"),r=V(n,"dev-manifest.json");if(!_(r))return[];try{let t=JSON.parse(X(r,"utf8")),i=[];for(let[o,s]of Object.entries(t.redirects??{}))typeof s!="string"||!o.startsWith("@tbox.cn/app-")||i.push({pkg:o,dir:V(n,s)});return i}catch{return[]}}function Wn(e,n){let r=[],t=[e];for(let d of["apps","packages"]){let S=V(e,d);if(_(S))try{for(let l of Ge(S,{withFileTypes:!0}))l.isDirectory()&&t.push(V(S,l.name))}catch{}}let i=new Set,o=(d,S,l)=>{let f=n?n.read(S,Ln):Ln(X(S,"utf8"));f!=null&&r.push({dir:d,slots:f.slots,meta:f.meta,via:l})},s=V(e,"config","service-slots.json");_(s)&&o(e,s,"config-override");for(let d of t){let S=V(d,"node_modules","@tbox.cn");if(!_(S))continue;let l=[];try{l=Ge(S)}catch{continue}for(let f of l){let R=V(S,f);if(i.has(R))continue;i.add(R);let k=V(R,"service-slots.json"),g=V(R,"src","service-slots.json");_(k)?o(R,k,"package"):_(g)&&o(R,g,"package")}}for(let d of t)for(let S of[V(d,"service-slots.json"),V(d,"src","service-slots.json")])_(S)&&o(d,S,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{},vendorMeta:{}},i={},o=[],s={},d=new Set,S=(a,m,h,u,v)=>{for(let w of a){let c=v===void 0||v===w.provider;c&&(t.vendorMeta[w.provider]??={owner:m,...u?.name?{name:u.name}:{},...u?.description?{description:u.description}:{}});let y=t.providers[w.provider]??={},A=y[w.implementation];A?A.services.includes(w.service)||A.services.push(w.service):(y[w.implementation]={provider:w.provider,implementation:w.implementation,credentialType:w.credentialType,owner:m,...c&&u?.name?{name:u.name}:{},...c&&u?.description?{description:u.description}:{},...w.local?{local:!0}:{},...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},services:[w.service]},t.credentialTypes[w.credentialType]??={owner:m,packageDir:h,...w.credentialSchema?{credentialSchema:w.credentialSchema}:{}});let I=`${w.provider}\0${w.service}`;i[I]||(i[I]={...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},packageDir:h})}},l=(a,m,h)=>{t.providers[a]??={},t.vendorMeta[a]??={owner:m,...h?.name?{name:h.name}:{},...h?.description?{description:h.description}:{}}},f=a=>a.kind==="strict"?{name:a.descriptor.name,description:a.descriptor.description}:void 0,R=(a,m)=>{for(let h of a){let u=s[h];u===void 0?s[h]=m:u!==m&&o.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:m,message:`服务 ${h} 归属冲突:${u} 与 ${m} 均声明 owns(先声明 ${u} 胜出)——修正 manifest declare.owns 互斥`})}},k=(a,m)=>{a.kind==="legacy"&&o.push({severity:"error",code:"OLD_MANIFEST_KEY",module:m,message:`${m}:${a.detail}`})},g=a=>a.kind==="strict"||a.kind==="loose"?a.declare:null,C=(a,m)=>{let h=a.optional!==!1,u=a.defaults??[],v=t.services[a.service];if(v){v.optional=v.optional&&h;let w=new Set(v.defaults.map(c=>`${c.provider}\0${c.implementation}`));for(let c of u){let y=`${c.provider}\0${c.implementation}`;w.has(y)||(v.defaults.push(c),w.add(y))}v.owners.includes(m)||v.owners.push(m);return}t.services[a.service]={optional:h,defaults:[...u],...a.name?{name:a.name}:{},...a.description?{description:a.description}:{},owners:[m]}};for(let a of zt(e)){if(d.has(a.id))continue;let m=V(e,"packages",a.id),h=V(e,"node_modules",...a.package.split("/")),u=Ie(V(m,"tbox.module.json"),n)??Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){k(u,a.id),d.add(a.id);continue}if(!u)continue;d.add(a.id);let v=_(V(m,"tbox.module.json"))?m:h,w=g(u);u.kind==="strict"&&r.push({id:a.id,dir:v,pkg:a.mode==="sdk"?a.package:`@app/${a.id}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&l(y,a.package,f(u)),c.length&&S(c,a.package,v,f(u),y);let A=w?.consumes??[];for(let M of A)C(M,a.package);let I=u.kind==="strict"?u.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),a.id)}for(let{pkg:a,dir:m}of Gt(e)){let h=Ie(V(m,"tbox.module.json"),n);if(h?.kind==="legacy"){k(h,a);continue}if(!h?.id||d.has(h.id))continue;d.add(h.id);let u=g(h),v=u?.providers?.slots??[],w=u?.providers?.id;w&&l(w,a,f(h)),v.length&&S(v,a,m,f(h),w);let c=u?.consumes??[];for(let A of c)C(A,a);let y=h.kind==="strict"?h.descriptor.declare.owns:[];y.length&&R(y.map(A=>A.service),h.id)}let O=V(e,"packages");if(_(O)){let a=[];try{a=Ge(O,{withFileTypes:!0}).filter(m=>m.isDirectory()).map(m=>m.name)}catch{}for(let m of a){if(d.has(m))continue;let h=V(O,m),u=Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){k(u,m),d.add(m);continue}if(!u)continue;let v=u.id??m;if(d.has(v))continue;d.add(v);let w=g(u);u.kind==="strict"&&r.push({id:v,dir:h,pkg:`@app/${v}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&l(y,`@app/${v}`,f(u)),c.length&&S(c,`@app/${v}`,h,f(u),y);let A=w?.consumes??[];for(let M of A)C(M,`@app/${v}`);let I=u.kind==="strict"?u.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),v)}}let x=new Set,p={};for(let a of Wn(e,n)){for(let m of a.slots)x.add(m);for(let[m,h]of Object.entries(a.meta))p[m]===void 0&&(p[m]=h)}return{modules:r,catalog:t,serviceSchemas:i,vocabulary:[...x].sort(),slotMeta:p,ownership:s,declarationIssues:o}}function Bn(e,n,r){let t=V(e,"src",n,"index.ts");if(!_(t))return!1;try{let i=X(t,"utf8");return new RegExp(`export\\s+const\\s+${r}\\b`).test(i)}catch{return!1}}function Jt(e){let n=V(e,"src","server","index.ts");if(!_(n))return"";try{return X(n,"utf8")}catch{return""}}function Un(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function Yt(e){let n=[],r=D(e),t=ze(e),i=new Map;for(let o of t?.npmModules??[])i.set(o.id,o.mode);for(let o of r.modules){let s=i.get(o.id)??"local",d=Bn(o.dir,"server","serverModule"),S=o.descriptor.declare;n.push({id:o.id,pkg:s==="sdk"?o.pkg:`@app/${o.id}`,mode:s,hasServerEntry:d,hasClientEntry:Bn(o.dir,"client","clientModule"),hasCards:(S.cards?.length??0)>0,...d?{moduleId:Un(Jt(o.dir))}:{}})}return n.sort((o,s)=>o.id.localeCompare(s.id))}function Ht(e){return D(e).ownership}function F(e,n){let r=e?.modules?.[n]?.provider;if(typeof r=="string"&&r.length>0)return{provider:r,layer:"module"};let t=e?.provider;return typeof t=="string"&&t.length>0?{provider:t,layer:"app"}:{provider:null,layer:null}}function U(e,n){let r=(n.descriptor.declare.owns??[]).map(t=>t.service).sort();return r.length===0?{writable:!1,reason:"zero-ownership",ownedServices:[]}:{writable:!0,ownedServices:r}}function de(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(r=>r.services))].sort()}function K(e){if(!e||typeof e!="object")return!1;let n=Object.keys(e),r=new Set(["provider","credentialType","configSchema"]);if(!n.every(i=>r.has(i)))return!1;let t=e;return typeof t.provider=="string"&&t.provider.length>0&&typeof t.credentialType=="string"&&t.credentialType.length>0&&(t.configSchema===void 0||typeof t.configSchema=="string")}function Kn(e,n,r){return e==="*"||r.has(e)?null:{severity:"error",code:"INSTANCE_KEY_NOT_REGISTERED",instance:e,message:`integrations: ${n} 键 ${e} 不在 malls 白名单内(${[...r].join(", ")})`}}function Je(e,n){let r=new Set(n),t=[],i=(o,s)=>{let d=Kn(o,s,r);d&&t.push(d)};for(let o of Object.keys(e.configByInstance??{}))i(o,"configByInstance");for(let o of Object.keys(e.credentialRefByInstance??{}))i(o,"credentialRefByInstance");for(let[o,s]of Object.entries(e.services??{}))for(let d of Object.keys(s.instances??{}))i(d,`services.${o}.instances`);return t}function ee(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:i,demandedServices:o,supplies:s,malls:d,credentialSchemaMissing:S,vendorConfigKeys:l,vendorGlobalConfigKeys:f,vendorConfigSchemaMissing:R,credentialFileMissing:k,credentialFileType:g,realmSwitchHints:C,moduleResourceNeeds:O,ownership:x,installedModuleIds:p}=e,a=d?new Set(d):void 0;for(let c of C??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:c});let m=new Set(Object.keys(i).map(c=>c.slice(0,c.indexOf("\0"))).filter(c=>c.length>0)),h=(c,y,A,I)=>{if(typeof A?.provider=="string"&&typeof A.implementation=="string"&&A.provider&&A.implementation)return i[le(A.provider,A.implementation)]?.credentialType;if(typeof y.provider=="string"&&typeof y.implementation=="string")return i[le(y.provider,y.implementation)]?.credentialType;let M=y.provider?.credentialType;if(typeof M=="string")return M;if(!s)return;let N=I??Object.keys(y.instances??{})[0]??"",j=r.resolveEffectiveService(t,c,N,s,x);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return i[le(j.effective.provider,j.effective.implementation)]?.credentialType};if(k||g)for(let[c,y]of Object.entries(t.services))for(let[A,I]of Object.entries(y.instances??{})){if(I.enabled===!1)continue;let M=I.credentialRef??y.credentialRef??t.credentialRefByInstance?.[A]??t.credentialRef;if(typeof M!="string"||!M.startsWith("secret://"))continue;let N=M.slice(9);k?.[N]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:c,instance:A,message:`integrations: 凭据文件缺失 ${N}(${c}@${A} effective ref=${M};档内 config/credentials/ 无此文件)`});let j=g?.[N];if(j){let P=h(c,y,I,A);P&&j!==P&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:c,instance:A,message:`integrations: 凭据文件 ${N}.json type=${j} 与绑定 credentialType ${P} 不一致(${c}@${A}——transport 创建期将按 type 选策略)`})}}let u=(c,y)=>{if(!a)return;let A=Kn(c,y,a);A&&n.push(A)};for(let[c]of Object.entries(t.configByInstance??{}))u(c,"configByInstance");for(let[c]of Object.entries(t.credentialRefByInstance??{}))u(c,"credentialRefByInstance");let v=Object.entries(t.services).filter(([,c])=>c.instances==null||c.instances["*"]!=null).map(([c])=>c);if(v.length>0){let c=Object.entries(t.services).filter(([,y])=>y.instances!=null&&y.instances["*"]==null).map(([y])=>y);c.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${v.join(", ")};显式键集:${c.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let w=r.normalizeInstances({instances:t.instances,defaultInstanceId:t.defaultInstanceId});w.instances.length>=2&&w.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${w.instances.length} 个部署实例(${w.instances.map(c=>c.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[c,y]of Object.entries(t.services)){if(!o[c]&&x?.[c]===void 0&&n.push({severity:"warning",code:"SLOT_NOT_DECLARED",service:c,message:`integrations: 服务槽 ${c} 无消费方声明(拼写错误或需求方未安装)——若为拆分前旧槽位词汇(member.main/parking.main/promotion.read/shopping-guide.main),参照 cookbook·app-config 槽位迁移配方展开为新槽`}),typeof y.provider=="string"?typeof y.implementation=="string"&&!i[le(y.provider,y.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,message:`integrations: provider ${y.provider}/${y.implementation} 未命中已装供给(${c} 槽级)——装对应 provider 包或改绑`}):y.provider!==void 0&&!K(y.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,message:`integrations: 内联 provider 超受控形状(${c} 槽级;允许键 provider/credentialType/configSchema)`}),S){let I=h(c,y);I&&S[I]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:c,message:`integrations: credentialType ${I} 的 schema 引用不存在(${c};manifest 声明指向缺失文件)`})}typeof y.provider=="object"&&typeof y.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 内联厂商声明必须同时提供 implementation(${c} 槽级)`});for(let[I,M]of Object.entries(y.instances??{})){u(I,`services.${c}.instances`);let N=M.provider!==void 0,j=M.implementation!==void 0;if(j&&!N&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,instance:I,message:`integrations: 实例级 implementation 需伴随 provider(${c}@${I}——impl-only 禁止,provider 是绑定组头)`}),N&&j){let P=M.provider,L=M.implementation;typeof P=="string"&&typeof L=="string"?i[le(P,L)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,instance:I,message:`integrations: 实例级 provider 覆盖 ${P}/${L} 未命中已装供给(${c}@${I})`}):K(P)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,instance:I,message:`integrations: 实例级内联 provider 超受控形状(${c}@${I})`})}}}for(let[c,y]of[["root",t.provider],...Object.entries(t.modules??{}).map(([A,I])=>[`modules.${A}`,I?.provider])])typeof y!="string"||y.length===0||m.has(y)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:c.startsWith("modules.")?c.slice(8):void 0,message:`integrations: ${c} provider ${y} 未命中已装供给——装对应 provider 包或 provider use 改绑(自声明厂商另查其包内 tbox.module.json declare.providers.slots——补槽声明前不在供给集)`});{let c=y=>{let A=x?.[y],I=A!=null?t.modules?.[A]:void 0;if(typeof I?.provider=="string"&&I.provider)return{provider:I.provider,where:`modules.${A}`};if(typeof t.provider=="string"&&t.provider)return{provider:t.provider,where:"root"}};for(let[y,A]of Object.entries(t.services)){if(typeof A.provider!="string"||!A.provider)continue;let I=c(y);!I||I.provider===A.provider||n.push({severity:"warning",code:"BINDING_SHADOWED",service:y,module:I.where.startsWith("modules.")?I.where.slice(8):void 0,message:`integrations: 槽级显式绑定 ${A.provider} 优先于 ${I.where} 层默认 ${I.provider}(${y}——绑定组层序 inst > slot > modules > root)——接入切换残留请剥离槽级 provider(改槽为 {} 激活节点或逐槽 provider bind 覆盖);有意差异化请忽略`})}}if(s)for(let[c,y]of Object.entries(t.services)){let A=y.instances?Object.keys(y.instances):[""];for(let I of A){let M=r.resolveEffectiveService(t,c,I,s,x);M.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:c,instance:I||void 0,message:`integrations: ${M.message}`})}}for(let[c,y]of Object.entries(t.services))y.implementation!==void 0&&y.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 槽级 implementation 需伴随 provider(${c}——impl-only 禁止,provider 是绑定组头)`});for(let[c,y]of Object.entries(t.modules??{})){if(!(y?.provider!==void 0||y?.config!==void 0))continue;let I=p?!p.has(c):!1,M=0;if(x)for(let j of Object.values(x))j===c&&(M+=1);if(I||!(x===void 0)&&M===0){let j=I?"未安装(键 = install id)":"未声明任何 owns(无模块级配置位)";n.push({severity:"error",code:"MODULE_CONFIG_DEAD",module:c,message:`integrations: modules.${c} 携带 provider/config 但模块${j}(MODULE_CONFIG_DEAD——模块级集成位作用于 declare.owns 服务,改 declare.owns 或删除该节点)`})}}if(l){let c=new Set,y=!1,A=I=>{typeof I!="string"||I.length===0||(l[I]&&c.add(I),!l[I]&&!R?.[I]&&(y=!0),R?.[I]&&(y=!0))};A(t.provider);for(let I of Object.values(t.modules??{}))A(I?.provider);for(let I of Object.values(t.services)){let M=I.provider;A(typeof I.provider=="string"?I.provider:M?.provider)}for(let I of c)l[I]?.has("mallId")&&n.push({severity:"warning",code:"MALL_IDENTITY_IN_CONFIG_SCHEMA",message:`integrations: 厂商 ${I} configSchema 声明商场身份键 mallId——商场身份恒来自会话 scope(mallId),不应作 config 键/参数模板;厂商独立编号用语义前缀键(如 parkingMallId)按实例差异化(见 npx --yes @tbox.cn/app-cli skills get provider-custom「商场身份单源」)`});if(c.size>0&&!y){let I=new Set;for(let j of c)for(let P of l[j]??[])I.add(P);let M=new Set;for(let j of c)for(let P of f?.[j]??[])M.add(P);let N=(j,P,L,Z)=>{for(let[q]of Object.entries(j??{}))(L??I).has(q)?Z&&Z.size>0&&!Z.has(q)&&n.push({severity:"warning",code:"GLOBAL_FIELD_UNDECLARED",message:`integrations: ${P} 键 ${q} 过 schema 校验但未声明 x-tbox-global(不进应用/模块全局表单;已配置值照常生效——如需全局编辑请在 provider schema 标记)`}):n.push({severity:"error",code:"DOMAIN_CONFIG_INVALID",message:`integrations: ${P} 键 ${q} 不在引用厂商(${[...c].join("/")})任何槽 schema properties 内(死配置)`})};N(t.config,"root.config",void 0,M);for(let[j,P]of Object.entries(t.configByInstance??{}))N(P,`root.configByInstance[${j}]`,void 0,M);for(let[j,P]of Object.entries(t.modules??{})){if(!P?.config)continue;let L=F(t,j).provider??void 0;if(L===void 0){N(P.config,`modules.${j}.config`,void 0,M);continue}let Z=l[L];if(!Z||R?.[L])continue;let q=f?.[L];N(P.config,`modules.${j}.config`,new Set(Z),q)}}}for(let[c,y]of Object.entries(o)){let A=t.services[c];if(!A){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:c,message:`integrations: 服务槽 ${c}(需求方 ${y.owners.join(", ")})未配置${y.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let I=Object.entries(A.instances??{}).filter(([,M])=>M.enabled===!1).map(([M])=>M);I.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:c,instance:I.join(", "),message:`integrations: ${c} 实例禁用(${I.join(", ")})`})}for(let[c,y]of Object.entries(t.modules??{})){let A=O?.[c];O&&!(c in O)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c} 未命中已装模块(键 = install id——检查 .tbox/app.json entry.id / packages/ 目录名)`});for(let[I,M]of Object.entries(y?.resources??{})){let N=M?.type;(typeof N!="string"||!r.RESOURCE_TYPE_IDS.includes(N))&&n.push({severity:"error",code:"RESOURCE_TYPE_UNKNOWN",module:c,message:`integrations: modules.${c}.resources.${I} type 非法(${String(N)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),A&&A.size>0&&!A.has(I)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c}.resources.${I} 未被模块 manifest declare.resources 声明`})}}return n}function le(e,n){return`${e}\0${n}`}import{existsSync as Ye,readFileSync as Zt,readdirSync as qt}from"fs";import{join as ke}from"path";function Gn(e){return e.replaceAll("-","_").toUpperCase()}function zn(e){if(!Ye(e))return null;try{let n=JSON.parse(Zt(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Qt(e){let n=new Set,r=e.properties;if(r&&typeof r=="object"&&!Array.isArray(r))for(let t of Object.keys(r))n.add(t);return n}function ue(e,n,r,t=process.env){let i={};for(let[u,v]of Object.entries(n.catalog.providers))for(let[w,c]of Object.entries(v))i[`${u}\0${w}`]={services:[...c.services],owner:c.owner,credentialType:c.credentialType};let o={};for(let[u,v]of Object.entries(n.catalog.services))o[u]={optional:v.optional,owners:[...v.owners]};let s={},d={},S={},l={},f={};for(let u of n.modules){f[u.id]=new Set((u.descriptor.declare.resources??[]).map(v=>v.id));for(let v of u.descriptor.declare.providers?.slots??[]){if(v.configSchema){let w=zn(ke(u.dir,v.configSchema));if(w){let c=s[v.provider]??=new Set,y=d[v.provider]??=new Set;for(let I of Qt(w))c.add(I);let A=w.properties;if(A&&typeof A=="object"&&!Array.isArray(A))for(let[I,M]of Object.entries(A))M&&typeof M=="object"&&M["x-tbox-global"]===!0&&y.add(I)}else S[v.provider]=!0}v.credentialSchema&&!Ye(ke(u.dir,v.credentialSchema))&&(l[v.credentialType]=!0)}}let R={},k=new Set,g=ke(e,"config","credentials");if(Ye(g))for(let u of qt(g)){if(!u.endsWith(".json"))continue;let v=u.slice(0,-5);k.add(v);let w=zn(ke(g,u));w&&typeof w.type=="string"&&(R[v]=w.type)}let C=r,O=[],x=u=>{typeof u=="string"&&u.startsWith("secret://")&&O.push(u)};for(let u of Object.values(C.services??{}))if(u&&typeof u=="object"){x(u.credentialRef);for(let v of Object.values(u.instances??{}))v&&typeof v=="object"&&x(v.credentialRef)}for(let u of Object.values(C.credentialRefByInstance??{}))x(u);x(C.credentialRef);let p={};for(let u of O){let v=u.slice(9);t[Gn(v)]===void 0&&(k.has(v)||(p[v]=!0))}let a=[];for(let[u,v]of Object.entries(C.services??{})){let w=v&&typeof v=="object"&&typeof v.provider=="string"?v.provider:void 0;for(let[c,y]of Object.entries((v&&typeof v=="object"?v.instances:void 0)??{})){let A=y&&typeof y=="object"&&typeof y.provider=="string"?y.provider:void 0;w&&A&&A!==w&&a.push(`integrations: ${u}@${c} 实现覆盖跨厂商(${w} → ${A})——凭据域切换,确认该 mall 对应凭据在场`)}}let h=((Array.isArray(C.instances)?C.instances:void 0)??[]).map(u=>u&&typeof u=="object"&&typeof u.id=="string"?u.id:void 0).filter(u=>typeof u=="string");return{suppliedProviders:i,demandedServices:o,credentialFileMissing:p,credentialFileType:R,credentialSchemaMissing:l,vendorConfigKeys:s,vendorGlobalConfigKeys:d,vendorConfigSchemaMissing:S,realmSwitchHints:a,moduleResourceNeeds:f,...h.length>0?{malls:h}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(u=>u.id),...new Set(Object.values(n.ownership))])}}import{existsSync as yi,readFileSync as Si}from"fs";import{join as hi,resolve as Ri}from"path";function He(e){return D(e).catalog}function be(e){let n=D(e).catalog,r={};for(let[o,s]of Object.entries(n.providers)){r[o]={};for(let[d,S]of Object.entries(s))r[o][d]={provider:S.provider,implementation:S.implementation,credentialType:S.credentialType,owner:S.owner,...S.local?{local:!0}:{},...S.configSchema?{configSchema:S.configSchema}:{},...S.credentialSchema?{credentialSchema:S.credentialSchema}:{},services:[...S.services]}}let t={};for(let[o,s]of Object.entries(n.services))t[o]={optional:s.optional,defaults:s.defaults.map(d=>({...d})),owners:[...s.owners]};let i={};for(let[o,s]of Object.entries(n.credentialTypes))i[o]={owner:s.owner,...s.credentialSchema?{credentialSchema:s.credentialSchema}:{}};return{providers:r,services:t,credentialTypes:i}}async function Ze(e,n,r,t=process.env){let i=r.module,o=D(e),s=i.buildSupplyLookup(be(e)),d=ue(e,o,n,t);return ee({contracts:i,integrations:n,supplies:s,...d})}import{existsSync as or,rmSync as sr}from"fs";import{join as ar}from"path";import{existsSync as Xt,readFileSync as er}from"fs";import{join as Jn}from"path";var nr=Jn("config","integrations.json");function G(e,n){let r=Jn(e,nr),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!Xt(r))return null;try{return t(er(r,"utf8"))}catch{return null}}async function Yn(e,n){let r=await T(e),t=G(e,n);if(t===null)return{config:null,strict:!1,contracts:r};if(r.strictValidation&&r.module.parseIntegrationsConfig)try{return{config:r.module.parseIntegrationsConfig(t),strict:!0,contracts:r}}catch(i){if(i instanceof Error&&Array.isArray(i.issues)){let o=i.issues.filter(s=>Array.isArray(s.path)).map(s=>s.path.map(String).join(".")).filter(s=>s.length>0);throw new E("VALIDATION_FAILED",400,"integrations.json 校验失败",o.length>0?o:void 0)}throw new E("VALIDATION_FAILED",400,i instanceof Error?i.message:String(i))}return{config:t,strict:!1,contracts:r}}function pe(e,n,r,t){return e.includes(r)||n.includes(r)||t.includes(r)}import{readdirSync as tr,existsSync as Ae,readFileSync as rr}from"fs";import{join as Ce}from"path";function Hn(e,n,r){let t=[];if(n){let i=Q({provider:e});t.push({stem:i,ref:`secret://${i}`,input:n})}for(let[i,o]of Object.entries(r??{})){let s=Q({provider:e,instanceId:i});t.push({instanceId:i,stem:s,ref:`secret://${s}`,input:o})}return t}function Zn(e,n,r,t,i){let o=[];if(t){let s=Q({provider:e,service:n});o.push({stem:s,ref:`secret://${s}`,input:t})}for(let[s,d]of Object.entries(i??{})){let S=Q({provider:e,instanceId:s,domain:r});o.push({instanceId:s,stem:S,ref:`secret://${S}`,input:d})}return o}function Qe(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ae(Ce(e,W(t.stem))):Ke(e,t.stem,t.input)}))}function ir(e,n){return Ae(Ce(e,W(n)))}function qe(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)qe(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))qe(r,n)}function ne(e){let n=Ce(e,"config","credentials"),r=new Set,t=Ce(e,"config","integrations.json");if(Ae(t))try{qe(JSON.parse(rr(t,"utf8")),r)}catch{}let i=[];if(!Ae(n))return i;let o=[];try{o=tr(n).filter(s=>s.endsWith(".json")).map(s=>s.slice(0,-5))}catch{return i}for(let s of o.sort()){if(r.has(s))continue;let d=ce(e,s);i.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${W(s)} 不再被引用(凭据文件保留,可手动清理)`})}return i}function Ee(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&K(e)){let n=e.provider;return n.length>0?n:void 0}}async function cr(e){let n=ar(e,"config","integrations.json"),r=G(e);if(r===null)return{removed:[],orphanCredentials:[],skipped:"not-configured"};let t=await T(e);if(!t.strictValidation)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};let i;try{let g=Ue(JSON.stringify(r),process.env);if(g.missing.length>0||g.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};i=JSON.parse(g.text)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let o;try{o=await Ze(e,i,t,process.env)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let s=D(e),d=new Set(Object.keys(s.catalog.providers)),S=s.ownership,l=structuredClone(r);l.services??={};let f=[];for(let g of o)if(g.severity==="error"){if(g.code==="VENDOR_NOT_INSTALLED")if(g.module){let O=(l.modules??{})[g.module];O?.provider&&(f.push(`modules.${g.module}.provider=${String(O.provider)}`),delete O.provider,Object.keys(O).length===0&&delete l.modules[g.module])}else l.provider&&(f.push(`root.provider=${l.provider}`),delete l.provider);else if(g.code==="MODULE_CONFIG_DEAD"&&g.module){let C=l.modules??{};if(C[g.module]){let O=C[g.module],x=[O.provider!==void 0?"provider":void 0,O.config!==void 0?"config":void 0,O.resources!==void 0?"resources":void 0].filter(Boolean);f.push(`modules.${g.module}(${x.join("+")} 整节点)`),delete l.modules[g.module]}}else if(g.code==="BINDING_UNRESOLVED"&&g.service){let C=l.services[g.service];if(!C)continue;let O=S[g.service];if([g.instance?Ee(C.instances?.[g.instance]?.provider):void 0,Ee(C.provider),O!==void 0?Ee(l.modules?.[O]?.provider):void 0,Ee(l.provider)].filter(p=>typeof p=="string").some(p=>d.has(p)))continue;if(g.instance){let p=C.instances;if(!p||!(g.instance in p))continue;delete p[g.instance],f.push(`services.${g.service}.instances.${g.instance}`),Object.keys(p).length===0&&delete C.instances,Object.keys(C).length===0&&delete l.services[g.service]}else delete l.services[g.service],f.push(`services.${g.service}`)}}if(Object.keys(l.services).length===0&&delete l.services,f.length===0)return{removed:f,orphanCredentials:[]};let R=!l.provider&&Object.keys(l.services??{}).length===0&&Object.keys(l.config??{}).length===0&&Object.keys(l.configByInstance??{}).length===0&&!l.credentialRef&&Object.keys(l.credentialRefByInstance??{}).length===0&&(l.instances??[]).length===0&&l.defaultInstanceId==null&&Object.keys(l.modules??{}).length===0;if(!R&&(l.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(l)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let k=[];return R?or(n)&&sr(n,{force:!0}):$(n,`${JSON.stringify(l,null,2)}
4
+ `),k=ne(e).map(g=>g.message),{removed:f,orphanCredentials:k}}function Oe(e,n){let r=e.modules.find(i=>i.id===n);if(r)return r;let t=e.modules.filter(i=>(i.descriptor.name??i.descriptor.id)===n);if(t.length===1)return t[0];throw t.length>1?new E("MODULE_NOT_FOUND",404,`模块展示名「${n}」命中多个模块:${t.map(i=>`${i.descriptor.name}(id=${i.id})`).join(" / ")}——请改用模块 id 寻址`):new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块(id / 展示名均未命中)`)}function Y(e,n,r){let t=new Set;for(let s of Object.values(e.catalog.providers))for(let d of Object.values(s))for(let S of d.services)t.add(S);if(e.vocabulary.includes(r)||Object.hasOwn(e.catalog.services,r)||t.has(r)||n.includes(r)||Object.hasOwn(e.ownership,r))return r;let i=[],o=s=>{i.includes(s)||i.push(s)};for(let s of e.vocabulary)(e.slotMeta[s]?.name??e.catalog.services[s]?.name)===r&&o(s);for(let[s,d]of Object.entries(e.catalog.services))d.name===r&&o(s);if(i.length===1)return i[0];throw i.length>1?new E("SERVICE_NOT_FOUND",404,`服务展示名「${r}」命中多个服务:${i.join(" / ")}——请改用服务 id 寻址`):new E("SERVICE_NOT_FOUND",404,`服务 ${r} 不在服务词汇(已装契约包 ∪ 已配置)`)}import{existsSync as rt,readFileSync as it}from"fs";import{join as re,resolve as dr}from"path";import lr from"ajv";var te=["$comment","$schema","provider","config","configByInstance","credentialRef","credentialRefByInstance","instances","defaultInstanceId"],xe=["provider","config"],qn=["provider","implementation","config","credentialRef","instances"],Qn=["provider","implementation","config","credentialRef","enabled"];var H=re("config","integrations.json");function fe(e,n){if(e===n)return!0;if(Array.isArray(e)&&Array.isArray(n))return e.length!==n.length?!1:e.every((r,t)=>fe(r,n[t]));if(e&&n&&typeof e=="object"&&typeof n=="object"){let r=Object.keys(e),t=Object.keys(n);return r.length!==t.length?!1:r.every(i=>fe(e[i],n[i]))}return!1}var ot=["$comment","$schema"];function Me(e,n){if(n)for(let r of ot)!(r in e)&&r in n&&(e[r]=n[r])}function Xn(e){if(e===null)return null;let n={...e};for(let r of ot)delete n[r];return n}function et(e,n){return fe(Xn(e),Xn(n))}function Pe(e,n){if(typeof e!="string"&&e&&typeof e=="object")for(let[r,t]of Object.entries(e)){if((r==="provider"||r==="instanceId")&&typeof t=="string"&&!z.test(t))throw new E("VALIDATION_FAILED",400,`${r} 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`${n}.${r}`]);Pe(t,`${n}.${r}`)}}function je(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!(r&&(t==="*"||t==="**"))&&!z.test(t))throw new E("VALIDATION_FAILED",400,`${n} 键 ${t} 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)——进凭据 stem 派生,防路径逃逸`,[n])}}function nt(e,n,r){if(r==="root"){let t=e.instances;Array.isArray(t)&&t.forEach((i,o)=>{let s=i&&typeof i=="object"?i.id:void 0;if(typeof s=="string"&&!z.test(s))throw new E("VALIDATION_FAILED",400,`instances[${o}].id 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`root.instances[${o}].id`])}),je(e.configByInstance,"root.configByInstance",!1),je(e.credentialRefByInstance,"root.credentialRefByInstance",!1)}else je(e.instances,"services.instances",!0);je(n.credentialsByInstance,"credentialsByInstance",!1)}function Ne(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!n.includes(t))throw new E("VALIDATION_FAILED",400,`${r} 仅接受 ${n.join("/")} 键(收到 ${t})`,[t])}}function Te(e,n){let r=re(e,H),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!rt(r))return null;try{return t(it(r,"utf8"))}catch{return null}}function Xe(e){let n=(e.instances??[]).map(r=>r.id);return n.length===0?[]:Je(e,n)}function ur(e,n,r,t){let{catalog:i}=D(e,t),o=i.providers[n];if(!o)return;let s=new Set;for(let d of Object.values(o))(r===void 0||d.services.includes(r))&&s.add(d.credentialType);return s.size===1?[...s][0]:void 0}function tt(e,n,r,t,i,o){if(typeof t.type!="string"||t.type.length===0)throw new E("VALIDATION_FAILED",400,"凭据 type 缺失或为空字符串",["credentials.type"]);let s=i??ur(e,n,r,o);if(s!==void 0&&s!=="-"&&t.type!==s)throw new E("VALIDATION_FAILED",400,`凭据 type=${t.type} 与绑定 credentialType ${s} 不一致`,["credentials.type"]);if(r===void 0)return;let{serviceSchemas:d}=D(e,o),S=d[`${n}\0${r}`];if(!S?.credentialSchema)return;let l=dr(S.packageDir,S.credentialSchema);if(rt(l))try{let R=new lr({allErrors:!0}).compile(JSON.parse(it(l,"utf8")));if(!R({type:t.type,...t.values})){let k=(R.errors??[]).map(g=>`credentials.values.${String(g.instancePath||g.params?.missingProperty||"").replace(/^\//,"")}`);throw new E("VALIDATION_FAILED",400,"凭据字段校验失败(ajv 字段级)",k)}}catch(f){if(f instanceof E)throw f}}function en(e,n={}){let{onApplied:r,cache:t}=n;function i(l,f,R,k){let g=l!==null,C=f.length>0,O=!k&&g,x=!k&&C;O&&($(re(e,H),`${JSON.stringify(l,null,2)}
5
+ `),t?.invalidate([re(e,H)]));let p=O||x;p&&R.push(...ne(e));let a=p&&r!==void 0;a&&r?.();let m=[];return g&&m.push(H),C&&m.push(...f.map(h=>W(h.stem))),{written:p,restartScheduled:a,files:m,credentials:f,issues:R}}let o;async function s(){o=await T(e)}function d(l,f){return l.filter(R=>Array.isArray(R.path)).map(R=>{let k=R.path.map(String).join(".");return f!==""&&k.startsWith(f)&&k.length>f.length?k.slice(f.length):k}).filter(R=>R.length>0)}function S(l,f,R){if(!o)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用——写路径门控失败(工厂边缘断言应先行拦截)");let k=se(o);if(k==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(o));if(k==="degraded"){f.push({severity:"warning",code:"STRICT_VALIDATION_SKIPPED",message:B(o)});return}try{o.module.parseIntegrationsConfig(l)}catch(g){throw g instanceof Error&&Array.isArray(g.issues)?new E("VALIDATION_FAILED",400,"节点 schema 校验失败",d(g.issues,R)):new E("VALIDATION_FAILED",400,g instanceof Error?g.message:String(g))}}return{warmup:s,applyApp(l,f={}){Pe(l,"root"),nt(l,f,"root"),Ne(l,te,"root");let R=[],k=Te(e,t),g=k??{services:{}};k===null&&R.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let C={...g};for(let v of te)v in l||delete C[v];for(let[v,w]of Object.entries(l))C[v]=w;let O=typeof C.provider=="string"?C.provider:"app",x=Hn(O,f.credentials,f.credentialsByInstance);for(let v of x)tt(e,O,void 0,v.input,void 0,t);let p=x.find(v=>v.instanceId===void 0);if(f.credentials&&p&&(C.credentialRef=p.ref),f.credentialsByInstance){let v={...C.credentialRefByInstance??{}};for(let w of x)w.instanceId!==void 0&&(v[w.instanceId]=w.ref);C.credentialRefByInstance=v}Me(C,k);let a=f.credentials!==void 0||f.credentialsByInstance!==void 0,m=et(k,C);if(m&&!a)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:R};S(C,R,"");let h=f.dryRun===!0,u=Qe(e,x,h);return R.push(...Xe(C)),i(m?null:C,u,R,f.dryRun)},applyModule(l,f,R={}){Pe(f,"root");let{modules:k,catalog:g,ownership:C}=D(e,t),O=k.find(c=>c.id===l);if(!O)throw new E("MODULE_NOT_FOUND",404,`模块 ${l} 非已装模块`);if(!U({modules:k,catalog:g,ownership:C},O).writable)throw new E("VALIDATION_FAILED",400,`模块 ${l} 未声明任何 declare.owns——无模块级配置位(模块级 provider/config 作用于归属服务)`);let p=[],a=Te(e,t);if(a===null&&Object.keys(f).length===0)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p};a===null&&p.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let m=a??{services:{}},h={...m.modules??{}},u={...h[l]??{}};Ne(f,xe,`modules.${l}`);let v={...u};for(let c of xe){let y=f[c];y==null||y===""||typeof y=="object"&&!Array.isArray(y)&&Object.keys(y).length===0?delete v[c]:v[c]=y}Object.keys(v).length===0?delete h[l]:h[l]=v;let w={...m,modules:h};return Me(w,a),fe(a,w)?{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p}:(S(w,p,`modules.${l}.`),p.push(...Xe(w)),i(w,[],p,R.dryRun))},applyService(l,f,R={}){Pe(f,"root"),nt(f,R,"slot"),Ne(f,qn,`services.${l}`);for(let[N,j]of Object.entries(f.instances??{}))Ne(j,Qn,`services.${l}.instances.${N}`);let k=[],g=Te(e,t),C=D(e,t);if(!pe(C.vocabulary,Object.keys(g?.services??{}),l,Object.keys(C.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${l} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);g===null&&k.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let O=g??{services:{}},x={...O.services??{}},p={...O,services:x};Me(p,g),x[l]={...f};let a=f.provider,m=a!==null&&typeof a=="object"?a:void 0,h=typeof a=="string"?a:typeof m?.provider=="string"?m.provider:"app",u=l.includes(".")?l.slice(0,l.indexOf(".")):l,v=Zn(h,l,u,R.credentials,R.credentialsByInstance);for(let N of v)tt(e,h,l,N.input,typeof m?.credentialType=="string"?m.credentialType:void 0,t);let w=x[l],c=v.find(N=>N.instanceId===void 0);if(R.credentials&&c&&(w.credentialRef=c.ref),R.credentialsByInstance){let N={...w.instances??{}};for(let j of v){if(j.instanceId===void 0)continue;let P={...N[j.instanceId]??{}};P.credentialRef=j.ref,N[j.instanceId]=P}w.instances=N}Me(p,g);let y=R.credentials!==void 0||R.credentialsByInstance!==void 0,A=et(g,p);if(A&&!y)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:k};S(p,k,`services.${l}.`);let I=R.dryRun===!0,M=Qe(e,v,I);return k.push(...Xe(p)),i(A?null:p,M,k,R.dryRun)},deleteService(l){let f=[],R=Te(e,t),k=D(e,t);if(!pe(k.vocabulary,Object.keys(R?.services??{}),l,Object.keys(k.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${l} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let g={...R?.services??{}};if(!(l in g))return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:f};delete g[l];let C={...R??{services:{}},services:g};$(re(e,H),`${JSON.stringify(C,null,2)}
6
+ `),t?.invalidate([re(e,H)]),f.push(...ne(e));let O=r!==void 0;return O&&r?.(),{written:!0,restartScheduled:O,files:[H],credentials:[],issues:f}}}}import{existsSync as pr,readFileSync as fr}from"fs";import{join as gr}from"path";var st=["$comment","$schema"];function mr(e){try{let n=JSON.parse(fr(e,"utf8"));if(!n||typeof n!="object"||Array.isArray(n))return{pristine:!1,meta:{}};let r=new Set(["services",...st]);if(Object.keys(n).some(o=>!r.has(o)))return{pristine:!1,meta:{}};let t=n.services;if(!t||typeof t!="object"||Array.isArray(t)||Object.keys(t).length>0)return{pristine:!1,meta:{}};let i={};for(let o of st)o in n&&(i[o]=n[o]);return{pristine:!0,meta:i}}catch{return{pristine:!1,meta:{}}}}function nn(e){let n=gr(e,"config","integrations.json"),r={};if(pr(n)){let s=mr(n);if(!s.pristine)return{generated:!1,reason:"in-place",services:[]};r=s.meta}let t=[];for(let s of D(e).modules)for(let d of s.descriptor.declare.providers?.slots??[])d.local===!0&&t.push({service:d.service,provider:d.provider,implementation:d.implementation});if(t.length===0)return{generated:!1,reason:"no-local-slots",services:[]};let i={},o=new Set(t.map(s=>s.provider));if(o.size===1){let[s]=o;for(let d of t)i[d.service]={};$(n,`${JSON.stringify({...r,provider:s,services:i},null,2)}
7
+ `)}else{for(let s of t)i[s.service]={provider:s.provider,implementation:s.implementation};$(n,`${JSON.stringify({...r,services:i},null,2)}
8
+ `)}return{generated:!0,reason:"generated",services:t.map(s=>s.service).sort()}}var tn={provider:null,layer:null};function rn(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:tn}function on(e){let n=rn(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:tn,inherited:tn}}function Ve(e,n){let r=e?.modules?.[n]?.provider,t=typeof r=="string"&&r.length>0?r:null,i=F(e,n),o={provider:i.provider,layer:i.layer};return{configured:t,effective:o,inherited:t!==null?rn(e):o}}function vr(e){return typeof e=="string"?e.length>0?e:null:K(e)?e.provider:null}function ge(e,n,r){let t=e?.services?.[r]?.provider,i=vr(t),o=n.ownership[r],s=o!==void 0?Ve(e,o).effective:rn(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as yr,readFileSync as Sr}from"fs";import{join as lt}from"path";function at(e,n){let r=D(e.appDir,e.cache),t=G(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function ct(e){let n=new Set;for(let r of e.modules){for(let t of r.descriptor.declare.owns??[])n.add(t.service);for(let t of r.descriptor.declare.consumes??[])n.add(t.service);for(let t of r.descriptor.declare.providers?.slots??[])n.add(t.service)}return n}function De(e,n,r){let t=e.providers[n];return t?Object.values(t).some(i=>i.services.includes(r)):!1}function J(e,n){let r=e.slotMeta[n],t=e.catalog.services[n],i=r?.name??t?.name??n,o=r?.description??t?.description;return{name:i,...o!==void 0?{description:o}:{}}}var wr=lt("config","knowledge.json");function hr(e,n,r){let i=r[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=lt(e.appDir,wr),s={};if(yr(o))try{s=(e.cache?.read(o,l=>JSON.parse(l))??JSON.parse(Sr(o,"utf8"))).knowledge_bases??{}}catch{s={}}let d={};for(let[S,l]of Object.entries(i)){if(!l||typeof l!="object"||Array.isArray(l))continue;let f=l,R=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),k=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,g=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,C=k??(g!==void 0&&typeof s[g]?.datasetId=="string"?s[g].datasetId:null),O={type:R,...k!==void 0?{datasetId:k}:{},...g!==void 0?{ref:g}:{},resolvedDatasetId:C,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};d[S]=O}return Object.keys(d).length>0?d:null}function dt(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function Rr(e){return dt(e.id).startsWith("provider-")||dt(e.pkg).startsWith("provider-")}function sn(e,n={}){return{modules:e.walk.modules.filter(t=>!Rr(t)).filter(t=>n.includeHidden===!0||t.descriptor.hidden!==!0).map(t=>({id:t.id,name:t.descriptor.name??t.descriptor.id,description:t.descriptor.description??"",...t.descriptor.hidden===!0?{hidden:!0}:{}})).sort((t,i)=>t.id.localeCompare(i.id))}}function an(e,n){let r=e.walk.modules.find(k=>k.id===n);if(!r)throw new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=U(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(k=>k.service)),o=(k,g)=>{let C=J(e.walk,k);return{service:k,name:C.name,...C.description!==void 0?{description:C.description}:{},required:g}},s=[...(r.descriptor.declare.consumes??[]).map(k=>o(k.service,k.optional===!1)),...[...new Set(t.ownedServices)].filter(k=>!i.has(k)).map(k=>o(k,!1))],d=e.integrations?.modules??{},S=d[n],l=S?{...typeof S.provider=="string"?{provider:S.provider}:{},...S.config&&typeof S.config=="object"&&!Array.isArray(S.config)?{config:S.config}:{}}:null,f=Ve(e.integrations,n),R={configured:f.configured,effective:f.effective,inherited:f.inherited,provider:f.effective.provider,layer:f.effective.layer};return{name:r.descriptor.name??r.descriptor.id,description:r.descriptor.description??"",...r.descriptor.hidden===!0?{hidden:!0}:{},ownedServices:t.ownedServices,integration:l,resources:hr(e,n,d),binding:R,configEditable:t.writable,services:s}}function cn(e){let n=ct(e.walk),r=e.walk.vocabulary.filter(o=>!n.has(o)).map(o=>{let s=J(e.walk,o);return{service:o,name:s.name,...s.description!==void 0?{description:s.description}:{},required:!1}}),t=e.integrations,i=null;if(t){let o={};for(let s of te)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i,binding:on(t)}}function dn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!pe(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let i=r[n]??null,o=J(e.walk,n);return{service:n,name:o.name,...o.description!==void 0?{description:o.description}:{},required:t?!t.optional:!1,integration:i,binding:ge(e.integrations,e.walk,n)}}import{existsSync as ft,readFileSync as gt,realpathSync as ut}from"fs";import{isAbsolute as Ir,join as kr,relative as br,resolve as pt,sep as Ar}from"path";function ln(e){let n=[];for(let[r,t]of Object.entries(e.catalog.providers)){let i=Object.values(t),o=e.catalog.vendorMeta[r];i.length===0&&!o||n.push({provider:r,local:i.length>0&&i.every(s=>s.local===!0),...o?.name?{name:o.name}:i[0]?.name?{name:i[0].name}:{}})}return{providers:n.sort((r,t)=>r.provider.localeCompare(t.provider))}}function un(e,n,r){let t=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(t)for(let l of Object.values(t))l.services.includes(r)&&o.push({implementation:l.implementation,credentialType:l.credentialType});let s=i[r]?.provider,d=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!d)throw t?new E("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&d&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:d.credentialType});let S=ie(e,n,r,d?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,configSchema:S,integrationSchemas:{configSchema:S}}}function ie(e,n,r,t){let i=e.walk.serviceSchemas[`${n}\0${r}`];return i?pn(e.appDir,i.packageDir,i.configSchema):typeof t=="string"?Cr(e.appDir,t):null}function pn(e,n,r){if(!r)return null;let t=kr(n,r);if(!ft(t))return null;try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function Cr(e,n){let r=pt(e,"config","schemas"),t=pt(e,n),i=br(r,t);if(i===""||i.startsWith("..")||Ir(i))throw new E("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!ft(t))return null;let o,s;try{o=ut(r),s=ut(t)}catch{return null}if(s!==o&&!s.startsWith(o+Ar))throw new E("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function _e(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,ownershipBindingV6:e.ownershipBindingV6,notes:[...e.notes]}}function mt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"];if(o&&o.provider!==void 0)return"instance";if(i?.provider!==void 0)return"service";let s=e.walk.ownership[n];return s!==void 0&&F(e.integrations,s).layer==="module"?"module":typeof t?.provider=="string"&&t.provider.length>0?"app":null}function vt(e,n,r,t,i){let o=n.resolveEffectiveService(e.integrations??{services:{}},r,t,i,e.walk.ownership);if(o.status==="ok"&&o.effective){let s=o.effective.provider,d=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:d,implementation:o.effective.implementation,effective:{provider:d,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:mt(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function yt(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function fn(e,n,r){let t=yt(n),{integrations:i,catalog:o}=n,s=r?.supplies??t.buildSupplyLookup(o),d=i,l=t.normalizeInstances({instances:d?.instances,defaultInstanceId:d?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??vt(n,t,e,l,s),R=mt(n,e,l),k=n.integrations?.services?.[e]?.provider,g=f.provider??(typeof k=="string"?k:typeof k=="object"&&k?String(k.provider):void 0),C={provider:g??null,layer:R??null},O=new Set(Object.keys(n.catalog.providers)),x=g!==void 0&&O.has(g)?Er(n.catalog,g,e):void 0,p=o.services[e],a=p!==void 0?!p.optional:void 0,m=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:C,...g!==void 0?{provider:g}:{},...g!==void 0&&R!==null?{layer:R}:{},...x!==void 0?{supplied:x}:{},...m!==void 0?{module:m}:{},...a!==void 0?{required:a}:{}}}function Er(e,n,r){return De(e,n,r)}function me(e){let n=new Set([...e.walk.vocabulary,...Object.keys(e.catalog.services),...Object.keys(e.walk.ownership)]),r=e.integrations?.services??{};for(let t of Object.keys(r))n.add(t);return[...n].sort()}function ve(e,n,r){let t={};for(let i of me(e))r&&!r.includes(i)||(t[i]=fn(i,e));return{contracts:_e(e.contracts),resolutions:t,issues:n}}function gn(e,n,r){let t=yt(n),i=t.buildSupplyLookup(n.catalog),o=n.integrations,s=t.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),d=s.instances.map(x=>x.id),S=n.integrations?.services?.[e],l=S?.instances?Object.keys(S.instances):void 0,f=St(l,d),R=new Map;for(let x of f)R.set(x,vt(n,t,e,x,i));let k=f.map(x=>{let p=R.get(x);return{instanceId:x,status:p.status,...p.statusMessage?{statusMessage:p.statusMessage}:{},...p.effective?{effective:p.effective}:{}}}),g=wt(n,e,s.defaultInstanceId??"*"),O={...fn(e,n,R.has(s.defaultInstanceId??"*")?{evaluation:R.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:k,inheritance:g};return{contracts:_e(n.contracts),resolution:O,issues:r.filter(x=>x.service===e)}}function St(e,n){if(n.length>0){let r=[...n];return e?.includes("*")&&r.push("*"),r}return e!==void 0&&e.length>0?e.includes("*")?["*"]:e:[]}function wt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"],s=e.walk.ownership[n],d=s!==void 0?F(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...d.layer==="module"&&d.provider?{provider:d.provider}:{}},{layer:"service",...typeof i?.provider=="string"?{provider:i.provider}:{},...i?.implementation?{implementation:i.implementation}:{}},{layer:"instance",...o?.provider?{provider:o.provider}:{},...o?.implementation?{implementation:o.implementation}:{}}]}function ye(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function ht(e,n,r){let t=e.catalog.services[n],i=e.walk.ownership[n];return{status:"evaluation-unavailable",statusMessage:r,binding:ge(e.integrations,e.walk,n).effective,...i!==void 0?{module:i}:{},...t!==void 0?{required:!t.optional}:{}}}function $e(e,n,r){let t=B(n),i={};for(let o of me(e))r&&!r.includes(o)||(i[o]=ht(e,o,t));return{contracts:_e(n),resolutions:i,issues:[]}}function Rt(e,n,r){let t=B(r),i={...ht(n,e,t),instances:Or(n,e),inheritance:wt(n,e,xr(n))};return{contracts:_e(r),resolution:i,issues:[]}}function Or(e,n){let r=e.integrations?.services?.[n],t=e.integrations,i=Array.isArray(t?.instances)?t.instances.map(s=>s&&typeof s=="object"?s.id:void 0).filter(s=>typeof s=="string"):[],o=r?.instances?Object.keys(r.instances):void 0;return St(o,i).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function xr(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function mn(e,n,r){if(!(n in e.catalog.providers))throw new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 不 ∈ catalog(内联声明厂商无包级档案——判定归求值轴 resolution.supplied)`);let t;if(r.kind==="app")t=me(e);else if(r.kind==="module"){let o=e.walk.modules.find(s=>s.id===r.module);if(!o)throw new E("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=U(e.walk,o).ownedServices}else t=[r.service];let i=new Set(de(e.catalog,n));return{provider:n,scope:r,services:t.map(o=>({service:o,name:J(e.walk,o).name,supplied:i.has(o)}))}}function vn(e,n,r){if(n===null)return null;let t={};for(let i of r)t[i]={configSchema:ie(e,n,i)};return{provider:n,services:t}}function oe(e){return e===null||typeof e!="object"?JSON.stringify(e??null):Array.isArray(e)?`[${e.map(oe).join(",")}]`:`{${Object.keys(e).sort().map(r=>`${JSON.stringify(r)}:${oe(e[r])}`).join(",")}}`}var Mr="\0no-enum";function jr(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(oe))].sort().join(",")}]`:Mr}function Nr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:oe(n)}function Tr(e){let n=e.map(t=>Nr(t.subschema));if(n.some(t=>t===null)||new Set(n).size>1)return null;if(n[0]==='"object"'){let t=oe(e[0].subschema);return e.every(i=>oe(i.subschema)===t)?e[0].subschema:null}return new Set(e.map(t=>jr(t.subschema))).size===1?e[0].subschema:null}function Fe(e){let n=[],r=!0,t=new Map;for(let[o,s]of Object.entries(e.services)){let d=s.configSchema;if(d===null){n.push(o);continue}if(!d||typeof d!="object"||Array.isArray(d))continue;let S=d;S.additionalProperties===!1&&(r=!1);let l=S.properties;if(!l||typeof l!="object"||Array.isArray(l))continue;let f=Array.isArray(S.required)?S.required:[];for(let R of Object.keys(l)){let k=t.get(R)??[];k.push({service:o,subschema:l[R],required:f.includes(R)}),t.set(R,k)}}let i=[];for(let[o,s]of t)i.push({key:o,schema:Tr(s),sources:s.map(({service:d,required:S})=>({service:d,required:S})),global:s.some(d=>!!d.subschema&&typeof d.subschema=="object"&&d.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:i}}function yn(e,n,r){if(e==="app"){let o=n.integrations?.provider;return typeof o=="string"&&o.length>0?o:null}let t=n.walk.modules.find(o=>o.id===r);return!t||!U(n.walk,t).writable?null:F(n.integrations,t.id).provider}var It={integrationSchemas:null,integrationFieldRegistry:null};function kt(e){return{...e,fields:e.fields.filter(n=>n.global)}}function Sn(e){let n=yn("app",e);if(n===null)return It;let r=vn(e,n,de(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:kt(Fe(r))}}function wn(e,n){let r=yn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return It;let i=(t.descriptor.declare.owns??[]).map(s=>s.service),o=vn(e,r,i.filter(s=>De(e.catalog,r,s)));return{integrationSchemas:o,integrationFieldRegistry:kt(Fe(o))}}function Pr(e){return Sn(e).integrationSchemas}function Vr(e,n){return wn(e,n).integrationSchemas}function Dr(e,n){let r=e.walk.ownership[n];if(r!==void 0)return F(e.integrations,r).provider;let t=e.integrations?.provider;return typeof t=="string"&&t.length>0?t:null}function Le(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=Dr(e,n);return t===null?null:{provider:t,configSchema:ie(e,t,n)}}if(typeof r=="string")return{provider:r,configSchema:ie(e,r,n)};if(K(r)){let t=r;return{provider:t.provider,configSchema:ie(e,t.provider,n,t.configSchema)}}return null}function hn(e,n){let r=Le(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return Fe(t)}function Se(e,n){if(n===void 0||!n.startsWith("secret://"))return;let r=n.slice(9),t=ce(e,r);if(t)return{type:t.type,ref:n,masked:we(t.values)}}function Rn(e){let n=e.integrations,r={credential:Se(e.appDir,typeof n?.credentialRef=="string"?n.credentialRef:void 0)??null,byInstance:{}};for(let{id:i}of n?.instances??[]){let o=n?.credentialRefByInstance?.[i];o!==void 0&&(r.byInstance[i]=Se(e.appDir,o)??null)}let t={};for(let[i,o]of Object.entries(n?.services??{})){let s={credential:Se(e.appDir,o.credentialRef)??null,byInstance:{}};for(let[d,S]of Object.entries(o.instances??{}))s.byInstance[d]=Se(e.appDir,S.credentialRef)??null;t[i]=s}return{app:r,services:t}}function In(e,n){return{types:(n===void 0?Object.keys(e.catalog.credentialTypes):[...new Set(Object.values(e.catalog.providers[n]??{}).map(t=>t.credentialType))]).sort().map(t=>{let i=e.catalog.credentialTypes[t];return{credentialType:t,credentialSchema:i?pn(e.appDir,i.packageDir,i.credentialSchema):null}})}}import _r from"path";var $r={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function kn(e,n){if(!n||n.length===0)return new Set;let r=$r[e],t=[...new Set(n)].filter(i=>!r.includes(i));if(t.length>0)throw new E("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}function Fr(e){let n=e?.kind;if(n!=="app"&&n!=="module"&&n!=="service")throw new E("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new E("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new E("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function Lr(e,n={}){let r=Be(),t=Promise.resolve(),i={appDir:e,cache:r};function o(p){if(se(p)==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function s(p){if(se(p)!=="ok")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function d(p){return at(i,p)}function S(p){let a=p.integrations?.services;return a&&typeof a=="object"?Object.keys(a):[]}async function l(){let p=await T(e),a=d(p),m=a.integrations;if(m===null)return[];let h={resolveEffectiveService:f(p.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(p.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(p.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:p.module.RESOURCE_TYPE_IDS??[]},u=ue(e,a.walk,m,process.env);return ee({contracts:h,integrations:m,supplies:h.buildSupplyLookup(a.catalog),...u})}function f(p,a){if(typeof p!="function")throw new E("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${a} 缺席(形态异常)`);return p}function R(p){let a=t.then(p,p);return t=a.catch(()=>{}),a}let k={async loadModules(p){let a=await T(e);return sn(d(a),p)},async loadModule(p,a){let m=kn("module",a?.include),h=await T(e),u=d(h),v=Oe(u.walk,p),w=an(u,v.id);if(m.has("serviceResolutions")){let c=[...new Set([...w.ownedServices,...w.services.map(y=>y.service)])];w.serviceResolutions=ye(h)?await l().then(y=>ve(u,y,c)):$e(u,h,c)}if(m.has("integrationSchemas")||m.has("integrationFieldRegistry")){let c=wn(u,v.id);m.has("integrationSchemas")&&(w.integrationSchemas=c.integrationSchemas),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=c.integrationFieldRegistry)}return w},async loadApp(p){let a=kn("app",p?.include),m=await T(e),h=d(m),u=cn(h);if(a.has("serviceResolutions")&&(u.serviceResolutions=ye(m)?await l().then(v=>ve(h,v)):$e(h,m)),a.has("integrationSchemas")||a.has("integrationFieldRegistry")){let v=Sn(h);a.has("integrationSchemas")&&(u.integrationSchemas=v.integrationSchemas),a.has("integrationFieldRegistry")&&(u.integrationFieldRegistry=v.integrationFieldRegistry)}return u},async loadService(p,a){let m=kn("service",a?.include),h=await T(e),u=d(h),v=Y(u.walk,S(u),p),w=dn(u,v);return m.has("integrationSchemas")&&(w.integrationSchemas=Le(u,v)),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=hn(u,v)),w},async loadServiceResolutions(p){let a=await T(e),m=d(a);if(!ye(a))return $e(m,a,p);let h=await l();return ve(m,h,p)},async loadServiceResolution(p){let a=await T(e),m=d(a),h=Y(m.walk,S(m),p);if(!ye(a))return Rt(h,m,a);let u=await l();return gn(h,m,u)},async loadProviders(){let p=await T(e);return ln(d(p))},async loadProviderSupply(p,a){Fr(a);let m=await T(e);return mn(d(m),p,a)},async loadProviderService(p,a){let m=await T(e),h=d(m),u=Y(h.walk,S(h),a);return un(h,p,u)},async loadCredentials(){let p=await T(e);return Rn(d(p))},async loadCredentialTypes(p){let a=await T(e);return In(d(a),p)}},g=en(e,{onApplied:n.onApplied,cache:r}),C={async writeAppIntegration(p,a){await g.warmup();let m=await T(e);return o(m),R(()=>g.applyApp(p,a))},async writeModuleIntegration(p,a,m){await g.warmup();let h=await T(e);return o(h),R(()=>{let u=Oe(d(h).walk,p);return g.applyModule(u.id,a,m)})},async writeServiceIntegration(p,a,m){await g.warmup();let h=await T(e);return o(h),R(()=>{let u=d(h),v=Y(u.walk,S(u),p);return g.applyService(v,a,m)})},async deleteServiceIntegration(p){await g.warmup();let a=await T(e);return o(a),R(()=>{let m=d(a),h=Y(m.walk,S(m),p);return g.deleteService(h)})}},O={invalidate(){r.invalidate(),We(e)},async resolveContracts(){return T(e)},walkManifests(){return x(e)},parseModuleDescriptor(p){return ae(p)},loadProviderCatalogRaw(){return He(e)},async readIntegrationsConfig(){return G(e,r)},async writeIntegrationsConfig(p){return R(()=>Br(e,p,r))},async ensureMockBindings(){return R(()=>nn(e))},async evaluateIntegrationServices(p){await g.warmup();let a=await T(e);s(a);let m={resolveEffectiveService:f(a.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(a.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(a.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:a.module.RESOURCE_TYPE_IDS??[]};return ee({...p,contracts:m})}};function x(p){return D(p,r)}return{...k,...C,...O}}function Br(e,n,r){let t=_r.join(e,"config","integrations.json");$(t,`${JSON.stringify(n,null,2)}
9
+ `),r.invalidate([t])}export{te as APP_INTEGRATION_NODE_KEYS,E as AppToolkitError,xe as MODULE_INTEGRATION_NODE_KEYS,z as SAFE_NAME_PATTERN,on as appProviderBinding,Kt as assertValidModuleId,Fe as buildIntegrationFieldRegistry,Ht as buildOwnershipMap,ue as buildPredicateAssembly,Je as checkInstanceKeys,Yt as collectDeclaredModules,B as contractsNotResolvedMessage,Lr as createAppToolkit,Be as createFileCache,en as createWriteCore,ir as credentialArtifactExists,fe as deepEqual,Q as deriveStem,Wn as discoverContractPackages,Se as echoForRef,Vn as ensureDir,nn as ensureMockBindings,Ze as evaluateAppIntegrationIssues,ee as evaluateIntegrationServices,Ue as expandEnvVars,Un as extractModuleIdFromSource,yn as formProviderOf,We as invalidateContractsResolver,K as isControlledInlineProvider,Fn as isValidModuleId,Pr as loadAppIntegrationSchemas,cn as loadAppView,In as loadCredentialTypesView,Rn as loadCredentialsView,an as loadModuleDetailView,Vr as loadModuleIntegrationSchemas,sn as loadModulesView,be as loadProviderCatalog,He as loadProviderCatalogRaw,un as loadProviderServiceDetailView,mn as loadProviderSupplyView,ln as loadProvidersView,dn as loadServiceDetailView,hn as loadServiceFieldRegistry,Le as loadServiceIntegrationSchemas,gn as loadServiceResolutionDetail,ve as loadServiceResolutionsView,Re as manifestPath,we as maskCredentialValues,Cn as moduleDependencySchema,jn as moduleDescriptorSchema,U as moduleOwnershipWritable,Ve as moduleProviderBinding,bn as pageContribSchema,ae as parseModuleDescriptor,de as providerFootprint,En as providerSlotContribSchema,cr as pruneIntegrationBindings,$n as readAppManifest,ze as readAppManifestFull,ce as readCredentialFile,G as readIntegrationsConfig,Yn as readIntegrationsStrict,ne as reconcileOrphanCredentials,Gn as refToEnvKey,Bt as removeNpmModule,me as resolutionKeys,T as resolveContractsForApp,T as resolveContractsForAppExport,vn as resolveLayerIntegrationSchemas,F as resolveModuleBinding,Oe as resolveModuleKey,Y as resolveServiceKey,fn as resolveServiceSummary,Mn as resourceNeedContribSchema,On as serviceConsumeContribSchema,xn as serviceOwnContribSchema,ge as serviceProviderBinding,W as stemToFilePath,jt as stemToRef,An as tabContribSchema,Ut as updateNpmModule,Wt as upsertMiniappContainer,Lt as upsertNpmModule,D as walkManifests,Ft as writeAppManifest,$ as writeAtomic,Ke as writeCredentialFile};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tbox.cn/app-toolkit",
3
- "version": "0.8.4",
3
+ "version": "0.8.5",
4
4
  "type": "module",
5
5
  "description": "tbox 应用工具面(运行面/工具面对仗:app-sdk 给运行的应用用,app-toolkit 给操作应用的工具用)——模块解析、集成配置求值/校验/写入内核,contracts 经应用侧动态解析(沙箱与目标应用版本解耦)。",
6
6
  "exports": {
@@ -34,6 +34,10 @@
34
34
  * 零声明厂商整体跳过——#7 同遍历双判定)
35
35
  * MALL_IDENTITY_IN_CONFIG_SCHEMA #18 warning 引用厂商 configSchema 声明商场身份键 mallId
36
36
  * (身份恒来自会话 scope——词表克制只拦精确键)
37
+ * BINDING_SHADOWED v6.2 warning 槽级显式绑定与继承默认(modules[owner]/root)异值——
38
+ * 槽级压过高层绑定(层序 inst > slot > modules > root),
39
+ * 接入切换残留未剥离则高层绑定静默失效;同值 = 显式钉版
40
+ * 静默;实例级覆盖零参与(per-instance 路由是设计特性)
37
41
  * ORPHANED_CREDENTIAL 写后对账 warning 凭据文件不再被引用(toolkit 写路径产出,非本谓词)
38
42
  * (v6 退役:DOMAIN_KEY_UNMATCHED #14——domains 键随归属模型退场)
39
43
  *
@@ -436,7 +440,10 @@ export function evaluateIntegrationServices(
436
440
  }
437
441
 
438
442
  // #11:root/modules 厂商存在性(继承层声明必须命中已装供给——vendor 集合 = 供给键前缀展开;
439
- // 槽级内联声明不在本检查范围—— 先声明后实施闭环归 #2/#6 形状检查)
443
+ // 槽级内联声明不在本检查范围—— 先声明后实施闭环归 #2/#6 形状检查)。
444
+ // 追加提示为条件性指引(不断言厂商身份——真厂商未装与零槽自声明两形态共用本码):
445
+ // 零槽自声明厂商(provider-custom 补槽声明前)不在供给集,「装包或改绑」对其误导
446
+ // (包已装,缺的是槽声明)。
440
447
  for (const [where, vendor] of [
441
448
  ['root', integrations.provider],
442
449
  ...Object.entries(integrations.modules ?? {}).map(([m, cfg]): [string, string | undefined] => [`modules.${m}`, cfg?.provider]),
@@ -447,7 +454,42 @@ export function evaluateIntegrationServices(
447
454
  severity: 'error',
448
455
  code: 'VENDOR_NOT_INSTALLED',
449
456
  module: where.startsWith('modules.') ? where.slice('modules.'.length) : undefined,
450
- message: `integrations: ${where} provider ${vendor} 未命中已装供给——装对应 provider 包或 provider use 改绑`,
457
+ message: `integrations: ${where} provider ${vendor} 未命中已装供给——装对应 provider 包或 provider use 改绑` +
458
+ `(自声明厂商另查其包内 tbox.module.json declare.providers.slots——补槽声明前不在供给集)`,
459
+ });
460
+ }
461
+ }
462
+
463
+ // BINDING_SHADOWED(v6.2):槽级显式字符串绑定 ≠ 继承默认(modules[owner].provider ?? root.provider)
464
+ // → warning。针对「模块/应用维度接入」半程态:写高层绑定后未剥离槽级既有绑定(出厂 mock 素材即
465
+ // 槽级形态),绑定组最特异层整组取(inst > slot > modules > root)——槽级压过高层,服务仍解析旧
466
+ // 厂商且 doctor 其余检查全绿(静默失效)。设计边界:
467
+ // - 同值豁免:槽级显式钉版与继承默认同厂商 = 合法(显式即真值的正当运用);
468
+ // - 实例级零参与:instances[k].provider 是 per-instance 跨厂商路由的设计特性(按 mallId 差异化),
469
+ // doctor 无法甄别设计性路由与意外残留——误报退役,意图甄别归 CLI use --module 写时警告;
470
+ // - ownership 缺席 → modules 层继承默认不可判(谓词纯函数,面信息由调用方喂)→ 模块轴跳过,
471
+ // root 轴不依赖 ownership 恒可判(对齐 MODULE_CONFIG_DEAD 防御模式同律);
472
+ // - warning 级咨询性:root=真厂商 + 单槽 custom 补缺口是合法混布(有意差异化)——消息明示可忽略。
473
+ {
474
+ const inherited = (serviceId: string): { provider: string; where: string } | undefined => {
475
+ const owner = ownership?.[serviceId];
476
+ const mod = owner != null ? integrations.modules?.[owner] : undefined;
477
+ if (typeof mod?.provider === 'string' && mod.provider) return { provider: mod.provider, where: `modules.${owner}` };
478
+ if (typeof integrations.provider === 'string' && integrations.provider) {
479
+ return { provider: integrations.provider, where: 'root' };
480
+ }
481
+ return undefined;
482
+ };
483
+ for (const [serviceId, service] of Object.entries(integrations.services)) {
484
+ if (typeof service.provider !== 'string' || !service.provider) continue; // 槽级显式字符串绑定在场
485
+ const head = inherited(serviceId);
486
+ if (!head || head.provider === service.provider) continue; // 无继承默认(纯槽级文件)或同值钉版
487
+ issues.push({
488
+ severity: 'warning',
489
+ code: 'BINDING_SHADOWED',
490
+ service: serviceId,
491
+ module: head.where.startsWith('modules.') ? head.where.slice('modules.'.length) : undefined,
492
+ message: `integrations: 槽级显式绑定 ${service.provider} 优先于 ${head.where} 层默认 ${head.provider}(${serviceId}——绑定组层序 inst > slot > modules > root)——接入切换残留请剥离槽级 provider(改槽为 {} 激活节点或逐槽 provider bind 覆盖);有意差异化请忽略`,
451
493
  });
452
494
  }
453
495
  }
@@ -0,0 +1,178 @@
1
+ /**
2
+ * predicate BINDING_SHADOWED(v6.2 层级遮蔽)行为单测:槽级显式字符串绑定与继承默认
3
+ * (modules[owner].provider ?? root.provider)异值 → warning;同值 = 显式钉版静默;
4
+ * 实例级覆盖零参与(per-instance 路由设计特性);ownership 缺席 → 模块轴跳过。
5
+ * 测试向量 = 五状态 doctor 矩阵(半程终态唯一触发态)+ 三素材拓扑零误报钉子
6
+ * (mock 槽级素材 / mocktest·wanda root-terse 素材)。
7
+ * 纯函数直调(零 app 装配;supplies 缺席即跳过 #12,谓词其余面静默)。
8
+ */
9
+ import { describe, expect, it } from 'vitest';
10
+ import { evaluateIntegrationServices } from '../src/integrations/predicate.js';
11
+
12
+ type ServiceNode = {
13
+ provider?: string | Record<string, unknown>;
14
+ implementation?: string;
15
+ config?: Record<string, unknown>;
16
+ instances?: Record<string, { enabled?: boolean; provider?: string; implementation?: string; config?: Record<string, unknown> }>;
17
+ };
18
+
19
+ const contracts = {
20
+ normalizeInstances: (cfg: { instances?: unknown[]; defaultInstanceId?: unknown }) => ({
21
+ instances: cfg.instances ?? [],
22
+ defaultInstanceId: cfg.defaultInstanceId ?? null,
23
+ }),
24
+ } as never;
25
+
26
+ function run(integrations: {
27
+ provider?: string;
28
+ modules?: Record<string, { provider?: string; config?: Record<string, unknown> }>;
29
+ services: Record<string, ServiceNode>;
30
+ }, ownership?: Record<string, string>) {
31
+ return evaluateIntegrationServices({
32
+ integrations,
33
+ suppliedProviders: {},
34
+ demandedServices: {},
35
+ contracts,
36
+ ...(ownership ? { ownership } : {}),
37
+ });
38
+ }
39
+
40
+ const GUIDE_SLOTS = [
41
+ 'shopping-guide.catalog',
42
+ 'shopping-guide.shops',
43
+ 'shopping-guide.categories',
44
+ 'shopping-guide.directory',
45
+ ] as const;
46
+
47
+ /** 五状态矩阵的 guide 四槽服务节构造器(S 出厂态 = 槽级 mock) */
48
+ const mockSlot = (): ServiceNode => ({ provider: 'mock' });
49
+
50
+ describe('predicate BINDING_SHADOWED(层级遮蔽——半程陷阱终态唯一触发)', () => {
51
+ it('五状态 · 半程终态(陷阱态):modules[guide]=custom + 槽级 mock + 槽声明已补 → 每槽一条 warning(其余检查全绿下唯一的 integration-services 信号)', () => {
52
+ const issues = run(
53
+ {
54
+ modules: { 'module-shopping-guide': { provider: 'provider-custom' } },
55
+ services: Object.fromEntries(GUIDE_SLOTS.map((s) => [s, mockSlot()])),
56
+ },
57
+ Object.fromEntries(GUIDE_SLOTS.map((s) => [s, 'module-shopping-guide'])),
58
+ );
59
+ const hits = issues.filter((i) => i.code === 'BINDING_SHADOWED');
60
+ expect(hits).toHaveLength(4);
61
+ for (const hit of hits) {
62
+ expect(hit?.severity).toBe('warning');
63
+ expect(hit?.module).toBe('module-shopping-guide');
64
+ expect(hit?.message).toContain('modules.module-shopping-guide 层默认 provider-custom');
65
+ expect(hit?.message).toContain('有意差异化请忽略');
66
+ }
67
+ });
68
+
69
+ it('五状态 · S 出厂态:纯槽级文件(无 modules/root provider)→ 零触发(无继承默认在场)', () => {
70
+ const issues = run({ services: Object.fromEntries(GUIDE_SLOTS.map((s) => [s, mockSlot()])) });
71
+ expect(issues.some((i) => i.code === 'BINDING_SHADOWED')).toBe(false);
72
+ });
73
+
74
+ it('五状态 · 正确终态:modules[guide]=custom + 槽 {} 激活节点 → 零触发(槽无显式绑定)', () => {
75
+ const issues = run(
76
+ {
77
+ modules: { 'module-shopping-guide': { provider: 'provider-custom', config: { baseUrl: 'https://api.example.com' } } },
78
+ services: Object.fromEntries(GUIDE_SLOTS.map((s) => [s, {}])),
79
+ },
80
+ Object.fromEntries(GUIDE_SLOTS.map((s) => [s, 'module-shopping-guide'])),
81
+ );
82
+ expect(issues.some((i) => i.code === 'BINDING_SHADOWED')).toBe(false);
83
+ });
84
+
85
+ it('五状态 · root 轴:root=custom + 槽级 mock 异值 → warning(where=root;ownership 缺席不依赖)', () => {
86
+ const issues = run({
87
+ provider: 'provider-custom',
88
+ services: { 'parking.query': { provider: 'mock' } },
89
+ });
90
+ const hit = issues.find((i) => i.code === 'BINDING_SHADOWED');
91
+ expect(hit?.severity).toBe('warning');
92
+ expect(hit?.message).toContain('root 层默认 provider-custom');
93
+ });
94
+
95
+ it('同值豁免:槽级显式钉版 = root 继承默认(provider bind 同厂商)→ 静默(显式即真值)', () => {
96
+ const issues = run({
97
+ provider: 'mock',
98
+ services: { 'parking.query': { provider: 'mock' } },
99
+ });
100
+ expect(issues.some((i) => i.code === 'BINDING_SHADOWED')).toBe(false);
101
+ });
102
+
103
+ it('实例级覆盖零参与:instances[k].provider ≠ 继承默认 → 不报(per-instance 跨厂商路由是设计特性)', () => {
104
+ const issues = run(
105
+ {
106
+ modules: { 'module-parking': { provider: 'provider-custom' } },
107
+ services: { 'parking.query': { instances: { '447': { provider: 'joycity' } } } },
108
+ },
109
+ { 'parking.query': 'module-parking' },
110
+ );
111
+ expect(issues.some((i) => i.code === 'BINDING_SHADOWED')).toBe(false);
112
+ });
113
+
114
+ it('ownership 缺席 + modules 层在场:模块轴继承默认不可判 → 跳过(谓词纯函数面信息防御;root 轴仍可判)', () => {
115
+ const issues = run({
116
+ modules: { 'module-shopping-guide': { provider: 'provider-custom' } },
117
+ services: { 'shopping-guide.catalog': mockSlot() },
118
+ });
119
+ expect(issues.some((i) => i.code === 'BINDING_SHADOWED')).toBe(false);
120
+ });
121
+
122
+ it('modules 层优先于 root:modules[owner] 有 provider 时 root 不参与该槽判定', () => {
123
+ const issues = run(
124
+ {
125
+ provider: 'joycity',
126
+ modules: { 'module-parking': { provider: 'provider-custom' } },
127
+ services: { 'parking.query': { provider: 'mock' } },
128
+ },
129
+ { 'parking.query': 'module-parking' },
130
+ );
131
+ const hit = issues.find((i) => i.code === 'BINDING_SHADOWED');
132
+ expect(hit?.message).toContain('modules.module-parking 层默认 provider-custom');
133
+ expect(hit?.message).not.toContain('root 层默认 joycity');
134
+ });
135
+ });
136
+
137
+ describe('BINDING_SHADOWED 三素材拓扑零误报钉子(防未来素材演化踩线)', () => {
138
+ it('mock 档形态(2026-10-21 槽级化):无 root/modules provider + 18 槽槽级 → 零触发', () => {
139
+ const services: Record<string, ServiceNode> = Object.fromEntries(
140
+ [
141
+ ...GUIDE_SLOTS,
142
+ 'member.account', 'member.profile', 'member.card', 'member.benefits', 'member.enrollment',
143
+ 'parking.query', 'parking.payment', 'parking.vehicle',
144
+ 'promotion.offers', 'promotion.entitlements', 'promotion.activities', 'promotion.acquisition',
145
+ 'mall.info', 'auth.alipay-login',
146
+ ].map((s) => [s, mockSlot()]),
147
+ );
148
+ const issues = run({ services });
149
+ expect(issues.some((i) => i.code === 'BINDING_SHADOWED')).toBe(false);
150
+ });
151
+
152
+ it('mocktest 档形态:root=mocktest + 槽 {} / config-only + modules 层仅 config → 零触发(无槽级显式绑定)', () => {
153
+ const issues = run({
154
+ provider: 'mocktest',
155
+ modules: {
156
+ 'module-member': { config: { cardName: '黑金会员卡' } },
157
+ 'module-parking': { config: { parkName: '示例停车场' } },
158
+ },
159
+ services: {
160
+ 'member.account': {},
161
+ 'parking.query': { config: { remainingSpaces: 56 } },
162
+ 'payment.main': { config: { baseUrl: 'https://example.com' } },
163
+ },
164
+ });
165
+ expect(issues.some((i) => i.code === 'BINDING_SHADOWED')).toBe(false);
166
+ });
167
+
168
+ it('wanda 档形态:root=wanda + 槽 {} + instances["*"] 仅 config → 零触发', () => {
169
+ const issues = run({
170
+ provider: 'wanda',
171
+ services: {
172
+ 'member.account': {},
173
+ 'auth.alipay-login': { instances: { '*': { config: { browserLogin: 'auto' } } } },
174
+ },
175
+ });
176
+ expect(issues.some((i) => i.code === 'BINDING_SHADOWED')).toBe(false);
177
+ });
178
+ });
@@ -763,6 +763,8 @@ describe('O6/O7/O10/O14(FX-3 补全)', () => {
763
763
  'MODULE_CONFIG_DEAD', 'GLOBAL_FIELD_UNDECLARED',
764
764
  // #18 additive(mall-id-single-source,api.md §5 表已收口)
765
765
  'MALL_IDENTITY_IN_CONFIG_SCHEMA',
766
+ // v6.2 additive(模块级接入层级遮蔽回拉信号,api.md §5 表已收口)
767
+ 'BINDING_SHADOWED',
766
768
  // 谓词头映射表 additive(检查族编号映射:#3/#4/#5 内联/#13/v4)
767
769
  'SLOT_NOT_DECLARED', 'SLOT_NOT_CONFIGURED', 'INLINE_PROVIDER_INVALID', 'MULTI_INSTANCE_NO_DEFAULT', 'INSTANCE_DISABLED',
768
770
  ]);