@collective-intelligence/extensions-sdk-backend 0.2.3 → 0.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +1 -1
- package/package.json +2 -2
package/dist/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
var __defProp=Object.defineProperty;var __returnValue=(v)=>v;function __exportSetter(name,newValue){this[name]=__returnValue.bind(null,newValue)}var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:true,configurable:true,set:__exportSetter.bind(all,name)})};var exports_src={};__export(exports_src,{BackendPackageSchemaError:()=>BackendPackageSchemaError,DatasetParser:()=>DatasetParser,ExternalDatasetProvider:()=>ExternalDatasetProvider,INBOUND_ATTACHMENT_MAX_BYTES:()=>INBOUND_ATTACHMENT_MAX_BYTES,ManagedDatasetProvider:()=>ManagedDatasetProvider,PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES:()=>PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES,PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS:()=>PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS,PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS:()=>PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS,PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS:()=>PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS,PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES:()=>PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES,PackageConnection:()=>PackageConnection,PackageDocumentsConnector:()=>PackageDocumentsConnector,PackageEmailProvider:()=>PackageEmailProvider,PackageEmailSendError:()=>PackageEmailSendError,PackageEventListener:()=>PackageEventListener,PackageFieldDefinition:()=>PackageFieldDefinition,PackageFieldTransformer:()=>PackageFieldTransformer,PackageInboundMessagingProvider:()=>PackageInboundMessagingProvider,PackageKnowledgeConnector:()=>PackageKnowledgeConnector,PackageKnowledgeConnectorOAuth:()=>PackageKnowledgeConnectorOAuth,PackageKnowledgeEntityAdapter:()=>PackageKnowledgeEntityAdapter,PackageMessageSendError:()=>PackageMessageSendError,PackageNotificationChannel:()=>PackageNotificationChannel,PackageOrganizationSso:()=>PackageOrganizationSso,PackageOutboundMessagingProvider:()=>PackageOutboundMessagingProvider,PackageRuntimeStoreConstraintError:()=>PackageRuntimeStoreConstraintError,PackageRuntimeStoreMissingError:()=>PackageRuntimeStoreMissingError,PackageTool:()=>PackageTool,PackageToolSettingsOptions:()=>PackageToolSettingsOptions,PackageWebhookRejectedError:()=>PackageWebhookRejectedError,PackageWorkflowField:()=>PackageWorkflowField,PackageWorkflowNode:()=>PackageWorkflowNode,PackageWorkflowNodeError:()=>PackageWorkflowNodeError,PackageWorkflowScheduleTrigger:()=>PackageWorkflowScheduleTrigger,accessTest:()=>accessTest,assertPackageRuntimeStorePut:()=>assertPackageRuntimeStorePut,backendInvocationIdentity:()=>backendInvocationIdentity,createBackendPackageRuntime:()=>createBackendPackageRuntime,declareBackendContribution:()=>declareBackendContribution,defineCapability:()=>defineCapability,inboundMessagingBinding:()=>inboundMessagingBinding,isBackendPackageOperationAllowed:()=>isBackendPackageOperationAllowed,packageConnectionToken:()=>packageConnectionToken,packageEmailToken:()=>packageEmailToken,packageOrganizationMemberSelection:()=>packageOrganizationMemberSelection,requirePackageRuntimeStore:()=>requirePackageRuntimeStore,webhookHeader:()=>webhookHeader,withDisplayParts:()=>withDisplayParts});import{accessGrantAxisSlug,canonicalJson as canonicalJson2}from"@collective-intelligence/extensions-sdk";import{access,capabilityCatalogNodes,coreCapabilities,declareAccessCapabilities}from"@collective-intelligence/extensions-sdk";var levelOf=(mode)=>mode==="manage"?2:1;var childLevel=(entryKind,entryLevel,childKind)=>{if(entryKind==="switch"){return childKind==="switch"?1:undefined}if(childKind==="readManage"){return entryLevel}return entryLevel===2?1:undefined};var packageNodes=(declaration)=>capabilityCatalogNodes(declareAccessCapabilities({definition:{grantableBy:declaration.grantableBy,nodes:declaration.nodes},manifest:{fqn:declaration.fqn,version:declaration.version}}));var applicationNodes=(manifest)=>capabilityCatalogNodes(access.accessGate({manifest,schemaSidecars:[]}));var accessTestCatalog=(declarations,applications=[])=>{const nodes=new Map;const children=new Map;for(const node of[...capabilityCatalogNodes(coreCapabilities),...declarations.flatMap(packageNodes),...applications.flatMap(applicationNodes)]){if(nodes.has(node.code)){throw new TypeError(`accessTest: capability '${node.code}' is declared twice`)}nodes.set(node.code,node);if(node.parent!==undefined){children.set(node.parent,[...children.get(node.parent)??[],node.code])}}const node=(code)=>{const found=nodes.get(code);if(found===undefined){throw new TypeError(`accessTest: capability '${code}' is not declared`)}return found};const reach=(levels,entry,entryLevel,code,level)=>{levels.set(code,Math.max(levels.get(code)??0,level));for(const child of children.get(code)??[]){const below=childLevel(entry.kind,entryLevel,node(child).kind);if(below!==undefined){reach(levels,entry,entryLevel,child,below)}}};const expand=(entries)=>{const levels=new Map;for(const{code,mode}of entries){const entry=node(code);if(entry.kind==="switch"!==(mode==="on")){throw new TypeError(`accessTest: '${code}' is a ${entry.kind} node and cannot be granted at '${mode}'`)}reach(levels,entry,levelOf(mode),code,levelOf(mode))}return levels};return{expand,holds:(levels,{mode,requires})=>{node(requires);return(levels.get(requires)??0)>=levelOf(mode)}}};var cutLevels=(levels,maximum)=>new Map([...levels].flatMap(([code,level])=>{const cut=Math.min(level,maximum.get(code)??0);return cut===0?[]:[[code,cut]]}));import{canonicalJson}from"@collective-intelligence/extensions-sdk";var anyAxis=Symbol("any axis");var valuesOf=(value)=>{if(value===undefined||value===null||value===anyAxis){return[]}return Array.isArray(value)?value:[value]};var equal=(left,right)=>canonicalJson({value:left})===canonicalJson({value:right});var pathValue=(root,path)=>{let current=root;for(const segment of path.split(".")){if(current===undefined||current===null||Array.isArray(current)||Object(current)!==current){return}current=current[segment]}return current};var resolve=(operand,record,scope)=>{if("resource"in operand){return record[operand.resource]}if("subject"in operand){return pathValue(scope.subject,operand.subject)}if("grantAxis"in operand){const values=scope.axisValues(operand.grantAxis);return values==="any"?anyAxis:[...values]}return operand.value};var ordered=(left,right,accept)=>{if(left===anyAxis||right===anyAxis){return true}if(typeof left==="number"&&typeof right==="number"){return accept(left-right)}if(typeof left==="string"&&typeof right==="string"){return accept(left.localeCompare(right))}return false};var isText=(value)=>typeof value==="string";var orderOf=(operator)=>{switch(operator){case"lt":{return(order)=>order<0}case"lte":{return(order)=>order<=0}case"gt":{return(order)=>order>0}case"gte":{return(order)=>order>=0}default:{return}}};var compare=(operator,left,right)=>{if(left===anyAxis||right===anyAxis){return true}const order=orderOf(operator);if(order!==undefined){return ordered(left,right,order)}switch(operator){case"eq":{return left!==undefined&&right!==undefined&&equal(left,right)}case"neq":{return left!==undefined&&right!==undefined&&!equal(left,right)}case"isIn":case"overlaps":{const options=valuesOf(right);return valuesOf(left).some((value)=>options.some((option)=>equal(value,option)))}case"contains":{if(Array.isArray(left)){return right!==undefined&&left.some((item)=>equal(item,right))}return isText(left)&&isText(right)&&left.includes(right)}default:{return isText(left)&&isText(right)&&left.startsWith(right)}}};var stringValues=(value)=>valuesOf(value).flatMap((item)=>typeof item==="string"?[item]:[]);var comparisonOf=(condition)=>{if("eq"in condition){return["eq",condition.eq]}if("neq"in condition){return["neq",condition.neq]}if("lt"in condition){return["lt",condition.lt]}if("lte"in condition){return["lte",condition.lte]}if("gt"in condition){return["gt",condition.gt]}if("gte"in condition){return["gte",condition.gte]}if("isIn"in condition){return["isIn",condition.isIn]}if("overlaps"in condition){return["overlaps",condition.overlaps]}if("contains"in condition){return["contains",condition.contains]}return"startsWith"in condition?["startsWith",condition.startsWith]:undefined};var holdsCondition=(condition,record,scope)=>{const me=pathValue(scope.subject,"userId");if("and"in condition){return condition.and.every((item)=>holdsCondition(item,record,scope))}if("or"in condition){return condition.or.some((item)=>holdsCondition(item,record,scope))}if("not"in condition){return!holdsCondition(condition.not,record,scope)}if("condition"in condition){return holdsCondition(scope.condition(condition.condition),record,scope)}if("exists"in condition){return valuesOf(resolve(condition.exists,record,scope)).length>0}if("isNull"in condition){const value=resolve(condition.isNull,record,scope);return value===undefined||value===null}if("isMe"in condition){return me!==undefined&&record[condition.isMe]===me}if("includesMe"in condition){return stringValues(record[condition.includesMe]).some((user)=>user===me)}if("inGroup"in condition){const{coverage,field,group}=condition.inGroup;const members=scope.groupMembers(group,coverage);return stringValues(record[field]).some((user)=>members.has(user))}if("inMyGroups"in condition){const{coverage,field}=condition.inMyGroups;if(typeof me!=="string"){return false}const peers=new Set([...scope.groupsOf(me,coverage)].flatMap((group)=>[...scope.groupMembers(group,"direct")]));return stringValues(record[field]).some((user)=>peers.has(user))}if("via"in condition){return stringValues(record[condition.via.resource]).some((id)=>{const related=scope.entity(id);return related!==undefined&&holdsCondition(condition.via.condition,related,scope)})}const comparison=comparisonOf(condition);if(comparison!==undefined){const[operator,[left,right]]=comparison;return compare(operator,resolve(left,record,scope),resolve(right,record,scope))}throw new TypeError(`accessTest: unknown condition ${JSON.stringify(condition)}`)};var fqnOf=(reference)=>typeof reference==="string"?reference:reference.manifest.fqn;var fail=(message)=>{throw new TypeError(`accessTest: ${message}`)};var indexBy=(declarations)=>new Map(declarations.map((declaration)=>[declaration.fqn,declaration]));var selects=(selection,key)=>{if(selection===undefined){return true}return"except"in selection?!selection.except.includes(key):selection.includes(key)};var corePolicy=({capability})=>({capability,otherAxes:"unscoped"});var accessTest=(packages,options={})=>{const primitives=(Array.isArray(packages)?packages:[packages]).flatMap((definition)=>definition.manifest.primitives);const declared=(kind)=>primitives.filter((primitive)=>primitive.kind===kind);const catalog=accessTestCatalog(declared("accessCapabilities"),declared("externalApplication"));const profiles=indexBy(declared("accessProfile"));const axes=indexBy(declared("accessGrantAxis"));const conditions=indexBy(declared("accessKnowledgeDataCondition"));const maxPrivileges=indexBy(declared("accessMaxPrivileges"));const policies=declared("accessKnowledgeDataPolicy");const entities=new Map((options.entities??[]).map((entity)=>[entity.id,{data:entity.data,schema:fqnOf(entity.schema)}]));const groups=new Map((options.groups??[]).map((group)=>[group.fqn,group]));const subgroupsOf=(group)=>[group,...[...groups.values()].filter(({parent})=>parent===group).flatMap(({fqn})=>subgroupsOf(fqn))];const covered=(group,coverage)=>coverage==="inherited"?subgroupsOf(group):[group];const groupMembers=(group,coverage)=>new Set(covered(group,coverage).flatMap((fqn)=>groups.get(fqn)?.members??[]));const groupsOf=(user,coverage)=>new Set([...groups.values()].filter(({members})=>members?.includes(user)===true).flatMap(({fqn})=>covered(fqn,coverage)));const condition=(fqn)=>conditions.get(fqn)?.where??fail(`condition '${fqn}' is not declared`);const entity=(id)=>{const found=entities.get(id);return found===undefined?undefined:{...found.data,id}};const scope=(user,tuple)=>({axisValues:(axis)=>tuple?.axes.get(axis)??"any",condition,entity,groupMembers,groupsOf,subject:{userId:user}});const axis=(fqn)=>axes.get(fqn)??fail(`Grant Axis '${fqn}' is not declared`);const resolveValue=(axisFqn,value)=>{if(typeof value==="string"){return value}const{field,value:wanted}=value.knowledgeEntity;const{target}=axis(axisFqn);const matches=[...entities].filter(([,{data,schema}])=>schema===target&&data[field]===wanted);const[match]=matches;return matches.length===1&&match!==undefined?match[0]:fail(`knowledgeEntity({ ${field}: "${wanted}" }) does not name one entity of '${target}'`)};const subtree=(axisFqn,id)=>{const{hierarchy,target}=axis(axisFqn);const values=new Set([id]);if(hierarchy===undefined){return values}const parents=new Map;const children=new Map;for(const[child,{data,schema}]of entities){const parent=data[hierarchy];if(schema===target&&typeof parent==="string"){parents.set(child,parent);children.set(parent,[...children.get(parent)??[],child])}}const seen=new Set;for(let parent=parents.get(id);parent!==undefined;parent=parents.get(parent)){if(parent===id){return values}if(seen.has(parent)){break}seen.add(parent)}for(const value of values){for(const child of children.get(value)??[]){values.add(child)}}return values};const tupleOf=(grant)=>{if("capabilities"in grant){return{axes:new Map,levels:catalog.expand(grant.capabilities)}}const fqn=fqnOf(grant.profile);const profile=profiles.get(fqn)??fail(`profile '${fqn}' is not declared`);const given=grant.axes??{};const profileAxes=profile.axes??[];if(Object.keys(given).length!==profileAxes.length){fail(`a grant of '${fqn}' sets one value for each axis of the profile`)}return{axes:new Map(profileAxes.map((axisFqn)=>{const slug=accessGrantAxisSlug(axisFqn);const value=given[slug]??fail(`a grant of '${fqn}' has no value for the axis '${slug}'`);return[axisFqn,subtree(axisFqn,resolveValue(axisFqn,value))]})),levels:catalog.expand(profile.capabilities)}};const policiesOf=(schema,operation)=>{const target=fqnOf(schema);const own=policies.filter((policy)=>policy.target===target&&policy.operation===operation);const core=(options.corePolicies??[]).filter((policy)=>policy.data==="knowledge"&&policy.operation===operation);const slotIsEmpty=(purpose)=>!own.some((policy)=>policy.purpose===purpose);return[...own,...core.filter((policy)=>policy.kind==="tenant"||policy.kind==="default"&&slotIsEmpty("access")||policy.kind==="admin"&&slotIsEmpty("administration")).map(corePolicy)]};const bindingValues=(record,binding)=>{if("self"in binding){return stringValues(record.id)}if("field"in binding){return stringValues(record[binding.field])}const{field,key}=binding.relation;return stringValues(record[key]).flatMap((id)=>stringValues(entity(id)?.[field]))};return{as:(principal)=>{const cap=principal.maxPrivileges===undefined?undefined:catalog.expand((maxPrivileges.get(fqnOf(principal.maxPrivileges))??fail(`Max Privileges '${fqnOf(principal.maxPrivileges)}' are not declared`)).capabilities);const tuples=(principal.grants??[]).map((grant)=>{const tuple=tupleOf(grant);return cap===undefined?tuple:{...tuple,levels:cutLevels(tuple.levels,cap)}});const admits=(policy,tuple,record)=>{if(!catalog.holds(tuple.levels,policy.capability)){return false}for(const[axisFqn,values]of tuple.axes){const rule=policy.axes?.find((candidate)=>candidate.axis===axisFqn);if(rule===undefined&&policy.otherAxes!=="unscoped"){return false}if(rule!==undefined&&"map"in rule&&!bindingValues(record,rule.map).some((value)=>values.has(value))){return false}}return policy.where===undefined||holdsCondition(policy.where,record,scope(principal.user,tuple))};const admitting=(schema,operation,record)=>policiesOf(schema,operation).flatMap((policy)=>tuples.filter((tuple)=>admits(policy,tuple,record)).map(()=>policy));const read=(schema,record)=>{const pairs=admitting(schema,"read",record);return pairs.length===0?undefined:Object.fromEntries(Object.entries(record).filter(([key])=>key==="id"||pairs.some(({readableFields})=>selects(readableFields,key))))};return{canRead:(schema,record)=>read(schema,record)!==undefined,canUpdate:(schema,stored,proposed)=>{const changed=[...new Set([...Object.keys(stored),...Object.keys(proposed)])].filter((key)=>canonicalJson2({value:stored[key]??null})!==canonicalJson2({value:proposed[key]??null})||Object.hasOwn(stored,key)!==Object.hasOwn(proposed,key));return policiesOf(schema,"write").some((policy)=>tuples.some((tuple)=>admits(policy,tuple,stored)&&admits(policy,tuple,proposed)&&changed.every((key)=>selects(policy.writableFields,key))))},canWrite:(schema,record)=>admitting(schema,"write",record).length>0,holds:(requirement)=>tuples.some((tuple)=>catalog.holds(tuple.levels,requirement)),read}},conditionTests:()=>[...conditions.values()].flatMap(({fqn,tests,where})=>(tests??[]).map(({expected,name,record,subject})=>{const user=subject?.userId;const actual=holdsCondition(where,record,{...scope(typeof user==="string"?user:""),subject:subject??{}});return{condition:fqn,expected,name,passed:actual===expected}}))}};class PackageConnection{}class ManagedDatasetProvider{}class ExternalDatasetProvider{}class DatasetParser{}class PackageDocumentsConnector{}class PackageEmailSendError extends Error{name="PackageEmailSendError";category;outcome;constructor(input){super(input.message);this.category=input.category;this.outcome=input.outcome;if(input.statusCode!==undefined){this.statusCode=input.statusCode}if(input.retry!==undefined){this.retry=input.retry}if(input.replay!==undefined){this.replay=input.replay}if(input.operationId!==undefined){this.operationId=input.operationId}if(input.diagnosticId!==undefined){this.diagnosticId=input.diagnosticId}}}class PackageEmailProvider{prepare(_input,_context){return{quotas:[]}}}class PackageEventListener{canonicalSelector(selector){return selector}routeKeys(_selector){return{}}broadRouteKeys(){return{}}}var INBOUND_ATTACHMENT_MAX_BYTES=25*1024*1024;var isRecord=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value);var isText2=(value)=>typeof value==="string";var inboundMessagingBinding=(context)=>{const{connection,messaging,state}=context.config??{};if(!isRecord(connection)||!isText2(connection.id)||!isRecord(connection.values)||!isRecord(messaging)||!isText2(messaging.service)){throw new TypeError("An inbound messaging provider requires config.connection and config.messaging.service")}const values={};for(const[field,value]of Object.entries(connection.values)){if(value!==null&&!isText2(value)){throw new TypeError(`Connection value '${field}' must be a string`)}values[field]=value}const verifyToken=isRecord(state)?state.verify_token:undefined;const token=isRecord(verifyToken)?verifyToken.token:undefined;return{connection:{id:connection.id,values},service:messaging.service,verifyToken:isText2(token)?token:undefined}};var webhookHeader=(request,name)=>{const wanted=name.toLowerCase();return Object.entries(request.headers).find(([header])=>header.toLowerCase()===wanted)?.[1]};class PackageWebhookRejectedError extends Error{name="PackageWebhookRejectedError";reason;constructor(reason){super(`Webhook request rejected: ${reason}`);this.reason=reason}}var enrichmentOptions=["detectLanguage","transcribe"];var askedEnrichment=(enrichment)=>{const asked=enrichmentOptions.filter((option)=>enrichment?.[option]===true);return asked.length===0?{}:{enrichment:Object.fromEntries(asked.map((option)=>[option,true]))}};var failed=(draft,reason)=>({filename:draft.filename,kind:draft.kind,reason,status:"failed"});var storeAttachment=async(draft,context)=>{if(draft.sizeBytes!==undefined&&draft.sizeBytes>INBOUND_ATTACHMENT_MAX_BYTES){return failed(draft,"too_large")}if(context.captureContent===undefined){throw new TypeError("An inbound messaging provider requires context.captureContent")}let content;try{content=await draft.download()}catch{context.signal?.throwIfAborted();return failed(draft,"download_failed")}if(content==="too_large"||content.byteLength>INBOUND_ATTACHMENT_MAX_BYTES){return failed(draft,"too_large")}const{contentType,filename,kind}=draft;const stored=await context.captureContent({content,contentType,filename});return{contentType,filename,kind,sizeBytes:stored.sizeBytes,status:"stored",storageFileId:stored.storageFileId}};var occurrencesOf=async(drafts,context)=>{const{connection,service}=inboundMessagingBinding(context);const occurrences=[];for(const draft of drafts){if(draft.fromSelf){continue}const attachments=[];for(const attachment of draft.attachments){attachments.push(await storeAttachment(attachment,context))}const{id:conversationId}=draft.conversationIdentity;const payload={attachments,connectionId:connection.id,conversation:draft.conversation,conversationIdentity:draft.conversationIdentity,messageId:draft.messageId,receivedAt:draft.receivedAt,sender:draft.sender,service,text:draft.text,vendorExtras:draft.vendorExtras};occurrences.push({eventKey:`${service}:${conversationId}:${draft.messageId}`,payload,routeKeys:{...draft.routeKeys??{conversation:conversationId},service},safeSummary:{connectionId:connection.id,messageId:draft.messageId,service}})}return occurrences};class PackageInboundMessagingProvider extends PackageEventListener{canonicalFilter(filter){return filter}canonicalSelector(selector){const{enrichment,...filter}=selector;return{...this.canonicalFilter(filter),...askedEnrichment(enrichment)}}async normalizeWebhookRequest(request,context){await this.verifyWebhook(request,context);return await occurrencesOf(await this.messagesFromWebhook(request,context),context)}async poll(request,context){if(this.pollMessages===undefined){throw new TypeError("This inbound messaging provider does not poll")}const{messages,nextCheckpoint}=await this.pollMessages(request.checkpoint,context);return{nextCheckpoint,occurrences:await occurrencesOf(messages,context)}}}class PackageMessageSendError extends Error{name="PackageMessageSendError";code;constructor(input){super(input.message);this.code=input.code;if(input.statusCode!==undefined){this.statusCode=input.statusCode}}}class PackageOutboundMessagingProvider{}class PackageKnowledgeConnector{}class PackageKnowledgeConnectorOAuth{}class PackageKnowledgeEntityAdapter{}class PackageNotificationChannel{}class PackageOrganizationSso{}class PackageTool{}class PackageToolSettingsOptions{}import{toolResultBrand}from"@collective-intelligence/extensions-sdk";var withDisplayParts=(output,displayParts)=>({displayParts,output,[toolResultBrand]:true});class PackageFieldTransformer{}class PackageWorkflowNode{}class PackageWorkflowScheduleTrigger extends PackageWorkflowNode{}class PackageWorkflowNodeError extends Error{name="PackageWorkflowNodeError";code;constructor(input){super(input.message);this.code=input.code;Object.defineProperty(this,"message",{enumerable:true})}}class PackageFieldDefinition{supportsOptionPaging=false;canonicalize(value,_config){return value}validateLocal(value,_config){return value}validateAuthoritative(value,_config,_context){return value}parts(_config){return[]}getOptions(_input,_context){return[]}}class PackageWorkflowField extends PackageFieldDefinition{}var isObjectLike=(value)=>value!==null&&Object(value)===value;var defineCapability=(id,requiredKeys)=>({id,isService:(value)=>isObjectLike(value)&&requiredKeys.every((key)=>Object.hasOwn(value,key))});class PackageRuntimeStoreMissingError extends Error{name="PackageRuntimeStoreMissingError";constructor(){super("Package runtime store is not available on this invocation")}}class PackageRuntimeStoreConstraintError extends Error{name="PackageRuntimeStoreConstraintError"}var isJsonObjectValue=(value)=>Object.prototype.toString.call(value)==="[object Object]"&&!Array.isArray(value)&&(Object.getPrototypeOf(value)===Object.prototype||Object.getPrototypeOf(value)===null);var PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES=512;var PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES=64*1024;var PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS=60;var PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS=30*24*60*60;var PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS=100;var utf8=new TextEncoder;var utf8ByteLength=(value)=>utf8.encode(value).byteLength;var assertPackageRuntimeStorePut=(key,value,ttlSeconds)=>{if(utf8ByteLength(key)>PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES){throw new PackageRuntimeStoreConstraintError("Package runtime store keys must be at most 512 bytes")}if(!isJsonObjectValue(value)){throw new PackageRuntimeStoreConstraintError("Package runtime store values must be JSON objects")}if(utf8ByteLength(JSON.stringify(value))>PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES){throw new PackageRuntimeStoreConstraintError("Package runtime store values must be at most 64 KiB")}if(!Number.isFinite(ttlSeconds)||ttlSeconds<PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS||ttlSeconds>PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS){throw new PackageRuntimeStoreConstraintError("Package runtime store TTL must be between 1 minute and 30 days")}};var requirePackageRuntimeStore=(context)=>{const{store}=context;if(store===undefined){throw new PackageRuntimeStoreMissingError}return{delete:(key)=>store.delete(key),get:(key)=>store.get(key),list:(prefix)=>store.list(prefix),put:(key,value,ttlSeconds)=>{assertPackageRuntimeStorePut(key,value,ttlSeconds);return store.put(key,value,ttlSeconds)}}};var packageOrganizationMemberSelection=defineCapability("collective_intelligence.organization_member_selection",["search","resolve","validate"]);import{declareHostedContribution}from"@collective-intelligence/extensions-sdk";var declareBackendContribution=(input)=>declareHostedContribution({...input,host:"backend"});var backendInvocationIdentity=(input)=>Object.freeze({...input,host:"backend",source:Object.freeze({...input.source})});var operations=[{kind:"connection",operations:["test","discover","test_and_discover"]},{kind:"datasetParser",operations:["analyze","parse_records"]},{kind:"documentsConnector",operations:["pull","fetch_content","fetch_source","read_file_revisions","delta_page","prove_root_ancestry","list_drives","list_folders"]},{kind:"emailProvider",operations:["prepare","send"]},{kind:"eventListener",operations:["canonical_selector","route_keys","broad_route_keys","parse_selector","normalize_internal","normalize_webhook","normalize_webhook_request","poll","register_webhook","unregister_webhook"]},{kind:"externalDatasetProvider",operations:["readiness","list_sources","discover_definition","dataset_query","dataset_inspect"]},{kind:"fieldTransformer",operations:["transform","inverse"]},{kind:"knowledgeConnector",operations:["browse","discover","pull","push","read","read_record"]},{kind:"knowledgeConnectorOauth",operations:["authorize_url","exchange_code"]},{kind:"knowledgeEntityAdapter",operations:["remote_id","to_local","to_remote","extra_props","normalize_field_map_value","normalize_imported_data"]},{kind:"managedDatasetProvider",operations:["readiness","dataset_provision","dataset_ingest","dataset_query","dataset_inspect","dataset_delete"]},{kind:"notificationChannel",operations:["deliver"]},{kind:"organizationSso",operations:["authorization_url","exchange_code"]},{kind:"outboundMessagingProvider",operations:["send"]},{kind:"tool",operations:["execute","health_check"]},{kind:"toolSettingsOptions",operations:["get_options"]},{kind:"workflowField",operations:["canonicalize","validate_local","validate_authoritative","parts","get_options"]},{kind:"workflowNode",operations:["execute"]}];var isBackendPackageOperationAllowed=(kind,operation)=>operations.some((entry)=>entry.kind===kind&&entry.operations.some((method)=>method===operation));class BackendPackageSchemaError extends Error{name="BackendPackageSchemaError";stage;location;issues;constructor(stage,location,issues){super(`${location}: ${stage}: ${issues.map((issue)=>issue.message).join("; ")}`);this.stage=stage;this.location=location;this.issues=issues}}import{canonicalJson as canonicalJson3,toolResultBrand as toolResultBrand2}from"@collective-intelligence/extensions-sdk";var TOOL_RESULT_ENVELOPE_KEY="@ci/tool-result";var isCodec=(value)=>("encode"in value)&&typeof value.encode==="function"&&("project"in value)&&typeof value.project==="function";var wireValue=(value)=>JSON.parse(canonicalJson3(value));var operationMethod=(operation)=>operation.replaceAll(/_(?<letter>[a-z])/gu,(_match,letter)=>letter.toUpperCase());var methodOf=(instance,operation)=>{const method=Reflect.get(instance,operationMethod(operation));if(operation==="extra_props"&&method===undefined){return()=>null}if(operation==="normalize_imported_data"&&method===undefined){return(local)=>local}if(operation==="normalize_field_map_value"&&method===undefined){return(value)=>value}if(operation==="validate_authoritative"&&method===undefined){return(value)=>value}if(operation==="parse_selector"&&method===undefined){return(selector)=>selector}if(typeof method!=="function"){throw new TypeError(`Unsupported package operation '${operation}'`)}return method};var isToolResultWithDisplay=(value)=>typeof value==="object"&&value!==null&&(toolResultBrand2 in value);var isRecord2=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value);var operationSchema=(manifest,direction,operation)=>{if(manifest.kind==="workflowField"&&(operation==="canonicalize"||operation==="validate_local"||operation==="validate_authoritative")&&manifest.contract.valueSchema!==undefined){return{location:`workflow_field:${manifest.fqn}.contract.valueSchema`,projection:manifest.contract.valueSchema}}if(manifest.kind==="tool"&&operation==="execute"){return{location:`tool:${manifest.fqn}.${direction}`,projection:direction==="input"?manifest.input:manifest.output}}if(manifest.kind==="connection"&&direction==="input"){return{location:`connection:${manifest.fqn}.credential.schema`,projection:manifest.credential.schema}}if(manifest.kind==="workflowNode"){const projection=direction==="input"?manifest.contract.inputSchema:manifest.contract.outputSchema;if(projection!==undefined){return{location:`workflow_node:${manifest.fqn}.contract.${direction}Schema`,projection}}}return};var sidecarFor=(component,direction,operation)=>{const{manifest}=component;const boundary=operationSchema(manifest,direction,operation);if(!boundary){return}const{location,projection}=boundary;const matches=component.schemaSidecars.filter((item)=>item.location===location);const[source]=matches;if(manifest.kind==="workflowField"&&direction==="output"&&source!==undefined&&!isCodec(source.source)){return}if(matches.length!==1||source===undefined||manifest.kind!=="workflowField"&&source.direction!==direction||direction==="output"&&!isCodec(source.source)){throw new BackendPackageSchemaError("stale_manifest",location,[])}const actual=source.direction==="output"&&isCodec(source.source)?source.source.project("output"):source.source.project("input");if(canonicalJson3(actual)!==canonicalJson3(projection)){throw new BackendPackageSchemaError("stale_manifest",location,[])}return source};var schemaProjection=(manifest,location)=>{const prefix=`:${manifest.fqn}.`;const offset=location.indexOf(prefix);if(offset===-1){throw new BackendPackageSchemaError("stale_manifest",location,[])}const keys=location.slice(offset+prefix.length).replaceAll(/\[(?<index>\d+)\]/gu,".$<index>").split(".");let current=manifest;for(const key of keys){if(typeof current!=="object"||current===null){throw new BackendPackageSchemaError("stale_manifest",location,[])}current=Reflect.get(current,key)}return current};var isSchemaInvocation=(call)=>call.operation==="decode_schema"||call.operation==="encode_schema";var invokeSchema=async(component,call)=>{const matches=component.schemaSidecars.filter((sidecar)=>sidecar.location===call.schemaLocation);const[sidecar]=matches;if(matches.length!==1||sidecar===undefined){throw new BackendPackageSchemaError("stale_manifest",call.schemaLocation,[])}const codec=isCodec(sidecar.source)?sidecar.source:undefined;const projection=sidecar.direction==="output"&&codec?codec.project("output"):sidecar.source.project("input");if(canonicalJson3(projection)!==canonicalJson3(schemaProjection(component.manifest,call.schemaLocation))){throw new BackendPackageSchemaError("stale_manifest",call.schemaLocation,[])}if(call.operation==="encode_schema"&&codec===undefined){throw new BackendPackageSchemaError("stale_manifest",call.schemaLocation,[])}const result=call.operation==="encode_schema"&&codec?await codec.encode(call.input):await sidecar.source.validate(call.input);call.signal.throwIfAborted();if(result.issues!==undefined){throw new BackendPackageSchemaError(call.operation==="encode_schema"?"output_encode":"input_decode",call.schemaLocation,result.issues)}return wireValue(result.value)};var webhookBody=(input)=>{if(!isRecord2(input)||!Array.isArray(input.bodyBytes)){throw new TypeError("Webhook bodyBytes must be a byte array")}const bytes=[];for(const byte of input.bodyBytes){if(typeof byte!=="number"||!Number.isInteger(byte)||byte<0||byte>255){throw new TypeError("Webhook byte must be an integer from 0 to 255")}bytes.push(byte)}return new Uint8Array(bytes)};var webhookRequest=(input)=>{const body=webhookBody(input);if(!isRecord2(input)||!isRecord2(input.headers)){throw new TypeError("Webhook headers must be a string record")}const entries=[];for(const[key,value]of Object.entries(input.headers)){if(typeof value!=="string"){throw new TypeError("Webhook headers must be strings")}entries.push([key,value])}const headers=Object.fromEntries(entries);return{body,headers,...typeof input.receivedAt==="string"&&{receivedAt:input.receivedAt},...typeof input.url==="string"&&{url:input.url}}};var parserArguments=(call,value)=>{if(!isRecord2(value)||!Array.isArray(value.bytes)||typeof value.maxRows!=="number"||!Number.isSafeInteger(value.maxRows)||value.maxRows<1){throw new TypeError("Dataset parser requires bytes and a positive safe integer maxRows")}const bytes=[];for(const byte of value.bytes){if(typeof byte!=="number"||!Number.isInteger(byte)||byte<0||byte>255){throw new TypeError("Dataset parser bytes must be integers from 0 to 255")}bytes.push(byte)}const input={bytes:new Uint8Array(bytes),maxRows:value.maxRows};if(call.operation==="parse_records"){if(!Array.isArray(value.fields)||!value.fields.every((field)=>isRecord2(field)&&typeof field.key==="string"&&field.key.length>0&&typeof field.label==="string"&&typeof field.nullable==="boolean"&&["boolean","int64","float64","decimal","date","duration","json","timestamp","string"].includes(String(field.type)))){throw new TypeError("Dataset parser requires valid fields")}return[{...input,fields:value.fields}]}return[input]};var documentsSourceWire=(source,message)=>{if(source===null){return null}if(isRecord2(source)&&typeof source.webUrl==="string"){return{webUrl:source.webUrl}}throw new TypeError(message)};var documentsFetchContentWire=(result)=>{if(!isRecord2(result)||!(result.bytes instanceof Uint8Array)){throw new TypeError("Documents fetchContent must return { bytes: Uint8Array }")}for(const field of["mimeType","extension","filename"]){if(result[field]!==undefined&&typeof result[field]!=="string"){throw new TypeError(`Documents fetchContent ${field} must be a string`)}}const wire={bytesBase64:Buffer.from(result.bytes).toString("base64")};if(typeof result.mimeType==="string"){wire.mimeType=result.mimeType}if(typeof result.extension==="string"){wire.extension=result.extension}if(typeof result.filename==="string"){wire.filename=result.filename}if(result.source!==undefined){wire.source=documentsSourceWire(result.source,"Documents fetchContent source must be { webUrl: string } or null")}return wire};var jsonResult=(kind,operation,result)=>{if(kind==="documentsConnector"&&operation==="fetch_source"){return wireValue(documentsSourceWire(result,"Documents fetchSource must return { webUrl: string } or null"))}if(result===undefined){return null}if(kind==="documentsConnector"&&operation==="fetch_content"){return wireValue(documentsFetchContentWire(result))}return wireValue(result)};var extraPropsArguments=(value)=>{if(!isRecord2(value)||!isRecord2(value.remote)||value.schemaMeta!==null&&!isRecord2(value.schemaMeta)||value.originalRemote!==undefined&&!isRecord2(value.originalRemote)){throw new TypeError("extraProps requires remote and schemaMeta records (or null schemaMeta), and an optional originalRemote record")}return value.originalRemote===undefined?[value.remote,value.schemaMeta]:[value.remote,value.schemaMeta,value.originalRemote]};var workflowFieldArguments=(call,value,context)=>{if(call.operation==="validate_authoritative"&&(!isRecord2(call.context)||typeof call.context.organizationId!=="string"||call.context.organizationId.length===0||typeof call.context.capability!=="function")){throw new TypeError("Authoritative field validation requires caller context")}if(call.operation==="parts"){return[context.config]}return call.operation==="validate_authoritative"?[value,context.config,context]:[value,context.config]};var invocationArguments=(call,kind,value)=>{const context={...call.context,signal:call.signal};if(kind==="tool"&&call.operation==="health_check"||kind==="eventListener"&&call.operation==="unregister_webhook"){return[context]}if(kind==="datasetParser"){return parserArguments(call,value)}if(kind==="eventListener"&&call.operation==="normalize_webhook"){return[webhookBody(value),context]}if(kind==="eventListener"&&call.operation==="normalize_webhook_request"){return[webhookRequest(value),context]}if(kind==="knowledgeEntityAdapter"&&call.operation==="extra_props"){return extraPropsArguments(value)}if(kind==="knowledgeEntityAdapter"&&call.operation==="normalize_imported_data"){if(!isRecord2(value)||!("local"in value)||!("remote"in value)){throw new TypeError("normalizeImportedData requires local and remote data")}return[value.local,value.remote]}const progress=(event)=>{if(!call.signal.aborted){call.onProgress?.(wireValue(event))}};if(kind==="workflowField"&&call.operation!=="get_options"){return workflowFieldArguments(call,value,context)}return[value,context,progress]};var acknowledgeTested=async(observer,signal)=>{signal.throwIfAborted();await new Promise((resolve,reject)=>{const aborted=()=>{reject(signal.reason)};signal.addEventListener("abort",aborted,{once:true});Promise.resolve().then(()=>{signal.throwIfAborted();return observer()}).then(resolve,reject).finally(()=>{signal.removeEventListener("abort",aborted)})});signal.throwIfAborted()};var testAndDiscover=async(instance,call,args)=>{await methodOf(instance,"test").apply(instance,args);call.signal.throwIfAborted();if(!call.discover){return{catalog:null}}if(call.onTested){await acknowledgeTested(call.onTested,call.signal)}const catalog=await methodOf(instance,"discover").apply(instance,args);call.signal.throwIfAborted();return{catalog:wireValue(catalog)}};var encodeResult=async(kind,call,output,result)=>{if(!output){return jsonResult(kind,call.operation,result)}if(!isCodec(output.source)){throw new BackendPackageSchemaError("stale_manifest",output.location,[])}const workflowResult=kind==="workflowNode"&&isRecord2(result)?result:undefined;if(workflowResult&&"directive"in workflowResult){return wireValue(workflowResult)}const encoded=await output.source.encode(workflowResult?workflowResult.outputs:result);if(encoded.issues){throw new BackendPackageSchemaError("output_encode",output.location,encoded.issues)}return wireValue(workflowResult?{...workflowResult,outputs:encoded.value}:encoded.value)};var invokeBackendPackageComponent=async(component,call)=>{if(isSchemaInvocation(call)){return await invokeSchema(component,call)}if(!("implementation"in component)){throw new TypeError(`Component '${call.componentFqn}' has no implementation`)}const{manifest}=component;if(!isBackendPackageOperationAllowed(manifest.kind,call.operation)){throw new TypeError(`Unsupported ${manifest.kind} operation '${call.operation}'`)}const input=sidecarFor(component,"input",call.operation);const output=sidecarFor(component,"output",call.operation);const decoded=input?await input.source.validate(call.input):{value:call.input};if(decoded.issues){throw new BackendPackageSchemaError("input_decode",input?.location??call.componentFqn,decoded.issues)}call.signal.throwIfAborted();const instance=new component.implementation;const args=invocationArguments(call,manifest.kind,decoded.value);if(call.operation==="test_and_discover"){return await testAndDiscover(instance,call,args)}const result=await methodOf(instance,call.operation).apply(instance,args);call.signal.throwIfAborted();if(manifest.kind==="tool"&&call.operation==="execute"&&isToolResultWithDisplay(result)){return wireValue({[TOOL_RESULT_ENVELOPE_KEY]:1,displayParts:result.displayParts.flatMap((part)=>{try{return[wireValue(part)]}catch{return[]}}),output:await encodeResult(manifest.kind,call,output,result.output)})}return await encodeResult(manifest.kind,call,output,result)};var componentOf=(packages,call)=>{const component=packages.get(call.packageFqn)?.components.find((item)=>item.manifest.fqn===call.componentFqn);if(!component){throw new TypeError(`Unknown executable component '${call.packageFqn}/${call.componentFqn}'`)}return component};var createBackendPackageRuntime=(definitions)=>{const packages=new Map;for(const definition of definitions){if(packages.has(definition.manifest.fqn)){throw new TypeError(`Duplicate package '${definition.manifest.fqn}'`)}const components=new Set;for(const component of definition.components){if(components.has(component.manifest.fqn)){throw new TypeError(`Duplicate component '${component.manifest.fqn}'`)}components.add(component.manifest.fqn)}packages.set(definition.manifest.fqn,definition)}return{async invoke(call){call.signal.throwIfAborted();return await invokeBackendPackageComponent(componentOf(packages,call),call)}}};var packageConnectionToken=defineCapability("collective_intelligence.connection_token",["getToken"]);var packageEmailToken=defineCapability("collective_intelligence.email_token",["getToken"]);var{accessTest:accessTest2,assertPackageRuntimeStorePut:assertPackageRuntimeStorePut2,backendInvocationIdentity:backendInvocationIdentity2,BackendPackageSchemaError:BackendPackageSchemaError2,createBackendPackageRuntime:createBackendPackageRuntime2,DatasetParser:DatasetParser2,declareBackendContribution:declareBackendContribution2,defineCapability:defineCapability2,ExternalDatasetProvider:ExternalDatasetProvider2,ManagedDatasetProvider:ManagedDatasetProvider2,INBOUND_ATTACHMENT_MAX_BYTES:INBOUND_ATTACHMENT_MAX_BYTES2,inboundMessagingBinding:inboundMessagingBinding2,isBackendPackageOperationAllowed:isBackendPackageOperationAllowed2,PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES:PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES2,PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS:PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS2,PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS:PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS2,PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS:PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS2,PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES:PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES2,PackageConnection:PackageConnection2,PackageDocumentsConnector:PackageDocumentsConnector2,PackageEmailProvider:PackageEmailProvider2,PackageEmailSendError:PackageEmailSendError2,packageConnectionToken:packageConnectionToken2,packageEmailToken:packageEmailToken2,packageOrganizationMemberSelection:packageOrganizationMemberSelection2,PackageEventListener:PackageEventListener2,PackageFieldDefinition:PackageFieldDefinition2,PackageFieldTransformer:PackageFieldTransformer2,PackageInboundMessagingProvider:PackageInboundMessagingProvider2,PackageKnowledgeConnector:PackageKnowledgeConnector2,PackageKnowledgeConnectorOAuth:PackageKnowledgeConnectorOAuth2,PackageKnowledgeEntityAdapter:PackageKnowledgeEntityAdapter2,PackageMessageSendError:PackageMessageSendError2,PackageNotificationChannel:PackageNotificationChannel2,PackageOrganizationSso:PackageOrganizationSso2,PackageOutboundMessagingProvider:PackageOutboundMessagingProvider2,PackageRuntimeStoreConstraintError:PackageRuntimeStoreConstraintError2,PackageRuntimeStoreMissingError:PackageRuntimeStoreMissingError2,PackageTool:PackageTool2,PackageToolSettingsOptions:PackageToolSettingsOptions2,PackageWebhookRejectedError:PackageWebhookRejectedError2,PackageWorkflowField:PackageWorkflowField2,PackageWorkflowNode:PackageWorkflowNode2,PackageWorkflowNodeError:PackageWorkflowNodeError2,PackageWorkflowScheduleTrigger:PackageWorkflowScheduleTrigger2,requirePackageRuntimeStore:requirePackageRuntimeStore2,webhookHeader:webhookHeader2,withDisplayParts:withDisplayParts2}=exports_src;export{BackendPackageSchemaError2 as BackendPackageSchemaError,DatasetParser2 as DatasetParser,ExternalDatasetProvider2 as ExternalDatasetProvider,INBOUND_ATTACHMENT_MAX_BYTES2 as INBOUND_ATTACHMENT_MAX_BYTES,ManagedDatasetProvider2 as ManagedDatasetProvider,PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES2 as PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES,PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS2 as PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS,PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS2 as PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS,PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS2 as PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS,PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES2 as PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES,PackageConnection2 as PackageConnection,PackageDocumentsConnector2 as PackageDocumentsConnector,PackageEmailProvider2 as PackageEmailProvider,PackageEmailSendError2 as PackageEmailSendError,PackageEventListener2 as PackageEventListener,PackageFieldDefinition2 as PackageFieldDefinition,PackageFieldTransformer2 as PackageFieldTransformer,PackageInboundMessagingProvider2 as PackageInboundMessagingProvider,PackageKnowledgeConnector2 as PackageKnowledgeConnector,PackageKnowledgeConnectorOAuth2 as PackageKnowledgeConnectorOAuth,PackageKnowledgeEntityAdapter2 as PackageKnowledgeEntityAdapter,PackageMessageSendError2 as PackageMessageSendError,PackageNotificationChannel2 as PackageNotificationChannel,PackageOrganizationSso2 as PackageOrganizationSso,PackageOutboundMessagingProvider2 as PackageOutboundMessagingProvider,PackageRuntimeStoreConstraintError2 as PackageRuntimeStoreConstraintError,PackageRuntimeStoreMissingError2 as PackageRuntimeStoreMissingError,PackageTool2 as PackageTool,PackageToolSettingsOptions2 as PackageToolSettingsOptions,PackageWebhookRejectedError2 as PackageWebhookRejectedError,PackageWorkflowField2 as PackageWorkflowField,PackageWorkflowNode2 as PackageWorkflowNode,PackageWorkflowNodeError2 as PackageWorkflowNodeError,PackageWorkflowScheduleTrigger2 as PackageWorkflowScheduleTrigger,accessTest2 as accessTest,assertPackageRuntimeStorePut2 as assertPackageRuntimeStorePut,backendInvocationIdentity2 as backendInvocationIdentity,createBackendPackageRuntime2 as createBackendPackageRuntime,declareBackendContribution2 as declareBackendContribution,defineCapability2 as defineCapability,inboundMessagingBinding2 as inboundMessagingBinding,isBackendPackageOperationAllowed2 as isBackendPackageOperationAllowed,packageConnectionToken2 as packageConnectionToken,packageEmailToken2 as packageEmailToken,packageOrganizationMemberSelection2 as packageOrganizationMemberSelection,requirePackageRuntimeStore2 as requirePackageRuntimeStore,webhookHeader2 as webhookHeader,withDisplayParts2 as withDisplayParts};
|
|
1
|
+
import{accessGrantAxisSlug,canonicalJson as canonicalJson2}from"@collective-intelligence/extensions-sdk";import{access,capabilityCatalogNodes,coreCapabilities,declareAccessCapabilities}from"@collective-intelligence/extensions-sdk";var levelOf=(mode)=>mode==="manage"?2:1;var childLevel=(entryKind,entryLevel,childKind)=>{if(entryKind==="switch"){return childKind==="switch"?1:undefined}if(childKind==="readManage"){return entryLevel}return entryLevel===2?1:undefined};var packageNodes=(declaration)=>capabilityCatalogNodes(declareAccessCapabilities({definition:{grantableBy:declaration.grantableBy,nodes:declaration.nodes},manifest:{fqn:declaration.fqn,version:declaration.version}}));var applicationNodes=(manifest)=>capabilityCatalogNodes(access.accessGate({manifest,schemaSidecars:[]}));var accessTestCatalog=(declarations,applications=[])=>{const nodes=new Map;const children=new Map;for(const node of[...capabilityCatalogNodes(coreCapabilities),...declarations.flatMap(packageNodes),...applications.flatMap(applicationNodes)]){if(nodes.has(node.code)){throw new TypeError(`accessTest: capability '${node.code}' is declared twice`)}nodes.set(node.code,node);if(node.parent!==undefined){children.set(node.parent,[...children.get(node.parent)??[],node.code])}}const node=(code)=>{const found=nodes.get(code);if(found===undefined){throw new TypeError(`accessTest: capability '${code}' is not declared`)}return found};const reach=(levels,entry,entryLevel,code,level)=>{levels.set(code,Math.max(levels.get(code)??0,level));for(const child of children.get(code)??[]){const below=childLevel(entry.kind,entryLevel,node(child).kind);if(below!==undefined){reach(levels,entry,entryLevel,child,below)}}};const expand=(entries)=>{const levels=new Map;for(const{code,mode}of entries){const entry=node(code);if(entry.kind==="switch"!==(mode==="on")){throw new TypeError(`accessTest: '${code}' is a ${entry.kind} node and cannot be granted at '${mode}'`)}reach(levels,entry,levelOf(mode),code,levelOf(mode))}return levels};return{expand,holds:(levels,{mode,requires})=>{node(requires);return(levels.get(requires)??0)>=levelOf(mode)}}};var cutLevels=(levels,maximum)=>new Map([...levels].flatMap(([code,level])=>{const cut=Math.min(level,maximum.get(code)??0);return cut===0?[]:[[code,cut]]}));import{canonicalJson}from"@collective-intelligence/extensions-sdk";var anyAxis=Symbol("any axis");var valuesOf=(value)=>{if(value===undefined||value===null||value===anyAxis){return[]}return Array.isArray(value)?value:[value]};var equal=(left,right)=>canonicalJson({value:left})===canonicalJson({value:right});var pathValue=(root,path)=>{let current=root;for(const segment of path.split(".")){if(current===undefined||current===null||Array.isArray(current)||Object(current)!==current){return}current=current[segment]}return current};var resolve=(operand,record,scope)=>{if("resource"in operand){return record[operand.resource]}if("subject"in operand){return pathValue(scope.subject,operand.subject)}if("grantAxis"in operand){const values=scope.axisValues(operand.grantAxis);return values==="any"?anyAxis:[...values]}return operand.value};var ordered=(left,right,accept)=>{if(left===anyAxis||right===anyAxis){return true}if(typeof left==="number"&&typeof right==="number"){return accept(left-right)}if(typeof left==="string"&&typeof right==="string"){return accept(left.localeCompare(right))}return false};var isText=(value)=>typeof value==="string";var orderOf=(operator)=>{switch(operator){case"lt":{return(order)=>order<0}case"lte":{return(order)=>order<=0}case"gt":{return(order)=>order>0}case"gte":{return(order)=>order>=0}default:{return}}};var compare=(operator,left,right)=>{if(left===anyAxis||right===anyAxis){return true}const order=orderOf(operator);if(order!==undefined){return ordered(left,right,order)}switch(operator){case"eq":{return left!==undefined&&right!==undefined&&equal(left,right)}case"neq":{return left!==undefined&&right!==undefined&&!equal(left,right)}case"isIn":case"overlaps":{const options=valuesOf(right);return valuesOf(left).some((value)=>options.some((option)=>equal(value,option)))}case"contains":{if(Array.isArray(left)){return right!==undefined&&left.some((item)=>equal(item,right))}return isText(left)&&isText(right)&&left.includes(right)}default:{return isText(left)&&isText(right)&&left.startsWith(right)}}};var stringValues=(value)=>valuesOf(value).flatMap((item)=>typeof item==="string"?[item]:[]);var comparisonOf=(condition)=>{if("eq"in condition){return["eq",condition.eq]}if("neq"in condition){return["neq",condition.neq]}if("lt"in condition){return["lt",condition.lt]}if("lte"in condition){return["lte",condition.lte]}if("gt"in condition){return["gt",condition.gt]}if("gte"in condition){return["gte",condition.gte]}if("isIn"in condition){return["isIn",condition.isIn]}if("overlaps"in condition){return["overlaps",condition.overlaps]}if("contains"in condition){return["contains",condition.contains]}return"startsWith"in condition?["startsWith",condition.startsWith]:undefined};var holdsCondition=(condition,record,scope)=>{const me=pathValue(scope.subject,"userId");if("and"in condition){return condition.and.every((item)=>holdsCondition(item,record,scope))}if("or"in condition){return condition.or.some((item)=>holdsCondition(item,record,scope))}if("not"in condition){return!holdsCondition(condition.not,record,scope)}if("condition"in condition){return holdsCondition(scope.condition(condition.condition),record,scope)}if("exists"in condition){return valuesOf(resolve(condition.exists,record,scope)).length>0}if("isNull"in condition){const value=resolve(condition.isNull,record,scope);return value===undefined||value===null}if("isMe"in condition){return me!==undefined&&record[condition.isMe]===me}if("includesMe"in condition){return stringValues(record[condition.includesMe]).some((user)=>user===me)}if("inGroup"in condition){const{coverage,field,group}=condition.inGroup;const members=scope.groupMembers(group,coverage);return stringValues(record[field]).some((user)=>members.has(user))}if("inMyGroups"in condition){const{coverage,field}=condition.inMyGroups;if(typeof me!=="string"){return false}const peers=new Set([...scope.groupsOf(me,coverage)].flatMap((group)=>[...scope.groupMembers(group,"direct")]));return stringValues(record[field]).some((user)=>peers.has(user))}if("via"in condition){return stringValues(record[condition.via.resource]).some((id)=>{const related=scope.entity(id);return related!==undefined&&holdsCondition(condition.via.condition,related,scope)})}const comparison=comparisonOf(condition);if(comparison!==undefined){const[operator,[left,right]]=comparison;return compare(operator,resolve(left,record,scope),resolve(right,record,scope))}throw new TypeError(`accessTest: unknown condition ${JSON.stringify(condition)}`)};var fqnOf=(reference)=>typeof reference==="string"?reference:reference.manifest.fqn;var fail=(message)=>{throw new TypeError(`accessTest: ${message}`)};var indexBy=(declarations)=>new Map(declarations.map((declaration)=>[declaration.fqn,declaration]));var selects=(selection,key)=>{if(selection===undefined){return true}return"except"in selection?!selection.except.includes(key):selection.includes(key)};var corePolicy=({capability})=>({capability,otherAxes:"unscoped"});var accessTest=(packages,options={})=>{const primitives=(Array.isArray(packages)?packages:[packages]).flatMap((definition)=>definition.manifest.primitives);const declared=(kind)=>primitives.filter((primitive)=>primitive.kind===kind);const catalog=accessTestCatalog(declared("accessCapabilities"),declared("externalApplication"));const profiles=indexBy(declared("accessProfile"));const axes=indexBy(declared("accessGrantAxis"));const conditions=indexBy(declared("accessKnowledgeDataCondition"));const maxPrivileges=indexBy(declared("accessMaxPrivileges"));const policies=declared("accessKnowledgeDataPolicy");const entities=new Map((options.entities??[]).map((entity)=>[entity.id,{data:entity.data,schema:fqnOf(entity.schema)}]));const groups=new Map((options.groups??[]).map((group)=>[group.fqn,group]));const subgroupsOf=(group)=>[group,...[...groups.values()].filter(({parent})=>parent===group).flatMap(({fqn})=>subgroupsOf(fqn))];const covered=(group,coverage)=>coverage==="inherited"?subgroupsOf(group):[group];const groupMembers=(group,coverage)=>new Set(covered(group,coverage).flatMap((fqn)=>groups.get(fqn)?.members??[]));const groupsOf=(user,coverage)=>new Set([...groups.values()].filter(({members})=>members?.includes(user)===true).flatMap(({fqn})=>covered(fqn,coverage)));const condition=(fqn)=>conditions.get(fqn)?.where??fail(`condition '${fqn}' is not declared`);const entity=(id)=>{const found=entities.get(id);return found===undefined?undefined:{...found.data,id}};const scope=(user,tuple)=>({axisValues:(axis)=>tuple?.axes.get(axis)??"any",condition,entity,groupMembers,groupsOf,subject:{userId:user}});const axis=(fqn)=>axes.get(fqn)??fail(`Grant Axis '${fqn}' is not declared`);const resolveValue=(axisFqn,value)=>{if(typeof value==="string"){return value}const{field,value:wanted}=value.knowledgeEntity;const{target}=axis(axisFqn);const matches=[...entities].filter(([,{data,schema}])=>schema===target&&data[field]===wanted);const[match]=matches;return matches.length===1&&match!==undefined?match[0]:fail(`knowledgeEntity({ ${field}: "${wanted}" }) does not name one entity of '${target}'`)};const subtree=(axisFqn,id)=>{const{hierarchy,target}=axis(axisFqn);const values=new Set([id]);if(hierarchy===undefined){return values}const parents=new Map;const children=new Map;for(const[child,{data,schema}]of entities){const parent=data[hierarchy];if(schema===target&&typeof parent==="string"){parents.set(child,parent);children.set(parent,[...children.get(parent)??[],child])}}const seen=new Set;for(let parent=parents.get(id);parent!==undefined;parent=parents.get(parent)){if(parent===id){return values}if(seen.has(parent)){break}seen.add(parent)}for(const value of values){for(const child of children.get(value)??[]){values.add(child)}}return values};const tupleOf=(grant)=>{if("capabilities"in grant){return{axes:new Map,levels:catalog.expand(grant.capabilities)}}const fqn=fqnOf(grant.profile);const profile=profiles.get(fqn)??fail(`profile '${fqn}' is not declared`);const given=grant.axes??{};const profileAxes=profile.axes??[];if(Object.keys(given).length!==profileAxes.length){fail(`a grant of '${fqn}' sets one value for each axis of the profile`)}return{axes:new Map(profileAxes.map((axisFqn)=>{const slug=accessGrantAxisSlug(axisFqn);const value=given[slug]??fail(`a grant of '${fqn}' has no value for the axis '${slug}'`);return[axisFqn,subtree(axisFqn,resolveValue(axisFqn,value))]})),levels:catalog.expand(profile.capabilities)}};const policiesOf=(schema,operation)=>{const target=fqnOf(schema);const own=policies.filter((policy)=>policy.target===target&&policy.operation===operation);const core=(options.corePolicies??[]).filter((policy)=>policy.data==="knowledge"&&policy.operation===operation);const slotIsEmpty=(purpose)=>!own.some((policy)=>policy.purpose===purpose);return[...own,...core.filter((policy)=>policy.kind==="tenant"||policy.kind==="default"&&slotIsEmpty("access")||policy.kind==="admin"&&slotIsEmpty("administration")).map(corePolicy)]};const bindingValues=(record,binding)=>{if("self"in binding){return stringValues(record.id)}if("field"in binding){return stringValues(record[binding.field])}const{field,key}=binding.relation;return stringValues(record[key]).flatMap((id)=>stringValues(entity(id)?.[field]))};return{as:(principal)=>{const cap=principal.maxPrivileges===undefined?undefined:catalog.expand((maxPrivileges.get(fqnOf(principal.maxPrivileges))??fail(`Max Privileges '${fqnOf(principal.maxPrivileges)}' are not declared`)).capabilities);const tuples=(principal.grants??[]).map((grant)=>{const tuple=tupleOf(grant);return cap===undefined?tuple:{...tuple,levels:cutLevels(tuple.levels,cap)}});const admits=(policy,tuple,record)=>{if(!catalog.holds(tuple.levels,policy.capability)){return false}for(const[axisFqn,values]of tuple.axes){const rule=policy.axes?.find((candidate)=>candidate.axis===axisFqn);if(rule===undefined&&policy.otherAxes!=="unscoped"){return false}if(rule!==undefined&&"map"in rule&&!bindingValues(record,rule.map).some((value)=>values.has(value))){return false}}return policy.where===undefined||holdsCondition(policy.where,record,scope(principal.user,tuple))};const admitting=(schema,operation,record)=>policiesOf(schema,operation).flatMap((policy)=>tuples.filter((tuple)=>admits(policy,tuple,record)).map(()=>policy));const read=(schema,record)=>{const pairs=admitting(schema,"read",record);return pairs.length===0?undefined:Object.fromEntries(Object.entries(record).filter(([key])=>key==="id"||pairs.some(({readableFields})=>selects(readableFields,key))))};return{canRead:(schema,record)=>read(schema,record)!==undefined,canUpdate:(schema,stored,proposed)=>{const changed=[...new Set([...Object.keys(stored),...Object.keys(proposed)])].filter((key)=>canonicalJson2({value:stored[key]??null})!==canonicalJson2({value:proposed[key]??null})||Object.hasOwn(stored,key)!==Object.hasOwn(proposed,key));return policiesOf(schema,"write").some((policy)=>tuples.some((tuple)=>admits(policy,tuple,stored)&&admits(policy,tuple,proposed)&&changed.every((key)=>selects(policy.writableFields,key))))},canWrite:(schema,record)=>admitting(schema,"write",record).length>0,holds:(requirement)=>tuples.some((tuple)=>catalog.holds(tuple.levels,requirement)),read}},conditionTests:()=>[...conditions.values()].flatMap(({fqn,tests,where})=>(tests??[]).map(({expected,name,record,subject})=>{const user=subject?.userId;const actual=holdsCondition(where,record,{...scope(typeof user==="string"?user:""),subject:subject??{}});return{condition:fqn,expected,name,passed:actual===expected}}))}};class PackageConnection{}class ManagedDatasetProvider{}class ExternalDatasetProvider{}class DatasetParser{}class PackageDocumentsConnector{}class PackageEmailSendError extends Error{name="PackageEmailSendError";category;outcome;constructor(input){super(input.message);this.category=input.category;this.outcome=input.outcome;if(input.statusCode!==undefined){this.statusCode=input.statusCode}if(input.retry!==undefined){this.retry=input.retry}if(input.replay!==undefined){this.replay=input.replay}if(input.operationId!==undefined){this.operationId=input.operationId}if(input.diagnosticId!==undefined){this.diagnosticId=input.diagnosticId}}}class PackageEmailProvider{prepare(_input,_context){return{quotas:[]}}}class PackageEventListener{canonicalSelector(selector){return selector}routeKeys(_selector){return{}}broadRouteKeys(){return{}}}var INBOUND_ATTACHMENT_MAX_BYTES=25*1024*1024;var isRecord=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value);var isText2=(value)=>typeof value==="string";var inboundMessagingBinding=(context)=>{const{connection,messaging,state}=context.config??{};if(!isRecord(connection)||!isText2(connection.id)||!isRecord(connection.values)||!isRecord(messaging)||!isText2(messaging.service)){throw new TypeError("An inbound messaging provider requires config.connection and config.messaging.service")}const values={};for(const[field,value]of Object.entries(connection.values)){if(value!==null&&!isText2(value)){throw new TypeError(`Connection value '${field}' must be a string`)}values[field]=value}const verifyToken=isRecord(state)?state.verify_token:undefined;const token=isRecord(verifyToken)?verifyToken.token:undefined;return{connection:{id:connection.id,values},service:messaging.service,verifyToken:isText2(token)?token:undefined}};var webhookHeader=(request,name)=>{const wanted=name.toLowerCase();return Object.entries(request.headers).find(([header])=>header.toLowerCase()===wanted)?.[1]};class PackageWebhookRejectedError extends Error{name="PackageWebhookRejectedError";reason;constructor(reason){super(`Webhook request rejected: ${reason}`);this.reason=reason}}var enrichmentOptions=["detectLanguage","transcribe"];var askedEnrichment=(enrichment)=>{const asked=enrichmentOptions.filter((option)=>enrichment?.[option]===true);return asked.length===0?{}:{enrichment:Object.fromEntries(asked.map((option)=>[option,true]))}};var failed=(draft,reason)=>({filename:draft.filename,kind:draft.kind,reason,status:"failed"});var storeAttachment=async(draft,context)=>{if(draft.sizeBytes!==undefined&&draft.sizeBytes>INBOUND_ATTACHMENT_MAX_BYTES){return failed(draft,"too_large")}if(context.captureContent===undefined){throw new TypeError("An inbound messaging provider requires context.captureContent")}let content;try{content=await draft.download()}catch{context.signal?.throwIfAborted();return failed(draft,"download_failed")}if(content==="too_large"||content.byteLength>INBOUND_ATTACHMENT_MAX_BYTES){return failed(draft,"too_large")}const{contentType,filename,kind}=draft;const stored=await context.captureContent({content,contentType,filename});return{contentType,filename,kind,sizeBytes:stored.sizeBytes,status:"stored",storageFileId:stored.storageFileId}};var occurrencesOf=async(drafts,context)=>{const{connection,service}=inboundMessagingBinding(context);const occurrences=[];for(const draft of drafts){if(draft.fromSelf){continue}const attachments=[];for(const attachment of draft.attachments){attachments.push(await storeAttachment(attachment,context))}const{id:conversationId}=draft.conversationIdentity;const payload={attachments,connectionId:connection.id,conversation:draft.conversation,conversationIdentity:draft.conversationIdentity,messageId:draft.messageId,receivedAt:draft.receivedAt,sender:draft.sender,service,text:draft.text,vendorExtras:draft.vendorExtras};occurrences.push({eventKey:`${service}:${conversationId}:${draft.messageId}`,payload,routeKeys:{...draft.routeKeys??{conversation:conversationId},service},safeSummary:{connectionId:connection.id,messageId:draft.messageId,service}})}return occurrences};class PackageInboundMessagingProvider extends PackageEventListener{canonicalFilter(filter){return filter}canonicalSelector(selector){const{enrichment,...filter}=selector;return{...this.canonicalFilter(filter),...askedEnrichment(enrichment)}}async normalizeWebhookRequest(request,context){await this.verifyWebhook(request,context);return await occurrencesOf(await this.messagesFromWebhook(request,context),context)}async poll(request,context){if(this.pollMessages===undefined){throw new TypeError("This inbound messaging provider does not poll")}const{messages,nextCheckpoint}=await this.pollMessages(request.checkpoint,context);return{nextCheckpoint,occurrences:await occurrencesOf(messages,context)}}}class PackageMessageSendError extends Error{name="PackageMessageSendError";code;constructor(input){super(input.message);this.code=input.code;if(input.statusCode!==undefined){this.statusCode=input.statusCode}}}class PackageOutboundMessagingProvider{}class PackageKnowledgeConnector{}class PackageKnowledgeConnectorOAuth{}class PackageKnowledgeEntityAdapter{}class PackageNotificationChannel{}class PackageOrganizationSso{}class PackageTool{}class PackageToolSettingsOptions{}import{toolResultBrand}from"@collective-intelligence/extensions-sdk";var withDisplayParts=(output,displayParts)=>({displayParts,output,[toolResultBrand]:true});class PackageFieldTransformer{}class PackageWorkflowNode{}class PackageWorkflowScheduleTrigger extends PackageWorkflowNode{}class PackageWorkflowNodeError extends Error{name="PackageWorkflowNodeError";code;constructor(input){super(input.message);this.code=input.code;Object.defineProperty(this,"message",{enumerable:true})}}class PackageFieldDefinition{supportsOptionPaging=false;canonicalize(value,_config){return value}validateLocal(value,_config){return value}validateAuthoritative(value,_config,_context){return value}parts(_config){return[]}getOptions(_input,_context){return[]}}class PackageWorkflowField extends PackageFieldDefinition{}var isObjectLike=(value)=>value!==null&&Object(value)===value;var defineCapability=(id,requiredKeys)=>({id,isService:(value)=>isObjectLike(value)&&requiredKeys.every((key)=>Object.hasOwn(value,key))});class PackageRuntimeStoreMissingError extends Error{name="PackageRuntimeStoreMissingError";constructor(){super("Package runtime store is not available on this invocation")}}class PackageRuntimeStoreConstraintError extends Error{name="PackageRuntimeStoreConstraintError"}var isJsonObjectValue=(value)=>Object.prototype.toString.call(value)==="[object Object]"&&!Array.isArray(value)&&(Object.getPrototypeOf(value)===Object.prototype||Object.getPrototypeOf(value)===null);var PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES=512;var PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES=64*1024;var PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS=60;var PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS=30*24*60*60;var PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS=100;var utf8=new TextEncoder;var utf8ByteLength=(value)=>utf8.encode(value).byteLength;var assertPackageRuntimeStorePut=(key,value,ttlSeconds)=>{if(utf8ByteLength(key)>PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES){throw new PackageRuntimeStoreConstraintError("Package runtime store keys must be at most 512 bytes")}if(!isJsonObjectValue(value)){throw new PackageRuntimeStoreConstraintError("Package runtime store values must be JSON objects")}if(utf8ByteLength(JSON.stringify(value))>PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES){throw new PackageRuntimeStoreConstraintError("Package runtime store values must be at most 64 KiB")}if(!Number.isFinite(ttlSeconds)||ttlSeconds<PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS||ttlSeconds>PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS){throw new PackageRuntimeStoreConstraintError("Package runtime store TTL must be between 1 minute and 30 days")}};var requirePackageRuntimeStore=(context)=>{const{store}=context;if(store===undefined){throw new PackageRuntimeStoreMissingError}return{delete:(key)=>store.delete(key),get:(key)=>store.get(key),list:(prefix)=>store.list(prefix),put:(key,value,ttlSeconds)=>{assertPackageRuntimeStorePut(key,value,ttlSeconds);return store.put(key,value,ttlSeconds)}}};var packageOrganizationMemberSelection=defineCapability("collective_intelligence.organization_member_selection",["search","resolve","validate"]);import{declareHostedContribution}from"@collective-intelligence/extensions-sdk";var declareBackendContribution=(input)=>declareHostedContribution({...input,host:"backend"});var backendInvocationIdentity=(input)=>Object.freeze({...input,host:"backend",source:Object.freeze({...input.source})});var operations=[{kind:"connection",operations:["test","discover","test_and_discover"]},{kind:"datasetParser",operations:["analyze","parse_records"]},{kind:"documentsConnector",operations:["pull","fetch_content","fetch_source","read_file_revisions","delta_page","prove_root_ancestry","list_drives","list_folders"]},{kind:"emailProvider",operations:["prepare","send"]},{kind:"eventListener",operations:["canonical_selector","route_keys","broad_route_keys","parse_selector","normalize_internal","normalize_webhook","normalize_webhook_request","poll","register_webhook","unregister_webhook"]},{kind:"externalDatasetProvider",operations:["readiness","list_sources","discover_definition","dataset_query","dataset_inspect"]},{kind:"fieldTransformer",operations:["transform","inverse"]},{kind:"knowledgeConnector",operations:["browse","discover","pull","push","read","read_record"]},{kind:"knowledgeConnectorOauth",operations:["authorize_url","exchange_code"]},{kind:"knowledgeEntityAdapter",operations:["remote_id","to_local","to_remote","extra_props","normalize_field_map_value","normalize_imported_data"]},{kind:"managedDatasetProvider",operations:["readiness","dataset_provision","dataset_ingest","dataset_query","dataset_inspect","dataset_delete"]},{kind:"notificationChannel",operations:["deliver"]},{kind:"organizationSso",operations:["authorization_url","exchange_code"]},{kind:"outboundMessagingProvider",operations:["send"]},{kind:"tool",operations:["execute","health_check"]},{kind:"toolSettingsOptions",operations:["get_options"]},{kind:"workflowField",operations:["canonicalize","validate_local","validate_authoritative","parts","get_options"]},{kind:"workflowNode",operations:["execute"]}];var isBackendPackageOperationAllowed=(kind,operation)=>operations.some((entry)=>entry.kind===kind&&entry.operations.some((method)=>method===operation));class BackendPackageSchemaError extends Error{name="BackendPackageSchemaError";stage;location;issues;constructor(stage,location,issues){super(`${location}: ${stage}: ${issues.map((issue)=>issue.message).join("; ")}`);this.stage=stage;this.location=location;this.issues=issues}}import{canonicalJson as canonicalJson3,toolResultBrand as toolResultBrand2}from"@collective-intelligence/extensions-sdk";var TOOL_RESULT_ENVELOPE_KEY="@ci/tool-result";var isCodec=(value)=>("encode"in value)&&typeof value.encode==="function"&&("project"in value)&&typeof value.project==="function";var wireValue=(value)=>JSON.parse(canonicalJson3(value));var operationMethod=(operation)=>operation.replaceAll(/_(?<letter>[a-z])/gu,(_match,letter)=>letter.toUpperCase());var methodOf=(instance,operation)=>{const method=Reflect.get(instance,operationMethod(operation));if(operation==="extra_props"&&method===undefined){return()=>null}if(operation==="normalize_imported_data"&&method===undefined){return(local)=>local}if(operation==="normalize_field_map_value"&&method===undefined){return(value)=>value}if(operation==="validate_authoritative"&&method===undefined){return(value)=>value}if(operation==="parse_selector"&&method===undefined){return(selector)=>selector}if(typeof method!=="function"){throw new TypeError(`Unsupported package operation '${operation}'`)}return method};var isToolResultWithDisplay=(value)=>typeof value==="object"&&value!==null&&(toolResultBrand2 in value);var isRecord2=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value);var operationSchema=(manifest,direction,operation)=>{if(manifest.kind==="workflowField"&&(operation==="canonicalize"||operation==="validate_local"||operation==="validate_authoritative")&&manifest.contract.valueSchema!==undefined){return{location:`workflow_field:${manifest.fqn}.contract.valueSchema`,projection:manifest.contract.valueSchema}}if(manifest.kind==="tool"&&operation==="execute"){return{location:`tool:${manifest.fqn}.${direction}`,projection:direction==="input"?manifest.input:manifest.output}}if(manifest.kind==="connection"&&direction==="input"){return{location:`connection:${manifest.fqn}.credential.schema`,projection:manifest.credential.schema}}if(manifest.kind==="workflowNode"){const projection=direction==="input"?manifest.contract.inputSchema:manifest.contract.outputSchema;if(projection!==undefined){return{location:`workflow_node:${manifest.fqn}.contract.${direction}Schema`,projection}}}return};var sidecarFor=(component,direction,operation)=>{const{manifest}=component;const boundary=operationSchema(manifest,direction,operation);if(!boundary){return}const{location,projection}=boundary;const matches=component.schemaSidecars.filter((item)=>item.location===location);const[source]=matches;if(manifest.kind==="workflowField"&&direction==="output"&&source!==undefined&&!isCodec(source.source)){return}if(matches.length!==1||source===undefined||manifest.kind!=="workflowField"&&source.direction!==direction||direction==="output"&&!isCodec(source.source)){throw new BackendPackageSchemaError("stale_manifest",location,[])}const actual=source.direction==="output"&&isCodec(source.source)?source.source.project("output"):source.source.project("input");if(canonicalJson3(actual)!==canonicalJson3(projection)){throw new BackendPackageSchemaError("stale_manifest",location,[])}return source};var schemaProjection=(manifest,location)=>{const prefix=`:${manifest.fqn}.`;const offset=location.indexOf(prefix);if(offset===-1){throw new BackendPackageSchemaError("stale_manifest",location,[])}const keys=location.slice(offset+prefix.length).replaceAll(/\[(?<index>\d+)\]/gu,".$<index>").split(".");let current=manifest;for(const key of keys){if(typeof current!=="object"||current===null){throw new BackendPackageSchemaError("stale_manifest",location,[])}current=Reflect.get(current,key)}return current};var isSchemaInvocation=(call)=>call.operation==="decode_schema"||call.operation==="encode_schema";var invokeSchema=async(component,call)=>{const matches=component.schemaSidecars.filter((sidecar)=>sidecar.location===call.schemaLocation);const[sidecar]=matches;if(matches.length!==1||sidecar===undefined){throw new BackendPackageSchemaError("stale_manifest",call.schemaLocation,[])}const codec=isCodec(sidecar.source)?sidecar.source:undefined;const projection=sidecar.direction==="output"&&codec?codec.project("output"):sidecar.source.project("input");if(canonicalJson3(projection)!==canonicalJson3(schemaProjection(component.manifest,call.schemaLocation))){throw new BackendPackageSchemaError("stale_manifest",call.schemaLocation,[])}if(call.operation==="encode_schema"&&codec===undefined){throw new BackendPackageSchemaError("stale_manifest",call.schemaLocation,[])}const result=call.operation==="encode_schema"&&codec?await codec.encode(call.input):await sidecar.source.validate(call.input);call.signal.throwIfAborted();if(result.issues!==undefined){throw new BackendPackageSchemaError(call.operation==="encode_schema"?"output_encode":"input_decode",call.schemaLocation,result.issues)}return wireValue(result.value)};var webhookBody=(input)=>{if(!isRecord2(input)||!Array.isArray(input.bodyBytes)){throw new TypeError("Webhook bodyBytes must be a byte array")}const bytes=[];for(const byte of input.bodyBytes){if(typeof byte!=="number"||!Number.isInteger(byte)||byte<0||byte>255){throw new TypeError("Webhook byte must be an integer from 0 to 255")}bytes.push(byte)}return new Uint8Array(bytes)};var webhookRequest=(input)=>{const body=webhookBody(input);if(!isRecord2(input)||!isRecord2(input.headers)){throw new TypeError("Webhook headers must be a string record")}const entries=[];for(const[key,value]of Object.entries(input.headers)){if(typeof value!=="string"){throw new TypeError("Webhook headers must be strings")}entries.push([key,value])}const headers=Object.fromEntries(entries);return{body,headers,...typeof input.receivedAt==="string"&&{receivedAt:input.receivedAt},...typeof input.url==="string"&&{url:input.url}}};var parserArguments=(call,value)=>{if(!isRecord2(value)||!Array.isArray(value.bytes)||typeof value.maxRows!=="number"||!Number.isSafeInteger(value.maxRows)||value.maxRows<1){throw new TypeError("Dataset parser requires bytes and a positive safe integer maxRows")}const bytes=[];for(const byte of value.bytes){if(typeof byte!=="number"||!Number.isInteger(byte)||byte<0||byte>255){throw new TypeError("Dataset parser bytes must be integers from 0 to 255")}bytes.push(byte)}const input={bytes:new Uint8Array(bytes),maxRows:value.maxRows};if(call.operation==="parse_records"){if(!Array.isArray(value.fields)||!value.fields.every((field)=>isRecord2(field)&&typeof field.key==="string"&&field.key.length>0&&typeof field.label==="string"&&typeof field.nullable==="boolean"&&["boolean","int64","float64","decimal","date","duration","json","timestamp","string"].includes(String(field.type)))){throw new TypeError("Dataset parser requires valid fields")}return[{...input,fields:value.fields}]}return[input]};var documentsSourceWire=(source,message)=>{if(source===null){return null}if(isRecord2(source)&&typeof source.webUrl==="string"){return{webUrl:source.webUrl}}throw new TypeError(message)};var documentsFetchContentWire=(result)=>{if(!isRecord2(result)||!(result.bytes instanceof Uint8Array)){throw new TypeError("Documents fetchContent must return { bytes: Uint8Array }")}for(const field of["mimeType","extension","filename"]){if(result[field]!==undefined&&typeof result[field]!=="string"){throw new TypeError(`Documents fetchContent ${field} must be a string`)}}const wire={bytesBase64:Buffer.from(result.bytes).toString("base64")};if(typeof result.mimeType==="string"){wire.mimeType=result.mimeType}if(typeof result.extension==="string"){wire.extension=result.extension}if(typeof result.filename==="string"){wire.filename=result.filename}if(result.source!==undefined){wire.source=documentsSourceWire(result.source,"Documents fetchContent source must be { webUrl: string } or null")}return wire};var jsonResult=(kind,operation,result)=>{if(kind==="documentsConnector"&&operation==="fetch_source"){return wireValue(documentsSourceWire(result,"Documents fetchSource must return { webUrl: string } or null"))}if(result===undefined){return null}if(kind==="documentsConnector"&&operation==="fetch_content"){return wireValue(documentsFetchContentWire(result))}return wireValue(result)};var extraPropsArguments=(value)=>{if(!isRecord2(value)||!isRecord2(value.remote)||value.schemaMeta!==null&&!isRecord2(value.schemaMeta)||value.originalRemote!==undefined&&!isRecord2(value.originalRemote)){throw new TypeError("extraProps requires remote and schemaMeta records (or null schemaMeta), and an optional originalRemote record")}return value.originalRemote===undefined?[value.remote,value.schemaMeta]:[value.remote,value.schemaMeta,value.originalRemote]};var workflowFieldArguments=(call,value,context)=>{if(call.operation==="validate_authoritative"&&(!isRecord2(call.context)||typeof call.context.organizationId!=="string"||call.context.organizationId.length===0||typeof call.context.capability!=="function")){throw new TypeError("Authoritative field validation requires caller context")}if(call.operation==="parts"){return[context.config]}return call.operation==="validate_authoritative"?[value,context.config,context]:[value,context.config]};var invocationArguments=(call,kind,value)=>{const context={...call.context,signal:call.signal};if(kind==="tool"&&call.operation==="health_check"||kind==="eventListener"&&call.operation==="unregister_webhook"){return[context]}if(kind==="datasetParser"){return parserArguments(call,value)}if(kind==="eventListener"&&call.operation==="normalize_webhook"){return[webhookBody(value),context]}if(kind==="eventListener"&&call.operation==="normalize_webhook_request"){return[webhookRequest(value),context]}if(kind==="knowledgeEntityAdapter"&&call.operation==="extra_props"){return extraPropsArguments(value)}if(kind==="knowledgeEntityAdapter"&&call.operation==="normalize_imported_data"){if(!isRecord2(value)||!("local"in value)||!("remote"in value)){throw new TypeError("normalizeImportedData requires local and remote data")}return[value.local,value.remote]}const progress=(event)=>{if(!call.signal.aborted){call.onProgress?.(wireValue(event))}};if(kind==="workflowField"&&call.operation!=="get_options"){return workflowFieldArguments(call,value,context)}return[value,context,progress]};var acknowledgeTested=async(observer,signal)=>{signal.throwIfAborted();await new Promise((resolve,reject)=>{const aborted=()=>{reject(signal.reason)};signal.addEventListener("abort",aborted,{once:true});Promise.resolve().then(()=>{signal.throwIfAborted();return observer()}).then(resolve,reject).finally(()=>{signal.removeEventListener("abort",aborted)})});signal.throwIfAborted()};var testAndDiscover=async(instance,call,args)=>{await methodOf(instance,"test").apply(instance,args);call.signal.throwIfAborted();if(!call.discover){return{catalog:null}}if(call.onTested){await acknowledgeTested(call.onTested,call.signal)}const catalog=await methodOf(instance,"discover").apply(instance,args);call.signal.throwIfAborted();return{catalog:wireValue(catalog)}};var encodeResult=async(kind,call,output,result)=>{if(!output){return jsonResult(kind,call.operation,result)}if(!isCodec(output.source)){throw new BackendPackageSchemaError("stale_manifest",output.location,[])}const workflowResult=kind==="workflowNode"&&isRecord2(result)?result:undefined;if(workflowResult&&"directive"in workflowResult){return wireValue(workflowResult)}const encoded=await output.source.encode(workflowResult?workflowResult.outputs:result);if(encoded.issues){throw new BackendPackageSchemaError("output_encode",output.location,encoded.issues)}return wireValue(workflowResult?{...workflowResult,outputs:encoded.value}:encoded.value)};var invokeBackendPackageComponent=async(component,call)=>{if(isSchemaInvocation(call)){return await invokeSchema(component,call)}if(!("implementation"in component)){throw new TypeError(`Component '${call.componentFqn}' has no implementation`)}const{manifest}=component;if(!isBackendPackageOperationAllowed(manifest.kind,call.operation)){throw new TypeError(`Unsupported ${manifest.kind} operation '${call.operation}'`)}const input=sidecarFor(component,"input",call.operation);const output=sidecarFor(component,"output",call.operation);const decoded=input?await input.source.validate(call.input):{value:call.input};if(decoded.issues){throw new BackendPackageSchemaError("input_decode",input?.location??call.componentFqn,decoded.issues)}call.signal.throwIfAborted();const instance=new component.implementation;const args=invocationArguments(call,manifest.kind,decoded.value);if(call.operation==="test_and_discover"){return await testAndDiscover(instance,call,args)}const result=await methodOf(instance,call.operation).apply(instance,args);call.signal.throwIfAborted();if(manifest.kind==="tool"&&call.operation==="execute"&&isToolResultWithDisplay(result)){return wireValue({[TOOL_RESULT_ENVELOPE_KEY]:1,displayParts:result.displayParts.flatMap((part)=>{try{return[wireValue(part)]}catch{return[]}}),output:await encodeResult(manifest.kind,call,output,result.output)})}return await encodeResult(manifest.kind,call,output,result)};var componentOf=(packages,call)=>{const component=packages.get(call.packageFqn)?.components.find((item)=>item.manifest.fqn===call.componentFqn);if(!component){throw new TypeError(`Unknown executable component '${call.packageFqn}/${call.componentFqn}'`)}return component};var createBackendPackageRuntime=(definitions)=>{const packages=new Map;for(const definition of definitions){if(packages.has(definition.manifest.fqn)){throw new TypeError(`Duplicate package '${definition.manifest.fqn}'`)}const components=new Set;for(const component of definition.components){if(components.has(component.manifest.fqn)){throw new TypeError(`Duplicate component '${component.manifest.fqn}'`)}components.add(component.manifest.fqn)}packages.set(definition.manifest.fqn,definition)}return{async invoke(call){call.signal.throwIfAborted();return await invokeBackendPackageComponent(componentOf(packages,call),call)}}};var packageConnectionToken=defineCapability("collective_intelligence.connection_token",["getToken"]);var packageEmailToken=defineCapability("collective_intelligence.email_token",["getToken"]);export{BackendPackageSchemaError,DatasetParser,ExternalDatasetProvider,INBOUND_ATTACHMENT_MAX_BYTES,ManagedDatasetProvider,PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES,PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS,PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS,PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS,PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES,PackageConnection,PackageDocumentsConnector,PackageEmailProvider,PackageEmailSendError,PackageEventListener,PackageFieldDefinition,PackageFieldTransformer,PackageInboundMessagingProvider,PackageKnowledgeConnector,PackageKnowledgeConnectorOAuth,PackageKnowledgeEntityAdapter,PackageMessageSendError,PackageNotificationChannel,PackageOrganizationSso,PackageOutboundMessagingProvider,PackageRuntimeStoreConstraintError,PackageRuntimeStoreMissingError,PackageTool,PackageToolSettingsOptions,PackageWebhookRejectedError,PackageWorkflowField,PackageWorkflowNode,PackageWorkflowNodeError,PackageWorkflowScheduleTrigger,accessTest,assertPackageRuntimeStorePut,backendInvocationIdentity,createBackendPackageRuntime,declareBackendContribution,defineCapability,inboundMessagingBinding,isBackendPackageOperationAllowed,packageConnectionToken,packageEmailToken,packageOrganizationMemberSelection,requirePackageRuntimeStore,webhookHeader,withDisplayParts};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@collective-intelligence/extensions-sdk-backend",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.4",
|
|
4
4
|
"description": "Framework-neutral executable contracts for Collective Intelligence extension packages, with an Effect adapter at ./effect.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"sideEffects": false,
|
|
@@ -63,5 +63,5 @@
|
|
|
63
63
|
"typescript": "7.0.2",
|
|
64
64
|
"ultracite": "7.10.7"
|
|
65
65
|
},
|
|
66
|
-
"gitHead": "
|
|
66
|
+
"gitHead": "5c6e6747e229d629d02380e62f0574c3e37d0090"
|
|
67
67
|
}
|