@collective-intelligence/extensions-sdk 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.
Files changed (64) hide show
  1. package/README.md +1276 -2
  2. package/dist/components/agents.d.ts +155 -0
  3. package/dist/components/authoring-core.d.ts +253 -0
  4. package/dist/components/base.d.ts +25 -0
  5. package/dist/components/catalog.d.ts +21 -0
  6. package/dist/components/connections.d.ts +52 -0
  7. package/dist/components/connector-instances.d.ts +142 -0
  8. package/dist/components/connectors.d.ts +408 -0
  9. package/dist/components/dataset-parser-validation.d.ts +2 -0
  10. package/dist/components/dataset-parser.d.ts +74 -0
  11. package/dist/components/datasets.d.ts +356 -0
  12. package/dist/components/declaration.d.ts +12 -0
  13. package/dist/components/executable-authoring.d.ts +27 -0
  14. package/dist/components/external-app-gateway.d.ts +7 -0
  15. package/dist/components/external-application.d.ts +17 -0
  16. package/dist/components/fields.d.ts +34 -0
  17. package/dist/components/knowledge-remote-reference.d.ts +7 -0
  18. package/dist/components/knowledge.d.ts +188 -0
  19. package/dist/components/lifecycle.d.ts +7 -0
  20. package/dist/components/metadata-authoring.d.ts +66 -0
  21. package/dist/components/notification-channel-capabilities.d.ts +7 -0
  22. package/dist/components/remote-tool-collection.d.ts +3 -0
  23. package/dist/components/studio.d.ts +48 -0
  24. package/dist/components/templates.d.ts +50 -0
  25. package/dist/components/tools.d.ts +138 -0
  26. package/dist/components/workflow-editor.d.ts +28 -0
  27. package/dist/components/workflow-node-authoring.d.ts +4 -0
  28. package/dist/components/workflow-ports.d.ts +26 -0
  29. package/dist/components/workflow-results.d.ts +75 -0
  30. package/dist/components/workflow-rules.d.ts +20 -0
  31. package/dist/components/workflow-schema.d.ts +22 -0
  32. package/dist/components/workflows.d.ts +529 -0
  33. package/dist/foundation/json.d.ts +8 -0
  34. package/dist/foundation/string-order.d.ts +2 -0
  35. package/dist/gateway/declarations.d.ts +69 -0
  36. package/dist/gateway/operation-contract.d.ts +29 -0
  37. package/dist/hosted/contributions.d.ts +52 -0
  38. package/dist/index.d.ts +69 -0
  39. package/dist/index.js +1 -0
  40. package/dist/package/canonical.d.ts +9 -0
  41. package/dist/package/connector-readers.d.ts +171 -0
  42. package/dist/package/definition.d.ts +31 -0
  43. package/dist/package/dependencies.d.ts +10 -0
  44. package/dist/package/instance-readers.d.ts +4 -0
  45. package/dist/package/knowledge-readers.d.ts +137 -0
  46. package/dist/package/manifest.d.ts +42 -0
  47. package/dist/package/parse-manifest.d.ts +3 -0
  48. package/dist/package/policy-readers.d.ts +17 -0
  49. package/dist/package/presentation-readers.d.ts +61 -0
  50. package/dist/package/primitive-readers.d.ts +678 -0
  51. package/dist/package/readers.d.ts +230 -0
  52. package/dist/package/template-readers.d.ts +37 -0
  53. package/dist/package/workflow-readers.d.ts +167 -0
  54. package/dist/release/archive.d.ts +11 -0
  55. package/dist/release/manifest.d.ts +66 -0
  56. package/dist/release/paths.d.ts +5 -0
  57. package/dist/release/stored-manifest.d.ts +13 -0
  58. package/dist/schema/forms.d.ts +117 -0
  59. package/dist/schema/knowledge-record.d.ts +16 -0
  60. package/dist/schema/normalization.d.ts +7 -0
  61. package/dist/schema/profiles.d.ts +45 -0
  62. package/dist/schema/projection.d.ts +59 -0
  63. package/dist/schema/source.d.ts +65 -0
  64. package/package.json +46 -4
@@ -0,0 +1,171 @@
1
+ import type * as C from "../components/connectors.js";
2
+ import type { ReadValue } from "./readers.js";
3
+ export declare const metadata: ReadValue<{
4
+ available: boolean;
5
+ label: string;
6
+ } & import("../index.js").JsonObject>;
7
+ export declare const connection: ReadValue<Readonly<{
8
+ description?: string;
9
+ displayName: string;
10
+ fqn: string;
11
+ icon?: string;
12
+ kind: "connection";
13
+ tags?: readonly string[];
14
+ version: string;
15
+ }> & Readonly<{
16
+ compatibility?: Readonly<{
17
+ auth?: string;
18
+ dialect?: string;
19
+ extensions?: import("../index.js").JsonObject;
20
+ provider?: string;
21
+ }>;
22
+ credential: import("../index.js").PortableFormDefinition;
23
+ creationMode?: "self_service" | "registration_only";
24
+ defaultConnectionName: string;
25
+ discoveryMetadata?: Readonly<{
26
+ available: boolean;
27
+ label: string;
28
+ }>;
29
+ providerFamily: string;
30
+ secretFields?: readonly string[];
31
+ testMetadata?: Readonly<{
32
+ available: boolean;
33
+ label: string;
34
+ }>;
35
+ }> & import("../index.js").JsonObject>;
36
+ export declare const pathParts: ReadValue<readonly (string | number)[]>;
37
+ export declare const bindingModes: ReadValue<readonly ("external" | "managed")[]>;
38
+ export declare const syncModes: ReadValue<readonly ("full" | "delta")[]>;
39
+ export declare const bindingScopes: ReadValue<readonly ("organization" | "tenant")[]>;
40
+ export declare const mutationPolicy: ReadValue<"never" | "always" | "connector_backed">;
41
+ export declare const extraProps: ReadValue<"ignore" | "import" | "inline">;
42
+ export declare const outboundStrategy: ReadValue<"local_first" | "remote_first">;
43
+ export declare const updateMode: ReadValue<"full" | "partial">;
44
+ export declare const localized: ReadValue<Readonly<{
45
+ fallbackLocale: string;
46
+ values: Readonly<Record<string, string>>;
47
+ }> & import("../index.js").JsonObject>;
48
+ export declare const catalogTags: ReadValue<Readonly<Record<string, readonly string[]>> | undefined>;
49
+ export declare const connectionRefs: ReadValue<readonly (Readonly<{
50
+ catalogCollection?: string;
51
+ connectionTemplateFqn: string;
52
+ label: string;
53
+ required?: boolean;
54
+ slot: string;
55
+ visibleWhen?: import("../index.js").VisibilityCondition;
56
+ }> & import("../index.js").JsonObject)[] | undefined>;
57
+ export declare const fieldMap: ReadValue<C.KnowledgeConnectorFieldMapRule>;
58
+ export declare const predefinedExtras: ReadValue<readonly (Readonly<{
59
+ displayName: string | null;
60
+ enabled: boolean;
61
+ id: string;
62
+ includeInEntityEmbedding: boolean;
63
+ kind: "linked_text" | "file_source";
64
+ slotKey: string;
65
+ source: import("../index.js").JsonObject;
66
+ }> & import("../index.js").JsonObject)[] | undefined>;
67
+ export declare const predefinedSchedules: ReadValue<readonly (Readonly<{
68
+ cronExpression: string;
69
+ enabled?: boolean;
70
+ importMode?: "delta" | "full";
71
+ label?: string;
72
+ rationale?: string;
73
+ timezone?: string;
74
+ }> & import("../index.js").JsonObject)[] | undefined>;
75
+ export declare const schemaCapability: {
76
+ extraPropsMode: ReadValue<"ignore" | "import" | "inline" | undefined>;
77
+ fieldMap: ReadValue<readonly C.KnowledgeConnectorFieldMapRule[] | undefined>;
78
+ fqn: ReadValue<string>;
79
+ outboundStrategy: ReadValue<"local_first" | "remote_first" | undefined>;
80
+ predefinedBindingExtras: ReadValue<readonly (Readonly<{
81
+ displayName: string | null;
82
+ enabled: boolean;
83
+ id: string;
84
+ includeInEntityEmbedding: boolean;
85
+ kind: "linked_text" | "file_source";
86
+ slotKey: string;
87
+ source: import("../index.js").JsonObject;
88
+ }> & import("../index.js").JsonObject)[] | undefined>;
89
+ predefinedBindingKey: ReadValue<string | undefined>;
90
+ predefinedBindingMode: ReadValue<"external" | "managed" | undefined>;
91
+ predefinedBindingRemoteCollectionId: ReadValue<string | undefined>;
92
+ predefinedBindingRemoteCollectionName: ReadValue<string | undefined>;
93
+ predefinedSchedules: ReadValue<readonly (Readonly<{
94
+ cronExpression: string;
95
+ enabled?: boolean;
96
+ importMode?: "delta" | "full";
97
+ label?: string;
98
+ rationale?: string;
99
+ timezone?: string;
100
+ }> & import("../index.js").JsonObject)[] | undefined>;
101
+ supportedSyncModes: ReadValue<readonly ("full" | "delta")[] | undefined>;
102
+ supportsInbound: ReadValue<boolean | undefined>;
103
+ supportsOutbound: ReadValue<boolean | undefined>;
104
+ syncIntervalSeconds: ReadValue<number | null | undefined>;
105
+ updateMode: ReadValue<"full" | "partial" | undefined>;
106
+ };
107
+ export declare const entityCapability: ReadValue<Readonly<{
108
+ extraPropsMode?: "ignore" | "import" | "inline";
109
+ fieldMap?: readonly C.KnowledgeConnectorFieldMapRule[];
110
+ fqn: string;
111
+ outboundStrategy?: "local_first" | "remote_first";
112
+ predefinedBindingExtras?: readonly C.KnowledgeConnectorBindingExtraConfig[];
113
+ predefinedBindingKey?: string;
114
+ predefinedBindingMode?: "external" | "managed";
115
+ predefinedBindingParentKey?: string;
116
+ predefinedBindingRemoteCollectionId?: string;
117
+ predefinedBindingRemoteCollectionName?: string;
118
+ predefinedSchedules?: readonly C.KnowledgePredefinedSchedule[];
119
+ supportedBindingModes?: readonly ("external" | "managed")[];
120
+ supportedSyncModes?: readonly ("delta" | "full")[];
121
+ supportsInbound?: boolean;
122
+ supportsOutbound?: boolean;
123
+ syncIntervalSeconds?: number | null;
124
+ updateMode?: "full" | "partial";
125
+ }> & import("../index.js").JsonObject>;
126
+ export declare const relationCapability: ReadValue<Readonly<{
127
+ extraPropsMode?: "ignore" | "import" | "inline";
128
+ fieldMap?: readonly C.KnowledgeConnectorFieldMapRule[];
129
+ fqn: string;
130
+ outboundStrategy?: "local_first" | "remote_first";
131
+ predefinedBindingExtras?: readonly C.KnowledgeConnectorBindingExtraConfig[];
132
+ predefinedBindingKey?: string;
133
+ predefinedBindingMode?: "external" | "managed";
134
+ predefinedBindingParentEntityKey?: string;
135
+ predefinedBindingRelationImportMode?: "child_binding" | "relation_only";
136
+ predefinedBindingRemoteCollectionId?: string;
137
+ predefinedBindingRemoteCollectionName?: string;
138
+ predefinedBindingSourceEntityKey?: string;
139
+ predefinedBindingTargetEntityKey?: string;
140
+ predefinedSchedules?: readonly C.KnowledgePredefinedSchedule[];
141
+ supportedSyncModes?: readonly ("delta" | "full")[];
142
+ supportsInbound?: boolean;
143
+ supportsOutbound?: boolean;
144
+ syncIntervalSeconds?: number | null;
145
+ updateMode?: "full" | "partial";
146
+ }> & import("../index.js").JsonObject>;
147
+ export declare const discoveryDefaults: ReadValue<Readonly<{
148
+ extraPropsMode: "ignore" | "import" | "inline";
149
+ outboundStrategy: "local_first" | "remote_first";
150
+ supportedBindingModes: readonly ("external" | "managed")[];
151
+ supportedSyncModes: readonly ("delta" | "full")[];
152
+ supportsInbound: boolean;
153
+ supportsOutbound: boolean;
154
+ syncIntervalSeconds: number | null;
155
+ updateMode: "full" | "partial";
156
+ }> & import("../index.js").JsonObject>;
157
+ export declare const datasetCapabilities: ReadValue<Readonly<{
158
+ intents: readonly import("../index.js").DatasetQueryIntent[];
159
+ predicates: readonly import("../index.js").DatasetPredicateOperator[];
160
+ aggregates: readonly import("../index.js").DatasetAggregateOperation[];
161
+ grouping: boolean;
162
+ ordering: boolean;
163
+ pagination: boolean;
164
+ definitionRefresh: boolean;
165
+ limits: Readonly<{
166
+ maxRows: number;
167
+ maxBytes: number;
168
+ timeoutMs: number;
169
+ maxPageRows: number;
170
+ }>;
171
+ }> & import("../index.js").JsonObject>;
@@ -0,0 +1,31 @@
1
+ import type { ClassDeclaredComponent, ConnectionImplementation, DeclaredComponent, DocumentsConnectorImplementation, ErasedWorkflowFieldImplementation, EventListenerImplementation, FieldTransformerImplementation, KnowledgeConnectorImplementation, KnowledgeConnectorOAuthImplementation, KnowledgeEntityAdapterImplementation, KnowledgeRelationAdapterImplementation, MetadataComponentManifest, NotificationChannelImplementation, PackageSchemaRuntimeSidecar, ToolImplementationConstructor, ToolSettingsOptionsImplementation, WorkflowNodeImplementationConstructor } from "../components/authoring-core.js";
2
+ import type { ConnectionDeclaration, DocumentsConnectorDeclaration, DatasetParserDeclaration, ExternalDatasetProviderDeclaration, ManagedDatasetProviderDeclaration, EventListenerDeclaration, KnowledgeConnectorDeclaration, KnowledgeConnectorOAuthDeclaration, KnowledgeEntityAdapterDeclaration, KnowledgeRelationAdapterDeclaration, OrganizationSsoDeclaration } from "../components/connectors.js";
3
+ import type { DatasetParserImplementation } from "../components/dataset-parser.js";
4
+ import type { ExternalDatasetProviderImplementation, ManagedDatasetProviderImplementation } from "../components/datasets.js";
5
+ import type { OrganizationSsoImplementation } from "../components/executable-authoring.js";
6
+ import type { FieldTransformerDeclaration, NotificationChannelDeclaration, ToolDeclaration, ToolSettingsOptionsDeclaration } from "../components/tools.js";
7
+ import type { WorkflowFieldDeclaration, WorkflowNodeDeclaration } from "../components/workflows.js";
8
+ import type { HostedContributionDeclaration } from "../hosted/contributions.js";
9
+ import type { PackageManifest } from "./manifest.js";
10
+ export type DeclaredPackageComponent = ClassDeclaredComponent<DatasetParserDeclaration, new () => DatasetParserImplementation> | ClassDeclaredComponent<ExternalDatasetProviderDeclaration, new () => ExternalDatasetProviderImplementation> | ClassDeclaredComponent<ManagedDatasetProviderDeclaration, new () => ManagedDatasetProviderImplementation> | ClassDeclaredComponent<OrganizationSsoDeclaration, new () => OrganizationSsoImplementation> | ClassDeclaredComponent<ToolDeclaration, ToolImplementationConstructor> | ClassDeclaredComponent<ConnectionDeclaration, new () => ConnectionImplementation<unknown>> | ClassDeclaredComponent<DocumentsConnectorDeclaration, new () => DocumentsConnectorImplementation> | ClassDeclaredComponent<KnowledgeConnectorDeclaration, new () => KnowledgeConnectorImplementation> | ClassDeclaredComponent<KnowledgeConnectorOAuthDeclaration, new () => KnowledgeConnectorOAuthImplementation> | ClassDeclaredComponent<WorkflowNodeDeclaration, WorkflowNodeImplementationConstructor> | ClassDeclaredComponent<WorkflowFieldDeclaration, new () => ErasedWorkflowFieldImplementation> | ClassDeclaredComponent<EventListenerDeclaration, new () => EventListenerImplementation> | ClassDeclaredComponent<KnowledgeEntityAdapterDeclaration, new () => KnowledgeEntityAdapterImplementation> | ClassDeclaredComponent<KnowledgeRelationAdapterDeclaration, new () => KnowledgeRelationAdapterImplementation> | ClassDeclaredComponent<FieldTransformerDeclaration, new () => FieldTransformerImplementation> | ClassDeclaredComponent<NotificationChannelDeclaration, new () => NotificationChannelImplementation> | ClassDeclaredComponent<ToolSettingsOptionsDeclaration, new () => ToolSettingsOptionsImplementation> | DeclaredComponent<MetadataComponentManifest>;
11
+ /** Backwards-compatible name for the discriminated package component union. */
12
+ export type PackageComponent = DeclaredPackageComponent;
13
+ export type DeclaredPackageManifest = PackageManifest;
14
+ /** Portable package declaration with retained, host-invokable component runtimes. */
15
+ export type PackageDefinition = Readonly<{
16
+ components: readonly DeclaredPackageComponent[];
17
+ hostedContributions?: readonly HostedContributionDeclaration[];
18
+ manifest: DeclaredPackageManifest;
19
+ schemaSidecars: readonly PackageSchemaRuntimeSidecar[];
20
+ }>;
21
+ /** Result of `declarePackage`; every optional authoring collection is explicit. */
22
+ export type NormalizedPackageDefinition = PackageDefinition & Readonly<{
23
+ hostedContributions: readonly HostedContributionDeclaration[];
24
+ }>;
25
+ export type PackageManifestInput = Omit<DeclaredPackageManifest, "apiVersion" | "hostedContributions" | "primitives">;
26
+ /** Assembles a portable package manifest while retaining component runtimes locally. */
27
+ export declare const declarePackage: (input: Readonly<{
28
+ components: readonly DeclaredPackageComponent[];
29
+ hostedContributions?: readonly HostedContributionDeclaration[];
30
+ manifest: PackageManifestInput;
31
+ }>) => NormalizedPackageDefinition;
@@ -0,0 +1,10 @@
1
+ import type { PackageDefinition } from "./definition.js";
2
+ import type { PackageDependencyPin } from "./manifest.js";
3
+ /** Validates exact immutable release references and orders them by package identity. */
4
+ export declare const parsePackageDependencyPins: (value: unknown) => readonly PackageDependencyPin[];
5
+ /**
6
+ * Validates package-to-package references and returns a dependency-first
7
+ * order. Discovery uses this once, rather than repeatedly walking imports or
8
+ * querying installations during startup.
9
+ */
10
+ export declare const resolvePackageDependencyOrder: (definitions: readonly PackageDefinition[]) => readonly PackageDefinition[];
@@ -0,0 +1,4 @@
1
+ import type * as I from "../components/connector-instances.js";
2
+ import type { ReadValue } from "./readers.js";
3
+ export declare const knowledgeConnectorInstance: ReadValue<I.KnowledgeConnectorInstanceDeclaration>;
4
+ export declare const datasetConnectorInstance: ReadValue<I.DatasetConnectorInstanceDeclaration>;
@@ -0,0 +1,137 @@
1
+ import type * as K from "../components/knowledge.js";
2
+ export declare const fieldSemantics: import("./readers.js").ReadValue<Readonly<{
3
+ defaultSearch?: boolean;
4
+ embedded?: boolean;
5
+ faceted?: boolean;
6
+ indexContent?: boolean;
7
+ indexOverview?: boolean;
8
+ indexed?: boolean;
9
+ managedProjectionSource?: "organization_team" | "organization_user";
10
+ queryGuidance?: string;
11
+ unique?: boolean;
12
+ }> & import("../index.js").JsonObject>;
13
+ export declare const managedProjection: import("./readers.js").ReadValue<Readonly<{
14
+ connectorPolicy: "allow" | "deny_schema";
15
+ genericMutationPolicy: "deny_managed_fields" | "deny_schema";
16
+ kind: "directory_person" | "directory_person_in_team" | "directory_team" | "directory_team_parent";
17
+ source: "organization_team" | "organization_team_hierarchy" | "organization_team_membership" | "organization_user";
18
+ }> & import("../index.js").JsonObject>;
19
+ export declare const fieldLocalization: import("./readers.js").ReadValue<Readonly<{
20
+ description?: K.LocalizedFieldText;
21
+ help?: K.LocalizedFieldText;
22
+ label?: K.LocalizedFieldText;
23
+ placeholder?: K.LocalizedFieldText;
24
+ }> & import("../index.js").JsonObject>;
25
+ export declare const fieldPresentation: import("./readers.js").ReadValue<Readonly<{
26
+ copyable?: boolean;
27
+ editor?: string;
28
+ editorOptions?: Readonly<{
29
+ accepts?: readonly string[];
30
+ allowCustomValues?: boolean;
31
+ autocomplete?: string;
32
+ clearable?: boolean;
33
+ falseLabel?: string;
34
+ multiple?: boolean;
35
+ options?: readonly Readonly<{
36
+ label: string;
37
+ value: string;
38
+ }>[];
39
+ rows?: number;
40
+ searchable?: boolean;
41
+ showButtons?: boolean;
42
+ spellcheck?: boolean;
43
+ step?: number;
44
+ trueLabel?: string;
45
+ }>;
46
+ emptyLabel?: string;
47
+ falseLabel?: string;
48
+ hidden?: boolean;
49
+ layout?: Readonly<{
50
+ column?: number;
51
+ labelPlacement?: "left" | "top";
52
+ order?: number;
53
+ row?: number;
54
+ width?: number | "full";
55
+ }>;
56
+ maxLines?: number;
57
+ readOnly?: boolean;
58
+ renderer?: string;
59
+ trueLabel?: string;
60
+ }> & import("../index.js").JsonObject>;
61
+ export declare const lifecycle: import("./readers.js").ReadValue<Readonly<{
62
+ deployMode: import("../index.js").LifecycleDeployMode;
63
+ readonly: boolean;
64
+ }> & import("../index.js").JsonObject>;
65
+ export declare const autocompleteConfiguration: import("./readers.js").ReadValue<Readonly<{
66
+ autocompleteFields: readonly K.KnowledgeAutocompleteFieldReference[];
67
+ defaultAutocompleteFields: readonly K.KnowledgeAutocompleteFieldReference[];
68
+ }> & import("../index.js").JsonObject>;
69
+ export declare const knowledgeSchema: {
70
+ catalogTags: import("./readers.js").ReadValue<Readonly<Record<string, readonly string[]>> | undefined>;
71
+ domainFqn: import("./readers.js").ReadValue<string>;
72
+ fieldLocalization: import("./readers.js").ReadValue<Readonly<Record<string, Readonly<{
73
+ description?: K.LocalizedFieldText;
74
+ help?: K.LocalizedFieldText;
75
+ label?: K.LocalizedFieldText;
76
+ placeholder?: K.LocalizedFieldText;
77
+ }> & import("../index.js").JsonObject>> | undefined>;
78
+ fieldPresentation: import("./readers.js").ReadValue<Readonly<Record<string, Readonly<{
79
+ copyable?: boolean;
80
+ editor?: string;
81
+ editorOptions?: Readonly<{
82
+ accepts?: readonly string[];
83
+ allowCustomValues?: boolean;
84
+ autocomplete?: string;
85
+ clearable?: boolean;
86
+ falseLabel?: string;
87
+ multiple?: boolean;
88
+ options?: readonly Readonly<{
89
+ label: string;
90
+ value: string;
91
+ }>[];
92
+ rows?: number;
93
+ searchable?: boolean;
94
+ showButtons?: boolean;
95
+ spellcheck?: boolean;
96
+ step?: number;
97
+ trueLabel?: string;
98
+ }>;
99
+ emptyLabel?: string;
100
+ falseLabel?: string;
101
+ hidden?: boolean;
102
+ layout?: Readonly<{
103
+ column?: number;
104
+ labelPlacement?: "left" | "top";
105
+ order?: number;
106
+ row?: number;
107
+ width?: number | "full";
108
+ }>;
109
+ maxLines?: number;
110
+ readOnly?: boolean;
111
+ renderer?: string;
112
+ trueLabel?: string;
113
+ }> & import("../index.js").JsonObject>> | undefined>;
114
+ fieldSemantics: import("./readers.js").ReadValue<Readonly<Record<string, Readonly<{
115
+ defaultSearch?: boolean;
116
+ embedded?: boolean;
117
+ faceted?: boolean;
118
+ indexContent?: boolean;
119
+ indexOverview?: boolean;
120
+ indexed?: boolean;
121
+ managedProjectionSource?: "organization_team" | "organization_user";
122
+ queryGuidance?: string;
123
+ unique?: boolean;
124
+ }> & import("../index.js").JsonObject>> | undefined>;
125
+ localMutationPolicy: import("./readers.js").ReadValue<"never" | "always" | "connector_backed" | undefined>;
126
+ managedProjection: import("./readers.js").ReadValue<(Readonly<{
127
+ connectorPolicy: "allow" | "deny_schema";
128
+ genericMutationPolicy: "deny_managed_fields" | "deny_schema";
129
+ kind: "directory_person" | "directory_person_in_team" | "directory_team" | "directory_team_parent";
130
+ source: "organization_team" | "organization_team_hierarchy" | "organization_team_membership" | "organization_user";
131
+ }> & import("../index.js").JsonObject) | undefined>;
132
+ schema: import("./readers.js").ReadValue<Readonly<{
133
+ dialect: typeof import("../index.js").Draft202012Dialect;
134
+ document: import("../index.js").JsonSchemaDocument;
135
+ fidelity: import("../index.js").ProjectionFidelity;
136
+ }> & import("../index.js").JsonObject>;
137
+ };
@@ -0,0 +1,42 @@
1
+ import type { PackagePrimitiveDeclaration } from "../components/declaration.js";
2
+ import type { HostedContributionManifest } from "../hosted/contributions.js";
3
+ export declare const PackageManifestVersion: "v4";
4
+ /** Declarative post-install flow; artifact refs are package-owned FQNs. */
5
+ export type InstallationWizard = Readonly<{
6
+ size?: "lg" | "md" | "xl";
7
+ steps: readonly InstallationWizardStep[];
8
+ }>;
9
+ export type InstallationWizardStep = Readonly<{
10
+ description?: string;
11
+ kind: "connector_instance" | "tool_instance";
12
+ optional?: boolean;
13
+ ref: string;
14
+ title?: string;
15
+ }>;
16
+ export type PackageDependencyPin = Readonly<{
17
+ fqn: string;
18
+ releaseId: string;
19
+ releaseDigest: string;
20
+ }>;
21
+ export type PackageManifest = Readonly<{
22
+ apiVersion: typeof PackageManifestVersion;
23
+ author?: string;
24
+ autoInstallable?: boolean;
25
+ bindingScopes?: readonly ("organization" | "tenant")[];
26
+ category?: string;
27
+ dependencies?: readonly PackageDependencyPin[];
28
+ description?: string;
29
+ documentation?: string;
30
+ fqn: string;
31
+ homepage?: string;
32
+ hostedContributions?: readonly HostedContributionManifest[];
33
+ icon?: string;
34
+ installationWizard?: InstallationWizard;
35
+ name: string;
36
+ primitives: readonly PackagePrimitiveDeclaration[];
37
+ requiredEnvironmentVariables?: readonly string[];
38
+ tags?: readonly string[];
39
+ tenantMandatory?: boolean;
40
+ tenantStandard?: boolean;
41
+ version: string;
42
+ }>;
@@ -0,0 +1,3 @@
1
+ import type { PackageManifest } from "./manifest.js";
2
+ /** Decodes an untrusted JSON-compatible portable manifest; never loads runtime sidecars. */
3
+ export declare const parsePackageManifest: (value: unknown) => PackageManifest;
@@ -0,0 +1,17 @@
1
+ import type { KnowledgePolicyPredicate } from "../components/knowledge.js";
2
+ import type { ReadValue } from "./readers.js";
3
+ export declare const policyPredicate: ReadValue<KnowledgePolicyPredicate>;
4
+ export declare const policyBody: ReadValue<Readonly<{
5
+ subjectMatch: KnowledgePolicyPredicate;
6
+ rule?: KnowledgePolicyPredicate;
7
+ }> & import("../index.js").JsonObject>;
8
+ export declare const policyFields: {
9
+ effect: ReadValue<"allow" | "deny">;
10
+ policyBody: ReadValue<Readonly<{
11
+ subjectMatch: KnowledgePolicyPredicate;
12
+ rule?: KnowledgePolicyPredicate;
13
+ }> & import("../index.js").JsonObject>;
14
+ policyType: ReadValue<"filter" | "gate">;
15
+ targetFqn: ReadValue<string>;
16
+ targetKind: ReadValue<"entity_domain" | "entity_schema" | "relation_domain" | "relation_schema">;
17
+ };
@@ -0,0 +1,61 @@
1
+ import type * as S from "../components/studio.js";
2
+ export declare const notificationDefinition: import("./readers.js").ReadValue<Readonly<{
3
+ capabilities: Readonly<{
4
+ extensionReadyProviders: readonly string[];
5
+ recipientTargets: readonly string[];
6
+ supportsActionLink: boolean;
7
+ supportsAttachments: boolean;
8
+ supportsFixedDestinations?: boolean;
9
+ supportsHtml: boolean;
10
+ supportsMarkdown: boolean;
11
+ supportsMentions: boolean;
12
+ supportsReadReceipts: boolean;
13
+ supportsRouteDestinations: boolean;
14
+ supportsThreads: boolean;
15
+ }>;
16
+ credentialProfileKey?: string;
17
+ family: "email" | "im" | "internal";
18
+ key: string;
19
+ provider: string;
20
+ setup: Readonly<{
21
+ docsUrl: string | null;
22
+ healthCheck: Readonly<{
23
+ available: boolean;
24
+ label?: string;
25
+ }>;
26
+ instructions: string;
27
+ liveTest: Readonly<{
28
+ available: boolean;
29
+ label?: string;
30
+ }>;
31
+ secretFields: readonly string[];
32
+ setupForm: import("../index.js").PortableFormDefinition | null;
33
+ }>;
34
+ }> & import("../index.js").JsonObject>;
35
+ export declare const studioPage: import("./readers.js").ReadValue<Readonly<{
36
+ fullWidth?: boolean;
37
+ icon?: string;
38
+ kind: "predefined";
39
+ label: string;
40
+ orderIndex: number;
41
+ predefinedPageRef: string;
42
+ routeSegment: string;
43
+ slug: string;
44
+ }> & import("../index.js").JsonObject>;
45
+ export declare const studioSection: import("./readers.js").ReadValue<Readonly<{
46
+ description?: string;
47
+ icon?: string;
48
+ label: string;
49
+ orderIndex: number;
50
+ pages: readonly S.StudioAppPageDefinition[];
51
+ slug: string;
52
+ }> & import("../index.js").JsonObject>;
53
+ export declare const studioApp: import("./readers.js").ReadValue<Readonly<{
54
+ color?: string;
55
+ description?: string;
56
+ icon?: string;
57
+ isDefaultTemplate?: boolean;
58
+ name: string;
59
+ sections: readonly S.StudioAppSectionDefinition[];
60
+ slug: string;
61
+ }> & import("../index.js").JsonObject>;