@collective-intelligence/extensions-sdk-backend 0.2.2 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,13 @@
1
+ import type { AccessCapabilitiesDeclaration, AccessCapabilityGrant, AccessCapabilityRequirement, ExternalApplicationDeclaration } from "@collective-intelligence/extensions-sdk";
2
+ /** The level of each held node: 1 is on or read, 2 is manage. */
3
+ export type CapabilityLevels = ReadonlyMap<string, number>;
4
+ /** The Capability Catalog of the core, the given package declarations and the app trees. */
5
+ export type AccessTestCatalog = Readonly<{
6
+ /** Expands profile entries with catalog rules 1 and 2 (ARC-001). */
7
+ expand: (entries: readonly AccessCapabilityGrant[]) => CapabilityLevels;
8
+ /** Whether the levels hold the required node at its mode or higher. */
9
+ holds: (levels: CapabilityLevels, requirement: AccessCapabilityRequirement) => boolean;
10
+ }>;
11
+ export declare const accessTestCatalog: (declarations: readonly AccessCapabilitiesDeclaration[], applications?: readonly ExternalApplicationDeclaration[]) => AccessTestCatalog;
12
+ /** Cuts levels to Max Privileges: the lower level of each node wins. */
13
+ export declare const cutLevels: (levels: CapabilityLevels, maximum: CapabilityLevels) => CapabilityLevels;
@@ -0,0 +1,21 @@
1
+ import type { AccessCondition, AccessGroupCoverage, JsonObject, JsonValue } from "@collective-intelligence/extensions-sdk";
2
+ /** The Axis Value of a Tuple: its value and subtree, or `any` when its profile has no such axis. */
3
+ export type AxisValues = ReadonlySet<string> | "any";
4
+ /** What a condition reads besides the record. */
5
+ export type ConditionScope = Readonly<{
6
+ /** The Axis Values of the Tuple under evaluation, by axis FQN. */
7
+ axisValues: (axis: string) => AxisValues;
8
+ /** A declared Knowledge Data Condition by FQN. */
9
+ condition: (fqn: string) => AccessCondition;
10
+ /** A Knowledge entity by id: the related record of `via`. */
11
+ entity: (id: string) => JsonObject | undefined;
12
+ /** The users of a Group, with its subgroups for inherited coverage. */
13
+ groupMembers: (group: string, coverage: AccessGroupCoverage) => ReadonlySet<string>;
14
+ /** The Groups of a user, with their subgroups for inherited coverage. */
15
+ groupsOf: (user: string, coverage: AccessGroupCoverage) => ReadonlySet<string>;
16
+ subject: JsonObject;
17
+ }>;
18
+ /** The string values of a single or multi-valued field: user ids and entity ids. */
19
+ export declare const stringValues: (value: JsonValue | undefined) => readonly string[];
20
+ /** Evaluates one condition on a record, in memory, as the engine does in SQL. */
21
+ export declare const holdsCondition: (condition: AccessCondition, record: JsonObject, scope: ConditionScope) => boolean;
@@ -0,0 +1,68 @@
1
+ import type { AccessCapabilityGrant, AccessCapabilityRequirement, AccessCorePolicy, AccessKnowledgeEntityIdentifier, AccessKnowledgeSchemaReference, AccessMaxPrivilegesHandle, AccessProfileReference, JsonObject, PackageDefinition } from "@collective-intelligence/extensions-sdk";
2
+ /** A Knowledge entity that axis hierarchies, identifiers and relations read. */
3
+ export type AccessTestEntity = Readonly<{
4
+ data: JsonObject;
5
+ id: string;
6
+ schema: AccessKnowledgeSchemaReference;
7
+ }>;
8
+ /** A Group with its parent and its direct members. */
9
+ export type AccessTestGroup = Readonly<{
10
+ fqn: string;
11
+ members?: readonly string[];
12
+ parent?: string;
13
+ }>;
14
+ export type AccessTestOptions = Readonly<{
15
+ /** The core policies of the core built-in package; without them no slot is filled by the core. */
16
+ corePolicies?: readonly AccessCorePolicy[];
17
+ entities?: readonly AccessTestEntity[];
18
+ groups?: readonly AccessTestGroup[];
19
+ }>;
20
+ /**
21
+ * One grant of the principal: a profile with one value per Grant Axis (an
22
+ * entity id or a Knowledge Entity Identifier), or a global capability list such
23
+ * as a tenant constant.
24
+ */
25
+ export type AccessTestGrant = Readonly<{
26
+ capabilities: readonly AccessCapabilityGrant[];
27
+ }> | Readonly<{
28
+ axes?: Readonly<Record<string, AccessKnowledgeEntityIdentifier | string>>;
29
+ profile: AccessProfileReference;
30
+ }>;
31
+ export type AccessTestPrincipal = Readonly<{
32
+ grants?: readonly AccessTestGrant[];
33
+ /** Acts through a token capped by these Max Privileges. */
34
+ maxPrivileges?: AccessMaxPrivilegesHandle | string;
35
+ user: string;
36
+ }>;
37
+ /** A record's data; an `id` key is its entity id for `self()` and is never masked. */
38
+ export type AccessTestRecord = JsonObject;
39
+ /** The access decisions of one principal. */
40
+ export type AccessTestSubject = Readonly<{
41
+ /** A record is readable through some (policy, Tuple) pair. */
42
+ canRead: (schema: AccessKnowledgeSchemaReference, record: AccessTestRecord) => boolean;
43
+ /** One Tuple and one write policy admit both records and every changed field. */
44
+ canUpdate: (schema: AccessKnowledgeSchemaReference, stored: AccessTestRecord, proposed: AccessTestRecord) => boolean;
45
+ /** A create of the record, or a delete of the stored record, is admitted by a write pair. */
46
+ canWrite: (schema: AccessKnowledgeSchemaReference, record: AccessTestRecord) => boolean;
47
+ /** A feature capability: the highest level of any Tuple wins. */
48
+ holds: (requirement: AccessCapabilityRequirement) => boolean;
49
+ /** The record with its Field Read Mask applied, or undefined when it is not readable. */
50
+ read: (schema: AccessKnowledgeSchemaReference, record: AccessTestRecord) => AccessTestRecord | undefined;
51
+ }>;
52
+ export type AccessConditionTestResult = Readonly<{
53
+ condition: string;
54
+ expected: boolean;
55
+ name: string;
56
+ passed: boolean;
57
+ }>;
58
+ export type AccessTest = Readonly<{
59
+ as: (principal: AccessTestPrincipal) => AccessTestSubject;
60
+ /** Runs the test cases of every declared Knowledge Data Condition. */
61
+ conditionTests: () => readonly AccessConditionTestResult[];
62
+ }>;
63
+ /**
64
+ * The SDK in-memory evaluator of the access model: declared capabilities,
65
+ * profiles, Grant Axes, Knowledge Data Policies and Conditions, Max Privileges
66
+ * and core policies, evaluated per grant as the engine does (D10).
67
+ */
68
+ export declare const accessTest: (packages: PackageDefinition | readonly PackageDefinition[], options?: AccessTestOptions) => AccessTest;
package/dist/index.d.ts CHANGED
@@ -1,3 +1,5 @@
1
+ export { accessTest } from "./access-test/index.js";
2
+ export type { AccessConditionTestResult, AccessTest, AccessTestEntity, AccessTestGrant, AccessTestGroup, AccessTestOptions, AccessTestPrincipal, AccessTestRecord, AccessTestSubject } from "./access-test/index.js";
1
3
  export { PackageConnection } from "./executables/connections.js";
2
4
  export type { PackageConnectionConstructor } from "./executables/connections.js";
3
5
  export { DatasetParser, ExternalDatasetProvider, ManagedDatasetProvider } from "./executables/datasets.js";
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,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});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 isText=(value)=>typeof value==="string";var inboundMessagingBinding=(context)=>{const{connection,messaging,state}=context.config??{};if(!isRecord(connection)||!isText(connection.id)||!isRecord(connection.values)||!isRecord(messaging)||!isText(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&&!isText(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:isText(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,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(canonicalJson(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(canonicalJson(actual)!==canonicalJson(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(canonicalJson(projection)!==canonicalJson(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{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,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
+ 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};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@collective-intelligence/extensions-sdk-backend",
3
- "version": "0.2.2",
3
+ "version": "0.2.3",
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,
@@ -44,7 +44,7 @@
44
44
  "access": "public"
45
45
  },
46
46
  "dependencies": {
47
- "@collective-intelligence/extensions-sdk": "0.2.2"
47
+ "@collective-intelligence/extensions-sdk": "0.2.3"
48
48
  },
49
49
  "peerDependencies": {
50
50
  "effect": "^4.1.0"
@@ -63,5 +63,5 @@
63
63
  "typescript": "7.0.2",
64
64
  "ultracite": "7.10.7"
65
65
  },
66
- "gitHead": "51fdea833e25fe215b3cf0d70adf1984b8e0f81c"
66
+ "gitHead": "1718b80bc8d0ba696d78ac8f5f905c8dc46fe0c5"
67
67
  }