@tbox.cn/app-toolkit 0.8.0 → 0.8.1

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.js CHANGED
@@ -5,5 +5,5 @@ import{a as _e,b as T,c as $e}from"./chunk-WUULQDOV.js";import{z as b}from"zod";
5
5
  `),t?.invalidate([te(e,Y)]));let g=x||p;g&&k.push(...ne(e));let d=g&&r!==void 0;d&&r?.();let S=[];return y&&S.push(Y),E&&S.push(...f.map(R=>B(R.stem))),{written:g,restartScheduled:d,files:S,credentials:f,issues:k}}let o;async function s(){o=await T(e)}function l(c,f){return c.filter(k=>Array.isArray(k.path)).map(k=>{let w=k.path.map(String).join(".");return f!==""&&w.startsWith(f)&&w.length>f.length?w.slice(f.length):w}).filter(k=>k.length>0)}function v(c,f,k){let w=o;if(!w||!w.strictValidation||!w.module.parseIntegrationsConfig)throw new O("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用(需 ≥0.9)——写路径门控失败(工厂边缘断言应先行拦截)");try{w.module.parseIntegrationsConfig(c)}catch(y){throw y instanceof Error&&Array.isArray(y.issues)?new O("VALIDATION_FAILED",400,"节点 schema 校验失败",l(y.issues,k)):new O("VALIDATION_FAILED",400,y instanceof Error?y.message:String(y))}}return{warmup:s,applyApp(c,f={}){je(c,"root"),Hn(c,f,"root");let k=[],w=Me(e,t),y=w??{services:{}};w===null&&k.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let E={...y};for(let m of pe)m in c||delete E[m];for(let[m,I]of Object.entries(c))E[m]=I;let x=typeof E.provider=="string"?E.provider:"app",p=Jn(x,f.credentials,f.credentialsByInstance);for(let m of p)Yn(e,x,void 0,m.input,void 0,t);let g=p.find(m=>m.instanceId===void 0);if(f.credentials&&g&&(E.credentialRef=g.ref),f.credentialsByInstance){let m={...E.credentialRefByInstance??{}};for(let I of p)I.instanceId!==void 0&&(m[I.instanceId]=I.ref);E.credentialRefByInstance=m}let d=f.credentials!==void 0||f.credentialsByInstance!==void 0,S=re(w,E);if(S&&!d)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:k};v(E,k,"");let R=f.dryRun===!0,u=Ye(e,p,R);return k.push(...Ze(E)),i(S?null:E,u,k,f.dryRun)},applyModule(c,f,k={}){je(f,"root");let{modules:w,catalog:y,ownership:E}=D(e,t),x=w.find(a=>a.id===c);if(!x)throw new O("MODULE_NOT_FOUND",404,`模块 ${c} 非已装模块`);if(!W({modules:w,catalog:y,ownership:E},x).writable)throw new O("VALIDATION_FAILED",400,`模块 ${c} 未声明任何 declare.owns——无模块级配置位(模块级 provider/config 作用于归属服务)`);let g=[],d=Me(e,t);if(d===null&&Object.keys(f).length===0)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:g};d===null&&g.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let S=d??{services:{}},R={...S.modules??{}},u={...R[c]??{}};for(let a of Object.keys(f))if(!fe.includes(a))throw new O("VALIDATION_FAILED",400,`模块集成位仅接受 ${fe.join("/")} 键(收到 ${a})`,[a]);let m={...u};for(let a of fe){let h=f[a];h==null||h===""||typeof h=="object"&&!Array.isArray(h)&&Object.keys(h).length===0?delete m[a]:m[a]=h}Object.keys(m).length===0?delete R[c]:R[c]=m;let I={...S,modules:R};return re(d,I)?{written:!1,restartScheduled:!1,files:[],credentials:[],issues:g}:(v(I,g,`modules.${c}.`),g.push(...Ze(I)),i(I,[],g,k.dryRun))},applyService(c,f,k={}){je(f,"root"),Hn(f,k,"slot");let w=[],y=Me(e,t),E=D(e,t);if(!ue(E.vocabulary,Object.keys(y?.services??{}),c,Object.keys(E.ownership)))throw new O("SERVICE_NOT_FOUND",404,`服务 ${c} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);y===null&&w.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let x=y??{services:{}},p={...x.services??{}},g={...x,services:p};p[c]={...f};let d=f.provider,S=d!==null&&typeof d=="object"?d:void 0,R=typeof d=="string"?d:typeof S?.provider=="string"?S.provider:"app",u=c.includes(".")?c.slice(0,c.indexOf(".")):c,m=Gn(R,c,u,k.credentials,k.credentialsByInstance);for(let P of m)Yn(e,R,c,P.input,typeof S?.credentialType=="string"?S.credentialType:void 0,t);let I=p[c],a=m.find(P=>P.instanceId===void 0);if(k.credentials&&a&&(I.credentialRef=a.ref),k.credentialsByInstance){let P={...I.instances??{}};for(let j of m){if(j.instanceId===void 0)continue;let N={...P[j.instanceId]??{}};N.credentialRef=j.ref,P[j.instanceId]=N}I.instances=P}let h=k.credentials!==void 0||k.credentialsByInstance!==void 0,A=re(y,g);if(A&&!h)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:w};v(g,w,`services.${c}.`);let C=k.dryRun===!0,M=Ye(e,m,C);return w.push(...Ze(g)),i(A?null:g,M,w,k.dryRun)},deleteService(c){let f=[],k=Me(e,t),w=D(e,t);if(!ue(w.vocabulary,Object.keys(k?.services??{}),c,Object.keys(w.ownership)))throw new O("SERVICE_NOT_FOUND",404,`服务 ${c} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let y={...k?.services??{}};if(!(c in y))return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:f};delete y[c];let E={...k??{services:{}},services:y};_(te(e,Y),`${JSON.stringify(E,null,2)}
6
6
  `),t?.invalidate([te(e,Y)]),f.push(...ne(e));let x=r!==void 0;return x&&r?.(),{written:!0,restartScheduled:x,files:[Y],credentials:[],issues:f}}}}import{existsSync as rr}from"fs";import{join as ir}from"path";function Qe(e){let n=ir(e,"config","integrations.json");if(rr(n))return{generated:!1,reason:"in-place",services:[]};let r=[];for(let o of D(e).modules)for(let s of o.descriptor.declare.providers?.slots??[])s.local===!0&&r.push({service:s.service,provider:s.provider,implementation:s.implementation});if(r.length===0)return{generated:!1,reason:"no-local-slots",services:[]};let t={},i=new Set(r.map(o=>o.provider));if(i.size===1){let[o]=i;for(let s of r)t[s.service]={};_(n,`${JSON.stringify({provider:o,services:t},null,2)}
7
7
  `)}else{for(let o of r)t[o.service]={provider:o.provider,implementation:o.implementation};_(n,`${JSON.stringify({services:t},null,2)}
8
- `)}return{generated:!0,reason:"generated",services:r.map(o=>o.service).sort()}}var Xe={provider:null,layer:null};function en(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:Xe}function nn(e){let n=en(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:Xe,inherited:Xe}}function Te(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?en(e):o}}function or(e){return typeof e=="string"?e.length>0?e:null:U(e)?e.provider:null}function ge(e,n,r){let t=e?.services?.[r]?.provider,i=or(t),o=n.ownership[r],s=o!==void 0?Te(e,o).effective:en(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as sr,readFileSync as ar}from"fs";import{join as nt}from"path";function Qn(e,n){let r=D(e.appDir,e.cache),t=K(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function Xn(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 Pe(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 cr=nt("config","knowledge.json");function dr(e,n,r){let i=r[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=nt(e.appDir,cr),s={};if(sr(o))try{s=(e.cache?.read(o,c=>JSON.parse(c))??JSON.parse(ar(o,"utf8"))).knowledge_bases??{}}catch{s={}}let l={};for(let[v,c]of Object.entries(i)){if(!c||typeof c!="object"||Array.isArray(c))continue;let f=c,k=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),w=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,y=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,E=w??(y!==void 0&&typeof s[y]?.datasetId=="string"?s[y].datasetId:null),x={type:k,...w!==void 0?{datasetId:w}:{},...y!==void 0?{ref:y}:{},resolvedDatasetId:E,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};l[v]=x}return Object.keys(l).length>0?l:null}function et(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function lr(e){return et(e.id).startsWith("provider-")||et(e.pkg).startsWith("provider-")}function tn(e,n={}){return{modules:e.walk.modules.filter(t=>!lr(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 rn(e,n){let r=e.walk.modules.find(w=>w.id===n);if(!r)throw new O("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=W(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(w=>w.service)),o=(w,y)=>{let E=J(e.walk,w);return{service:w,name:E.name,...E.description!==void 0?{description:E.description}:{},required:y}},s=[...(r.descriptor.declare.consumes??[]).map(w=>o(w.service,w.optional===!1)),...[...new Set(t.ownedServices)].filter(w=>!i.has(w)).map(w=>o(w,!1))],l=e.integrations?.modules??{},v=l[n],c=v?{...typeof v.provider=="string"?{provider:v.provider}:{},...v.config&&typeof v.config=="object"&&!Array.isArray(v.config)?{config:v.config}:{}}:null,f=Te(e.integrations,n),k={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:c,resources:dr(e,n,l),binding:k,configEditable:t.writable,services:s}}function on(e){let n=Xn(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 pe)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i,binding:nn(t)}}function sn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!ue(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new O("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 it,readFileSync as ot,realpathSync as tt}from"fs";import{isAbsolute as ur,join as pr,relative as fr,resolve as rt,sep as gr}from"path";function an(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 cn(e,n,r){let t=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(t)for(let c of Object.values(t))c.services.includes(r)&&o.push({implementation:c.implementation,credentialType:c.credentialType});let s=i[r]?.provider,l=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!l)throw t?new O("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new O("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&l&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:l.credentialType});let v=ie(e,n,r,l?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,configSchema:v,integrationSchemas:{configSchema:v}}}function ie(e,n,r,t){let i=e.walk.serviceSchemas[`${n}\0${r}`];return i?dn(e.appDir,i.packageDir,i.configSchema):typeof t=="string"?mr(e.appDir,t):null}function dn(e,n,r){if(!r)return null;let t=pr(n,r);if(!it(t))return null;try{return JSON.parse(ot(t,"utf8"))}catch{return null}}function mr(e,n){let r=rt(e,"config","schemas"),t=rt(e,n),i=fr(r,t);if(i===""||i.startsWith("..")||ur(i))throw new O("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!it(t))return null;let o,s;try{o=tt(r),s=tt(t)}catch{return null}if(s!==o&&!s.startsWith(o+gr))throw new O("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(ot(t,"utf8"))}catch{return null}}function Ne(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,notes:[...e.notes]}}function st(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 at(e,n,r,t,i){let o=n.resolveEffectiveService(e.integrations,r,t,i,e.walk.ownership);if(o.status==="ok"&&o.effective){let s=o.effective.provider,l=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:l,implementation:o.effective.implementation,effective:{provider:l,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:st(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function ct(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new O("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function ln(e,n,r){let t=ct(n),{integrations:i,catalog:o}=n,s=r?.supplies??t.buildSupplyLookup(o),l=i,c=t.normalizeInstances({instances:l?.instances,defaultInstanceId:l?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??at(n,t,e,c,s),k=st(n,e,c),w=n.integrations?.services?.[e]?.provider,y=f.provider??(typeof w=="string"?w:typeof w=="object"&&w?String(w.provider):void 0),E={provider:y??null,layer:k??null},x=new Set(Object.keys(n.catalog.providers)),p=y!==void 0&&x.has(y)?vr(n.catalog,y,e):void 0,g=o.services[e],d=g!==void 0?!g.optional:void 0,S=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:E,...y!==void 0?{provider:y}:{},...y!==void 0&&k!==null?{layer:k}:{},...p!==void 0?{supplied:p}:{},...S!==void 0?{module:S}:{},...d!==void 0?{required:d}:{}}}function vr(e,n,r){return Pe(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]=ln(i,e));return{contracts:Ne(e.contracts),resolutions:t,issues:n}}function un(e,n,r){let t=ct(n),i=t.buildSupplyLookup(n.catalog),o=n.integrations,s=t.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),l=s.instances.map(p=>p.id),v=n.integrations?.services?.[e],c=v?.instances?Object.keys(v.instances):void 0,f=dt(c,l),k=new Map;for(let p of f)k.set(p,at(n,t,e,p,i));let w=f.map(p=>{let g=k.get(p);return{instanceId:p,status:g.status,...g.statusMessage?{statusMessage:g.statusMessage}:{},...g.effective?{effective:g.effective}:{}}}),y=lt(n,e,s.defaultInstanceId??"*"),x={...ln(e,n,k.has(s.defaultInstanceId??"*")?{evaluation:k.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:w,inheritance:y};return{contracts:Ne(n.contracts),resolution:x,issues:r.filter(p=>p.service===e)}}function dt(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 lt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"],s=e.walk.ownership[n],l=s!==void 0?$(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...l.layer==="module"&&l.provider?{provider:l.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 ut(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 Ve(e,n,r){let t=G(n),i={};for(let o of me(e))r&&!r.includes(o)||(i[o]=ut(e,o,t));return{contracts:Ne(n),resolutions:i,issues:[]}}function pt(e,n,r){let t=G(r),i={...ut(n,e,t),instances:yr(n,e),inheritance:lt(n,e,Sr(n))};return{contracts:Ne(r),resolution:i,issues:[]}}function yr(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 dt(o,i).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function Sr(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function pn(e,n,r){if(!(n in e.catalog.providers))throw new O("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 O("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=W(e.walk,o).ownedServices}else t=[r.service];let i=new Set(ce(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 fn(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 wr="\0no-enum";function hr(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(oe))].sort().join(",")}]`:wr}function Rr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:oe(n)}function Ir(e){let n=e.map(t=>Rr(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=>hr(t.subschema))).size===1?e[0].subschema:null}function De(e){let n=[],r=!0,t=new Map;for(let[o,s]of Object.entries(e.services)){let l=s.configSchema;if(l===null){n.push(o);continue}if(!l||typeof l!="object"||Array.isArray(l))continue;let v=l;v.additionalProperties===!1&&(r=!1);let c=v.properties;if(!c||typeof c!="object"||Array.isArray(c))continue;let f=Array.isArray(v.required)?v.required:[];for(let k of Object.keys(c)){let w=t.get(k)??[];w.push({service:o,subschema:c[k],required:f.includes(k)}),t.set(k,w)}}let i=[];for(let[o,s]of t)i.push({key:o,schema:Ir(s),sources:s.map(({service:l,required:v})=>({service:l,required:v})),global:s.some(l=>!!l.subschema&&typeof l.subschema=="object"&&l.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:i}}function gn(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||!W(n.walk,t).writable?null:$(n.integrations,t.id).provider}var ft={integrationSchemas:null,integrationFieldRegistry:null};function gt(e){return{...e,fields:e.fields.filter(n=>n.global)}}function mn(e){let n=gn("app",e);if(n===null)return ft;let r=fn(e,n,ce(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:gt(De(r))}}function vn(e,n){let r=gn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return ft;let i=(t.descriptor.declare.owns??[]).map(s=>s.service),o=fn(e,r,i.filter(s=>Pe(e.catalog,r,s)));return{integrationSchemas:o,integrationFieldRegistry:gt(De(o))}}function kr(e){return mn(e).integrationSchemas}function br(e,n){return vn(e,n).integrationSchemas}function Cr(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 Fe(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=Cr(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(U(r)){let t=r;return{provider:t.provider,configSchema:ie(e,t.provider,n,t.configSchema)}}return null}function yn(e,n){let r=Fe(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return De(t)}function Se(e,n){if(n===void 0||!n.startsWith("secret://"))return;let r=n.slice(9),t=ae(e,r);if(t)return{type:t.type,ref:n,masked:we(t.values)}}function Sn(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[l,v]of Object.entries(o.instances??{}))s.byInstance[l]=Se(e.appDir,v.credentialRef)??null;t[i]=s}return{app:r,services:t}}function wn(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?dn(e.appDir,i.packageDir,i.credentialSchema):null}})}}import Ar from"path";var Er={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function hn(e,n){if(!n||n.length===0)return new Set;let r=Er[e],t=[...new Set(n)].filter(i=>!r.includes(i));if(t.length>0)throw new O("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}function Or(e){let n=e?.kind;if(n!=="app"&&n!=="module"&&n!=="service")throw new O("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new O("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new O("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function xr(e,n={}){let r=_e(),t=Promise.resolve(),i={appDir:e,cache:r};function o(p){if(!p.strictValidation)throw new O("CONTRACTS_NOT_RESOLVED",503,G(p));if(!p.ownershipBindingV6)throw new O("CONTRACTS_NOT_RESOLVED",503,G(p))}function s(p){return Qn(i,p)}function l(p){let g=p.integrations?.services;return g&&typeof g=="object"?Object.keys(g):[]}async function v(){let p=await T(e),g=s(p),d=g.integrations;if(d===null)return[];let S={resolveEffectiveService:c(p.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:c(p.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:c(p.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:p.module.RESOURCE_TYPE_IDS??[]},R=le(e,g.walk,d,process.env);return ee({contracts:S,integrations:d,supplies:S.buildSupplyLookup(g.catalog),...R})}function c(p,g){if(typeof p!="function")throw new O("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${g} 缺席(形态异常)`);return p}function f(p){let g=t.then(p,p);return t=g.catch(()=>{}),g}let k={async loadModules(p){let g=await T(e);return tn(s(g),p)},async loadModule(p,g){let d=hn("module",g?.include),S=await T(e),R=s(S),u=Oe(R.walk,p),m=rn(R,u.id);if(d.has("serviceResolutions")){let I=[...new Set([...m.ownedServices,...m.services.map(a=>a.service)])];m.serviceResolutions=ye(S)?await v().then(a=>ve(R,a,I)):Ve(R,S,I)}if(d.has("integrationSchemas")||d.has("integrationFieldRegistry")){let I=vn(R,u.id);d.has("integrationSchemas")&&(m.integrationSchemas=I.integrationSchemas),d.has("integrationFieldRegistry")&&(m.integrationFieldRegistry=I.integrationFieldRegistry)}return m},async loadApp(p){let g=hn("app",p?.include),d=await T(e),S=s(d),R=on(S);if(g.has("serviceResolutions")&&(R.serviceResolutions=ye(d)?await v().then(u=>ve(S,u)):Ve(S,d)),g.has("integrationSchemas")||g.has("integrationFieldRegistry")){let u=mn(S);g.has("integrationSchemas")&&(R.integrationSchemas=u.integrationSchemas),g.has("integrationFieldRegistry")&&(R.integrationFieldRegistry=u.integrationFieldRegistry)}return R},async loadService(p,g){let d=hn("service",g?.include),S=await T(e),R=s(S),u=H(R.walk,l(R),p),m=sn(R,u);return d.has("integrationSchemas")&&(m.integrationSchemas=Fe(R,u)),d.has("integrationFieldRegistry")&&(m.integrationFieldRegistry=yn(R,u)),m},async loadServiceResolutions(p){let g=await T(e),d=s(g);if(!ye(g))return Ve(d,g,p);let S=await v();return ve(d,S,p)},async loadServiceResolution(p){let g=await T(e),d=s(g),S=H(d.walk,l(d),p);if(!ye(g))return pt(S,d,g);let R=await v();return un(S,d,R)},async loadProviders(){let p=await T(e);return an(s(p))},async loadProviderSupply(p,g){Or(g);let d=await T(e);return pn(s(d),p,g)},async loadProviderService(p,g){let d=await T(e),S=s(d),R=H(S.walk,l(S),g);return cn(S,p,R)},async loadCredentials(){let p=await T(e);return Sn(s(p))},async loadCredentialTypes(p){let g=await T(e);return wn(s(g),p)}},w=qe(e,{onApplied:n.onApplied,cache:r}),y={async writeAppIntegration(p,g){await w.warmup();let d=await T(e);return o(d),f(()=>w.applyApp(p,g))},async writeModuleIntegration(p,g,d){await w.warmup();let S=await T(e);return o(S),f(()=>{let R=Oe(s(S).walk,p);return w.applyModule(R.id,g,d)})},async writeServiceIntegration(p,g,d){await w.warmup();let S=await T(e);return o(S),f(()=>{let R=s(S),u=H(R.walk,l(R),p);return w.applyService(u,g,d)})},async deleteServiceIntegration(p){await w.warmup();let g=await T(e);return o(g),f(()=>{let d=s(g),S=H(d.walk,l(d),p);return w.deleteService(S)})}},E={invalidate(){r.invalidate(),$e(e)},async resolveContracts(){return T(e)},walkManifests(){return x(e)},parseModuleDescriptor(p){return se(p)},loadProviderCatalogRaw(){return Je(e)},async readIntegrationsConfig(){return K(e,r)},async writeIntegrationsConfig(p){await w.warmup();let g=await T(e);return o(g),f(()=>Mr(e,p,r))},async ensureMockBindings(){await w.warmup();let p=await T(e);return o(p),f(()=>Qe(e))},async evaluateIntegrationServices(p){await w.warmup();let g=await T(e);o(g);let d={resolveEffectiveService:c(g.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:c(g.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:c(g.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:g.module.RESOURCE_TYPE_IDS??[]};return ee({...p,contracts:d})}};function x(p){return D(p,r)}return{...k,...y,...E}}function Mr(e,n,r){let t=Ar.join(e,"config","integrations.json");_(t,`${JSON.stringify(n,null,2)}
8
+ `)}return{generated:!0,reason:"generated",services:r.map(o=>o.service).sort()}}var Xe={provider:null,layer:null};function en(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:Xe}function nn(e){let n=en(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:Xe,inherited:Xe}}function Te(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?en(e):o}}function or(e){return typeof e=="string"?e.length>0?e:null:U(e)?e.provider:null}function ge(e,n,r){let t=e?.services?.[r]?.provider,i=or(t),o=n.ownership[r],s=o!==void 0?Te(e,o).effective:en(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as sr,readFileSync as ar}from"fs";import{join as nt}from"path";function Qn(e,n){let r=D(e.appDir,e.cache),t=K(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function Xn(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 Pe(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 cr=nt("config","knowledge.json");function dr(e,n,r){let i=r[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=nt(e.appDir,cr),s={};if(sr(o))try{s=(e.cache?.read(o,c=>JSON.parse(c))??JSON.parse(ar(o,"utf8"))).knowledge_bases??{}}catch{s={}}let l={};for(let[v,c]of Object.entries(i)){if(!c||typeof c!="object"||Array.isArray(c))continue;let f=c,k=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),w=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,y=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,E=w??(y!==void 0&&typeof s[y]?.datasetId=="string"?s[y].datasetId:null),x={type:k,...w!==void 0?{datasetId:w}:{},...y!==void 0?{ref:y}:{},resolvedDatasetId:E,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};l[v]=x}return Object.keys(l).length>0?l:null}function et(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function lr(e){return et(e.id).startsWith("provider-")||et(e.pkg).startsWith("provider-")}function tn(e,n={}){return{modules:e.walk.modules.filter(t=>!lr(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 rn(e,n){let r=e.walk.modules.find(w=>w.id===n);if(!r)throw new O("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=W(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(w=>w.service)),o=(w,y)=>{let E=J(e.walk,w);return{service:w,name:E.name,...E.description!==void 0?{description:E.description}:{},required:y}},s=[...(r.descriptor.declare.consumes??[]).map(w=>o(w.service,w.optional===!1)),...[...new Set(t.ownedServices)].filter(w=>!i.has(w)).map(w=>o(w,!1))],l=e.integrations?.modules??{},v=l[n],c=v?{...typeof v.provider=="string"?{provider:v.provider}:{},...v.config&&typeof v.config=="object"&&!Array.isArray(v.config)?{config:v.config}:{}}:null,f=Te(e.integrations,n),k={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:c,resources:dr(e,n,l),binding:k,configEditable:t.writable,services:s}}function on(e){let n=Xn(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 pe)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i,binding:nn(t)}}function sn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!ue(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new O("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 it,readFileSync as ot,realpathSync as tt}from"fs";import{isAbsolute as ur,join as pr,relative as fr,resolve as rt,sep as gr}from"path";function an(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 cn(e,n,r){let t=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(t)for(let c of Object.values(t))c.services.includes(r)&&o.push({implementation:c.implementation,credentialType:c.credentialType});let s=i[r]?.provider,l=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!l)throw t?new O("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new O("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&l&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:l.credentialType});let v=ie(e,n,r,l?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,configSchema:v,integrationSchemas:{configSchema:v}}}function ie(e,n,r,t){let i=e.walk.serviceSchemas[`${n}\0${r}`];return i?dn(e.appDir,i.packageDir,i.configSchema):typeof t=="string"?mr(e.appDir,t):null}function dn(e,n,r){if(!r)return null;let t=pr(n,r);if(!it(t))return null;try{return JSON.parse(ot(t,"utf8"))}catch{return null}}function mr(e,n){let r=rt(e,"config","schemas"),t=rt(e,n),i=fr(r,t);if(i===""||i.startsWith("..")||ur(i))throw new O("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!it(t))return null;let o,s;try{o=tt(r),s=tt(t)}catch{return null}if(s!==o&&!s.startsWith(o+gr))throw new O("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(ot(t,"utf8"))}catch{return null}}function Ne(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,notes:[...e.notes]}}function st(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 at(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,l=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:l,implementation:o.effective.implementation,effective:{provider:l,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:st(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function ct(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new O("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function ln(e,n,r){let t=ct(n),{integrations:i,catalog:o}=n,s=r?.supplies??t.buildSupplyLookup(o),l=i,c=t.normalizeInstances({instances:l?.instances,defaultInstanceId:l?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??at(n,t,e,c,s),k=st(n,e,c),w=n.integrations?.services?.[e]?.provider,y=f.provider??(typeof w=="string"?w:typeof w=="object"&&w?String(w.provider):void 0),E={provider:y??null,layer:k??null},x=new Set(Object.keys(n.catalog.providers)),p=y!==void 0&&x.has(y)?vr(n.catalog,y,e):void 0,g=o.services[e],d=g!==void 0?!g.optional:void 0,S=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:E,...y!==void 0?{provider:y}:{},...y!==void 0&&k!==null?{layer:k}:{},...p!==void 0?{supplied:p}:{},...S!==void 0?{module:S}:{},...d!==void 0?{required:d}:{}}}function vr(e,n,r){return Pe(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]=ln(i,e));return{contracts:Ne(e.contracts),resolutions:t,issues:n}}function un(e,n,r){let t=ct(n),i=t.buildSupplyLookup(n.catalog),o=n.integrations,s=t.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),l=s.instances.map(p=>p.id),v=n.integrations?.services?.[e],c=v?.instances?Object.keys(v.instances):void 0,f=dt(c,l),k=new Map;for(let p of f)k.set(p,at(n,t,e,p,i));let w=f.map(p=>{let g=k.get(p);return{instanceId:p,status:g.status,...g.statusMessage?{statusMessage:g.statusMessage}:{},...g.effective?{effective:g.effective}:{}}}),y=lt(n,e,s.defaultInstanceId??"*"),x={...ln(e,n,k.has(s.defaultInstanceId??"*")?{evaluation:k.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:w,inheritance:y};return{contracts:Ne(n.contracts),resolution:x,issues:r.filter(p=>p.service===e)}}function dt(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 lt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"],s=e.walk.ownership[n],l=s!==void 0?$(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...l.layer==="module"&&l.provider?{provider:l.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 ut(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 Ve(e,n,r){let t=G(n),i={};for(let o of me(e))r&&!r.includes(o)||(i[o]=ut(e,o,t));return{contracts:Ne(n),resolutions:i,issues:[]}}function pt(e,n,r){let t=G(r),i={...ut(n,e,t),instances:yr(n,e),inheritance:lt(n,e,Sr(n))};return{contracts:Ne(r),resolution:i,issues:[]}}function yr(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 dt(o,i).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function Sr(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function pn(e,n,r){if(!(n in e.catalog.providers))throw new O("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 O("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=W(e.walk,o).ownedServices}else t=[r.service];let i=new Set(ce(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 fn(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 wr="\0no-enum";function hr(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(oe))].sort().join(",")}]`:wr}function Rr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:oe(n)}function Ir(e){let n=e.map(t=>Rr(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=>hr(t.subschema))).size===1?e[0].subschema:null}function De(e){let n=[],r=!0,t=new Map;for(let[o,s]of Object.entries(e.services)){let l=s.configSchema;if(l===null){n.push(o);continue}if(!l||typeof l!="object"||Array.isArray(l))continue;let v=l;v.additionalProperties===!1&&(r=!1);let c=v.properties;if(!c||typeof c!="object"||Array.isArray(c))continue;let f=Array.isArray(v.required)?v.required:[];for(let k of Object.keys(c)){let w=t.get(k)??[];w.push({service:o,subschema:c[k],required:f.includes(k)}),t.set(k,w)}}let i=[];for(let[o,s]of t)i.push({key:o,schema:Ir(s),sources:s.map(({service:l,required:v})=>({service:l,required:v})),global:s.some(l=>!!l.subschema&&typeof l.subschema=="object"&&l.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:i}}function gn(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||!W(n.walk,t).writable?null:$(n.integrations,t.id).provider}var ft={integrationSchemas:null,integrationFieldRegistry:null};function gt(e){return{...e,fields:e.fields.filter(n=>n.global)}}function mn(e){let n=gn("app",e);if(n===null)return ft;let r=fn(e,n,ce(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:gt(De(r))}}function vn(e,n){let r=gn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return ft;let i=(t.descriptor.declare.owns??[]).map(s=>s.service),o=fn(e,r,i.filter(s=>Pe(e.catalog,r,s)));return{integrationSchemas:o,integrationFieldRegistry:gt(De(o))}}function kr(e){return mn(e).integrationSchemas}function br(e,n){return vn(e,n).integrationSchemas}function Cr(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 Fe(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=Cr(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(U(r)){let t=r;return{provider:t.provider,configSchema:ie(e,t.provider,n,t.configSchema)}}return null}function yn(e,n){let r=Fe(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return De(t)}function Se(e,n){if(n===void 0||!n.startsWith("secret://"))return;let r=n.slice(9),t=ae(e,r);if(t)return{type:t.type,ref:n,masked:we(t.values)}}function Sn(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[l,v]of Object.entries(o.instances??{}))s.byInstance[l]=Se(e.appDir,v.credentialRef)??null;t[i]=s}return{app:r,services:t}}function wn(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?dn(e.appDir,i.packageDir,i.credentialSchema):null}})}}import Ar from"path";var Er={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function hn(e,n){if(!n||n.length===0)return new Set;let r=Er[e],t=[...new Set(n)].filter(i=>!r.includes(i));if(t.length>0)throw new O("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}function Or(e){let n=e?.kind;if(n!=="app"&&n!=="module"&&n!=="service")throw new O("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new O("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new O("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function xr(e,n={}){let r=_e(),t=Promise.resolve(),i={appDir:e,cache:r};function o(p){if(!p.strictValidation)throw new O("CONTRACTS_NOT_RESOLVED",503,G(p));if(!p.ownershipBindingV6)throw new O("CONTRACTS_NOT_RESOLVED",503,G(p))}function s(p){return Qn(i,p)}function l(p){let g=p.integrations?.services;return g&&typeof g=="object"?Object.keys(g):[]}async function v(){let p=await T(e),g=s(p),d=g.integrations;if(d===null)return[];let S={resolveEffectiveService:c(p.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:c(p.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:c(p.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:p.module.RESOURCE_TYPE_IDS??[]},R=le(e,g.walk,d,process.env);return ee({contracts:S,integrations:d,supplies:S.buildSupplyLookup(g.catalog),...R})}function c(p,g){if(typeof p!="function")throw new O("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${g} 缺席(形态异常)`);return p}function f(p){let g=t.then(p,p);return t=g.catch(()=>{}),g}let k={async loadModules(p){let g=await T(e);return tn(s(g),p)},async loadModule(p,g){let d=hn("module",g?.include),S=await T(e),R=s(S),u=Oe(R.walk,p),m=rn(R,u.id);if(d.has("serviceResolutions")){let I=[...new Set([...m.ownedServices,...m.services.map(a=>a.service)])];m.serviceResolutions=ye(S)?await v().then(a=>ve(R,a,I)):Ve(R,S,I)}if(d.has("integrationSchemas")||d.has("integrationFieldRegistry")){let I=vn(R,u.id);d.has("integrationSchemas")&&(m.integrationSchemas=I.integrationSchemas),d.has("integrationFieldRegistry")&&(m.integrationFieldRegistry=I.integrationFieldRegistry)}return m},async loadApp(p){let g=hn("app",p?.include),d=await T(e),S=s(d),R=on(S);if(g.has("serviceResolutions")&&(R.serviceResolutions=ye(d)?await v().then(u=>ve(S,u)):Ve(S,d)),g.has("integrationSchemas")||g.has("integrationFieldRegistry")){let u=mn(S);g.has("integrationSchemas")&&(R.integrationSchemas=u.integrationSchemas),g.has("integrationFieldRegistry")&&(R.integrationFieldRegistry=u.integrationFieldRegistry)}return R},async loadService(p,g){let d=hn("service",g?.include),S=await T(e),R=s(S),u=H(R.walk,l(R),p),m=sn(R,u);return d.has("integrationSchemas")&&(m.integrationSchemas=Fe(R,u)),d.has("integrationFieldRegistry")&&(m.integrationFieldRegistry=yn(R,u)),m},async loadServiceResolutions(p){let g=await T(e),d=s(g);if(!ye(g))return Ve(d,g,p);let S=await v();return ve(d,S,p)},async loadServiceResolution(p){let g=await T(e),d=s(g),S=H(d.walk,l(d),p);if(!ye(g))return pt(S,d,g);let R=await v();return un(S,d,R)},async loadProviders(){let p=await T(e);return an(s(p))},async loadProviderSupply(p,g){Or(g);let d=await T(e);return pn(s(d),p,g)},async loadProviderService(p,g){let d=await T(e),S=s(d),R=H(S.walk,l(S),g);return cn(S,p,R)},async loadCredentials(){let p=await T(e);return Sn(s(p))},async loadCredentialTypes(p){let g=await T(e);return wn(s(g),p)}},w=qe(e,{onApplied:n.onApplied,cache:r}),y={async writeAppIntegration(p,g){await w.warmup();let d=await T(e);return o(d),f(()=>w.applyApp(p,g))},async writeModuleIntegration(p,g,d){await w.warmup();let S=await T(e);return o(S),f(()=>{let R=Oe(s(S).walk,p);return w.applyModule(R.id,g,d)})},async writeServiceIntegration(p,g,d){await w.warmup();let S=await T(e);return o(S),f(()=>{let R=s(S),u=H(R.walk,l(R),p);return w.applyService(u,g,d)})},async deleteServiceIntegration(p){await w.warmup();let g=await T(e);return o(g),f(()=>{let d=s(g),S=H(d.walk,l(d),p);return w.deleteService(S)})}},E={invalidate(){r.invalidate(),$e(e)},async resolveContracts(){return T(e)},walkManifests(){return x(e)},parseModuleDescriptor(p){return se(p)},loadProviderCatalogRaw(){return Je(e)},async readIntegrationsConfig(){return K(e,r)},async writeIntegrationsConfig(p){await w.warmup();let g=await T(e);return o(g),f(()=>Mr(e,p,r))},async ensureMockBindings(){await w.warmup();let p=await T(e);return o(p),f(()=>Qe(e))},async evaluateIntegrationServices(p){await w.warmup();let g=await T(e);o(g);let d={resolveEffectiveService:c(g.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:c(g.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:c(g.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:g.module.RESOURCE_TYPE_IDS??[]};return ee({...p,contracts:d})}};function x(p){return D(p,r)}return{...k,...y,...E}}function Mr(e,n,r){let t=Ar.join(e,"config","integrations.json");_(t,`${JSON.stringify(n,null,2)}
9
9
  `),r.invalidate([t])}export{pe as APP_INTEGRATION_NODE_KEYS,O as AppToolkitError,fe as MODULE_INTEGRATION_NODE_KEYS,z as SAFE_NAME_PATTERN,nn as appProviderBinding,Vt as assertValidModuleId,De as buildIntegrationFieldRegistry,Lt as buildOwnershipMap,le as buildPredicateAssembly,ze as checkInstanceKeys,$t as collectDeclaredModules,G as contractsNotResolvedMessage,xr as createAppToolkit,_e as createFileCache,qe as createWriteCore,Yt as credentialArtifactExists,re as deepEqual,Q as deriveStem,$n as discoverContractPackages,Se as echoForRef,Tn as ensureDir,Qe as ensureMockBindings,Ge as evaluateAppIntegrationIssues,ee as evaluateIntegrationServices,Le as expandEnvVars,Ln as extractModuleIdFromSource,gn as formProviderOf,$e as invalidateContractsResolver,U as isControlledInlineProvider,Dn as isValidModuleId,kr as loadAppIntegrationSchemas,on as loadAppView,wn as loadCredentialTypesView,Sn as loadCredentialsView,rn as loadModuleDetailView,br as loadModuleIntegrationSchemas,tn as loadModulesView,be as loadProviderCatalog,Je as loadProviderCatalogRaw,cn as loadProviderServiceDetailView,pn as loadProviderSupplyView,an as loadProvidersView,sn as loadServiceDetailView,yn as loadServiceFieldRegistry,Fe as loadServiceIntegrationSchemas,un as loadServiceResolutionDetail,ve as loadServiceResolutionsView,Re as manifestPath,we as maskCredentialValues,kn as moduleDependencySchema,On as moduleDescriptorSchema,W as moduleOwnershipWritable,Te as moduleProviderBinding,Rn as pageContribSchema,se as parseModuleDescriptor,ce as providerFootprint,bn as providerSlotContribSchema,Xt as pruneIntegrationBindings,Vn as readAppManifest,We as readAppManifestFull,ae as readCredentialFile,K as readIntegrationsConfig,Kn as readIntegrationsStrict,ne as reconcileOrphanCredentials,Un as refToEnvKey,Tt as removeNpmModule,me as resolutionKeys,T as resolveContractsForApp,T as resolveContractsForAppExport,fn as resolveLayerIntegrationSchemas,$ as resolveModuleBinding,Oe as resolveModuleKey,H as resolveServiceKey,ln as resolveServiceSummary,En as resourceNeedContribSchema,Cn as serviceConsumeContribSchema,An as serviceOwnContribSchema,ge as serviceProviderBinding,B as stemToFilePath,It as stemToRef,In as tabContribSchema,Nt as updateNpmModule,Pt as upsertMiniappContainer,jt as upsertNpmModule,D as walkManifests,Mt as writeAppManifest,_ as writeAtomic,Be as writeCredentialFile};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tbox.cn/app-toolkit",
3
- "version": "0.8.0",
3
+ "version": "0.8.1",
4
4
  "type": "module",
5
5
  "description": "tbox 应用工具面(运行面/工具面对仗:app-sdk 给运行的应用用,app-toolkit 给操作应用的工具用)——模块解析、集成配置求值/校验/写入内核,contracts 经应用侧动态解析(沙箱与目标应用版本解耦)。",
6
6
  "exports": {
@@ -81,7 +81,8 @@ function evaluateInstance(
81
81
  supplies: unknown,
82
82
  ): InstanceEvaluation {
83
83
  const r = contracts.resolveEffectiveService(
84
- snapshot.integrations as never,
84
+ // 文件缺席是未配置态;contracts 入参要求对象,静态快照仍保留 null 文件镜像。
85
+ (snapshot.integrations ?? { services: {} }) as never,
85
86
  service,
86
87
  instanceId,
87
88
  supplies as never,
@@ -1,6 +1,6 @@
1
1
  import { describe, it, expect, beforeEach } from 'vitest';
2
2
  import { join } from 'node:path';
3
- import { mkdirSync, readFileSync, symlinkSync } from 'node:fs';
3
+ import { mkdirSync, readFileSync, rmSync, symlinkSync } from 'node:fs';
4
4
  import { fileURLToPath } from 'node:url';
5
5
  import { createAppToolkit, type AppToolkit } from '../src/factory.js';
6
6
  import { invalidateContractsResolver } from '../src/core/contracts-resolver.js';
@@ -338,6 +338,40 @@ describe('views/工厂(O 矩阵核心族)', () => {
338
338
  h = harnessWithContracts();
339
339
  });
340
340
 
341
+ it('integrations 文件缺席:四个读求值入口保持未配置态,静态镜像仍为 null', async () => {
342
+ const { app, tk } = harnessWithContracts({
343
+ // contracts 要求对象入参;既有宽松 fake 会掩盖传 null 的边界错误。
344
+ resolveBody: ['return { status: integrations.services[service] ? "ok" : "service-not-configured" };'],
345
+ });
346
+ try {
347
+ rmSync(join(app.appDir, 'config/integrations.json'));
348
+ const include = ['serviceResolutions', 'integrationFieldRegistry'];
349
+ const appView = await tk.loadApp({ include });
350
+ const moduleView = await tk.loadModule('module-parking', { include });
351
+ const batch = await tk.loadServiceResolutions();
352
+ const detail = await tk.loadServiceResolution('parking.query');
353
+ expect(appView.integration).toBeNull();
354
+ expect(appView.integrationFieldRegistry).toBeNull();
355
+ expect(moduleView.integrationFieldRegistry).toBeNull();
356
+ expect(appView.serviceResolutions).toEqual(batch);
357
+ expect(batch.issues).toEqual([]);
358
+ expect(Object.keys(batch.resolutions)).toEqual(['parking.query']);
359
+ const summary = batch.resolutions['parking.query'];
360
+ expect(summary).toMatchObject({
361
+ status: 'service-not-configured',
362
+ binding: { provider: null, layer: null },
363
+ module: 'module-parking',
364
+ required: true,
365
+ });
366
+ expect(moduleView.serviceResolutions?.resolutions['parking.query']).toEqual(summary);
367
+ expect(detail.resolution).toMatchObject(summary!);
368
+ expect(detail.resolution.instances).toEqual([]);
369
+ expect(await tk.readIntegrationsConfig()).toBeNull();
370
+ } finally {
371
+ app.dispose();
372
+ }
373
+ });
374
+
341
375
  it('O1 integration 字段逐字等价(文件节点原值——预填真值不变式 D21)', async () => {
342
376
  const detail = await h.tk.loadService('parking.query');
343
377
  const fileConfig = ((await h.tk.readIntegrationsConfig()) ?? { services: {} }) as {