@collective-intelligence/extensions-sdk-backend 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,286 @@
1
- # Temporary Holding Version
1
+ # `@collective-intelligence/extensions-sdk-backend`
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Framework-neutral executable contracts for backend extensions hosted by Collective Intelligence.
4
+
5
+ Use this package for executable component base classes, host capability keys, and the runtime context supplied by a host. Common declarations, schemas, fields, and manifests remain in `@collective-intelligence/extensions-sdk`.
6
+
7
+ Event-listener execution contracts (`EventListenerRuntime`, its factory, and
8
+ its host-supplied context) and the callback-bearing
9
+ `KnowledgeConnectorOAuthProvider` also live here. Their portable declarations,
10
+ request/result envelopes, and OAuth token data remain in the common SDK.
11
+
12
+ `DatasetParser` implements file parsing through `analyze(input)` and
13
+ `parseRecords(input)`, returning `Awaitable<DatasetParserResult<DatasetParserAnalysis>>`
14
+ and `Awaitable<DatasetParserResult<DatasetParserRecords>>`. Bind a no-argument
15
+ subclass with the base SDK's `declareDatasetParser`. Package runtime calls use
16
+ JSON `bytes: readonly number[]`; the runtime validates each byte (0–255) and a
17
+ positive safe integer `maxRows`, then reconstructs `Uint8Array`. Expected errors
18
+ are plain JSON failure envelopes; unexpected exceptions remain rejections.
19
+
20
+ `ManagedDatasetProvider` exposes readiness, datasetProvision, datasetIngest,
21
+ datasetQuery, datasetInspect, and datasetDelete. `ExternalDatasetProvider`
22
+ exposes readiness, listSources, discoverDefinition, datasetQuery, and
23
+ datasetInspect. Each method takes its portable dataset input plus
24
+ `PackageRuntimeContext` and returns an `Awaitable<DatasetProviderResult<T>>`.
25
+ Bind them with `declareManagedDatasetProvider` and
26
+ `declareExternalDatasetProvider`. The host supplies connection identity
27
+ and optional provider endpoint settings in `context.config`; an implementation
28
+ validates those settings and uses `context.resolveConnection` with an allowed
29
+ connection-template set to obtain authorized credentials. Original dataset
30
+ inputs remain unchanged. Neither credentials nor runtime configuration enter
31
+ the declaration. Runtime dispatch admits only the methods owned by each kind;
32
+ parsers cannot execute connector, knowledge-connector, documents-connector,
33
+ tool, or workflow hooks.
34
+
35
+ `PackageDocumentsConnector` implements file inventory and content fetch through
36
+ `pull(input, context)` and `fetchContent(input, context)`. Bind a no-argument
37
+ subclass with the base SDK's `declareDocumentsConnector`. `pull` receives
38
+ `{ cursor?, selectedRootRemoteIds? }` and returns JSON `{ items, nextCursor? }`.
39
+ `fetchContent` receives `{ contentRevision, remoteFileId }` and returns
40
+ `{ bytes: Uint8Array, mimeType?, extension?, filename?, source? }`, describing the
41
+ actual stored representation after any provider export. Package runtime calls use the default
42
+ `[value, context, progress]` invocation. Before JSON encoding, `fetchContent`
43
+ converts `bytes` into `bytesBase64` with standard base64 and preserves the
44
+ optional string fields and `source`; non-`Uint8Array` bytes and non-string format fields are
45
+ rejected. Raw `Uint8Array` never crosses the JSON invocation boundary.
46
+
47
+ `source` is the base SDK's `DocumentsSource` (`{ webUrl: string }`) and refers to
48
+ the live original individual file, separately from exported/stored Version bytes.
49
+ A present source survives serialization; `source: null` explicitly clears an
50
+ observed destination; omitted source stays omitted and means no observation.
51
+ Neither a collection-root URL nor an ID-derived URL substitutes for a missing
52
+ per-file URL. The host owns URL usability and authorization policy.
53
+
54
+ A connector may implement `fetchSource({ remoteFileId }, context)` for metadata-only
55
+ refresh of existing imports and unchanged revisions. Hosted callers invoke
56
+ `fetch_source`; no content revision or byte fetch is required. The result is a
57
+ `DocumentsSource` or explicit `null`. Missing optional hooks remain unsupported
58
+ operations, distinct from a successful `null` result. Provider failures reject
59
+ the invocation; they must not masquerade as missing metadata.
60
+ Read-only
61
+ browse operations `listDrives({ cursor? })`
62
+ and `listFolders({ parentRemoteId, cursor? })` return `{ items, nextCursor? }`
63
+ pages of drives and direct child folders; every returned `remoteId` is a
64
+ selectable `pull` / `proveRootAncestry` root. Knowledge-connector operations are
65
+ unchanged. `proveRootAncestry` passes provider-reported selected-root
66
+ `displayName` and `webUrl` through the hosted JSON invocation when present.
67
+
68
+ ```ts
69
+ import {
70
+ PackageTool,
71
+ type PackageRuntimeContext
72
+ } from "@collective-intelligence/extensions-sdk-backend"
73
+
74
+ export class EchoTool extends PackageTool<{ text: string }, string> {
75
+ execute(
76
+ input: { text: string },
77
+ _context: PackageRuntimeContext
78
+ ): PromiseLike<string> {
79
+ return Promise.resolve(input.text)
80
+ }
81
+ }
82
+ ```
83
+
84
+ A tool whose declaration sets `healthCheck: { description, capabilities? }`
85
+ implements the optional `healthCheck(context)` method (`health_check`
86
+ operation). It receives the same runtime context as `execute` (settings,
87
+ connection resolution, authority) but no input, and bypasses the tool input and
88
+ output schemas. It returns a `PackageToolHealthReport`:
89
+ `{ status: "healthy" | "degraded" | "failing", summary?, remediation?,
90
+ capabilities?: [{ name, status, summary?, remediation?, details? }] }`. Probes
91
+ must not mutate provider data or return workspace content; the host stamps the
92
+ check time (`checkedAt`), redacts credential values, and persists the report.
93
+ Details keep only camelCase identifier, code, count, and flag metadata: `id`,
94
+ `*Id`, `ids`, `*Ids`, `count`, `*Count`, `statusCode`, `action`, `category`,
95
+ `code`, `errorCode`, `permission`, `provider`, `providerFamily`,
96
+ `resourceType`, `scopeKind`, `authorityMode`, `configured`,
97
+ `permissionGranted`, and `reachable`; other keys are dropped.
98
+
99
+ The API exposes ordinary values and `PromiseLike` results. Effect services and private host implementations are intentionally outside this package.
100
+
101
+ For local validation, `test/consumer` is a private workspace with explicit SDK dependencies. Run `bun run test:pack` to verify the published boundary: it copies the consumer without local `node_modules` and installs the packed SDK artifacts in a temporary directory, so workspace links cannot satisfy its imports.
102
+
103
+ The fixture runs lint with its own generated configuration and declared tooling
104
+ dependencies. This keeps the SDK rules active for consumer code and resolves
105
+ the generated lint plugin from the fixture's scope.
106
+
107
+ ## Worker-local package runtime
108
+
109
+ Export one runtime over the same ordinary definitions used to declare a package:
110
+
111
+ ```ts
112
+ import { createBackendPackageRuntime } from "@collective-intelligence/extensions-sdk-backend"
113
+ import { packageDefinitions } from "./definitions"
114
+
115
+ export const runtime = createBackendPackageRuntime(packageDefinitions)
116
+ ```
117
+
118
+ The host calls `runtime.invoke({ packageFqn, componentFqn, operation, input,
119
+ context, signal, onProgress })`. Package identity is independent of the artifact
120
+ that acquired it: an aggregate built-in artifact may contain several packages.
121
+ Duplicate package or component identities fail during runtime creation. The
122
+ operation is checked against the component kind before constructing its class.
123
+ Authors keep their existing methods; they do not wrap each method as a hosted
124
+ contribution. Existing hosted contribution declarations remain separate exports.
125
+
126
+ Tool input decoders and output encoders execute beside the class. Connection
127
+ credentials, workflow input and output values, and workflow field values use
128
+ retained native sidecars. Workflow output encoding preserves the result envelope
129
+ and directives. Field `parts` receives `context.config`; `canonicalize` and
130
+ `validateLocal` receive the value and that configuration. Other methods receive
131
+ input and the invocation context; connection discovery also receives the progress
132
+ callback. Listener routing and field transformation methods are addressed by
133
+ snake_case operation values. A void result becomes JSON `null`.
134
+
135
+ `BackendPackageSchemaError` exposes `stage`, `location`, and `issues`. Package
136
+ exceptions retain their original identity and structured properties in the local
137
+ adapter; a worker transport must preserve those fields. Results and progress
138
+ must be JSON-compatible after native encoding. No constructor, codec, capability,
139
+ credential, or cancellation signal is serialized into the manifest.
140
+
141
+ Every call supplies an `AbortSignal`, also available as `context.signal`.
142
+ Cancellation is checked before decoding, before and after execution, and progress
143
+ is suppressed after cancellation. The host owns finite deadlines, cancellation
144
+ grace, forced worker termination, and shutdown. `context.deadlineAt`, when supplied,
145
+ is the host's absolute deadline in epoch milliseconds. The adapter does not retry
146
+ an invocation or authorize a caller; the host injects the authorized context and
147
+ capabilities for that invocation.
148
+
149
+ ### Tenant state
150
+
151
+ One Worker serves every Organization that invokes the same package release, and
152
+ several invocations may run in it at once. The per-call `context` is the only
153
+ tenant carrier: read the Organization, capabilities, store and configuration
154
+ from the `context` of the current call. Do not keep tenant data, contexts,
155
+ capabilities or credentials in module-level variables or caches that outlive the
156
+ call. The host authorizes each capability call from its own record of that
157
+ invocation, so a context kept from an earlier call is rejected once that call
158
+ ends. Workers are a shared execution environment, not a security sandbox.
159
+
160
+ ## Organization SSO
161
+
162
+ Use the base SDK's `declareOrganizationSso` with a `PackageOrganizationSso`
163
+ subclass. `authorizationUrl(request, context)` and `exchangeCode(request, context)`
164
+ use ordinary values or `PromiseLike` results. Requests carry a readonly credential
165
+ record; exchange returns `{ subject, email, name? }`. HTTP clients and other
166
+ services enter through capabilities. The declaration includes `providerId`,
167
+ `connectionTemplateFqn`, required and secret credential field names, and optional
168
+ localized setup guides. This metadata participates in the canonical package
169
+ manifest; the constructor remains worker-local.
170
+
171
+ For separate form, configuration, and port validation, the same `invoke` method
172
+ accepts `operation: "decode_schema" | "encode_schema"` with a required
173
+ `schemaLocation` from that component's retained sidecars. The adapter checks the
174
+ sidecar against its portable projection and returns JSON. This preserves host
175
+ boundaries that require decoded JSON; it deliberately rejects a nonportable
176
+ native result. Native tool and workflow values execute through the ordinary
177
+ method invocation so they stay in the worker. A location cannot select another
178
+ component's sidecars.
179
+
180
+ Listener acquisition hooks are optional: `parseSelector`, `normalizeInternal`,
181
+ `normalizeWebhook`, `normalizeWebhookRequest`, and `poll`. Missing hooks fail as
182
+ unsupported operations; the runtime does not invent empty acquisition results.
183
+ Existing `canonicalSelector`, `routeKeys`, and `broadRouteKeys` defaults remain.
184
+ `poll` receives the watch request and authorized `PackageRuntimeContext`, including
185
+ its cancellation signal. Internal normalization receives the JSON event envelope.
186
+
187
+ Webhook invocation uses explicit JSON envelopes:
188
+
189
+ - `normalizeWebhook`: `input: { bodyBytes: number[] }`.
190
+ - `normalizeWebhookRequest`: `input: { bodyBytes: number[], headers: Record<string, string> }`.
191
+
192
+ The adapter accepts only integer bytes from 0 through 255, reconstructs a
193
+ `Uint8Array`, and preserves header names and values. Headers must be strings.
194
+ The public `BackendWebhookBodyInput` and `BackendWebhookRequestInput` types name
195
+ these envelopes. The corresponding class hooks receive native bytes or the
196
+ native `{ body, headers }` request, plus the invocation context.
197
+
198
+ Entity adapter `extraProps` uses `BackendExtraPropsInput`:
199
+ `input: { remote: JsonObject, schemaMeta: JsonObject | null, originalRemote?: JsonObject }`.
200
+ The adapter calls `extraProps(remote, schemaMeta)` with exactly two data arguments
201
+ when `originalRemote` is absent. When present, it passes
202
+ `extraProps(remote, schemaMeta, originalRemote)` so extras can use original provider
203
+ metadata (such as file timestamps) even after mapped fields are pruned. It never substitutes
204
+ the host context for schema metadata. Product hosts own constructing these
205
+ envelopes and authorizing their context; package-internal helper methods remain
206
+ outside the callable operation inventory.
207
+
208
+ `PackageKnowledgeEntityAdapter<Remote, Local>` and
209
+ `PackageKnowledgeRelationAdapter<Remote, Local>` require
210
+ `remoteId(remote: Remote): Awaitable<string>`. Providers return a stable, nonempty
211
+ source identity, including any composite-key calculation. The `remoteId` worker
212
+ operation receives the remote JSON value through the existing invocation path;
213
+ local mapping and relation endpoints remain separate operations. Hosts must
214
+ validate the returned identity before graph writes. There is no default `id`
215
+ field reader and no identity derived from the local projection.
216
+
217
+ Hosts may supply `PackageRuntimeContext.capabilityBindings`, a
218
+ `ReadonlyMap<string, object>` of already-authorized services bound once for the
219
+ invocation. `capability(key)` must validate and return the same bound object.
220
+ Bindings may contain synchronous data and nested asynchronous methods; the host
221
+ owns transport and lifetime. This inventory grants no authority and never enters
222
+ portable manifests.
223
+
224
+ Hosts may also supply optional `PackageRuntimeContext.store` with `get`, `put`,
225
+ `delete`, and prefix `list`. Values are JSON objects only; nested arrays inside
226
+ an object are allowed. Every `put` requires a TTL from 1 minute to 30 days. Keys
227
+ are at most 512 bytes and values at most 64 KiB. Prefix list returns at most 100
228
+ keys and does not auto-walk. Isolation by organization and package FQN is
229
+ host-stamped; SDK keys are caller keys. Last-write-wins; there is no
230
+ compare-and-swap. Packages call `requirePackageRuntimeStore(context)` so omitted
231
+ store fails those operations. `assertPackageRuntimeStorePut` is the shared cap
232
+ check for authors and the host adapter in `apps/backend` (`PackageRuntimeStoreService`).
233
+ The store never enters portable manifests.
234
+
235
+ Tool invocations also receive read-only `PackageRuntimeContext.authority`
236
+ (`PackageRuntimeAuthority`: `mode` `admin_wide` or `fixed_user`, with optional
237
+ `impersonatedUserId` and `impersonatedSubject`) and, when a binding such as a
238
+ skill tool binding selected the tool, `bindingSettings`, separate from the
239
+ instance `config`. Packages may refuse work their authority does not allow;
240
+ the host remains the enforcement point for visibility and approval.
241
+
242
+ A tool connection reference may name a discovered catalog collection with
243
+ `catalogCollection`. Tool invocations then receive read-only
244
+ `connectionCatalogIds[slot]`: the `id` of every resource in that collection of
245
+ the bound connection's last discovery snapshot. A slot is omitted when it
246
+ declares no collection, or the connection has no usable snapshot or lacks that
247
+ collection; treat an omitted slot as unknown (unrestricted) and an empty list as
248
+ nothing reachable.
249
+
250
+ The `testAndDiscover` connection operation accepts the ordinary credential input,
251
+ `discover: boolean`, and an optional runtime-only `onTested: () => Awaitable<void>`.
252
+ It decodes credentials once and uses one instance for test and discovery. When
253
+ discovery is enabled, it awaits the tested observer before discovery; observer
254
+ failure or cancellation prevents discovery. Disabled discovery skips the observer
255
+ and returns `{ catalog: null }`; enabled discovery returns `{ catalog }`.
256
+ The caller's invocation signal bounds observer acknowledgement and progress.
257
+
258
+ An entity adapter without the optional `extraProps` hook returns JSON `null` for
259
+ that operation, allowing the host to apply its schema-field fallback. Implemented
260
+ hooks retain their results and errors; a non-callable hook remains an error.
261
+
262
+ Entity adapters may implement `normalizeImportedData(local, remote)` to normalize
263
+ mapped import data while retaining access to the original provider record. Declare
264
+ `normalizesImportedData: true` to opt in: hosts dispatch this operation only when
265
+ that manifest flag is true, preserving older runtime behavior when absent or false. Invoke
266
+ it with operation `normalizeImportedData` and `BackendNormalizeImportedDataInput`:
267
+ `input: { local: JsonValue, remote: JsonValue }`. The runtime passes these as two
268
+ data arguments, without substituting runtime context or the cancellation signal.
269
+ An absent hook returns `local` unchanged; non-callable hooks and implementation
270
+ failures propagate to the caller. Without a declarative field map, normalization
271
+ belongs in `toLocal(remote)`.
272
+
273
+ Entity adapters may also implement `normalizeFieldMapValue(value)` and declare
274
+ `normalizesFieldMapValues: true`. The host invokes it on each value read from an
275
+ inbound field-map path before a rule casts or transforms that value. An absent
276
+ hook returns the value unchanged; the method remains an executable sidecar.
277
+
278
+ Declare `entitySchemaFqn: "*"` for a connector-wide fallback adapter. Hosts select
279
+ one exact schema adapter first, then one wildcard adapter; ambiguous matches are
280
+ errors. The wildcard uses the existing declaration shape.
281
+
282
+ ## Enum value spelling
283
+
284
+ Repository-owned enum values use lower `snake_case`. This includes component kinds, dataset statuses, schema consumer profiles, and hosted contribution identity. Notification enum values retain their existing spelling. External protocol values, including HTTP methods and JSON Schema keywords and formats, retain the protocol spelling.
285
+
286
+ Invocation operation values such as `fetch_content`, `dataset_query`, and `test_and_discover` use `snake_case`; executable method names such as `fetchContent`, `datasetQuery`, and `testAndDiscover` retain their TypeScript spelling. The runtime translates operation values before dispatch.
@@ -0,0 +1,9 @@
1
+ import type { ConnectionDiscoveryCatalog, PackageConnectionProgress } from "@collective-intelligence/extensions-sdk";
2
+ import type { Awaitable, PackageRuntimeContext } from "../host/context.js";
3
+ export declare abstract class PackageConnection<Credentials = unknown, Result = void> {
4
+ readonly packageCredentials?: Credentials;
5
+ readonly packageResult?: Result;
6
+ test?(credentials: Credentials, context: PackageRuntimeContext): Awaitable<Result>;
7
+ discover?(credentials: Credentials, context: PackageRuntimeContext, progress?: (progress: PackageConnectionProgress) => void): Awaitable<ConnectionDiscoveryCatalog>;
8
+ }
9
+ export type PackageConnectionConstructor<Credentials = unknown> = new () => PackageConnection<Credentials>;
@@ -0,0 +1,24 @@
1
+ import type { DatasetDeleteInput, DatasetDeleteResult, DatasetIngestInput, DatasetIngestResult, DatasetInspectInput, DatasetInspectResult, DatasetParserAnalysis, DatasetParserInput, DatasetParserRecords, DatasetParserRecordsInput, DatasetParserResult, DatasetProviderResult, DatasetProvisionInput, DatasetProvisionResult, DatasetResultPage, DefinitionProposal, DiscoverDefinitionInput, ListSourcesInput, QueryInput, Readiness, ReadinessInput, SourcePage } from "@collective-intelligence/extensions-sdk";
2
+ import type { Awaitable, PackageRuntimeContext } from "../host/context.js";
3
+ /** CI-authoritative Dataset storage uses host-authorized connections from the invocation context. */
4
+ export declare abstract class ManagedDatasetProvider {
5
+ abstract readiness(input: ReadinessInput, context: PackageRuntimeContext): Awaitable<DatasetProviderResult<Readiness>>;
6
+ abstract datasetProvision(input: DatasetProvisionInput, context: PackageRuntimeContext): Awaitable<DatasetProviderResult<DatasetProvisionResult>>;
7
+ abstract datasetIngest(input: DatasetIngestInput, context: PackageRuntimeContext): Awaitable<DatasetProviderResult<DatasetIngestResult>>;
8
+ abstract datasetQuery(input: QueryInput, context: PackageRuntimeContext): Awaitable<DatasetProviderResult<DatasetResultPage>>;
9
+ abstract datasetInspect(input: DatasetInspectInput, context: PackageRuntimeContext): Awaitable<DatasetProviderResult<DatasetInspectResult>>;
10
+ abstract datasetDelete(input: DatasetDeleteInput, context: PackageRuntimeContext): Awaitable<DatasetProviderResult<DatasetDeleteResult>>;
11
+ }
12
+ /** External Dataset source access uses host-authorized connections from the invocation context. */
13
+ export declare abstract class ExternalDatasetProvider {
14
+ abstract readiness(input: ReadinessInput, context: PackageRuntimeContext): Awaitable<DatasetProviderResult<Readiness>>;
15
+ abstract listSources(input: ListSourcesInput, context: PackageRuntimeContext): Awaitable<DatasetProviderResult<SourcePage>>;
16
+ abstract discoverDefinition(input: DiscoverDefinitionInput, context: PackageRuntimeContext): Awaitable<DatasetProviderResult<DefinitionProposal>>;
17
+ abstract datasetQuery(input: QueryInput, context: PackageRuntimeContext): Awaitable<DatasetProviderResult<DatasetResultPage>>;
18
+ abstract datasetInspect(input: DatasetInspectInput, context: PackageRuntimeContext): Awaitable<DatasetProviderResult<DatasetInspectResult>>;
19
+ }
20
+ /** File parsing has no connector bindings or workflow execution hooks. */
21
+ export declare abstract class DatasetParser {
22
+ abstract analyze(input: DatasetParserInput): Awaitable<DatasetParserResult<DatasetParserAnalysis>>;
23
+ abstract parseRecords(input: DatasetParserRecordsInput): Awaitable<DatasetParserResult<DatasetParserRecords>>;
24
+ }
@@ -0,0 +1,41 @@
1
+ import type { DocumentsDeltaPage, DocumentsDeltaRequest, DocumentsDrivesPage, DocumentsFoldersPage, DocumentsFetchedContent, DocumentsSource, DocumentsRootAncestry } from "@collective-intelligence/extensions-sdk";
2
+ import type { Awaitable, PackageRuntimeContext } from "../host/context.js";
3
+ /** File inventory and content fetch use host-authorized connections from invocation context. */
4
+ export declare abstract class PackageDocumentsConnector {
5
+ abstract deltaPage(input: DocumentsDeltaRequest, context: PackageRuntimeContext): Awaitable<DocumentsDeltaPage>;
6
+ abstract proveRootAncestry(input: {
7
+ readonly rootRemoteId: string;
8
+ }, context: PackageRuntimeContext): Awaitable<DocumentsRootAncestry>;
9
+ /** Drive `remoteId`s are root folder ids accepted by `pull` and `proveRootAncestry`. */
10
+ abstract listDrives(input: {
11
+ readonly cursor?: string;
12
+ }, context: PackageRuntimeContext): Awaitable<DocumentsDrivesPage>;
13
+ /** Direct child folders only, sorted by title. */
14
+ abstract listFolders(input: {
15
+ readonly parentRemoteId: string;
16
+ readonly cursor?: string;
17
+ }, context: PackageRuntimeContext): Awaitable<DocumentsFoldersPage>;
18
+ abstract pull(input: {
19
+ readonly cursor?: string;
20
+ readonly selectedRootRemoteIds?: readonly string[];
21
+ }, context: PackageRuntimeContext): Awaitable<{
22
+ readonly items: readonly {
23
+ readonly contentHash?: string;
24
+ readonly contentRevision?: string;
25
+ readonly deleted?: boolean;
26
+ readonly kind: "file" | "folder";
27
+ readonly parentRemoteIds: readonly string[];
28
+ readonly remoteFileId: string;
29
+ readonly title: string;
30
+ }[];
31
+ readonly nextCursor?: string;
32
+ }>;
33
+ /** Optional live-file metadata refresh. Missing hook is unsupported, not a source clear. */
34
+ fetchSource?(input: {
35
+ readonly remoteFileId: string;
36
+ }, context: PackageRuntimeContext): Awaitable<DocumentsSource | null>;
37
+ abstract fetchContent(input: {
38
+ readonly contentRevision: string;
39
+ readonly remoteFileId: string;
40
+ }, context: PackageRuntimeContext): Awaitable<DocumentsFetchedContent>;
41
+ }
@@ -0,0 +1,12 @@
1
+ import type { EventListenerInternalOccurrence, EventListenerPollRequest, EventListenerPollResult, EventListenerWebhookRequest, JsonObject } from "@collective-intelligence/extensions-sdk";
2
+ import type { Awaitable, PackageRuntimeContext } from "../host/context.js";
3
+ export declare abstract class PackageEventListener<Selector = unknown> {
4
+ poll?(request: EventListenerPollRequest, context: PackageRuntimeContext): Awaitable<EventListenerPollResult>;
5
+ normalizeWebhook?(body: Uint8Array, context: PackageRuntimeContext): Awaitable<readonly EventListenerInternalOccurrence[]>;
6
+ normalizeWebhookRequest?(request: EventListenerWebhookRequest, context: PackageRuntimeContext): Awaitable<readonly EventListenerInternalOccurrence[]>;
7
+ parseSelector?(selector: Selector): Awaitable<Selector>;
8
+ normalizeInternal?(envelope: JsonObject, context: PackageRuntimeContext): Awaitable<readonly EventListenerInternalOccurrence[]>;
9
+ canonicalSelector(selector: Selector): Selector;
10
+ routeKeys(_selector: Selector): Readonly<Record<string, string>>;
11
+ broadRouteKeys(): Readonly<Record<string, string>>;
12
+ }
@@ -0,0 +1,36 @@
1
+ import type { JsonObject, JsonValue } from "@collective-intelligence/extensions-sdk";
2
+ import type { Awaitable, PackageRuntimeContext } from "../host/context.js";
3
+ export declare abstract class PackageKnowledgeConnector<PullInput = unknown, PushInput = unknown, DiscoveryInput = unknown> {
4
+ readonly packagePullInput?: PullInput;
5
+ readonly packagePushInput?: PushInput;
6
+ readonly packageDiscoveryInput?: DiscoveryInput;
7
+ browse?(_input: JsonValue, _context: PackageRuntimeContext): Awaitable<JsonValue>;
8
+ discover?(_input: DiscoveryInput, _context: PackageRuntimeContext): Awaitable<JsonValue>;
9
+ pull?(_input: PullInput, _context: PackageRuntimeContext): Awaitable<JsonValue>;
10
+ read?(_input: JsonValue, _context: PackageRuntimeContext): Awaitable<JsonValue>;
11
+ push?(_input: PushInput, _context: PackageRuntimeContext): Awaitable<JsonValue>;
12
+ }
13
+ export declare abstract class PackageKnowledgeConnectorOAuth<AuthorizeInput = unknown, ExchangeInput = unknown> {
14
+ readonly packageAuthorizeInput?: AuthorizeInput;
15
+ readonly packageExchangeInput?: ExchangeInput;
16
+ abstract authorizeUrl(input: AuthorizeInput, context: PackageRuntimeContext): Awaitable<string>;
17
+ abstract exchangeCode(input: ExchangeInput, context: PackageRuntimeContext): Awaitable<JsonValue>;
18
+ }
19
+ export declare abstract class PackageKnowledgeEntityAdapter<Remote = unknown, Local = unknown> {
20
+ readonly packageRemote?: Remote;
21
+ readonly packageLocal?: Local;
22
+ abstract remoteId(remote: Remote): Awaitable<string>;
23
+ normalizeFieldMapValue?(value: JsonValue): Awaitable<JsonValue>;
24
+ extraProps?(remote: Remote, schemaMeta: JsonObject | null, originalRemote?: Remote): Awaitable<JsonObject>;
25
+ normalizeImportedData?(local: Local, remote: Remote): Awaitable<Local>;
26
+ abstract toLocal(remote: Remote): Awaitable<Local>;
27
+ abstract toRemote(local: Local): Awaitable<Remote>;
28
+ }
29
+ export declare abstract class PackageKnowledgeRelationAdapter<Remote = unknown, Local = unknown> {
30
+ readonly packageRemote?: Remote;
31
+ readonly packageLocal?: Local;
32
+ abstract remoteId(remote: Remote): Awaitable<string>;
33
+ abstract toLocal(remote: Remote): Awaitable<Local>;
34
+ abstract sourceRef(remote: Remote): Awaitable<string>;
35
+ abstract targetRef(remote: Remote): Awaitable<string>;
36
+ }
@@ -0,0 +1,5 @@
1
+ import type { Awaitable, PackageRuntimeContext } from "../host/context.js";
2
+ export declare abstract class PackageNotificationChannel<Message = unknown> {
3
+ readonly packageMessage?: Message;
4
+ abstract deliver(message: Message, context: PackageRuntimeContext): Awaitable<void>;
5
+ }
@@ -0,0 +1,23 @@
1
+ import type { Awaitable, PackageRuntimeContext } from "../host/context.js";
2
+ export type PackageSsoIdentity = Readonly<{
3
+ subject: string;
4
+ email: string;
5
+ name?: string;
6
+ }>;
7
+ export type PackageSsoAuthorizationRequest = Readonly<{
8
+ credentials: Readonly<Record<string, string>>;
9
+ redirectUri: string;
10
+ state: string;
11
+ loginHint?: string;
12
+ codeChallenge?: string;
13
+ }>;
14
+ export type PackageSsoCodeExchangeRequest = Readonly<{
15
+ credentials: Readonly<Record<string, string>>;
16
+ redirectUri: string;
17
+ code: string;
18
+ codeVerifier?: string;
19
+ }>;
20
+ export declare abstract class PackageOrganizationSso {
21
+ abstract authorizationUrl(request: PackageSsoAuthorizationRequest, context: PackageRuntimeContext): Awaitable<string>;
22
+ abstract exchangeCode(request: PackageSsoCodeExchangeRequest, context: PackageRuntimeContext): Awaitable<PackageSsoIdentity>;
23
+ }
@@ -0,0 +1,35 @@
1
+ import type { JsonObject } from "@collective-intelligence/extensions-sdk";
2
+ import type { Awaitable, PackageRuntimeContext } from "../host/context.js";
3
+ export type PackageToolHealthStatus = "healthy" | "degraded" | "failing";
4
+ /** One declared capability's probe result; never workspace content or secrets. */
5
+ export type PackageToolHealthCapability = Readonly<{
6
+ details?: JsonObject;
7
+ name: string;
8
+ remediation?: readonly string[];
9
+ status: PackageToolHealthStatus;
10
+ summary?: string | null;
11
+ }>;
12
+ /** A read-only readiness result; the host stamps the check time and persists it. */
13
+ export type PackageToolHealthReport = Readonly<{
14
+ capabilities?: readonly PackageToolHealthCapability[];
15
+ remediation?: readonly string[];
16
+ status: PackageToolHealthStatus;
17
+ summary?: string | null;
18
+ }>;
19
+ export declare abstract class PackageTool<Input = unknown, Output = unknown> {
20
+ readonly packageInput?: Input;
21
+ readonly packageOutput?: Output;
22
+ abstract execute(input: Input, context: PackageRuntimeContext): Awaitable<Output>;
23
+ /**
24
+ * Optional non-mutating readiness probe (`health_check` operation), paired
25
+ * with the declaration's `healthCheck` metadata. Receives the same runtime
26
+ * context as `execute`, without tool input.
27
+ */
28
+ healthCheck?(context: PackageRuntimeContext): Awaitable<PackageToolHealthReport>;
29
+ }
30
+ export type PackageToolConstructor<Input = unknown, Output = unknown> = new () => PackageTool<Input, Output>;
31
+ export declare abstract class PackageToolSettingsOptions<Input = unknown, Output = unknown> {
32
+ readonly packageInput?: Input;
33
+ readonly packageOutput?: Output;
34
+ abstract getOptions(input: Input, context: PackageRuntimeContext): Awaitable<Output>;
35
+ }
@@ -0,0 +1,7 @@
1
+ import type { Awaitable } from "../host/context.js";
2
+ export declare abstract class PackageFieldTransformer<Input = unknown, Output = unknown> {
3
+ readonly packageInput?: Input;
4
+ readonly packageOutput?: Output;
5
+ abstract transform(value: Input): Awaitable<Output>;
6
+ inverse?(value: Output): Awaitable<Input>;
7
+ }
@@ -0,0 +1,21 @@
1
+ import type { FieldOption, FieldOptionPage, FieldOptionsInput, FieldPart, JsonObject, JsonValue, PackageWorkflowNodeExecutionResult } from "@collective-intelligence/extensions-sdk";
2
+ import type { Awaitable, PackageRuntimeContext } from "../host/context.js";
3
+ export type { PackageWorkflowNodeDirective, PackageWorkflowNodeExecutionResult, PackageWorkflowNodeResult, PackageWorkflowPauseResumeContract } from "@collective-intelligence/extensions-sdk";
4
+ export declare abstract class PackageWorkflowNode<Input = unknown, Output = JsonObject> {
5
+ readonly packageInput?: Input;
6
+ readonly packageOutput?: Output;
7
+ abstract execute(input: Input, context: PackageRuntimeContext): Awaitable<PackageWorkflowNodeExecutionResult<Output>>;
8
+ }
9
+ export type PackageWorkflowNodeRuntime = Omit<PackageWorkflowNode<JsonValue, JsonValue>, "packageInput" | "packageOutput">;
10
+ export type PackageWorkflowNodeConstructor = new () => PackageWorkflowNodeRuntime;
11
+ export declare abstract class PackageFieldDefinition<Value extends JsonValue = JsonValue, Config extends JsonObject = JsonObject, OptionValue extends JsonValue = Value> {
12
+ readonly supportsOptionPaging = false;
13
+ canonicalize(value: Value, _config?: Config): Awaitable<Value>;
14
+ validateLocal(value: Value, _config?: Config): Awaitable<Value>;
15
+ parts(_config?: Config): Awaitable<readonly FieldPart[]>;
16
+ getOptions(_input: FieldOptionsInput<Config>, _context?: PackageRuntimeContext): Awaitable<readonly FieldOption<OptionValue>[] | FieldOptionPage<OptionValue>>;
17
+ }
18
+ export declare abstract class PackageWorkflowField<Value extends JsonValue = JsonValue, Config extends JsonObject = JsonObject, OptionValue extends JsonValue = Value> extends PackageFieldDefinition<Value, Config, OptionValue> {
19
+ }
20
+ export type PackageFieldDefinitionConstructor = new () => PackageFieldDefinition;
21
+ export type PackageWorkflowFieldConstructor = new () => PackageWorkflowField;
@@ -0,0 +1,7 @@
1
+ /** A host-owned capability handle. Its value is never serialized into a package manifest. */
2
+ export type CapabilityKey<Service extends object> = Readonly<{
3
+ readonly id: string;
4
+ readonly isService: (value: unknown) => value is Service;
5
+ }>;
6
+ /** Declares a host-neutral capability dependency for a package implementation. */
7
+ export declare const defineCapability: <Service extends object>(id: string, requiredKeys: readonly (keyof Service)[]) => CapabilityKey<Service>;
@@ -0,0 +1,63 @@
1
+ import type { JsonObject } from "@collective-intelligence/extensions-sdk";
2
+ import type { CapabilityKey } from "./capabilities.js";
3
+ import type { PackageRuntimeStore } from "./store.js";
4
+ export type Awaitable<Value> = PromiseLike<Value> | Value;
5
+ /** Provider-neutral connection material resolved and authorized by the host. */
6
+ export type PackageRuntimeConnection = Readonly<{
7
+ readonly id: string;
8
+ readonly templateFqn: string;
9
+ readonly values: Readonly<Record<string, string | null>>;
10
+ }>;
11
+ export type PackageRuntimeConnectionRequest = Readonly<{
12
+ readonly allowedConnectionTemplateFqns: ReadonlySet<string>;
13
+ readonly connectionId?: string;
14
+ readonly slot?: string;
15
+ }>;
16
+ export type PackageContentCapture = Readonly<{
17
+ readonly content: Uint8Array;
18
+ readonly contentType: string | null;
19
+ readonly filename: string;
20
+ }>;
21
+ export type PackageContentCaptureResult = Readonly<{
22
+ readonly contentHash: string;
23
+ readonly sizeBytes: number;
24
+ readonly storageFileId: string;
25
+ }>;
26
+ /**
27
+ * Authority the host granted this invocation: organization-wide, or fixed to
28
+ * one impersonated user. Read-only; packages may refuse work that needs more.
29
+ */
30
+ export type PackageRuntimeAuthority = Readonly<{
31
+ readonly mode: "admin_wide" | "fixed_user";
32
+ readonly impersonatedSubject?: string;
33
+ readonly impersonatedUserId?: string;
34
+ }>;
35
+ /** Already-authorized services bound once for one invocation; never portable manifest data. */
36
+ export type PackageRuntimeCapabilityBindings = ReadonlyMap<string, object>;
37
+ /** Host authority supplied at an executable package boundary. */
38
+ export type PackageRuntimeContext = Readonly<{
39
+ readonly signal?: AbortSignal;
40
+ readonly deadlineAt?: number;
41
+ readonly config?: JsonObject;
42
+ /**
43
+ * Settings of the binding (for example a skill's tool binding) that selected
44
+ * this invocation, separate from the instance `config`. Absent when unbound.
45
+ */
46
+ readonly bindingSettings?: JsonObject;
47
+ /**
48
+ * Per connection slot whose reference declares `catalogCollection`, the ids
49
+ * of the remote resources the bound connection could reach at its last
50
+ * discovery. A missing slot means unknown (no restriction); an empty list
51
+ * means the connection reaches nothing.
52
+ */
53
+ readonly connectionCatalogIds?: Readonly<Record<string, readonly string[]>>;
54
+ /** Present for tool invocations. */
55
+ readonly authority?: PackageRuntimeAuthority;
56
+ readonly organizationId: string;
57
+ /** Enumeration for host transports. Lookup must return the same bound objects. */
58
+ readonly capabilityBindings?: PackageRuntimeCapabilityBindings;
59
+ readonly capability: <Service extends object>(key: CapabilityKey<Service>) => Service;
60
+ readonly resolveConnection?: (request: PackageRuntimeConnectionRequest) => Awaitable<PackageRuntimeConnection | undefined>;
61
+ readonly captureContent?: (input: PackageContentCapture) => Awaitable<PackageContentCaptureResult>;
62
+ readonly store?: PackageRuntimeStore;
63
+ }>;
@@ -0,0 +1,28 @@
1
+ import type { EventListenerDeclaration, EventListenerInternalOccurrence, EventListenerPollRequest, EventListenerPollResult, EventListenerWebhookRequest, JsonObject } from "@collective-intelligence/extensions-sdk";
2
+ /** Runtime provenance supplied by the host to a package event listener. */
3
+ export type EventListenerRuntimeContext = Readonly<{
4
+ connection?: Readonly<{
5
+ id: string;
6
+ values: Readonly<Record<string, string | null>>;
7
+ }>;
8
+ installationId: string;
9
+ listener: Readonly<{
10
+ fqn: string;
11
+ version: string;
12
+ }>;
13
+ organizationId: string;
14
+ state?: JsonObject;
15
+ requiredCapability?: EventListenerDeclaration["capabilities"][number];
16
+ sourceWatchId?: string;
17
+ }>;
18
+ export type EventListenerRuntime = Readonly<{
19
+ broadRouteKeys: (selector: JsonObject) => Readonly<Record<string, string>>;
20
+ canonicalSelector: (selector: JsonObject) => JsonObject;
21
+ normalizeInternal?: (envelope: JsonObject) => readonly EventListenerInternalOccurrence[] | Promise<readonly EventListenerInternalOccurrence[]>;
22
+ normalizeWebhook?: (body: Uint8Array) => readonly EventListenerInternalOccurrence[] | Promise<readonly EventListenerInternalOccurrence[]>;
23
+ normalizeWebhookRequest?: (request: EventListenerWebhookRequest) => readonly EventListenerInternalOccurrence[] | Promise<readonly EventListenerInternalOccurrence[]>;
24
+ poll?: (request: EventListenerPollRequest) => EventListenerPollResult | Promise<EventListenerPollResult>;
25
+ parseSelector: (selector: JsonObject) => JsonObject;
26
+ routeKeys: (selector: JsonObject) => Readonly<Record<string, string>>;
27
+ }>;
28
+ export type EventListenerRuntimeFactory = (context: EventListenerRuntimeContext) => EventListenerRuntime | Promise<EventListenerRuntime>;
@@ -0,0 +1,11 @@
1
+ import type { KnowledgeConnectorOAuthTokens } from "@collective-intelligence/extensions-sdk";
2
+ export type KnowledgeConnectorOAuthProvider = Readonly<{
3
+ authorizeUrl: (input: Readonly<{
4
+ redirectUri: string;
5
+ state: string;
6
+ }>) => string | Promise<string>;
7
+ exchangeCode: (input: Readonly<{
8
+ code: string;
9
+ redirectUri: string;
10
+ }>) => KnowledgeConnectorOAuthTokens | Promise<KnowledgeConnectorOAuthTokens>;
11
+ }>;
@@ -0,0 +1,25 @@
1
+ import type { JsonObject } from "@collective-intelligence/extensions-sdk";
2
+ import type { Awaitable, PackageRuntimeContext } from "./context.js";
3
+ /** Caller-owned JSON object stored with a required TTL. Isolation is host-stamped. */
4
+ export type PackageRuntimeStore = Readonly<{
5
+ readonly get: (key: string) => Awaitable<JsonObject | undefined>;
6
+ readonly put: (key: string, value: JsonObject, ttlSeconds: number) => Awaitable<void>;
7
+ readonly delete: (key: string) => Awaitable<void>;
8
+ readonly list: (prefix: string) => Awaitable<readonly string[]>;
9
+ }>;
10
+ export declare class PackageRuntimeStoreMissingError extends Error {
11
+ readonly name = "PackageRuntimeStoreMissingError";
12
+ constructor();
13
+ }
14
+ export declare class PackageRuntimeStoreConstraintError extends Error {
15
+ readonly name = "PackageRuntimeStoreConstraintError";
16
+ }
17
+ export declare const PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES = 512;
18
+ export declare const PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES: number;
19
+ export declare const PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS = 60;
20
+ export declare const PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS: number;
21
+ export declare const PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS = 100;
22
+ /** Reject values the store will not persist. Host adapters reuse this before write. */
23
+ export declare const assertPackageRuntimeStorePut: (key: string, value: unknown, ttlSeconds: number) => void;
24
+ /** Fail store operations when the host omitted `context.store`. */
25
+ export declare const requirePackageRuntimeStore: (context: PackageRuntimeContext) => PackageRuntimeStore;
@@ -0,0 +1,20 @@
1
+ import type { HostedContributionDeclaration, HostedContributionInput, HostedContributionSourceIdentity } from "@collective-intelligence/extensions-sdk";
2
+ import type { Awaitable, PackageRuntimeContext } from "../host/context.js";
3
+ export type BackendInvocationIdentity = Readonly<{
4
+ contributionFqn: string;
5
+ extensionPackageFqn: string;
6
+ host: "backend";
7
+ organizationId: string;
8
+ source: HostedContributionSourceIdentity;
9
+ tenantId: string;
10
+ }>;
11
+ export type BackendInvocationIdentityInput = Omit<BackendInvocationIdentity, "host">;
12
+ /** Host Capabilities plus the immutable identity injected for one call. */
13
+ export type BackendHostedContributionContext = PackageRuntimeContext & Readonly<{
14
+ invocation: BackendInvocationIdentity;
15
+ }>;
16
+ export type BackendHostedContributionHandler<Input, Output> = (input: Input, context: BackendHostedContributionContext) => Awaitable<Output>;
17
+ export type BackendContributionInput<Module extends object> = Omit<HostedContributionInput<Module>, "host">;
18
+ export declare const declareBackendContribution: <Module extends object>(input: BackendContributionInput<Module>) => HostedContributionDeclaration<Module>;
19
+ /** Materializes the exact immutable code and authorization identity for a call. */
20
+ export declare const backendInvocationIdentity: (input: BackendInvocationIdentityInput) => BackendInvocationIdentity;
@@ -0,0 +1,26 @@
1
+ export { PackageConnection } from "./executables/connections.js";
2
+ export type { PackageConnectionConstructor } from "./executables/connections.js";
3
+ export { DatasetParser, ExternalDatasetProvider, ManagedDatasetProvider } from "./executables/datasets.js";
4
+ export { PackageDocumentsConnector } from "./executables/documents.js";
5
+ export { PackageEventListener } from "./executables/events.js";
6
+ export { PackageKnowledgeConnector, PackageKnowledgeConnectorOAuth, PackageKnowledgeEntityAdapter, PackageKnowledgeRelationAdapter } from "./executables/knowledge.js";
7
+ export { PackageNotificationChannel } from "./executables/notifications.js";
8
+ export { PackageOrganizationSso } from "./executables/organization-sso.js";
9
+ export type { PackageSsoAuthorizationRequest, PackageSsoCodeExchangeRequest, PackageSsoIdentity } from "./executables/organization-sso.js";
10
+ export { PackageTool, PackageToolSettingsOptions } from "./executables/tooling.js";
11
+ export type { PackageToolConstructor, PackageToolHealthCapability, PackageToolHealthReport, PackageToolHealthStatus } from "./executables/tooling.js";
12
+ export { PackageFieldTransformer } from "./executables/transforms.js";
13
+ export { PackageFieldDefinition, PackageWorkflowField, PackageWorkflowNode } from "./executables/workflows.js";
14
+ export type { PackageFieldDefinitionConstructor, PackageWorkflowFieldConstructor, PackageWorkflowNodeConstructor, PackageWorkflowNodeDirective, PackageWorkflowNodeExecutionResult, PackageWorkflowNodeResult, PackageWorkflowNodeRuntime, PackageWorkflowPauseResumeContract } from "./executables/workflows.js";
15
+ export { defineCapability } from "./host/capabilities.js";
16
+ export type { CapabilityKey } from "./host/capabilities.js";
17
+ export type { Awaitable, PackageContentCapture, PackageContentCaptureResult, PackageRuntimeAuthority, PackageRuntimeCapabilityBindings, PackageRuntimeConnection, PackageRuntimeConnectionRequest, PackageRuntimeContext } from "./host/context.js";
18
+ export type { PackageRuntimeStore } from "./host/store.js";
19
+ export { assertPackageRuntimeStorePut, 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, PackageRuntimeStoreConstraintError, PackageRuntimeStoreMissingError, requirePackageRuntimeStore } from "./host/store.js";
20
+ export type { EventListenerRuntime, EventListenerRuntimeContext, EventListenerRuntimeFactory } from "./host/event-listener-runtime.js";
21
+ export type { KnowledgeConnectorOAuthProvider } from "./host/knowledge-oauth-provider.js";
22
+ export { backendInvocationIdentity, declareBackendContribution } from "./hosted/contribution.js";
23
+ export type { BackendContributionInput, BackendHostedContributionContext, BackendHostedContributionHandler, BackendInvocationIdentity, BackendInvocationIdentityInput } from "./hosted/contribution.js";
24
+ export { BackendPackageSchemaError, isBackendPackageOperationAllowed } from "./runtime/contracts.js";
25
+ export type { BackendDatasetParserInput, BackendDatasetParserRecordsInput, BackendExtraPropsInput, BackendNormalizeImportedDataInput, BackendPackageInvocation, BackendPackageOperation, BackendPackageRuntime, BackendWebhookBodyInput, BackendWebhookRequestInput } from "./runtime/contracts.js";
26
+ export { createBackendPackageRuntime } from "./runtime/package-runtime.js";
package/dist/index.js ADDED
@@ -0,0 +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,{requirePackageRuntimeStore:()=>requirePackageRuntimeStore,isBackendPackageOperationAllowed:()=>isBackendPackageOperationAllowed,defineCapability:()=>defineCapability,declareBackendContribution:()=>declareBackendContribution,createBackendPackageRuntime:()=>createBackendPackageRuntime,backendInvocationIdentity:()=>backendInvocationIdentity,assertPackageRuntimeStorePut:()=>assertPackageRuntimeStorePut,PackageWorkflowNode:()=>PackageWorkflowNode,PackageWorkflowField:()=>PackageWorkflowField,PackageToolSettingsOptions:()=>PackageToolSettingsOptions,PackageTool:()=>PackageTool,PackageRuntimeStoreMissingError:()=>PackageRuntimeStoreMissingError,PackageRuntimeStoreConstraintError:()=>PackageRuntimeStoreConstraintError,PackageOrganizationSso:()=>PackageOrganizationSso,PackageNotificationChannel:()=>PackageNotificationChannel,PackageKnowledgeRelationAdapter:()=>PackageKnowledgeRelationAdapter,PackageKnowledgeEntityAdapter:()=>PackageKnowledgeEntityAdapter,PackageKnowledgeConnectorOAuth:()=>PackageKnowledgeConnectorOAuth,PackageKnowledgeConnector:()=>PackageKnowledgeConnector,PackageFieldTransformer:()=>PackageFieldTransformer,PackageFieldDefinition:()=>PackageFieldDefinition,PackageEventListener:()=>PackageEventListener,PackageDocumentsConnector:()=>PackageDocumentsConnector,PackageConnection:()=>PackageConnection,PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES:()=>PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES,PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS:()=>PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS,PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS:()=>PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS,PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS:()=>PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS,PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES:()=>PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES,ManagedDatasetProvider:()=>ManagedDatasetProvider,ExternalDatasetProvider:()=>ExternalDatasetProvider,DatasetParser:()=>DatasetParser,BackendPackageSchemaError:()=>BackendPackageSchemaError});class PackageConnection{}class ManagedDatasetProvider{}class ExternalDatasetProvider{}class DatasetParser{}class PackageDocumentsConnector{}class PackageEventListener{canonicalSelector(selector){return selector}routeKeys(_selector){return{}}broadRouteKeys(){return{}}}class PackageKnowledgeConnector{}class PackageKnowledgeConnectorOAuth{}class PackageKnowledgeEntityAdapter{}class PackageKnowledgeRelationAdapter{}class PackageNotificationChannel{}class PackageOrganizationSso{}class PackageTool{}class PackageToolSettingsOptions{}class PackageFieldTransformer{}class PackageWorkflowNode{}class PackageFieldDefinition{supportsOptionPaging=false;canonicalize(value,_config){return value}validateLocal(value,_config){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 compareCodePoints=(left,right)=>{const leftPoints=Array.from(left,(character)=>character.codePointAt(0)??0);const rightPoints=Array.from(right,(character)=>character.codePointAt(0)??0);const length=Math.min(leftPoints.length,rightPoints.length);for(let index=0;index<length;index+=1){const difference=leftPoints[index]-rightPoints[index];if(difference!==0){return difference}}return leftPoints.length-rightPoints.length};var insertSortedKey=(keys,key)=>{let index=0;while(index<keys.length&&compareCodePoints(keys[index]??"",key)<=0){index+=1}keys.splice(index,0,key)};var isJsonObject=(value)=>Object.prototype.toString.call(value)==="[object Object]"&&!Array.isArray(value)&&(Object.getPrototypeOf(value)===Object.prototype||Object.getPrototypeOf(value)===null);var isJsonArray=(value)=>Array.isArray(value);var canonicalize=(value,ancestors,_valueType)=>{if(value===null){return"null"}if(isJsonArray(value)){if(ancestors.has(value)){throw new TypeError("package declarations cannot contain cyclic values")}ancestors.add(value);try{return`[${value.map((item)=>canonicalize(item,ancestors)).join(",")}]`}finally{ancestors.delete(value)}}if(isJsonObject(value)){if(ancestors.has(value)){throw new TypeError("package declarations cannot contain cyclic values")}ancestors.add(value);try{const record=value;const keys=[];for(const key of Object.keys(record)){insertSortedKey(keys,key)}return`{${keys.map((key)=>`${JSON.stringify(key)}:${canonicalize(record[key],ancestors)}`).join(",")}}`}finally{ancestors.delete(value)}}if(value instanceof Object){throw new TypeError("package declarations must contain JSON-compatible values")}switch(Object.prototype.toString.call(value)){case"[object Boolean]":{return value===true?"true":"false"}case"[object Number]":{const number=Number(value);if(!Number.isFinite(number)){throw new TypeError("package declarations cannot contain non-finite numbers")}return JSON.stringify(number)}case"[object String]":{return JSON.stringify(String(value))}default:{throw new TypeError("package declarations must contain JSON-compatible values")}}};var canonicalJson=(value,..._typeEvidence)=>canonicalize(value,new WeakSet);var parseJsonObject=(source)=>{const value=JSON.parse(source);if(!isJsonObject(value)){throw new TypeError("expected a JSON object")}return value};var compareUtf16CodeUnits=(left,right)=>{const length=Math.min(left.length,right.length);for(let index=0;index<length;index+=1){const difference=left.charCodeAt(index)-right.charCodeAt(index);if(difference!==0){return difference}}return left.length-right.length};var invalid=(path)=>{throw new TypeError(`Invalid package manifest at ${path}`)};var string=(v,p)=>typeof v==="string"?v:invalid(p);var identity=(v,p)=>{const s=string(v,p);return s.trim()===""?invalid(p):s};var hostedIdentity=(value,path)=>{const text=identity(value,path);return text===text.trim()?text:invalid(path)};var assertDenseArrays=(value,path,seen)=>{if(typeof value!=="object"||value===null||seen.has(value)){return}seen.add(value);if(Array.isArray(value)){for(let index=0;index<value.length;index+=1){if(!Object.hasOwn(value,index)){invalid(`${path}/${index}`)}}}for(const[key,child]of Object.entries(value)){assertDenseArrays(child,`${path}/${key}`,seen)}};var boolean=(v,p)=>typeof v==="boolean"?v:invalid(p);var number=(v,p)=>typeof v==="number"&&Number.isFinite(v)?v:invalid(p);var positiveSafeInteger=(value,path)=>{const parsed=number(value,path);return Number.isSafeInteger(parsed)&&parsed>0?parsed:invalid(path)};var optional=(read)=>(v,p)=>v===undefined?undefined:read(v,p);var nullable=(read)=>(v,p)=>v===null?null:read(v,p);var literal=(...values)=>(v,p)=>{for(const value of values){if(v===value){return value}}return invalid(p)};var array=(read)=>(v,p)=>{if(!Array.isArray(v)){return invalid(p)}return v.map((item,index)=>read(item,`${p}/${index}`))};var record=(read)=>(v,p)=>{if(typeof v!=="object"||v===null||Array.isArray(v)){return invalid(p)}return Object.fromEntries(Object.entries(v).map(([key,value])=>[key,read(value,`${p}/${key}`)]))};var object=(fields)=>(v,p)=>{if(typeof v!=="object"||v===null||Array.isArray(v)){return invalid(p)}const entries=Object.entries(v);for(const key in fields){if(!Object.hasOwn(fields,key)){continue}fields[key](entries.find(([name])=>name===key)?.[1],`${p}/${key}`)}return v};var refine=(read,violation)=>(v,p)=>{const value=read(v,p);return violation(value)===undefined?value:invalid(p)};var strings=array(string);var optString=optional(string);var optBoolean=optional(boolean);var optNumber=optional(number);var optStrings=optional(strings);var json=(v)=>parseJsonObject(canonicalJson({value:v})).value;var jsonObject=record(json);var base={description:optString,displayName:string,fqn:identity,icon:optString,tags:optStrings,version:string};var union=(left,right)=>(v,p)=>{try{return left(v,p)}catch(error){if(!(error instanceof TypeError)){throw error}return right(v,p)}};var schemaDocument=(v,p)=>{const doc=jsonObject(v,p);const schemaType=literal("array","boolean","integer","null","number","object","string");const fields={$anchor:optString,$comment:optString,$defs:optional(record(schemaDocument)),$dynamicAnchor:optString,$dynamicRef:optString,$id:optString,$ref:optString,$schema:optional(literal("https://json-schema.org/draft/2020-12/schema")),additionalProperties:optional(union(boolean,schemaDocument)),allOf:optional(array(schemaDocument)),anyOf:optional(array(schemaDocument)),const:optional(json),contains:optional(schemaDocument),default:optional(json),dependentRequired:optional(record(strings)),description:optString,else:optional(schemaDocument),enum:optional(array(json)),exclusiveMaximum:optNumber,exclusiveMinimum:optNumber,format:optString,if:optional(schemaDocument),items:optional(schemaDocument),maxItems:optNumber,maxLength:optNumber,maxProperties:optNumber,maximum:optNumber,minItems:optNumber,minLength:optNumber,minProperties:optNumber,minimum:optNumber,multipleOf:optNumber,not:optional(schemaDocument),oneOf:optional(array(schemaDocument)),pattern:optString,patternProperties:optional(record(schemaDocument)),prefixItems:optional(array(schemaDocument)),properties:optional(record(schemaDocument)),required:optStrings,then:optional(schemaDocument),title:optString,type:optional(union(schemaType,array(schemaType))),unevaluatedItems:optional(union(boolean,schemaDocument)),unevaluatedProperties:optional(union(boolean,schemaDocument)),uniqueItems:optBoolean};return object(fields)(doc,p)};var schema=object({dialect:literal("https://json-schema.org/draft/2020-12/schema"),document:schemaDocument,fidelity:literal("exact","structural")});var visibility=object({equals:optional(json),field:string,in:optional(array(json)),isNotSet:optBoolean,isSet:optBoolean,notEquals:optional(json),notIn:optional(array(json))});var visibilityRule=object({logic:optional(literal("and","or")),visibleWhen:union(visibility,array(visibility))});var validationRule=(v,p)=>{const{type}=object({type:string})(v,p);const messages={code:optString,message:optString};switch(type){case"min_length":case"max_length":case"min":case"max":{return object({...messages,type:literal(type),value:number})(v,p)}case"pattern":{return object({...messages,type:literal(type),value:string})(v,p)}case"required":{return object({...messages,type:literal("required")})(v,p)}default:{return object({...messages,type:literal("integer","json","non_empty_array")})(v,p)}}};var selectOption=object({label:optString,locked:optBoolean,value:string});var selectOptions=object({aiFill:optional(object({buttonLabel:optString,prompt:string,retryable:optBoolean})),allowClear:optBoolean,allowCustom:optBoolean,dataSource:optString,dependencies:optStrings,options:optional(array(union(string,selectOption))),preventSaveWhenEmpty:optBoolean,readonlyOnUpdate:optBoolean,searchable:optBoolean,selectionMetadataField:optString,submit:optBoolean});var fieldUi=object({"ui:disabled":optBoolean,"ui:help":optString,"ui:options":optional(selectOptions),"ui:order":optNumber,"ui:placeholder":optString,"ui:readonly":optBoolean,"ui:suggestedName":optString,"ui:validation":optional(array(validationRule)),"ui:widget":optString});var formItems=array(union(string,object({md:string})));var form=object({createSteps:optional(array(object({description:optional(nullable(string)),id:string,includeInBasicInfo:optional(nullable(boolean)),items:formItems,title:string,visibility:optional(nullable(visibilityRule))}))),layout:optional(literal("stacked","two_column")),schema,uiSchema:optional(record(fieldUi)),updateSections:optional(array(object({description:optional(nullable(string)),items:formItems,layout:optional(nullable(literal("stacked","two_column"))),title:optional(nullable(string))}))),visibility:optional(record(visibilityRule))});var closedGatewayObject=(fields)=>refine(object(fields),(value)=>Object.keys(value).some((key)=>!Object.hasOwn(fields,key))?"unexpected Gateway field":undefined);var identifier=refine(string,(value)=>/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/u.test(value)?undefined:"invalid identifier");var version=refine(string,(value)=>value.length>0&&value.length<=128&&value.trim()===value?undefined:"invalid version");var bounded=(maximum,minimum=1)=>refine(number,(value)=>Number.isSafeInteger(value)&&value>=minimum&&value<=maximum?undefined:"invalid limit");var unique=(read,key)=>refine(read,(values)=>new Set(values.map(key)).size===values.length?undefined:"duplicate identifier");var projection=refine(schema,(value)=>(value.fidelity==="exact"||value.fidelity==="structural")&&Object.keys(value).every((key)=>key==="dialect"||key==="document"||key==="fidelity")?undefined:"unsupported Gateway projection");var authorization=closedGatewayObject({delegatedSubject:literal("allowed","forbidden","required"),organization:literal("required"),principalKinds:refine(unique(array(literal("detached_user","service_principal")),(kind)=>kind),(values)=>values.length>0?undefined:"empty principalKinds"),scopes:unique(array(refine(string,(value)=>value.length>0&&value.length<=256?undefined:"invalid scope")),(scope)=>scope)});var operationFields={authorization,description:string,effects:literal("external_side_effect","read","write"),execution:closedGatewayObject({mode:literal("synchronous"),timeoutMs:bounded(3600000)}),id:identifier,idempotency:literal("idempotent","requires_key","safe"),input:projection,limits:closedGatewayObject({maxRequestBytes:bounded(16777216),maxResponseBytes:bounded(16777216)}),output:projection,retry:union(closedGatewayObject({mode:literal("never")}),closedGatewayObject({maxAttempts:bounded(10,2),mode:literal("idempotent_only")})),title:string,version};var operationReader=closedGatewayObject(operationFields);var domainFields={description:optional(string),displayOrder:optional(number),icon:optional(string),id:identifier,tags:optional(strings),title:string};var domainsReader=unique(array(closedGatewayObject({...domainFields,operations:unique(array(operationReader),(operation)=>operation.id)})),(domain)=>domain.id);var inputReader=closedGatewayObject({id:identifier,operationDomains:domainsReader,version});var empty=refine(array(identity),(values)=>values.length===0?undefined:"operation-only Gateway required");var emptyReader=(value,path)=>{empty(value,path);return[]};var disabled=(value,path)=>boolean(value,path)===false?false:invalid(path);var contractReader=closedGatewayObject({capabilities:closedGatewayObject({resources:disabled}),datasets:emptyReader,id:identifier,knowledge:emptyReader,operationDomains:unique(array(closedGatewayObject({...domainFields,operations:unique(array(closedGatewayObject({...operationFields,canonicalReference:string})),(operation)=>operation.id)})),(domain)=>domain.id),organizationBinding:closedGatewayObject({mode:literal("installed_organization")}),protocolVersion:literal("2"),version});var buildOperationGatewayContract=(input)=>{assertDenseArrays(input,"gateway",new WeakSet);canonicalJson(input);const admitted=inputReader(input,"gateway");return{capabilities:{resources:false},datasets:[],id:admitted.id,knowledge:[],operationDomains:admitted.operationDomains.map((domain)=>({...domain,operations:domain.operations.map((operation)=>({...operation,canonicalReference:`${admitted.id}/${domain.id}/${operation.id}@${operation.version}`})).sort((a,b)=>compareUtf16CodeUnits(a.id,b.id))})).sort((a,b)=>compareUtf16CodeUnits(a.id,b.id)),organizationBinding:{mode:"installed_organization"},protocolVersion:"2",version:admitted.version}};var readOperationGatewayContract=(value,path)=>{assertDenseArrays(value,path,new WeakSet);const admitted=contractReader(value,path);const normalized=buildOperationGatewayContract({id:admitted.id,operationDomains:admitted.operationDomains.map((domain)=>({...domain,operations:domain.operations.map(({canonicalReference:_reference,...operation})=>operation)})),version:admitted.version});if(canonicalJson(admitted)!==canonicalJson(normalized)){invalid(path)}return normalized};var deepFreeze=(value)=>{if(value!==null&&typeof value==="object"&&!Object.isFrozen(value)){Object.freeze(value);for(const child of Object.values(value)){deepFreeze(child)}}return value};var SchemaConsumerProfiles=Object.freeze({automationGraphInput:"workflow_value",automationGraphOutput:"workflow_value",connectionCredential:"interactive_form",connectorSettings:"interactive_form",form:"interactive_form",knowledgeEntity:"knowledge_record",knowledgeRelation:"knowledge_record",notificationCredential:"interactive_form",studioComponentProps:"studio_props",toolInput:"ai_function_input",toolOutput:"runtime_json",toolSettings:"interactive_form",workflowConfiguration:"workflow_value",workflowFieldValue:"workflow_value",workflowInput:"workflow_value",workflowOutput:"workflow_value",workflowPortValue:"workflow_value"});var annotationKeywords=["$anchor","$comment","$id","$schema","$vocabulary","deprecated","description","examples","readOnly","title","writeOnly"];var structuralKeywords=["$defs","$ref","additionalProperties","const","enum","items","properties","required","type"];var boundKeywords=["exclusiveMaximum","exclusiveMinimum","maxItems","maxLength","maxProperties","maximum","minItems","minLength","minProperties","minimum","multipleOf","pattern","uniqueItems"];var UnrestrictedScopeKeyword="x-unrestricted-scope";var baseProfileKeywords=[...annotationKeywords,...structuralKeywords,...boundKeywords];var ConsumerProfiles=deepFreeze({ai_function_input:{allowedFidelity:["exact","structural"],allowedKeywords:[...baseProfileKeywords,"anyOf"],id:"ai_function_input",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","oneOf","not","patternProperties","prefixItems","contains","dependentRequired","if","then","else","unevaluatedItems","unevaluatedProperties"]},interactive_form:{allowedFidelity:["exact"],allowedKeywords:[...baseProfileKeywords,"anyOf","default","format",UnrestrictedScopeKeyword],id:"interactive_form",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","oneOf","not","patternProperties","contains","dependentRequired","if","then","else","prefixItems","unevaluatedItems","unevaluatedProperties"]},knowledge_record:{allowedFidelity:["exact","structural"],allowedKeywords:[...baseProfileKeywords,"format"],id:"knowledge_record",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","anyOf","oneOf","not","patternProperties","prefixItems","contains","dependentRequired","if","then","else","unevaluatedItems","unevaluatedProperties"]},runtime_json:{allowedFidelity:["exact","structural"],allowedKeywords:null,id:"runtime_json",rootObject:false,unsupportedKeywords:["$dynamicRef","$dynamicAnchor"]},studio_props:{allowedFidelity:["exact"],allowedKeywords:[...baseProfileKeywords,"anyOf","default","format"],id:"studio_props",rootObject:true,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","oneOf","not","patternProperties","contains","dependentRequired","if","then","else","prefixItems","unevaluatedItems","unevaluatedProperties"]},workflow_value:{allowedFidelity:["exact","structural"],allowedKeywords:[...baseProfileKeywords,"default","format","oneOf"],id:"workflow_value",rootObject:false,unsupportedKeywords:["$dynamicRef","$dynamicAnchor","allOf","anyOf","not","unevaluatedItems","unevaluatedProperties"]}});var knownVocabularies=new Set(["https://json-schema.org/draft/2020-12/vocab/applicator","https://json-schema.org/draft/2020-12/vocab/content","https://json-schema.org/draft/2020-12/vocab/core","https://json-schema.org/draft/2020-12/vocab/format-annotation","https://json-schema.org/draft/2020-12/vocab/format-assertion","https://json-schema.org/draft/2020-12/vocab/meta-data","https://json-schema.org/draft/2020-12/vocab/unevaluated","https://json-schema.org/draft/2020-12/vocab/validation"]);var schemaArrayKeywords=new Set(["allOf","anyOf","oneOf","prefixItems"]);var schemaMapKeywords=new Set(["$defs","patternProperties","properties"]);var schemaValueKeywords=new Set(["additionalProperties","contains","else","if","items","not","then","unevaluatedItems","unevaluatedProperties"]);var workflowBindingKey=(binding)=>canonicalJson({path:binding.path,target:binding.target});var renderWorkflowBinding=(binding)=>`${binding.target}:${binding.path.join(".")}`;var isConnectionCount=(value)=>value===undefined||value===null||Number.isSafeInteger(value)&&value>=0;var workflowPortPolicyViolation=(port)=>{if(!isConnectionCount(port.minConnections)||!isConnectionCount(port.maxConnections)){return"connection counts must be non-negative integers"}const max=port.maxConnections===undefined?1:port.maxConnections;if(max!==null&&(port.minConnections??0)>max){return"minConnections cannot exceed maxConnections"}if(port.allowedTemplateKinds?.length===0){return"allowedTemplateKinds cannot be empty"}if(port.allowedTemplateFqns?.length===0){return"allowedTemplateFqns cannot be empty"}if(port.schemaResolution?.variants.length===0){return"schemaResolution requires variants"}return};var firstDuplicate=(values)=>values.find((value,index)=>values.indexOf(value)!==index);var workflowEditorViolation=(editor)=>{const sections=editor.form?.sections??[];const duplicateSection=firstDuplicate(sections.flatMap((section)=>section.id===undefined?[]:[section.id]));if(duplicateSection!==undefined){return`workflow editor section id '${duplicateSection}' is not unique`}const fields=sections.flatMap((section)=>section.fields??[]);const keys=fields.map((field)=>workflowBindingKey(field.binding));const duplicateField=fields.find((field,index)=>keys.indexOf(workflowBindingKey(field.binding))!==index);if(duplicateField!==undefined){return`workflow editor binding ${renderWorkflowBinding(duplicateField.binding)} is not unique`}for(const field of fields){const references=[...(field.visibleWhen??[]).map((rule)=>rule.binding),...field.optionSource?.kind==="remote"?field.optionSource.dependsOn:[]];const dangling=references.find((reference)=>!keys.includes(workflowBindingKey(reference)));if(dangling!==undefined){return`workflow editor field ${renderWorkflowBinding(field.binding)} references unknown binding ${renderWorkflowBinding(dangling)}`}}return};var metadata=object({available:boolean,label:string});var connection=object({...base,compatibility:optional(object({auth:optString,dialect:optString,extensions:optional(jsonObject),provider:optString})),creationMode:optional(literal("self_service","registration_only")),credential:form,defaultConnectionName:string,discoveryMetadata:optional(metadata),kind:literal("connection"),providerFamily:string,secretFields:optStrings,testMetadata:optional(metadata)});var pathParts=array(union(string,number));var bindingModes=array(literal("external","managed"));var syncModes=array(literal("delta","full"));var bindingScopes=array(literal("organization","tenant"));var mutationPolicy=literal("always","connector_backed","never");var extraProps=literal("ignore","import","inline");var outboundStrategy=literal("local_first","remote_first");var updateMode=literal("full","partial");var localized=object({fallbackLocale:string,values:record(string)});var catalogTags=optional(record(strings));var connectionRefs=optional(array(object({catalogCollection:optString,connectionTemplateFqn:string,label:string,required:optBoolean,slot:string,visibleWhen:optional(visibility)})));var fieldMap=(v,p)=>{const common={direction:literal("both","inbound","outbound"),local:string,skipIfNull:boolean};const{op}=object({op:string})(v,p);switch(op){case"path":{return object({...common,op:literal(op),remote:string})(v,p)}case"cast":{return object({...common,falseValues:optStrings,op:literal(op),remote:string,trueValues:optStrings})(v,p)}case"default":{return object({...common,op:literal(op),remote:optString,value:json})(v,p)}case"concat":{return object({...common,op:literal(op),remote:strings,separator:optString})(v,p)}case"split":{return object({...common,discardEmpty:optBoolean,op:literal(op),remote:string,separators:optStrings,trimItems:optBoolean,uniqueItems:optBoolean})(v,p)}case"coordinates":{return object({...common,latitudeKey:optString,longitudeKey:optString,op:literal(op),remote:(value,location)=>{const parts=strings(value,location);if(parts.length!==2){return invalid(location)}return[string(parts[0],location),string(parts[1],location)]}})(v,p)}case"transform":{return object({...common,op:literal(op),remote:string,transformerId:string})(v,p)}default:{return invalid(`${p}/op`)}}};var predefinedExtras=optional(array(object({displayName:nullable(string),enabled:boolean,id:string,includeInEntityEmbedding:boolean,kind:literal("linked_text","file_source"),slotKey:string,source:jsonObject})));var predefinedSchedules=optional(array(object({cronExpression:string,enabled:optBoolean,importMode:optional(literal("delta","full")),label:optString,rationale:optString,timezone:optString})));var schemaCapability={extraPropsMode:optional(extraProps),fieldMap:optional(array(fieldMap)),fqn:string,outboundStrategy:optional(outboundStrategy),predefinedBindingExtras:predefinedExtras,predefinedBindingKey:optString,predefinedBindingMode:optional(literal("external","managed")),predefinedBindingRemoteCollectionId:optString,predefinedBindingRemoteCollectionName:optString,predefinedSchedules,supportedSyncModes:optional(syncModes),supportsInbound:optBoolean,supportsOutbound:optBoolean,syncIntervalSeconds:optional(nullable(number)),updateMode:optional(updateMode)};var entityCapability=object({...schemaCapability,predefinedBindingParentKey:optString,supportedBindingModes:optional(bindingModes)});var relationCapability=object({...schemaCapability,predefinedBindingParentEntityKey:optString,predefinedBindingRelationImportMode:optional(literal("child_binding","relation_only")),predefinedBindingSourceEntityKey:optString,predefinedBindingTargetEntityKey:optString});var discoveryDefaults=object({extraPropsMode:extraProps,outboundStrategy,supportedBindingModes:bindingModes,supportedSyncModes:syncModes,supportsInbound:boolean,supportsOutbound:boolean,syncIntervalSeconds:nullable(number),updateMode});var datasetCapabilities=object({aggregates:array(literal("count","count_distinct","sum","min","max","avg")),definitionRefresh:boolean,grouping:boolean,intents:array(literal("records","aggregate","time_series")),limits:object({maxBytes:number,maxPageRows:number,maxRows:number,timeoutMs:number}),ordering:boolean,pagination:boolean,predicates:array(literal("eq","ne","lt","lte","gt","gte","in","not_in","is_null","is_not_null","contains","starts_with"))});var fieldSemantics=object({defaultSearch:optBoolean,embedded:optBoolean,faceted:optBoolean,indexContent:optBoolean,indexOverview:optBoolean,indexed:optBoolean,managedProjectionSource:optional(literal("organization_team","organization_user")),queryGuidance:optString,unique:optBoolean});var managedProjection=object({connectorPolicy:literal("allow","deny_schema"),genericMutationPolicy:literal("deny_managed_fields","deny_schema"),kind:literal("directory_person","directory_person_in_team","directory_team","directory_team_parent"),source:literal("organization_team","organization_team_hierarchy","organization_team_membership","organization_user")});var fieldLocalization=object({description:optional(localized),help:optional(localized),label:optional(localized),placeholder:optional(localized)});var fieldPresentation=object({copyable:optBoolean,editor:optString,editorOptions:optional(object({accepts:optStrings,allowCustomValues:optBoolean,autocomplete:optString,clearable:optBoolean,falseLabel:optString,multiple:optBoolean,options:optional(array(object({label:string,value:string}))),rows:optNumber,searchable:optBoolean,showButtons:optBoolean,spellcheck:optBoolean,step:optNumber,trueLabel:optString})),emptyLabel:optString,falseLabel:optString,hidden:optBoolean,layout:optional(object({column:optNumber,labelPlacement:optional(literal("left","top")),order:optNumber,row:optNumber,width:optional(union(number,literal("full")))})),maxLines:optNumber,readOnly:optBoolean,renderer:optString,trueLabel:optString});var lifecycle=object({deployMode:literal("init_only","upsert"),readonly:boolean});var autocompleteConfiguration=object({autocompleteFields:array(object({field:string,scope:literal("data","entity")})),defaultAutocompleteFields:array(object({field:string,scope:literal("data","entity")}))});var knowledgeSchema={catalogTags,domainFqn:string,fieldLocalization:optional(record(fieldLocalization)),fieldPresentation:optional(record(fieldPresentation)),fieldSemantics:optional(record(fieldSemantics)),localMutationPolicy:optional(mutationPolicy),managedProjection:optional(managedProjection),schema};var policyRef=(value,path)=>{const{kind}=object({kind:string})(value,path);return kind==="literal"?object({kind:literal("literal"),value:json})(value,path):object({kind:literal("subject","resource"),path:strings})(value,path)};var uuid=(value,path)=>{const parsed=identity(value,path);return/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu.test(parsed)?parsed:invalid(path)};var policyPredicate=(value,path)=>{const{op}=object({op:string})(value,path);switch(op){case"eq":case"neq":case"lt":case"lte":case"gt":case"gte":{return object({left:policyRef,op:literal("eq","neq","lt","lte","gt","gte"),right:policyRef})(value,path)}case"in":{return object({op:literal("in"),set:policyRef,value:policyRef})(value,path)}case"exists":case"is_null":{return object({op:literal("exists","is_null"),ref:policyRef})(value,path)}case"contains":case"starts_with":{return object({op:literal("contains","starts_with"),ref:policyRef,value:policyRef})(value,path)}case"const":{return object({op:literal("const"),value:boolean})(value,path)}case"not":{return object({arg:policyPredicate,op:literal("not")})(value,path)}case"and":case"or":{return object({args:array(policyPredicate),op:literal("and","or")})(value,path)}case"relation_exists":{return object({direction:literal("out","in"),op:literal("relation_exists"),relationSchemaId:uuid})(value,path)}case"relation_field":{return object({direction:literal("out","in"),inner:policyPredicate,op:literal("relation_field"),relationSchemaId:uuid})(value,path)}default:{return invalid(`${path}/op`)}}};var policyBody=object({rule:optional(policyPredicate),subjectMatch:policyPredicate});var policyFields={effect:literal("allow","deny"),policyBody,policyType:literal("filter","gate"),targetFqn:identity,targetKind:literal("entity_domain","entity_schema","relation_domain","relation_schema")};var connection2=refine(object({setupKey:identity}),(value)=>Object.keys(value).some((key)=>key!=="setupKey")?"install-only input":undefined);var bindingFields={executionRole:optional(literal("root","child")),extraPropsMode:optional(literal("ignore","import","inline")),extras:refine(predefinedExtras,(extras)=>extras?.some((extra)=>!/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu.test(extra.id))?"invalid extra UUID":undefined),fieldMap:optional(array(fieldMap)),key:identity,outboundStrategy:optional(literal("local_first","remote_first")),parentKey:optional(nullable(identity)),remoteCollectionId:optional(nullable(string)),remoteCollectionName:optional(nullable(string)),supportedSyncModes:optional(array(literal("delta","full"))),supportsInbound:optBoolean,supportsOutbound:optBoolean,syncIntervalSeconds:optional(nullable(positiveSafeInteger)),updateMode:optional(literal("full","partial"))};var entityBinding=object({...bindingFields,bindingMode:literal("managed","external"),missingConnectorFieldsBehavior:optional(literal("prune","retain")),schemaFqn:identity,supportedBindingModes:optional(array(literal("managed","external"))),suppressEntityEvents:optBoolean});var relationBinding=object({...bindingFields,bindingMode:optional(literal("managed")),relationImportMode:optional(literal("child_binding","relation_only")),relationSchemaFqn:identity,sourceEntityKey:optional(nullable(identity)),targetEntityKey:optional(nullable(identity))});var schedule=object({cronExpression:identity,enabled:optBoolean,importMode:optional(literal("delta","full")),key:identity,timezone:optString});var positive=refine(number,(n)=>n>0?undefined:"positive");var budget=optional(nullable(positiveSafeInteger));var pipeline=object({definition:object({budgets:optional(object({maxPagesPerRun:budget,maxRemoteItemsPerRun:budget,maxRootWorkUnitsPerRun:budget,maxSecondsPerRun:optional(nullable(positive))})),steps:refine(array(object({tasks:array(object({bindingKey:identity,kind:literal("entity","relation"),modeOverride:optional(nullable(literal("delta","full")))}))})),(steps)=>steps.length>0?undefined:"empty")}),enabled:optBoolean,key:identity,name:optString,schedules:optional(array(schedule))});var uniqueKeys=(values,path)=>{const seen=new Set;for(const[index,value]of values.entries()){if(seen.has(value.key)){invalid(`${path}/${index}/key`)}seen.add(value.key)}};var knowledge=object({...base,connections:optional(record(connection2)),dataPolicies:optional(array(object({...policyFields,fqn:identity,priority:optNumber}))),enabled:optBoolean,entityBindings:optional(array(entityBinding)),kind:literal("knowledgeConnectorInstance"),lifecycle,pipelines:optional(array(pipeline)),relationBindings:optional(array(relationBinding)),remoteFilters:optional(record(object({mode:literal("all","only_selected","all_except_selected"),selected_ids:strings}))),settings:optional(record(object({type:literal("inline","linked"),value:json}))),templateFqn:identity});var assertEntityParents=(entities,path)=>{const parents=new Map(entities.map((b)=>[b.key,b.parentKey]));for(const binding of entities){const seen=new Set([binding.key]);let parent=binding.parentKey;while(parent){if(seen.has(parent)){invalid(`${path}/entityBindings/parentKey`)}seen.add(parent);parent=parents.get(parent)}}};var assertPolicyLifecycle=(policies,path)=>{for(const[index,policy]of policies.entries()){if(Object.keys(policy).some((key)=>key==="lifecycle"||key==="deployMode"||key==="readonly")){invalid(`${path}/dataPolicies/${index}/lifecycle`)}}};var knowledgeConnectorInstance=(value,path)=>{const parsed=knowledge(value,path);assertPolicyLifecycle(parsed.dataPolicies??[],path);const entities=parsed.entityBindings??[];const relations=parsed.relationBindings??[];const pipelines=parsed.pipelines??[];uniqueKeys(entities,`${path}/entityBindings`);uniqueKeys(relations,`${path}/relationBindings`);uniqueKeys(pipelines,`${path}/pipelines`);const entityKeys=new Set(entities.map((b)=>b.key));const relationKeys=new Set(relations.map((b)=>b.key));assertEntityParents(entities,path);for(const[index,binding]of[...entities,...relations].entries()){if(binding.parentKey&&(!entityKeys.has(binding.parentKey)||binding.parentKey===binding.key)){invalid(`${path}/bindings/${index}/parentKey`)}}for(const[index,relation]of relations.entries()){for(const key of[relation.sourceEntityKey,relation.targetEntityKey]){if(key&&!entityKeys.has(key)){invalid(`${path}/relationBindings/${index}`)}}}for(const[index,item]of pipelines.entries()){uniqueKeys(item.schedules??[],`${path}/pipelines/${index}/schedules`);const tasks=new Set;for(const step of item.definition.steps){for(const task of step.tasks){const keys=task.kind==="entity"?entityKeys:relationKeys;const key=`${task.kind}:${task.bindingKey}`;if(!keys.has(task.bindingKey)||tasks.has(key)){invalid(`${path}/pipelines/${index}/definition/steps`)}tasks.add(key)}}}return parsed};var scalar=literal("boolean","string","int64","float64","decimal","date","timestamp","duration","json");var datasetDefinition=object({fields:array(object({id:identity,name:string,nullable:boolean,semantic:optString,type:scalar})),measures:array(object({id:identity,name:string,resultType:scalar})),relationships:array(object({cardinality:literal("one_to_one","one_to_many","many_to_one","many_to_many"),fromFieldId:identity,id:identity,toFieldId:identity})),version:literal(1)});var location=(value,path)=>{const{segments}=object({segments:array(object({kind:literal("container","dataset"),label:string,opaqueId:identity}))})(value,path);const[first]=segments;if(!first||first.kind!=="container"){return invalid(`${path}/segments/0`)}return{segments:[{...first,kind:"container"},...segments.slice(1)]}};var datasetValue=(value,path)=>{const{kind}=object({kind:string})(value,path);switch(kind){case"null":{return object({kind:literal("null")})(value,path)}case"boolean":{return object({kind:literal("boolean"),value:boolean})(value,path)}case"float64":{return object({kind:literal("float64"),value:number})(value,path)}case"json":{return object({kind:literal("json"),value:json})(value,path)}default:{return object({kind:literal("string","int64","decimal","date","timestamp","duration"),value:string})(value,path)}}};var datasetFilter=(value,path)=>{const{kind}=object({kind:string})(value,path);if(kind==="not"){return object({filter:datasetFilter,kind:literal("not")})(value,path)}if(kind==="and"||kind==="or"){return object({filters:array(datasetFilter),kind:literal("and","or")})(value,path)}return object({fieldId:identity,kind:literal("predicate"),operator:literal("eq","ne","lt","lte","gt","gte","in","not_in","is_null","is_not_null","contains","starts_with"),values:array(datasetValue)})(value,path)};var datasetFields={...base,connection:optional(connection2),dataPolicy:optional(object({allowedFields:strings,allowedOperations:array(literal("describe","records","aggregate","time_series")),maxBytes:budget,maxRows:budget,maxTimeoutMs:budget,principals:array(object({id:identity,kind:literal("user","service")})),rowFilter:optional(nullable(datasetFilter)),sensitiveFields:optional(strings)})),kind:literal("datasetConnectorInstance"),lifecycle,providerFqn:identity,schedules:optional(array(object({action:literal("health","refresh_definition"),cronExpression:identity,enabled:optBoolean,key:identity,timezone:optString}))),settings:optional(jsonObject)};var datasetConnectorInstance=(value,path)=>{const parsed=union(object({...datasetFields,bindingMode:literal("managed"),definition:datasetDefinition,sourceLocation:optional(location),templateConfig:optional(object({variant:identity,version:literal(1)})),templateFqn:optional(identity)}),object({...datasetFields,bindingMode:literal("external"),definition:optional(datasetDefinition),gatewayBindingKey:optString,sourceLocation:location,sourceMapping:optional(object({effectiveAtFieldId:optString,entityIdFieldId:identity,historySemantics:optional(literal("append_history")),kind:literal("entity_snapshot","status_update"),statusFieldId:optString,version:literal(1)}))}))(value,path);uniqueKeys(parsed.schedules??[],`${path}/schedules`);return parsed};var datasetParserFormat=(value,path)=>{if(typeof value!=="string"||value.length>128||value==="external"||!/^[a-z][a-z0-9._-]*$/u.test(value)){throw new TypeError(`Invalid dataset parser format at ${path}`)}return value};var datasetParserVersion=(value,path)=>{if(typeof value!=="string"||value.trim()===""||value.length>96){throw new TypeError(`Invalid dataset parser version at ${path}`)}return value};var readExternalAppGateway=closedGatewayObject({...base,expectedContract:readOperationGatewayContract,kind:literal("externalAppGateway")});var identifier2=/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/u;var fields=new Set(["category","defaultVisibility","description","displayName","fqn","gatewayRef","icon","kind","operationReferences","tags","version"]);var referencesGateway=(reference,gatewayId)=>{const separator=reference.indexOf("@");if(separator===-1){return false}const[gateway,domain,operation,...rest]=reference.slice(0,separator).split("/");const version2=reference.slice(separator+1);return identifier2.test(gatewayId)&&gateway===gatewayId&&domain!==undefined&&identifier2.test(domain)&&operation!==undefined&&identifier2.test(operation)&&rest.length===0&&version2.length>0&&version2.length<=128&&version2.trim()===version2};var remoteToolCollectionViolation=(declaration)=>{const unknownField=Object.keys(declaration).find((key)=>!fields.has(key));if(unknownField!==undefined){return`unsupported remote metadata field '${unknownField}'`}const{gatewayRef,operationReferences}=declaration;if(gatewayRef===undefined||gatewayRef.trim()===""||gatewayRef.trim()!==gatewayRef){return"gatewayRef must be a nonempty FQN"}if(operationReferences.length===0||new Set(operationReferences).size!==operationReferences.length||operationReferences.some((reference)=>!referencesGateway(reference,reference.split("/")[0]??""))){return"operationReferences must name unique versioned Gateway operations"}return};var readPin=object({fqn:hostedIdentity,releaseDigest:(value,path)=>{const digest=hostedIdentity(value,path);return/^[\da-f]{64}$/u.test(digest)?digest:invalid(path)},releaseId:hostedIdentity});var parsePackageDependencyPins=(value)=>{const pins=array(readPin)(value,"/dependencies");const identities=new Set;for(const pin of pins){if(Object.keys(pin).some((key)=>!["fqn","releaseId","releaseDigest"].includes(key))){throw new TypeError(`package dependency '${pin.fqn}' has unexpected fields`)}if(identities.has(pin.fqn)){throw new TypeError(`duplicate package dependency '${pin.fqn}'`)}identities.add(pin.fqn)}return[...pins].sort((left,right)=>compareUtf16CodeUnits(left.fqn,right.fqn))};var PackageManifestVersion="v4";var legacyFixedDestinationTargets=new Set(["fixed-email","channel-destination","telegram-chat","whatsapp-destination"]);var uuid2=/^[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}$/iu;var placeholder=/\{(?<name>[^{}]*)\}/gu;var placeholders={remoteId:(remoteId)=>encodeURIComponent(remoteId),remoteIdUuidHex:(remoteId)=>uuid2.test(remoteId)?remoteId.replaceAll("-","").toLowerCase():null};var isPlaceholderName=(name)=>Object.hasOwn(placeholders,name);var resolver=(name)=>isPlaceholderName(name)?placeholders[name]:undefined;var knowledgeRemoteReferenceUrlTemplate=(value,path)=>{if(typeof value!=="string"||!value.startsWith("https://")||/[{}]/u.test(value.replaceAll(placeholder,(match,name)=>resolver(name)===undefined?match:""))){throw new TypeError(`Invalid remote reference URL template at ${path}`)}return value};var FRONTEND_CATALOG_CONTRACT="frontend-catalog/v1";var FRONTEND_CATALOG_EXPORT_NAME="loadFrontendCatalog";var BACKEND_EXECUTION_LANES=["interactive","job"];var requireIdentityPart=(value,label)=>{if(value.trim()===""||value!==value.trim()){throw new TypeError(`Hosted Contribution ${label} must be non-empty and trimmed`)}};function declareHostedContribution(input){const contributionFqn=input.fqn;const contributionExport=input.exportName;const contributionContract=input.contract;requireIdentityPart(contributionFqn,"FQN");requireIdentityPart(contributionExport,"export name");const execution="execution"in input?input.execution:undefined;if(execution!==undefined){if(input.host!=="backend"){throw new TypeError(`Frontend Hosted Contribution '${contributionFqn}' cannot declare an execution lane`)}if(!BACKEND_EXECUTION_LANES.some((lane)=>lane===execution)){throw new TypeError(`Backend Hosted Contribution '${contributionFqn}' execution must be 'interactive' or 'job'`)}}if(input.host!=="backend"){if(contributionContract!==FRONTEND_CATALOG_CONTRACT){throw new TypeError(`Frontend Hosted Contribution '${contributionFqn}' contract must be '${FRONTEND_CATALOG_CONTRACT}'`)}if(contributionExport!==FRONTEND_CATALOG_EXPORT_NAME){throw new TypeError(`Frontend Hosted Contribution '${contributionFqn}' export must be '${FRONTEND_CATALOG_EXPORT_NAME}'`)}}const manifest=input.host==="backend"?{...input.compatibility===undefined?undefined:{compatibility:input.compatibility},...input.contract===undefined?undefined:{contract:input.contract},...input.execution===undefined?undefined:{execution:input.execution},exportName:input.exportName,fqn:input.fqn,host:input.host}:{...input.compatibility===undefined?undefined:{compatibility:input.compatibility},contract:FRONTEND_CATALOG_CONTRACT,exportName:FRONTEND_CATALOG_EXPORT_NAME,fqn:input.fqn,host:input.host};return{load:input.load,manifest}}var toolBindingDeclaration=(entry)=>typeof entry==="string"?{tool:entry}:entry;var duplicateToolBinding=(tools)=>{const seen=new Set;for(const entry of tools){const binding=toolBindingDeclaration(entry);const key=JSON.stringify([binding.tool,binding.name??null]);if(seen.has(key)){return binding}seen.add(key)}return};var agentAudienceViolation=(audience)=>{const applications=audience.applications??[];if(audience.anonymous===true&&applications.length===0){return"anonymous visitors need an application in audience.applications"}const repeated=applications.find((fqn,index)=>applications.indexOf(fqn)!==index);return repeated===undefined?undefined:`audience application '${repeated}' is listed more than once`};var agentModelTiers=["complex","balanced","fast","super_fast"];var notificationDefinition=object({capabilities:object({extensionReadyProviders:strings,recipientTargets:strings,supportsActionLink:boolean,supportsAttachments:boolean,supportsFixedDestinations:optBoolean,supportsHtml:boolean,supportsMarkdown:boolean,supportsMentions:boolean,supportsReadReceipts:boolean,supportsRouteDestinations:boolean,supportsThreads:boolean}),credentialProfileKey:optString,family:literal("email","im","internal"),key:string,provider:string,setup:object({docsUrl:nullable(string),healthCheck:object({available:boolean,label:optString}),instructions:string,liveTest:object({available:boolean,label:optString}),secretFields:strings,setupForm:nullable(form)})});var studioPage=object({fullWidth:optBoolean,icon:optString,kind:literal("predefined"),label:string,orderIndex:number,predefinedPageRef:string,routeSegment:string,slug:string});var studioSection=object({description:optString,icon:optString,label:string,orderIndex:number,pages:array(studioPage),slug:string});var studioApp=object({color:optString,description:optString,icon:optString,isDefaultTemplate:optBoolean,name:string,sections:array(studioSection),slug:string});var datasetScalarType=literal("boolean","string","int64","float64","decimal","date","timestamp","duration","json");var datasetDefinition2=object({fields:array(object({id:string,name:string,nullable:boolean,semantic:optional(string),type:datasetScalarType})),measures:array(object({id:string,name:string,resultType:datasetScalarType})),relationships:array(object({cardinality:literal("one_to_one","one_to_many","many_to_one","many_to_many"),fromFieldId:string,id:string,toFieldId:string})),version:literal(1)});var datasetBlueprint=object({...base,blueprintVersion:positiveSafeInteger,configuration:optional(jsonObject),definition:datasetDefinition2,kind:literal("datasetBlueprint"),templateFqn:identity});var semanticRole=literal("dimension","effective_time","entity_reference","event_time","identity","measure","status");var hint=object({role:semanticRole});var datasetTableTemplate=object({...base,admittedIngestionModes:array(literal("append","replace","upsert")),compatibleProviderFqns:strings,configuration:schema,identity:object({keyRoles:array(semanticRole),uniqueness:literal("append_only","key","none")}),indexHints:array(hint),kind:literal("datasetTableTemplate"),partitionHints:array(hint),physicalCode:literal("evt","fact","gen","snap","stat","ts"),requirements:schema,semanticRoles:array(semanticRole)});var WorkflowEditorWidgets=["checkbox","code","condition_builder","credential_selector","key_value","list","mapping_builder","multi_select","number","resource_selector","schedule_builder","schema_builder","select","text","textarea"];var WorkflowTemplateKinds=["action_node","input_node","output_node","trigger_node"];var WorkflowTriggerLifecycleAdapterIds=Object.freeze({externalApplication:"builtin.core.workflows.lifecycle.external-application",mcpOperation:"builtin.core.workflows.lifecycle.mcp-operation"});var dynamicPort=object({configPath:string,defaultIdPath:optString,idPath:string,requiredPath:optString,schemaPath:optString});var fieldBinding=object({path:pathParts,target:literal("input_binding","parameter")});var nonNegativeInteger=(value,path)=>{const parsed=number(value,path);return Number.isSafeInteger(parsed)&&parsed>=0?parsed:invalid(path)};var optionSource=union(object({kind:literal("static"),options:array(object({label:localized,value:json}))}),object({clearOnDependencyChange:boolean,dependsOn:array(fieldBinding),kind:literal("remote"),operationId:string,searchable:boolean}));var editorField=object({binding:fieldBinding,fieldConfig:optional(jsonObject),fieldFqn:optString,fieldVersion:optString,help:optional(localized),label:optional(localized),optionSource:optional(optionSource),order:optNumber,placeholder:optional(localized),readOnly:optBoolean,required:optBoolean,resolutionPhase:literal("runtime","structural"),sensitive:optBoolean,valueSources:array(literal("expression","fixed","literal","mapping","model","system")),visibleWhen:optional(array(object({binding:fieldBinding,operator:literal("equals","in","is_not_set","is_set","not_equals"),value:optional(json)}))),widget:optional(literal(...WorkflowEditorWidgets))});var templateKind=literal(...WorkflowTemplateKinds);var nodePort=refine(object({allowedTemplateFqns:optStrings,allowedTemplateKinds:optional(array(templateKind)),direction:literal("input","output"),key:string,maxConnections:optional(nullable(nonNegativeInteger)),minConnections:optional(nonNegativeInteger),schemaResolution:optional(object({configPath:pathParts,variants:array(object({schema,schemaInjections:optional(array(object({configPath:pathParts,schemaPath:pathParts}))),when:json}))})),valueSchema:schema}),workflowPortPolicyViolation);var eventSelectorProjection=union(object({required:optBoolean,sourcePath:pathParts,targetPath:pathParts}),object({targetPath:pathParts,value:json}));var eventIngress=object({acquisitionMode:string,callbackPathPath:optional(pathParts),connectionIdPath:optional(pathParts),eventKind:string,listener:object({fqn:string,version:string}),requiredConfigPaths:optional(array(pathParts)),requiredListener:optBoolean,selector:array(eventSelectorProjection)});var triggerActivation=union(object({eventIngress,kind:literal("event")}),union(object({invocationRole:optional(literal("application","user")),kind:literal("manual"),lifecycleAdapterId:optString,triggerRefPath:optional(pathParts)}),object({kind:literal("schedule")})));var parseWorkflowReusableDependency=(value)=>object({inputContractPath:pathParts,modePath:optional(pathParts),targetWorkflowIdPath:pathParts})(value,"/reusableDependency");var nodeContract=object({capabilityComposition:optional(object({capability:string,fragments:strings,selector:object({path:pathParts,target:literal("parameter")})})),configSchema:optional(schema),connectionRequirements:optional(array(object({cardinality:literal("many","one"),connectionTemplateFqns:refine(strings,(fqns)=>fqns.length===0?"connectionTemplateFqns cannot be empty":undefined),key:string,required:boolean,selector:object({path:pathParts,target:literal("parameter")})}))),dynamicPorts:optional(object({input:optional(dynamicPort),output:optional(dynamicPort)})),editor:optional(refine(object({form:optional(object({sections:optional(array(object({fields:optional(array(editorField)),id:optString,order:optNumber,title:optString})))}))}),workflowEditorViolation)),execution:optional(object({itemModes:optional(array(literal("all_items","each_item","single"))),mainOutputPort:optString,resumable:optBoolean,sideEffect:literal("external","none","read","write"),testable:optBoolean})),implementationId:string,inputSchema:optional(schema),instancePolicy:optional(object({maxInstances:optNumber,minInstances:optNumber,onWorkflowCreate:optBoolean})),nodeCollectionFqn:optString,nodeCollectionVersion:optString,outputChannels:optional(array(object({adapterId:string,cardinality:literal("many","one"),deliveryMode:literal("asynchronous","synchronous"),key:string,required:boolean,valueSchema:schema}))),outputSchema:optional(schema),ports:optional(array(nodePort)),reusableDependency:optional(parseWorkflowReusableDependency),triggerActivation:optional(triggerActivation)});var fieldContract=object({availableForInput:optBoolean,availableForOutput:optBoolean,clearOnDependencyChange:optBoolean,optionDependencies:optional(array(object({path:pathParts,target:literal("parameter","part","value")}))),valueSchema:optional(schema)});var graphSchema=object({bindings:optional(array(object({extensions:jsonObject}))),fieldProjections:array(object({source:pathParts,target:pathParts})),schema});var graphBoundary=object({templateFqn:string,templateVersion:string});var graph=object({edges:array(object({extensions:optional(jsonObject),id:string,source:string,target:string})),inputBoundary:graphBoundary,inputContract:graphSchema,metadata:object({description:nullable(string),tags:strings,templateSource:nullable(string)}),nodes:array(object({extensions:optional(jsonObject),id:string,templateFqn:string,templateVersion:string})),outputBoundary:graphBoundary,outputContract:graphSchema,triggers:array(object({config:object({extensions:optional(jsonObject)}),id:string,inputBindings:record(string),invocation:object({mode:literal("attach","detach"),timeoutMs:nullable(number)}),metadata:object({fieldDisplayValues:record(string)}),settings:object({enabled:boolean}),templateFqn:string,templateVersion:string})),version:literal(1)});var uiLayout=object({edges:record(object({extensions:optional(jsonObject)})),nodes:record(object({position:optional(object({x:number,y:number}))})),version:literal(1),viewport:nullable(object({x:number,y:number,zoom:number}))});var bindingSpan=object({end:number,start:number});var bindingSource=object({kind:literal("input","loop_index","loop_item","merge_output","node_output","port_arrival","run","scope","trigger"),mergeId:optional(nullable(string)),nodeId:optional(nullable(string)),portId:optional(nullable(string)),selection:optional(nullable(object({ancestry:literal("nearest_dominating_ancestor"),iteration:literal("aggregate","previous_iteration","same_iteration")})))});var bindingExpression=(value,path)=>{const{kind}=object({kind:string})(value,path);switch(kind){case"array":{return object({items:array(bindingExpression),kind:literal("array")})(value,path)}case"call":{return object({args:array(bindingExpression),kind:literal("call"),name:string})(value,path)}case"interpolation":{return object({kind:literal("interpolation"),parts:array(bindingExpression),span:optional(nullable(bindingSpan))})(value,path)}case"literal":{return object({kind:literal("literal"),value:json})(value,path)}case"object":{return object({fields:record(bindingExpression),kind:literal("object")})(value,path)}case"operator":{return object({args:array(bindingExpression),kind:literal("operator"),op:string})(value,path)}case"ref":{return object({kind:literal("ref"),onUnavailable:object({kind:literal("error","fallback","null"),value:optional(nullable(bindingExpression))}),path:pathParts,source:bindingSource,span:optional(nullable(bindingSpan))})(value,path)}default:{return invalid(`${path}/kind`)}}};var authoredValue=union(object({mode:literal("fixed"),value:json}),object({compiled:optional(nullable(bindingExpression)),languageVersion:literal(1),mode:literal("expression"),source:string}));var nodeExecutionSettings=object({dryRun:optional(object({mode:literal("allow","block_side_effects")})),idempotencyKey:optional(nullable(bindingExpression)),onError:optional(object({mode:literal("continue","fail_run")})),retry:optional(object({backoffMs:optional(nullable(number)),maxAttempts:optional(nullable(number)),mode:literal("disabled","exponential","fixed")})),timeoutMs:optional(nullable(number))});var authoringTemplateRef=object({templateFqn:string,templateVersion:string});var authoringFieldProjection=object({fieldConfig:optional(jsonObject),fieldFqn:string,fieldVersion:string,path:strings});var authoringInputContract=object({fieldProjections:optional(array(authoringFieldProjection)),jsonSchema:jsonObject});var authoringOutputContract=object({bindings:array(object({key:string,kind:literal("artifact","value"),value:bindingExpression})),fieldProjections:optional(array(authoringFieldProjection)),jsonSchema:jsonObject});var inputEndpoint=object({kind:literal("input_node"),portId:string});var actionEndpoint=object({kind:literal("action_node"),nodeId:string,portId:string});var triggerEndpoint=object({kind:literal("trigger_node"),portId:string,triggerId:string});var outputEndpoint=object({kind:literal("output_node"),portId:string});var authoringDefinition=object({edges:array(object({id:string,source:union(union(actionEndpoint,inputEndpoint),triggerEndpoint),target:union(union(actionEndpoint,inputEndpoint),outputEndpoint)})),inputBoundary:authoringTemplateRef,inputContract:authoringInputContract,metadata:jsonObject,nodes:array(object({config:record(authoredValue),extensions:optional(jsonObject),id:string,inputs:record(authoredValue),metadata:jsonObject,settings:nodeExecutionSettings,templateFqn:string,templateVersion:string,uid:optString})),outputBoundary:authoringTemplateRef,outputContract:authoringOutputContract,triggers:array(object({config:jsonObject,id:string,inputBindings:record(object({overridePolicy:literal("caller_may_override","locked"),value:authoredValue})),invocation:object({mode:literal("attach","await_result","detach"),timeoutMs:optional(nullable(number))}),metadata:jsonObject,settings:jsonObject,templateFqn:string,templateVersion:string})),version:literal(1)});var knowledgeSelection=optional(object({exclude:optional(array(identity)),include:optional(array(identity))}));var toolBindings2=refine(array(union(identity,object({approval:optional(union(literal("always","never"),object({rule:identity}))),knowledge:optional(object({domains:knowledgeSelection,entitySchemas:knowledgeSelection,relationSchemas:knowledgeSelection,unrestricted:optBoolean})),name:optional(identity),settings:optional(jsonObject),tool:identity}))),(tools)=>duplicateToolBinding(tools)===undefined?undefined:"duplicate tool binding");var agentAudience2=refine(object({anonymous:optBoolean,applications:optional(array(identity)),members:optional(literal("all","none","selected")),organizationTeams:optional(literal("none","selected"))}),agentAudienceViolation);var withoutRetiredAgentFields=(agent)=>["invokingApplicationFqns","modelPreset"].find((field)=>(field in agent));var primitives={agent:refine(object({...base,activity:optional(object({heartbeat:boolean,schedule:boolean})),audience:optional(agentAudience2),behavioralBoundaries:strings,kind:literal("agent"),lifecycle,maxSteps:optional(positiveSafeInteger),modelTier:optional(literal(...agentModelTiers)),objectives:strings,operatingInstructions:string,output:optional(object({schema})),responsibility:string,skills:array(identity),tools:toolBindings2}),withoutRetiredAgentFields),connection,datasetBlueprint,datasetConnectorInstance,datasetParser:object({...base,extensions:array(identity),format:datasetParserFormat,kind:literal("datasetParser"),mediaTypes:array(identity),parserVersion:datasetParserVersion}),datasetTableTemplate,documentsConnector:object({...base,connectionRefs,kind:literal("documentsConnector"),providerDisplayName:optional(identity),providerFamily:identity}),domain:object({...base,kind:literal("domain"),lifecycle,localMutationPolicy:optional(mutationPolicy),versioningEnabled:nullable(boolean)}),domainTemplate:object({...base,catalogTags,domainFqn:string,domainName:string,entitySchemaFqns:strings,kind:literal("domainTemplate"),relationSchemaFqns:strings}),eventListener:object({...base,capabilities:array(literal("internal","poll","webhook")),eventKind:string,kind:literal("eventListener"),manualWebhookState:optional(object({keyFamily:identity,stateKey:identity})),runtimeState:optional(array(object({keyFamily:string,stateKey:string}))),safeOccurrenceFields:optStrings,safeSelectorFields:optStrings,webhookHandshake:optional(object({kind:literal("echo_query_parameter"),parameter:identity}))}),externalAppGateway:readExternalAppGateway,externalApplication:object({...base,allowedOrigins:strings,applicationType:literal("confidential","public"),audience:string,kind:literal("externalApplication"),lifecycle,postLogoutRedirectUris:strings,redirectUris:strings,scopes:strings,setupInstructions:optString}),externalDatasetProvider:object({...base,capabilities:datasetCapabilities,connectionTemplateFqns:strings,kind:literal("externalDatasetProvider"),sourceCapabilities:optional(array(object({capabilities:datasetCapabilities,datasetOpaqueIdPrefix:string})))}),fieldTransformer:object({...base,kind:literal("fieldTransformer"),sourceFieldType:string,targetFieldType:string}),knowledgeConnector:object({...base,autoActivate:optBoolean,autoInstantiate:optBoolean,bindingScopes:optional(bindingScopes),connectionRefs,contributions:optional(array(object({capabilityFqn:string,connectionSlot:string,connectionTemplateFqn:string,controlFqn:optString,displayName:string,fqn:identity,metadata:optional(jsonObject)}))),defaultOutboundStrategy:optional(outboundStrategy),defaultUpdateMode:optional(updateMode),discoveryDefaults:optional(discoveryDefaults),entityIdentityMode:optional(literal("adapter","item_metadata")),entitySchemaCapabilities:optional(array(entityCapability)),isSingleton:optBoolean,kind:literal("knowledgeConnector"),outboundCapability:optional(literal("declared_and_enablable","none")),recommendedImportSchedules:predefinedSchedules,relationSchemaCapabilities:optional(array(relationCapability)),remoteReference:optional(object({providerKey:identity,urlTemplate:knowledgeRemoteReferenceUrlTemplate})),settings:optional(form),supportedBindingModes:optional(bindingModes)}),knowledgeConnectorInstance,knowledgeConnectorOauth:object({...base,connectorFqn:string,kind:literal("knowledgeConnectorOauth")}),knowledgeEntityAdapter:object({...base,connectorFqn:string,entitySchemaFqn:string,kind:literal("knowledgeEntityAdapter"),normalizesFieldMapValues:optBoolean,normalizesImportedData:optBoolean}),knowledgeEntitySchema:object({...base,...knowledgeSchema,autocompleteConfiguration,defaultSyncDirection:optString,deletionMode:optString,displayDefaults:optional(object({collections:optStrings,details:optStrings})),displayNameExpression:nullable(string),embedEntities:optBoolean,embeddingConfig:nullable(jsonObject),extendsSchemaFqn:optString,kind:literal("knowledgeEntitySchema"),lifecycle,maxVersionsExpirationDays:optional(nullable(number)),persistFullFieldContributions:boolean,relationFields:optional(array(object({cardinality:literal("many","one"),field:string,id:string,nullable:boolean,reference:literal("external_id"),targetEntityId:string,targetSchemaFqn:string}))),syncable:optBoolean,usableAsDocumentScope:boolean,versioned:optBoolean,versioningEnabled:nullable(boolean)}),knowledgePolicy:object({...base,...policyFields,kind:literal("knowledgePolicy"),priority:optNumber}),knowledgeRelationAdapter:object({...base,connectorFqn:string,kind:literal("knowledgeRelationAdapter"),relationSchemaFqn:string}),knowledgeRelationSchema:object({...base,...knowledgeSchema,kind:literal("knowledgeRelationSchema"),lifecycle:optional(lifecycle),sourceSchemaFqn:string,targetSchemaFqn:string}),managedDatasetProvider:object({...base,capabilities:datasetCapabilities,connectionTemplateFqns:strings,kind:literal("managedDatasetProvider")}),notificationChannel:object({...base,credential:optional(form),definition:notificationDefinition,kind:literal("notificationChannel")}),organizationSso:object({...base,connectionTemplateFqn:string,kind:literal("organizationSso"),providerId:string,requiredCredentialFields:strings,secretCredentialFields:optStrings,setupGuide:optional(array(object({locale:string,markdown:string})))}),remoteToolCollection:refine(object({...base,category:optString,defaultVisibility:optional(array(object({effect:literal("allow","deny"),subject:literal("organization")}))),gatewayRef:identity,kind:literal("remoteToolCollection"),operationReferences:strings}),remoteToolCollectionViolation),skill:object({...base,instructions:string,kind:literal("skill"),lifecycle,tools:toolBindings2}),skillTemplate:object({...base,catalogTags,kind:literal("skillTemplate"),lifecycle:optional(lifecycle),name:string}),studioApp:object({...base,definition:studioApp,kind:literal("studioApp")}),studioComponent:object({...base,category:literal("layout","page","primitive","view","widget"),composition:optional(object({extensions:optional(jsonObject),slotSource:literal("props","static"),slots:array(object({extensions:optional(jsonObject),key:string,label:optional(localized)}))})),kind:literal("studioComponent"),propsSchema:schema,sourceRef:string}),tool:object({...base,allowMultipleSkillBindings:optBoolean,autoActivate:optBoolean,autoInstantiate:optBoolean,bindingScopes:optional(bindingScopes),bindingSettings:optional(form),capabilityType:optional(literal("delegate","external","read","write")),category:optString,connectionRefs,effectKind:optional(literal("mutation","read_only")),extraLoaders:optional(array(object({bindingName:string,inheritBindingSettings:optBoolean,toolFqn:string}))),healthCheck:optional(object({capabilities:optStrings,description:string})),input:schema,isSingleton:optBoolean,kind:literal("tool"),output:schema,settings:optional(form),setupInstructions:optional(object({links:strings,markdown:string})),toolCollectionFqns:optStrings,toolGuidance:optional(object({inputRequirementsSummary:optString,useWhen:optString})),usageScopes:optional(array(literal("automation","chat","skill")))}),toolCollection:object({...base,category:optString,defaultVisibility:optional(array(object({effect:literal("allow","deny"),subject:literal("organization")}))),kind:literal("toolCollection"),toolFqns:strings}),toolSettingsOptions:object({...base,catalogCollection:optString,catalogConnectionSlots:optStrings,connectionSlots:optStrings,dependencies:optStrings,fieldKey:string,formTarget:optional(literal("binding","settings")),includeUnavailableSelectedOptions:optBoolean,kind:literal("toolSettingsOptions"),toolFqn:string}),workflow:object({...base,definition:authoringDefinition,kind:literal("workflow"),lifecycle,name:string,slug:string}),workflowField:object({...base,collectionFqn:string,collectionVersion:string,contract:fieldContract,kind:literal("workflowField"),presentation:optional(object({placeholder:optString,widget:optString}))}),workflowFieldCollection:object({...base,contract:object({weight:number}),kind:literal("workflowFieldCollection"),presentation:optional(object({categoryPath:strings,label:localized}))}),workflowNode:object({...base,contract:nodeContract,kind:literal("workflowNode"),nodeKind:literal("action","input","output","trigger"),presentation:optional(object({categoryPath:optStrings,tags:optStrings}))}),workflowNodeCollection:object({...base,contract:object({collection:optional(object({parentFqn:string,parentVersion:string,weight:number}))}),kind:literal("workflowNodeCollection"),presentation:optional(object({categoryPath:strings}))}),workflowTemplate:object({...base,catalogTags,category:string,definition:graph,kind:literal("workflowTemplate"),lifecycle,name:string,requiredSkills:strings,requiredTools:strings,skillSlots:strings,slug:string,uiLayout:nullable(uiLayout)})};var primitive=(v,p)=>{const{kind}=object({kind:string})(v,p);for(const[name,read]of Object.entries(primitives)){if(name===kind){return read(v,p)}}return invalid(`${p}/kind`)};var readHostedContribution=(value,path)=>{const shared=object({compatibility:optional(record(string)),contract:optString,execution:optional(literal("interactive","job")),exportName:hostedIdentity,fqn:hostedIdentity,host:literal("backend","dashboard","studio")})(value,path);if(shared.host==="backend"){return{...shared.compatibility===undefined?undefined:{compatibility:shared.compatibility},...shared.contract===undefined?undefined:{contract:shared.contract},...shared.execution===undefined?undefined:{execution:shared.execution},exportName:shared.exportName,fqn:shared.fqn,host:shared.host}}if(shared.execution!==undefined){throw new TypeError(`Invalid package manifest at ${path}/execution: frontend contributions cannot declare an execution lane`)}if(shared.contract!==FRONTEND_CATALOG_CONTRACT){throw new TypeError(`Invalid package manifest at ${path}/contract: frontend contribution contract must be '${FRONTEND_CATALOG_CONTRACT}'`)}if(shared.exportName!==FRONTEND_CATALOG_EXPORT_NAME){throw new TypeError(`Invalid package manifest at ${path}/exportName: frontend contribution export must be '${FRONTEND_CATALOG_EXPORT_NAME}'`)}return{...shared.compatibility===undefined?undefined:{compatibility:shared.compatibility},contract:FRONTEND_CATALOG_CONTRACT,exportName:FRONTEND_CATALOG_EXPORT_NAME,fqn:shared.fqn,host:shared.host}};var readManifest=object({apiVersion:literal(PackageManifestVersion),author:optString,autoInstallable:optBoolean,bindingScopes:optional(array(literal("organization","tenant"))),category:optString,dependencies:optional(parsePackageDependencyPins),description:optString,documentation:optString,fqn:identity,homepage:optString,hostedContributions:optional(array(readHostedContribution)),icon:optString,installationWizard:optional(object({size:optional(literal("lg","md","xl")),steps:array(object({description:optString,kind:literal("connector_instance","tool_instance"),optional:optBoolean,ref:string,title:optString}))})),name:string,primitives:array(primitive),requiredEnvironmentVariables:optStrings,tags:optStrings,tenantMandatory:optBoolean,tenantStandard:optBoolean,version:string});var retiredPrimitiveKinds=new Map(Object.entries({dataset_blueprint:"datasetBlueprint",dataset_parser:"datasetParser",dataset_table_template:"datasetTableTemplate",documents_connector:"documentsConnector",domain_template:"domainTemplate",event_listener:"eventListener",external_application:"externalApplication",external_dataset_provider:"externalDatasetProvider",field_transformer:"fieldTransformer",knowledge_connector:"knowledgeConnector",knowledge_connector_oauth:"knowledgeConnectorOauth",knowledge_entity_adapter:"knowledgeEntityAdapter",knowledge_entity_schema:"knowledgeEntitySchema",knowledge_policy:"knowledgePolicy",knowledge_relation_adapter:"knowledgeRelationAdapter",knowledge_relation_schema:"knowledgeRelationSchema",managed_dataset_provider:"managedDatasetProvider","notification-channel":"notificationChannel",organization_sso:"organizationSso",skill_template:"skillTemplate",studio_app:"studioApp",studio_component:"studioComponent",tool_collection:"toolCollection",tool_settings_options:"toolSettingsOptions",workflow_field:"workflowField",workflow_field_collection:"workflowFieldCollection",workflow_node:"workflowNode",workflow_node_collection:"workflowNodeCollection",workflow_template:"workflowTemplate"}));var 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","delta_page","prove_root_ancestry","list_drives","list_folders"]},{kind:"eventListener",operations:["canonical_selector","route_keys","broad_route_keys","parse_selector","normalize_internal","normalize_webhook","normalize_webhook_request","poll"]},{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"]},{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:"knowledgeRelationAdapter",operations:["remote_id","to_local","source_ref","target_ref"]},{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:"tool",operations:["execute","health_check"]},{kind:"toolSettingsOptions",operations:["get_options"]},{kind:"workflowField",operations:["canonicalize","validate_local","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,location2,issues){super(`${location2}: ${stage}: ${issues.map((issue)=>issue.message).join("; ")}`);this.stage=stage;this.location=location2;this.issues=issues}}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==="parse_selector"&&method===undefined){return(selector)=>selector}if(typeof method!=="function"){throw new TypeError(`Unsupported package operation '${operation}'`)}return method};var isRecord=(value)=>typeof value==="object"&&value!==null&&!Array.isArray(value);var operationSchema=(manifest,direction,operation)=>{if(manifest.kind==="workflowField"&&(operation==="canonicalize"||operation==="validate_local")&&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 projection2=direction==="input"?manifest.contract.inputSchema:manifest.contract.outputSchema;if(projection2!==undefined){return{location:`workflow_node:${manifest.fqn}.contract.${direction}Schema`,projection:projection2}}}return};var sidecarFor=(component,direction,operation)=>{const{manifest}=component;const boundary=operationSchema(manifest,direction,operation);if(!boundary){return}const{location:location2,projection:projection2}=boundary;const matches=component.schemaSidecars.filter((item)=>item.location===location2);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",location2,[])}const actual=source.direction==="output"&&isCodec(source.source)?source.source.project("output"):source.source.project("input");if(canonicalJson(actual)!==canonicalJson(projection2)){throw new BackendPackageSchemaError("stale_manifest",location2,[])}return source};var schemaProjection=(manifest,location2)=>{const prefix=`:${manifest.fqn}.`;const offset=location2.indexOf(prefix);if(offset===-1){throw new BackendPackageSchemaError("stale_manifest",location2,[])}const keys=location2.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",location2,[])}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((sidecar2)=>sidecar2.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 projection2=sidecar.direction==="output"&&codec?codec.project("output"):sidecar.source.project("input");if(canonicalJson(projection2)!==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(!isRecord(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(!isRecord(input)||!isRecord(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])}return{body,headers:Object.fromEntries(entries)}};var parserArguments=(call,value)=>{if(!isRecord(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)=>isRecord(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(isRecord(source)&&typeof source.webUrl==="string"){return{webUrl:source.webUrl}}throw new TypeError(message)};var documentsFetchContentWire=(result)=>{if(!isRecord(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(!isRecord(value)||!isRecord(value.remote)||value.schemaMeta!==null&&!isRecord(value.schemaMeta)||value.originalRemote!==undefined&&!isRecord(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 invocationArguments=(call,kind,value)=>{const context={...call.context,signal:call.signal};if(kind==="tool"&&call.operation==="health_check"){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(!isRecord(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))}};let args=[value,context,progress];if(kind==="workflowField"){if(call.operation==="parts"){args=[context.config]}else if(call.operation!=="get_options"){args=[value,context.config]}}return args};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 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(!output){return jsonResult(manifest.kind,call.operation,result)}if(!isCodec(output.source)){throw new BackendPackageSchemaError("stale_manifest",output.location,[])}const workflowResult=manifest.kind==="workflowNode"&&isRecord(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 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{assertPackageRuntimeStorePut:assertPackageRuntimeStorePut2,backendInvocationIdentity:backendInvocationIdentity2,BackendPackageSchemaError:BackendPackageSchemaError2,createBackendPackageRuntime:createBackendPackageRuntime2,DatasetParser:DatasetParser2,declareBackendContribution:declareBackendContribution2,defineCapability:defineCapability2,ExternalDatasetProvider:ExternalDatasetProvider2,ManagedDatasetProvider:ManagedDatasetProvider2,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,PackageEventListener:PackageEventListener2,PackageFieldDefinition:PackageFieldDefinition2,PackageFieldTransformer:PackageFieldTransformer2,PackageKnowledgeConnector:PackageKnowledgeConnector2,PackageKnowledgeConnectorOAuth:PackageKnowledgeConnectorOAuth2,PackageKnowledgeEntityAdapter:PackageKnowledgeEntityAdapter2,PackageKnowledgeRelationAdapter:PackageKnowledgeRelationAdapter2,PackageNotificationChannel:PackageNotificationChannel2,PackageOrganizationSso:PackageOrganizationSso2,PackageRuntimeStoreConstraintError:PackageRuntimeStoreConstraintError2,PackageRuntimeStoreMissingError:PackageRuntimeStoreMissingError2,PackageTool:PackageTool2,PackageToolSettingsOptions:PackageToolSettingsOptions2,PackageWorkflowField:PackageWorkflowField2,PackageWorkflowNode:PackageWorkflowNode2,requirePackageRuntimeStore:requirePackageRuntimeStore2}=exports_src;export{requirePackageRuntimeStore2 as requirePackageRuntimeStore,isBackendPackageOperationAllowed2 as isBackendPackageOperationAllowed,defineCapability2 as defineCapability,declareBackendContribution2 as declareBackendContribution,createBackendPackageRuntime2 as createBackendPackageRuntime,backendInvocationIdentity2 as backendInvocationIdentity,assertPackageRuntimeStorePut2 as assertPackageRuntimeStorePut,PackageWorkflowNode2 as PackageWorkflowNode,PackageWorkflowField2 as PackageWorkflowField,PackageToolSettingsOptions2 as PackageToolSettingsOptions,PackageTool2 as PackageTool,PackageRuntimeStoreMissingError2 as PackageRuntimeStoreMissingError,PackageRuntimeStoreConstraintError2 as PackageRuntimeStoreConstraintError,PackageOrganizationSso2 as PackageOrganizationSso,PackageNotificationChannel2 as PackageNotificationChannel,PackageKnowledgeRelationAdapter2 as PackageKnowledgeRelationAdapter,PackageKnowledgeEntityAdapter2 as PackageKnowledgeEntityAdapter,PackageKnowledgeConnectorOAuth2 as PackageKnowledgeConnectorOAuth,PackageKnowledgeConnector2 as PackageKnowledgeConnector,PackageFieldTransformer2 as PackageFieldTransformer,PackageFieldDefinition2 as PackageFieldDefinition,PackageEventListener2 as PackageEventListener,PackageDocumentsConnector2 as PackageDocumentsConnector,PackageConnection2 as PackageConnection,PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES2 as PACKAGE_RUNTIME_STORE_VALUE_MAX_BYTES,PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS2 as PACKAGE_RUNTIME_STORE_TTL_MIN_SECONDS,PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS2 as PACKAGE_RUNTIME_STORE_TTL_MAX_SECONDS,PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS2 as PACKAGE_RUNTIME_STORE_LIST_MAX_KEYS,PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES2 as PACKAGE_RUNTIME_STORE_KEY_MAX_BYTES,ManagedDatasetProvider2 as ManagedDatasetProvider,ExternalDatasetProvider2 as ExternalDatasetProvider,DatasetParser2 as DatasetParser,BackendPackageSchemaError2 as BackendPackageSchemaError};
@@ -0,0 +1,119 @@
1
+ import type { DatasetParserField, JsonObject, JsonValue, PackageSchemaIssue } from "@collective-intelligence/extensions-sdk";
2
+ import type { Awaitable, PackageRuntimeContext } from "../host/context.js";
3
+ declare const operations: readonly [{
4
+ readonly kind: "connection";
5
+ readonly operations: readonly ["test", "discover", "test_and_discover"];
6
+ }, {
7
+ readonly kind: "datasetParser";
8
+ readonly operations: readonly ["analyze", "parse_records"];
9
+ }, {
10
+ readonly kind: "documentsConnector";
11
+ readonly operations: readonly ["pull", "fetch_content", "fetch_source", "delta_page", "prove_root_ancestry", "list_drives", "list_folders"];
12
+ }, {
13
+ readonly kind: "eventListener";
14
+ readonly operations: readonly ["canonical_selector", "route_keys", "broad_route_keys", "parse_selector", "normalize_internal", "normalize_webhook", "normalize_webhook_request", "poll"];
15
+ }, {
16
+ readonly kind: "externalDatasetProvider";
17
+ readonly operations: readonly ["readiness", "list_sources", "discover_definition", "dataset_query", "dataset_inspect"];
18
+ }, {
19
+ readonly kind: "fieldTransformer";
20
+ readonly operations: readonly ["transform", "inverse"];
21
+ }, {
22
+ readonly kind: "knowledgeConnector";
23
+ readonly operations: readonly ["browse", "discover", "pull", "push", "read"];
24
+ }, {
25
+ readonly kind: "knowledgeConnectorOauth";
26
+ readonly operations: readonly ["authorize_url", "exchange_code"];
27
+ }, {
28
+ readonly kind: "knowledgeEntityAdapter";
29
+ readonly operations: readonly ["remote_id", "to_local", "to_remote", "extra_props", "normalize_field_map_value", "normalize_imported_data"];
30
+ }, {
31
+ readonly kind: "knowledgeRelationAdapter";
32
+ readonly operations: readonly ["remote_id", "to_local", "source_ref", "target_ref"];
33
+ }, {
34
+ readonly kind: "managedDatasetProvider";
35
+ readonly operations: readonly ["readiness", "dataset_provision", "dataset_ingest", "dataset_query", "dataset_inspect", "dataset_delete"];
36
+ }, {
37
+ readonly kind: "notificationChannel";
38
+ readonly operations: readonly ["deliver"];
39
+ }, {
40
+ readonly kind: "organizationSso";
41
+ readonly operations: readonly ["authorization_url", "exchange_code"];
42
+ }, {
43
+ readonly kind: "tool";
44
+ readonly operations: readonly ["execute", "health_check"];
45
+ }, {
46
+ readonly kind: "toolSettingsOptions";
47
+ readonly operations: readonly ["get_options"];
48
+ }, {
49
+ readonly kind: "workflowField";
50
+ readonly operations: readonly ["canonicalize", "validate_local", "parts", "get_options"];
51
+ }, {
52
+ readonly kind: "workflowNode";
53
+ readonly operations: readonly ["execute"];
54
+ }];
55
+ export type ExecutableOperation = (typeof operations)[number]["operations"][number];
56
+ export declare const isBackendPackageOperationAllowed: (kind: string, operation: string) => boolean;
57
+ export type BackendPackageOperation = ExecutableOperation | "decode_schema" | "encode_schema";
58
+ export type BackendExtraPropsInput = Readonly<{
59
+ originalRemote?: JsonObject;
60
+ remote: JsonObject;
61
+ schemaMeta: JsonObject | null;
62
+ }>;
63
+ export type BackendNormalizeImportedDataInput = Readonly<{
64
+ local: JsonValue;
65
+ remote: JsonValue;
66
+ }>;
67
+ export type BackendWebhookBodyInput = Readonly<{
68
+ bodyBytes: readonly number[];
69
+ }>;
70
+ export type BackendDatasetParserInput = Readonly<{
71
+ bytes: readonly number[];
72
+ maxRows: number;
73
+ }>;
74
+ export type BackendDatasetParserRecordsInput = BackendDatasetParserInput & Readonly<{
75
+ fields: readonly DatasetParserField[];
76
+ }>;
77
+ export type BackendWebhookRequestInput = BackendWebhookBodyInput & Readonly<{
78
+ headers: Readonly<Record<string, string>>;
79
+ }>;
80
+ export type BackendPackageInvocation = Readonly<{
81
+ packageFqn: string;
82
+ componentFqn: string;
83
+ input: JsonValue;
84
+ context: PackageRuntimeContext;
85
+ signal: AbortSignal;
86
+ onProgress?: (progress: JsonValue) => void;
87
+ }> & (Readonly<{
88
+ operation: Exclude<ExecutableOperation, "normalize_webhook" | "normalize_webhook_request" | "extra_props" | "normalize_imported_data" | "test_and_discover">;
89
+ }> | Readonly<{
90
+ operation: "test_and_discover";
91
+ discover: boolean;
92
+ onTested?: () => Awaitable<void>;
93
+ }> | Readonly<{
94
+ operation: "extra_props";
95
+ input: BackendExtraPropsInput;
96
+ }> | Readonly<{
97
+ operation: "normalize_imported_data";
98
+ input: BackendNormalizeImportedDataInput;
99
+ }> | Readonly<{
100
+ operation: "normalize_webhook";
101
+ input: BackendWebhookBodyInput;
102
+ }> | Readonly<{
103
+ operation: "normalize_webhook_request";
104
+ input: BackendWebhookRequestInput;
105
+ }> | Readonly<{
106
+ operation: "decode_schema" | "encode_schema";
107
+ schemaLocation: string;
108
+ }>);
109
+ export type BackendPackageRuntime = Readonly<{
110
+ invoke: (invocation: BackendPackageInvocation) => Promise<JsonValue>;
111
+ }>;
112
+ export declare class BackendPackageSchemaError extends Error {
113
+ readonly name = "BackendPackageSchemaError";
114
+ readonly stage: "input_decode" | "output_encode" | "stale_manifest";
115
+ readonly location: string;
116
+ readonly issues: readonly PackageSchemaIssue[];
117
+ constructor(stage: "input_decode" | "output_encode" | "stale_manifest", location: string, issues: readonly PackageSchemaIssue[]);
118
+ }
119
+ export {};
@@ -0,0 +1,3 @@
1
+ import type { JsonValue, PackageDefinition } from "@collective-intelligence/extensions-sdk";
2
+ import type { BackendPackageInvocation } from "./contracts.js";
3
+ export declare const invokeBackendPackageComponent: (component: PackageDefinition["components"][number], call: BackendPackageInvocation) => Promise<JsonValue>;
@@ -0,0 +1,3 @@
1
+ import type { PackageDefinition } from "@collective-intelligence/extensions-sdk";
2
+ import type { BackendPackageRuntime } from "./contracts.js";
3
+ export declare const createBackendPackageRuntime: (definitions: readonly PackageDefinition[]) => BackendPackageRuntime;
package/package.json CHANGED
@@ -1,6 +1,54 @@
1
1
  {
2
2
  "name": "@collective-intelligence/extensions-sdk-backend",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.0",
4
+ "description": "Framework-neutral executable contracts for Collective Intelligence extension packages.",
5
+ "type": "module",
6
+ "sideEffects": false,
7
+ "files": [
8
+ "dist",
9
+ "README.md"
10
+ ],
11
+ "main": "./dist/index.js",
12
+ "types": "./dist/index.d.ts",
13
+ "exports": {
14
+ ".": {
15
+ "ci-source": "./src/index.ts",
16
+ "types": "./dist/index.d.ts",
17
+ "import": "./dist/index.js",
18
+ "default": "./dist/index.js"
19
+ }
20
+ },
21
+ "scripts": {
22
+ "build": "bun tools/build.ts",
23
+ "test": "bun test src tools && bun run test:pack",
24
+ "test:pack": "bun run build && bun tools/test-pack.ts",
25
+ "test:unit": "bun test src",
26
+ "format": "oxfmt --write .",
27
+ "format:check": "oxfmt --check .",
28
+ "format:check:staged": "oxfmt --check",
29
+ "lint": "node \"../../../.agents/scripts/managed-lint-runner.mjs\" --scope \"packages/public/extensions-sdk-backend\"",
30
+ "lint:staged": "oxlint --no-error-on-unmatched-pattern",
31
+ "prepack": "bun run build",
32
+ "type-check": "tsc --noEmit"
33
+ },
34
+ "publishConfig": {
35
+ "access": "public"
36
+ },
37
+ "dependencies": {
38
+ "@collective-intelligence/extensions-sdk": "0.1.0"
39
+ },
40
+ "devDependencies": {
41
+ "@effect/eslint-plugin": "latest",
42
+ "@effect/tsgo": "0.48.1",
43
+ "@oxlint/plugins": "1.85.0",
44
+ "@types/bun": "1.3.14",
45
+ "@typescript-eslint/utils": "8.22.0",
46
+ "bun-types": "^1.3.14",
47
+ "eslint": "9.39.5",
48
+ "oxfmt": "0.66.0",
49
+ "oxlint": "1.82.0",
50
+ "oxlint-tsgolint": "7.0.2001",
51
+ "typescript": "^5.9.3",
52
+ "ultracite": "7.10.7"
53
+ }
54
+ }