@collective-intelligence/extensions-sdk-frontend 0.1.12 → 0.1.13

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.
Files changed (2) hide show
  1. package/dist/index.js +2 -2
  2. package/package.json +2 -2
package/dist/index.js CHANGED
@@ -1,2 +1,2 @@
1
- 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 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 plainFormWidgets=["checkbox","color","date","date_range","datetime","email","file","hidden","number","password","structured_file_preview","switch","text","textarea","variable_references"];var selectFormWidgets=["folders_explorer","multi_select","radio","select"];var packageVariableTypes=["string","number","boolean","string[]","json","secret"];var isVariableReference=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value)&&Object.keys(value).length===1&&("$variable"in value)&&typeof value.$variable==="string";var isString=(value)=>String(value)===value;var holdsType=(type,value)=>{switch(type){case"boolean":{return Boolean(value)===value}case"json":{return true}case"number":{return Number(value)===value}case"string[]":{return Array.isArray(value)&&value.every(isString)}default:{return isString(value)}}};var packageVariableViolation=(name,declaration)=>{if(!packageVariableTypes.includes(declaration.type)){return`variable '${name}' has the unknown type '${declaration.type}'`}if(!("default"in declaration)||declaration.default===undefined){return}if(declaration.type==="secret"){return`variable '${name}' is a secret and cannot declare a default`}if(!holdsType(declaration.type,declaration.default)){return`variable '${name}' declares a default outside its type '${declaration.type}'`}return};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 hostedIdentity=(value,path)=>{const text=identity(value,path);return text===text.trim()?text:invalid(path)};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 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 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 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",knowledgeRelation:"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 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",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 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 metadata=object({available:boolean,label:string});var connection=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"),providerFamily:string,secretFields:optStrings,testMetadata:optional(metadata)});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 relationCapability=object({...schemaCapability,predefinedBindingParentEntityKey:optString,predefinedBindingRelationImportMode:optional(literal("child_binding","relation_only")),predefinedBindingSourceEntityKey:optString,predefinedBindingTargetEntityKey:optString});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","ends_with","eq","exists","gt","gte","in","is_empty","is_not_empty","lt","lte","ne","nin","not_contains","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,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});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 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 policyRef=(value,path)=>{const{kind}=object({kind:string})(value,path);return kind==="literal"?object({kind:literal("literal"),value:json})(value,path):object({kind:literal("subject","resource"),path:strings})(value,path)};var uuid=(value,path)=>{const parsed=identity(value,path);return/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu.test(parsed)?parsed:invalid(path)};var policyPredicate=(value,path)=>{const{op}=object({op:string})(value,path);switch(op){case"eq":case"neq":case"lt":case"lte":case"gt":case"gte":{return object({left:policyRef,op:literal("eq","neq","lt","lte","gt","gte"),right:policyRef})(value,path)}case"in":{return object({op:literal("in"),set:policyRef,value:policyRef})(value,path)}case"exists":case"is_null":{return object({op:literal("exists","is_null"),ref:policyRef})(value,path)}case"contains":case"starts_with":{return object({op:literal("contains","starts_with"),ref:policyRef,value:policyRef})(value,path)}case"const":{return object({op:literal("const"),value:boolean})(value,path)}case"not":{return object({arg:policyPredicate,op:literal("not")})(value,path)}case"and":case"or":{return object({args:array(policyPredicate),op:literal("and","or")})(value,path)}case"relation_exists":{return object({direction:literal("out","in"),op:literal("relation_exists"),relationSchemaId:uuid})(value,path)}case"relation_field":{return object({direction:literal("out","in"),inner:policyPredicate,op:literal("relation_field"),relationSchemaId:uuid})(value,path)}default:{return invalid(`${path}/op`)}}};var policyBody=object({rule:optional(policyPredicate),subjectMatch:policyPredicate});var policyFields={effect:literal("allow","deny"),policyBody,policyType:literal("filter","gate"),targetFqn:identity,targetKind:literal("entity_domain","entity_schema","relation_domain","relation_schema")};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"),missingConnectorFieldsBehavior:optional(literal("prune","retain")),pushEntityMatch:optional(literal("remote_ref","unique_fields")),schemaFqn:identity,supportedBindingModes:optional(varyingArray(literal("managed","external"))),suppressEntityEvents:optBoolean});var relationBinding=varyingObject({...bindingFields,bindingMode:optional(literal("managed")),relationImportMode:optional(literal("child_binding","relation_only")),relationSchemaFqn:identity,sourceEntityKey:optional(nullable(identity)),targetEntityKey:optional(nullable(identity))});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 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:literal("entity","relation"),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=varyingObject({...base,connections:optional(record(connection2)),dataPolicies:optional(varyingArray(varyingObject({...policyFields,fqn:identity,priority:optNumber}))),enabled:optBoolean,entityBindings:optional(varyingArray(entityBinding)),kind:literal("knowledgeConnectorInstance"),lifecycle,pipelines:optional(varyingArray(pipeline)),relationBindings:optional(varyingArray(relationBinding)),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});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 assertPolicyLifecycle=(policies,path)=>{for(const[index,policy]of policies.entries()){if(Object.keys(policy).some((key)=>key==="lifecycle"||key==="deployMode"||key==="readonly")){invalid(`${path}/dataPolicies/${index}/lifecycle`)}}};var assertPipelineTasks=(item,bindingKeys,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}const key=`${task.kind}:${bindingKey}`;if(bindingKeys[task.kind]?.has(bindingKey)===false||tasks.has(key)){invalid(`${path}/definition/steps`)}tasks.add(key)}}};var knowledgeConnectorInstance=(value,path)=>{const parsed=knowledge(value,path);assertPolicyLifecycle(concrete(parsed.dataPolicies),path);const entities=concrete(parsed.entityBindings);const relations=concrete(parsed.relationBindings);const pipelines=concrete(parsed.pipelines);uniqueKeys(entities,`${path}/entityBindings`);uniqueKeys(relations,`${path}/relationBindings`);uniqueKeys(pipelines,`${path}/pipelines`);const entityKeys=knownKeys(parsed.entityBindings);const bindingKeys={entity:entityKeys,relation:knownKeys(parsed.relationBindings)};assertEntityParents(entities,path);for(const[index,binding]of[...entities,...relations].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,relation]of relations.entries()){for(const key of[relation.sourceEntityKey,relation.targetEntityKey]){const entityKey=spelled(key);if(entityKey!==undefined&&entityKeys?.has(entityKey)===false){invalid(`${path}/relationBindings/${index}`)}}}for(const[index,item]of pipelines.entries()){uniqueKeys(concrete(item.schedules),`${path}/pipelines/${index}/schedules`);assertPipelineTasks(item,bindingKeys,`${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 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 toolBindingDeclaration=(entry)=>typeof entry==="string"?{tool:entry}:entry;var duplicateToolBinding=(tools)=>{const seen=new Set;for(const entry of tools){const binding=toolBindingDeclaration(entry);const key=JSON.stringify([binding.tool,binding.name??null]);if(seen.has(key)){return binding}seen.add(key)}return};var agentAudienceViolation=(audience)=>{const applications=audience.applications??[];if(audience.anonymous===true&&applications.length===0){return"anonymous visitors need an application in audience.applications"}const repeated=applications.find((fqn,index)=>applications.indexOf(fqn)!==index);return repeated===undefined?undefined:`audience application '${repeated}' is listed more than once`};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 readExternalAppGateway=closedGatewayObject({...base,expectedContract:readOperationGatewayContract,kind:literal("externalAppGateway")});var externalApplicationConsents=["inherit","ask","skip"];var roleKey=/^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/u;var resourceAction=/^[a-z][a-z0-9_]*(?::[a-z][a-z0-9_]*)+$/u;var isOwnAncestor=({key,parent},declared)=>{const seen=new Set;let ancestor=parent;while(ancestor!==undefined&&ancestor!==key&&!seen.has(ancestor)){seen.add(ancestor);ancestor=declared.get(ancestor)?.role.parent}return ancestor===key};var permissionsOf=({appPermissions=[],platformPermissions})=>[...platformPermissions,...appPermissions];var roleViolation=(entry,roles,declared)=>{const{kind,path,role}=entry;const{assignRoles=[],key,parent,replaces}=role;const visibility=entry.kind==="User Role"?entry.role.visibility:undefined;if(key==="anonymous"&&visibility!=="declared"){return`${path}: role 'anonymous' must be a User Role with Declared Visibility`}if(visibility==="user"&&Object.hasOwn(role,"bindings")){return`${path}.bindings: role '${key}' with User Visibility declares no bindings`}const assigned=assignRoles.find((other)=>declared.get(other)?.kind!=="User Role");if(assigned!==undefined){return`${path}.assignRoles: role '${assigned}' of role '${key}' is not a User Role of this application`}if(replaces!==undefined){if(declared.has(replaces)){return`${path}.replaces: role '${key}' replaces '${replaces}', which this release declares`}const first=roles.find((other)=>other.role.replaces===replaces);if(first?.role.key!==key){return`${path}.replaces: roles '${first?.role.key}' and '${key}' replace the same role '${replaces}'`}}if(parent===undefined){return}const held=declared.get(parent);if(held?.kind!==kind){return`${path}.parent: parent '${parent}' of role '${key}' is not a declared ${kind}`}const heldPermissions=permissionsOf(held.role);const missing=permissionsOf(role).find((permission)=>!heldPermissions.includes(permission));if(missing!==undefined){return`${path}.parent: role '${parent}' must hold permission '${missing}' of its child role '${key}'`}return isOwnAncestor(role,declared)?`${path}.parent: role '${key}' is its own ancestor`:undefined};var rolesViolation=(userRoles,serverRoles)=>{const roles=[...userRoles.map((role,index)=>({kind:"User Role",path:`userRoles[${index}]`,role})),...serverRoles.map((role,index)=>({kind:"Server Role",path:`serverRoles[${index}]`,role}))];const declared=new Map;for(const entry of roles){const{path,role}=entry;const{key,platformPermissions}=role;if(key.length>64||!roleKey.test(key)){return`${path}.key: role key '${key}' must match ${roleKey.source} and hold at most 64 characters`}if(declared.has(key)){return`${path}.key: role key '${key}' is declared more than once`}declared.set(key,entry);const malformed=platformPermissions.find((permission)=>!resourceAction.test(permission));if(malformed!==undefined){return`${path}.platformPermissions: permission '${malformed}' of role '${key}' must be 'resource:action'`}}for(const entry of roles){const violation=roleViolation(entry,roles,declared);if(violation!==undefined){return violation}}return};var defaultServerRoleViolation=(defaultServerRole,serverRoles)=>{if(defaultServerRole===undefined){return serverRoles.length===0?undefined:"defaultServerRole is required with serverRoles"}return serverRoles.some(({key})=>key===defaultServerRole)?undefined:`defaultServerRole: role '${defaultServerRole}' is not a declared Server Role`};var groupBindingsViolation=(groupBindings,userRoles)=>{for(const[index,{group,role}]of groupBindings.entries()){const path=`groupBindings[${index}]`;if(group.trim()===""){return`${path}.group: the Group Role Binding of role '${role}' must name a Group`}if(!userRoles.some(({key})=>key===role)){return`${path}.role: role '${role}' of the Group Role Binding to Group '${group}' is not a declared User Role`}const first=groupBindings.findIndex((other)=>other.group===group&&other.role===role);if(first!==index){return`${path}: the Group Role Binding of role '${role}' to Group '${group}' is declared more than once`}}return};var externalApplicationViolation=({applicationConsent,defaultServerRole,groupBindings=[],primaryRedirectUri,redirectUris,serverRoles=[],userRoles})=>{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 rolesViolation(userRoles,serverRoles)??defaultServerRoleViolation(defaultServerRole,serverRoles)??groupBindingsViolation(groupBindings,userRoles)};var uuid2=/^[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)=>uuid2.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 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 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 identifier2=/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/u;var fields=new Set(["category","defaultVisibility","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)=>!fields.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 servicePrincipalOrganizationRoles=["organization_admin","organization_operator","organization_member"];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 fieldReaders={boolean:valueField,entities:entitiesField,enum:enumField,file:fileField,json:jsonField,number:valueField,text:valueField,textarea:valueField};var formField=(value,path)=>{const{type}=object({type:literal("boolean","entities","enum","file","json","number","text","textarea")})(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 access=optional(object({groups:refine(array(identity),(groups)=>groups.length===0?"no group":undefined)}));var view=object({access,componentRef:identity,dataBinding:optional(object({filter:optional(jsonObject),kind:literal("schema"),schema:identity})),fqn:identity,orderIndex:number,props:optional(jsonObject),slot:identity});var pageBase={access,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 isTrue=(value,path)=>value===true?true:invalid(path);var studioAppDeclaration=object({...base,definition:refine(object({color:optString,description:optString,icon:optString,layout:optional(layout),name:string,sections:array(object({access,description:optString,fqn:identity,icon:optString,label:string,orderIndex:number,pages:array(page),slug:identity})),slug:identity}),collision),grants:object({groups:refine(array(object({group:identity,role:literal("manage","view")})),(grants)=>new Set(grants.map(({group})=>group)).size===grants.length?undefined:"duplicate Group")}),kind:literal("studioApp"),lifecycle:object({deployMode:literal("upsert"),readonly:isTrue})});var studioFormKey2="studioForm";var studioAgentFormAt=(metadata,path)=>optional(object({fields:studioFormFields}))(metadata[studioFormKey2],`${path}/${studioFormKey2}`);var studioAgentMetadata=(read)=>(value,path)=>{const metadata=read(value,path);studioAgentFormAt(metadata,path);return metadata};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 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 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,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")}))),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 bindingTargets=(read)=>optional(union(literal("all"),array(read)));var knowledgeTargets=bindingTargets(object({fqn:identity,policy:optional(identity)}));var declaredBindings=optional(object({agents:bindingTargets(identity),documents:bindingTargets(identity),knowledge:optional(object({domains:knowledgeTargets,schemas:knowledgeTargets})),skills:bindingTargets(identity),workflows:bindingTargets(identity)}));var roleFields={appPermissions:optStrings,assignRoles:optStrings,key:string,parent:optString,platformPermissions:strings,replaces:optString,users:optional(object({create:boolean}))};var roleVisibility=object({visibility:literal("user","declared")});var userVisibilityRole=object({...roleFields,visibility:literal("user")});var declaredVisibilityRole=object({...roleFields,bindings:declaredBindings,visibility:literal("declared")});var userRole=(value,path)=>roleVisibility(value,path).visibility==="declared"?declaredVisibilityRole(value,path):userVisibilityRole(value,path);var knowledgeSelection=optional(object({exclude:optional(array(identity)),include:optional(array(identity))}));var toolBindings2=refine(array(union(identity,object({approval:optional(union(literal("always","never"),object({rule:identity}))),knowledge:optional(object({domains:knowledgeSelection,entitySchemas:knowledgeSelection,relationSchemas:knowledgeSelection,unrestricted:optBoolean})),name:optional(identity),settings:optional(jsonObject),tool:identity}))),(tools)=>duplicateToolBinding(tools)===undefined?undefined:"duplicate tool binding");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 agentAudience2=refine(object({anonymous:optBoolean,applications:optional(array(identity)),members:optional(literal("all","none","selected")),organizationGroups:optional(literal("none","selected"))}),(audience)=>("organizationTeams"in audience)?"organizationTeams":agentAudienceViolation(audience));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}),defaultRole:literal("organization_admin","organization_operator","organization_member"),domains:varyingStrings,enabled:boolean,provisionMembers:boolean}),provider:union(object({fqn:identity}),varyingObject({providerId:identity}))});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 subgroups=(value,path)=>optional(array(object({description:optString,displayName:string,key:string,subgroups})))(value,path);var primitives={agent:refine(object({...base,activity:optional(object({heartbeat:boolean,schedule:boolean})),audience:optional(agentAudience2),behavioralBoundaries:strings,dataAccess:readDataAccess("agent"),kind:literal("agent"),lifecycle,maxSteps:optional(positiveSafeInteger),metadata:optional(studioAgentMetadata(jsonObject)),modelTier:optional(literal(...agentModelTiers)),objectives:strings,operatingInstructions:string,output:optional(object({schema})),responsibility:string,skills:array(identity),tools:toolBindings2}),withoutRetiredAgentFields),connection,connectionInstance:substituted(varyingObject({...base,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,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:object({...base,catalogTags,domainFqn:string,domainName:string,entitySchemaFqns:strings,kind:literal("domainTemplate"),relationSchemaFqns:strings}),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(refine(object({...varyingFields({...base,allowedOrigins:varyingStrings,applicationConsent:optional(literal(...externalApplicationConsents)),applicationType:literal("confidential","public"),audience:string,kind:literal("externalApplication"),lifecycle,postLogoutRedirectUris:varyingStrings,primaryRedirectUri:optString,redirectUris:varyingStrings,scopes:varyingStrings,setupInstructions:optString}),defaultServerRole:optString,groupBindings:optional(array(object({coverage:optional(literal("direct","inherited")),group:string,lifecycle,role:string}))),serverRoles:optional(array(object({...roleFields,bindings:declaredBindings}))),userRoles:array(userRole)}),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: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),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")),recommendedImportSchedules:predefinedSchedules,relationSchemaCapabilities:optional(array(relationCapability)),remoteReference:optional(object({providerKey:identity,urlTemplate:knowledgeRemoteReferenceUrlTemplate})),settings:optional(form),supportedBindingModes:optional(bindingModes)}),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)})),knowledgePolicy:object({...base,...policyFields,kind:literal("knowledgePolicy"),priority:optNumber}),knowledgeRelationAdapter:object({...base,connectorFqn:string,kind:literal("knowledgeRelationAdapter"),relationSchemaFqn:string}),knowledgeRelationSchema:object({...base,...knowledgeSchema,kind:literal("knowledgeRelationSchema"),lifecycle:optional(lifecycle),sourceSchemaFqn:string,targetSchemaFqn:string}),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),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}),remoteToolCollection:refine(object({...base,category:optString,defaultVisibility:optional(array(object({effect:literal("allow","deny"),subject:literal("organization")}))),gatewayRef:identity,kind:literal("remoteToolCollection"),operationReferences:strings}),remoteToolCollectionViolation),servicePrincipal:object({...base,groups:array(identity),kind:literal("servicePrincipal"),organizationRole:literal(...servicePrincipalOrganizationRoles)}),skill:object({dataAccess:readDataAccess("skill"),...base,instructions:string,kind:literal("skill"),lifecycle,tools:toolBindings2}),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,autoActivate:optBoolean,autoInstantiate:optBoolean,bindingScopes:optional(bindingScopes),bindingSettings:optional(form),capabilityType:optional(literal("delegate","external","read","write")),category:optString,connectionRefs,effectKind:optional(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,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:object({...base,category:optString,defaultVisibility:optional(array(object({effect:literal("allow","deny"),subject:literal("organization")}))),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:refine(object({dataAccess:readDataAccess("workflow"),...base,definition:authoringDefinition,kind:literal("workflow"),lifecycle,name:string,slug:string}),(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,contract:nodeContract,kind:literal("workflowNode"),nodeKind:literal("action","input","output","trigger"),presentation:optional(object({categoryPath:optStrings,tags:optStrings}))}),workflowNodeCollection:object({...base,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 primitive=(v,p)=>{const{kind}=object({kind:string})(v,p);for(const[name,read]of Object.entries(primitives)){if(name===kind){return read(v,p)}}return invalid(`${p}/kind`)};var readDependency=object({fqn:hostedIdentity});var parsePackageDependencies=(value)=>{const requirements=array(readDependency)(value,"/dependencies");const identities=new Set;for(const requirement of requirements){if(Object.keys(requirement).some((key)=>key!=="fqn")){throw new TypeError(`package dependency '${requirement.fqn}' has unexpected fields`)}if(identities.has(requirement.fqn)){throw new TypeError(`duplicate package dependency '${requirement.fqn}'`)}identities.add(requirement.fqn)}return[...requirements].sort((left,right)=>compareUtf16CodeUnits(left.fqn,right.fqn))};var PackageManifestVersion="v4";var legacyFixedDestinationTargets=new Set(["fixed-email","channel-destination","telegram-chat","whatsapp-destination"]);var FRONTEND_CATALOG_CONTRACT="frontend-catalog/v1";var FRONTEND_CATALOG_EXPORT_NAME="loadFrontendCatalog";var BACKEND_EXECUTION_LANES=["interactive","job"];var requireIdentityPart=(value,label)=>{if(value.trim()===""||value!==value.trim()){throw new TypeError(`Hosted Contribution ${label} must be non-empty and trimmed`)}};function declareHostedContribution(input){const contributionFqn=input.fqn;const contributionExport=input.exportName;const contributionContract=input.contract;requireIdentityPart(contributionFqn,"FQN");requireIdentityPart(contributionExport,"export name");const execution="execution"in input?input.execution:undefined;if(execution!==undefined){if(input.host!=="backend"){throw new TypeError(`Frontend Hosted Contribution '${contributionFqn}' cannot declare an execution lane`)}if(!BACKEND_EXECUTION_LANES.some((lane)=>lane===execution)){throw new TypeError(`Backend Hosted Contribution '${contributionFqn}' execution must be 'interactive' or 'job'`)}}if(input.host!=="backend"){if(contributionContract!==FRONTEND_CATALOG_CONTRACT){throw new TypeError(`Frontend Hosted Contribution '${contributionFqn}' contract must be '${FRONTEND_CATALOG_CONTRACT}'`)}if(contributionExport!==FRONTEND_CATALOG_EXPORT_NAME){throw new TypeError(`Frontend Hosted Contribution '${contributionFqn}' export must be '${FRONTEND_CATALOG_EXPORT_NAME}'`)}}const manifest=input.host==="backend"?{...input.compatibility===undefined?undefined:{compatibility:input.compatibility},...input.contract===undefined?undefined:{contract:input.contract},...input.execution===undefined?undefined:{execution:input.execution},exportName:input.exportName,fqn:input.fqn,host:input.host}:{...input.compatibility===undefined?undefined:{compatibility:input.compatibility},contract:FRONTEND_CATALOG_CONTRACT,exportName:FRONTEND_CATALOG_EXPORT_NAME,fqn:input.fqn,host:input.host};return{load:input.load,manifest}}var packageVariable=(value,path)=>{const declared=object({default:optional(json),description:optString,type:literal(...packageVariableTypes)})(value,path);const name=path.slice(path.lastIndexOf("/")+1);if(packageVariableViolation(name,declared)!==undefined){return invalid(path)}return declared};var readHostedContribution=(value,path)=>{const shared=object({compatibility:optional(record(string)),contract:optString,execution:optional(literal("interactive","job")),exportName:hostedIdentity,fqn:hostedIdentity,host:literal("backend","dashboard","studio")})(value,path);if(shared.host==="backend"){return{...shared.compatibility===undefined?undefined:{compatibility:shared.compatibility},...shared.contract===undefined?undefined:{contract:shared.contract},...shared.execution===undefined?undefined:{execution:shared.execution},exportName:shared.exportName,fqn:shared.fqn,host:shared.host}}if(shared.execution!==undefined){throw new TypeError(`Invalid package manifest at ${path}/execution: frontend contributions cannot declare an execution lane`)}if(shared.contract!==FRONTEND_CATALOG_CONTRACT){throw new TypeError(`Invalid package manifest at ${path}/contract: frontend contribution contract must be '${FRONTEND_CATALOG_CONTRACT}'`)}if(shared.exportName!==FRONTEND_CATALOG_EXPORT_NAME){throw new TypeError(`Invalid package manifest at ${path}/exportName: frontend contribution export must be '${FRONTEND_CATALOG_EXPORT_NAME}'`)}return{...shared.compatibility===undefined?undefined:{compatibility:shared.compatibility},contract:FRONTEND_CATALOG_CONTRACT,exportName:FRONTEND_CATALOG_EXPORT_NAME,fqn:shared.fqn,host:shared.host}};var readManifest=object({apiVersion:literal(PackageManifestVersion),author:optString,autoInstallable:optBoolean,bindingScopes:optional(array(literal("organization","tenant"))),category:optString,dependencies:optional(parsePackageDependencies),description:optString,documentation:optString,fqn:identity,homepage:optString,hostedContributions:optional(array(readHostedContribution)),icon:optString,installationWizard:optional(object({size:optional(literal("lg","md","xl")),steps:array(object({description:optString,kind:literal("connector_instance","tool_instance"),optional:optBoolean,ref:string,title:optString}))})),name:string,primitives:array(primitive),requiredEnvironmentVariables:optStrings,tags:optStrings,tenantMandatory:optBoolean,tenantStandard:optBoolean,variables:optional(record(packageVariable)),version:string});var PACKAGE_MEDIA_SIZE_LIMIT_BYTES=2*1024*1024;var retiredPrimitiveKinds=new Map(Object.entries({dataset_blueprint:"datasetBlueprint",dataset_parser:"datasetParser",dataset_table_template:"datasetTableTemplate",documents_connector:"documentsConnector",domain_template:"domainTemplate",event_listener:"eventListener",external_application:"externalApplication",external_dataset_provider:"externalDatasetProvider",field_transformer:"fieldTransformer",knowledge_connector:"knowledgeConnector",knowledge_connector_oauth:"knowledgeConnectorOauth",knowledge_entity_adapter:"knowledgeEntityAdapter",knowledge_entity_schema:"knowledgeEntitySchema",knowledge_policy:"knowledgePolicy",knowledge_relation_adapter:"knowledgeRelationAdapter",knowledge_relation_schema:"knowledgeRelationSchema",managed_dataset_provider:"managedDatasetProvider","notification-channel":"notificationChannel",organization_sso:"organizationSso",skill_template:"skillTemplate",studio_app:"studioApp",studio_component:"studioComponent",tool_collection:"toolCollection",tool_settings_options:"toolSettingsOptions",workflow_field:"workflowField",workflow_field_collection:"workflowFieldCollection",workflow_node:"workflowNode",workflow_node_collection:"workflowNodeCollection",workflow_template:"workflowTemplate"}));var retiredGroupNames=new Map(Object.entries({directory_person_in_team:"directory_person_in_group",directory_team:"directory_group",directory_team_parent:"directory_group_parent",organization_team:"organization_group",organization_team_hierarchy:"organization_group_hierarchy",organization_team_membership:"organization_group_membership"}));var toolResultBrand=Symbol.for("@ci/tool-result");var requireIdentity=(value,label)=>{if(value.trim()===""||value!==value.trim()){throw new TypeError(`${label} must be non-empty and trimmed`)}};var freezeJson=(candidate)=>{if(candidate===null||!(candidate instanceof Object)){return}for(const child of Object.values(candidate)){freezeJson(child)}Object.freeze(candidate)};var immutableMetadata=(metadata)=>{const value=parseJsonObject(canonicalJson(metadata));freezeJson(value);return value};var moduleReference=(reference,role)=>{requireIdentity(role,"Frontend implementation role");requireIdentity(reference.exportName,`Frontend '${role}' export name`);if(!(reference.module instanceof URL)){requireIdentity(reference.module,`Frontend '${role}' module`)}return Object.freeze({...reference})};var declareFrontendComponent=(input)=>{for(const[label,value]of Object.entries({"Frontend component FQN":input.target.fqn,"Frontend component role":input.target.role,"Frontend component version":input.target.version,"Frontend package FQN":input.target.packageFqn})){requireIdentity(value,label)}const references=Object.fromEntries(Object.entries(input.implementation).map(([role,reference])=>[role,moduleReference(reference,role)]));const{render}=references;if(render===undefined){throw new TypeError("Frontend component requires a render implementation")}const implementation={...references,render};return Object.freeze({implementation:Object.freeze(implementation),kind:"component",metadata:immutableMetadata(input.metadata??{}),target:Object.freeze({...input.target})})};var requireIdentity2=(value,label)=>{if(value.trim()===""||value!==value.trim()){throw new TypeError(`${label} must be non-empty and trimmed`)}};var declareFrontendPackage=(input)=>{requireIdentity2(input.manifest.fqn,"Frontend package FQN");requireIdentity2(input.manifest.name,"Frontend package name");requireIdentity2(input.manifest.version,"Frontend package version");return Object.freeze({components:Object.freeze([...input.components]),kind:"package",manifest:Object.freeze({...input.manifest})})};var bindingKey=(declaration)=>{const{target}=declaration;return`${target.packageFqn}\x00${target.fqn}\x00${target.version}\x00${target.role}`};var compareStrings=(left,right)=>{if(left<right){return-1}if(left>right){return 1}return 0};var serializableComponent=(declaration)=>({kind:declaration.kind,metadata:declaration.metadata,target:declaration.target});var serializeFrontendDeclaration=(declaration)=>{if(declaration.kind==="component"){return canonicalJson(serializableComponent(declaration))}const components=[...declaration.components].sort((left,right)=>compareStrings(bindingKey(left),bindingKey(right)));return canonicalJson({components:components.map(serializableComponent),kind:declaration.kind,manifest:declaration.manifest})};var bindingKey2=(binding)=>`${binding.packageFqn}\x00${binding.fqn}\x00${binding.version}\x00${binding.role}`;var compareEntries=(left,right)=>{if(left.key<right.key){return-1}if(left.key>right.key){return 1}return 0};var entryFor=(packageFqn,declaration)=>{const{target}=declaration;return Object.freeze({declaration,key:bindingKey2(target),packageFqn,role:target.role,target:target.fqn,version:target.version})};var validateFrontendPackages=(packages)=>{const errors=[];const claims=new Map;for(const frontendPackage of packages){for(const declaration of frontendPackage.components){const{target}=declaration;if(target.packageFqn!==frontendPackage.manifest.fqn){errors.push({code:"cross_package_binding",message:`Package ${frontendPackage.manifest.fqn} cannot bind ${target.fqn} owned by ${target.packageFqn}`,packageFqn:frontendPackage.manifest.fqn,target,targetPackageFqn:target.packageFqn});continue}const entry=entryFor(frontendPackage.manifest.fqn,declaration);if(claims.has(entry.key)){errors.push({code:"duplicate_exact_binding",message:`Exact binding ${target.fqn}@${target.version}/${target.role} is declared more than once`,packageFqn:frontendPackage.manifest.fqn,target,targetPackageFqn:target.packageFqn});continue}claims.set(entry.key,entry)}}if(errors.length>0){return Object.freeze({errors:Object.freeze(errors),kind:"invalid"})}const entries=[...claims.values()].sort(compareEntries);return Object.freeze({entries:Object.freeze(entries),kind:"valid"})};var declareFrontendCatalogContribution=(input)=>declareHostedContribution({...input.compatibility===undefined?undefined:{compatibility:input.compatibility},contract:FRONTEND_CATALOG_CONTRACT,exportName:FRONTEND_CATALOG_EXPORT_NAME,fqn:input.fqn,host:input.host,load:input.load});var isRecord=(value)=>value!==null&&typeof value==="object"&&!Array.isArray(value);var isIdentity=(value)=>typeof value==="string"&&value!==""&&value===value.trim();var isDigest=(value)=>typeof value==="string"&&/^[\da-f]{64}$/u.test(value);var diagnostic=(authority,code,message)=>Object.freeze({diagnostic:Object.freeze({code,contributionFqn:authority.logical.contributionFqn,host:authority.logical.host,message,packageFqn:authority.logical.packageFqn,servingGeneration:authority.logical.servingGeneration}),kind:"rejected"});var isModuleLoader=(value)=>typeof value==="function";var readModuleReference=(value)=>{if(!isRecord(value)||!isIdentity(value.exportName)){return}if(!(value.module instanceof URL)&&!isIdentity(value.module)){return}const reference={exportName:value.exportName,module:value.module};if(value.load===undefined){return reference}return isModuleLoader(value.load)?{...reference,load:value.load}:undefined};var readComponent=(value)=>{if(!isRecord(value)||value.kind!=="component"||!isRecord(value.target)||!isIdentity(value.target.fqn)||!isIdentity(value.target.packageFqn)||!isIdentity(value.target.role)||!isIdentity(value.target.version)||!isRecord(value.implementation)||!isRecord(value.metadata)){return}const implementationEntries=[];for(const[role,reference]of Object.entries(value.implementation)){const parsed=readModuleReference(reference);if(!isIdentity(role)||parsed===undefined){return}implementationEntries.push([role,parsed])}const implementation=Object.fromEntries(implementationEntries);const{render}=implementation;if(render===undefined){return}let metadata;try{metadata=parseJsonObject(canonicalJson(value.metadata))}catch{return}const input={implementation:{...implementation,render},metadata,target:{fqn:value.target.fqn,packageFqn:value.target.packageFqn,role:value.target.role,version:value.target.version}};return declareFrontendComponent(input)};var readPackage=(value)=>{if(!isRecord(value)||value.kind!=="package"||!isRecord(value.manifest)||!isIdentity(value.manifest.fqn)||!isIdentity(value.manifest.name)||!isIdentity(value.manifest.version)||!Array.isArray(value.components)){return{code:"package_shape_invalid",kind:"invalid"}}const components=value.components.map(readComponent);if(components.some((component)=>component===undefined)){return{code:"component_shape_invalid",kind:"invalid"}}return{kind:"valid",value:declareFrontendPackage({components:components.filter((component)=>component!==undefined),manifest:{fqn:value.manifest.fqn,name:value.manifest.name,version:value.manifest.version}})}};var validateAuthority=(authority)=>{const{logical,physical}=authority;if(!isIdentity(logical.contributionFqn)||!isIdentity(logical.packageFqn)||!isIdentity(logical.packageVersion)||typeof logical.servingGeneration!=="string"||!/^(?:0|[1-9]\d*)$/u.test(logical.servingGeneration)||!isIdentity(physical.assetPath)||!Number.isSafeInteger(physical.assetSize)||physical.assetSize<0||!isIdentity(physical.carrierPackageFqn)||!isIdentity(physical.extensionReleaseId)||!isDigest(physical.assetDigest)||!isDigest(physical.extensionReleaseDigest)){return diagnostic(authority,"invalid_provenance","Frontend catalog authority contains invalid logical or physical provenance")}if(logical.contract!==FRONTEND_CATALOG_CONTRACT||physical.contract!==FRONTEND_CATALOG_CONTRACT){return diagnostic(authority,"unsupported_contract",`Frontend catalog contract must be '${FRONTEND_CATALOG_CONTRACT}'`)}if(logical.exportName!==FRONTEND_CATALOG_EXPORT_NAME||physical.exportName!==FRONTEND_CATALOG_EXPORT_NAME){return diagnostic(authority,"unexpected_export",`Frontend catalog export must be '${FRONTEND_CATALOG_EXPORT_NAME}'`)}if(logical.host!==physical.host){return diagnostic(authority,"host_mismatch","Logical and physical frontend catalog Hosts do not match")}if(logical.contributionFqn!==physical.contributionFqn){return diagnostic(authority,"contribution_mismatch","Logical and physical frontend contribution identities do not match")}return};var admitFrontendCatalog=async(input)=>{const authorityFailure=validateAuthority(input.authority);if(authorityFailure!==undefined){return authorityFailure}if(!isRecord(input.loadedModule)){return diagnostic(input.authority,"module_shape_invalid","Frontend catalog module must be an object")}const loader=input.loadedModule[FRONTEND_CATALOG_EXPORT_NAME];if(typeof loader!=="function"){return diagnostic(input.authority,"loader_not_callable",`Frontend catalog module export '${FRONTEND_CATALOG_EXPORT_NAME}' must be callable`)}let loaded;try{loaded=await loader()}catch{return diagnostic(input.authority,"loader_failed","Frontend catalog loader failed before returning declarations")}if(!Array.isArray(loaded)){return diagnostic(input.authority,"result_not_array","Frontend catalog loader must return an array of Frontend Package Declarations")}const packages=[];for(const candidate of loaded){const result=readPackage(candidate);if(result.kind==="invalid"){return diagnostic(input.authority,result.code,result.code==="package_shape_invalid"?"Frontend catalog loader returned an invalid Frontend Package Declaration":"Frontend catalog loader returned an invalid Frontend Component Declaration")}if(result.value.manifest.fqn!==input.authority.logical.packageFqn||result.value.manifest.version!==input.authority.logical.packageVersion){return diagnostic(input.authority,"package_identity_mismatch",`Frontend package '${result.value.manifest.fqn}@${result.value.manifest.version}' does not match authorized package '${input.authority.logical.packageFqn}@${input.authority.logical.packageVersion}'`)}packages.push(result.value)}const packageIdentities=new Set(packages.map(({manifest})=>manifest.fqn));if(packageIdentities.size!==packages.length){return diagnostic(input.authority,"duplicate_package","Frontend catalog loader returned the same package more than once")}const validation=validateFrontendPackages(packages);if(validation.kind==="invalid"){const[first]=validation.errors;return diagnostic(input.authority,first?.code??"component_shape_invalid",first?.message??"Frontend catalog validation failed")}return Object.freeze({authority:input.authority,kind:"admitted",packages:Object.freeze(packages)})};var emptySnapshot=()=>Object.freeze({entries:Object.freeze([]),revision:0});var requireSourceKey=(sourceKey)=>{if(sourceKey.trim()===""||sourceKey!==sourceKey.trim()){throw new TypeError("Frontend catalog source key must be non-empty and trimmed")}};var createFrontendCatalog=()=>{let selectedSourceKey;let currentSnapshot=emptySnapshot();let entriesByKey=new Map;return{activate(packages,options){const sourceKey=options?.sourceKey;if(sourceKey!==undefined){requireSourceKey(sourceKey);if(selectedSourceKey!==undefined&&sourceKey!==selectedSourceKey){return Object.freeze({expectedSourceKey:selectedSourceKey,kind:"stale",reason:"source",receivedSourceKey:sourceKey,snapshot:currentSnapshot})}}const validation=validateFrontendPackages(packages);if(validation.kind==="invalid"){return validation}const{entries}=validation;currentSnapshot=Object.freeze({entries,revision:currentSnapshot.revision+1});entriesByKey=new Map(entries.map((entry)=>[entry.key,entry]));if(sourceKey!==undefined&&selectedSourceKey===undefined){selectedSourceKey=sourceKey}return Object.freeze({kind:"activated",snapshot:currentSnapshot})},resolve(binding){return entriesByKey.get(bindingKey2(binding))},selectSource(sourceKey){requireSourceKey(sourceKey);selectedSourceKey=sourceKey},snapshot(){return currentSnapshot}}};export{admitFrontendCatalog,createFrontendCatalog,declareFrontendCatalogContribution,declareFrontendComponent,declareFrontendPackage,serializeFrontendDeclaration};
1
+ 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 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 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 packageVariableTypes=["string","number","boolean","string[]","json","secret"];var isVariableReference=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value)&&Object.keys(value).length===1&&("$variable"in value)&&typeof value.$variable==="string";var isString=(value)=>String(value)===value;var holdsType=(type,value)=>{switch(type){case"boolean":{return Boolean(value)===value}case"json":{return true}case"number":{return Number(value)===value}case"string[]":{return Array.isArray(value)&&value.every(isString)}default:{return isString(value)}}};var packageVariableViolation=(name,declaration)=>{if(!packageVariableTypes.includes(declaration.type)){return`variable '${name}' has the unknown type '${declaration.type}'`}if(!("default"in declaration)||declaration.default===undefined){return}if(declaration.type==="secret"){return`variable '${name}' is a secret and cannot declare a default`}if(!holdsType(declaration.type,declaration.default)){return`variable '${name}' declares a default outside its type '${declaration.type}'`}return};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 hostedIdentity=(value,path)=>{const text=identity(value,path);return text===text.trim()?text:invalid(path)};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 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 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 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",knowledgeRelation:"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 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",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 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 metadata=object({available:boolean,label:string});var connection=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"),providerFamily:string,secretFields:optStrings,testMetadata:optional(metadata)});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 relationCapability=object({...schemaCapability,predefinedBindingParentEntityKey:optString,predefinedBindingRelationImportMode:optional(literal("child_binding","relation_only")),predefinedBindingSourceEntityKey:optString,predefinedBindingTargetEntityKey:optString});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,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({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 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 policyRef=(value,path)=>{const{kind}=object({kind:string})(value,path);return kind==="literal"?object({kind:literal("literal"),value:json})(value,path):object({kind:literal("subject","resource"),path:strings})(value,path)};var uuid=(value,path)=>{const parsed=identity(value,path);return/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu.test(parsed)?parsed:invalid(path)};var policyPredicate=(value,path)=>{const{op}=object({op:string})(value,path);switch(op){case"eq":case"neq":case"lt":case"lte":case"gt":case"gte":{return object({left:policyRef,op:literal("eq","neq","lt","lte","gt","gte"),right:policyRef})(value,path)}case"in":{return object({op:literal("in"),set:policyRef,value:policyRef})(value,path)}case"exists":case"is_null":{return object({op:literal("exists","is_null"),ref:policyRef})(value,path)}case"contains":case"starts_with":{return object({op:literal("contains","starts_with"),ref:policyRef,value:policyRef})(value,path)}case"const":{return object({op:literal("const"),value:boolean})(value,path)}case"not":{return object({arg:policyPredicate,op:literal("not")})(value,path)}case"and":case"or":{return object({args:array(policyPredicate),op:literal("and","or")})(value,path)}case"relation_exists":{return object({direction:literal("out","in"),op:literal("relation_exists"),relationSchemaId:uuid})(value,path)}case"relation_field":{return object({direction:literal("out","in"),inner:policyPredicate,op:literal("relation_field"),relationSchemaId:uuid})(value,path)}default:{return invalid(`${path}/op`)}}};var policyBody=object({rule:optional(policyPredicate),subjectMatch:policyPredicate});var policyFields={effect:literal("allow","deny"),policyBody,policyType:literal("filter","gate"),targetFqn:identity,targetKind:literal("entity_domain","entity_schema","relation_domain","relation_schema")};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"),missingConnectorFieldsBehavior:optional(literal("prune","retain")),pushEntityMatch:optional(literal("remote_ref","unique_fields")),schemaFqn:identity,supportedBindingModes:optional(varyingArray(literal("managed","external"))),suppressEntityEvents:optBoolean});var relationBinding=varyingObject({...bindingFields,bindingMode:optional(literal("managed")),relationImportMode:optional(literal("child_binding","relation_only")),relationSchemaFqn:identity,sourceEntityKey:optional(nullable(identity)),targetEntityKey:optional(nullable(identity))});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 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:literal("entity","relation"),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=varyingObject({...base,connections:optional(record(connection2)),dataPolicies:optional(varyingArray(varyingObject({...policyFields,fqn:identity,priority:optNumber}))),enabled:optBoolean,entityBindings:optional(varyingArray(entityBinding)),kind:literal("knowledgeConnectorInstance"),lifecycle,pipelines:optional(varyingArray(pipeline)),relationBindings:optional(varyingArray(relationBinding)),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});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 assertPolicyLifecycle=(policies,path)=>{for(const[index,policy]of policies.entries()){if(Object.keys(policy).some((key)=>key==="lifecycle"||key==="deployMode"||key==="readonly")){invalid(`${path}/dataPolicies/${index}/lifecycle`)}}};var assertPipelineTasks=(item,bindingKeys,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}const key=`${task.kind}:${bindingKey}`;if(bindingKeys[task.kind]?.has(bindingKey)===false||tasks.has(key)){invalid(`${path}/definition/steps`)}tasks.add(key)}}};var knowledgeConnectorInstance=(value,path)=>{const parsed=knowledge(value,path);assertPolicyLifecycle(concrete(parsed.dataPolicies),path);const entities=concrete(parsed.entityBindings);const relations=concrete(parsed.relationBindings);const pipelines=concrete(parsed.pipelines);uniqueKeys(entities,`${path}/entityBindings`);uniqueKeys(relations,`${path}/relationBindings`);uniqueKeys(pipelines,`${path}/pipelines`);const entityKeys=knownKeys(parsed.entityBindings);const bindingKeys={entity:entityKeys,relation:knownKeys(parsed.relationBindings)};assertEntityParents(entities,path);for(const[index,binding]of[...entities,...relations].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,relation]of relations.entries()){for(const key of[relation.sourceEntityKey,relation.targetEntityKey]){const entityKey=spelled(key);if(entityKey!==undefined&&entityKeys?.has(entityKey)===false){invalid(`${path}/relationBindings/${index}`)}}}for(const[index,item]of pipelines.entries()){uniqueKeys(concrete(item.schedules),`${path}/pipelines/${index}/schedules`);assertPipelineTasks(item,bindingKeys,`${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 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 toolBindingDeclaration=(entry)=>typeof entry==="string"?{tool:entry}:entry;var duplicateToolBinding=(tools)=>{const seen=new Set;for(const entry of tools){const binding=toolBindingDeclaration(entry);const key=JSON.stringify([binding.tool,binding.name??null]);if(seen.has(key)){return binding}seen.add(key)}return};var agentAudienceViolation=(audience)=>{const applications=audience.applications??[];if(audience.anonymous===true&&applications.length===0){return"anonymous visitors need an application in audience.applications"}const repeated=applications.find((fqn,index)=>applications.indexOf(fqn)!==index);return repeated===undefined?undefined:`audience application '${repeated}' is listed more than once`};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 readExternalAppGateway=closedGatewayObject({...base,expectedContract:readOperationGatewayContract,kind:literal("externalAppGateway")});var externalApplicationConsents=["inherit","ask","skip"];var roleKey=/^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/u;var resourceAction=/^[a-z][a-z0-9_]*(?::[a-z][a-z0-9_]*)+$/u;var isOwnAncestor=({key,parent},declared)=>{const seen=new Set;let ancestor=parent;while(ancestor!==undefined&&ancestor!==key&&!seen.has(ancestor)){seen.add(ancestor);ancestor=declared.get(ancestor)?.role.parent}return ancestor===key};var permissionsOf=({appPermissions=[],platformPermissions})=>[...platformPermissions,...appPermissions];var roleViolation=(entry,roles,declared)=>{const{kind,path,role}=entry;const{assignRoles=[],key,parent,replaces}=role;const visibility=entry.kind==="User Role"?entry.role.visibility:undefined;if(key==="anonymous"&&visibility!=="declared"){return`${path}: role 'anonymous' must be a User Role with Declared Visibility`}if(visibility==="user"&&Object.hasOwn(role,"bindings")){return`${path}.bindings: role '${key}' with User Visibility declares no bindings`}const assigned=assignRoles.find((other)=>declared.get(other)?.kind!=="User Role");if(assigned!==undefined){return`${path}.assignRoles: role '${assigned}' of role '${key}' is not a User Role of this application`}if(replaces!==undefined){if(declared.has(replaces)){return`${path}.replaces: role '${key}' replaces '${replaces}', which this release declares`}const first=roles.find((other)=>other.role.replaces===replaces);if(first?.role.key!==key){return`${path}.replaces: roles '${first?.role.key}' and '${key}' replace the same role '${replaces}'`}}if(parent===undefined){return}const held=declared.get(parent);if(held?.kind!==kind){return`${path}.parent: parent '${parent}' of role '${key}' is not a declared ${kind}`}const heldPermissions=permissionsOf(held.role);const missing=permissionsOf(role).find((permission)=>!heldPermissions.includes(permission));if(missing!==undefined){return`${path}.parent: role '${parent}' must hold permission '${missing}' of its child role '${key}'`}return isOwnAncestor(role,declared)?`${path}.parent: role '${key}' is its own ancestor`:undefined};var rolesViolation=(userRoles,serverRoles)=>{const roles=[...userRoles.map((role,index)=>({kind:"User Role",path:`userRoles[${index}]`,role})),...serverRoles.map((role,index)=>({kind:"Server Role",path:`serverRoles[${index}]`,role}))];const declared=new Map;for(const entry of roles){const{path,role}=entry;const{key,platformPermissions}=role;if(key.length>64||!roleKey.test(key)){return`${path}.key: role key '${key}' must match ${roleKey.source} and hold at most 64 characters`}if(declared.has(key)){return`${path}.key: role key '${key}' is declared more than once`}declared.set(key,entry);const malformed=platformPermissions.find((permission)=>!resourceAction.test(permission));if(malformed!==undefined){return`${path}.platformPermissions: permission '${malformed}' of role '${key}' must be 'resource:action'`}}for(const entry of roles){const violation=roleViolation(entry,roles,declared);if(violation!==undefined){return violation}}return};var defaultServerRoleViolation=(defaultServerRole,serverRoles)=>{if(defaultServerRole===undefined){return serverRoles.length===0?undefined:"defaultServerRole is required with serverRoles"}return serverRoles.some(({key})=>key===defaultServerRole)?undefined:`defaultServerRole: role '${defaultServerRole}' is not a declared Server Role`};var groupBindingsViolation=(groupBindings,userRoles)=>{for(const[index,{group,role}]of groupBindings.entries()){const path=`groupBindings[${index}]`;if(group.trim()===""){return`${path}.group: the Group Role Binding of role '${role}' must name a Group`}if(!userRoles.some(({key})=>key===role)){return`${path}.role: role '${role}' of the Group Role Binding to Group '${group}' is not a declared User Role`}const first=groupBindings.findIndex((other)=>other.group===group&&other.role===role);if(first!==index){return`${path}: the Group Role Binding of role '${role}' to Group '${group}' is declared more than once`}}return};var externalApplicationViolation=({applicationConsent,defaultServerRole,groupBindings=[],primaryRedirectUri,redirectUris,serverRoles=[],userRoles})=>{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 rolesViolation(userRoles,serverRoles)??defaultServerRoleViolation(defaultServerRole,serverRoles)??groupBindingsViolation(groupBindings,userRoles)};var uuid2=/^[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)=>uuid2.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 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 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 identifier2=/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/u;var fields=new Set(["category","defaultVisibility","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)=>!fields.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 servicePrincipalOrganizationRoles=["organization_admin","organization_operator","organization_member"];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 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,text:valueField,textarea:valueField,user_select:userField};var formField=(value,path)=>{const{type}=object({type:literal("boolean","entities","enum","file","json","number","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 access=optional(object({groups:refine(array(identity),(groups)=>groups.length===0?"no group":undefined)}));var view=object({access,componentRef:identity,dataBinding:optional(object({filter:optional(jsonObject),kind:literal("schema"),schema:identity})),fqn:identity,orderIndex:number,props:optional(jsonObject),slot:identity});var pageBase={access,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 isTrue=(value,path)=>value===true?true:invalid(path);var studioAppDeclaration=object({...base,definition:refine(object({color:optString,description:optString,icon:optString,layout:optional(layout),name:string,sections:array(object({access,description:optString,fqn:identity,icon:optString,label:string,orderIndex:number,pages:array(page),slug:identity})),slug:identity}),collision),grants:object({groups:refine(array(object({group:identity,role:literal("manage","view")})),(grants)=>new Set(grants.map(({group})=>group)).size===grants.length?undefined:"duplicate Group")}),kind:literal("studioApp"),lifecycle:object({deployMode:literal("upsert"),readonly:isTrue})});var agentFormFields=(value,path)=>studioFormFields(value,path).map((field,index)=>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 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 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 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,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 bindingTargets=(read)=>optional(union(literal("all"),array(read)));var knowledgeTargets=bindingTargets(object({fqn:identity,policy:optional(identity)}));var declaredBindings=optional(object({agents:bindingTargets(identity),documents:bindingTargets(identity),knowledge:optional(object({domains:knowledgeTargets,schemas:knowledgeTargets})),skills:bindingTargets(identity),workflows:bindingTargets(identity)}));var roleFields={appPermissions:optStrings,assignRoles:optStrings,key:string,parent:optString,platformPermissions:strings,replaces:optString,users:optional(object({create:boolean}))};var roleVisibility=object({visibility:literal("user","declared")});var userVisibilityRole=object({...roleFields,visibility:literal("user")});var declaredVisibilityRole=object({...roleFields,bindings:declaredBindings,visibility:literal("declared")});var userRole=(value,path)=>roleVisibility(value,path).visibility==="declared"?declaredVisibilityRole(value,path):userVisibilityRole(value,path);var knowledgeSelection=optional(object({exclude:optional(array(identity)),include:optional(array(identity))}));var toolBindings2=refine(array(union(identity,object({approval:optional(union(literal("always","never"),object({rule:identity}))),knowledge:optional(object({domains:knowledgeSelection,entitySchemas:knowledgeSelection,relationSchemas:knowledgeSelection,unrestricted:optBoolean})),name:optional(identity),settings:optional(jsonObject),tool:identity}))),(tools)=>duplicateToolBinding(tools)===undefined?undefined:"duplicate tool binding");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 agentAudience2=refine(object({anonymous:optBoolean,applications:optional(array(identity)),members:optional(literal("all","none","selected")),organizationGroups:optional(literal("none","selected"))}),(audience)=>("organizationTeams"in audience)?"organizationTeams":agentAudienceViolation(audience));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}),defaultRole:literal("organization_admin","organization_operator","organization_member"),domains:varyingStrings,enabled:boolean,provisionMembers:boolean}),provider:union(object({fqn:identity}),varyingObject({providerId:identity}))});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 subgroups=(value,path)=>optional(array(object({description:optString,displayName:string,key:string,subgroups})))(value,path);var primitives={agent:refine(object({...base,activity:optional(object({heartbeat:boolean,schedule:boolean})),audience:optional(agentAudience2),behavioralBoundaries:strings,dataAccess:readDataAccess("agent"),kind:literal("agent"),lifecycle,maxSteps:optional(positiveSafeInteger),metadata:optional(studioAgentMetadata(jsonObject)),modelTier:optional(literal(...agentModelTiers)),objectives:strings,operatingInstructions:string,output:optional(object({schema})),responsibility:string,skills:array(identity),tools:toolBindings2}),withoutRetiredAgentFields),connection,connectionInstance:substituted(varyingObject({...base,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,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:object({...base,catalogTags,domainFqn:string,domainName:string,entitySchemaFqns:strings,kind:literal("domainTemplate"),relationSchemaFqns:strings}),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(refine(object({...varyingFields({...base,allowedOrigins:varyingStrings,applicationConsent:optional(literal(...externalApplicationConsents)),applicationType:literal("confidential","public"),audience:string,kind:literal("externalApplication"),lifecycle,postLogoutRedirectUris:varyingStrings,primaryRedirectUri:optString,redirectUris:varyingStrings,scopes:varyingStrings,setupInstructions:optString}),defaultServerRole:optString,groupBindings:optional(array(object({coverage:optional(literal("direct","inherited")),group:string,lifecycle,role:string}))),serverRoles:optional(array(object({...roleFields,bindings:declaredBindings}))),userRoles:array(userRole)}),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: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),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")),recommendedImportSchedules:predefinedSchedules,relationSchemaCapabilities:optional(array(relationCapability)),remoteReference:optional(object({providerKey:identity,urlTemplate:knowledgeRemoteReferenceUrlTemplate})),settings:optional(form),supportedBindingModes:optional(bindingModes)}),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)})),knowledgePolicy:object({...base,...policyFields,kind:literal("knowledgePolicy"),priority:optNumber}),knowledgeRelationAdapter:object({...base,connectorFqn:string,kind:literal("knowledgeRelationAdapter"),relationSchemaFqn:string}),knowledgeRelationSchema:object({...base,...knowledgeSchema,kind:literal("knowledgeRelationSchema"),lifecycle:optional(lifecycle),sourceSchemaFqn:string,targetSchemaFqn:string}),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),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}),remoteToolCollection:refine(object({...base,category:optString,defaultVisibility:optional(array(object({effect:literal("allow","deny"),subject:literal("organization")}))),gatewayRef:identity,kind:literal("remoteToolCollection"),operationReferences:strings}),remoteToolCollectionViolation),servicePrincipal:object({...base,groups:array(identity),kind:literal("servicePrincipal"),organizationRole:literal(...servicePrincipalOrganizationRoles)}),skill:object({dataAccess:readDataAccess("skill"),...base,instructions:string,kind:literal("skill"),lifecycle,tools:toolBindings2}),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,autoActivate:optBoolean,autoInstantiate:optBoolean,bindingScopes:optional(bindingScopes),bindingSettings:optional(form),capabilityType:optional(literal("delegate","external","read","write")),category:optString,connectionRefs,effectKind:optional(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,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:object({...base,category:optString,defaultVisibility:optional(array(object({effect:literal("allow","deny"),subject:literal("organization")}))),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:refine(object({dataAccess:readDataAccess("workflow"),...base,definition:authoringDefinition,kind:literal("workflow"),lifecycle,name:string,slug:string}),(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,contract:nodeContract,kind:literal("workflowNode"),nodeKind:literal("action","input","output","trigger"),presentation:optional(object({categoryPath:optStrings,tags:optStrings}))}),workflowNodeCollection:object({...base,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 primitive=(v,p)=>{const{kind}=object({kind:string})(v,p);for(const[name,read]of Object.entries(primitives)){if(name===kind){return read(v,p)}}return invalid(`${p}/kind`)};var readDependency=object({fqn:hostedIdentity});var parsePackageDependencies=(value)=>{const requirements=array(readDependency)(value,"/dependencies");const identities=new Set;for(const requirement of requirements){if(Object.keys(requirement).some((key)=>key!=="fqn")){throw new TypeError(`package dependency '${requirement.fqn}' has unexpected fields`)}if(identities.has(requirement.fqn)){throw new TypeError(`duplicate package dependency '${requirement.fqn}'`)}identities.add(requirement.fqn)}return[...requirements].sort((left,right)=>compareUtf16CodeUnits(left.fqn,right.fqn))};var PackageManifestVersion="v4";var legacyFixedDestinationTargets=new Set(["fixed-email","channel-destination","telegram-chat","whatsapp-destination"]);var FRONTEND_CATALOG_CONTRACT="frontend-catalog/v1";var FRONTEND_CATALOG_EXPORT_NAME="loadFrontendCatalog";var BACKEND_EXECUTION_LANES=["interactive","job"];var requireIdentityPart=(value,label)=>{if(value.trim()===""||value!==value.trim()){throw new TypeError(`Hosted Contribution ${label} must be non-empty and trimmed`)}};function declareHostedContribution(input){const contributionFqn=input.fqn;const contributionExport=input.exportName;const contributionContract=input.contract;requireIdentityPart(contributionFqn,"FQN");requireIdentityPart(contributionExport,"export name");const execution="execution"in input?input.execution:undefined;if(execution!==undefined){if(input.host!=="backend"){throw new TypeError(`Frontend Hosted Contribution '${contributionFqn}' cannot declare an execution lane`)}if(!BACKEND_EXECUTION_LANES.some((lane)=>lane===execution)){throw new TypeError(`Backend Hosted Contribution '${contributionFqn}' execution must be 'interactive' or 'job'`)}}if(input.host!=="backend"){if(contributionContract!==FRONTEND_CATALOG_CONTRACT){throw new TypeError(`Frontend Hosted Contribution '${contributionFqn}' contract must be '${FRONTEND_CATALOG_CONTRACT}'`)}if(contributionExport!==FRONTEND_CATALOG_EXPORT_NAME){throw new TypeError(`Frontend Hosted Contribution '${contributionFqn}' export must be '${FRONTEND_CATALOG_EXPORT_NAME}'`)}}const manifest=input.host==="backend"?{...input.compatibility===undefined?undefined:{compatibility:input.compatibility},...input.contract===undefined?undefined:{contract:input.contract},...input.execution===undefined?undefined:{execution:input.execution},exportName:input.exportName,fqn:input.fqn,host:input.host}:{...input.compatibility===undefined?undefined:{compatibility:input.compatibility},contract:FRONTEND_CATALOG_CONTRACT,exportName:FRONTEND_CATALOG_EXPORT_NAME,fqn:input.fqn,host:input.host};return{load:input.load,manifest}}var packageVariable=(value,path)=>{const declared=object({default:optional(json),description:optString,type:literal(...packageVariableTypes)})(value,path);const name=path.slice(path.lastIndexOf("/")+1);if(packageVariableViolation(name,declared)!==undefined){return invalid(path)}return declared};var readHostedContribution=(value,path)=>{const shared=object({compatibility:optional(record(string)),contract:optString,execution:optional(literal("interactive","job")),exportName:hostedIdentity,fqn:hostedIdentity,host:literal("backend","dashboard","studio")})(value,path);if(shared.host==="backend"){return{...shared.compatibility===undefined?undefined:{compatibility:shared.compatibility},...shared.contract===undefined?undefined:{contract:shared.contract},...shared.execution===undefined?undefined:{execution:shared.execution},exportName:shared.exportName,fqn:shared.fqn,host:shared.host}}if(shared.execution!==undefined){throw new TypeError(`Invalid package manifest at ${path}/execution: frontend contributions cannot declare an execution lane`)}if(shared.contract!==FRONTEND_CATALOG_CONTRACT){throw new TypeError(`Invalid package manifest at ${path}/contract: frontend contribution contract must be '${FRONTEND_CATALOG_CONTRACT}'`)}if(shared.exportName!==FRONTEND_CATALOG_EXPORT_NAME){throw new TypeError(`Invalid package manifest at ${path}/exportName: frontend contribution export must be '${FRONTEND_CATALOG_EXPORT_NAME}'`)}return{...shared.compatibility===undefined?undefined:{compatibility:shared.compatibility},contract:FRONTEND_CATALOG_CONTRACT,exportName:FRONTEND_CATALOG_EXPORT_NAME,fqn:shared.fqn,host:shared.host}};var readManifest=object({apiVersion:literal(PackageManifestVersion),author:optString,autoInstallable:optBoolean,bindingScopes:optional(array(literal("organization","tenant"))),category:optString,dependencies:optional(parsePackageDependencies),description:optString,documentation:optString,fqn:identity,homepage:optString,hostedContributions:optional(array(readHostedContribution)),icon:optString,installationWizard:optional(object({size:optional(literal("lg","md","xl")),steps:array(object({description:optString,kind:literal("connector_instance","tool_instance"),optional:optBoolean,ref:string,title:optString}))})),name:string,primitives:array(primitive),requiredEnvironmentVariables:optStrings,tags:optStrings,tenantMandatory:optBoolean,tenantStandard:optBoolean,variables:optional(record(packageVariable)),version:string});var PACKAGE_MEDIA_SIZE_LIMIT_BYTES=2*1024*1024;var retiredPrimitiveKinds=new Map(Object.entries({dataset_blueprint:"datasetBlueprint",dataset_parser:"datasetParser",dataset_table_template:"datasetTableTemplate",documents_connector:"documentsConnector",domain_template:"domainTemplate",event_listener:"eventListener",external_application:"externalApplication",external_dataset_provider:"externalDatasetProvider",field_transformer:"fieldTransformer",knowledge_connector:"knowledgeConnector",knowledge_connector_oauth:"knowledgeConnectorOauth",knowledge_entity_adapter:"knowledgeEntityAdapter",knowledge_entity_schema:"knowledgeEntitySchema",knowledge_policy:"knowledgePolicy",knowledge_relation_adapter:"knowledgeRelationAdapter",knowledge_relation_schema:"knowledgeRelationSchema",managed_dataset_provider:"managedDatasetProvider","notification-channel":"notificationChannel",organization_sso:"organizationSso",skill_template:"skillTemplate",studio_app:"studioApp",studio_component:"studioComponent",tool_collection:"toolCollection",tool_settings_options:"toolSettingsOptions",workflow_field:"workflowField",workflow_field_collection:"workflowFieldCollection",workflow_node:"workflowNode",workflow_node_collection:"workflowNodeCollection",workflow_template:"workflowTemplate"}));var retiredGroupNames=new Map(Object.entries({directory_person_in_team:"directory_person_in_group",directory_team:"directory_group",directory_team_parent:"directory_group_parent",organization_team:"organization_group",organization_team_hierarchy:"organization_group_hierarchy",organization_team_membership:"organization_group_membership"}));var toolResultBrand=Symbol.for("@ci/tool-result");var requireIdentity=(value,label)=>{if(value.trim()===""||value!==value.trim()){throw new TypeError(`${label} must be non-empty and trimmed`)}};var freezeJson=(candidate)=>{if(candidate===null||!(candidate instanceof Object)){return}for(const child of Object.values(candidate)){freezeJson(child)}Object.freeze(candidate)};var immutableMetadata=(metadata)=>{const value=parseJsonObject(canonicalJson(metadata));freezeJson(value);return value};var moduleReference=(reference,role)=>{requireIdentity(role,"Frontend implementation role");requireIdentity(reference.exportName,`Frontend '${role}' export name`);if(!(reference.module instanceof URL)){requireIdentity(reference.module,`Frontend '${role}' module`)}return Object.freeze({...reference})};var declareFrontendComponent=(input)=>{for(const[label,value]of Object.entries({"Frontend component FQN":input.target.fqn,"Frontend component role":input.target.role,"Frontend component version":input.target.version,"Frontend package FQN":input.target.packageFqn})){requireIdentity(value,label)}const references=Object.fromEntries(Object.entries(input.implementation).map(([role,reference])=>[role,moduleReference(reference,role)]));const{render}=references;if(render===undefined){throw new TypeError("Frontend component requires a render implementation")}const implementation={...references,render};return Object.freeze({implementation:Object.freeze(implementation),kind:"component",metadata:immutableMetadata(input.metadata??{}),target:Object.freeze({...input.target})})};var requireIdentity2=(value,label)=>{if(value.trim()===""||value!==value.trim()){throw new TypeError(`${label} must be non-empty and trimmed`)}};var declareFrontendPackage=(input)=>{requireIdentity2(input.manifest.fqn,"Frontend package FQN");requireIdentity2(input.manifest.name,"Frontend package name");requireIdentity2(input.manifest.version,"Frontend package version");return Object.freeze({components:Object.freeze([...input.components]),kind:"package",manifest:Object.freeze({...input.manifest})})};var bindingKey=(declaration)=>{const{target}=declaration;return`${target.packageFqn}\x00${target.fqn}\x00${target.version}\x00${target.role}`};var compareStrings=(left,right)=>{if(left<right){return-1}if(left>right){return 1}return 0};var serializableComponent=(declaration)=>({kind:declaration.kind,metadata:declaration.metadata,target:declaration.target});var serializeFrontendDeclaration=(declaration)=>{if(declaration.kind==="component"){return canonicalJson(serializableComponent(declaration))}const components=[...declaration.components].sort((left,right)=>compareStrings(bindingKey(left),bindingKey(right)));return canonicalJson({components:components.map(serializableComponent),kind:declaration.kind,manifest:declaration.manifest})};var bindingKey2=(binding)=>`${binding.packageFqn}\x00${binding.fqn}\x00${binding.version}\x00${binding.role}`;var compareEntries=(left,right)=>{if(left.key<right.key){return-1}if(left.key>right.key){return 1}return 0};var entryFor=(packageFqn,declaration)=>{const{target}=declaration;return Object.freeze({declaration,key:bindingKey2(target),packageFqn,role:target.role,target:target.fqn,version:target.version})};var validateFrontendPackages=(packages)=>{const errors=[];const claims=new Map;for(const frontendPackage of packages){for(const declaration of frontendPackage.components){const{target}=declaration;if(target.packageFqn!==frontendPackage.manifest.fqn){errors.push({code:"cross_package_binding",message:`Package ${frontendPackage.manifest.fqn} cannot bind ${target.fqn} owned by ${target.packageFqn}`,packageFqn:frontendPackage.manifest.fqn,target,targetPackageFqn:target.packageFqn});continue}const entry=entryFor(frontendPackage.manifest.fqn,declaration);if(claims.has(entry.key)){errors.push({code:"duplicate_exact_binding",message:`Exact binding ${target.fqn}@${target.version}/${target.role} is declared more than once`,packageFqn:frontendPackage.manifest.fqn,target,targetPackageFqn:target.packageFqn});continue}claims.set(entry.key,entry)}}if(errors.length>0){return Object.freeze({errors:Object.freeze(errors),kind:"invalid"})}const entries=[...claims.values()].sort(compareEntries);return Object.freeze({entries:Object.freeze(entries),kind:"valid"})};var declareFrontendCatalogContribution=(input)=>declareHostedContribution({...input.compatibility===undefined?undefined:{compatibility:input.compatibility},contract:FRONTEND_CATALOG_CONTRACT,exportName:FRONTEND_CATALOG_EXPORT_NAME,fqn:input.fqn,host:input.host,load:input.load});var isRecord=(value)=>value!==null&&typeof value==="object"&&!Array.isArray(value);var isIdentity=(value)=>typeof value==="string"&&value!==""&&value===value.trim();var isDigest=(value)=>typeof value==="string"&&/^[\da-f]{64}$/u.test(value);var diagnostic=(authority,code,message)=>Object.freeze({diagnostic:Object.freeze({code,contributionFqn:authority.logical.contributionFqn,host:authority.logical.host,message,packageFqn:authority.logical.packageFqn,servingGeneration:authority.logical.servingGeneration}),kind:"rejected"});var isModuleLoader=(value)=>typeof value==="function";var readModuleReference=(value)=>{if(!isRecord(value)||!isIdentity(value.exportName)){return}if(!(value.module instanceof URL)&&!isIdentity(value.module)){return}const reference={exportName:value.exportName,module:value.module};if(value.load===undefined){return reference}return isModuleLoader(value.load)?{...reference,load:value.load}:undefined};var readComponent=(value)=>{if(!isRecord(value)||value.kind!=="component"||!isRecord(value.target)||!isIdentity(value.target.fqn)||!isIdentity(value.target.packageFqn)||!isIdentity(value.target.role)||!isIdentity(value.target.version)||!isRecord(value.implementation)||!isRecord(value.metadata)){return}const implementationEntries=[];for(const[role,reference]of Object.entries(value.implementation)){const parsed=readModuleReference(reference);if(!isIdentity(role)||parsed===undefined){return}implementationEntries.push([role,parsed])}const implementation=Object.fromEntries(implementationEntries);const{render}=implementation;if(render===undefined){return}let metadata;try{metadata=parseJsonObject(canonicalJson(value.metadata))}catch{return}const input={implementation:{...implementation,render},metadata,target:{fqn:value.target.fqn,packageFqn:value.target.packageFqn,role:value.target.role,version:value.target.version}};return declareFrontendComponent(input)};var readPackage=(value)=>{if(!isRecord(value)||value.kind!=="package"||!isRecord(value.manifest)||!isIdentity(value.manifest.fqn)||!isIdentity(value.manifest.name)||!isIdentity(value.manifest.version)||!Array.isArray(value.components)){return{code:"package_shape_invalid",kind:"invalid"}}const components=value.components.map(readComponent);if(components.some((component)=>component===undefined)){return{code:"component_shape_invalid",kind:"invalid"}}return{kind:"valid",value:declareFrontendPackage({components:components.filter((component)=>component!==undefined),manifest:{fqn:value.manifest.fqn,name:value.manifest.name,version:value.manifest.version}})}};var validateAuthority=(authority)=>{const{logical,physical}=authority;if(!isIdentity(logical.contributionFqn)||!isIdentity(logical.packageFqn)||!isIdentity(logical.packageVersion)||typeof logical.servingGeneration!=="string"||!/^(?:0|[1-9]\d*)$/u.test(logical.servingGeneration)||!isIdentity(physical.assetPath)||!Number.isSafeInteger(physical.assetSize)||physical.assetSize<0||!isIdentity(physical.carrierPackageFqn)||!isIdentity(physical.extensionReleaseId)||!isDigest(physical.assetDigest)||!isDigest(physical.extensionReleaseDigest)){return diagnostic(authority,"invalid_provenance","Frontend catalog authority contains invalid logical or physical provenance")}if(logical.contract!==FRONTEND_CATALOG_CONTRACT||physical.contract!==FRONTEND_CATALOG_CONTRACT){return diagnostic(authority,"unsupported_contract",`Frontend catalog contract must be '${FRONTEND_CATALOG_CONTRACT}'`)}if(logical.exportName!==FRONTEND_CATALOG_EXPORT_NAME||physical.exportName!==FRONTEND_CATALOG_EXPORT_NAME){return diagnostic(authority,"unexpected_export",`Frontend catalog export must be '${FRONTEND_CATALOG_EXPORT_NAME}'`)}if(logical.host!==physical.host){return diagnostic(authority,"host_mismatch","Logical and physical frontend catalog Hosts do not match")}if(logical.contributionFqn!==physical.contributionFqn){return diagnostic(authority,"contribution_mismatch","Logical and physical frontend contribution identities do not match")}return};var admitFrontendCatalog=async(input)=>{const authorityFailure=validateAuthority(input.authority);if(authorityFailure!==undefined){return authorityFailure}if(!isRecord(input.loadedModule)){return diagnostic(input.authority,"module_shape_invalid","Frontend catalog module must be an object")}const loader=input.loadedModule[FRONTEND_CATALOG_EXPORT_NAME];if(typeof loader!=="function"){return diagnostic(input.authority,"loader_not_callable",`Frontend catalog module export '${FRONTEND_CATALOG_EXPORT_NAME}' must be callable`)}let loaded;try{loaded=await loader()}catch{return diagnostic(input.authority,"loader_failed","Frontend catalog loader failed before returning declarations")}if(!Array.isArray(loaded)){return diagnostic(input.authority,"result_not_array","Frontend catalog loader must return an array of Frontend Package Declarations")}const packages=[];for(const candidate of loaded){const result=readPackage(candidate);if(result.kind==="invalid"){return diagnostic(input.authority,result.code,result.code==="package_shape_invalid"?"Frontend catalog loader returned an invalid Frontend Package Declaration":"Frontend catalog loader returned an invalid Frontend Component Declaration")}if(result.value.manifest.fqn!==input.authority.logical.packageFqn||result.value.manifest.version!==input.authority.logical.packageVersion){return diagnostic(input.authority,"package_identity_mismatch",`Frontend package '${result.value.manifest.fqn}@${result.value.manifest.version}' does not match authorized package '${input.authority.logical.packageFqn}@${input.authority.logical.packageVersion}'`)}packages.push(result.value)}const packageIdentities=new Set(packages.map(({manifest})=>manifest.fqn));if(packageIdentities.size!==packages.length){return diagnostic(input.authority,"duplicate_package","Frontend catalog loader returned the same package more than once")}const validation=validateFrontendPackages(packages);if(validation.kind==="invalid"){const[first]=validation.errors;return diagnostic(input.authority,first?.code??"component_shape_invalid",first?.message??"Frontend catalog validation failed")}return Object.freeze({authority:input.authority,kind:"admitted",packages:Object.freeze(packages)})};var emptySnapshot=()=>Object.freeze({entries:Object.freeze([]),revision:0});var requireSourceKey=(sourceKey)=>{if(sourceKey.trim()===""||sourceKey!==sourceKey.trim()){throw new TypeError("Frontend catalog source key must be non-empty and trimmed")}};var createFrontendCatalog=()=>{let selectedSourceKey;let currentSnapshot=emptySnapshot();let entriesByKey=new Map;return{activate(packages,options){const sourceKey=options?.sourceKey;if(sourceKey!==undefined){requireSourceKey(sourceKey);if(selectedSourceKey!==undefined&&sourceKey!==selectedSourceKey){return Object.freeze({expectedSourceKey:selectedSourceKey,kind:"stale",reason:"source",receivedSourceKey:sourceKey,snapshot:currentSnapshot})}}const validation=validateFrontendPackages(packages);if(validation.kind==="invalid"){return validation}const{entries}=validation;currentSnapshot=Object.freeze({entries,revision:currentSnapshot.revision+1});entriesByKey=new Map(entries.map((entry)=>[entry.key,entry]));if(sourceKey!==undefined&&selectedSourceKey===undefined){selectedSourceKey=sourceKey}return Object.freeze({kind:"activated",snapshot:currentSnapshot})},resolve(binding){return entriesByKey.get(bindingKey2(binding))},selectSource(sourceKey){requireSourceKey(sourceKey);selectedSourceKey=sourceKey},snapshot(){return currentSnapshot}}};export{admitFrontendCatalog,createFrontendCatalog,declareFrontendCatalogContribution,declareFrontendComponent,declareFrontendPackage,serializeFrontendDeclaration};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@collective-intelligence/extensions-sdk-frontend",
3
- "version": "0.1.12",
3
+ "version": "0.1.13",
4
4
  "description": "Framework-neutral frontend declaration, catalog, and activation contracts for Collective Intelligence extension packages.",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -35,7 +35,7 @@
35
35
  "access": "public"
36
36
  },
37
37
  "dependencies": {
38
- "@collective-intelligence/extensions-sdk": "0.1.12"
38
+ "@collective-intelligence/extensions-sdk": "0.1.13"
39
39
  },
40
40
  "devDependencies": {
41
41
  "@oxlint/plugins": "1.85.0",