@collective-intelligence/extensions-sdk 0.3.2 → 0.3.3
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/README.md +38 -34
- package/dist/access/dataset-policy.d.ts +38 -0
- package/dist/access/index.d.ts +3 -1
- package/dist/access/manifest.d.ts +31 -1
- package/dist/access/readers.d.ts +19 -1
- package/dist/components/base.d.ts +1 -1
- package/dist/components/connector-instances.d.ts +14 -1
- package/dist/components/document-collections.d.ts +9 -1
- package/dist/components/metadata-authoring.d.ts +11 -3
- package/dist/documents.js +2 -2
- package/dist/index.d.ts +3 -2
- package/dist/index.js +3 -3
- package/dist/package/primitive-readers.d.ts +18 -0
- package/dist/release/stored-manifest.d.ts +16 -4
- package/docs/guide/ai/index.md +36 -17
- package/docs/guide/ai/studio.md +245 -0
- package/docs/guide/data/connectors.md +81 -18
- package/docs/guide/data/datasets.md +6 -17
- package/docs/guide/data/documents.md +235 -0
- package/docs/guide/data/index.md +62 -0
- package/docs/guide/data/knowledge.md +21 -18
- package/docs/guide/develop/extensions.md +15 -14
- package/docs/guide/develop/external-apps.md +48 -14
- package/docs/guide/develop/infrastructure.md +135 -0
- package/docs/guide/develop/sdks.md +2 -2
- package/docs/guide/index.md +11 -7
- package/docs/guide/platform/access.md +82 -17
- package/docs/guide/platform/architecture.md +27 -18
- package/docs/guide/platform/entrypoints.md +125 -48
- package/docs/guide/scenarios/index.md +69 -46
- package/docs/guide/template/index.md +22 -9
- package/docs/guide/template/state-machines.md +1 -1
- package/package.json +2 -2
package/dist/documents.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import{existsSync,readdirSync,readFileSync}from"node:fs";import path from"node:path";import{fileURLToPath}from"node:url";var compareCodePoints=(left,right)=>{const leftPoints=Array.from(left,(character)=>character.codePointAt(0)??0);const rightPoints=Array.from(right,(character)=>character.codePointAt(0)??0);const length=Math.min(leftPoints.length,rightPoints.length);for(let index=0;index<length;index+=1){const difference=leftPoints[index]-rightPoints[index];if(difference!==0){return difference}}return leftPoints.length-rightPoints.length};var insertSortedKey=(keys,key)=>{let index=0;while(index<keys.length&&compareCodePoints(keys[index]??"",key)<=0){index+=1}keys.splice(index,0,key)};var isJsonObject=(value)=>Object.prototype.toString.call(value)==="[object Object]"&&!Array.isArray(value)&&(Object.getPrototypeOf(value)===Object.prototype||Object.getPrototypeOf(value)===null);var isJsonArray=(value)=>Array.isArray(value);var canonicalize=(value,ancestors,_valueType)=>{if(value===null){return"null"}if(isJsonArray(value)){if(ancestors.has(value)){throw new TypeError("package declarations cannot contain cyclic values")}ancestors.add(value);try{return`[${value.map((item)=>canonicalize(item,ancestors)).join(",")}]`}finally{ancestors.delete(value)}}if(isJsonObject(value)){if(ancestors.has(value)){throw new TypeError("package declarations cannot contain cyclic values")}ancestors.add(value);try{const record=value;const keys=[];for(const key of Object.keys(record)){insertSortedKey(keys,key)}return`{${keys.map((key)=>`${JSON.stringify(key)}:${canonicalize(record[key],ancestors)}`).join(",")}}`}finally{ancestors.delete(value)}}if(value instanceof Object){throw new TypeError("package declarations must contain JSON-compatible values")}switch(Object.prototype.toString.call(value)){case"[object Boolean]":{return value===true?"true":"false"}case"[object Number]":{const number=Number(value);if(!Number.isFinite(number)){throw new TypeError("package declarations cannot contain non-finite numbers")}return JSON.stringify(number)}case"[object String]":{return JSON.stringify(String(value))}default:{throw new TypeError("package declarations must contain JSON-compatible values")}}};var canonicalJson=(value,..._typeEvidence)=>canonicalize(value,new WeakSet);var parseJsonObject=(source)=>{const value=JSON.parse(source);if(!isJsonObject(value)){throw new TypeError("expected a JSON object")}return value};var roundConstants=[1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298];var initialState=[1779033703,3144134277,1013904242,2773480762,1359893119,2600822924,528734635,1541459225];var rotateRight=(value,bits)=>value>>>bits|value<<32-bits;var padded=(message)=>{const blocks=Math.ceil((message.length+9)/64);const bytes=new Uint8Array(blocks*64);bytes.set(message);bytes[message.length]=128;const view=new DataView(bytes.buffer);view.setUint32(bytes.length-8,Math.floor(message.length*8/2**32));view.setUint32(bytes.length-4,message.length*8>>>0);return bytes};var compress=(state,block)=>{const words=[];for(let index=0;index<16;index+=1){words[index]=block.getUint32(index*4)}for(let index=16;index<64;index+=1){const early=words[index-15]??0;const late=words[index-2]??0;const small0=rotateRight(early,7)^rotateRight(early,18)^early>>>3;const small1=rotateRight(late,17)^rotateRight(late,19)^late>>>10;words[index]=(words[index-16]??0)+small0+(words[index-7]??0)+small1>>>0}let[a=0,b=0,c=0,d=0,e=0,f=0,g=0,h=0]=state;for(let index=0;index<64;index+=1){const big1=rotateRight(e,6)^rotateRight(e,11)^rotateRight(e,25);const choice=e&f^~e&g;const first=h+big1+choice+(roundConstants[index]??0)+(words[index]??0)>>>0;const big0=rotateRight(a,2)^rotateRight(a,13)^rotateRight(a,22);const majority=a&b^a&c^b&c;const second=big0+majority>>>0;h=g;g=f;f=e;e=d+first>>>0;d=c;c=b;b=a;a=first+second>>>0}const next=[a,b,c,d,e,f,g,h];for(let index=0;index<8;index+=1){state[index]=(state[index]??0)+(next[index]??0)>>>0}};var sha256Hex=(text)=>{const bytes=padded(new TextEncoder().encode(text));const state=[...initialState];for(let offset=0;offset<bytes.length;offset+=64){compress(state,new DataView(bytes.buffer,offset,64))}return state.map((word)=>word.toString(16).padStart(8,"0")).join("")};var compareUtf16CodeUnits=(left,right)=>{const length=Math.min(left.length,right.length);for(let index=0;index<length;index+=1){const difference=left.charCodeAt(index)-right.charCodeAt(index);if(difference!==0){return difference}}return left.length-right.length};var deepFreeze=(value)=>{if(value!==null&&typeof value==="object"&&!Object.isFrozen(value)){Object.freeze(value);for(const child of Object.values(value)){deepFreeze(child)}}return value};var SchemaConsumerProfiles=Object.freeze({automationGraphInput:"workflow_value",automationGraphOutput:"workflow_value",connectionCredential:"interactive_form",connectorSettings:"interactive_form",form:"interactive_form",knowledgeEntity:"knowledge_record",notificationCredential:"interactive_form",studioComponentProps:"studio_props",toolInput:"ai_function_input",toolOutput:"runtime_json",toolSettings:"interactive_form",workflowConfiguration:"workflow_value",workflowFieldValue:"workflow_value",workflowInput:"workflow_value",workflowOutput:"workflow_value",workflowPortValue:"workflow_value"});var annotationKeywords=["$anchor","$comment","$id","$schema","$vocabulary","deprecated","description","examples","readOnly","title","writeOnly"];var structuralKeywords=["$defs","$ref","additionalProperties","const","enum","items","properties","required","type"];var boundKeywords=["exclusiveMaximum","exclusiveMinimum","maxItems","maxLength","maxProperties","maximum","minItems","minLength","minProperties","minimum","multipleOf","pattern","uniqueItems"];var UnrestrictedScopeKeyword="x-unrestricted-scope";var FqnOfKeyword="x-fqn-of";var FqnKind=Object.freeze({KnowledgeDomain:"knowledge-domain",KnowledgeEntitySchema:"knowledge-entity-schema"});var HostBindingSettingKeys=Object.freeze(["approvalMode","approvalRuleId"]);var baseProfileKeywords=[...annotationKeywords,...structuralKeywords,...boundKeywords];var ConsumerProfiles=deepFreeze({ai_function_input:{allowedFidelity:["exact","structural"],allowedKeywords:[...baseProfileKeywords,"anyOf"],id:"ai_function_input",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","oneOf","not","patternProperties","prefixItems","contains","dependentRequired","if","then","else","unevaluatedItems","unevaluatedProperties"]},interactive_form:{allowedFidelity:["exact"],allowedKeywords:[...baseProfileKeywords,"anyOf","default","format",FqnOfKeyword,UnrestrictedScopeKeyword],id:"interactive_form",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","oneOf","not","patternProperties","contains","dependentRequired","if","then","else","prefixItems","unevaluatedItems","unevaluatedProperties"]},knowledge_record:{allowedFidelity:["exact","structural"],allowedKeywords:[...baseProfileKeywords,"format"],id:"knowledge_record",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","anyOf","oneOf","not","patternProperties","prefixItems","contains","dependentRequired","if","then","else","unevaluatedItems","unevaluatedProperties"]},runtime_json:{allowedFidelity:["exact","structural"],allowedKeywords:null,id:"runtime_json",rootObject:false,unsupportedKeywords:["$dynamicRef","$dynamicAnchor"]},studio_props:{allowedFidelity:["exact"],allowedKeywords:[...baseProfileKeywords,"anyOf","default","format"],id:"studio_props",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","oneOf","not","patternProperties","contains","dependentRequired","if","then","else","prefixItems","unevaluatedItems","unevaluatedProperties"]},workflow_value:{allowedFidelity:["exact","structural"],allowedKeywords:[...baseProfileKeywords,"default","format","oneOf"],id:"workflow_value",rootObject:false,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","anyOf","not","unevaluatedItems","unevaluatedProperties"]}});var knownVocabularies=new Set(["https://json-schema.org/draft/2020-12/vocab/applicator","https://json-schema.org/draft/2020-12/vocab/content","https://json-schema.org/draft/2020-12/vocab/core","https://json-schema.org/draft/2020-12/vocab/format-annotation","https://json-schema.org/draft/2020-12/vocab/format-assertion","https://json-schema.org/draft/2020-12/vocab/meta-data","https://json-schema.org/draft/2020-12/vocab/unevaluated","https://json-schema.org/draft/2020-12/vocab/validation"]);var schemaArrayKeywords=new Set(["allOf","anyOf","oneOf","prefixItems"]);var schemaMapKeywords=new Set(["$defs","patternProperties","properties"]);var schemaValueKeywords=new Set(["additionalProperties","contains","else","if","items","not","then","unevaluatedItems","unevaluatedProperties"]);var fqnKinds=new Set(Object.values(FqnKind));var plainFormWidgets=["checkbox","color","date","date_range","datetime","email","file","hidden","number","password","structured_file_preview","switch","text","textarea","user_multi_select","user_select","variable_references"];var selectFormWidgets=["folders_explorer","multi_select","radio","select"];var isVariableReference=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value)&&Object.keys(value).length===1&&("$variable"in value)&&typeof value.$variable==="string";var invalid=(path)=>{throw new TypeError(`Invalid package manifest at ${path}`)};var string=(v,p)=>typeof v==="string"?v:invalid(p);var identity=(v,p)=>{const s=string(v,p);return s.trim()===""?invalid(p):s};var assertDenseArrays=(value,path,seen)=>{if(typeof value!=="object"||value===null||seen.has(value)){return}seen.add(value);if(Array.isArray(value)){for(let index=0;index<value.length;index+=1){if(!Object.hasOwn(value,index)){invalid(`${path}/${index}`)}}}for(const[key,child]of Object.entries(value)){assertDenseArrays(child,`${path}/${key}`,seen)}};var boolean=(v,p)=>typeof v==="boolean"?v:invalid(p);var number=(v,p)=>typeof v==="number"&&Number.isFinite(v)?v:invalid(p);var positiveSafeInteger=(value,path)=>{const parsed=number(value,path);return Number.isSafeInteger(parsed)&&parsed>0?parsed:invalid(path)};var optional=(read)=>(v,p)=>v===undefined?undefined:read(v,p);var nullable=(read)=>(v,p)=>v===null?null:read(v,p);var literal=(...values)=>(v,p)=>{for(const value of values){if(v===value){return value}}return invalid(p)};var array=(read)=>(v,p)=>{if(!Array.isArray(v)){return invalid(p)}return v.map((item,index)=>read(item,`${p}/${index}`))};var record=(read)=>(v,p)=>{if(typeof v!=="object"||v===null||Array.isArray(v)){return invalid(p)}return Object.fromEntries(Object.entries(v).map(([key,value])=>[key,read(value,`${p}/${key}`)]))};var object=(fields)=>(v,p)=>{if(typeof v!=="object"||v===null||Array.isArray(v)){return invalid(p)}const entries=Object.entries(v);for(const key in fields){if(!Object.hasOwn(fields,key)){continue}fields[key](entries.find(([name])=>name===key)?.[1],`${p}/${key}`)}return v};var varying=(read)=>(v,p)=>isVariableReference(v)?v:read(v,p);var varyingStructure=(read)=>(v,p)=>isVariableReference(v)?v:read(v,p);var varyingArray=(read)=>array(varying(read));var varyingStrings=varyingArray(string);var excludedKey=/^(?:fqn|kind|lifecycle|version)$|Fqn$/u;var varyingFields=(fields)=>{const wrapped=Object.fromEntries(Object.entries(fields).map(([key,read])=>[key,excludedKey.test(key)?read:varying(read)]));return wrapped};var varyingObject=(fields)=>object(varyingFields(fields));var substituted=(read)=>(v,p)=>read(v,p);var refine=(read,violation)=>(v,p)=>{const value=read(v,p);return violation(value)===undefined?value:invalid(p)};var onlyKeys=(...keys)=>(value)=>Object.keys(value).some((key)=>!keys.includes(key))?"unexpected member":undefined;var withoutKeys=(keys,read)=>(value,path)=>{const declaration=read(value,path);const key=keys.find((name)=>(name in declaration));return key===undefined?declaration:invalid(`${path}/${key}`)};var strings=array(string);var optString=optional(string);var optBoolean=optional(boolean);var optNumber=optional(number);var optStrings=optional(strings);var json=(v)=>parseJsonObject(canonicalJson({value:v})).value;var jsonObject=record(json);var base={description:optString,displayName:string,fqn:identity,icon:optString,tags:optStrings,version:string};var union=(left,right)=>(v,p)=>{try{return left(v,p)}catch(error){if(!(error instanceof TypeError)){throw error}return right(v,p)}};var schemaDocument=(v,p)=>{const doc=jsonObject(v,p);const schemaType=literal("array","boolean","integer","null","number","object","string");const fields={$anchor:optString,$comment:optString,$defs:optional(record(schemaDocument)),$dynamicAnchor:optString,$dynamicRef:optString,$id:optString,$ref:optString,$schema:optional(literal("https://json-schema.org/draft/2020-12/schema")),additionalProperties:optional(union(boolean,schemaDocument)),allOf:optional(array(schemaDocument)),anyOf:optional(array(schemaDocument)),const:optional(json),contains:optional(schemaDocument),default:optional(json),dependentRequired:optional(record(strings)),description:optString,else:optional(schemaDocument),enum:optional(array(json)),exclusiveMaximum:optNumber,exclusiveMinimum:optNumber,format:optString,if:optional(schemaDocument),items:optional(schemaDocument),maxItems:optNumber,maxLength:optNumber,maxProperties:optNumber,maximum:optNumber,minItems:optNumber,minLength:optNumber,minProperties:optNumber,minimum:optNumber,multipleOf:optNumber,not:optional(schemaDocument),oneOf:optional(array(schemaDocument)),pattern:optString,patternProperties:optional(record(schemaDocument)),prefixItems:optional(array(schemaDocument)),properties:optional(record(schemaDocument)),required:optStrings,then:optional(schemaDocument),title:optString,type:optional(union(schemaType,array(schemaType))),unevaluatedItems:optional(union(boolean,schemaDocument)),unevaluatedProperties:optional(union(boolean,schemaDocument)),uniqueItems:optBoolean};return object(fields)(doc,p)};var schema=object({dialect:literal("https://json-schema.org/draft/2020-12/schema"),document:schemaDocument,fidelity:literal("exact","structural")});var visibility=object({equals:optional(json),field:string,in:optional(array(json)),isNotSet:optBoolean,isSet:optBoolean,notEquals:optional(json),notIn:optional(array(json))});var visibilityRule=object({logic:optional(literal("and","or")),visibleWhen:union(visibility,array(visibility))});var validationRule=(v,p)=>{const{type}=object({type:string})(v,p);const messages={code:optString,message:optString};switch(type){case"min_length":case"max_length":case"min":case"max":{return object({...messages,type:literal(type),value:number})(v,p)}case"pattern":{return object({...messages,type:literal(type),value:string})(v,p)}case"required":{return object({...messages,type:literal("required")})(v,p)}default:{return object({...messages,type:literal("integer","json","non_empty_array")})(v,p)}}};var selectOption=object({label:optString,locked:optBoolean,value:string});var selectOptions=object({aiFill:optional(object({buttonLabel:optString,prompt:string,retryable:optBoolean})),allowClear:optBoolean,allowCustom:optBoolean,dataSource:optString,dependencies:optStrings,options:optional(array(union(string,selectOption))),preventSaveWhenEmpty:optBoolean,readonlyOnUpdate:optBoolean,searchable:optBoolean,selectionMetadataField:optString,submit:optBoolean});var fieldUiBase={"ui:disabled":optBoolean,"ui:help":optString,"ui:order":optNumber,"ui:placeholder":optString,"ui:readonly":optBoolean,"ui:suggestedName":optString,"ui:validation":optional(array(validationRule))};var absent=(v,p)=>v===undefined?undefined:invalid(p);var plainFieldUi=object({...fieldUiBase,"ui:options":absent,"ui:widget":literal(...plainFormWidgets)});var selectFieldUi=object({...fieldUiBase,"ui:options":optional(selectOptions),"ui:widget":optional(literal(...selectFormWidgets))});var structuredFileUploadFieldUi=object({...fieldUiBase,"ui:options":optional(object({formatField:optString})),"ui:widget":literal("structured_file_upload")});var structuredFileBrowserFieldUi=object({...fieldUiBase,"ui:options":object({contribution:object({componentFqn:string,connectionSlot:string}),formatField:optString,label:optString}),"ui:widget":literal("structured_file_browser")});var fieldUi=union(union(plainFieldUi,selectFieldUi),union(structuredFileUploadFieldUi,structuredFileBrowserFieldUi));var formItems=array(union(string,object({md:string})));var form=object({createSteps:optional(array(object({description:optional(nullable(string)),id:string,includeInBasicInfo:optional(nullable(boolean)),items:formItems,title:string,visibility:optional(nullable(visibilityRule))}))),layout:optional(literal("stacked","two_column")),schema,uiSchema:optional(record(fieldUi)),updateSections:optional(array(object({description:optional(nullable(string)),items:formItems,layout:optional(nullable(literal("stacked","two_column"))),title:optional(nullable(string))}))),visibility:optional(record(visibilityRule))});var isDeclaredCondition=(input)=>("manifest"in input);var isStructured=(value)=>Object(value)===value;var scansGrantAxis=(value)=>{if(!isStructured(value)){return false}if(Array.isArray(value)){return value.some(scansGrantAxis)}return"grantAxis"in value||Object.values(value).some(scansGrantAxis)};var readsGrantAxis=(input)=>scansGrantAxis(isDeclaredCondition(input)?input.manifest.where:input);var accessCapabilityNode=Symbol.for("@collective-intelligence/extensions-sdk/access-capability-node");var nodeKey=/^[a-z][a-zA-Z0-9]*$/u;var kinds=new Set(["readManage","switch"]);var capabilityNodeDeclarations=(nodes,parentKind,location,reserved=new Set)=>Object.fromEntries(Object.entries(nodes).map(([key,node])=>{if(!nodeKey.test(key)||reserved.has(key)){throw new TypeError(`${location}: capability key '${key}' must match ${nodeKey.source} and must not be ${[...reserved].join(" or ")}`)}const kind=node.kind??parentKind;if(!kinds.has(kind)){throw new TypeError(`${location}.${key}: kind must be "switch" or "readManage"`)}const children=node.children===undefined?undefined:capabilityNodeDeclarations(node.children,kind,`${location}.${key}`);const declaration=children===undefined||Object.keys(children).length===0?{kind}:{children,kind};return[key,declaration]}));var capabilityTree=(identity,children={})=>{const handles={};for(const[key,child]of Object.entries(children)){handles[key]=capabilityTree({...identity,code:`${identity.code}.${key}`,kind:child.kind,path:[...identity.path,key]},child.children)}return Object.freeze({...handles,[accessCapabilityNode]:identity})};var identityOf=(capability,location)=>{const identity=capability[accessCapabilityNode];if(identity===undefined){throw new TypeError(`${location} takes a capability handle or a capability code: a profile never declares a capability inline`)}return identity};var capabilityLevel=(capability,mode,location)=>{if(mode!==undefined&&mode!=="read"&&mode!=="manage"){throw new TypeError(`${location}: mode must be "read" or "manage"`)}if(typeof capability==="string"){if(capability.trim()===""){throw new TypeError(`${location}: a capability code must not be empty`)}return Object.freeze({code:capability,mode:mode??"on"})}const{code,kind}=identityOf(capability,location);if(kind==="switch"){if(mode!==undefined){throw new TypeError(`${location}: the Switch '${code}' takes no mode; it is on when granted`)}return Object.freeze({code,mode:"on"})}if(mode===undefined){throw new TypeError(`${location}: the Read/Manage node '${code}' needs the mode "read" or "manage"`)}return Object.freeze({code,mode})};var capabilityCode=(capability)=>typeof capability==="string"?capability:identityOf(capability,"capability").code;var isHandle=(value)=>(accessCapabilityNode in value);var childHandles=(handle)=>Object.values(handle).filter((value)=>(accessCapabilityNode in value));var capabilityCatalogNodes=(source)=>{const nodes=[];const visit=(handle,parent)=>{const identity=handle[accessCapabilityNode];const node={area:identity.area,code:identity.code,grantable:identity.grantable,key:identity.path.at(-1)??identity.code,kind:identity.kind};nodes.push({...node,...identity.application===undefined?undefined:{application:identity.application},...identity.package===undefined?undefined:{package:identity.package},...parent===undefined?undefined:{parent}});for(const child of childHandles(handle)){visit(child,identity.code)}};for(const root of isHandle(source)?[source]:Object.values(source)){visit(root)}return nodes};var requires=(capability,...[mode])=>{const level=capabilityLevel(capability,mode,"requires");return Object.freeze({mode:level.mode,requires:level.code})};var defineCapabilityCatalog=(input)=>{const roots=Object.entries(input).map(([area,root])=>{const children=capabilityNodeDeclarations(root.children??{},root.kind,`coreCapabilities.${area}`);const coreArea=area;return[area,capabilityTree({area:coreArea,code:area,grantable:root.grantable!==false,kind:root.kind,path:[area]},children)]});return Object.freeze(Object.fromEntries(roots))};var coreCapabilities=defineCapabilityCatalog({dashboard:{kind:"switch",children:{home:{},ai:{children:{skills:{},reports:{},tools:{},agents:{},approvals:{},workflows:{},settings:{}}},knowledge:{children:{schemas:{},connectors:{},data:{},setup:{},settings:{}}},documents:{children:{collections:{},setup:{}}},datasets:{children:{explore:{},catalog:{},setup:{}}},apps:{children:{studio:{},external:{},mcp:{},setup:{}}},monitoring:{children:{activities:{},runHistory:{},feedbacks:{},mappings:{},notifications:{},events:{},usage:{},budgets:{}}},organization:{children:{accounts:{},identity:{},general:{},developers:{},notifications:{},extensions:{},transfer:{},onboarding:{}}}}},studio:{kind:"switch",children:{authoring:{kind:"readManage",children:{agents:{},skills:{},workflows:{},code:{}}},notifications:{},settings:{children:{memories:{},notifications:{},transcription:{},permissions:{}}}}},mcp:{kind:"switch"},admin:{kind:"readManage",children:{organization:{},users:{},groups:{},servicePrincipals:{},guests:{},profiles:{},grants:{},apiKeys:{},connections:{},packages:{},extensions:{children:{repositories:{}}},externalApps:{},studioApps:{},mcp:{},ai:{children:{unrestrictedBindings:{kind:"switch"},skills:{},tools:{},agents:{}}},unrestrictedRuns:{kind:"switch"},aiFeedback:{},aiMemories:{},aiUsage:{},knowledge:{},datasets:{},documents:{},workflows:{},automations:{children:{review:{}}},reports:{},notifications:{children:{channels:{},profiles:{}}},eventsHub:{},organizationTransfer:{children:{export:{kind:"switch"},import:{kind:"switch"},inspect:{kind:"switch"}}}}},platform:{kind:"switch",children:{conversations:{},agents:{},knowledge:{},workflows:{},datasets:{},notifications:{},attachments:{},benchmarks:{},messaging:{}}},data:{kind:"readManage",children:{knowledge:{},documents:{},datasets:{}}},tenant:{kind:"readManage",grantable:false,children:{organizations:{},users:{},infrastructure:{},secrets:{},aiModels:{},studioReleases:{},maintenance:{},settings:{},monitoring:{},eventsHubPii:{kind:"switch"},workflowsPii:{kind:"switch"},data:{}}}});var defineSectionRequirements=(catalog,build)=>Object.freeze(build(catalog).map(([section,requirement])=>Object.freeze({requirement,section:capabilityCode(section)})));var coreSectionRequirements=defineSectionRequirements(coreCapabilities,(c)=>[[c.dashboard.ai.skills,requires(c.admin.ai.skills,"read")],[c.dashboard.ai.tools,requires(c.admin.ai.tools,"read")],[c.dashboard.ai.agents,requires(c.admin.ai.agents,"read")],[c.dashboard.ai.approvals,requires(c.admin.ai,"read")],[c.dashboard.ai.settings,requires(c.admin.ai,"read")],[c.dashboard.ai.reports,requires(c.admin.reports,"read")],[c.dashboard.ai.workflows,requires(c.admin.workflows,"read")],[c.dashboard.knowledge,requires(c.admin.knowledge,"read")],[c.dashboard.documents,requires(c.admin.documents,"read")],[c.dashboard.datasets,requires(c.admin.datasets,"read")],[c.dashboard.apps.studio,requires(c.admin.studioApps,"read")],[c.dashboard.apps.external,requires(c.admin.externalApps,"read")],[c.dashboard.apps.mcp,requires(c.admin.mcp,"read")],[c.dashboard.apps.setup,requires(c.admin.externalApps,"read")],[c.dashboard.monitoring.activities,requires(c.admin.workflows,"read")],[c.dashboard.monitoring.runHistory,requires(c.admin.workflows,"read")],[c.dashboard.monitoring.feedbacks,requires(c.admin.aiFeedback,"read")],[c.dashboard.monitoring.mappings,requires(c.admin.knowledge,"read")],[c.dashboard.monitoring.notifications,requires(c.admin.notifications,"read")],[c.dashboard.monitoring.events,requires(c.admin.eventsHub,"read")],[c.dashboard.monitoring.usage,requires(c.admin.aiUsage,"read")],[c.dashboard.monitoring.budgets,requires(c.admin.aiUsage,"read")],[c.dashboard.organization.accounts,requires(c.admin.users,"read")],[c.dashboard.organization.identity,requires(c.admin.organization,"read")],[c.dashboard.organization.general,requires(c.admin.organization,"read")],[c.dashboard.organization.developers,requires(c.admin.apiKeys,"read")],[c.dashboard.organization.notifications,requires(c.admin.notifications,"read")],[c.dashboard.organization.extensions,requires(c.admin.packages,"read")],[c.dashboard.organization.transfer,requires(c.admin.organizationTransfer.inspect)],[c.dashboard.organization.onboarding,requires(c.admin.organization,"manage")]]);var capabilityGrantKeys=new Set(["code","mode"]);var capabilityGrantsViolation=(capabilities)=>capabilities.every((entry)=>Object.keys(entry).every((key)=>capabilityGrantKeys.has(key))&&typeof entry.code==="string"&&entry.code.trim()!==""&&(entry.mode==="on"||entry.mode==="read"||entry.mode==="manage"))?undefined:"capabilities take access.allow(...) entries: a profile never declares a capability inline";var reservedHandleKeys=new Set(["manifest","schemaSidecars"]);var appliesToValues=new Set(["anonymous","server","user"]);var grantsReachedFrom=(()=>{const nodes=new Map(capabilityCatalogNodes(coreCapabilities).map((node)=>[node.code,node]));const codes=new Set;for(let node=nodes.get(capabilityCode(coreCapabilities.admin.grants));node?.kind==="readManage";node=node.parent===undefined?undefined:nodes.get(node.parent)){codes.add(node.code)}return codes})();var canGrantViolation=(profile)=>(profile.canGrant===undefined||profile.canGrant.length===0)&&profile.capabilities.some(({code,mode})=>mode==="manage"&&grantsReachedFrom.has(code))?'the profile holds admin.grants at manage and must declare canGrant: "all" or the grantable profiles':undefined;var serverAxesViolation=(profile)=>profile.appliesTo==="server"&&(profile.axes??[]).length>0?"a server profile declares no Grant Axes: an app server credential holds its Tuple without axes":undefined;var granteeKeys=new Set(["applicationServer","applicationVisitors","group","servicePrincipal","user"]);var accessGrantFqnMaxLength=320;var grantFqnSegment=/^[a-z0-9]+(?:-[a-z0-9]+)*$/u;var accessGrantFqnViolation=(fqn)=>[...fqn].length<=accessGrantFqnMaxLength&&fqn.split(".").every((segment)=>grantFqnSegment.test(segment))?undefined:`an Access Grant FQN has dot-separated segments that match ${grantFqnSegment.source} and at most ${accessGrantFqnMaxLength} characters`;var knowledgeEntityIdentifierViolation=(value)=>Object.keys(value).length===1&&value.knowledgeEntity!==undefined&&value.knowledgeEntity.field.trim()!==""&&value.knowledgeEntity.value.trim()!==""?undefined:"an Axis Value of a declared grant is a knowledgeEntity({ field: value }) identifier";var audienceKeys=new Set(["anonymous","applications","capabilities","groups","organization","profiles"]);var accessAudienceViolation=(audience)=>{const lists=[["anonymous",audience.anonymous??[]],["applications",audience.applications??[]],["capabilities",(audience.capabilities??[]).map(({code,mode})=>`${code}:${mode}`)],["groups",(audience.groups??[]).map(({fqn})=>fqn)],["profiles",audience.profiles??[]]];for(const[key,fqns]of lists){const repeated=fqns.find((fqn,index)=>fqns.indexOf(fqn)!==index);if(repeated!==undefined){return`audience.${key} lists '${repeated}' more than once`}}return};var onlyTrue=(value,path)=>value===true?true:invalid(path);var fqnList=optional(array(identity));var unexpectedKey=(audience)=>Object.keys(audience).some((key)=>!audienceKeys.has(key));var readAccessAudience=refine(object({anonymous:fqnList,applications:fqnList,capabilities:optional(refine(array(object({code:identity,mode:literal("manage","on","read")})),capabilityGrantsViolation)),groups:optional(array(refine(object({coverage:literal("direct","inherited"),fqn:identity}),onlyKeys("coverage","fqn")))),organization:optional(onlyTrue),profiles:fqnList}),(audience)=>unexpectedKey(audience)?"unexpected member":accessAudienceViolation(audience));var connectionScopes=["organization","user","both"];var connectionScopeViolation=({personalCredentials,scope})=>personalCredentials!==undefined&&(scope===undefined||scope==="organization")?"personalCredentials needs the scope user or both":undefined;var metadata=object({available:boolean,label:string});var connection=(value,path)=>{const declaration=object({...base,compatibility:optional(object({auth:optString,dialect:optString,extensions:optional(jsonObject),provider:optString})),creationMode:optional(literal("self_service","registration_only")),credential:form,defaultConnectionName:string,discoveryMetadata:optional(metadata),kind:literal("connection"),personalCredentials:optional(form),providerFamily:string,scope:optional(literal(...connectionScopes)),secretFields:optStrings,testMetadata:optional(metadata)})(value,path);if(connectionScopeViolation(declaration)!==undefined){return invalid(`${path}/personalCredentials`)}return declaration};var pathParts=array(union(string,number));var bindingModes=array(literal("external","managed"));var syncModes=array(literal("delta","full"));var bindingScopes=array(literal("organization","tenant"));var mutationPolicy=literal("always","connector_backed","never");var extraProps=literal("ignore","import","inline");var outboundStrategy=literal("local_first","remote_first");var updateMode=literal("full","partial");var localized=object({fallbackLocale:string,values:record(string)});var catalogTags=optional(record(strings));var connectionRefs=optional(array(object({catalogCollection:optString,connectionInstanceFqn:optional(identity),connectionTemplateFqn:string,label:string,required:optBoolean,slot:string,visibleWhen:optional(visibility)})));var projectionPath=refine(string,(path)=>path.split(".").every((key)=>/^[^[\]]+(?:\[\d*\])*$/u.test(key))&&path.split("[]").length<=2?undefined:"malformed remote path");var fieldMap=(v,p)=>{const common={direction:literal("both","inbound","outbound"),local:string,skipIfNull:boolean};const{op}=object({op:string})(v,p);switch(op){case"path":{return object({...common,op:literal(op),remote:string})(v,p)}case"cast":{return object({...common,falseValues:optStrings,op:literal(op),remote:string,trueValues:optStrings})(v,p)}case"default":{return object({...common,op:literal(op),remote:optString,value:json})(v,p)}case"concat":{return object({...common,op:literal(op),remote:strings,separator:optString})(v,p)}case"split":{return object({...common,discardEmpty:optBoolean,op:literal(op),remote:string,separators:optStrings,trimItems:optBoolean,uniqueItems:optBoolean})(v,p)}case"coordinates":{return object({...common,latitudeKey:optString,longitudeKey:optString,op:literal(op),remote:(value,location)=>{const parts=strings(value,location);if(parts.length!==2){return invalid(location)}return[string(parts[0],location),string(parts[1],location)]}})(v,p)}case"transform":{return object({...common,op:literal(op),remote:string,transformerId:string})(v,p)}case"reference":{return object({...common,op:literal(op),remote:projectionPath,target:optString})(v,p)}case"embedded":{return object({...common,fieldMap:array((rule,path)=>{const nested=fieldMap(rule,path);if(nested.op==="embedded"){throw new TypeError(`Invalid package manifest at ${path}/op: an embedded rule cannot hold another embedded rule`)}return nested}),op:literal(op),remote:projectionPath,remoteId:string,target:optString})(v,p)}default:{return invalid(`${p}/op`)}}};var predefinedExtras=optional(array(object({displayName:nullable(string),enabled:boolean,id:string,includeInEntityEmbedding:boolean,kind:literal("linked_text","file_source"),slotKey:string,source:jsonObject})));var predefinedSchedules=optional(array(object({cronExpression:string,enabled:optBoolean,importMode:optional(literal("delta","full")),label:optString,rationale:optString,timezone:optString})));var schemaCapability={extraPropsMode:optional(extraProps),fieldMap:optional(array(fieldMap)),fqn:string,outboundStrategy:optional(outboundStrategy),predefinedBindingExtras:predefinedExtras,predefinedBindingKey:optString,predefinedBindingMode:optional(literal("external","managed")),predefinedBindingRemoteCollectionId:optString,predefinedBindingRemoteCollectionName:optString,predefinedSchedules,supportedSyncModes:optional(syncModes),supportsInbound:optBoolean,supportsOutbound:optBoolean,syncIntervalSeconds:optional(nullable(number)),updateMode:optional(updateMode)};var entityCapability=object({...schemaCapability,predefinedBindingParentKey:optString,supportedBindingModes:optional(bindingModes)});var discoveryDefaults=object({extraPropsMode:extraProps,outboundStrategy,supportedBindingModes:bindingModes,supportedSyncModes:syncModes,supportsInbound:boolean,supportsOutbound:boolean,syncIntervalSeconds:nullable(number),updateMode});var datasetCapabilities=object({aggregates:array(literal("count","count_distinct","sum","min","max","avg")),definitionRefresh:boolean,grouping:boolean,intents:array(literal("records","aggregate","time_series")),limits:object({maxBytes:number,maxPageRows:number,maxRows:number,timeoutMs:number}),ordering:boolean,pagination:boolean,predicates:array(literal("eq","ne","lt","lte","gt","gte","in","not_in","is_null","is_not_null","contains","starts_with"))});var readOverviewBudget=(value,path)=>{const parsed=positiveSafeInteger(value,path);return parsed<=1e6?parsed:invalid(path)};var overviewInputMaxChars=optional(nullable(readOverviewBudget));var richEnrichment=optional(nullable(boolean));var fieldReferences=array(object({field:string,scope:literal("data","entity")}));var ownerRelationFields={autocomplete:optional(object({baseFilters:optional(array(object({caseSensitive:optBoolean,field:identity,operator:literal("contains","contains_all","contains_any","contains_none","ends_with","eq","exists","gt","gte","in","is_empty","is_not_empty","is_not_null","is_null","lt","lte","ne","nin","not_contains","not_in","starts_with"),value:json}))),fields:optional(fieldReferences)})),display:optional(object({fields:fieldReferences})),inverseOf:optional((_value,path)=>invalid(path)),onDelete:optional(literal("clear","restrict")),targetSchemaFqn:identity};var ownerRelation=union(object({...ownerRelationFields,cardinality:literal("one_to_one","many_to_one"),maxItems:optional((_value,path)=>invalid(path))}),object({...ownerRelationFields,cardinality:literal("one_to_many","many_to_many"),maxItems:optional(positiveSafeInteger)}));var inverseRelation=object({autocomplete:optional((_value,path)=>invalid(path)),cardinality:optional((_value,path)=>invalid(path)),display:optional(object({fields:fieldReferences})),inverseOf:object({field:refine(identity,(pointer)=>/^\/(?:[^~/]|~[01])+$/u.test(pointer)?undefined:"top-level pointer"),schemaFqn:identity}),maxItems:optional((_value,path)=>invalid(path)),onDelete:optional((_value,path)=>invalid(path)),targetSchemaFqn:optional((_value,path)=>invalid(path))});var relation=union(ownerRelation,inverseRelation);var fieldSemantics=object({defaultSearch:optBoolean,embedded:optBoolean,faceted:optBoolean,file:optional(object({accepts:strings,maxBytes:optional(positiveSafeInteger),multiple:boolean})),includeInItemEmbedding:optBoolean,indexContent:optBoolean,indexOverview:optBoolean,indexed:optBoolean,managedProjectionSource:optional(literal("organization_group","organization_user")),mediaVisibility:optional(literal("private","protected","public")),overviewInputMaxChars,queryGuidance:optString,relation:optional(relation),richEnrichment,unique:optBoolean,user:optional(object({accounts:optional((value,path)=>value===true?true:invalid(path)),multiple:boolean}))});var managedProjection=object({connectorPolicy:literal("allow","deny_schema"),genericMutationPolicy:literal("deny_managed_fields","deny_schema"),kind:literal("directory_person","directory_person_in_group","directory_group","directory_group_parent"),source:literal("organization_group","organization_group_hierarchy","organization_group_membership","organization_user")});var fieldLocalization=object({description:optional(localized),help:optional(localized),label:optional(localized),placeholder:optional(localized)});var fieldPresentation=object({copyable:optBoolean,editor:optString,editorOptions:optional(object({accepts:optStrings,allowCustomValues:optBoolean,autocomplete:optString,clearable:optBoolean,falseLabel:optString,multiple:optBoolean,options:optional(array(object({label:string,value:string}))),rows:optNumber,searchable:optBoolean,showButtons:optBoolean,spellcheck:optBoolean,step:optNumber,trueLabel:optString})),emptyLabel:optString,falseLabel:optString,hidden:optBoolean,layout:optional(object({column:optNumber,labelPlacement:optional(literal("left","top")),order:optNumber,row:optNumber,width:optional(union(number,literal("full")))})),maxLines:optNumber,readOnly:optBoolean,renderer:optString,trueLabel:optString});var lifecycle=object({deployMode:literal("init_only","upsert"),readonly:boolean});var withoutRetiredRelationKey=(read,key)=>(value,path)=>{const parsed=read(value,path);if(key in parsed){throw new TypeError(`Invalid package manifest at ${path}/${key}: ${key} is retired with Record Relations; declare a Reference Field instead`)}return parsed};var autocompleteConfiguration=object({autocompleteFields:fieldReferences,defaultAutocompleteFields:fieldReferences});var knowledgeSchema={catalogTags,domainFqn:string,fieldLocalization:optional(record(fieldLocalization)),fieldPresentation:optional(record(fieldPresentation)),fieldSemantics:optional(record(fieldSemantics)),localMutationPolicy:optional(mutationPolicy),managedProjection:optional(managedProjection),schema};var selectionKeys=(selection)=>{if(selection===undefined){return[]}return"except"in selection?selection.except:selection};var nestedConditions=(node)=>{if("and"in node){return node.and}if("or"in node){return node.or}if("not"in node){return[node.not]}return"via"in node?[node.via.condition]:[]};var operands=(node)=>{if("exists"in node){return[node.exists]}if("isNull"in node){return[node.isNull]}if("contains"in node){return node.contains}if("eq"in node){return node.eq}if("gt"in node){return node.gt}if("gte"in node){return node.gte}if("isIn"in node){return node.isIn}if("lt"in node){return node.lt}if("lte"in node){return node.lte}if("neq"in node){return node.neq}if("overlaps"in node){return node.overlaps}return"startsWith"in node?node.startsWith:[]};var collectReads=(node,read)=>{if("condition"in node){return false}for(const operand of operands(node)){if("grantAxis"in operand){read.add(operand.grantAxis)}}return nestedConditions(node).every((child)=>collectReads(child,read))};var unreadConditionAxes=(axes,where)=>{const read=new Set;if(where!==undefined&&!collectReads(where,read)){return[]}return axes.flatMap((rule)=>("byCondition"in rule)&&!read.has(rule.axis)?[rule.axis]:[])};var purposes=new Set(["access","administration"]);var operations=new Set(["read","write"]);var knowledgeDataPolicyViolation=(policy)=>{if(!operations.has(policy.operation)||!purposes.has(policy.purpose)){return'operation is "read" or "write" and purpose is "access" or "administration"'}const rules=policy.axes??[];const axes=rules.map(({axis})=>axis);if(new Set(axes).size!==axes.length){return"axes binds one rule per axis"}const[unread]=unreadConditionAxes(rules,policy.where);if(unread!==undefined){return`byCondition(${unread}) needs a where that reads grantAxis(${unread})`}if(policy.operation==="read"&&policy.writableFields!==undefined){return"writableFields belongs to write policies"}if(policy.operation==="write"&&policy.readableFields!==undefined){return"readableFields belongs to read policies"}const keys=[...selectionKeys(policy.readableFields),...selectionKeys(policy.writableFields)];return keys.some((key)=>key.trim()==="")?"a field key must not be empty":undefined};var coreKinds=new Set(["admin","default","tenant"]);var coreData=new Set(["datasets","documents","knowledge"]);var documentOperations=new Set(["history","read","write"]);var mode=literal("manage","on","read");var coverage=literal("direct","inherited");var operation=literal("read","write");var documentOperation=literal("history","read","write");var capabilityNode=(value,path)=>refine(object({children:optional(record(capabilityNode)),kind:literal("readManage","switch")}),onlyKeys("children","kind"))(value,path);var capabilityNodes=(value,path)=>{const nodes=record(capabilityNode)(value,path);capabilityNodeDeclarations(nodes,"readManage",path,new Set(["manifest","schemaSidecars"]));return nodes};var applicationCapabilityNodes=(value,path)=>{const nodes=record(capabilityNode)(value,path);capabilityNodeDeclarations(nodes,"switch",path);return nodes};var capabilityGrants=refine(array(object({code:identity,mode})),capabilityGrantsViolation);var requirement=refine(object({mode,requires:identity}),onlyKeys("mode","requires"));var singleKey=(value,path)=>{const keys=Object.keys(jsonObject(value,path));const[key]=keys;return keys.length===1&&key!==undefined?key:invalid(path)};var variant=(readers,key,path)=>(key===undefined||!Object.hasOwn(readers,key)?undefined:readers[key])??(()=>invalid(path));var operandReaders={grantAxis:object({grantAxis:identity}),resource:object({resource:identity}),subject:object({subject:identity}),value:object({value:json})};var operand=(value,path)=>variant(operandReaders,singleKey(value,path),path)(value,path);var comparisonOperators=new Set(["contains","eq","gt","gte","isIn","lt","lte","neq","overlaps","startsWith"]);var comparison=refine(array(operand),(pair)=>pair.length===2?undefined:"a comparison has two operands");var condition=(value,path)=>{const key=singleKey(value,path);const at=`${path}/${key}`;const member=jsonObject(value,path)[key];if(key==="and"||key==="or"){refine(array(condition),(items)=>items.length===0?"needs a condition":undefined)(member,at)}else if(key==="not"){if(readsGrantAxis(condition(member,at))){invalid(at)}}else if(comparisonOperators.has(key)){comparison(member,at)}else if(key==="exists"||key==="isNull"){operand(member,at)}else if(key==="condition"||key==="isMe"||key==="includesMe"){identity(member,at)}else if(key==="inGroup"){object({coverage,field:identity,group:identity})(member,at)}else if(key==="inMyGroups"){object({coverage,field:identity})(member,at)}else if(key==="via"){object({condition,resource:identity})(member,at)}else{invalid(at)}return value};var fieldSelection=union(array(identity),refine(object({except:array(identity)}),onlyKeys("except")));var isTrue=(value,path)=>value===true?true:invalid(path);var bindingReaders={field:object({field:identity}),relation:object({relation:object({field:identity,key:identity})}),self:object({self:isTrue})};var axisBinding=(value,path)=>variant(bindingReaders,singleKey(value,path),path)(value,path);var policyAxis=(value,path)=>{const rule=jsonObject(value,path);const keys=Object.keys(rule).filter((key)=>key!=="axis");const[key]=keys;identity(rule.axis,`${path}/axis`);if(keys.length!==1||key===undefined){return invalid(path)}if(key==="map"){axisBinding(rule.map,`${path}/map`)}else if(key!=="byCondition"&&key!=="unscoped"){invalid(`${path}/${key}`)}else{isTrue(rule[key],`${path}/${key}`)}return value};var knowledgeEntityIdentifier=refine(object({knowledgeEntity:object({field:identity,value:identity})}),knowledgeEntityIdentifierViolation);var granteeReaders={applicationServer:refine(object({applicationServer:identity}),onlyKeys("applicationServer")),applicationVisitors:refine(object({applicationVisitors:identity}),onlyKeys("applicationVisitors")),group:refine(object({coverage,group:object({fqn:identity})}),onlyKeys("coverage","group")),servicePrincipal:refine(object({servicePrincipal:identity}),onlyKeys("servicePrincipal")),user:refine(object({user:object({email:identity})}),onlyKeys("user"))};var grantee=(value,path)=>variant(granteeReaders,Object.keys(jsonObject(value,path)).find((name)=>name!=="coverage"),path)(value,path);var documentFolderTarget=union(refine(object({drive:identity,folders:strings}),onlyKeys("drive","folders")),refine(object({remoteId:identity}),onlyKeys("remoteId")));var documentDataPolicy=(value,path)=>{const policy=refine(object({...base,capability:requirement,collection:optional(identity),folder:optional(object({collection:identity,target:documentFolderTarget})),kind:literal("accessDocumentDataPolicy"),lifecycle:optional(lifecycle),operation:documentOperation}),({collection,folder})=>collection===undefined===(folder===undefined)?"name a collection or a folder":undefined)(value,path);return policy};var conditionTest=object({expected:boolean,name:identity,record:jsonObject,subject:optional(jsonObject)});var accessPrimitives={accessCapabilities:object({...base,grantableBy:literal("admins","holders"),kind:literal("accessCapabilities"),lifecycle:optional(lifecycle),nodes:capabilityNodes}),accessDocumentDataPolicy:documentDataPolicy,accessGrantAxis:object({...base,hierarchy:optional(identity),kind:literal("accessGrantAxis"),label:identity,lifecycle:optional(lifecycle),target:identity}),accessKnowledgeDataCondition:object({...base,kind:literal("accessKnowledgeDataCondition"),lifecycle:optional(lifecycle),target:identity,tests:optional(array(conditionTest)),where:condition}),accessKnowledgeDataPolicy:refine(object({...base,axes:optional(array(policyAxis)),capability:requirement,kind:literal("accessKnowledgeDataPolicy"),lifecycle:optional(lifecycle),operation,otherAxes:optional(literal("unscoped")),purpose:literal("access","administration"),readableFields:optional(fieldSelection),target:identity,where:optional(condition),writableFields:optional(fieldSelection)}),knowledgeDataPolicyViolation),accessMaxPrivileges:object({...base,appliesTo:union(refine(object({applicationTokens:identity}),onlyKeys("applicationTokens")),refine(object({apiKeyTemplate:identity}),onlyKeys("apiKeyTemplate"))),capabilities:capabilityGrants,kind:literal("accessMaxPrivileges"),lifecycle:optional(lifecycle)}),accessProfile:withoutKeys(["audience"],refine(object({...base,appliesTo:literal("anonymous","server","user"),axes:optional(array(identity)),canGrant:optional(union(literal("all"),array(identity))),capabilities:capabilityGrants,kind:literal("accessProfile"),lifecycle:optional(lifecycle)}),(profile)=>canGrantViolation(profile)??serverAxesViolation(profile))),accessProfileGrant:refine(object({...base,axes:optional(record(knowledgeEntityIdentifier)),grantee,kind:literal("accessProfileGrant"),lifecycle:optional(lifecycle),profile:identity}),(grant)=>accessGrantFqnViolation(grant.fqn))};var assertDataAccess=(value,own,location)=>{if(value===undefined){return}if(typeof value!=="object"||value===null||Array.isArray(value)){throw new TypeError(`${location}: dataAccess must be an object`)}for(const[source,mode]of Object.entries(value)){if(!["knowledge","datasets","documents"].includes(source)){throw new TypeError(`${location}: unknown dataAccess source '${source}'`)}if(mode!=="user"&&mode!==own){throw new TypeError(`${location}: dataAccess.${source} must be 'user' or '${own}'`)}}};var readDataAccess=(own)=>(value,location)=>{assertDataAccess(value,own,location);return value};var workflowDataAccess=(outer,inner,location)=>{assertDataAccess(outer,"workflow",location);assertDataAccess(inner,"workflow",`${location}.definition`);if(outer!==undefined&&inner!==undefined){for(const source of["knowledge","datasets","documents"]){if((outer[source]??"workflow")!==(inner[source]??"workflow")){throw new TypeError(`${location}: conflicting dataAccess.${source} in declaration and definition`)}}}return outer??inner};var usesBindingKeys=["approval","description","fqn","name","settings"];var definedBindingKeys=new Set(usesBindingKeys);var boundTool=Symbol("boundTool");var usesBindingDeclaration=(entry)=>typeof entry==="string"?{fqn:entry}:entry;var duplicateUsesBinding=(bindings)=>{const seen=new Set;for(const entry of bindings){const binding=usesBindingDeclaration(entry);const key=JSON.stringify([binding.fqn,binding.name??null]);if(seen.has(key)){return binding}seen.add(key)}return};var agentModelTiers=["complex","balanced","fast","super_fast"];var datasetParserFormat=(value,path)=>{if(typeof value!=="string"||value.length>128||value==="external"||!/^[a-z][a-z0-9._-]*$/u.test(value)){throw new TypeError(`Invalid dataset parser format at ${path}`)}return value};var datasetParserVersion=(value,path)=>{if(typeof value!=="string"||value.trim()===""||value.length>96){throw new TypeError(`Invalid dataset parser version at ${path}`)}return value};var assertNoHostKeys=(form,location)=>{const properties=form.schema.document.properties??{};const defined=HostBindingSettingKeys.filter((key)=>Object.hasOwn(properties,key));if(defined.length>0){throw new TypeError(defined.map((key)=>`${location}/properties/${key}: the host owns '${key}'; a Binding Settings Form cannot define it`).join("; "))}};var closedGatewayObject=(fields)=>refine(object(fields),(value)=>Object.keys(value).some((key)=>!Object.hasOwn(fields,key))?"unexpected Gateway field":undefined);var identifier=refine(string,(value)=>/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/u.test(value)?undefined:"invalid identifier");var version=refine(string,(value)=>value.length>0&&value.length<=128&&value.trim()===value?undefined:"invalid version");var bounded=(maximum,minimum=1)=>refine(number,(value)=>Number.isSafeInteger(value)&&value>=minimum&&value<=maximum?undefined:"invalid limit");var unique=(read,key)=>refine(read,(values)=>new Set(values.map(key)).size===values.length?undefined:"duplicate identifier");var projection=refine(schema,(value)=>(value.fidelity==="exact"||value.fidelity==="structural")&&Object.keys(value).every((key)=>key==="dialect"||key==="document"||key==="fidelity")?undefined:"unsupported Gateway projection");var authorization=closedGatewayObject({delegatedSubject:literal("allowed","forbidden","required"),organization:literal("required"),principalKinds:refine(unique(array(literal("detached_user","service_principal")),(kind)=>kind),(values)=>values.length>0?undefined:"empty principalKinds"),scopes:unique(array(refine(string,(value)=>value.length>0&&value.length<=256?undefined:"invalid scope")),(scope)=>scope)});var operationFields={authorization,description:string,effects:literal("external_side_effect","read","write"),execution:closedGatewayObject({mode:literal("synchronous"),timeoutMs:bounded(3600000)}),id:identifier,idempotency:literal("idempotent","requires_key","safe"),input:projection,limits:closedGatewayObject({maxRequestBytes:bounded(16777216),maxResponseBytes:bounded(16777216)}),output:projection,retry:union(closedGatewayObject({mode:literal("never")}),closedGatewayObject({maxAttempts:bounded(10,2),mode:literal("idempotent_only")})),title:string,version};var operationReader=closedGatewayObject(operationFields);var domainFields={description:optional(string),displayOrder:optional(number),icon:optional(string),id:identifier,tags:optional(strings),title:string};var domainsReader=unique(array(closedGatewayObject({...domainFields,operations:unique(array(operationReader),(operation)=>operation.id)})),(domain)=>domain.id);var inputReader=closedGatewayObject({id:identifier,operationDomains:domainsReader,version});var empty=refine(array(identity),(values)=>values.length===0?undefined:"operation-only Gateway required");var emptyReader=(value,path)=>{empty(value,path);return[]};var disabled=(value,path)=>boolean(value,path)===false?false:invalid(path);var contractReader=closedGatewayObject({capabilities:closedGatewayObject({resources:disabled}),datasets:emptyReader,id:identifier,knowledge:emptyReader,operationDomains:unique(array(closedGatewayObject({...domainFields,operations:unique(array(closedGatewayObject({...operationFields,canonicalReference:string})),(operation)=>operation.id)})),(domain)=>domain.id),organizationBinding:closedGatewayObject({mode:literal("installed_organization")}),protocolVersion:literal("2"),version});var buildOperationGatewayContract=(input)=>{assertDenseArrays(input,"gateway",new WeakSet);canonicalJson(input);const admitted=inputReader(input,"gateway");return{capabilities:{resources:false},datasets:[],id:admitted.id,knowledge:[],operationDomains:admitted.operationDomains.map((domain)=>({...domain,operations:domain.operations.map((operation)=>({...operation,canonicalReference:`${admitted.id}/${domain.id}/${operation.id}@${operation.version}`})).sort((a,b)=>compareUtf16CodeUnits(a.id,b.id))})).sort((a,b)=>compareUtf16CodeUnits(a.id,b.id)),organizationBinding:{mode:"installed_organization"},protocolVersion:"2",version:admitted.version}};var readOperationGatewayContract=(value,path)=>{assertDenseArrays(value,path,new WeakSet);const admitted=contractReader(value,path);const normalized=buildOperationGatewayContract({id:admitted.id,operationDomains:admitted.operationDomains.map((domain)=>({...domain,operations:domain.operations.map(({canonicalReference:_reference,...operation})=>operation)})),version:admitted.version});if(canonicalJson(admitted)!==canonicalJson(normalized)){invalid(path)}return normalized};var readExternalAppGateway=closedGatewayObject({...base,expectedContract:readOperationGatewayContract,kind:literal("externalAppGateway")});var externalApplicationConsents=["inherit","ask","skip"];var externalApplicationViolation=({applicationConsent,primaryRedirectUri,redirectUris})=>{if(primaryRedirectUri!==undefined&&!isVariableReference(primaryRedirectUri)&&!isVariableReference(redirectUris)&&!redirectUris.some(isVariableReference)&&!redirectUris.includes(primaryRedirectUri)){return"primaryRedirectUri must be one of redirectUris"}if(applicationConsent!==undefined&&!isVariableReference(applicationConsent)&&!externalApplicationConsents.includes(applicationConsent)){return"applicationConsent must be 'inherit', 'ask' or 'skip'"}return};var uuid=/^[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}$/iu;var placeholder=/\{(?<name>[^{}]*)\}/gu;var placeholders={remoteId:(remoteId)=>encodeURIComponent(remoteId),remoteIdUuidHex:(remoteId)=>uuid.test(remoteId)?remoteId.replaceAll("-","").toLowerCase():null};var isPlaceholderName=(name)=>Object.hasOwn(placeholders,name);var resolver=(name)=>isPlaceholderName(name)?placeholders[name]:undefined;var knowledgeRemoteReferenceUrlTemplate=(value,path)=>{if(typeof value!=="string"||!value.startsWith("https://")||/[{}]/u.test(value.replaceAll(placeholder,(match,name)=>resolver(name)===undefined?match:""))){throw new TypeError(`Invalid remote reference URL template at ${path}`)}return value};var subgroupKey=/^[a-z0-9]+(?:-[a-z0-9]+)*$/u;var organizationGroupFqnMaxLength=320;var fqnViolation=(fqn)=>{const characters=[...fqn];if(characters.length<=organizationGroupFqnMaxLength){return}const shortened=`${characters.slice(0,40).join("")}...${characters.slice(-40).join("")}`;return`Group FQN '${shortened}' holds ${characters.length} characters; the limit is ${organizationGroupFqnMaxLength}`};var subgroupsViolation=(parentFqn,subgroups=[])=>{const keys=new Set;for(const{key,subgroups:nested}of subgroups){if(!subgroupKey.test(key)){return`subgroup key '${key}' of '${parentFqn}' must match ${subgroupKey.source}`}if(keys.has(key)){return`subgroup key '${key}' is declared more than once in '${parentFqn}'`}keys.add(key);const fqn=`${parentFqn}.${key}`;const violation=fqnViolation(fqn)??subgroupsViolation(fqn,nested);if(violation!==undefined){return violation}}return};var organizationGroupViolation=({fqn,subgroups})=>fqnViolation(fqn)??subgroupsViolation(fqn,subgroups);var fields=["answerLength","bannedQuestions","enabled","otherInstructions","toneOfVoice"];var organizationInstructionsViolation=(definition)=>fields.some((field)=>definition[field]!==undefined)?undefined:"at least one field is required";var sections=["authentication","branding","governance","identity","locale"];var mediaPath=/^media\/[^/]+$/u;var brandingViolation=(branding)=>{if(branding===undefined||isVariableReference(branding)){return}const paths=new Set;for(const key of["cover","icon","logo"]){const reference=branding[key];const media=isVariableReference(reference)?undefined:reference?.media;if(media===undefined||isVariableReference(media)){continue}if(!mediaPath.test(media)){return`branding.${key} media path '${media}' must be media/<file>`}if(paths.has(media)){return`branding.${key} media path '${media}' is used by two branding keys`}paths.add(media)}return};var authenticationViolation=(authentication)=>{if(authentication===undefined||isVariableReference(authentication)){return}for(const method of["otp","password"]){const local=authentication[method];if(local===undefined||isVariableReference(local)){continue}const{domains,enabled}=local;if(enabled===true&&!isVariableReference(domains)&&(domains??[]).length===0){return`authentication.${method} is enabled and needs at least one domain`}}const{sso}=authentication;for(const[index,entry]of(sso===undefined||isVariableReference(sso)?[]:sso).entries()){if(!isVariableReference(entry)&&entry.provisionMembers===true&&entry.defaultProfile===undefined){return`authentication.sso[${index}] registers members and needs a defaultProfile`}}const consent=authentication.applicationConsent;if(consent!==undefined&&!isVariableReference(consent)&&consent!=="ask"&&consent!=="skip"){return"authentication.applicationConsent must be 'ask' or 'skip'"}return};var organizationSettingsViolation=(definition)=>{if(!sections.some((section)=>Object.keys(definition[section]??{}).length>0)){return"at least one setting is required"}if(definition.identity!==undefined&&"slug"in definition.identity){return"identity.slug is not declarable"}return brandingViolation(definition.branding)??authenticationViolation(definition.authentication)};var packageSourceDeployModes=["managed","ci"];var identifier2=/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/u;var fields2=new Set(["category","description","displayName","fqn","gatewayRef","icon","kind","operationReferences","tags","version"]);var referencesGateway=(reference,gatewayId)=>{const separator=reference.indexOf("@");if(separator===-1){return false}const[gateway,domain,operation,...rest]=reference.slice(0,separator).split("/");const version=reference.slice(separator+1);return identifier2.test(gatewayId)&&gateway===gatewayId&&domain!==undefined&&identifier2.test(domain)&&operation!==undefined&&identifier2.test(operation)&&rest.length===0&&version.length>0&&version.length<=128&&version.trim()===version};var remoteToolCollectionViolation=(declaration)=>{const unknownField=Object.keys(declaration).find((key)=>!fields2.has(key));if(unknownField!==undefined){return`unsupported remote metadata field '${unknownField}'`}const{gatewayRef,operationReferences}=declaration;if(gatewayRef===undefined||gatewayRef.trim()===""||gatewayRef.trim()!==gatewayRef){return"gatewayRef must be a nonempty FQN"}if(operationReferences.length===0||new Set(operationReferences).size!==operationReferences.length||operationReferences.some((reference)=>!referencesGateway(reference,reference.split("/")[0]??""))){return"operationReferences must name unique versioned Gateway operations"}return};var reviewKpis=["safety","efficiency","overlap","quality","custom"];var maxStudioTriggerFormFileBytes=10*1024*1024;var studioFormKey="studioForm";var fieldKeyPattern=/^[A-Za-z][A-Za-z0-9_]*$/u;var contentTypePattern=/^[\w.+-]+\/[\w.+-]+$/u;var fieldKey=refine(identity,(key)=>fieldKeyPattern.test(key)?undefined:"key");var fileField=object({accept:optional(refine(array(refine(identity,(type)=>contentTypePattern.test(type)?undefined:"content type")),(types)=>types.length===0?"no content type":undefined)),key:fieldKey,label:identity,maxBytes:optional(refine(positiveSafeInteger,(bytes)=>bytes>maxStudioTriggerFormFileBytes?"above ceiling":undefined)),type:literal("file")});var valueField=object({key:fieldKey,label:identity,type:literal("boolean","number","text","textarea")});var enumField=object({key:fieldKey,label:identity,options:refine(array(object({label:identity,value:identity})),(options)=>options.length>0&&new Set(options.map(({value})=>value)).size===options.length?undefined:"options"),type:literal("enum")});var jsonField=object({key:fieldKey,label:identity,schema:schemaDocument,type:literal("json")});var entitiesField=object({key:fieldKey,label:identity,labelKey:optional(identity),schemaFqn:identity,type:literal("entities"),valueKey:optional(identity)});var richTextField=object({key:fieldKey,label:identity,type:literal("rich_text")});var userField=object({key:fieldKey,label:identity,multiple:optBoolean,required:optBoolean,type:literal("user_select")});var fieldReaders={boolean:valueField,entities:entitiesField,enum:enumField,file:fileField,json:jsonField,number:valueField,rich_text:richTextField,text:valueField,textarea:valueField,user_select:userField};var formField=(value,path)=>{const{type}=object({type:literal("boolean","entities","enum","file","json","number","rich_text","text","textarea","user_select")})(value,path);return fieldReaders[type](value,path)};var studioFormFields=refine(array(formField),(fields)=>new Set(fields.map(({key})=>key)).size===fields.length?undefined:"duplicate key");var studioTriggerFormAt=(metadata,path)=>optional(object({fields:optional(studioFormFields),organizationGroup:identity}))(metadata[studioFormKey],`${path}/${studioFormKey}`);var studioTriggerMetadata=(read)=>(value,path)=>{const metadata=read(value,path);studioTriggerFormAt(metadata,path);return metadata};var audience=optional(readAccessAudience);var view=object({componentRef:identity,dataBinding:optional(object({filter:optional(jsonObject),kind:literal("schema"),schema:identity})),fqn:identity,orderIndex:number,props:optional(jsonObject),slot:identity});var pageBase={audience,fqn:identity,fullHeight:optBoolean,fullWidth:optBoolean,icon:optString,label:string,orderIndex:number,routeSegment:identity,slug:identity};var genericPage=object({...pageBase,kind:literal("generic"),views:array(view)});var predefinedPage=object({...pageBase,kind:literal("predefined"),predefinedPageRef:identity});var page=(value,path)=>object({kind:literal("generic","predefined")})(value,path).kind==="generic"?genericPage(value,path):predefinedPage(value,path);var layout=(value,path)=>object({kind:literal("custom","left_sidebar")})(value,path).kind==="custom"?object({componentRef:identity,kind:literal("custom"),props:optional(jsonObject)})(value,path):object({kind:literal("left_sidebar")})(value,path);var studioViewKey=(fqn)=>(fqn.split(".").at(-1)??fqn).toLowerCase().replaceAll(/[^a-z0-9]+/gu,"-").replaceAll(/^-+|-+$/gu,"").slice(0,64);var hasDuplicate=(keys)=>new Set(keys).size!==keys.length;var collision=({sections})=>{const pages=sections.map((section)=>section.pages);const views=pages.flat().map((item)=>item.kind==="generic"?item.views:[]);if(hasDuplicate([...sections.map(({fqn})=>fqn),...pages.flat().map(({fqn})=>fqn),...views.flat().map(({fqn})=>fqn)])){return"duplicate FQN"}if(hasDuplicate(sections.map(({slug})=>slug))){return"duplicate section slug"}if(pages.some((items)=>hasDuplicate(items.map(({slug})=>slug)))){return"duplicate page slug"}return views.some((items)=>hasDuplicate(items.map(({fqn,slot})=>`${slot}
|
|
2
|
-
${studioViewKey(fqn)}`)))?"duplicate view key":undefined};var isTrue2=(value,path)=>value===true?true:invalid(path);var studioAppDeclaration=object({...base,audience,definition:refine(object({color:optString,description:optString,icon:optString,layout:optional(layout),name:string,sections:array(object({description:optString,fqn:identity,icon:optString,label:string,orderIndex:number,pages:array(page),slug:identity})),slug:identity}),collision),kind:literal("studioApp"),lifecycle:object({deployMode:literal("upsert"),readonly:isTrue2})});var agentFormFields=(value,path)=>studioFormFields(value,path).map((field,index)=>field.type==="rich_text"||field.type==="user_select"?invalid(`${path}/${index}/type`):field);var studioFormKey2="studioForm";var studioAgentFormAt=(metadata,path)=>optional(object({fields:agentFormFields}))(metadata[studioFormKey2],`${path}/${studioFormKey2}`);var studioAgentMetadata=(read)=>(value,path)=>{const metadata=read(value,path);studioAgentFormAt(metadata,path);return metadata};var WorkflowEditorWidgets=["checkbox","code","condition_builder","credential_selector","key_value","list","mapping_builder","multi_select","number","resource_selector","schedule_builder","schema_builder","select","text","textarea"];var WorkflowTemplateKinds=["action_node","input_node","output_node","trigger_node"];var WorkflowTriggerLifecycleAdapterIds=Object.freeze({externalApplication:"builtin.core.workflows.lifecycle.external-application",mcpOperation:"builtin.core.workflows.lifecycle.mcp-operation"});var duplicateUsesConnection=(connections)=>{const seen=new Set;for(const entry of connections){const connection=typeof entry==="string"?{fqn:entry}:entry;const key=JSON.stringify([connection.fqn,connection.scope??null]);if(seen.has(key)){return connection}seen.add(key)}return};var definitionKinds=["agent","skill","workflow"];var automationTypes=["organization","personal"];var automationDeclarationSegments={automationLimits:"automation-limits",packageSource:"package-sources",placementRule:"placement-rules",repositoryLink:"repository-links",reviewPolicy:"review-policies"};var segment=/^[a-z0-9]+(?:-[a-z0-9]+)*$/u;var kindSegments=new Set(Object.values(automationDeclarationSegments));var rule=`an automation declaration FQN is <package fqn>.<kind>.<slug>: dot-separated segments that match ${segment.source}, and <kind> is one of ${Object.values(automationDeclarationSegments).join(", ")}`;var kebabCase=(fqn)=>fqn.split(".").every((part)=>segment.test(part));var declarationFqnViolation=(fqn,kind)=>{const parts=fqn.split(".");const kindSegment=parts.at(-2)??"";const kindFits=kind===undefined?kindSegments.has(kindSegment):kindSegment===automationDeclarationSegments[kind];return parts.length>=3&&kebabCase(fqn)&&kindFits?undefined:rule};var automationFqnViolation=(kind)=>({fqn})=>declarationFqnViolation(fqn,kind);var concrete=(list)=>list===undefined||isVariableReference(list)?[]:list.filter((item)=>!isVariableReference(item));var spelled=(key)=>key===null||isVariableReference(key)?undefined:key;var knownKeys=(list)=>{if(isVariableReference(list)){return}const keys=new Set;for(const item of list??[]){const key=isVariableReference(item)?undefined:spelled(item.key);if(key===undefined){return}keys.add(key)}return keys};var connection2=union(refine(varyingObject({setupKey:identity}),(value)=>Object.keys(value).some((key)=>key!=="setupKey")?"install-only input":undefined),refine(object({connectionInstanceFqn:identity}),(value)=>Object.keys(value).some((key)=>key!=="connectionInstanceFqn")?"declared connection reference":undefined));var bindingFields={executionRole:optional(literal("root","child")),extraPropsMode:optional(literal("ignore","import","inline")),extras:refine(predefinedExtras,(extras)=>extras?.some((extra)=>!/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu.test(extra.id))?"invalid extra UUID":undefined),fieldMap:optional(array(fieldMap)),key:identity,outboundStrategy:optional(literal("local_first","remote_first")),parentKey:optional(nullable(identity)),remoteCollectionId:optional(nullable(string)),remoteCollectionName:optional(nullable(string)),supportedSyncModes:optional(varyingArray(literal("delta","full"))),supportsInbound:optBoolean,supportsOutbound:optBoolean,syncIntervalSeconds:optional(nullable(positiveSafeInteger)),updateMode:optional(literal("full","partial"))};var entityBinding=varyingObject({...bindingFields,bindingMode:literal("managed","external"),maxRemoteDeletionsPerRun:optional(nullable(positiveSafeInteger)),missingConnectorFieldsBehavior:optional(literal("prune","retain")),pushEntityMatch:optional(literal("remote_ref","unique_fields")),remoteDeletionPropagation:optional(literal("never","full","full_and_delta")),schemaFqn:identity,supportedBindingModes:optional(varyingArray(literal("managed","external"))),suppressEntityEvents:optBoolean});var schedule=varyingObject({cronExpression:identity,enabled:optBoolean,importMode:optional(literal("delta","full")),key:identity,timezone:optString});var positive=refine(number,(n)=>n>0?undefined:"positive");var budget=optional(nullable(positiveSafeInteger));var taskKind=(value,path)=>{if(value==="relation"){throw new TypeError(`Invalid package manifest at ${path}: the pipeline task kind relation is retired with Record Relations; a task names an entity binding`)}return literal("entity")(value,path)};var pipeline=varyingObject({definition:varyingObject({budgets:optional(varyingObject({maxPagesPerRun:budget,maxRemoteItemsPerRun:budget,maxRootWorkUnitsPerRun:budget,maxSecondsPerRun:optional(nullable(positive))})),steps:refine(varyingArray(varyingObject({tasks:varyingArray(varyingObject({bindingKey:identity,kind:taskKind,modeOverride:optional(nullable(literal("delta","full")))}))})),(steps)=>steps.length>0?undefined:"empty")}),enabled:optBoolean,key:identity,name:optString,schedules:optional(varyingArray(schedule))});var uniqueKeys=(values,path)=>{const seen=new Set;for(const[index,value]of values.entries()){const key=spelled(value.key);if(key===undefined){continue}if(seen.has(key)){invalid(`${path}/${index}/key`)}seen.add(key)}};var knowledge=withoutRetiredRelationKey(varyingObject({...base,connections:optional(record(connection2)),enabled:optBoolean,entityBindings:optional(varyingArray(entityBinding)),kind:literal("knowledgeConnectorInstance"),lifecycle,pipelines:optional(varyingArray(pipeline)),remoteFilters:optional(record(varyingObject({mode:literal("all","only_selected","all_except_selected"),selected_ids:varyingStrings}))),settings:optional(record(varyingObject({type:literal("inline","linked"),value:json}))),templateFqn:identity}),"relationBindings");var assertEntityParents=(entities,path)=>{const parents=new Map(entities.map((b)=>[spelled(b.key),spelled(b.parentKey)]));for(const binding of entities){const key=spelled(binding.key);if(key===undefined){continue}const seen=new Set([key]);let parent=spelled(binding.parentKey);while(parent!==undefined){if(seen.has(parent)){invalid(`${path}/entityBindings/parentKey`)}seen.add(parent);parent=parents.get(parent)}}};var assertPipelineTasks=(item,entityKeys,path)=>{const tasks=new Set;const definition=isVariableReference(item.definition)?undefined:item.definition;for(const step of concrete(definition?.steps)){for(const task of concrete(step.tasks)){const bindingKey=spelled(task.bindingKey);if(bindingKey===undefined){continue}if(entityKeys?.has(bindingKey)===false||tasks.has(bindingKey)){invalid(`${path}/definition/steps`)}tasks.add(bindingKey)}}};var knowledgeConnectorInstance=(value,path)=>{const parsed=knowledge(value,path);const entities=concrete(parsed.entityBindings);const pipelines=concrete(parsed.pipelines);uniqueKeys(entities,`${path}/entityBindings`);uniqueKeys(pipelines,`${path}/pipelines`);const entityKeys=knownKeys(parsed.entityBindings);assertEntityParents(entities,path);for(const[index,binding]of entities.entries()){const parentKey=spelled(binding.parentKey);if(parentKey!==undefined&&(entityKeys?.has(parentKey)===false||parentKey===spelled(binding.key))){invalid(`${path}/bindings/${index}/parentKey`)}}for(const[index,item]of pipelines.entries()){uniqueKeys(concrete(item.schedules),`${path}/pipelines/${index}/schedules`);assertPipelineTasks(item,entityKeys,`${path}/pipelines/${index}`)}return parsed};var scalar=literal("boolean","string","int64","float64","decimal","date","timestamp","duration","json");var datasetDefinition=varyingObject({fields:varyingArray(varyingObject({id:identity,name:string,nullable:boolean,semantic:optString,type:scalar})),measures:varyingArray(varyingObject({id:identity,name:string,resultType:scalar})),relationships:varyingArray(varyingObject({cardinality:literal("one_to_one","one_to_many","many_to_one","many_to_many"),fromFieldId:identity,id:identity,toFieldId:identity})),version:literal(1)});var location=(value,path)=>{const parsed=varyingObject({segments:varyingArray(varyingObject({kind:literal("container","dataset"),label:string,opaqueId:identity}))})(value,path);if(isVariableReference(parsed.segments)){return parsed}const[first]=parsed.segments;if(first===undefined||!isVariableReference(first)&&first.kind!=="container"){return invalid(`${path}/segments/0`)}return parsed};var datasetValue=(value,path)=>{const{kind}=object({kind:string})(value,path);switch(kind){case"null":{return varyingObject({kind:literal("null")})(value,path)}case"boolean":{return varyingObject({kind:literal("boolean"),value:boolean})(value,path)}case"float64":{return varyingObject({kind:literal("float64"),value:number})(value,path)}case"json":{return varyingObject({kind:literal("json"),value:json})(value,path)}default:{return varyingObject({kind:literal("string","int64","decimal","date","timestamp","duration"),value:string})(value,path)}}};var datasetFilter=(value,path)=>{const{kind}=object({kind:string})(value,path);if(kind==="not"){return varyingObject({filter:datasetFilter,kind:literal("not")})(value,path)}if(kind==="and"||kind==="or"){return varyingObject({filters:varyingArray(datasetFilter),kind:literal("and","or")})(value,path)}return varyingObject({fieldId:identity,kind:literal("predicate"),operator:literal("eq","ne","lt","lte","gt","gte","in","not_in","is_null","is_not_null","contains","starts_with"),values:varyingArray(datasetValue)})(value,path)};var datasetFields={...base,connection:optional(connection2),dataPolicy:optional(varyingObject({allowedFields:varyingStrings,allowedOperations:varyingArray(literal("describe","records","aggregate","time_series")),maxBytes:budget,maxRows:budget,maxTimeoutMs:budget,principals:varyingArray(varyingObject({id:identity,kind:literal("user","service")})),rowFilter:optional(nullable(datasetFilter)),sensitiveFields:optional(varyingStrings)})),kind:literal("datasetConnectorInstance"),lifecycle,providerFqn:identity,schedules:optional(varyingArray(varyingObject({action:literal("health","refresh_definition"),cronExpression:identity,enabled:optBoolean,key:identity,timezone:optString}))),settings:optional(jsonObject)};var datasetConnectorInstance=(value,path)=>{const parsed=union(varyingObject({...datasetFields,bindingMode:literal("managed"),definition:datasetDefinition,sourceLocation:optional(location),templateConfig:optional(varyingObject({variant:identity,version:literal(1)})),templateFqn:optional(identity)}),varyingObject({...datasetFields,bindingMode:literal("external"),definition:optional(datasetDefinition),gatewayBindingKey:optString,sourceLocation:location,sourceMapping:optional(varyingObject({effectiveAtFieldId:optString,entityIdFieldId:identity,historySemantics:optional(literal("append_history")),kind:literal("entity_snapshot","status_update"),statusFieldId:optString,version:literal(1)}))}))(value,path);uniqueKeys(concrete(parsed.schedules),`${path}/schedules`);return parsed};var notificationDefinition=object({capabilities:object({extensionReadyProviders:strings,recipientTargets:strings,supportsActionLink:boolean,supportsAttachments:boolean,supportsFixedDestinations:optBoolean,supportsHtml:boolean,supportsMarkdown:boolean,supportsMentions:boolean,supportsReadReceipts:boolean,supportsRouteDestinations:boolean,supportsThreads:boolean}),credentialProfileKey:optString,family:literal("email","im","internal"),key:string,provider:string,setup:object({docsUrl:nullable(string),healthCheck:object({available:boolean,label:optString}),instructions:string,liveTest:object({available:boolean,label:optString}),secretFields:strings,setupForm:nullable(form)})});var studioPage=object({fullWidth:optBoolean,icon:optString,kind:literal("predefined"),label:string,orderIndex:number,predefinedPageRef:string,routeSegment:string,slug:string});var studioSection=object({description:optString,icon:optString,label:string,orderIndex:number,pages:array(studioPage),slug:string});var studioAppTemplate=object({color:optString,description:optString,icon:optString,isDefaultTemplate:optBoolean,name:string,sections:array(studioSection),slug:string});var datasetScalarType=literal("boolean","string","int64","float64","decimal","date","timestamp","duration","json");var datasetDefinition2=object({fields:array(object({id:string,name:string,nullable:boolean,semantic:optional(string),type:datasetScalarType})),measures:array(object({id:string,name:string,resultType:datasetScalarType})),relationships:array(object({cardinality:literal("one_to_one","one_to_many","many_to_one","many_to_many"),fromFieldId:string,id:string,toFieldId:string})),version:literal(1)});var datasetBlueprint=object({...base,blueprintVersion:positiveSafeInteger,configuration:optional(jsonObject),definition:datasetDefinition2,kind:literal("datasetBlueprint"),templateFqn:identity});var semanticRole=literal("dimension","effective_time","entity_reference","event_time","identity","measure","status");var hint=object({role:semanticRole});var datasetTableTemplate=object({...base,admittedIngestionModes:array(literal("append","replace","upsert")),compatibleProviderFqns:strings,configuration:schema,identity:object({keyRoles:array(semanticRole),uniqueness:literal("append_only","key","none")}),indexHints:array(hint),kind:literal("datasetTableTemplate"),partitionHints:array(hint),physicalCode:literal("evt","fact","gen","snap","stat","ts"),requirements:schema,semanticRoles:array(semanticRole)});var workflowBindingKey=(binding)=>canonicalJson({path:binding.path,target:binding.target});var renderWorkflowBinding=(binding)=>`${binding.target}:${binding.path.join(".")}`;var isConnectionCount=(value)=>value===undefined||value===null||Number.isSafeInteger(value)&&value>=0;var workflowPortPolicyViolation=(port)=>{if(!isConnectionCount(port.minConnections)||!isConnectionCount(port.maxConnections)){return"connection counts must be non-negative integers"}const max=port.maxConnections===undefined?1:port.maxConnections;if(max!==null&&(port.minConnections??0)>max){return"minConnections cannot exceed maxConnections"}if(port.allowedTemplateKinds?.length===0){return"allowedTemplateKinds cannot be empty"}if(port.allowedTemplateFqns?.length===0){return"allowedTemplateFqns cannot be empty"}if(port.schemaResolution?.variants.length===0){return"schemaResolution requires variants"}return};var firstDuplicate=(values)=>values.find((value,index)=>values.indexOf(value)!==index);var workflowEditorViolation=(editor)=>{const sections=editor.form?.sections??[];const duplicateSection=firstDuplicate(sections.flatMap((section)=>section.id===undefined?[]:[section.id]));if(duplicateSection!==undefined){return`workflow editor section id '${duplicateSection}' is not unique`}const fields=sections.flatMap((section)=>section.fields??[]);const keys=fields.map((field)=>workflowBindingKey(field.binding));const duplicateField=fields.find((field,index)=>keys.indexOf(workflowBindingKey(field.binding))!==index);if(duplicateField!==undefined){return`workflow editor binding ${renderWorkflowBinding(duplicateField.binding)} is not unique`}for(const field of fields){const references=[...(field.visibleWhen??[]).map((rule)=>rule.binding),...field.optionSource?.kind==="remote"?field.optionSource.dependsOn:[]];const dangling=references.find((reference)=>!keys.includes(workflowBindingKey(reference)));if(dangling!==undefined){return`workflow editor field ${renderWorkflowBinding(field.binding)} references unknown binding ${renderWorkflowBinding(dangling)}`}}return};var dynamicPort=object({configPath:string,defaultIdPath:optString,idPath:string,requiredPath:optString,schemaPath:optString});var fieldBinding=object({path:pathParts,target:literal("input_binding","parameter")});var nonNegativeInteger=(value,path)=>{const parsed=number(value,path);return Number.isSafeInteger(parsed)&&parsed>=0?parsed:invalid(path)};var optionSource=union(object({kind:literal("static"),options:array(object({label:localized,value:json}))}),object({clearOnDependencyChange:boolean,dependsOn:array(fieldBinding),kind:literal("remote"),operationId:string,searchable:boolean}));var editorField=object({binding:fieldBinding,fieldConfig:optional(jsonObject),fieldFqn:optString,fieldVersion:optString,help:optional(localized),label:optional(localized),optionSource:optional(optionSource),order:optNumber,placeholder:optional(localized),readOnly:optBoolean,required:optBoolean,resolutionPhase:literal("runtime","structural"),sensitive:optBoolean,valueSources:array(literal("expression","fixed","literal","mapping","model","system")),visibleWhen:optional(array(object({binding:fieldBinding,operator:literal("equals","in","is_not_set","is_set","not_equals"),value:optional(json)}))),widget:optional(literal(...WorkflowEditorWidgets))});var templateKind=literal(...WorkflowTemplateKinds);var nodePort=refine(object({allowedTemplateFqns:optStrings,allowedTemplateKinds:optional(array(templateKind)),direction:literal("input","output"),key:string,maxConnections:optional(nullable(nonNegativeInteger)),minConnections:optional(nonNegativeInteger),schemaResolution:optional(object({configPath:pathParts,variants:array(object({schema,schemaInjections:optional(array(object({configPath:pathParts,schemaPath:pathParts}))),when:json}))})),valueSchema:schema}),workflowPortPolicyViolation);var eventSelectorProjection=union(object({required:optBoolean,sourcePath:pathParts,targetPath:pathParts}),object({targetPath:pathParts,value:json}));var eventIngress=object({acquisitionMode:string,callbackPathPath:optional(pathParts),connectionIdPath:optional(pathParts),eventKind:string,listener:object({fqn:string,version:string}),requiredConfigPaths:optional(array(pathParts)),requiredListener:optBoolean,selector:array(eventSelectorProjection)});var triggerActivation=union(object({eventIngress,kind:literal("event")}),union(object({invocationRole:optional(literal("application","user")),kind:literal("manual"),lifecycleAdapterId:optString,triggerRefPath:optional(pathParts)}),object({kind:literal("schedule")})));var parseWorkflowReusableDependency=(value)=>object({inputContractPath:pathParts,modePath:optional(pathParts),targetWorkflowFqnPath:optional(pathParts),targetWorkflowIdPath:pathParts})(value,"/reusableDependency");var nodeContract=object({capabilityComposition:optional(object({capability:string,fragments:strings,selector:object({path:pathParts,target:literal("parameter")})})),configSchema:optional(schema),connectionRequirements:optional(array(object({cardinality:literal("many","one"),connectionTemplateFqns:refine(strings,(fqns)=>fqns.length===0?"connectionTemplateFqns cannot be empty":undefined),key:string,required:boolean,selector:object({path:pathParts,target:literal("parameter")})}))),dynamicPorts:optional(object({input:optional(dynamicPort),output:optional(dynamicPort)})),editor:optional(refine(object({form:optional(object({sections:optional(array(object({fields:optional(array(editorField)),id:optString,order:optNumber,title:optString})))}))}),workflowEditorViolation)),execution:optional(object({itemModes:optional(array(literal("all_items","each_item","single"))),mainOutputPort:optString,repeatable:optBoolean,resumable:optBoolean,sample:optional(json),sideEffect:literal("external","none","read","write"),testable:optBoolean})),implementationId:string,inputSchema:optional(schema),instancePolicy:optional(object({maxInstances:optNumber,minInstances:optNumber,onWorkflowCreate:optBoolean})),nodeCollectionFqn:optString,nodeCollectionVersion:optString,outputChannels:optional(array(object({adapterId:string,cardinality:literal("many","one"),deliveryMode:literal("asynchronous","synchronous"),key:string,required:boolean,valueSchema:schema}))),outputSchema:optional(schema),ports:optional(array(nodePort)),reusableDependency:optional(parseWorkflowReusableDependency),triggerActivation:optional(triggerActivation)});var fieldContract=object({availableForInput:optBoolean,availableForOutput:optBoolean,clearOnDependencyChange:optBoolean,optionDependencies:optional(array(object({path:pathParts,target:literal("parameter","part","value")}))),user:optional(object({multiple:boolean})),valueSchema:optional(schema)});var graphSchema=object({bindings:optional(array(object({extensions:jsonObject}))),fieldProjections:array(object({source:pathParts,target:pathParts})),schema});var graphBoundary=object({templateFqn:string,templateVersion:string});var graph=object({edges:array(object({extensions:optional(jsonObject),id:string,source:string,target:string})),inputBoundary:graphBoundary,inputContract:graphSchema,metadata:object({description:nullable(string),tags:strings,templateSource:nullable(string)}),nodes:array(object({extensions:optional(jsonObject),id:string,templateFqn:string,templateVersion:string})),outputBoundary:graphBoundary,outputContract:graphSchema,triggers:array(object({config:object({extensions:optional(jsonObject)}),id:string,inputBindings:record(string),invocation:object({mode:literal("attach","detach"),timeoutMs:nullable(number)}),metadata:object({fieldDisplayValues:record(string)}),settings:object({enabled:boolean}),templateFqn:string,templateVersion:string})),version:literal(1)});var uiLayout=object({edges:record(object({extensions:optional(jsonObject)})),nodes:record(object({position:optional(object({x:number,y:number}))})),version:literal(1),viewport:nullable(object({x:number,y:number,zoom:number}))});var bindingSpan=object({end:number,start:number});var bindingSource=object({kind:literal("input","loop_index","loop_item","merge_output","node_output","port_arrival","run","scope","trigger"),mergeId:optional(nullable(string)),nodeId:optional(nullable(string)),portId:optional(nullable(string)),selection:optional(nullable(object({ancestry:literal("nearest_dominating_ancestor"),iteration:literal("aggregate","previous_iteration","same_iteration")})))});var bindingExpression=(value,path)=>{const{kind}=object({kind:string})(value,path);switch(kind){case"array":{return object({items:array(bindingExpression),kind:literal("array")})(value,path)}case"call":{return object({args:array(bindingExpression),kind:literal("call"),name:string})(value,path)}case"interpolation":{return object({kind:literal("interpolation"),parts:array(bindingExpression),span:optional(nullable(bindingSpan))})(value,path)}case"literal":{return object({kind:literal("literal"),value:json})(value,path)}case"object":{return object({fields:record(bindingExpression),kind:literal("object")})(value,path)}case"operator":{return object({args:array(bindingExpression),kind:literal("operator"),op:string})(value,path)}case"ref":{return object({kind:literal("ref"),onUnavailable:object({kind:literal("error","fallback","null"),value:optional(nullable(bindingExpression))}),path:pathParts,source:bindingSource,span:optional(nullable(bindingSpan))})(value,path)}default:{return invalid(`${path}/kind`)}}};var authoredValue=union(object({mode:literal("fixed"),value:json}),object({compiled:optional(nullable(bindingExpression)),languageVersion:literal(1),mode:literal("expression"),source:string}));var nodeExecutionSettings=object({dryRun:optional(object({mode:literal("allow","block_side_effects")})),idempotencyKey:optional(nullable(bindingExpression)),onError:optional(object({mode:literal("continue","fail_run")})),retry:optional(object({backoffMs:optional(nullable(number)),maxAttempts:optional(nullable(number)),mode:literal("disabled","exponential","fixed")})),timeoutMs:optional(nullable(number))});var authoringTemplateRef=object({templateFqn:string,templateVersion:string});var authoringFieldProjection=object({fieldConfig:optional(jsonObject),fieldFqn:string,fieldVersion:string,path:strings});var authoringInputContract=object({fieldProjections:optional(array(authoringFieldProjection)),jsonSchema:jsonObject});var authoringOutputContract=object({bindings:array(object({key:string,kind:literal("artifact","value"),value:bindingExpression})),fieldProjections:optional(array(authoringFieldProjection)),jsonSchema:jsonObject});var inputEndpoint=object({kind:literal("input_node"),portId:string});var actionEndpoint=object({kind:literal("action_node"),nodeId:string,portId:string});var triggerEndpoint=object({kind:literal("trigger_node"),portId:string,triggerId:string});var outputEndpoint=object({kind:literal("output_node"),portId:string});var authoringDefinition=object({dataAccess:readDataAccess("workflow"),edges:array(object({id:string,source:union(union(actionEndpoint,inputEndpoint),triggerEndpoint),target:union(union(actionEndpoint,inputEndpoint),outputEndpoint)})),inputBoundary:authoringTemplateRef,inputContract:authoringInputContract,metadata:jsonObject,nodes:array(object({config:record(authoredValue),extensions:optional(jsonObject),id:string,inputs:record(authoredValue),metadata:jsonObject,settings:nodeExecutionSettings,templateFqn:string,templateVersion:string,uid:optString})),outputBoundary:authoringTemplateRef,outputContract:authoringOutputContract,triggers:array(object({config:jsonObject,id:string,inputBindings:record(object({overridePolicy:literal("caller_may_override","locked"),value:authoredValue})),invocation:object({mode:literal("attach","await_result","detach"),timeoutMs:optional(nullable(number))}),metadata:studioTriggerMetadata(jsonObject),settings:jsonObject,templateFqn:string,templateVersion:string})),version:literal(1)});var onlyKeys2=(...keys)=>(value)=>Object.keys(value).some((key)=>!keys.includes(key))?"unexpected member":undefined;var remoteDeletion=union(refine(object({capability:literal("full")}),onlyKeys2("capability")),refine(object({capability:literal("full_and_delta"),feed:literal("server_filtered","client_filtered")}),onlyKeys2("capability","feed")));var usesBindings=refine(array(union(identity,refine(object({approval:optional(union(literal("always","never"),object({rule:identity}))),description:optional(identity),fqn:identity,name:optional(identity),settings:optional(jsonObject)}),onlyKeys2(...usesBindingKeys)))),(bindings)=>duplicateUsesBinding(bindings)===undefined?undefined:"duplicate binding");var bindingSettingsForm=(value,path)=>{const read=form(value,path);assertNoHostKeys(read,`Invalid package manifest at ${path}/schema/document`);return read};var withoutRetiredRelationFields=(read)=>(value,path)=>{const declaration=read(value,path);if("relationFields"in declaration){throw new TypeError(`Invalid package manifest at ${path}/relationFields: relationFields is no longer supported; rebuild the package with the current extensions SDK, which declares Entity Relation Fields in fieldSemantics`)}return declaration};var withoutRetiredAgentFields=(agent)=>["invokingApplicationFqns","modelPreset"].find((field)=>(field in agent));var webhookHandshake=union(object({kind:literal("echo_query_parameter"),parameter:identity}),union(object({kind:literal("echo_query_parameter_with_verify_token"),parameter:identity,tokenParameter:identity}),object({field:identity,kind:literal("echo_json_body_field"),when:object({equals:string,field:identity})})));var localMethod=varyingObject({domains:optional(varyingStrings),enabled:boolean});var media=varyingObject({media:string});var organizationSettingsSso=object({...varyingFields({connection:varyingObject({setupKey:identity}),defaultProfile:optional(identity),domains:varyingStrings,enabled:boolean,provisionMembers:boolean}),provider:union(object({fqn:identity}),varyingObject({providerId:identity}))});var organizationInstructions=object(varyingFields({...base,answerLength:optString,bannedQuestions:optString,enabled:optBoolean,kind:literal("organizationInstructions"),lifecycle,otherInstructions:optString,toneOfVoice:optString}));var organizationSettings=object({...varyingFields({...base,branding:optional(varyingObject({cover:optional(media),icon:optional(media),logo:optional(media)})),governance:optional(varyingObject({accessAuditRetentionMonths:optional(positiveSafeInteger),maxGroupHierarchyDepth:optional(positiveSafeInteger)})),identity:optional(varyingObject({companyDomains:optional(varyingStrings),name:optString})),kind:literal("organizationSettings"),lifecycle,locale:optional(varyingObject({defaultLanguage:optString,languages:optional(varyingStrings),timezone:optString}))}),authentication:varyingStructure(optional(object({...varyingFields({applicationConsent:optional(literal("ask","skip")),otp:optional(localMethod),password:optional(localMethod)}),sso:varyingStructure(optional(array(varyingStructure(organizationSettingsSso))))})))});var documentFolder=union(refine(varyingObject({drive:identity,folders:varyingArray(identity)}),onlyKeys2("drive","folders")),refine(varyingObject({remoteId:identity}),onlyKeys2("remoteId")));var documentCollection=(value,path)=>{const declaration=varyingObject({...base,connection:connection2,connectorFqn:optional(identity),excludedFolderNames:optional(varyingStrings),indexContent:optBoolean,indexOverview:optBoolean,kind:literal("documentCollection"),overviewInputMaxChars,remoteRoots:varyingArray(documentFolder),richEnrichment,syncEnabled:optBoolean,title:identity})(value,path);return declaration};var subgroups=(value,path)=>optional(array(object({description:optString,displayName:string,key:string,subgroups})))(value,path);var agentContent={activity:optional(object({heartbeat:boolean,schedule:boolean})),audience:optional(readAccessAudience),behavioralBoundaries:strings,bypassOrganizationInstructions:optional(boolean),dataAccess:readDataAccess("agent"),maxSteps:optional(positiveSafeInteger),metadata:optional(studioAgentMetadata(jsonObject)),modelTier:optional(literal(...agentModelTiers)),objectives:strings,operatingInstructions:string,output:optional(object({schema})),responsibility:string,uses:object({skills:usesBindings,tools:usesBindings})};var skillContent={audience:optional(readAccessAudience),dataAccess:readDataAccess("skill"),instructions:string,uses:object({tools:usesBindings})};var nonNegativeInteger2=refine(number,(value)=>Number.isSafeInteger(value)&&value>=0?undefined:"not a non-negative integer");var nonNegativeNumber=refine(number,(value)=>value>=0?undefined:"negative");var recordOf=(keys,read)=>refine(record(read),onlyKeys2(...keys));var runIdentity=union(refine(object({mode:literal("triggering_user")}),onlyKeys2("mode")),refine(object({mode:literal("service_principal"),servicePrincipal:identity}),onlyKeys2("mode","servicePrincipal")));var workflowContent={audience:optional(readAccessAudience),dataAccess:readDataAccess("workflow"),definition:authoringDefinition,name:string,runDetailsRetention:optional(literal("full","outcome_only")),runIdentity:optional(runIdentity),slug:string,uses:optional(object({connections:refine(array(union(identity,object({fqn:identity,scope:optional(literal("user"))}))),(connections)=>duplicateUsesConnection(connections)===undefined?undefined:"duplicate connection")}))};var primitives={...accessPrimitives,agent:withoutKeys(["skills","tools"],refine(object({...base,...agentContent,kind:literal("agent"),lifecycle}),withoutRetiredAgentFields)),automationLimits:refine(object({...base,budgetProfile:optional(identity),kind:literal("automationLimits"),lifecycle,maxActiveTriggers:optional(nonNegativeInteger2),maxPersonalItems:optional(recordOf(definitionKinds,nonNegativeInteger2))}),automationFqnViolation("automationLimits")),connection,connectionInstance:substituted(varyingObject({...base,audience:optional(readAccessAudience),credentials:jsonObject,kind:literal("connectionInstance"),lifecycle,templateFqn:identity})),datasetBlueprint,datasetConnectorInstance,datasetParser:object({...base,extensions:array(identity),format:datasetParserFormat,kind:literal("datasetParser"),mediaTypes:array(identity),parserVersion:datasetParserVersion}),datasetTableTemplate,documentCollection,documentsConnector:object({...base,connectionRefs,kind:literal("documentsConnector"),providerDisplayName:optional(identity),providerFamily:identity}),domain:object({...base,kind:literal("domain"),lifecycle,localMutationPolicy:optional(mutationPolicy),versioningEnabled:nullable(boolean)}),domainTemplate:withoutRetiredRelationKey(object({...base,catalogTags,domainFqn:string,domainName:string,entitySchemaFqns:strings,kind:literal("domainTemplate")}),"relationSchemaFqns"),emailProvider:object({...base,connectionTemplateFqn:identity,deploymentIdentity:optional(union(literal("aws"),literal("azure"))),kind:literal("emailProvider"),senderKind:literal("address","mailbox")}),eventListener:object({...base,capabilities:array(literal("internal","poll","webhook")),eventKind:string,kind:literal("eventListener"),manualWebhookState:optional(object({keyFamily:identity,stateKey:identity})),messaging:optional(object({connectionTemplateFqn:identity,contractVersion:literal(1),service:identity})),receiveModeField:optional(identity),runtimeState:optional(array(object({keyFamily:string,stateKey:string}))),safeOccurrenceFields:optStrings,safeSelectorFields:optStrings,sourceScope:optional(literal("connection","selector")),webhookAcknowledgement:optional(object({status:literal(200,204)})),webhookHandshake:optional(webhookHandshake),webhookRegistration:optional(literal("listener"))}),externalAppGateway:readExternalAppGateway,externalApplication:substituted(withoutKeys(["audience"],refine(object({...varyingFields({...base,allowedOrigins:varyingStrings,applicationConsent:optional(literal(...externalApplicationConsents)),applicationType:literal("confidential","public"),kind:literal("externalApplication"),lifecycle,oauthAudience:string,postLogoutRedirectUris:varyingStrings,primaryRedirectUri:optString,redirectUris:varyingStrings,setupInstructions:optString}),capabilities:optional(applicationCapabilityNodes)}),externalApplicationViolation))),externalDatasetProvider:object({...base,capabilities:datasetCapabilities,connectionTemplateFqns:strings,kind:literal("externalDatasetProvider"),sourceCapabilities:optional(array(object({capabilities:datasetCapabilities,datasetOpaqueIdPrefix:string})))}),fieldTransformer:object({...base,kind:literal("fieldTransformer"),sourceFieldType:string,targetFieldType:string}),knowledgeConnector:withoutRetiredRelationKey(object({...base,autoActivate:optBoolean,autoInstantiate:optBoolean,bindingScopes:optional(bindingScopes),connectionRefs,contributions:optional(array(object({capabilityFqn:string,connectionSlot:string,connectionTemplateFqn:string,controlFqn:optString,displayName:string,fqn:identity,metadata:optional(jsonObject)}))),defaultOutboundStrategy:optional(outboundStrategy),defaultUpdateMode:optional(updateMode),deltaOverlapSeconds:optional(positiveSafeInteger),discoveryDefaults:optional(discoveryDefaults),entityIdentityMode:optional(literal("adapter","item_metadata")),entitySchemaCapabilities:optional(array(entityCapability)),isSingleton:optBoolean,kind:literal("knowledgeConnector"),outboundCapability:optional(literal("declared_and_enablable","none")),pullPageSize:optional(positiveSafeInteger),recommendedImportSchedules:predefinedSchedules,remoteDeletion:optional(remoteDeletion),remoteReference:optional(object({providerKey:identity,urlTemplate:knowledgeRemoteReferenceUrlTemplate})),settings:optional(form),supportedBindingModes:optional(bindingModes)}),"relationSchemaCapabilities"),knowledgeConnectorInstance,knowledgeConnectorOauth:object({...base,connectorFqn:string,kind:literal("knowledgeConnectorOauth")}),knowledgeEntityAdapter:object({...base,connectorFqn:string,entitySchemaFqn:string,kind:literal("knowledgeEntityAdapter"),normalizesFieldMapValues:optBoolean,normalizesImportedData:optBoolean}),knowledgeEntitySchema:withoutRetiredRelationFields(object({...base,...knowledgeSchema,autocompleteConfiguration,defaultSyncDirection:optString,deletionMode:optString,displayDefaults:optional(object({collections:optStrings,details:optStrings})),displayNameExpression:nullable(string),embedEntities:optBoolean,embeddingConfig:nullable(jsonObject),extendsSchemaFqn:optString,kind:literal("knowledgeEntitySchema"),lifecycle,maxVersionsExpirationDays:optional(nullable(number)),overviewInputMaxChars,persistFullFieldContributions:boolean,richEnrichment,syncable:optBoolean,usableAsDocumentScope:boolean,versioned:optBoolean,versioningEnabled:nullable(boolean)})),managedDatasetProvider:object({...base,capabilities:datasetCapabilities,connectionTemplateFqns:strings,kind:literal("managedDatasetProvider")}),notificationChannel:object({...base,credential:optional(form),definition:notificationDefinition,kind:literal("notificationChannel")}),organizationGroup:refine(object({...base,kind:literal("organizationGroup"),lifecycle,parent:optional(identity),subgroups}),organizationGroupViolation),organizationInstructions:substituted(refine(organizationInstructions,organizationInstructionsViolation)),organizationSettings:substituted(refine(organizationSettings,organizationSettingsViolation)),organizationSso:object({...base,connectionTemplateFqn:string,kind:literal("organizationSso"),providerId:string,requiredCredentialFields:strings,secretCredentialFields:optStrings,setupGuide:optional(array(object({locale:string,markdown:string})))}),outboundMessagingProvider:object({...base,connectionTemplateFqn:identity,kind:literal("outboundMessagingProvider"),service:identity}),packageSource:refine(object({...base,deployMode:literal(...packageSourceDeployModes),kind:literal("packageSource"),lifecycle,packageFqn:identity,path:identity,repositoryLink:identity,scope:literal(...automationTypes)}),automationFqnViolation("packageSource")),placementRule:refine(object({...base,automationKind:literal(...definitionKinds),folderPattern:optional(identity),kind:literal("placementRule"),lifecycle,order:nonNegativeInteger2,packageSource:identity,scope:literal(...automationTypes)}),automationFqnViolation("placementRule")),remoteToolCollection:refine(object({...base,category:optString,gatewayRef:identity,kind:literal("remoteToolCollection"),operationReferences:strings}),remoteToolCollectionViolation),repositoryLink:refine(object({...base,connection:identity,defaultBranch:identity,kind:literal("repositoryLink"),lifecycle,provider:identity,repository:identity}),automationFqnViolation("repositoryLink")),reviewPolicy:refine(object({...base,approvalRule:optional(identity),kind:literal("reviewPolicy"),lifecycle,thresholds:optional(recordOf(reviewKpis,nonNegativeNumber))}),automationFqnViolation("reviewPolicy")),servicePrincipal:object({...base,audience:optional(readAccessAudience),groups:array(identity),kind:literal("servicePrincipal")}),skill:withoutKeys(["tools"],object({...base,...skillContent,kind:literal("skill"),lifecycle})),skillTemplate:object({...base,catalogTags,kind:literal("skillTemplate"),lifecycle:optional(lifecycle),name:string}),studioApp:studioAppDeclaration,studioAppTemplate:object({...base,definition:studioAppTemplate,kind:literal("studioAppTemplate")}),studioComponent:object({...base,category:literal("layout","page","primitive","view","widget"),composition:optional(object({extensions:optional(jsonObject),slotSource:literal("props","static"),slots:array(object({extensions:optional(jsonObject),key:string,label:optional(localized)}))})),kind:literal("studioComponent"),propsSchema:schema,sourceRef:string}),tool:object({...base,allowMultipleSkillBindings:optBoolean,audience:optional(readAccessAudience),autoActivate:optBoolean,autoInstantiate:optBoolean,bindingScopes:optional(bindingScopes),bindingSettings:optional(bindingSettingsForm),capabilityType:optional(literal("delegate","external","read","write")),category:optString,connectionRefs,effectKind:literal("mutation","read_only"),extraLoaders:optional(array(object({bindingName:string,inheritBindingSettings:optBoolean,toolFqn:string}))),healthCheck:optional(object({capabilities:optStrings,description:string})),input:schema,isSingleton:optBoolean,kind:literal("tool"),output:schema,sample:optional(json),settings:optional(form),setupInstructions:optional(object({links:strings,markdown:string})),toolCollectionFqns:optStrings,toolGuidance:optional(object({inputRequirementsSummary:optString,useWhen:optString})),usageScopes:optional(array(literal("automation","chat","skill")))}),toolCollection:withoutKeys(["audience"],object({...base,category:optString,kind:literal("toolCollection"),toolFqns:strings})),toolSettingsOptions:object({...base,catalogCollection:optString,catalogConnectionSlots:optStrings,connectionSlots:optStrings,dependencies:optStrings,fieldKey:string,formTarget:optional(literal("binding","settings")),includeUnavailableSelectedOptions:optBoolean,kind:literal("toolSettingsOptions"),toolFqn:string}),workflow:withoutKeys(["servicePrincipalFqn"],refine(object({...base,...workflowContent,kind:literal("workflow"),lifecycle}),(workflow)=>{workflowDataAccess(workflow.dataAccess,workflow.definition.dataAccess,`workflow:${workflow.fqn}`)})),workflowField:object({...base,collectionFqn:string,collectionVersion:string,contract:fieldContract,kind:literal("workflowField"),presentation:optional(object({placeholder:optString,widget:optString}))}),workflowFieldCollection:object({...base,contract:object({weight:number}),kind:literal("workflowFieldCollection"),presentation:optional(object({categoryPath:strings,label:localized}))}),workflowNode:object({...base,audience:optional(readAccessAudience),contract:nodeContract,kind:literal("workflowNode"),nodeKind:literal("action","input","output","trigger"),presentation:optional(object({categoryPath:optStrings,tags:optStrings}))}),workflowNodeCollection:object({...base,audience:optional(readAccessAudience),contract:object({collection:optional(object({parentFqn:string,parentVersion:string,weight:number}))}),kind:literal("workflowNodeCollection"),presentation:optional(object({categoryPath:strings}))}),workflowTemplate:object({...base,catalogTags,category:string,definition:graph,kind:literal("workflowTemplate"),lifecycle,name:string,requiredSkills:strings,requiredTools:strings,skillSlots:strings,slug:string,uiLayout:nullable(uiLayout)})};var retiredRelationKinds=new Set(["knowledgeRelationAdapter","knowledgeRelationSchema"]);var renamedKeys=new Map([["accessProfile",[["audience","appliesTo"]]],["agent",[["skills","uses.skills"],["tools","uses.tools"]]],["externalApplication",[["audience","oauthAudience"]]],["skill",[["tools","uses.tools"]]],["workflow",[["servicePrincipalFqn","runIdentity"]]]]);var repeatedIds=(ids,path,label)=>ids.flatMap((id,index)=>ids.indexOf(id)===index?[]:[{message:`${label} '${id}' is declared more than once`,path:path(index)}]);var workflowGraphIssues=(graph,path)=>{const nodeIds=new Set(graph.nodes.map(({id})=>id));const triggerIds=new Set(graph.triggers.map(({id})=>id));const missing=(endpoint,pointer)=>{if(endpoint.kind==="action_node"&&!nodeIds.has(endpoint.nodeId)){return[{message:`edge ends at node '${endpoint.nodeId}', which the graph does not declare`,path:`${pointer}/nodeId`}]}if(endpoint.kind==="trigger_node"&&!triggerIds.has(endpoint.triggerId)){return[{message:`edge starts at trigger '${endpoint.triggerId}', which the graph does not declare`,path:`${pointer}/triggerId`}]}return[]};return[...repeatedIds(graph.nodes.map(({id})=>id),(index)=>`${path}/nodes/${index}/id`,"node"),...repeatedIds(graph.triggers.map(({id})=>id),(index)=>`${path}/triggers/${index}/id`,"trigger"),...repeatedIds(graph.edges.map(({id})=>id),(index)=>`${path}/edges/${index}/id`,"edge"),...graph.edges.flatMap((edge,index)=>[...missing(edge.source,`${path}/edges/${index}/source`),...missing(edge.target,`${path}/edges/${index}/target`)])]};var readerPath=/^Invalid package manifest at (?<path>\S*?)(?:: (?<detail>.*))?$/su;var locationPath=/^(?<path>\/\S*?): (?<detail>.*)$/su;var issueOf=(error)=>{const groups=(readerPath.exec(error.message)??locationPath.exec(error.message))?.groups;return{message:groups?.detail??(groups===undefined?error.message:"is not a valid value"),path:groups?.path??""}};var validator=(check)=>(definition)=>{try{assertDenseArrays(definition,"",new WeakSet);const portable=check.read(parseJsonObject(canonicalJson(definition)),"");const[first,...rest]=check.issues(portable);return first===undefined?{definition:portable,valid:true}:{issues:[first,...rest],valid:false}}catch(error){if(!(error instanceof TypeError)){throw error}return{issues:[issueOf(error)],valid:false}}};var validators={agent:validator({issues:()=>[],read:object({...agentContent,lifecycle:optional(lifecycle)})}),skill:validator({issues:()=>[],read:object({...skillContent,lifecycle:optional(lifecycle)})}),workflow:validator({issues:(workflow)=>{workflowDataAccess(workflow.dataAccess,workflow.definition.dataAccess,"workflow definition");return workflowGraphIssues(workflow.definition,"/definition")},read:object({...workflowContent,lifecycle:optional(lifecycle)})})};var validateDefinition=(kind,definition)=>validators[kind](definition);var automationDocumentFileNames=["agent.json","automation.json","instructions.md","SKILL.md","skill.json","workflow.json"];var defaultLifecycle={deployMode:"upsert",readonly:true};var fqnSegments={agent:"agents",skill:"skills",workflow:"workflows"};var slugPattern=/^[a-z0-9]+(?:-[a-z0-9]+)*$/u;var readEnvelope=object({kind:literal(...definitionKinds),slug:refine(string,(slug)=>slugPattern.test(slug)?undefined:"slug is not kebab-case"),title:identity});var fail=(folder,message)=>{throw new TypeError(`${folder}: ${message}`)};var isFileName=(name)=>automationDocumentFileNames.some((known)=>known===name);var foldersOf=(files)=>{const folders=new Map;for(const[path,text]of Object.entries(files)){const[folder,name,...deeper]=path.split("/");if(folder!==undefined&&name!==undefined&&deeper.length===0&&isFileName(name)){folders.set(folder,{...folders.get(folder),[name]:text})}}return folders};var textOf=(folder,files,name)=>files[name]??fail(folder,`${name} is missing`);var jsonObjectOf=(folder,name,text)=>{if(text===undefined){return{}}try{return parseJsonObject(text)}catch{return fail(folder,`${name} is not a JSON object`)}};var withText=(folder,structured,structuredName,text)=>(text.field in structured)?fail(folder,`${structuredName} and ${text.file} both hold ${text.field}; keep it in ${text.file}`):{...structured,[text.field]:text.value};var definitionOf=(folder,files,{kind,slug,title})=>{switch(kind){case"agent":{return withText(folder,jsonObjectOf(folder,"agent.json",textOf(folder,files,"agent.json")),"agent.json",{field:"operatingInstructions",file:"instructions.md",value:textOf(folder,files,"instructions.md")})}case"skill":{return{uses:{tools:[]},...withText(folder,jsonObjectOf(folder,"skill.json",files["skill.json"]),"skill.json",{field:"instructions",file:"SKILL.md",value:textOf(folder,files,"SKILL.md")})}}case"workflow":{return{name:title,slug,...jsonObjectOf(folder,"workflow.json",textOf(folder,files,"workflow.json"))}}default:{const exhaustive=kind;return exhaustive}}};var envelopeOf=(folder,files)=>{const automation=jsonObjectOf(folder,"automation.json",textOf(folder,files,"automation.json"));try{return readEnvelope(automation,"")}catch(error){if(error instanceof TypeError){return fail(folder,`automation.json ${issueOf(error).path}`)}throw error}};var componentOf=(folder,files,options)=>{const envelope=envelopeOf(folder,files);const checked=validateDefinition(envelope.kind,definitionOf(folder,files,envelope));if(!checked.valid){return fail(folder,checked.issues.map(({message,path})=>`${path||"(definition)"} ${message}`).join("; "))}return{manifest:primitives[envelope.kind]({lifecycle:options.lifecycle??defaultLifecycle,...checked.definition,displayName:envelope.title,fqn:`${options.packageFqn}.${fqnSegments[envelope.kind]}.${envelope.slug}`,kind:envelope.kind,version:options.version},folder),schemaSidecars:[]}};var automationDocumentComponents=(files,options)=>{for(const name of["packageFqn","version"]){if(options[name].trim()===""){throw new TypeError(`${name} must not be blank`)}}const owners=new Map;return[...foldersOf(files)].sort(([left],[right])=>compareUtf16CodeUnits(left,right)).map(([folder,folderFiles])=>{const component=componentOf(folder,folderFiles,options);const{fqn}=component.manifest;const owner=owners.get(fqn);if(owner!==undefined){return fail(folder,`'${fqn}' is declared more than once, also by ${owner}`)}owners.set(fqn,folder);return component})};var automationDocumentSchemaVersion=1;var documentFolder2="document";var documentMembers=(value)=>parseJsonObject(canonicalJson(value));var documentJson=(value)=>`${JSON.stringify(JSON.parse(canonicalJson(value)),null,2)}
|
|
1
|
+
import{existsSync,readdirSync,readFileSync}from"node:fs";import path from"node:path";import{fileURLToPath}from"node:url";var compareCodePoints=(left,right)=>{const leftPoints=Array.from(left,(character)=>character.codePointAt(0)??0);const rightPoints=Array.from(right,(character)=>character.codePointAt(0)??0);const length=Math.min(leftPoints.length,rightPoints.length);for(let index=0;index<length;index+=1){const difference=leftPoints[index]-rightPoints[index];if(difference!==0){return difference}}return leftPoints.length-rightPoints.length};var insertSortedKey=(keys,key)=>{let index=0;while(index<keys.length&&compareCodePoints(keys[index]??"",key)<=0){index+=1}keys.splice(index,0,key)};var isJsonObject=(value)=>Object.prototype.toString.call(value)==="[object Object]"&&!Array.isArray(value)&&(Object.getPrototypeOf(value)===Object.prototype||Object.getPrototypeOf(value)===null);var isJsonArray=(value)=>Array.isArray(value);var canonicalize=(value,ancestors,_valueType)=>{if(value===null){return"null"}if(isJsonArray(value)){if(ancestors.has(value)){throw new TypeError("package declarations cannot contain cyclic values")}ancestors.add(value);try{return`[${value.map((item)=>canonicalize(item,ancestors)).join(",")}]`}finally{ancestors.delete(value)}}if(isJsonObject(value)){if(ancestors.has(value)){throw new TypeError("package declarations cannot contain cyclic values")}ancestors.add(value);try{const record=value;const keys=[];for(const key of Object.keys(record)){insertSortedKey(keys,key)}return`{${keys.map((key)=>`${JSON.stringify(key)}:${canonicalize(record[key],ancestors)}`).join(",")}}`}finally{ancestors.delete(value)}}if(value instanceof Object){throw new TypeError("package declarations must contain JSON-compatible values")}switch(Object.prototype.toString.call(value)){case"[object Boolean]":{return value===true?"true":"false"}case"[object Number]":{const number=Number(value);if(!Number.isFinite(number)){throw new TypeError("package declarations cannot contain non-finite numbers")}return JSON.stringify(number)}case"[object String]":{return JSON.stringify(String(value))}default:{throw new TypeError("package declarations must contain JSON-compatible values")}}};var canonicalJson=(value,..._typeEvidence)=>canonicalize(value,new WeakSet);var parseJsonObject=(source)=>{const value=JSON.parse(source);if(!isJsonObject(value)){throw new TypeError("expected a JSON object")}return value};var roundConstants=[1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298];var initialState=[1779033703,3144134277,1013904242,2773480762,1359893119,2600822924,528734635,1541459225];var rotateRight=(value,bits)=>value>>>bits|value<<32-bits;var padded=(message)=>{const blocks=Math.ceil((message.length+9)/64);const bytes=new Uint8Array(blocks*64);bytes.set(message);bytes[message.length]=128;const view=new DataView(bytes.buffer);view.setUint32(bytes.length-8,Math.floor(message.length*8/2**32));view.setUint32(bytes.length-4,message.length*8>>>0);return bytes};var compress=(state,block)=>{const words=[];for(let index=0;index<16;index+=1){words[index]=block.getUint32(index*4)}for(let index=16;index<64;index+=1){const early=words[index-15]??0;const late=words[index-2]??0;const small0=rotateRight(early,7)^rotateRight(early,18)^early>>>3;const small1=rotateRight(late,17)^rotateRight(late,19)^late>>>10;words[index]=(words[index-16]??0)+small0+(words[index-7]??0)+small1>>>0}let[a=0,b=0,c=0,d=0,e=0,f=0,g=0,h=0]=state;for(let index=0;index<64;index+=1){const big1=rotateRight(e,6)^rotateRight(e,11)^rotateRight(e,25);const choice=e&f^~e&g;const first=h+big1+choice+(roundConstants[index]??0)+(words[index]??0)>>>0;const big0=rotateRight(a,2)^rotateRight(a,13)^rotateRight(a,22);const majority=a&b^a&c^b&c;const second=big0+majority>>>0;h=g;g=f;f=e;e=d+first>>>0;d=c;c=b;b=a;a=first+second>>>0}const next=[a,b,c,d,e,f,g,h];for(let index=0;index<8;index+=1){state[index]=(state[index]??0)+(next[index]??0)>>>0}};var sha256Hex=(text)=>{const bytes=padded(new TextEncoder().encode(text));const state=[...initialState];for(let offset=0;offset<bytes.length;offset+=64){compress(state,new DataView(bytes.buffer,offset,64))}return state.map((word)=>word.toString(16).padStart(8,"0")).join("")};var compareUtf16CodeUnits=(left,right)=>{const length=Math.min(left.length,right.length);for(let index=0;index<length;index+=1){const difference=left.charCodeAt(index)-right.charCodeAt(index);if(difference!==0){return difference}}return left.length-right.length};var deepFreeze=(value)=>{if(value!==null&&typeof value==="object"&&!Object.isFrozen(value)){Object.freeze(value);for(const child of Object.values(value)){deepFreeze(child)}}return value};var SchemaConsumerProfiles=Object.freeze({automationGraphInput:"workflow_value",automationGraphOutput:"workflow_value",connectionCredential:"interactive_form",connectorSettings:"interactive_form",form:"interactive_form",knowledgeEntity:"knowledge_record",notificationCredential:"interactive_form",studioComponentProps:"studio_props",toolInput:"ai_function_input",toolOutput:"runtime_json",toolSettings:"interactive_form",workflowConfiguration:"workflow_value",workflowFieldValue:"workflow_value",workflowInput:"workflow_value",workflowOutput:"workflow_value",workflowPortValue:"workflow_value"});var annotationKeywords=["$anchor","$comment","$id","$schema","$vocabulary","deprecated","description","examples","readOnly","title","writeOnly"];var structuralKeywords=["$defs","$ref","additionalProperties","const","enum","items","properties","required","type"];var boundKeywords=["exclusiveMaximum","exclusiveMinimum","maxItems","maxLength","maxProperties","maximum","minItems","minLength","minProperties","minimum","multipleOf","pattern","uniqueItems"];var UnrestrictedScopeKeyword="x-unrestricted-scope";var FqnOfKeyword="x-fqn-of";var FqnKind=Object.freeze({KnowledgeDomain:"knowledge-domain",KnowledgeEntitySchema:"knowledge-entity-schema"});var HostBindingSettingKeys=Object.freeze(["approvalMode","approvalRuleId"]);var baseProfileKeywords=[...annotationKeywords,...structuralKeywords,...boundKeywords];var ConsumerProfiles=deepFreeze({ai_function_input:{allowedFidelity:["exact","structural"],allowedKeywords:[...baseProfileKeywords,"anyOf"],id:"ai_function_input",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","oneOf","not","patternProperties","prefixItems","contains","dependentRequired","if","then","else","unevaluatedItems","unevaluatedProperties"]},interactive_form:{allowedFidelity:["exact"],allowedKeywords:[...baseProfileKeywords,"anyOf","default","format",FqnOfKeyword,UnrestrictedScopeKeyword],id:"interactive_form",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","oneOf","not","patternProperties","contains","dependentRequired","if","then","else","prefixItems","unevaluatedItems","unevaluatedProperties"]},knowledge_record:{allowedFidelity:["exact","structural"],allowedKeywords:[...baseProfileKeywords,"format"],id:"knowledge_record",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","anyOf","oneOf","not","patternProperties","prefixItems","contains","dependentRequired","if","then","else","unevaluatedItems","unevaluatedProperties"]},runtime_json:{allowedFidelity:["exact","structural"],allowedKeywords:null,id:"runtime_json",rootObject:false,unsupportedKeywords:["$dynamicRef","$dynamicAnchor"]},studio_props:{allowedFidelity:["exact"],allowedKeywords:[...baseProfileKeywords,"anyOf","default","format"],id:"studio_props",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","oneOf","not","patternProperties","contains","dependentRequired","if","then","else","prefixItems","unevaluatedItems","unevaluatedProperties"]},workflow_value:{allowedFidelity:["exact","structural"],allowedKeywords:[...baseProfileKeywords,"default","format","oneOf"],id:"workflow_value",rootObject:false,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","anyOf","not","unevaluatedItems","unevaluatedProperties"]}});var knownVocabularies=new Set(["https://json-schema.org/draft/2020-12/vocab/applicator","https://json-schema.org/draft/2020-12/vocab/content","https://json-schema.org/draft/2020-12/vocab/core","https://json-schema.org/draft/2020-12/vocab/format-annotation","https://json-schema.org/draft/2020-12/vocab/format-assertion","https://json-schema.org/draft/2020-12/vocab/meta-data","https://json-schema.org/draft/2020-12/vocab/unevaluated","https://json-schema.org/draft/2020-12/vocab/validation"]);var schemaArrayKeywords=new Set(["allOf","anyOf","oneOf","prefixItems"]);var schemaMapKeywords=new Set(["$defs","patternProperties","properties"]);var schemaValueKeywords=new Set(["additionalProperties","contains","else","if","items","not","then","unevaluatedItems","unevaluatedProperties"]);var fqnKinds=new Set(Object.values(FqnKind));var plainFormWidgets=["checkbox","color","date","date_range","datetime","email","file","hidden","number","password","structured_file_preview","switch","text","textarea","user_multi_select","user_select","variable_references"];var selectFormWidgets=["folders_explorer","multi_select","radio","select"];var isVariableReference=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value)&&Object.keys(value).length===1&&("$variable"in value)&&typeof value.$variable==="string";var invalid=(path)=>{throw new TypeError(`Invalid package manifest at ${path}`)};var string=(v,p)=>typeof v==="string"?v:invalid(p);var identity=(v,p)=>{const s=string(v,p);return s.trim()===""?invalid(p):s};var assertDenseArrays=(value,path,seen)=>{if(typeof value!=="object"||value===null||seen.has(value)){return}seen.add(value);if(Array.isArray(value)){for(let index=0;index<value.length;index+=1){if(!Object.hasOwn(value,index)){invalid(`${path}/${index}`)}}}for(const[key,child]of Object.entries(value)){assertDenseArrays(child,`${path}/${key}`,seen)}};var boolean=(v,p)=>typeof v==="boolean"?v:invalid(p);var number=(v,p)=>typeof v==="number"&&Number.isFinite(v)?v:invalid(p);var positiveSafeInteger=(value,path)=>{const parsed=number(value,path);return Number.isSafeInteger(parsed)&&parsed>0?parsed:invalid(path)};var optional=(read)=>(v,p)=>v===undefined?undefined:read(v,p);var nullable=(read)=>(v,p)=>v===null?null:read(v,p);var literal=(...values)=>(v,p)=>{for(const value of values){if(v===value){return value}}return invalid(p)};var array=(read)=>(v,p)=>{if(!Array.isArray(v)){return invalid(p)}return v.map((item,index)=>read(item,`${p}/${index}`))};var record=(read)=>(v,p)=>{if(typeof v!=="object"||v===null||Array.isArray(v)){return invalid(p)}return Object.fromEntries(Object.entries(v).map(([key,value])=>[key,read(value,`${p}/${key}`)]))};var object=(fields)=>(v,p)=>{if(typeof v!=="object"||v===null||Array.isArray(v)){return invalid(p)}const entries=Object.entries(v);for(const key in fields){if(!Object.hasOwn(fields,key)){continue}fields[key](entries.find(([name])=>name===key)?.[1],`${p}/${key}`)}return v};var varying=(read)=>(v,p)=>isVariableReference(v)?v:read(v,p);var varyingStructure=(read)=>(v,p)=>isVariableReference(v)?v:read(v,p);var varyingArray=(read)=>array(varying(read));var varyingStrings=varyingArray(string);var excludedKey=/^(?:fqn|kind|lifecycle|version)$|Fqn$/u;var varyingFields=(fields)=>{const wrapped=Object.fromEntries(Object.entries(fields).map(([key,read])=>[key,excludedKey.test(key)?read:varying(read)]));return wrapped};var varyingObject=(fields)=>object(varyingFields(fields));var substituted=(read)=>(v,p)=>read(v,p);var refine=(read,violation)=>(v,p)=>{const value=read(v,p);return violation(value)===undefined?value:invalid(p)};var onlyKeys=(...keys)=>(value)=>Object.keys(value).some((key)=>!keys.includes(key))?"unexpected member":undefined;var withoutKeys=(keys,read)=>(value,path)=>{const declaration=read(value,path);const key=keys.find((name)=>(name in declaration));return key===undefined?declaration:invalid(`${path}/${key}`)};var strings=array(string);var optString=optional(string);var optBoolean=optional(boolean);var optNumber=optional(number);var optStrings=optional(strings);var json=(v)=>parseJsonObject(canonicalJson({value:v})).value;var jsonObject=record(json);var base={description:optString,displayName:string,fqn:identity,icon:optString,tags:optStrings,version:string};var union=(left,right)=>(v,p)=>{try{return left(v,p)}catch(error){if(!(error instanceof TypeError)){throw error}return right(v,p)}};var schemaDocument=(v,p)=>{const doc=jsonObject(v,p);const schemaType=literal("array","boolean","integer","null","number","object","string");const fields={$anchor:optString,$comment:optString,$defs:optional(record(schemaDocument)),$dynamicAnchor:optString,$dynamicRef:optString,$id:optString,$ref:optString,$schema:optional(literal("https://json-schema.org/draft/2020-12/schema")),additionalProperties:optional(union(boolean,schemaDocument)),allOf:optional(array(schemaDocument)),anyOf:optional(array(schemaDocument)),const:optional(json),contains:optional(schemaDocument),default:optional(json),dependentRequired:optional(record(strings)),description:optString,else:optional(schemaDocument),enum:optional(array(json)),exclusiveMaximum:optNumber,exclusiveMinimum:optNumber,format:optString,if:optional(schemaDocument),items:optional(schemaDocument),maxItems:optNumber,maxLength:optNumber,maxProperties:optNumber,maximum:optNumber,minItems:optNumber,minLength:optNumber,minProperties:optNumber,minimum:optNumber,multipleOf:optNumber,not:optional(schemaDocument),oneOf:optional(array(schemaDocument)),pattern:optString,patternProperties:optional(record(schemaDocument)),prefixItems:optional(array(schemaDocument)),properties:optional(record(schemaDocument)),required:optStrings,then:optional(schemaDocument),title:optString,type:optional(union(schemaType,array(schemaType))),unevaluatedItems:optional(union(boolean,schemaDocument)),unevaluatedProperties:optional(union(boolean,schemaDocument)),uniqueItems:optBoolean};return object(fields)(doc,p)};var schema=object({dialect:literal("https://json-schema.org/draft/2020-12/schema"),document:schemaDocument,fidelity:literal("exact","structural")});var visibility=object({equals:optional(json),field:string,in:optional(array(json)),isNotSet:optBoolean,isSet:optBoolean,notEquals:optional(json),notIn:optional(array(json))});var visibilityRule=object({logic:optional(literal("and","or")),visibleWhen:union(visibility,array(visibility))});var validationRule=(v,p)=>{const{type}=object({type:string})(v,p);const messages={code:optString,message:optString};switch(type){case"min_length":case"max_length":case"min":case"max":{return object({...messages,type:literal(type),value:number})(v,p)}case"pattern":{return object({...messages,type:literal(type),value:string})(v,p)}case"required":{return object({...messages,type:literal("required")})(v,p)}default:{return object({...messages,type:literal("integer","json","non_empty_array")})(v,p)}}};var selectOption=object({label:optString,locked:optBoolean,value:string});var selectOptions=object({aiFill:optional(object({buttonLabel:optString,prompt:string,retryable:optBoolean})),allowClear:optBoolean,allowCustom:optBoolean,dataSource:optString,dependencies:optStrings,options:optional(array(union(string,selectOption))),preventSaveWhenEmpty:optBoolean,readonlyOnUpdate:optBoolean,searchable:optBoolean,selectionMetadataField:optString,submit:optBoolean});var fieldUiBase={"ui:disabled":optBoolean,"ui:help":optString,"ui:order":optNumber,"ui:placeholder":optString,"ui:readonly":optBoolean,"ui:suggestedName":optString,"ui:validation":optional(array(validationRule))};var absent=(v,p)=>v===undefined?undefined:invalid(p);var plainFieldUi=object({...fieldUiBase,"ui:options":absent,"ui:widget":literal(...plainFormWidgets)});var selectFieldUi=object({...fieldUiBase,"ui:options":optional(selectOptions),"ui:widget":optional(literal(...selectFormWidgets))});var structuredFileUploadFieldUi=object({...fieldUiBase,"ui:options":optional(object({formatField:optString})),"ui:widget":literal("structured_file_upload")});var structuredFileBrowserFieldUi=object({...fieldUiBase,"ui:options":object({contribution:object({componentFqn:string,connectionSlot:string}),formatField:optString,label:optString}),"ui:widget":literal("structured_file_browser")});var fieldUi=union(union(plainFieldUi,selectFieldUi),union(structuredFileUploadFieldUi,structuredFileBrowserFieldUi));var formItems=array(union(string,object({md:string})));var form=object({createSteps:optional(array(object({description:optional(nullable(string)),id:string,includeInBasicInfo:optional(nullable(boolean)),items:formItems,title:string,visibility:optional(nullable(visibilityRule))}))),layout:optional(literal("stacked","two_column")),schema,uiSchema:optional(record(fieldUi)),updateSections:optional(array(object({description:optional(nullable(string)),items:formItems,layout:optional(nullable(literal("stacked","two_column"))),title:optional(nullable(string))}))),visibility:optional(record(visibilityRule))});var isDeclaredCondition=(input)=>("manifest"in input);var isStructured=(value)=>Object(value)===value;var scansGrantAxis=(value)=>{if(!isStructured(value)){return false}if(Array.isArray(value)){return value.some(scansGrantAxis)}return"grantAxis"in value||Object.values(value).some(scansGrantAxis)};var readsGrantAxis=(input)=>scansGrantAxis(isDeclaredCondition(input)?input.manifest.where:input);var accessCapabilityNode=Symbol.for("@collective-intelligence/extensions-sdk/access-capability-node");var nodeKey=/^[a-z][a-zA-Z0-9]*$/u;var kinds=new Set(["readManage","switch"]);var capabilityNodeDeclarations=(nodes,parentKind,location,reserved=new Set)=>Object.fromEntries(Object.entries(nodes).map(([key,node])=>{if(!nodeKey.test(key)||reserved.has(key)){throw new TypeError(`${location}: capability key '${key}' must match ${nodeKey.source} and must not be ${[...reserved].join(" or ")}`)}const kind=node.kind??parentKind;if(!kinds.has(kind)){throw new TypeError(`${location}.${key}: kind must be "switch" or "readManage"`)}const children=node.children===undefined?undefined:capabilityNodeDeclarations(node.children,kind,`${location}.${key}`);const declaration=children===undefined||Object.keys(children).length===0?{kind}:{children,kind};return[key,declaration]}));var capabilityTree=(identity,children={})=>{const handles={};for(const[key,child]of Object.entries(children)){handles[key]=capabilityTree({...identity,code:`${identity.code}.${key}`,kind:child.kind,path:[...identity.path,key]},child.children)}return Object.freeze({...handles,[accessCapabilityNode]:identity})};var identityOf=(capability,location)=>{const identity=capability[accessCapabilityNode];if(identity===undefined){throw new TypeError(`${location} takes a capability handle or a capability code: a profile never declares a capability inline`)}return identity};var capabilityLevel=(capability,mode,location)=>{if(mode!==undefined&&mode!=="read"&&mode!=="manage"){throw new TypeError(`${location}: mode must be "read" or "manage"`)}if(typeof capability==="string"){if(capability.trim()===""){throw new TypeError(`${location}: a capability code must not be empty`)}return Object.freeze({code:capability,mode:mode??"on"})}const{code,kind}=identityOf(capability,location);if(kind==="switch"){if(mode!==undefined){throw new TypeError(`${location}: the Switch '${code}' takes no mode; it is on when granted`)}return Object.freeze({code,mode:"on"})}if(mode===undefined){throw new TypeError(`${location}: the Read/Manage node '${code}' needs the mode "read" or "manage"`)}return Object.freeze({code,mode})};var capabilityCode=(capability)=>typeof capability==="string"?capability:identityOf(capability,"capability").code;var isHandle=(value)=>(accessCapabilityNode in value);var childHandles=(handle)=>Object.values(handle).filter((value)=>(accessCapabilityNode in value));var capabilityCatalogNodes=(source)=>{const nodes=[];const visit=(handle,parent)=>{const identity=handle[accessCapabilityNode];const node={area:identity.area,code:identity.code,grantable:identity.grantable,key:identity.path.at(-1)??identity.code,kind:identity.kind};nodes.push({...node,...identity.application===undefined?undefined:{application:identity.application},...identity.package===undefined?undefined:{package:identity.package},...parent===undefined?undefined:{parent}});for(const child of childHandles(handle)){visit(child,identity.code)}};for(const root of isHandle(source)?[source]:Object.values(source)){visit(root)}return nodes};var requires=(capability,...[mode])=>{const level=capabilityLevel(capability,mode,"requires");return Object.freeze({mode:level.mode,requires:level.code})};var defineCapabilityCatalog=(input)=>{const roots=Object.entries(input).map(([area,root])=>{const children=capabilityNodeDeclarations(root.children??{},root.kind,`coreCapabilities.${area}`);const coreArea=area;return[area,capabilityTree({area:coreArea,code:area,grantable:root.grantable!==false,kind:root.kind,path:[area]},children)]});return Object.freeze(Object.fromEntries(roots))};var coreCapabilities=defineCapabilityCatalog({dashboard:{kind:"switch",children:{home:{},ai:{children:{skills:{},reports:{},tools:{},agents:{},approvals:{},workflows:{},settings:{}}},knowledge:{children:{schemas:{},connectors:{},data:{},setup:{},settings:{}}},documents:{children:{collections:{},setup:{}}},datasets:{children:{explore:{},catalog:{},setup:{}}},apps:{children:{studio:{},external:{},mcp:{},setup:{}}},monitoring:{children:{activities:{},runHistory:{},feedbacks:{},mappings:{},notifications:{},events:{},usage:{},budgets:{}}},organization:{children:{accounts:{},identity:{},general:{},developers:{},notifications:{},extensions:{},transfer:{},onboarding:{}}}}},studio:{kind:"switch",children:{authoring:{kind:"readManage",children:{agents:{},skills:{},workflows:{},code:{}}},notifications:{},settings:{children:{memories:{},notifications:{},transcription:{},permissions:{}}}}},mcp:{kind:"switch"},admin:{kind:"readManage",children:{organization:{},users:{},groups:{},servicePrincipals:{},guests:{},profiles:{},grants:{},apiKeys:{},connections:{},packages:{},extensions:{children:{repositories:{}}},externalApps:{},studioApps:{},mcp:{},ai:{children:{unrestrictedBindings:{kind:"switch"},skills:{},tools:{},agents:{}}},unrestrictedRuns:{kind:"switch"},aiFeedback:{},aiMemories:{},aiUsage:{},knowledge:{},datasets:{},documents:{},workflows:{},automations:{children:{review:{}}},reports:{},notifications:{children:{channels:{},profiles:{}}},eventsHub:{},organizationTransfer:{children:{export:{kind:"switch"},import:{kind:"switch"},inspect:{kind:"switch"}}}}},platform:{kind:"switch",children:{conversations:{},agents:{},knowledge:{},workflows:{},datasets:{},notifications:{},attachments:{},benchmarks:{},messaging:{}}},data:{kind:"readManage",children:{knowledge:{},documents:{},datasets:{}}},tenant:{kind:"readManage",grantable:false,children:{organizations:{},users:{},infrastructure:{},secrets:{},aiModels:{},studioReleases:{},maintenance:{},settings:{},monitoring:{},eventsHubPii:{kind:"switch"},workflowsPii:{kind:"switch"},data:{}}}});var defineSectionRequirements=(catalog,build)=>Object.freeze(build(catalog).map(([section,requirement])=>Object.freeze({requirement,section:capabilityCode(section)})));var coreSectionRequirements=defineSectionRequirements(coreCapabilities,(c)=>[[c.dashboard.ai.skills,requires(c.admin.ai.skills,"read")],[c.dashboard.ai.tools,requires(c.admin.ai.tools,"read")],[c.dashboard.ai.agents,requires(c.admin.ai.agents,"read")],[c.dashboard.ai.approvals,requires(c.admin.ai,"read")],[c.dashboard.ai.settings,requires(c.admin.ai,"read")],[c.dashboard.ai.reports,requires(c.admin.reports,"read")],[c.dashboard.ai.workflows,requires(c.admin.workflows,"read")],[c.dashboard.knowledge,requires(c.admin.knowledge,"read")],[c.dashboard.documents,requires(c.admin.documents,"read")],[c.dashboard.datasets,requires(c.admin.datasets,"read")],[c.dashboard.apps.studio,requires(c.admin.studioApps,"read")],[c.dashboard.apps.external,requires(c.admin.externalApps,"read")],[c.dashboard.apps.mcp,requires(c.admin.mcp,"read")],[c.dashboard.apps.setup,requires(c.admin.externalApps,"read")],[c.dashboard.monitoring.activities,requires(c.admin.workflows,"read")],[c.dashboard.monitoring.runHistory,requires(c.admin.workflows,"read")],[c.dashboard.monitoring.feedbacks,requires(c.admin.aiFeedback,"read")],[c.dashboard.monitoring.mappings,requires(c.admin.knowledge,"read")],[c.dashboard.monitoring.notifications,requires(c.admin.notifications,"read")],[c.dashboard.monitoring.events,requires(c.admin.eventsHub,"read")],[c.dashboard.monitoring.usage,requires(c.admin.aiUsage,"read")],[c.dashboard.monitoring.budgets,requires(c.admin.aiUsage,"read")],[c.dashboard.organization.accounts,requires(c.admin.users,"read")],[c.dashboard.organization.identity,requires(c.admin.organization,"read")],[c.dashboard.organization.general,requires(c.admin.organization,"read")],[c.dashboard.organization.developers,requires(c.admin.apiKeys,"read")],[c.dashboard.organization.notifications,requires(c.admin.notifications,"read")],[c.dashboard.organization.extensions,requires(c.admin.packages,"read")],[c.dashboard.organization.transfer,requires(c.admin.organizationTransfer.inspect)],[c.dashboard.organization.onboarding,requires(c.admin.organization,"manage")]]);var capabilityGrantKeys=new Set(["code","mode"]);var capabilityGrantsViolation=(capabilities)=>capabilities.every((entry)=>Object.keys(entry).every((key)=>capabilityGrantKeys.has(key))&&typeof entry.code==="string"&&entry.code.trim()!==""&&(entry.mode==="on"||entry.mode==="read"||entry.mode==="manage"))?undefined:"capabilities take access.allow(...) entries: a profile never declares a capability inline";var reservedHandleKeys=new Set(["manifest","schemaSidecars"]);var appliesToValues=new Set(["anonymous","server","user"]);var grantsReachedFrom=(()=>{const nodes=new Map(capabilityCatalogNodes(coreCapabilities).map((node)=>[node.code,node]));const codes=new Set;for(let node=nodes.get(capabilityCode(coreCapabilities.admin.grants));node?.kind==="readManage";node=node.parent===undefined?undefined:nodes.get(node.parent)){codes.add(node.code)}return codes})();var canGrantViolation=(profile)=>(profile.canGrant===undefined||profile.canGrant.length===0)&&profile.capabilities.some(({code,mode})=>mode==="manage"&&grantsReachedFrom.has(code))?'the profile holds admin.grants at manage and must declare canGrant: "all" or the grantable profiles':undefined;var serverAxesViolation=(profile)=>profile.appliesTo==="server"&&(profile.axes??[]).length>0?"a server profile declares no Grant Axes: an app server credential holds its Tuple without axes":undefined;var granteeKeys=new Set(["applicationServer","applicationVisitors","group","servicePrincipal","user"]);var accessGrantFqnMaxLength=320;var grantFqnSegment=/^[a-z0-9]+(?:-[a-z0-9]+)*$/u;var accessGrantFqnViolation=(fqn)=>[...fqn].length<=accessGrantFqnMaxLength&&fqn.split(".").every((segment)=>grantFqnSegment.test(segment))?undefined:`an Access Grant FQN has dot-separated segments that match ${grantFqnSegment.source} and at most ${accessGrantFqnMaxLength} characters`;var knowledgeEntityIdentifierViolation=(value)=>Object.keys(value).length===1&&value.knowledgeEntity!==undefined&&value.knowledgeEntity.field.trim()!==""&&value.knowledgeEntity.value.trim()!==""?undefined:"an Axis Value of a declared grant is a knowledgeEntity({ field: value }) identifier";var audienceKeys=new Set(["anonymous","applications","capabilities","groups","organization","profiles"]);var accessAudienceViolation=(audience)=>{const lists=[["anonymous",audience.anonymous??[]],["applications",audience.applications??[]],["capabilities",(audience.capabilities??[]).map(({code,mode})=>`${code}:${mode}`)],["groups",(audience.groups??[]).map(({fqn})=>fqn)],["profiles",audience.profiles??[]]];for(const[key,fqns]of lists){const repeated=fqns.find((fqn,index)=>fqns.indexOf(fqn)!==index);if(repeated!==undefined){return`audience.${key} lists '${repeated}' more than once`}}return};var onlyTrue=(value,path)=>value===true?true:invalid(path);var fqnList=optional(array(identity));var unexpectedKey=(audience)=>Object.keys(audience).some((key)=>!audienceKeys.has(key));var readAccessAudience=refine(object({anonymous:fqnList,applications:fqnList,capabilities:optional(refine(array(object({code:identity,mode:literal("manage","on","read")})),capabilityGrantsViolation)),groups:optional(array(refine(object({coverage:literal("direct","inherited"),fqn:identity}),onlyKeys("coverage","fqn")))),organization:optional(onlyTrue),profiles:fqnList}),(audience)=>unexpectedKey(audience)?"unexpected member":accessAudienceViolation(audience));var connectionScopes=["organization","user","both"];var connectionScopeViolation=({personalCredentials,scope})=>personalCredentials!==undefined&&(scope===undefined||scope==="organization")?"personalCredentials needs the scope user or both":undefined;var metadata=object({available:boolean,label:string});var connection=(value,path)=>{const declaration=object({...base,compatibility:optional(object({auth:optString,dialect:optString,extensions:optional(jsonObject),provider:optString})),creationMode:optional(literal("self_service","registration_only")),credential:form,defaultConnectionName:string,discoveryMetadata:optional(metadata),kind:literal("connection"),personalCredentials:optional(form),providerFamily:string,scope:optional(literal(...connectionScopes)),secretFields:optStrings,testMetadata:optional(metadata)})(value,path);if(connectionScopeViolation(declaration)!==undefined){return invalid(`${path}/personalCredentials`)}return declaration};var pathParts=array(union(string,number));var bindingModes=array(literal("external","managed"));var syncModes=array(literal("delta","full"));var bindingScopes=array(literal("organization","tenant"));var mutationPolicy=literal("always","connector_backed","never");var extraProps=literal("ignore","import","inline");var outboundStrategy=literal("local_first","remote_first");var updateMode=literal("full","partial");var localized=object({fallbackLocale:string,values:record(string)});var catalogTags=optional(record(strings));var connectionRefs=optional(array(object({catalogCollection:optString,connectionInstanceFqn:optional(identity),connectionTemplateFqn:string,label:string,required:optBoolean,slot:string,visibleWhen:optional(visibility)})));var projectionPath=refine(string,(path)=>path.split(".").every((key)=>/^[^[\]]+(?:\[\d*\])*$/u.test(key))&&path.split("[]").length<=2?undefined:"malformed remote path");var fieldMap=(v,p)=>{const common={direction:literal("both","inbound","outbound"),local:string,skipIfNull:boolean};const{op}=object({op:string})(v,p);switch(op){case"path":{return object({...common,op:literal(op),remote:string})(v,p)}case"cast":{return object({...common,falseValues:optStrings,op:literal(op),remote:string,trueValues:optStrings})(v,p)}case"default":{return object({...common,op:literal(op),remote:optString,value:json})(v,p)}case"concat":{return object({...common,op:literal(op),remote:strings,separator:optString})(v,p)}case"split":{return object({...common,discardEmpty:optBoolean,op:literal(op),remote:string,separators:optStrings,trimItems:optBoolean,uniqueItems:optBoolean})(v,p)}case"coordinates":{return object({...common,latitudeKey:optString,longitudeKey:optString,op:literal(op),remote:(value,location)=>{const parts=strings(value,location);if(parts.length!==2){return invalid(location)}return[string(parts[0],location),string(parts[1],location)]}})(v,p)}case"transform":{return object({...common,op:literal(op),remote:string,transformerId:string})(v,p)}case"reference":{return object({...common,op:literal(op),remote:projectionPath,target:optString})(v,p)}case"embedded":{return object({...common,fieldMap:array((rule,path)=>{const nested=fieldMap(rule,path);if(nested.op==="embedded"){throw new TypeError(`Invalid package manifest at ${path}/op: an embedded rule cannot hold another embedded rule`)}return nested}),op:literal(op),remote:projectionPath,remoteId:string,target:optString})(v,p)}default:{return invalid(`${p}/op`)}}};var predefinedExtras=optional(array(object({displayName:nullable(string),enabled:boolean,id:string,includeInEntityEmbedding:boolean,kind:literal("linked_text","file_source"),slotKey:string,source:jsonObject})));var predefinedSchedules=optional(array(object({cronExpression:string,enabled:optBoolean,importMode:optional(literal("delta","full")),label:optString,rationale:optString,timezone:optString})));var schemaCapability={extraPropsMode:optional(extraProps),fieldMap:optional(array(fieldMap)),fqn:string,outboundStrategy:optional(outboundStrategy),predefinedBindingExtras:predefinedExtras,predefinedBindingKey:optString,predefinedBindingMode:optional(literal("external","managed")),predefinedBindingRemoteCollectionId:optString,predefinedBindingRemoteCollectionName:optString,predefinedSchedules,supportedSyncModes:optional(syncModes),supportsInbound:optBoolean,supportsOutbound:optBoolean,syncIntervalSeconds:optional(nullable(number)),updateMode:optional(updateMode)};var entityCapability=object({...schemaCapability,predefinedBindingParentKey:optString,supportedBindingModes:optional(bindingModes)});var discoveryDefaults=object({extraPropsMode:extraProps,outboundStrategy,supportedBindingModes:bindingModes,supportedSyncModes:syncModes,supportsInbound:boolean,supportsOutbound:boolean,syncIntervalSeconds:nullable(number),updateMode});var datasetCapabilities=object({aggregates:array(literal("count","count_distinct","sum","min","max","avg")),definitionRefresh:boolean,grouping:boolean,intents:array(literal("records","aggregate","time_series")),limits:object({maxBytes:number,maxPageRows:number,maxRows:number,timeoutMs:number}),ordering:boolean,pagination:boolean,predicates:array(literal("eq","ne","lt","lte","gt","gte","in","not_in","is_null","is_not_null","contains","starts_with"))});var readOverviewBudget=(value,path)=>{const parsed=positiveSafeInteger(value,path);return parsed<=1e6?parsed:invalid(path)};var overviewInputMaxChars=optional(nullable(readOverviewBudget));var richEnrichment=optional(nullable(boolean));var fieldReferences=array(object({field:string,scope:literal("data","entity")}));var ownerRelationFields={autocomplete:optional(object({baseFilters:optional(array(object({caseSensitive:optBoolean,field:identity,operator:literal("contains","contains_all","contains_any","contains_none","ends_with","eq","exists","gt","gte","in","is_empty","is_not_empty","is_not_null","is_null","lt","lte","ne","nin","not_contains","not_in","starts_with"),value:json}))),fields:optional(fieldReferences)})),display:optional(object({fields:fieldReferences})),inverseOf:optional((_value,path)=>invalid(path)),onDelete:optional(literal("clear","restrict")),targetSchemaFqn:identity};var ownerRelation=union(object({...ownerRelationFields,cardinality:literal("one_to_one","many_to_one"),maxItems:optional((_value,path)=>invalid(path))}),object({...ownerRelationFields,cardinality:literal("one_to_many","many_to_many"),maxItems:optional(positiveSafeInteger)}));var inverseRelation=object({autocomplete:optional((_value,path)=>invalid(path)),cardinality:optional((_value,path)=>invalid(path)),display:optional(object({fields:fieldReferences})),inverseOf:object({field:refine(identity,(pointer)=>/^\/(?:[^~/]|~[01])+$/u.test(pointer)?undefined:"top-level pointer"),schemaFqn:identity}),maxItems:optional((_value,path)=>invalid(path)),onDelete:optional((_value,path)=>invalid(path)),targetSchemaFqn:optional((_value,path)=>invalid(path))});var relation=union(ownerRelation,inverseRelation);var fieldSemantics=object({defaultSearch:optBoolean,embedded:optBoolean,faceted:optBoolean,file:optional(object({accepts:strings,maxBytes:optional(positiveSafeInteger),multiple:boolean})),includeInItemEmbedding:optBoolean,indexContent:optBoolean,indexOverview:optBoolean,indexed:optBoolean,managedProjectionSource:optional(literal("organization_group","organization_user")),mediaVisibility:optional(literal("private","protected","public")),overviewInputMaxChars,queryGuidance:optString,relation:optional(relation),richEnrichment,unique:optBoolean,user:optional(object({accounts:optional((value,path)=>value===true?true:invalid(path)),multiple:boolean}))});var managedProjection=object({connectorPolicy:literal("allow","deny_schema"),genericMutationPolicy:literal("deny_managed_fields","deny_schema"),kind:literal("directory_person","directory_person_in_group","directory_group","directory_group_parent"),source:literal("organization_group","organization_group_hierarchy","organization_group_membership","organization_user")});var fieldLocalization=object({description:optional(localized),help:optional(localized),label:optional(localized),placeholder:optional(localized)});var fieldPresentation=object({copyable:optBoolean,editor:optString,editorOptions:optional(object({accepts:optStrings,allowCustomValues:optBoolean,autocomplete:optString,clearable:optBoolean,falseLabel:optString,multiple:optBoolean,options:optional(array(object({label:string,value:string}))),rows:optNumber,searchable:optBoolean,showButtons:optBoolean,spellcheck:optBoolean,step:optNumber,trueLabel:optString})),emptyLabel:optString,falseLabel:optString,hidden:optBoolean,layout:optional(object({column:optNumber,labelPlacement:optional(literal("left","top")),order:optNumber,row:optNumber,width:optional(union(number,literal("full")))})),maxLines:optNumber,readOnly:optBoolean,renderer:optString,trueLabel:optString});var lifecycle=object({deployMode:literal("init_only","upsert"),readonly:boolean});var withoutRetiredRelationKey=(read,key)=>(value,path)=>{const parsed=read(value,path);if(key in parsed){throw new TypeError(`Invalid package manifest at ${path}/${key}: ${key} is retired with Record Relations; declare a Reference Field instead`)}return parsed};var autocompleteConfiguration=object({autocompleteFields:fieldReferences,defaultAutocompleteFields:fieldReferences});var knowledgeSchema={catalogTags,domainFqn:string,fieldLocalization:optional(record(fieldLocalization)),fieldPresentation:optional(record(fieldPresentation)),fieldSemantics:optional(record(fieldSemantics)),localMutationPolicy:optional(mutationPolicy),managedProjection:optional(managedProjection),schema};var selectionKeys=(selection)=>{if(selection===undefined){return[]}return"except"in selection?selection.except:selection};var nestedConditions=(node)=>{if("and"in node){return node.and}if("or"in node){return node.or}if("not"in node){return[node.not]}return"via"in node?[node.via.condition]:[]};var operands=(node)=>{if("exists"in node){return[node.exists]}if("isNull"in node){return[node.isNull]}if("contains"in node){return node.contains}if("eq"in node){return node.eq}if("gt"in node){return node.gt}if("gte"in node){return node.gte}if("isIn"in node){return node.isIn}if("lt"in node){return node.lt}if("lte"in node){return node.lte}if("neq"in node){return node.neq}if("overlaps"in node){return node.overlaps}return"startsWith"in node?node.startsWith:[]};var collectReads=(node,read)=>{if("condition"in node){return false}for(const operand of operands(node)){if("grantAxis"in operand){read.add(operand.grantAxis)}}return nestedConditions(node).every((child)=>collectReads(child,read))};var unreadConditionAxes=(axes,where)=>{const read=new Set;if(where!==undefined&&!collectReads(where,read)){return[]}return axes.flatMap((rule)=>("byCondition"in rule)&&!read.has(rule.axis)?[rule.axis]:[])};var purposes=new Set(["access","administration"]);var operations=new Set(["read","write"]);var knowledgeDataPolicyViolation=(policy)=>{if(!operations.has(policy.operation)||!purposes.has(policy.purpose)){return'operation is "read" or "write" and purpose is "access" or "administration"'}const rules=policy.axes??[];const axes=rules.map(({axis})=>axis);if(new Set(axes).size!==axes.length){return"axes binds one rule per axis"}const[unread]=unreadConditionAxes(rules,policy.where);if(unread!==undefined){return`byCondition(${unread}) needs a where that reads grantAxis(${unread})`}if(policy.operation==="read"&&policy.writableFields!==undefined){return"writableFields belongs to write policies"}if(policy.operation==="write"&&policy.readableFields!==undefined){return"readableFields belongs to read policies"}const keys=[...selectionKeys(policy.readableFields),...selectionKeys(policy.writableFields)];return keys.some((key)=>key.trim()==="")?"a field key must not be empty":undefined};var coreKinds=new Set(["admin","default","tenant"]);var coreData=new Set(["datasets","documents","knowledge"]);var documentOperations=new Set(["history","read","write"]);var unlowerable=new Set(["condition","includesMe","overlaps","via"]);var unlowerableOperator=(where)=>{const operator=Object.keys(where).find((key)=>unlowerable.has(key));if(operator!==undefined){return operator}let children=[];if("and"in where){children=where.and}else if("or"in where){children=where.or}else if("not"in where){children=[where.not]}return children.map(unlowerableOperator).find((found)=>found!==undefined)};var datasetDataPolicyViolation=(policy)=>{const axes=(policy.axes??[]).map(({axis})=>axis);if(new Set(axes).size!==axes.length){return"axes binds one rule per axis"}const operator=policy.where===undefined?undefined:unlowerableOperator(policy.where);if(operator!==undefined){return`${operator} has no Dataset filter`}const keys=[...selectionKeys(policy.readableFields),...(policy.axes??[]).map(({field})=>field)];if(keys.some((key)=>key.trim()==="")){return"a field key must not be empty"}return Object.values(policy.limits??{}).every((bound)=>Number.isSafeInteger(bound)&&bound>0)?undefined:"limits are positive whole numbers"};var mode=literal("manage","on","read");var coverage=literal("direct","inherited");var operation=literal("read","write");var documentOperation=literal("history","read","write");var capabilityNode=(value,path)=>refine(object({children:optional(record(capabilityNode)),kind:literal("readManage","switch")}),onlyKeys("children","kind"))(value,path);var capabilityNodes=(value,path)=>{const nodes=record(capabilityNode)(value,path);capabilityNodeDeclarations(nodes,"readManage",path,new Set(["manifest","schemaSidecars"]));return nodes};var applicationCapabilityNodes=(value,path)=>{const nodes=record(capabilityNode)(value,path);capabilityNodeDeclarations(nodes,"switch",path);return nodes};var capabilityGrants=refine(array(object({code:identity,mode})),capabilityGrantsViolation);var requirement=refine(object({mode,requires:identity}),onlyKeys("mode","requires"));var singleKey=(value,path)=>{const keys=Object.keys(jsonObject(value,path));const[key]=keys;return keys.length===1&&key!==undefined?key:invalid(path)};var variant=(readers,key,path)=>(key===undefined||!Object.hasOwn(readers,key)?undefined:readers[key])??(()=>invalid(path));var operandReaders={grantAxis:object({grantAxis:identity}),resource:object({resource:identity}),subject:object({subject:identity}),value:object({value:json})};var operand=(value,path)=>variant(operandReaders,singleKey(value,path),path)(value,path);var comparisonOperators=new Set(["contains","eq","gt","gte","isIn","lt","lte","neq","overlaps","startsWith"]);var comparison=refine(array(operand),(pair)=>pair.length===2?undefined:"a comparison has two operands");var condition=(value,path)=>{const key=singleKey(value,path);const at=`${path}/${key}`;const member=jsonObject(value,path)[key];if(key==="and"||key==="or"){refine(array(condition),(items)=>items.length===0?"needs a condition":undefined)(member,at)}else if(key==="not"){if(readsGrantAxis(condition(member,at))){invalid(at)}}else if(comparisonOperators.has(key)){comparison(member,at)}else if(key==="exists"||key==="isNull"){operand(member,at)}else if(key==="condition"||key==="isMe"||key==="includesMe"){identity(member,at)}else if(key==="inGroup"){object({coverage,field:identity,group:identity})(member,at)}else if(key==="inMyGroups"){object({coverage,field:identity})(member,at)}else if(key==="via"){object({condition,resource:identity})(member,at)}else{invalid(at)}return value};var fieldSelection=union(array(identity),refine(object({except:array(identity)}),onlyKeys("except")));var isTrue=(value,path)=>value===true?true:invalid(path);var bindingReaders={field:object({field:identity}),relation:object({relation:object({field:identity,key:identity})}),self:object({self:isTrue})};var axisBinding=(value,path)=>variant(bindingReaders,singleKey(value,path),path)(value,path);var policyAxis=(value,path)=>{const rule=jsonObject(value,path);const keys=Object.keys(rule).filter((key)=>key!=="axis");const[key]=keys;identity(rule.axis,`${path}/axis`);if(keys.length!==1||key===undefined){return invalid(path)}if(key==="map"){axisBinding(rule.map,`${path}/map`)}else if(key!=="byCondition"&&key!=="unscoped"){invalid(`${path}/${key}`)}else{isTrue(rule[key],`${path}/${key}`)}return value};var knowledgeEntityIdentifier=refine(object({knowledgeEntity:object({field:identity,value:identity})}),knowledgeEntityIdentifierViolation);var granteeReaders={applicationServer:refine(object({applicationServer:identity}),onlyKeys("applicationServer")),applicationVisitors:refine(object({applicationVisitors:identity}),onlyKeys("applicationVisitors")),group:refine(object({coverage,group:object({fqn:identity})}),onlyKeys("coverage","group")),servicePrincipal:refine(object({servicePrincipal:identity}),onlyKeys("servicePrincipal")),user:refine(object({user:object({email:identity})}),onlyKeys("user"))};var grantee=(value,path)=>variant(granteeReaders,Object.keys(jsonObject(value,path)).find((name)=>name!=="coverage"),path)(value,path);var documentFolderTarget=union(refine(object({drive:identity,folders:strings}),onlyKeys("drive","folders")),refine(object({remoteId:identity}),onlyKeys("remoteId")));var documentDataPolicy=(value,path)=>{const policy=refine(object({...base,capability:requirement,collection:optional(identity),folder:optional(object({collection:identity,target:documentFolderTarget})),kind:literal("accessDocumentDataPolicy"),lifecycle:optional(lifecycle),operation:documentOperation}),({collection,folder})=>collection===undefined===(folder===undefined)?"name a collection or a folder":undefined)(value,path);return policy};var conditionTest=object({expected:boolean,name:identity,record:jsonObject,subject:optional(jsonObject)});var accessPrimitives={accessCapabilities:object({...base,grantableBy:literal("admins","holders"),kind:literal("accessCapabilities"),lifecycle:optional(lifecycle),nodes:capabilityNodes}),accessDatasetDataPolicy:refine(object({...base,axes:optional(array(refine(object({axis:identity,field:identity,match:literal("externalId","id")}),onlyKeys("axis","field","match")))),capability:requirement,dataset:identity,kind:literal("accessDatasetDataPolicy"),lifecycle:optional(lifecycle),limits:optional(refine(object({maxBytes:optional(positiveSafeInteger),maxRows:optional(positiveSafeInteger),maxTimeoutMs:optional(positiveSafeInteger)}),onlyKeys("maxBytes","maxRows","maxTimeoutMs"))),otherAxes:optional(literal("unscoped")),readableFields:optional(fieldSelection),where:optional(condition)}),datasetDataPolicyViolation),accessDocumentDataPolicy:documentDataPolicy,accessGrantAxis:object({...base,hierarchy:optional(identity),kind:literal("accessGrantAxis"),label:identity,lifecycle:optional(lifecycle),target:identity}),accessKnowledgeDataCondition:object({...base,kind:literal("accessKnowledgeDataCondition"),lifecycle:optional(lifecycle),target:identity,tests:optional(array(conditionTest)),where:condition}),accessKnowledgeDataPolicy:refine(object({...base,axes:optional(array(policyAxis)),capability:requirement,kind:literal("accessKnowledgeDataPolicy"),lifecycle:optional(lifecycle),operation,otherAxes:optional(literal("unscoped")),purpose:literal("access","administration"),readableFields:optional(fieldSelection),target:identity,where:optional(condition),writableFields:optional(fieldSelection)}),knowledgeDataPolicyViolation),accessMaxPrivileges:object({...base,appliesTo:union(refine(object({applicationTokens:identity}),onlyKeys("applicationTokens")),refine(object({apiKeyTemplate:identity}),onlyKeys("apiKeyTemplate"))),capabilities:capabilityGrants,kind:literal("accessMaxPrivileges"),lifecycle:optional(lifecycle)}),accessProfile:withoutKeys(["audience"],refine(object({...base,appliesTo:literal("anonymous","server","user"),axes:optional(array(identity)),canGrant:optional(union(literal("all"),array(identity))),capabilities:capabilityGrants,kind:literal("accessProfile"),lifecycle:optional(lifecycle)}),(profile)=>canGrantViolation(profile)??serverAxesViolation(profile))),accessProfileGrant:refine(object({...base,axes:optional(record(knowledgeEntityIdentifier)),grantee,kind:literal("accessProfileGrant"),lifecycle:optional(lifecycle),profile:identity}),(grant)=>accessGrantFqnViolation(grant.fqn))};var assertDataAccess=(value,own,location)=>{if(value===undefined){return}if(typeof value!=="object"||value===null||Array.isArray(value)){throw new TypeError(`${location}: dataAccess must be an object`)}for(const[source,mode]of Object.entries(value)){if(!["knowledge","datasets","documents"].includes(source)){throw new TypeError(`${location}: unknown dataAccess source '${source}'`)}if(mode!=="user"&&mode!==own){throw new TypeError(`${location}: dataAccess.${source} must be 'user' or '${own}'`)}}};var readDataAccess=(own)=>(value,location)=>{assertDataAccess(value,own,location);return value};var workflowDataAccess=(outer,inner,location)=>{assertDataAccess(outer,"workflow",location);assertDataAccess(inner,"workflow",`${location}.definition`);if(outer!==undefined&&inner!==undefined){for(const source of["knowledge","datasets","documents"]){if((outer[source]??"workflow")!==(inner[source]??"workflow")){throw new TypeError(`${location}: conflicting dataAccess.${source} in declaration and definition`)}}}return outer??inner};var usesBindingKeys=["approval","description","fqn","name","settings"];var definedBindingKeys=new Set(usesBindingKeys);var boundTool=Symbol("boundTool");var usesBindingDeclaration=(entry)=>typeof entry==="string"?{fqn:entry}:entry;var duplicateUsesBinding=(bindings)=>{const seen=new Set;for(const entry of bindings){const binding=usesBindingDeclaration(entry);const key=JSON.stringify([binding.fqn,binding.name??null]);if(seen.has(key)){return binding}seen.add(key)}return};var agentModelTiers=["complex","balanced","fast","super_fast"];var datasetParserFormat=(value,path)=>{if(typeof value!=="string"||value.length>128||value==="external"||!/^[a-z][a-z0-9._-]*$/u.test(value)){throw new TypeError(`Invalid dataset parser format at ${path}`)}return value};var datasetParserVersion=(value,path)=>{if(typeof value!=="string"||value.trim()===""||value.length>96){throw new TypeError(`Invalid dataset parser version at ${path}`)}return value};var assertNoHostKeys=(form,location)=>{const properties=form.schema.document.properties??{};const defined=HostBindingSettingKeys.filter((key)=>Object.hasOwn(properties,key));if(defined.length>0){throw new TypeError(defined.map((key)=>`${location}/properties/${key}: the host owns '${key}'; a Binding Settings Form cannot define it`).join("; "))}};var closedGatewayObject=(fields)=>refine(object(fields),(value)=>Object.keys(value).some((key)=>!Object.hasOwn(fields,key))?"unexpected Gateway field":undefined);var identifier=refine(string,(value)=>/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/u.test(value)?undefined:"invalid identifier");var version=refine(string,(value)=>value.length>0&&value.length<=128&&value.trim()===value?undefined:"invalid version");var bounded=(maximum,minimum=1)=>refine(number,(value)=>Number.isSafeInteger(value)&&value>=minimum&&value<=maximum?undefined:"invalid limit");var unique=(read,key)=>refine(read,(values)=>new Set(values.map(key)).size===values.length?undefined:"duplicate identifier");var projection=refine(schema,(value)=>(value.fidelity==="exact"||value.fidelity==="structural")&&Object.keys(value).every((key)=>key==="dialect"||key==="document"||key==="fidelity")?undefined:"unsupported Gateway projection");var authorization=closedGatewayObject({delegatedSubject:literal("allowed","forbidden","required"),organization:literal("required"),principalKinds:refine(unique(array(literal("detached_user","service_principal")),(kind)=>kind),(values)=>values.length>0?undefined:"empty principalKinds"),scopes:unique(array(refine(string,(value)=>value.length>0&&value.length<=256?undefined:"invalid scope")),(scope)=>scope)});var operationFields={authorization,description:string,effects:literal("external_side_effect","read","write"),execution:closedGatewayObject({mode:literal("synchronous"),timeoutMs:bounded(3600000)}),id:identifier,idempotency:literal("idempotent","requires_key","safe"),input:projection,limits:closedGatewayObject({maxRequestBytes:bounded(16777216),maxResponseBytes:bounded(16777216)}),output:projection,retry:union(closedGatewayObject({mode:literal("never")}),closedGatewayObject({maxAttempts:bounded(10,2),mode:literal("idempotent_only")})),title:string,version};var operationReader=closedGatewayObject(operationFields);var domainFields={description:optional(string),displayOrder:optional(number),icon:optional(string),id:identifier,tags:optional(strings),title:string};var domainsReader=unique(array(closedGatewayObject({...domainFields,operations:unique(array(operationReader),(operation)=>operation.id)})),(domain)=>domain.id);var inputReader=closedGatewayObject({id:identifier,operationDomains:domainsReader,version});var empty=refine(array(identity),(values)=>values.length===0?undefined:"operation-only Gateway required");var emptyReader=(value,path)=>{empty(value,path);return[]};var disabled=(value,path)=>boolean(value,path)===false?false:invalid(path);var contractReader=closedGatewayObject({capabilities:closedGatewayObject({resources:disabled}),datasets:emptyReader,id:identifier,knowledge:emptyReader,operationDomains:unique(array(closedGatewayObject({...domainFields,operations:unique(array(closedGatewayObject({...operationFields,canonicalReference:string})),(operation)=>operation.id)})),(domain)=>domain.id),organizationBinding:closedGatewayObject({mode:literal("installed_organization")}),protocolVersion:literal("2"),version});var buildOperationGatewayContract=(input)=>{assertDenseArrays(input,"gateway",new WeakSet);canonicalJson(input);const admitted=inputReader(input,"gateway");return{capabilities:{resources:false},datasets:[],id:admitted.id,knowledge:[],operationDomains:admitted.operationDomains.map((domain)=>({...domain,operations:domain.operations.map((operation)=>({...operation,canonicalReference:`${admitted.id}/${domain.id}/${operation.id}@${operation.version}`})).sort((a,b)=>compareUtf16CodeUnits(a.id,b.id))})).sort((a,b)=>compareUtf16CodeUnits(a.id,b.id)),organizationBinding:{mode:"installed_organization"},protocolVersion:"2",version:admitted.version}};var readOperationGatewayContract=(value,path)=>{assertDenseArrays(value,path,new WeakSet);const admitted=contractReader(value,path);const normalized=buildOperationGatewayContract({id:admitted.id,operationDomains:admitted.operationDomains.map((domain)=>({...domain,operations:domain.operations.map(({canonicalReference:_reference,...operation})=>operation)})),version:admitted.version});if(canonicalJson(admitted)!==canonicalJson(normalized)){invalid(path)}return normalized};var readExternalAppGateway=closedGatewayObject({...base,expectedContract:readOperationGatewayContract,kind:literal("externalAppGateway")});var externalApplicationConsents=["inherit","ask","skip"];var externalApplicationViolation=({applicationConsent,primaryRedirectUri,redirectUris})=>{if(primaryRedirectUri!==undefined&&!isVariableReference(primaryRedirectUri)&&!isVariableReference(redirectUris)&&!redirectUris.some(isVariableReference)&&!redirectUris.includes(primaryRedirectUri)){return"primaryRedirectUri must be one of redirectUris"}if(applicationConsent!==undefined&&!isVariableReference(applicationConsent)&&!externalApplicationConsents.includes(applicationConsent)){return"applicationConsent must be 'inherit', 'ask' or 'skip'"}return};var uuid=/^[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}$/iu;var placeholder=/\{(?<name>[^{}]*)\}/gu;var placeholders={remoteId:(remoteId)=>encodeURIComponent(remoteId),remoteIdUuidHex:(remoteId)=>uuid.test(remoteId)?remoteId.replaceAll("-","").toLowerCase():null};var isPlaceholderName=(name)=>Object.hasOwn(placeholders,name);var resolver=(name)=>isPlaceholderName(name)?placeholders[name]:undefined;var knowledgeRemoteReferenceUrlTemplate=(value,path)=>{if(typeof value!=="string"||!value.startsWith("https://")||/[{}]/u.test(value.replaceAll(placeholder,(match,name)=>resolver(name)===undefined?match:""))){throw new TypeError(`Invalid remote reference URL template at ${path}`)}return value};var subgroupKey=/^[a-z0-9]+(?:-[a-z0-9]+)*$/u;var organizationGroupFqnMaxLength=320;var fqnViolation=(fqn)=>{const characters=[...fqn];if(characters.length<=organizationGroupFqnMaxLength){return}const shortened=`${characters.slice(0,40).join("")}...${characters.slice(-40).join("")}`;return`Group FQN '${shortened}' holds ${characters.length} characters; the limit is ${organizationGroupFqnMaxLength}`};var subgroupsViolation=(parentFqn,subgroups=[])=>{const keys=new Set;for(const{key,subgroups:nested}of subgroups){if(!subgroupKey.test(key)){return`subgroup key '${key}' of '${parentFqn}' must match ${subgroupKey.source}`}if(keys.has(key)){return`subgroup key '${key}' is declared more than once in '${parentFqn}'`}keys.add(key);const fqn=`${parentFqn}.${key}`;const violation=fqnViolation(fqn)??subgroupsViolation(fqn,nested);if(violation!==undefined){return violation}}return};var organizationGroupViolation=({fqn,subgroups})=>fqnViolation(fqn)??subgroupsViolation(fqn,subgroups);var fields=["answerLength","bannedQuestions","enabled","otherInstructions","toneOfVoice"];var organizationInstructionsViolation=(definition)=>fields.some((field)=>definition[field]!==undefined)?undefined:"at least one field is required";var sections=["authentication","branding","governance","identity","locale"];var mediaPath=/^media\/[^/]+$/u;var brandingViolation=(branding)=>{if(branding===undefined||isVariableReference(branding)){return}const paths=new Set;for(const key of["cover","icon","logo"]){const reference=branding[key];const media=isVariableReference(reference)?undefined:reference?.media;if(media===undefined||isVariableReference(media)){continue}if(!mediaPath.test(media)){return`branding.${key} media path '${media}' must be media/<file>`}if(paths.has(media)){return`branding.${key} media path '${media}' is used by two branding keys`}paths.add(media)}return};var authenticationViolation=(authentication)=>{if(authentication===undefined||isVariableReference(authentication)){return}for(const method of["otp","password"]){const local=authentication[method];if(local===undefined||isVariableReference(local)){continue}const{domains,enabled}=local;if(enabled===true&&!isVariableReference(domains)&&(domains??[]).length===0){return`authentication.${method} is enabled and needs at least one domain`}}const{sso}=authentication;for(const[index,entry]of(sso===undefined||isVariableReference(sso)?[]:sso).entries()){if(!isVariableReference(entry)&&entry.provisionMembers===true&&entry.defaultProfile===undefined){return`authentication.sso[${index}] registers members and needs a defaultProfile`}}const consent=authentication.applicationConsent;if(consent!==undefined&&!isVariableReference(consent)&&consent!=="ask"&&consent!=="skip"){return"authentication.applicationConsent must be 'ask' or 'skip'"}return};var organizationSettingsViolation=(definition)=>{if(!sections.some((section)=>Object.keys(definition[section]??{}).length>0)){return"at least one setting is required"}if(definition.identity!==undefined&&"slug"in definition.identity){return"identity.slug is not declarable"}return brandingViolation(definition.branding)??authenticationViolation(definition.authentication)};var packageSourceDeployModes=["managed","ci"];var identifier2=/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/u;var fields2=new Set(["category","description","displayName","fqn","gatewayRef","icon","kind","operationReferences","tags","version"]);var referencesGateway=(reference,gatewayId)=>{const separator=reference.indexOf("@");if(separator===-1){return false}const[gateway,domain,operation,...rest]=reference.slice(0,separator).split("/");const version=reference.slice(separator+1);return identifier2.test(gatewayId)&&gateway===gatewayId&&domain!==undefined&&identifier2.test(domain)&&operation!==undefined&&identifier2.test(operation)&&rest.length===0&&version.length>0&&version.length<=128&&version.trim()===version};var remoteToolCollectionViolation=(declaration)=>{const unknownField=Object.keys(declaration).find((key)=>!fields2.has(key));if(unknownField!==undefined){return`unsupported remote metadata field '${unknownField}'`}const{gatewayRef,operationReferences}=declaration;if(gatewayRef===undefined||gatewayRef.trim()===""||gatewayRef.trim()!==gatewayRef){return"gatewayRef must be a nonempty FQN"}if(operationReferences.length===0||new Set(operationReferences).size!==operationReferences.length||operationReferences.some((reference)=>!referencesGateway(reference,reference.split("/")[0]??""))){return"operationReferences must name unique versioned Gateway operations"}return};var reviewKpis=["safety","efficiency","overlap","quality","custom"];var maxStudioTriggerFormFileBytes=10*1024*1024;var studioFormKey="studioForm";var fieldKeyPattern=/^[A-Za-z][A-Za-z0-9_]*$/u;var contentTypePattern=/^[\w.+-]+\/[\w.+-]+$/u;var fieldKey=refine(identity,(key)=>fieldKeyPattern.test(key)?undefined:"key");var fileField=object({accept:optional(refine(array(refine(identity,(type)=>contentTypePattern.test(type)?undefined:"content type")),(types)=>types.length===0?"no content type":undefined)),key:fieldKey,label:identity,maxBytes:optional(refine(positiveSafeInteger,(bytes)=>bytes>maxStudioTriggerFormFileBytes?"above ceiling":undefined)),type:literal("file")});var valueField=object({key:fieldKey,label:identity,type:literal("boolean","number","text","textarea")});var enumField=object({key:fieldKey,label:identity,options:refine(array(object({label:identity,value:identity})),(options)=>options.length>0&&new Set(options.map(({value})=>value)).size===options.length?undefined:"options"),type:literal("enum")});var jsonField=object({key:fieldKey,label:identity,schema:schemaDocument,type:literal("json")});var entitiesField=object({key:fieldKey,label:identity,labelKey:optional(identity),schemaFqn:identity,type:literal("entities"),valueKey:optional(identity)});var richTextField=object({key:fieldKey,label:identity,type:literal("rich_text")});var userField=object({key:fieldKey,label:identity,multiple:optBoolean,required:optBoolean,type:literal("user_select")});var fieldReaders={boolean:valueField,entities:entitiesField,enum:enumField,file:fileField,json:jsonField,number:valueField,rich_text:richTextField,text:valueField,textarea:valueField,user_select:userField};var formField=(value,path)=>{const{type}=object({type:literal("boolean","entities","enum","file","json","number","rich_text","text","textarea","user_select")})(value,path);return fieldReaders[type](value,path)};var studioFormFields=refine(array(formField),(fields)=>new Set(fields.map(({key})=>key)).size===fields.length?undefined:"duplicate key");var studioTriggerFormAt=(metadata,path)=>optional(object({fields:optional(studioFormFields),organizationGroup:identity}))(metadata[studioFormKey],`${path}/${studioFormKey}`);var studioTriggerMetadata=(read)=>(value,path)=>{const metadata=read(value,path);studioTriggerFormAt(metadata,path);return metadata};var audience=optional(readAccessAudience);var view=object({componentRef:identity,dataBinding:optional(object({filter:optional(jsonObject),kind:literal("schema"),schema:identity})),fqn:identity,orderIndex:number,props:optional(jsonObject),slot:identity});var pageBase={audience,fqn:identity,fullHeight:optBoolean,fullWidth:optBoolean,icon:optString,label:string,orderIndex:number,routeSegment:identity,slug:identity};var genericPage=object({...pageBase,kind:literal("generic"),views:array(view)});var predefinedPage=object({...pageBase,kind:literal("predefined"),predefinedPageRef:identity});var page=(value,path)=>object({kind:literal("generic","predefined")})(value,path).kind==="generic"?genericPage(value,path):predefinedPage(value,path);var layout=(value,path)=>object({kind:literal("custom","left_sidebar")})(value,path).kind==="custom"?object({componentRef:identity,kind:literal("custom"),props:optional(jsonObject)})(value,path):object({kind:literal("left_sidebar")})(value,path);var studioViewKey=(fqn)=>(fqn.split(".").at(-1)??fqn).toLowerCase().replaceAll(/[^a-z0-9]+/gu,"-").replaceAll(/^-+|-+$/gu,"").slice(0,64);var hasDuplicate=(keys)=>new Set(keys).size!==keys.length;var collision=({sections})=>{const pages=sections.map((section)=>section.pages);const views=pages.flat().map((item)=>item.kind==="generic"?item.views:[]);if(hasDuplicate([...sections.map(({fqn})=>fqn),...pages.flat().map(({fqn})=>fqn),...views.flat().map(({fqn})=>fqn)])){return"duplicate FQN"}if(hasDuplicate(sections.map(({slug})=>slug))){return"duplicate section slug"}if(pages.some((items)=>hasDuplicate(items.map(({slug})=>slug)))){return"duplicate page slug"}return views.some((items)=>hasDuplicate(items.map(({fqn,slot})=>`${slot}
|
|
2
|
+
${studioViewKey(fqn)}`)))?"duplicate view key":undefined};var isTrue2=(value,path)=>value===true?true:invalid(path);var studioAppDeclaration=object({...base,audience,definition:refine(object({color:optString,description:optString,icon:optString,layout:optional(layout),name:string,sections:array(object({description:optString,fqn:identity,icon:optString,label:string,orderIndex:number,pages:array(page),slug:identity})),slug:identity}),collision),kind:literal("studioApp"),lifecycle:object({deployMode:literal("upsert"),readonly:isTrue2})});var agentFormFields=(value,path)=>studioFormFields(value,path).map((field,index)=>field.type==="rich_text"||field.type==="user_select"?invalid(`${path}/${index}/type`):field);var studioFormKey2="studioForm";var studioAgentFormAt=(metadata,path)=>optional(object({fields:agentFormFields}))(metadata[studioFormKey2],`${path}/${studioFormKey2}`);var studioAgentMetadata=(read)=>(value,path)=>{const metadata=read(value,path);studioAgentFormAt(metadata,path);return metadata};var WorkflowEditorWidgets=["checkbox","code","condition_builder","credential_selector","key_value","list","mapping_builder","multi_select","number","resource_selector","schedule_builder","schema_builder","select","text","textarea"];var WorkflowTemplateKinds=["action_node","input_node","output_node","trigger_node"];var WorkflowTriggerLifecycleAdapterIds=Object.freeze({externalApplication:"builtin.core.workflows.lifecycle.external-application",mcpOperation:"builtin.core.workflows.lifecycle.mcp-operation"});var duplicateUsesConnection=(connections)=>{const seen=new Set;for(const entry of connections){const connection=typeof entry==="string"?{fqn:entry}:entry;const key=JSON.stringify([connection.fqn,connection.scope??null]);if(seen.has(key)){return connection}seen.add(key)}return};var definitionKinds=["agent","skill","workflow"];var automationTypes=["organization","personal"];var automationDeclarationSegments={automationLimits:"automation-limits",packageSource:"package-sources",placementRule:"placement-rules",repositoryLink:"repository-links",reviewPolicy:"review-policies"};var segment=/^[a-z0-9]+(?:-[a-z0-9]+)*$/u;var kindSegments=new Set(Object.values(automationDeclarationSegments));var rule=`an automation declaration FQN is <package fqn>.<kind>.<slug>: dot-separated segments that match ${segment.source}, and <kind> is one of ${Object.values(automationDeclarationSegments).join(", ")}`;var kebabCase=(fqn)=>fqn.split(".").every((part)=>segment.test(part));var declarationFqnViolation=(fqn,kind)=>{const parts=fqn.split(".");const kindSegment=parts.at(-2)??"";const kindFits=kind===undefined?kindSegments.has(kindSegment):kindSegment===automationDeclarationSegments[kind];return parts.length>=3&&kebabCase(fqn)&&kindFits?undefined:rule};var automationFqnViolation=(kind)=>({fqn})=>declarationFqnViolation(fqn,kind);var concrete=(list)=>list===undefined||isVariableReference(list)?[]:list.filter((item)=>!isVariableReference(item));var spelled=(key)=>key===null||isVariableReference(key)?undefined:key;var knownKeys=(list)=>{if(isVariableReference(list)){return}const keys=new Set;for(const item of list??[]){const key=isVariableReference(item)?undefined:spelled(item.key);if(key===undefined){return}keys.add(key)}return keys};var connection2=union(refine(varyingObject({setupKey:identity}),(value)=>Object.keys(value).some((key)=>key!=="setupKey")?"install-only input":undefined),refine(object({connectionInstanceFqn:identity}),(value)=>Object.keys(value).some((key)=>key!=="connectionInstanceFqn")?"declared connection reference":undefined));var bindingFields={executionRole:optional(literal("root","child")),extraPropsMode:optional(literal("ignore","import","inline")),extras:refine(predefinedExtras,(extras)=>extras?.some((extra)=>!/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu.test(extra.id))?"invalid extra UUID":undefined),fieldMap:optional(array(fieldMap)),key:identity,outboundStrategy:optional(literal("local_first","remote_first")),parentKey:optional(nullable(identity)),remoteCollectionId:optional(nullable(string)),remoteCollectionName:optional(nullable(string)),supportedSyncModes:optional(varyingArray(literal("delta","full"))),supportsInbound:optBoolean,supportsOutbound:optBoolean,syncIntervalSeconds:optional(nullable(positiveSafeInteger)),updateMode:optional(literal("full","partial"))};var entityBinding=varyingObject({...bindingFields,bindingMode:literal("managed","external"),maxRemoteDeletionsPerRun:optional(nullable(positiveSafeInteger)),missingConnectorFieldsBehavior:optional(literal("prune","retain")),pushEntityMatch:optional(literal("remote_ref","unique_fields")),remoteDeletionPropagation:optional(literal("never","full","full_and_delta")),schemaFqn:identity,supportedBindingModes:optional(varyingArray(literal("managed","external"))),suppressEntityEvents:optBoolean});var schedule=varyingObject({cronExpression:identity,enabled:optBoolean,importMode:optional(literal("delta","full")),key:identity,timezone:optString});var positive=refine(number,(n)=>n>0?undefined:"positive");var budget=optional(nullable(positiveSafeInteger));var taskKind=(value,path)=>{if(value==="relation"){throw new TypeError(`Invalid package manifest at ${path}: the pipeline task kind relation is retired with Record Relations; a task names an entity binding`)}return literal("entity")(value,path)};var pipeline=varyingObject({definition:varyingObject({budgets:optional(varyingObject({maxPagesPerRun:budget,maxRemoteItemsPerRun:budget,maxRootWorkUnitsPerRun:budget,maxSecondsPerRun:optional(nullable(positive))})),steps:refine(varyingArray(varyingObject({tasks:varyingArray(varyingObject({bindingKey:identity,kind:taskKind,modeOverride:optional(nullable(literal("delta","full")))}))})),(steps)=>steps.length>0?undefined:"empty")}),enabled:optBoolean,key:identity,name:optString,schedules:optional(varyingArray(schedule))});var uniqueKeys=(values,path)=>{const seen=new Set;for(const[index,value]of values.entries()){const key=spelled(value.key);if(key===undefined){continue}if(seen.has(key)){invalid(`${path}/${index}/key`)}seen.add(key)}};var knowledge=withoutRetiredRelationKey(varyingObject({...base,connections:optional(record(connection2)),enabled:optBoolean,entityBindings:optional(varyingArray(entityBinding)),kind:literal("knowledgeConnectorInstance"),lifecycle,pipelines:optional(varyingArray(pipeline)),remoteFilters:optional(record(varyingObject({mode:literal("all","only_selected","all_except_selected"),selected_ids:varyingStrings}))),settings:optional(record(varyingObject({type:literal("inline","linked"),value:json}))),templateFqn:identity}),"relationBindings");var assertEntityParents=(entities,path)=>{const parents=new Map(entities.map((b)=>[spelled(b.key),spelled(b.parentKey)]));for(const binding of entities){const key=spelled(binding.key);if(key===undefined){continue}const seen=new Set([key]);let parent=spelled(binding.parentKey);while(parent!==undefined){if(seen.has(parent)){invalid(`${path}/entityBindings/parentKey`)}seen.add(parent);parent=parents.get(parent)}}};var assertPipelineTasks=(item,entityKeys,path)=>{const tasks=new Set;const definition=isVariableReference(item.definition)?undefined:item.definition;for(const step of concrete(definition?.steps)){for(const task of concrete(step.tasks)){const bindingKey=spelled(task.bindingKey);if(bindingKey===undefined){continue}if(entityKeys?.has(bindingKey)===false||tasks.has(bindingKey)){invalid(`${path}/definition/steps`)}tasks.add(bindingKey)}}};var knowledgeConnectorInstance=(value,path)=>{const parsed=knowledge(value,path);const entities=concrete(parsed.entityBindings);const pipelines=concrete(parsed.pipelines);uniqueKeys(entities,`${path}/entityBindings`);uniqueKeys(pipelines,`${path}/pipelines`);const entityKeys=knownKeys(parsed.entityBindings);assertEntityParents(entities,path);for(const[index,binding]of entities.entries()){const parentKey=spelled(binding.parentKey);if(parentKey!==undefined&&(entityKeys?.has(parentKey)===false||parentKey===spelled(binding.key))){invalid(`${path}/bindings/${index}/parentKey`)}}for(const[index,item]of pipelines.entries()){uniqueKeys(concrete(item.schedules),`${path}/pipelines/${index}/schedules`);assertPipelineTasks(item,entityKeys,`${path}/pipelines/${index}`)}return parsed};var scalar=literal("boolean","string","int64","float64","decimal","date","timestamp","duration","json");var datasetDefinition=varyingObject({fields:varyingArray(varyingObject({id:identity,name:string,nullable:boolean,semantic:optString,type:scalar})),measures:varyingArray(varyingObject({id:identity,name:string,resultType:scalar})),relationships:varyingArray(varyingObject({cardinality:literal("one_to_one","one_to_many","many_to_one","many_to_many"),fromFieldId:identity,id:identity,toFieldId:identity})),version:literal(1)});var location=(value,path)=>{const parsed=varyingObject({segments:varyingArray(varyingObject({kind:literal("container","dataset"),label:string,opaqueId:identity}))})(value,path);if(isVariableReference(parsed.segments)){return parsed}const[first]=parsed.segments;if(first===undefined||!isVariableReference(first)&&first.kind!=="container"){return invalid(`${path}/segments/0`)}return parsed};var datasetFields={...base,audience:optional(readAccessAudience),connection:optional(connection2),kind:literal("datasetConnectorInstance"),lifecycle,providerFqn:identity,schedules:optional(varyingArray(varyingObject({action:literal("health","refresh_definition"),cronExpression:identity,enabled:optBoolean,key:identity,timezone:optString}))),settings:optional(jsonObject)};var datasetConnectorInstance=(value,path)=>{const parsed=union(varyingObject({...datasetFields,bindingMode:literal("managed"),definition:datasetDefinition,sourceLocation:optional(location),templateConfig:optional(varyingObject({variant:identity,version:literal(1)})),templateFqn:optional(identity)}),varyingObject({...datasetFields,bindingMode:literal("external"),definition:optional(datasetDefinition),gatewayBindingKey:optString,sourceLocation:location,sourceMapping:optional(varyingObject({effectiveAtFieldId:optString,entityIdFieldId:identity,historySemantics:optional(literal("append_history")),kind:literal("entity_snapshot","status_update"),statusFieldId:optString,version:literal(1)}))}))(value,path);uniqueKeys(concrete(parsed.schedules),`${path}/schedules`);return parsed};var notificationDefinition=object({capabilities:object({extensionReadyProviders:strings,recipientTargets:strings,supportsActionLink:boolean,supportsAttachments:boolean,supportsFixedDestinations:optBoolean,supportsHtml:boolean,supportsMarkdown:boolean,supportsMentions:boolean,supportsReadReceipts:boolean,supportsRouteDestinations:boolean,supportsThreads:boolean}),credentialProfileKey:optString,family:literal("email","im","internal"),key:string,provider:string,setup:object({docsUrl:nullable(string),healthCheck:object({available:boolean,label:optString}),instructions:string,liveTest:object({available:boolean,label:optString}),secretFields:strings,setupForm:nullable(form)})});var studioPage=object({fullWidth:optBoolean,icon:optString,kind:literal("predefined"),label:string,orderIndex:number,predefinedPageRef:string,routeSegment:string,slug:string});var studioSection=object({description:optString,icon:optString,label:string,orderIndex:number,pages:array(studioPage),slug:string});var studioAppTemplate=object({color:optString,description:optString,icon:optString,isDefaultTemplate:optBoolean,name:string,sections:array(studioSection),slug:string});var datasetScalarType=literal("boolean","string","int64","float64","decimal","date","timestamp","duration","json");var datasetDefinition2=object({fields:array(object({id:string,name:string,nullable:boolean,semantic:optional(string),type:datasetScalarType})),measures:array(object({id:string,name:string,resultType:datasetScalarType})),relationships:array(object({cardinality:literal("one_to_one","one_to_many","many_to_one","many_to_many"),fromFieldId:string,id:string,toFieldId:string})),version:literal(1)});var datasetBlueprint=object({...base,blueprintVersion:positiveSafeInteger,configuration:optional(jsonObject),definition:datasetDefinition2,kind:literal("datasetBlueprint"),templateFqn:identity});var semanticRole=literal("dimension","effective_time","entity_reference","event_time","identity","measure","status");var hint=object({role:semanticRole});var datasetTableTemplate=object({...base,admittedIngestionModes:array(literal("append","replace","upsert")),compatibleProviderFqns:strings,configuration:schema,identity:object({keyRoles:array(semanticRole),uniqueness:literal("append_only","key","none")}),indexHints:array(hint),kind:literal("datasetTableTemplate"),partitionHints:array(hint),physicalCode:literal("evt","fact","gen","snap","stat","ts"),requirements:schema,semanticRoles:array(semanticRole)});var workflowBindingKey=(binding)=>canonicalJson({path:binding.path,target:binding.target});var renderWorkflowBinding=(binding)=>`${binding.target}:${binding.path.join(".")}`;var isConnectionCount=(value)=>value===undefined||value===null||Number.isSafeInteger(value)&&value>=0;var workflowPortPolicyViolation=(port)=>{if(!isConnectionCount(port.minConnections)||!isConnectionCount(port.maxConnections)){return"connection counts must be non-negative integers"}const max=port.maxConnections===undefined?1:port.maxConnections;if(max!==null&&(port.minConnections??0)>max){return"minConnections cannot exceed maxConnections"}if(port.allowedTemplateKinds?.length===0){return"allowedTemplateKinds cannot be empty"}if(port.allowedTemplateFqns?.length===0){return"allowedTemplateFqns cannot be empty"}if(port.schemaResolution?.variants.length===0){return"schemaResolution requires variants"}return};var firstDuplicate=(values)=>values.find((value,index)=>values.indexOf(value)!==index);var workflowEditorViolation=(editor)=>{const sections=editor.form?.sections??[];const duplicateSection=firstDuplicate(sections.flatMap((section)=>section.id===undefined?[]:[section.id]));if(duplicateSection!==undefined){return`workflow editor section id '${duplicateSection}' is not unique`}const fields=sections.flatMap((section)=>section.fields??[]);const keys=fields.map((field)=>workflowBindingKey(field.binding));const duplicateField=fields.find((field,index)=>keys.indexOf(workflowBindingKey(field.binding))!==index);if(duplicateField!==undefined){return`workflow editor binding ${renderWorkflowBinding(duplicateField.binding)} is not unique`}for(const field of fields){const references=[...(field.visibleWhen??[]).map((rule)=>rule.binding),...field.optionSource?.kind==="remote"?field.optionSource.dependsOn:[]];const dangling=references.find((reference)=>!keys.includes(workflowBindingKey(reference)));if(dangling!==undefined){return`workflow editor field ${renderWorkflowBinding(field.binding)} references unknown binding ${renderWorkflowBinding(dangling)}`}}return};var dynamicPort=object({configPath:string,defaultIdPath:optString,idPath:string,requiredPath:optString,schemaPath:optString});var fieldBinding=object({path:pathParts,target:literal("input_binding","parameter")});var nonNegativeInteger=(value,path)=>{const parsed=number(value,path);return Number.isSafeInteger(parsed)&&parsed>=0?parsed:invalid(path)};var optionSource=union(object({kind:literal("static"),options:array(object({label:localized,value:json}))}),object({clearOnDependencyChange:boolean,dependsOn:array(fieldBinding),kind:literal("remote"),operationId:string,searchable:boolean}));var editorField=object({binding:fieldBinding,fieldConfig:optional(jsonObject),fieldFqn:optString,fieldVersion:optString,help:optional(localized),label:optional(localized),optionSource:optional(optionSource),order:optNumber,placeholder:optional(localized),readOnly:optBoolean,required:optBoolean,resolutionPhase:literal("runtime","structural"),sensitive:optBoolean,valueSources:array(literal("expression","fixed","literal","mapping","model","system")),visibleWhen:optional(array(object({binding:fieldBinding,operator:literal("equals","in","is_not_set","is_set","not_equals"),value:optional(json)}))),widget:optional(literal(...WorkflowEditorWidgets))});var templateKind=literal(...WorkflowTemplateKinds);var nodePort=refine(object({allowedTemplateFqns:optStrings,allowedTemplateKinds:optional(array(templateKind)),direction:literal("input","output"),key:string,maxConnections:optional(nullable(nonNegativeInteger)),minConnections:optional(nonNegativeInteger),schemaResolution:optional(object({configPath:pathParts,variants:array(object({schema,schemaInjections:optional(array(object({configPath:pathParts,schemaPath:pathParts}))),when:json}))})),valueSchema:schema}),workflowPortPolicyViolation);var eventSelectorProjection=union(object({required:optBoolean,sourcePath:pathParts,targetPath:pathParts}),object({targetPath:pathParts,value:json}));var eventIngress=object({acquisitionMode:string,callbackPathPath:optional(pathParts),connectionIdPath:optional(pathParts),eventKind:string,listener:object({fqn:string,version:string}),requiredConfigPaths:optional(array(pathParts)),requiredListener:optBoolean,selector:array(eventSelectorProjection)});var triggerActivation=union(object({eventIngress,kind:literal("event")}),union(object({invocationRole:optional(literal("application","user")),kind:literal("manual"),lifecycleAdapterId:optString,triggerRefPath:optional(pathParts)}),object({kind:literal("schedule")})));var parseWorkflowReusableDependency=(value)=>object({inputContractPath:pathParts,modePath:optional(pathParts),targetWorkflowFqnPath:optional(pathParts),targetWorkflowIdPath:pathParts})(value,"/reusableDependency");var nodeContract=object({capabilityComposition:optional(object({capability:string,fragments:strings,selector:object({path:pathParts,target:literal("parameter")})})),configSchema:optional(schema),connectionRequirements:optional(array(object({cardinality:literal("many","one"),connectionTemplateFqns:refine(strings,(fqns)=>fqns.length===0?"connectionTemplateFqns cannot be empty":undefined),key:string,required:boolean,selector:object({path:pathParts,target:literal("parameter")})}))),dynamicPorts:optional(object({input:optional(dynamicPort),output:optional(dynamicPort)})),editor:optional(refine(object({form:optional(object({sections:optional(array(object({fields:optional(array(editorField)),id:optString,order:optNumber,title:optString})))}))}),workflowEditorViolation)),execution:optional(object({itemModes:optional(array(literal("all_items","each_item","single"))),mainOutputPort:optString,repeatable:optBoolean,resumable:optBoolean,sample:optional(json),sideEffect:literal("external","none","read","write"),testable:optBoolean})),implementationId:string,inputSchema:optional(schema),instancePolicy:optional(object({maxInstances:optNumber,minInstances:optNumber,onWorkflowCreate:optBoolean})),nodeCollectionFqn:optString,nodeCollectionVersion:optString,outputChannels:optional(array(object({adapterId:string,cardinality:literal("many","one"),deliveryMode:literal("asynchronous","synchronous"),key:string,required:boolean,valueSchema:schema}))),outputSchema:optional(schema),ports:optional(array(nodePort)),reusableDependency:optional(parseWorkflowReusableDependency),triggerActivation:optional(triggerActivation)});var fieldContract=object({availableForInput:optBoolean,availableForOutput:optBoolean,clearOnDependencyChange:optBoolean,optionDependencies:optional(array(object({path:pathParts,target:literal("parameter","part","value")}))),user:optional(object({multiple:boolean})),valueSchema:optional(schema)});var graphSchema=object({bindings:optional(array(object({extensions:jsonObject}))),fieldProjections:array(object({source:pathParts,target:pathParts})),schema});var graphBoundary=object({templateFqn:string,templateVersion:string});var graph=object({edges:array(object({extensions:optional(jsonObject),id:string,source:string,target:string})),inputBoundary:graphBoundary,inputContract:graphSchema,metadata:object({description:nullable(string),tags:strings,templateSource:nullable(string)}),nodes:array(object({extensions:optional(jsonObject),id:string,templateFqn:string,templateVersion:string})),outputBoundary:graphBoundary,outputContract:graphSchema,triggers:array(object({config:object({extensions:optional(jsonObject)}),id:string,inputBindings:record(string),invocation:object({mode:literal("attach","detach"),timeoutMs:nullable(number)}),metadata:object({fieldDisplayValues:record(string)}),settings:object({enabled:boolean}),templateFqn:string,templateVersion:string})),version:literal(1)});var uiLayout=object({edges:record(object({extensions:optional(jsonObject)})),nodes:record(object({position:optional(object({x:number,y:number}))})),version:literal(1),viewport:nullable(object({x:number,y:number,zoom:number}))});var bindingSpan=object({end:number,start:number});var bindingSource=object({kind:literal("input","loop_index","loop_item","merge_output","node_output","port_arrival","run","scope","trigger"),mergeId:optional(nullable(string)),nodeId:optional(nullable(string)),portId:optional(nullable(string)),selection:optional(nullable(object({ancestry:literal("nearest_dominating_ancestor"),iteration:literal("aggregate","previous_iteration","same_iteration")})))});var bindingExpression=(value,path)=>{const{kind}=object({kind:string})(value,path);switch(kind){case"array":{return object({items:array(bindingExpression),kind:literal("array")})(value,path)}case"call":{return object({args:array(bindingExpression),kind:literal("call"),name:string})(value,path)}case"interpolation":{return object({kind:literal("interpolation"),parts:array(bindingExpression),span:optional(nullable(bindingSpan))})(value,path)}case"literal":{return object({kind:literal("literal"),value:json})(value,path)}case"object":{return object({fields:record(bindingExpression),kind:literal("object")})(value,path)}case"operator":{return object({args:array(bindingExpression),kind:literal("operator"),op:string})(value,path)}case"ref":{return object({kind:literal("ref"),onUnavailable:object({kind:literal("error","fallback","null"),value:optional(nullable(bindingExpression))}),path:pathParts,source:bindingSource,span:optional(nullable(bindingSpan))})(value,path)}default:{return invalid(`${path}/kind`)}}};var authoredValue=union(object({mode:literal("fixed"),value:json}),object({compiled:optional(nullable(bindingExpression)),languageVersion:literal(1),mode:literal("expression"),source:string}));var nodeExecutionSettings=object({dryRun:optional(object({mode:literal("allow","block_side_effects")})),idempotencyKey:optional(nullable(bindingExpression)),onError:optional(object({mode:literal("continue","fail_run")})),retry:optional(object({backoffMs:optional(nullable(number)),maxAttempts:optional(nullable(number)),mode:literal("disabled","exponential","fixed")})),timeoutMs:optional(nullable(number))});var authoringTemplateRef=object({templateFqn:string,templateVersion:string});var authoringFieldProjection=object({fieldConfig:optional(jsonObject),fieldFqn:string,fieldVersion:string,path:strings});var authoringInputContract=object({fieldProjections:optional(array(authoringFieldProjection)),jsonSchema:jsonObject});var authoringOutputContract=object({bindings:array(object({key:string,kind:literal("artifact","value"),value:bindingExpression})),fieldProjections:optional(array(authoringFieldProjection)),jsonSchema:jsonObject});var inputEndpoint=object({kind:literal("input_node"),portId:string});var actionEndpoint=object({kind:literal("action_node"),nodeId:string,portId:string});var triggerEndpoint=object({kind:literal("trigger_node"),portId:string,triggerId:string});var outputEndpoint=object({kind:literal("output_node"),portId:string});var authoringDefinition=object({dataAccess:readDataAccess("workflow"),edges:array(object({id:string,source:union(union(actionEndpoint,inputEndpoint),triggerEndpoint),target:union(union(actionEndpoint,inputEndpoint),outputEndpoint)})),inputBoundary:authoringTemplateRef,inputContract:authoringInputContract,metadata:jsonObject,nodes:array(object({config:record(authoredValue),extensions:optional(jsonObject),id:string,inputs:record(authoredValue),metadata:jsonObject,settings:nodeExecutionSettings,templateFqn:string,templateVersion:string,uid:optString})),outputBoundary:authoringTemplateRef,outputContract:authoringOutputContract,triggers:array(object({config:jsonObject,id:string,inputBindings:record(object({overridePolicy:literal("caller_may_override","locked"),value:authoredValue})),invocation:object({mode:literal("attach","await_result","detach"),timeoutMs:optional(nullable(number))}),metadata:studioTriggerMetadata(jsonObject),settings:jsonObject,templateFqn:string,templateVersion:string})),version:literal(1)});var onlyKeys2=(...keys)=>(value)=>Object.keys(value).some((key)=>!keys.includes(key))?"unexpected member":undefined;var remoteDeletion=union(refine(object({capability:literal("full")}),onlyKeys2("capability")),refine(object({capability:literal("full_and_delta"),feed:literal("server_filtered","client_filtered")}),onlyKeys2("capability","feed")));var usesBindings=refine(array(union(identity,refine(object({approval:optional(union(literal("always","never"),object({rule:identity}))),description:optional(identity),fqn:identity,name:optional(identity),settings:optional(jsonObject)}),onlyKeys2(...usesBindingKeys)))),(bindings)=>duplicateUsesBinding(bindings)===undefined?undefined:"duplicate binding");var bindingSettingsForm=(value,path)=>{const read=form(value,path);assertNoHostKeys(read,`Invalid package manifest at ${path}/schema/document`);return read};var withoutRetiredRelationFields=(read)=>(value,path)=>{const declaration=read(value,path);if("relationFields"in declaration){throw new TypeError(`Invalid package manifest at ${path}/relationFields: relationFields is no longer supported; rebuild the package with the current extensions SDK, which declares Entity Relation Fields in fieldSemantics`)}return declaration};var withoutRetiredAgentFields=(agent)=>["invokingApplicationFqns","modelPreset"].find((field)=>(field in agent));var webhookHandshake=union(object({kind:literal("echo_query_parameter"),parameter:identity}),union(object({kind:literal("echo_query_parameter_with_verify_token"),parameter:identity,tokenParameter:identity}),object({field:identity,kind:literal("echo_json_body_field"),when:object({equals:string,field:identity})})));var localMethod=varyingObject({domains:optional(varyingStrings),enabled:boolean});var media=varyingObject({media:string});var organizationSettingsSso=object({...varyingFields({connection:varyingObject({setupKey:identity}),defaultProfile:optional(identity),domains:varyingStrings,enabled:boolean,provisionMembers:boolean}),provider:union(object({fqn:identity}),varyingObject({providerId:identity}))});var organizationInstructions=object(varyingFields({...base,answerLength:optString,bannedQuestions:optString,enabled:optBoolean,kind:literal("organizationInstructions"),lifecycle,otherInstructions:optString,toneOfVoice:optString}));var organizationSettings=object({...varyingFields({...base,branding:optional(varyingObject({cover:optional(media),icon:optional(media),logo:optional(media)})),governance:optional(varyingObject({accessAuditRetentionMonths:optional(positiveSafeInteger),maxGroupHierarchyDepth:optional(positiveSafeInteger)})),identity:optional(varyingObject({companyDomains:optional(varyingStrings),name:optString})),kind:literal("organizationSettings"),lifecycle,locale:optional(varyingObject({defaultLanguage:optString,languages:optional(varyingStrings),timezone:optString}))}),authentication:varyingStructure(optional(object({...varyingFields({applicationConsent:optional(literal("ask","skip")),otp:optional(localMethod),password:optional(localMethod)}),sso:varyingStructure(optional(array(varyingStructure(organizationSettingsSso))))})))});var documentFolder=union(refine(varyingObject({drive:identity,folders:varyingArray(identity)}),onlyKeys2("drive","folders")),refine(varyingObject({remoteId:identity}),onlyKeys2("remoteId")));var documentCollection=(value,path)=>{const declaration=varyingObject({...base,audience:optional(readAccessAudience),connection:connection2,connectorFqn:optional(identity),excludedFolderNames:optional(varyingStrings),indexContent:optBoolean,indexOverview:optBoolean,kind:literal("documentCollection"),overviewInputMaxChars,remoteRoots:varyingArray(documentFolder),richEnrichment,syncEnabled:optBoolean,title:identity})(value,path);return declaration};var subgroups=(value,path)=>optional(array(object({description:optString,displayName:string,key:string,subgroups})))(value,path);var agentContent={activity:optional(object({heartbeat:boolean,schedule:boolean})),audience:optional(readAccessAudience),behavioralBoundaries:strings,bypassOrganizationInstructions:optional(boolean),dataAccess:readDataAccess("agent"),maxSteps:optional(positiveSafeInteger),metadata:optional(studioAgentMetadata(jsonObject)),modelTier:optional(literal(...agentModelTiers)),objectives:strings,operatingInstructions:string,output:optional(object({schema})),responsibility:string,uses:object({skills:usesBindings,tools:usesBindings})};var skillContent={audience:optional(readAccessAudience),dataAccess:readDataAccess("skill"),instructions:string,uses:object({tools:usesBindings})};var nonNegativeInteger2=refine(number,(value)=>Number.isSafeInteger(value)&&value>=0?undefined:"not a non-negative integer");var nonNegativeNumber=refine(number,(value)=>value>=0?undefined:"negative");var recordOf=(keys,read)=>refine(record(read),onlyKeys2(...keys));var runIdentity=union(refine(object({mode:literal("triggering_user")}),onlyKeys2("mode")),refine(object({mode:literal("service_principal"),servicePrincipal:identity}),onlyKeys2("mode","servicePrincipal")));var workflowContent={audience:optional(readAccessAudience),dataAccess:readDataAccess("workflow"),definition:authoringDefinition,name:string,runDetailsRetention:optional(literal("full","outcome_only")),runIdentity:optional(runIdentity),slug:string,uses:optional(object({connections:refine(array(union(identity,object({fqn:identity,scope:optional(literal("user"))}))),(connections)=>duplicateUsesConnection(connections)===undefined?undefined:"duplicate connection")}))};var primitives={...accessPrimitives,agent:withoutKeys(["skills","tools"],refine(object({...base,...agentContent,kind:literal("agent"),lifecycle}),withoutRetiredAgentFields)),automationLimits:refine(object({...base,budgetProfile:optional(identity),kind:literal("automationLimits"),lifecycle,maxActiveTriggers:optional(nonNegativeInteger2),maxPersonalItems:optional(recordOf(definitionKinds,nonNegativeInteger2))}),automationFqnViolation("automationLimits")),connection,connectionInstance:substituted(varyingObject({...base,audience:optional(readAccessAudience),credentials:jsonObject,kind:literal("connectionInstance"),lifecycle,templateFqn:identity})),datasetBlueprint,datasetConnectorInstance,datasetParser:object({...base,extensions:array(identity),format:datasetParserFormat,kind:literal("datasetParser"),mediaTypes:array(identity),parserVersion:datasetParserVersion}),datasetTableTemplate,documentCollection,documentsConnector:object({...base,connectionRefs,kind:literal("documentsConnector"),providerDisplayName:optional(identity),providerFamily:identity}),domain:object({...base,kind:literal("domain"),lifecycle,localMutationPolicy:optional(mutationPolicy),versioningEnabled:nullable(boolean)}),domainTemplate:withoutRetiredRelationKey(object({...base,catalogTags,domainFqn:string,domainName:string,entitySchemaFqns:strings,kind:literal("domainTemplate")}),"relationSchemaFqns"),emailProvider:object({...base,connectionTemplateFqn:identity,deploymentIdentity:optional(union(literal("aws"),literal("azure"))),kind:literal("emailProvider"),senderKind:literal("address","mailbox")}),eventListener:object({...base,capabilities:array(literal("internal","poll","webhook")),eventKind:string,kind:literal("eventListener"),manualWebhookState:optional(object({keyFamily:identity,stateKey:identity})),messaging:optional(object({connectionTemplateFqn:identity,contractVersion:literal(1),service:identity})),receiveModeField:optional(identity),runtimeState:optional(array(object({keyFamily:string,stateKey:string}))),safeOccurrenceFields:optStrings,safeSelectorFields:optStrings,sourceScope:optional(literal("connection","selector")),webhookAcknowledgement:optional(object({status:literal(200,204)})),webhookHandshake:optional(webhookHandshake),webhookRegistration:optional(literal("listener"))}),externalAppGateway:readExternalAppGateway,externalApplication:substituted(withoutKeys(["audience"],refine(object({...varyingFields({...base,allowedOrigins:varyingStrings,applicationConsent:optional(literal(...externalApplicationConsents)),applicationType:literal("confidential","public"),kind:literal("externalApplication"),lifecycle,oauthAudience:string,postLogoutRedirectUris:varyingStrings,primaryRedirectUri:optString,redirectUris:varyingStrings,setupInstructions:optString}),capabilities:optional(applicationCapabilityNodes)}),externalApplicationViolation))),externalDatasetProvider:object({...base,capabilities:datasetCapabilities,connectionTemplateFqns:strings,kind:literal("externalDatasetProvider"),sourceCapabilities:optional(array(object({capabilities:datasetCapabilities,datasetOpaqueIdPrefix:string})))}),fieldTransformer:object({...base,kind:literal("fieldTransformer"),sourceFieldType:string,targetFieldType:string}),knowledgeConnector:withoutRetiredRelationKey(object({...base,autoActivate:optBoolean,autoInstantiate:optBoolean,bindingScopes:optional(bindingScopes),connectionRefs,contributions:optional(array(object({capabilityFqn:string,connectionSlot:string,connectionTemplateFqn:string,controlFqn:optString,displayName:string,fqn:identity,metadata:optional(jsonObject)}))),defaultOutboundStrategy:optional(outboundStrategy),defaultUpdateMode:optional(updateMode),deltaOverlapSeconds:optional(positiveSafeInteger),discoveryDefaults:optional(discoveryDefaults),entityIdentityMode:optional(literal("adapter","item_metadata")),entitySchemaCapabilities:optional(array(entityCapability)),isSingleton:optBoolean,kind:literal("knowledgeConnector"),outboundCapability:optional(literal("declared_and_enablable","none")),pullPageSize:optional(positiveSafeInteger),recommendedImportSchedules:predefinedSchedules,remoteDeletion:optional(remoteDeletion),remoteReference:optional(object({providerKey:identity,urlTemplate:knowledgeRemoteReferenceUrlTemplate})),settings:optional(form),supportedBindingModes:optional(bindingModes)}),"relationSchemaCapabilities"),knowledgeConnectorInstance,knowledgeConnectorOauth:object({...base,connectorFqn:string,kind:literal("knowledgeConnectorOauth")}),knowledgeEntityAdapter:object({...base,connectorFqn:string,entitySchemaFqn:string,kind:literal("knowledgeEntityAdapter"),normalizesFieldMapValues:optBoolean,normalizesImportedData:optBoolean}),knowledgeEntitySchema:withoutRetiredRelationFields(object({...base,...knowledgeSchema,autocompleteConfiguration,defaultSyncDirection:optString,deletionMode:optString,displayDefaults:optional(object({collections:optStrings,details:optStrings})),displayNameExpression:nullable(string),embedEntities:optBoolean,embeddingConfig:nullable(jsonObject),extendsSchemaFqn:optString,kind:literal("knowledgeEntitySchema"),lifecycle,maxVersionsExpirationDays:optional(nullable(number)),overviewInputMaxChars,persistFullFieldContributions:boolean,richEnrichment,syncable:optBoolean,usableAsDocumentScope:boolean,versioned:optBoolean,versioningEnabled:nullable(boolean)})),managedDatasetProvider:object({...base,capabilities:datasetCapabilities,connectionTemplateFqns:strings,kind:literal("managedDatasetProvider")}),notificationChannel:object({...base,credential:optional(form),definition:notificationDefinition,kind:literal("notificationChannel")}),organizationGroup:refine(object({...base,kind:literal("organizationGroup"),lifecycle,parent:optional(identity),subgroups}),organizationGroupViolation),organizationInstructions:substituted(refine(organizationInstructions,organizationInstructionsViolation)),organizationSettings:substituted(refine(organizationSettings,organizationSettingsViolation)),organizationSso:object({...base,connectionTemplateFqn:string,kind:literal("organizationSso"),providerId:string,requiredCredentialFields:strings,secretCredentialFields:optStrings,setupGuide:optional(array(object({locale:string,markdown:string})))}),outboundMessagingProvider:object({...base,connectionTemplateFqn:identity,kind:literal("outboundMessagingProvider"),service:identity}),packageSource:refine(object({...base,deployMode:literal(...packageSourceDeployModes),kind:literal("packageSource"),lifecycle,packageFqn:identity,path:identity,repositoryLink:identity,scope:literal(...automationTypes)}),automationFqnViolation("packageSource")),placementRule:refine(object({...base,automationKind:literal(...definitionKinds),folderPattern:optional(identity),kind:literal("placementRule"),lifecycle,order:nonNegativeInteger2,packageSource:identity,scope:literal(...automationTypes)}),automationFqnViolation("placementRule")),remoteToolCollection:refine(object({...base,category:optString,gatewayRef:identity,kind:literal("remoteToolCollection"),operationReferences:strings}),remoteToolCollectionViolation),repositoryLink:refine(object({...base,connection:identity,defaultBranch:identity,kind:literal("repositoryLink"),lifecycle,provider:identity,repository:identity}),automationFqnViolation("repositoryLink")),reviewPolicy:refine(object({...base,approvalRule:optional(identity),kind:literal("reviewPolicy"),lifecycle,thresholds:optional(recordOf(reviewKpis,nonNegativeNumber))}),automationFqnViolation("reviewPolicy")),servicePrincipal:object({...base,audience:optional(readAccessAudience),groups:array(identity),kind:literal("servicePrincipal")}),skill:withoutKeys(["tools"],object({...base,...skillContent,kind:literal("skill"),lifecycle})),skillTemplate:object({...base,catalogTags,kind:literal("skillTemplate"),lifecycle:optional(lifecycle),name:string}),studioApp:studioAppDeclaration,studioAppTemplate:object({...base,definition:studioAppTemplate,kind:literal("studioAppTemplate")}),studioComponent:object({...base,category:literal("layout","page","primitive","view","widget"),composition:optional(object({extensions:optional(jsonObject),slotSource:literal("props","static"),slots:array(object({extensions:optional(jsonObject),key:string,label:optional(localized)}))})),kind:literal("studioComponent"),propsSchema:schema,sourceRef:string}),tool:object({...base,allowMultipleSkillBindings:optBoolean,audience:optional(readAccessAudience),autoActivate:optBoolean,autoInstantiate:optBoolean,bindingScopes:optional(bindingScopes),bindingSettings:optional(bindingSettingsForm),capabilityType:optional(literal("delegate","external","read","write")),category:optString,connectionRefs,effectKind:literal("mutation","read_only"),extraLoaders:optional(array(object({bindingName:string,inheritBindingSettings:optBoolean,toolFqn:string}))),healthCheck:optional(object({capabilities:optStrings,description:string})),input:schema,isSingleton:optBoolean,kind:literal("tool"),output:schema,sample:optional(json),settings:optional(form),setupInstructions:optional(object({links:strings,markdown:string})),toolCollectionFqns:optStrings,toolGuidance:optional(object({inputRequirementsSummary:optString,useWhen:optString})),usageScopes:optional(array(literal("automation","chat","skill")))}),toolCollection:withoutKeys(["audience"],object({...base,category:optString,kind:literal("toolCollection"),toolFqns:strings})),toolSettingsOptions:object({...base,catalogCollection:optString,catalogConnectionSlots:optStrings,connectionSlots:optStrings,dependencies:optStrings,fieldKey:string,formTarget:optional(literal("binding","settings")),includeUnavailableSelectedOptions:optBoolean,kind:literal("toolSettingsOptions"),toolFqn:string}),workflow:withoutKeys(["servicePrincipalFqn"],refine(object({...base,...workflowContent,kind:literal("workflow"),lifecycle}),(workflow)=>{workflowDataAccess(workflow.dataAccess,workflow.definition.dataAccess,`workflow:${workflow.fqn}`)})),workflowField:object({...base,collectionFqn:string,collectionVersion:string,contract:fieldContract,kind:literal("workflowField"),presentation:optional(object({placeholder:optString,widget:optString}))}),workflowFieldCollection:object({...base,contract:object({weight:number}),kind:literal("workflowFieldCollection"),presentation:optional(object({categoryPath:strings,label:localized}))}),workflowNode:object({...base,audience:optional(readAccessAudience),contract:nodeContract,kind:literal("workflowNode"),nodeKind:literal("action","input","output","trigger"),presentation:optional(object({categoryPath:optStrings,tags:optStrings}))}),workflowNodeCollection:object({...base,audience:optional(readAccessAudience),contract:object({collection:optional(object({parentFqn:string,parentVersion:string,weight:number}))}),kind:literal("workflowNodeCollection"),presentation:optional(object({categoryPath:strings}))}),workflowTemplate:object({...base,catalogTags,category:string,definition:graph,kind:literal("workflowTemplate"),lifecycle,name:string,requiredSkills:strings,requiredTools:strings,skillSlots:strings,slug:string,uiLayout:nullable(uiLayout)})};var retiredRelationKinds=new Set(["knowledgeRelationAdapter","knowledgeRelationSchema"]);var renamedKeys=new Map([["accessProfile",[["audience","appliesTo"]]],["agent",[["skills","uses.skills"],["tools","uses.tools"]]],["externalApplication",[["audience","oauthAudience"]]],["skill",[["tools","uses.tools"]]],["workflow",[["servicePrincipalFqn","runIdentity"]]]]);var repeatedIds=(ids,path,label)=>ids.flatMap((id,index)=>ids.indexOf(id)===index?[]:[{message:`${label} '${id}' is declared more than once`,path:path(index)}]);var workflowGraphIssues=(graph,path)=>{const nodeIds=new Set(graph.nodes.map(({id})=>id));const triggerIds=new Set(graph.triggers.map(({id})=>id));const missing=(endpoint,pointer)=>{if(endpoint.kind==="action_node"&&!nodeIds.has(endpoint.nodeId)){return[{message:`edge ends at node '${endpoint.nodeId}', which the graph does not declare`,path:`${pointer}/nodeId`}]}if(endpoint.kind==="trigger_node"&&!triggerIds.has(endpoint.triggerId)){return[{message:`edge starts at trigger '${endpoint.triggerId}', which the graph does not declare`,path:`${pointer}/triggerId`}]}return[]};return[...repeatedIds(graph.nodes.map(({id})=>id),(index)=>`${path}/nodes/${index}/id`,"node"),...repeatedIds(graph.triggers.map(({id})=>id),(index)=>`${path}/triggers/${index}/id`,"trigger"),...repeatedIds(graph.edges.map(({id})=>id),(index)=>`${path}/edges/${index}/id`,"edge"),...graph.edges.flatMap((edge,index)=>[...missing(edge.source,`${path}/edges/${index}/source`),...missing(edge.target,`${path}/edges/${index}/target`)])]};var readerPath=/^Invalid package manifest at (?<path>\S*?)(?:: (?<detail>.*))?$/su;var locationPath=/^(?<path>\/\S*?): (?<detail>.*)$/su;var issueOf=(error)=>{const groups=(readerPath.exec(error.message)??locationPath.exec(error.message))?.groups;return{message:groups?.detail??(groups===undefined?error.message:"is not a valid value"),path:groups?.path??""}};var validator=(check)=>(definition)=>{try{assertDenseArrays(definition,"",new WeakSet);const portable=check.read(parseJsonObject(canonicalJson(definition)),"");const[first,...rest]=check.issues(portable);return first===undefined?{definition:portable,valid:true}:{issues:[first,...rest],valid:false}}catch(error){if(!(error instanceof TypeError)){throw error}return{issues:[issueOf(error)],valid:false}}};var validators={agent:validator({issues:()=>[],read:object({...agentContent,lifecycle:optional(lifecycle)})}),skill:validator({issues:()=>[],read:object({...skillContent,lifecycle:optional(lifecycle)})}),workflow:validator({issues:(workflow)=>{workflowDataAccess(workflow.dataAccess,workflow.definition.dataAccess,"workflow definition");return workflowGraphIssues(workflow.definition,"/definition")},read:object({...workflowContent,lifecycle:optional(lifecycle)})})};var validateDefinition=(kind,definition)=>validators[kind](definition);var automationDocumentFileNames=["agent.json","automation.json","instructions.md","SKILL.md","skill.json","workflow.json"];var defaultLifecycle={deployMode:"upsert",readonly:true};var fqnSegments={agent:"agents",skill:"skills",workflow:"workflows"};var slugPattern=/^[a-z0-9]+(?:-[a-z0-9]+)*$/u;var readEnvelope=object({kind:literal(...definitionKinds),slug:refine(string,(slug)=>slugPattern.test(slug)?undefined:"slug is not kebab-case"),title:identity});var fail=(folder,message)=>{throw new TypeError(`${folder}: ${message}`)};var isFileName=(name)=>automationDocumentFileNames.some((known)=>known===name);var foldersOf=(files)=>{const folders=new Map;for(const[path,text]of Object.entries(files)){const[folder,name,...deeper]=path.split("/");if(folder!==undefined&&name!==undefined&&deeper.length===0&&isFileName(name)){folders.set(folder,{...folders.get(folder),[name]:text})}}return folders};var textOf=(folder,files,name)=>files[name]??fail(folder,`${name} is missing`);var jsonObjectOf=(folder,name,text)=>{if(text===undefined){return{}}try{return parseJsonObject(text)}catch{return fail(folder,`${name} is not a JSON object`)}};var withText=(folder,structured,structuredName,text)=>(text.field in structured)?fail(folder,`${structuredName} and ${text.file} both hold ${text.field}; keep it in ${text.file}`):{...structured,[text.field]:text.value};var definitionOf=(folder,files,{kind,slug,title})=>{switch(kind){case"agent":{return withText(folder,jsonObjectOf(folder,"agent.json",textOf(folder,files,"agent.json")),"agent.json",{field:"operatingInstructions",file:"instructions.md",value:textOf(folder,files,"instructions.md")})}case"skill":{return{uses:{tools:[]},...withText(folder,jsonObjectOf(folder,"skill.json",files["skill.json"]),"skill.json",{field:"instructions",file:"SKILL.md",value:textOf(folder,files,"SKILL.md")})}}case"workflow":{return{name:title,slug,...jsonObjectOf(folder,"workflow.json",textOf(folder,files,"workflow.json"))}}default:{const exhaustive=kind;return exhaustive}}};var envelopeOf=(folder,files)=>{const automation=jsonObjectOf(folder,"automation.json",textOf(folder,files,"automation.json"));try{return readEnvelope(automation,"")}catch(error){if(error instanceof TypeError){return fail(folder,`automation.json ${issueOf(error).path}`)}throw error}};var componentOf=(folder,files,options)=>{const envelope=envelopeOf(folder,files);const checked=validateDefinition(envelope.kind,definitionOf(folder,files,envelope));if(!checked.valid){return fail(folder,checked.issues.map(({message,path})=>`${path||"(definition)"} ${message}`).join("; "))}return{manifest:primitives[envelope.kind]({lifecycle:options.lifecycle??defaultLifecycle,...checked.definition,displayName:envelope.title,fqn:`${options.packageFqn}.${fqnSegments[envelope.kind]}.${envelope.slug}`,kind:envelope.kind,version:options.version},folder),schemaSidecars:[]}};var automationDocumentComponents=(files,options)=>{for(const name of["packageFqn","version"]){if(options[name].trim()===""){throw new TypeError(`${name} must not be blank`)}}const owners=new Map;return[...foldersOf(files)].sort(([left],[right])=>compareUtf16CodeUnits(left,right)).map(([folder,folderFiles])=>{const component=componentOf(folder,folderFiles,options);const{fqn}=component.manifest;const owner=owners.get(fqn);if(owner!==undefined){return fail(folder,`'${fqn}' is declared more than once, also by ${owner}`)}owners.set(fqn,folder);return component})};var automationDocumentSchemaVersion=1;var documentFolder2="document";var documentMembers=(value)=>parseJsonObject(canonicalJson(value));var documentJson=(value)=>`${JSON.stringify(JSON.parse(canonicalJson(value)),null,2)}
|
|
3
3
|
`;var emptySkillMembers=canonicalJson({uses:{tools:[]}});var agentFiles=(definition)=>{const{operatingInstructions,...members}=definition;return{"agent.json":documentJson(documentMembers(members)),"instructions.md":operatingInstructions}};var skillFiles=(definition)=>{const{instructions,...members}=definition;const instructed={"SKILL.md":instructions};return canonicalJson(members)===emptySkillMembers?instructed:{...instructed,"skill.json":documentJson(documentMembers(members))}};var workflowFiles=(definition,envelope)=>{const{name,slug,...members}=definition;const written=documentMembers(members);const named=name===envelope.title?written:{...written,name};const identified=slug===envelope.slug?named:{...named,slug};return{"workflow.json":documentJson(identified)}};var readFullEnvelope=object({authority:optional(literal("database","repository")),baseHash:optional(nullable(string)),kind:literal(...definitionKinds),remoteId:optional(nullable(string)),revision:optional(nullable(number)),schemaVersion:optional(literal(automationDocumentSchemaVersion)),slug:refine(string,(slug)=>slugPattern.test(slug)?undefined:"slug is not kebab-case"),title:identity});var writeAutomationDocument=(document)=>{const{envelope}=document;const written={...document.extra,"automation.json":documentJson({authority:envelope.authority??"database",baseHash:envelope.baseHash??null,kind:document.kind,remoteId:envelope.remoteId??null,revision:envelope.revision??null,schemaVersion:automationDocumentSchemaVersion,slug:envelope.slug,title:envelope.title})};switch(document.kind){case"agent":{return{...written,...agentFiles(document.definition)}}case"skill":{return{...written,...skillFiles(document.definition)}}case"workflow":{return{...written,...workflowFiles(document.definition,envelope)}}default:{return document}}};var readAutomationDocument=(files)=>{const folder=Object.fromEntries(Object.entries(files).filter(([name])=>isFileName(name)));const extra=Object.fromEntries(Object.entries(files).filter(([name])=>!isFileName(name)&&name!=="automation.json"));const raw=(()=>{try{return readFullEnvelope(jsonObjectOf(documentFolder2,"automation.json",textOf(documentFolder2,folder,"automation.json")),"")}catch(error){if(error instanceof TypeError){return fail(documentFolder2,`automation.json ${issueOf(error).path}`)}throw error}})();const envelope={authority:raw.authority??"database",baseHash:raw.baseHash??null,remoteId:raw.remoteId??null,revision:raw.revision??null,schemaVersion:automationDocumentSchemaVersion,slug:raw.slug,title:raw.title};const json=definitionOf(documentFolder2,folder,{kind:raw.kind,slug:raw.slug,title:raw.title});const failed=(issues)=>fail(documentFolder2,issues.map(({message,path})=>`${path||"(definition)"} ${message}`).join("; "));switch(raw.kind){case"agent":{const checked=validateDefinition("agent",json);return checked.valid?{definition:checked.definition,envelope:{...envelope,kind:"agent"},extra,kind:"agent"}:failed(checked.issues)}case"skill":{const checked=validateDefinition("skill",json);return checked.valid?{definition:checked.definition,envelope:{...envelope,kind:"skill"},extra,kind:"skill"}:failed(checked.issues)}case"workflow":{const checked=validateDefinition("workflow",json);return checked.valid?{definition:checked.definition,envelope:{...envelope,kind:"workflow"},extra,kind:"workflow"}:failed(checked.issues)}default:{return raw.kind}}};var automationDocumentHash=(files)=>{const{kind,slug,title}=readFullEnvelope(jsonObjectOf(documentFolder2,"automation.json",textOf(documentFolder2,files,"automation.json")),"");const payload=Object.entries(files).filter(([name])=>name!=="automation.json").sort(([left],[right])=>compareUtf16CodeUnits(left,right)).map(([name,text])=>`${name}
|
|
4
4
|
${text.length}
|
|
5
5
|
${text}`);return sha256Hex([canonicalJson({kind,slug,title}),...payload].join(`
|