@contractspec/lib.contracts 1.46.2 → 1.47.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 (103) hide show
  1. package/dist/app-config/app-config.capability.d.ts +7 -0
  2. package/dist/app-config/app-config.capability.js +23 -0
  3. package/dist/app-config/app-config.feature.d.ts +1 -2
  4. package/dist/app-config/app-config.feature.js +9 -2
  5. package/dist/app-config/contracts.d.ts +50 -50
  6. package/dist/app-config/events.d.ts +27 -27
  7. package/dist/app-config/index.d.ts +4 -3
  8. package/dist/app-config/index.js +3 -2
  9. package/dist/app-config/lifecycle-contracts.d.ts +55 -55
  10. package/dist/app-config/runtime.d.ts +6 -6
  11. package/dist/app-config/spec.d.ts +9 -5
  12. package/dist/app-config/spec.js +5 -1
  13. package/dist/contract-registry/schemas.d.ts +2 -2
  14. package/dist/data-views/runtime.d.ts +5 -1
  15. package/dist/data-views/runtime.js +34 -7
  16. package/dist/data-views/spec.d.ts +1 -1
  17. package/dist/docs/index.js +2 -1
  18. package/dist/docs/tech/cli.docblock.d.ts +6 -0
  19. package/dist/docs/tech/cli.docblock.js +138 -0
  20. package/dist/docs/tech/contracts/vertical-pocket-family-office.docblock.js +106 -1
  21. package/dist/docs/tech/studio/project-access-teams.docblock.js +3 -1
  22. package/dist/examples/index.d.ts +9 -1
  23. package/dist/examples/index.js +8 -1
  24. package/dist/examples/registry.d.ts +3 -25
  25. package/dist/examples/registry.js +4 -60
  26. package/dist/examples/schema.d.ts +17 -17
  27. package/dist/examples/types.d.ts +1 -1
  28. package/dist/features/types.d.ts +1 -1
  29. package/dist/index.d.ts +27 -26
  30. package/dist/index.js +6 -6
  31. package/dist/install.d.ts +1 -1
  32. package/dist/integrations/index.d.ts +2 -2
  33. package/dist/integrations/index.js +2 -2
  34. package/dist/integrations/integrations.capability.d.ts +7 -0
  35. package/dist/integrations/integrations.capability.js +17 -0
  36. package/dist/integrations/integrations.feature.d.ts +1 -2
  37. package/dist/integrations/integrations.feature.js +9 -2
  38. package/dist/integrations/openbanking/contracts/accounts.d.ts +66 -66
  39. package/dist/integrations/openbanking/contracts/balances.d.ts +34 -34
  40. package/dist/integrations/openbanking/models.d.ts +55 -55
  41. package/dist/integrations/openbanking/openbanking.capability.d.ts +7 -0
  42. package/dist/integrations/openbanking/openbanking.capability.js +21 -0
  43. package/dist/integrations/openbanking/openbanking.feature.d.ts +1 -2
  44. package/dist/integrations/openbanking/openbanking.feature.js +9 -2
  45. package/dist/integrations/operations.d.ts +102 -102
  46. package/dist/integrations/providers/elevenlabs.d.ts +1 -0
  47. package/dist/integrations/providers/elevenlabs.js +3 -2
  48. package/dist/integrations/providers/gcs-storage.d.ts +1 -0
  49. package/dist/integrations/providers/gcs-storage.js +3 -2
  50. package/dist/integrations/providers/gmail.d.ts +1 -0
  51. package/dist/integrations/providers/gmail.js +3 -2
  52. package/dist/integrations/providers/google-calendar.d.ts +1 -0
  53. package/dist/integrations/providers/google-calendar.js +3 -2
  54. package/dist/integrations/providers/impls/provider-factory.js +2 -1
  55. package/dist/integrations/providers/mistral.d.ts +1 -0
  56. package/dist/integrations/providers/mistral.js +3 -2
  57. package/dist/integrations/providers/postmark.d.ts +1 -0
  58. package/dist/integrations/providers/postmark.js +3 -2
  59. package/dist/integrations/providers/powens.d.ts +1 -0
  60. package/dist/integrations/providers/powens.js +3 -2
  61. package/dist/integrations/providers/qdrant.d.ts +1 -0
  62. package/dist/integrations/providers/qdrant.js +3 -2
  63. package/dist/integrations/providers/stripe.d.ts +1 -0
  64. package/dist/integrations/providers/stripe.js +3 -2
  65. package/dist/integrations/providers/twilio-sms.d.ts +1 -0
  66. package/dist/integrations/providers/twilio-sms.js +3 -2
  67. package/dist/integrations/spec.d.ts +5 -1
  68. package/dist/integrations/spec.js +5 -1
  69. package/dist/knowledge/knowledge.capability.d.ts +7 -0
  70. package/dist/knowledge/knowledge.capability.js +21 -0
  71. package/dist/knowledge/knowledge.feature.d.ts +1 -2
  72. package/dist/knowledge/knowledge.feature.js +9 -2
  73. package/dist/knowledge/operations.d.ts +66 -66
  74. package/dist/llm/exporters.d.ts +1 -1
  75. package/dist/llm/types.d.ts +1 -1
  76. package/dist/onboarding-base.d.ts +29 -29
  77. package/dist/operations/operation.d.ts +1 -1
  78. package/dist/server/mcp/createMcpServer.js +1 -1
  79. package/dist/server/mcp/mcpTypes.d.ts +1 -1
  80. package/dist/server/mcp/registerPresentations.js +1 -1
  81. package/dist/server/mcp/registerResources.js +2 -2
  82. package/dist/tests/index.d.ts +2 -2
  83. package/dist/tests/index.js +2 -2
  84. package/dist/tests/spec.d.ts +2 -1
  85. package/dist/tests/spec.js +4 -1
  86. package/dist/types.d.ts +2 -2
  87. package/dist/workflow/index.d.ts +8 -1
  88. package/dist/workflow/index.js +8 -1
  89. package/dist/workflow/runner.d.ts +2 -2
  90. package/dist/workflow/spec.d.ts +1 -1
  91. package/dist/workflow/validation.d.ts +1 -1
  92. package/dist/workspace-config/contractsrc-schema.d.ts +45 -974
  93. package/dist/workspace-config/contractsrc-schema.js +89 -55
  94. package/dist/workspace-config/contractsrc-types.d.ts +346 -0
  95. package/dist/workspace-config/contractsrc-types.js +0 -0
  96. package/dist/workspace-config/index.d.ts +3 -2
  97. package/package.json +27 -25
  98. package/dist/docs/tech/contracts/create-subscription.docblock.d.ts +0 -6
  99. package/dist/docs/tech/contracts/create-subscription.docblock.js +0 -21
  100. package/dist/docs/tech/contracts/graphql-typed-outputs.docblock.d.ts +0 -6
  101. package/dist/docs/tech/contracts/graphql-typed-outputs.docblock.js +0 -21
  102. package/dist/docs/tech/templates/runtime.docblock.d.ts +0 -6
  103. package/dist/docs/tech/templates/runtime.docblock.js +0 -21
@@ -13,7 +13,112 @@ const tech_contracts_vertical_pocket_family_office_DocBlocks = [{
13
13
  "contracts",
14
14
  "vertical-pocket-family-office"
15
15
  ],
16
- body: "# Pocket Family Office Vertical\n\nPocket Family Office is a ContractSpec reference vertical that\ndemonstrates finance automation atop the integration and knowledge\nlayers. It is optimised for the hackathon stack (Google Cloud, Mistral,\nQdrant, ElevenLabs) while remaining provider-agnostic.\n\n## Goals\n\n- Ingest household financial documents (uploads + Gmail threads).\n- Generate AI summaries and optionally deliver them as voice notes.\n- Schedule multi-channel reminders for upcoming bills.\n- Showcase spec-first composition of integrations, knowledge spaces, and\n workflows.\n\n## Blueprint Overview\n\nSource: `packages/verticals/pocket-family-office/blueprint.ts`\n\n- **Integration slots**\n - `primaryLLM` → Mistral chat/embeddings\n - `primaryVectorDb` → Qdrant\n - `primaryStorage` → Google Cloud Storage\n - `primaryOpenBanking` → Powens BYOK project for account aggregation\n - `emailInbound` / `emailOutbound` → Gmail + Postmark\n - `calendarScheduling` → Google Calendar\n - `voicePlayback` → ElevenLabs (optional)\n - `smsNotifications` → Twilio (optional)\n - `paymentsProcessing` → Stripe (optional)\n- **Workflows**\n - `process-uploaded-document`\n - `upcoming-payments-reminder`\n - `generate-financial-summary`\n - `ingest-email-threads`\n - `sync-openbanking-accounts`\n - `sync-openbanking-transactions`\n - `refresh-openbanking-balances`\n - `generate-openbanking-overview`\n- **Policies/Telemetry** – references tenant policy specs and\n `pfo.telemetry` for observability.\n\n## Tenant Sample\n\n`tenant.sample.ts` binds each slot to sample connections defined in\n`connections/samples.ts`. Key details:\n\n- Uses Google Cloud Secret Manager URIs for all credentials.\n- Enables knowledge spaces `knowledge.financial-docs` and\n `knowledge.email-threads`, plus the derived summaries space\n `knowledge.financial-overview` populated by open banking workflows.\n- Keeps `voicePlayback` and `paymentsProcessing` optional so tenants can\n enable them incrementally.\n\n## Contracts\n\n`contracts/index.ts` defines command/query specs that power the\nworkflows:\n\n- `pfo.documents.upload` – store object + enqueue ingestion.\n- `pfo.reminders.schedule-payment` – send email/SMS/calendar reminders.\n- `pfo.summary.generate` – run RAG over knowledge spaces.\n- `pfo.summary.dispatch` – deliver summaries via email / voice.\n- `pfo.email.sync-threads` – ingest Gmail threads.\n\n## Workflows\n\n- **Process Uploaded Document**\n 1. Upload to storage / queue ingestion.\n 2. Optional human review step.\n- **Upcoming Payments Reminder**\n 1. Human review (confirm due date / channel).\n 2. Automation schedules reminders (email/SMS/calendar).\n- **Generate Financial Summary**\n 1. Run RAG to produce Markdown summary.\n 2. Dispatch summary (email + optional ElevenLabs voice note).\n- **Ingest Email Threads**\n 1. Sync Gmail threads into knowledge space.\n 2. Triage step for operators when nothing new is ingested.\n\n## Knowledge & Jobs\n\n- Knowledge spaces registered via\n `registerFinancialDocsKnowledgeSpace` and\n `registerEmailThreadsKnowledgeSpace`.\n- Ingestion adapters (`GmailIngestionAdapter`, `StorageIngestionAdapter`)\n and job handlers (`createGmailSyncHandler`,\n `createStorageDocumentHandler`) wire Gmail labels & GCS prefixes into\n Qdrant.\n- `KnowledgeQueryService` provides summarisation + references for the\n summary generation workflow.\n\n## Tests & Usage\n\n`tests/pocket-family-office.test.ts` exercises:\n\n- Blueprint validation + config composition.\n- In-memory ingestion of a sample invoice.\n- Retrieval augmented generation producing a summary with references.\n\nUse these files as scaffolding for new tenants or as a template for the\nhackathon deliverable. Replace the sample connection metadata with\ntenant-specific IDs/secret references before deploying.\n\n\n\n"
16
+ body: `# Pocket Family Office Vertical
17
+
18
+ Pocket Family Office is a ContractSpec reference vertical that
19
+ demonstrates finance automation atop the integration and knowledge
20
+ layers. It is optimised for the hackathon stack (Google Cloud, Mistral,
21
+ Qdrant, ElevenLabs) while remaining provider-agnostic.
22
+
23
+ ## Goals
24
+
25
+ - Ingest household financial documents (uploads + Gmail threads).
26
+ - Generate AI summaries and optionally deliver them as voice notes.
27
+ - Schedule multi-channel reminders for upcoming bills.
28
+ - Showcase spec-first composition of integrations, knowledge spaces, and
29
+ workflows.
30
+
31
+ ## Blueprint Overview
32
+
33
+ Source: \`packages/examples/pocket-family-office/blueprint.ts\`
34
+
35
+ - **Integration slots**
36
+ - \`primaryLLM\` \u2192 Mistral chat/embeddings
37
+ - \`primaryVectorDb\` \u2192 Qdrant
38
+ - \`primaryStorage\` \u2192 Google Cloud Storage
39
+ - \`primaryOpenBanking\` \u2192 Powens BYOK project for account aggregation
40
+ - \`emailInbound\` / \`emailOutbound\` \u2192 Gmail + Postmark
41
+ - \`calendarScheduling\` \u2192 Google Calendar
42
+ - \`voicePlayback\` \u2192 ElevenLabs (optional)
43
+ - \`smsNotifications\` \u2192 Twilio (optional)
44
+ - \`paymentsProcessing\` \u2192 Stripe (optional)
45
+ - **Workflows**
46
+ - \`process-uploaded-document\`
47
+ - \`upcoming-payments-reminder\`
48
+ - \`generate-financial-summary\`
49
+ - \`ingest-email-threads\`
50
+ - \`sync-openbanking-accounts\`
51
+ - \`sync-openbanking-transactions\`
52
+ - \`refresh-openbanking-balances\`
53
+ - \`generate-openbanking-overview\`
54
+ - **Policies/Telemetry** \u2013 references tenant policy specs and
55
+ \`pfo.telemetry\` for observability.
56
+
57
+ ## Tenant Sample
58
+
59
+ \`tenant.sample.ts\` binds each slot to sample connections defined in
60
+ \`connections/samples.ts\`. Key details:
61
+
62
+ - Uses Google Cloud Secret Manager URIs for all credentials.
63
+ - Enables knowledge spaces \`knowledge.financial-docs\` and
64
+ \`knowledge.email-threads\`, plus the derived summaries space
65
+ \`knowledge.financial-overview\` populated by open banking workflows.
66
+ - Keeps \`voicePlayback\` and \`paymentsProcessing\` optional so tenants can
67
+ enable them incrementally.
68
+
69
+ ## Contracts
70
+
71
+ \`contracts/index.ts\` defines command/query specs that power the
72
+ workflows:
73
+
74
+ - \`pfo.documents.upload\` \u2013 store object + enqueue ingestion.
75
+ - \`pfo.reminders.schedule-payment\` \u2013 send email/SMS/calendar reminders.
76
+ - \`pfo.summary.generate\` \u2013 run RAG over knowledge spaces.
77
+ - \`pfo.summary.dispatch\` \u2013 deliver summaries via email / voice.
78
+ - \`pfo.email.sync-threads\` \u2013 ingest Gmail threads.
79
+
80
+ ## Workflows
81
+
82
+ - **Process Uploaded Document**
83
+ 1. Upload to storage / queue ingestion.
84
+ 2. Optional human review step.
85
+ - **Upcoming Payments Reminder**
86
+ 1. Human review (confirm due date / channel).
87
+ 2. Automation schedules reminders (email/SMS/calendar).
88
+ - **Generate Financial Summary**
89
+ 1. Run RAG to produce Markdown summary.
90
+ 2. Dispatch summary (email + optional ElevenLabs voice note).
91
+ - **Ingest Email Threads**
92
+ 1. Sync Gmail threads into knowledge space.
93
+ 2. Triage step for operators when nothing new is ingested.
94
+
95
+ ## Knowledge & Jobs
96
+
97
+ - Knowledge spaces registered via
98
+ \`registerFinancialDocsKnowledgeSpace\` and
99
+ \`registerEmailThreadsKnowledgeSpace\`.
100
+ - Ingestion adapters (\`GmailIngestionAdapter\`, \`StorageIngestionAdapter\`)
101
+ and job handlers (\`createGmailSyncHandler\`,
102
+ \`createStorageDocumentHandler\`) wire Gmail labels & GCS prefixes into
103
+ Qdrant.
104
+ - \`KnowledgeQueryService\` provides summarisation + references for the
105
+ summary generation workflow.
106
+
107
+ ## Tests & Usage
108
+
109
+ \`tests/pocket-family-office.test.ts\` exercises:
110
+
111
+ - Blueprint validation + config composition.
112
+ - In-memory ingestion of a sample invoice.
113
+ - Retrieval augmented generation producing a summary with references.
114
+
115
+ Use these files as scaffolding for new tenants or as a template for the
116
+ hackathon deliverable. Replace the sample connection metadata with
117
+ tenant-specific IDs/secret references before deploying.
118
+
119
+
120
+
121
+ `
17
122
  }];
18
123
  registerDocBlocks(tech_contracts_vertical_pocket_family_office_DocBlocks);
19
124
 
@@ -33,7 +33,9 @@ Studio access control is **organization-first** with optional **team-based shari
33
33
 
34
34
  ## GraphQL surfaces
35
35
 
36
- - Read:\n - \`myStudioProjects\` (returns only projects you can access)\n - \`studioProjectBySlug(slug)\` (enforces the same access rules)\n - \`myTeams\`\n - \`projectTeams(projectId)\`\n\n- Write:\n - \`createStudioProject(input.teamIds?)\` (teamIds optional)\n - \`setProjectTeams(projectId, teamIds)\` (admin-only)\n
36
+ - Read:
37
+ - \`myStudioProjects\` (returns only projects you can access)\n - \`studioProjectBySlug(slug)\` (enforces the same access rules)\n - \`myTeams\`\n - \`projectTeams(projectId)\`\n\n- Write:\n - \`createStudioProject(input.teamIds?)\` (teamIds optional)\n - \`setProjectTeams(projectId, teamIds)\` (admin-only)\n
38
+
37
39
  ## Related\n+\n+- Team administration + invitations: see \`/docs/tech/studio/team-invitations\`.\n+
38
40
  ## Notes
39
41
 
@@ -2,4 +2,12 @@ import { ExampleDocumentation, ExampleEntrypoints, ExampleKind, ExampleKindEnum,
2
2
  import { ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindSchema, ExampleMetaSchema, ExampleSandboxModeSchema, ExampleSpecSchema, ExampleSurfacesSchema, ExampleVisibilitySchema, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec } from "./schema.js";
3
3
  import { ExampleRegistry } from "./registry.js";
4
4
  import { CrossValidationContext, ExampleValidationError, ExampleValidationWarning, ValidateExampleResult, ValidateExamplesResult, validateExample, validateExampleReferences, validateExamples } from "./validation.js";
5
- export { type CrossValidationContext, type ExampleDocumentation, ExampleDocumentationSchema, type ExampleEntrypoints, ExampleEntrypointsSchema, type ExampleKind, ExampleKindEnum, ExampleKindSchema, type ExampleMcpSupport, type ExampleMeta, ExampleMetaSchema, ExampleRegistry, type ExampleSandboxMode, ExampleSandboxModeEnum, ExampleSandboxModeSchema, type ExampleSandboxSupport, type ExampleSpec, ExampleSpecSchema, type ExampleStudioSupport, type ExampleSurfaces, ExampleSurfacesSchema, type ExampleValidationError, type ExampleValidationWarning, type ExampleVisibility, ExampleVisibilityEnum, ExampleVisibilitySchema, type ValidateExampleResult, type ValidateExamplesResult, isExampleKind, isExampleVisibility, isFeatureRef, isSpecPointer, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec, validateExample, validateExampleReferences, validateExamples };
5
+
6
+ //#region src/examples/index.d.ts
7
+
8
+ /**
9
+ * Helper to define an Example.
10
+ */
11
+ declare const defineExample: (spec: ExampleSpec) => ExampleSpec;
12
+ //#endregion
13
+ export { type CrossValidationContext, type ExampleDocumentation, ExampleDocumentationSchema, type ExampleEntrypoints, ExampleEntrypointsSchema, type ExampleKind, ExampleKindEnum, ExampleKindSchema, type ExampleMcpSupport, type ExampleMeta, ExampleMetaSchema, ExampleRegistry, type ExampleSandboxMode, ExampleSandboxModeEnum, ExampleSandboxModeSchema, type ExampleSandboxSupport, type ExampleSpec, ExampleSpecSchema, type ExampleStudioSupport, type ExampleSurfaces, ExampleSurfacesSchema, type ExampleValidationError, type ExampleValidationWarning, type ExampleVisibility, ExampleVisibilityEnum, ExampleVisibilitySchema, type ValidateExampleResult, type ValidateExamplesResult, defineExample, isExampleKind, isExampleVisibility, isFeatureRef, isSpecPointer, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec, validateExample, validateExampleReferences, validateExamples };
@@ -3,4 +3,11 @@ import { ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindSchema
3
3
  import { ExampleRegistry } from "./registry.js";
4
4
  import { validateExample, validateExampleReferences, validateExamples } from "./validation.js";
5
5
 
6
- export { ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindEnum, ExampleKindSchema, ExampleMetaSchema, ExampleRegistry, ExampleSandboxModeEnum, ExampleSandboxModeSchema, ExampleSpecSchema, ExampleSurfacesSchema, ExampleVisibilityEnum, ExampleVisibilitySchema, isExampleKind, isExampleVisibility, isFeatureRef, isSpecPointer, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec, validateExample, validateExampleReferences, validateExamples };
6
+ //#region src/examples/index.ts
7
+ /**
8
+ * Helper to define an Example.
9
+ */
10
+ const defineExample = (spec) => spec;
11
+
12
+ //#endregion
13
+ export { ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindEnum, ExampleKindSchema, ExampleMetaSchema, ExampleRegistry, ExampleSandboxModeEnum, ExampleSandboxModeSchema, ExampleSpecSchema, ExampleSurfacesSchema, ExampleVisibilityEnum, ExampleVisibilitySchema, defineExample, isExampleKind, isExampleVisibility, isFeatureRef, isSpecPointer, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec, validateExample, validateExampleReferences, validateExamples };
@@ -1,4 +1,4 @@
1
- import { GroupKeyFn, RegistryFilter } from "../registry-utils.js";
1
+ import { SpecContractRegistry } from "../registry.js";
2
2
  import { ExampleKind, ExampleSpec, ExampleVisibility } from "./types.js";
3
3
 
4
4
  //#region src/examples/registry.d.ts
@@ -18,42 +18,20 @@ import { ExampleKind, ExampleSpec, ExampleVisibility } from "./types.js";
18
18
  * const publicExamples = registry.listByVisibility('public');
19
19
  * ```
20
20
  */
21
- declare class ExampleRegistry {
22
- private items;
23
- /** Register an example. Throws when the key already exists. */
24
- register(spec: ExampleSpec): this;
25
- /** List all registered examples. */
26
- list(): ExampleSpec[];
27
- /** Get an example by its key. */
28
- get(key: string, version?: string): ExampleSpec | undefined;
29
- /** Check if an example with the given key exists. */
30
- has(key: string, version?: string): boolean;
31
- /** Get the number of registered examples. */
32
- get size(): number;
33
- /** Clear all registered examples. */
34
- clear(): void;
35
- /** Filter examples by criteria. */
36
- filter(criteria: RegistryFilter): ExampleSpec[];
21
+ declare class ExampleRegistry extends SpecContractRegistry<'example', ExampleSpec> {
22
+ constructor(items?: ExampleSpec[]);
37
23
  /** List examples by kind. */
38
24
  listByKind(kind: ExampleKind): ExampleSpec[];
39
25
  /** List examples by visibility. */
40
26
  listByVisibility(visibility: ExampleVisibility): ExampleSpec[];
41
- /** List examples with specific tag. */
42
- listByTag(tag: string): ExampleSpec[];
43
- /** List examples by owner. */
44
- listByOwner(owner: string): ExampleSpec[];
45
27
  /** List examples by domain. */
46
28
  listByDomain(domain: string): ExampleSpec[];
47
29
  /** List examples that support a specific surface. */
48
30
  listBySurface(surface: 'templates' | 'sandbox' | 'studio' | 'mcp'): ExampleSpec[];
49
31
  /** List examples that are installable via Studio. */
50
32
  listInstallable(): ExampleSpec[];
51
- /** Group examples by key function. */
52
- groupBy(keyFn: GroupKeyFn<ExampleSpec>): Map<string, ExampleSpec[]>;
53
33
  /** Group examples by kind. */
54
34
  groupByKind(): Map<ExampleKind, ExampleSpec[]>;
55
- /** Get unique tags from all examples. */
56
- getUniqueTags(): string[];
57
35
  /** Get unique kinds from all examples. */
58
36
  getUniqueKinds(): ExampleKind[];
59
37
  /** Get unique domains from all examples. */
@@ -1,11 +1,6 @@
1
- import { filterBy, getUniqueTags, groupBy, init_registry_utils } from "../registry-utils.js";
2
- import { compareVersions } from "compare-versions";
1
+ import { SpecContractRegistry } from "../registry.js";
3
2
 
4
3
  //#region src/examples/registry.ts
5
- init_registry_utils();
6
- function exampleKey(meta) {
7
- return `${meta.key}.v${meta.version}`;
8
- }
9
4
  /**
10
5
  * In-memory registry for ExampleSpec.
11
6
  *
@@ -21,44 +16,9 @@ function exampleKey(meta) {
21
16
  * const publicExamples = registry.listByVisibility('public');
22
17
  * ```
23
18
  */
24
- var ExampleRegistry = class {
25
- items = /* @__PURE__ */ new Map();
26
- /** Register an example. Throws when the key already exists. */
27
- register(spec) {
28
- const key = exampleKey(spec.meta);
29
- if (this.items.has(key)) throw new Error(`Duplicate example: ${key}`);
30
- this.items.set(key, spec);
31
- return this;
32
- }
33
- /** List all registered examples. */
34
- list() {
35
- return [...this.items.values()];
36
- }
37
- /** Get an example by its key. */
38
- get(key, version) {
39
- if (version != null) return this.items.get(`${key}.v${version}`);
40
- let candidate;
41
- for (const [_k, v] of this.items.entries()) {
42
- if (v.meta.key !== key) continue;
43
- if (!candidate || compareVersions(v.meta.version, candidate.meta.version) > 0) candidate = v;
44
- }
45
- return candidate;
46
- }
47
- /** Check if an example with the given key exists. */
48
- has(key, version) {
49
- return !!this.get(key, version);
50
- }
51
- /** Get the number of registered examples. */
52
- get size() {
53
- return this.items.size;
54
- }
55
- /** Clear all registered examples. */
56
- clear() {
57
- this.items.clear();
58
- }
59
- /** Filter examples by criteria. */
60
- filter(criteria) {
61
- return filterBy(this.list(), criteria);
19
+ var ExampleRegistry = class extends SpecContractRegistry {
20
+ constructor(items) {
21
+ super("example", items);
62
22
  }
63
23
  /** List examples by kind. */
64
24
  listByKind(kind) {
@@ -68,14 +28,6 @@ var ExampleRegistry = class {
68
28
  listByVisibility(visibility) {
69
29
  return this.list().filter((spec) => spec.meta.visibility === visibility);
70
30
  }
71
- /** List examples with specific tag. */
72
- listByTag(tag) {
73
- return this.list().filter((spec) => spec.meta.tags.includes(tag));
74
- }
75
- /** List examples by owner. */
76
- listByOwner(owner) {
77
- return this.list().filter((spec) => spec.meta.owners.includes(owner));
78
- }
79
31
  /** List examples by domain. */
80
32
  listByDomain(domain) {
81
33
  return this.list().filter((spec) => spec.meta.domain === domain);
@@ -94,10 +46,6 @@ var ExampleRegistry = class {
94
46
  listInstallable() {
95
47
  return this.list().filter((spec) => spec.surfaces.studio.installable);
96
48
  }
97
- /** Group examples by key function. */
98
- groupBy(keyFn) {
99
- return groupBy(this.list(), keyFn);
100
- }
101
49
  /** Group examples by kind. */
102
50
  groupByKind() {
103
51
  const result = /* @__PURE__ */ new Map();
@@ -108,10 +56,6 @@ var ExampleRegistry = class {
108
56
  }
109
57
  return result;
110
58
  }
111
- /** Get unique tags from all examples. */
112
- getUniqueTags() {
113
- return getUniqueTags(this.list());
114
- }
115
59
  /** Get unique kinds from all examples. */
116
60
  getUniqueKinds() {
117
61
  const kinds = /* @__PURE__ */ new Set();
@@ -3,14 +3,14 @@ import { z as z$1 } from "zod";
3
3
 
4
4
  //#region src/examples/schema.d.ts
5
5
  declare const ExampleKindSchema: z$1.ZodEnum<{
6
- integration: "integration";
7
- template: "template";
8
- workflow: "workflow";
9
6
  knowledge: "knowledge";
7
+ library: "library";
8
+ workflow: "workflow";
9
+ template: "template";
10
+ integration: "integration";
10
11
  blueprint: "blueprint";
11
12
  ui: "ui";
12
13
  script: "script";
13
- library: "library";
14
14
  }>;
15
15
  declare const ExampleVisibilitySchema: z$1.ZodEnum<{
16
16
  experimental: "experimental";
@@ -25,9 +25,9 @@ declare const ExampleSandboxModeSchema: z$1.ZodEnum<{
25
25
  evolution: "evolution";
26
26
  }>;
27
27
  declare const StabilitySchema: z$1.ZodEnum<{
28
+ experimental: "experimental";
28
29
  idea: "idea";
29
30
  in_creation: "in_creation";
30
- experimental: "experimental";
31
31
  beta: "beta";
32
32
  stable: "stable";
33
33
  deprecated: "deprecated";
@@ -93,9 +93,9 @@ declare const ExampleMetaSchema: z$1.ZodObject<{
93
93
  description: z$1.ZodString;
94
94
  domain: z$1.ZodOptional<z$1.ZodString>;
95
95
  stability: z$1.ZodEnum<{
96
+ experimental: "experimental";
96
97
  idea: "idea";
97
98
  in_creation: "in_creation";
98
- experimental: "experimental";
99
99
  beta: "beta";
100
100
  stable: "stable";
101
101
  deprecated: "deprecated";
@@ -104,14 +104,14 @@ declare const ExampleMetaSchema: z$1.ZodObject<{
104
104
  tags: z$1.ZodArray<z$1.ZodString>;
105
105
  docId: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
106
106
  kind: z$1.ZodEnum<{
107
- integration: "integration";
108
- template: "template";
109
- workflow: "workflow";
110
107
  knowledge: "knowledge";
108
+ library: "library";
109
+ workflow: "workflow";
110
+ template: "template";
111
+ integration: "integration";
111
112
  blueprint: "blueprint";
112
113
  ui: "ui";
113
114
  script: "script";
114
- library: "library";
115
115
  }>;
116
116
  visibility: z$1.ZodEnum<{
117
117
  experimental: "experimental";
@@ -141,9 +141,9 @@ declare const ExampleSpecSchema: z$1.ZodObject<{
141
141
  description: z$1.ZodString;
142
142
  domain: z$1.ZodOptional<z$1.ZodString>;
143
143
  stability: z$1.ZodEnum<{
144
+ experimental: "experimental";
144
145
  idea: "idea";
145
146
  in_creation: "in_creation";
146
- experimental: "experimental";
147
147
  beta: "beta";
148
148
  stable: "stable";
149
149
  deprecated: "deprecated";
@@ -152,14 +152,14 @@ declare const ExampleSpecSchema: z$1.ZodObject<{
152
152
  tags: z$1.ZodArray<z$1.ZodString>;
153
153
  docId: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
154
154
  kind: z$1.ZodEnum<{
155
- integration: "integration";
156
- template: "template";
157
- workflow: "workflow";
158
155
  knowledge: "knowledge";
156
+ library: "library";
157
+ workflow: "workflow";
158
+ template: "template";
159
+ integration: "integration";
159
160
  blueprint: "blueprint";
160
161
  ui: "ui";
161
162
  script: "script";
162
- library: "library";
163
163
  }>;
164
164
  visibility: z$1.ZodEnum<{
165
165
  experimental: "experimental";
@@ -221,10 +221,10 @@ declare function safeParseExampleSpec(data: unknown): z$1.ZodSafeParseResult<{
221
221
  version: string;
222
222
  key: string;
223
223
  description: string;
224
- stability: "idea" | "in_creation" | "experimental" | "beta" | "stable" | "deprecated";
224
+ stability: "experimental" | "idea" | "in_creation" | "beta" | "stable" | "deprecated";
225
225
  owners: string[];
226
226
  tags: string[];
227
- kind: "integration" | "template" | "workflow" | "knowledge" | "blueprint" | "ui" | "script" | "library";
227
+ kind: "knowledge" | "library" | "workflow" | "template" | "integration" | "blueprint" | "ui" | "script";
228
228
  visibility: "experimental" | "public" | "internal";
229
229
  title?: string | undefined;
230
230
  domain?: string | undefined;
@@ -1,7 +1,7 @@
1
1
  import { OwnerShipMeta } from "../ownership.js";
2
- import { AppBlueprintSpec, SpecPointer } from "../app-config/spec.js";
3
2
  import { FeatureModuleSpec, FeatureRef } from "../features/types.js";
4
3
  import "../features/index.js";
4
+ import { AppBlueprintSpec, SpecPointer } from "../app-config/spec.js";
5
5
 
6
6
  //#region src/examples/types.d.ts
7
7
  /** Kind of example - determines how it's presented in catalogs */
@@ -2,9 +2,9 @@ import { PresentationTarget } from "../presentations/presentations.js";
2
2
  import { OwnerShipMeta } from "../ownership.js";
3
3
  import { CapabilityRef, CapabilityRequirement } from "../capabilities/capabilities.js";
4
4
  import "../capabilities/index.js";
5
+ import { ExperimentRef } from "../experiments/spec.js";
5
6
  import { ImplementationRef } from "../operations/operation.js";
6
7
  import "../operations/index.js";
7
- import { ExperimentRef } from "../experiments/spec.js";
8
8
 
9
9
  //#region src/features/types.d.ts
10
10
  /** Minimal metadata to identify and categorize a feature module. */
package/dist/index.d.ts CHANGED
@@ -6,15 +6,30 @@ import { techContractsDocs } from "./docs/tech-contracts.docs.js";
6
6
  import { metaDocs } from "./docs/meta.docs.js";
7
7
  import "./docs/index.js";
8
8
  import { Owner, OwnerShipMeta, Owners, OwnersEnum, Stability, StabilityEnum, Tag, Tags, TagsEnum } from "./ownership.js";
9
- import { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, capabilityKey, defineCapability } from "./capabilities/capabilities.js";
10
- import { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities } from "./capabilities/openbanking.js";
11
- import "./capabilities/index.js";
12
- import { AttributeMatcher, ConsentDefinition, FieldPolicyRule, PIIPolicy, PolicyCondition, PolicyEffect, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRule, PolicySpec, RateLimitDefinition, RelationshipDefinition, RelationshipMatcher, ResourceMatcher, SubjectMatcher } from "./policy/spec.js";
13
9
  import { FilterableItem, GroupKeyFn, GroupedItems, GroupingStrategies, RegistryFilter, filterBy, getUniqueDomains, getUniqueOwners, getUniqueTags, groupBy, groupByMultiple, groupByToArray } from "./registry-utils.js";
10
+ import { AttributeMatcher, ConsentDefinition, FieldPolicyRule, PIIPolicy, PolicyCondition, PolicyEffect, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRule, PolicySpec, RateLimitDefinition, RelationshipDefinition, RelationshipMatcher, ResourceMatcher, SubjectMatcher } from "./policy/spec.js";
14
11
  import { TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyThreshold, TelemetryConfig, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySpec, makeTelemetryKey } from "./telemetry/spec.js";
15
12
  import { TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions } from "./telemetry/anomaly.js";
16
13
  import { RuntimeTelemetryProvider, TelemetryDispatch, TelemetryEventContext, TelemetryTracker, TelemetryTrackerOptions } from "./telemetry/tracker.js";
17
14
  import "./telemetry/index.js";
15
+ import { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, capabilityKey, defineCapability } from "./capabilities/capabilities.js";
16
+ import { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities } from "./capabilities/openbanking.js";
17
+ import "./capabilities/index.js";
18
+ import { AllocationStrategy, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, MetricAggregation, SuccessMetric, TargetingRule, makeExperimentKey } from "./experiments/spec.js";
19
+ import { ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, defineResourceTemplate, isResourceRef, resourceRef } from "./resources.js";
20
+ import { Action, Assertion, CoverageRequirement, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, Fixture, OperationTargetRef, TestRegistry, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, WorkflowTargetRef, defineTestSpec, makeTestKey } from "./tests/spec.js";
21
+ import { AnyOperationSpec, EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, OperationSpec, OperationSpecMeta, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef } from "./operations/operation.js";
22
+ import { EventParam, HandlerForOperationSpec, OperationSpecInput, OperationSpecOutput, RuntimeSpecOutput, ZodOperationSpecInput, installOp, makeEmit, op } from "./install.js";
23
+ import { OperationKey, OperationSpecRegistry, opKey } from "./operations/registry.js";
24
+ import "./operations/index.js";
25
+ import { EventRef, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, OpRef, PresentationRef } from "./features/types.js";
26
+ import { FeatureRegistry } from "./features/registry.js";
27
+ import { ComponentMap, PresentationRenderer, PresentationValidator, ReactRenderDescriptor, RenderContext, TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer } from "./presentations/transform-engine.js";
28
+ import { PresentationRegistry } from "./presentations/registry.js";
29
+ import "./presentations/index.js";
30
+ import { InstallFeatureDeps, installFeature } from "./features/install.js";
31
+ import { validateFeatureTargetsV2 } from "./features/validation.js";
32
+ import { defineFeature } from "./features/index.js";
18
33
  import { DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewSections, DataViewSource, DataViewStates, DataViewTableColumn, DataViewTableConfig } from "./data-views/types.js";
19
34
  import { DataViewRef, DataViewSpec, defineDataView } from "./data-views/spec.js";
20
35
  import { DataViewRegistry, dataViewKey } from "./data-views/registry.js";
@@ -22,33 +37,18 @@ import "./data-views/index.js";
22
37
  import { CompensationStep, CompensationStrategy, FormRef, GuardCondition, GuardConditionKind, RetryPolicy, SLA, Step, StepAction, StepType, Transition, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowStatus } from "./workflow/spec.js";
23
38
  import { PolicyRegistry } from "./policy/registry.js";
24
39
  import { ComponentVariantDefinition, ComponentVariantSpec, ThemeMeta, ThemeOverride, ThemeRef, ThemeRegistry, ThemeScope, ThemeSpec, ThemeToken, ThemeTokens, makeThemeRef } from "./themes.js";
25
- import { IntegrationByokSetup, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationHealthCheck, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, makeIntegrationSpecKey } from "./integrations/spec.js";
40
+ import { IntegrationByokSetup, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationHealthCheck, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, defineIntegration, makeIntegrationSpecKey } from "./integrations/spec.js";
26
41
  import { ConnectionStatus, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationUsageMetrics } from "./integrations/connection.js";
27
42
  import { AppIntegrationBinding } from "./integrations/binding.js";
28
43
  import { KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, makeKnowledgeSpaceKey } from "./knowledge/spec.js";
29
44
  import { KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType } from "./knowledge/source.js";
30
45
  import { AppKnowledgeBinding } from "./knowledge/binding.js";
31
46
  import { BlueprintTranslationCatalog, Locale, MessageKey, PlatformTranslationCatalog, TranslationCatalogMeta, TranslationEntry } from "./translations/catalog.js";
32
- import { AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TenantAppConfig, TenantAppConfigMeta, TenantRouteOverride, TenantSpecOverride, TranslationCatalogPointer, makeAppBlueprintKey } from "./app-config/spec.js";
47
+ import { AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TenantAppConfig, TenantAppConfigMeta, TenantRouteOverride, TenantSpecOverride, TranslationCatalogPointer, defineAppConfig, makeAppBlueprintKey } from "./app-config/spec.js";
33
48
  import { AppComposition, AppCompositionDeps, ComposeOptions, MissingReference, ResolveAppConfigDeps, ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, composeAppConfig, resolveAppConfig } from "./app-config/runtime.js";
34
- import { AnyEventSpec, EventEnvelope, EventKey, EventRegistry, EventSpec, EventSpecMeta, defineEvent, eventKey } from "./events.js";
35
- import { ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, defineResourceTemplate, isResourceRef, resourceRef } from "./resources.js";
36
- import { Action, Assertion, CoverageRequirement, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, Fixture, OperationTargetRef, TestRegistry, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, WorkflowTargetRef, makeTestKey } from "./tests/spec.js";
37
- import { AnyOperationSpec, EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, OperationSpec, OperationSpecMeta, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef } from "./operations/operation.js";
38
- import { EventParam, HandlerForOperationSpec, OperationSpecInput, OperationSpecOutput, RuntimeSpecOutput, ZodOperationSpecInput, installOp, makeEmit, op } from "./install.js";
39
- import { OperationKey, OperationSpecRegistry, opKey } from "./operations/registry.js";
40
- import "./operations/index.js";
41
49
  import { RuntimeContract, SpecVariantResolver } from "./experiments/spec-resolver.js";
42
50
  import { Actor, Channel, ContractSpecType, EventPublisher, FieldLevelDecision, HandlerCtx, PolicyDecider, PolicyDeciderInput, PolicyDecision, RateLimiter, TranslationResolver } from "./types.js";
43
- import { AllocationStrategy, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, MetricAggregation, SuccessMetric, TargetingRule, makeExperimentKey } from "./experiments/spec.js";
44
- import { EventRef, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, OpRef, PresentationRef } from "./features/types.js";
45
- import { FeatureRegistry } from "./features/registry.js";
46
- import { ComponentMap, PresentationRenderer, PresentationValidator, ReactRenderDescriptor, RenderContext, TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer } from "./presentations/transform-engine.js";
47
- import { PresentationRegistry } from "./presentations/registry.js";
48
- import "./presentations/index.js";
49
- import { InstallFeatureDeps, installFeature } from "./features/install.js";
50
- import { validateFeatureTargetsV2 } from "./features/validation.js";
51
- import { defineFeature } from "./features/index.js";
51
+ import { AnyEventSpec, EventEnvelope, EventKey, EventRegistry, EventSpec, EventSpecMeta, defineEvent, eventKey } from "./events.js";
52
52
  import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./client/react/feature-render.js";
53
53
  import { ArrayFieldSpec, BaseFieldSpec, CheckboxFieldSpec, ConstraintDecl, ConstraintHandler, EnhanceFields, FieldSpec, FormAction, FormOption, FormRegistry, FormSpec, FormValuesFor, GroupFieldSpec, OptionsSource, Predicate, PredicateOp, RadioFieldSpec, SelectFieldSpec, SwitchFieldSpec, TextFieldSpec, TextareaFieldSpec, TypedOptionsSource, TypedPredicate, TypedWhenClause, WhenClause, buildZodWithRelations, defineFormSpec, evalPredicate } from "./forms/forms.js";
54
54
  import "./forms/index.js";
@@ -127,7 +127,8 @@ import { behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope } from "./rege
127
127
  import { ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions } from "./regenerator/sinks.js";
128
128
  import "./regenerator/index.js";
129
129
  import { TenantTranslationOverride } from "./translations/tenant.js";
130
- import { BumpStrategy, BumpStrategySchema, ChangelogFormat, ChangelogFormatSchema, ChangelogTier, ChangelogTierSchema, ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventions, FolderConventionsSchema, FormatterConfig, FormatterConfigSchema, FormatterType, FormatterTypeSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema, RuleSyncConfig, RuleSyncConfigSchema, RuleSyncTarget, RuleSyncTargetSchema, SchemaFormat, SchemaFormatSchema, VersioningConfig, VersioningConfigSchema } from "./workspace-config/contractsrc-schema.js";
130
+ import { BumpStrategy, ChangelogFormat, ChangelogTier, ContractsrcConfig, ContractsrcFileConfig, FolderConventions, FormatterConfig, FormatterType, OpenApiConfig, OpenApiExportConfig, OpenApiSourceConfig, ResolvedContractsrcConfig, RuleSyncConfig, RuleSyncTarget, SchemaFormat, VersioningConfig } from "./workspace-config/contractsrc-types.js";
131
+ import { BumpStrategySchema, ChangelogFormatSchema, ChangelogTierSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, FormatterConfigSchema, FormatterTypeSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, RuleSyncConfigSchema, RuleSyncTargetSchema, SchemaFormatSchema, VersioningConfigSchema } from "./workspace-config/contractsrc-schema.js";
131
132
  import "./workspace-config/index.js";
132
133
  import { ValidateWorkflowSpecOptions, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, assertWorkflowSpecValid, validateWorkflowSpec } from "./workflow/validation.js";
133
134
  import { StateStore, StepExecution, WorkflowState, WorkflowStateFilters } from "./workflow/state.js";
@@ -136,7 +137,7 @@ import { ExpressionContext, evaluateExpression } from "./workflow/expression.js"
136
137
  import { InMemoryStateStore } from "./workflow/adapters/memory-store.js";
137
138
  import { PrismaStateStore } from "./workflow/adapters/db-adapter.js";
138
139
  import { FileStateStoreOptions, createFileStateStore } from "./workflow/adapters/file-adapter.js";
139
- import "./workflow/index.js";
140
+ import { defineWorkflow } from "./workflow/index.js";
140
141
  import { SchemaMarkdownOptions, schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable } from "./schema-to-markdown.js";
141
142
  import { AgentPrompt, AgentType, BatchExportOptions, ExportableItem, FeatureExportOptions, FeatureExportResult, FeatureLookup, ImplementationPlan, LLMExportFormat, SpecExportOptions, SpecExportResult, SpecLookup, VerificationIssue, VerificationReport, VerificationTier } from "./llm/types.js";
142
143
  import { docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, operationSpecToAgentPrompt, operationSpecToContextMarkdown, operationSpecToFullMarkdown, presentationToMarkdown } from "./llm/exporters.js";
@@ -147,8 +148,8 @@ import { ExampleDocumentation, ExampleEntrypoints, ExampleKind, ExampleKindEnum,
147
148
  import { ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindSchema, ExampleMetaSchema, ExampleSandboxModeSchema, ExampleSpecSchema, ExampleSurfacesSchema, ExampleVisibilitySchema, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec } from "./examples/schema.js";
148
149
  import { ExampleRegistry } from "./examples/registry.js";
149
150
  import { CrossValidationContext, ExampleValidationError, ExampleValidationWarning, ValidateExampleResult, ValidateExamplesResult, validateExample, validateExampleReferences, validateExamples } from "./examples/validation.js";
150
- import "./examples/index.js";
151
+ import { defineExample } from "./examples/index.js";
151
152
  import { ChangeEntry, ChangeType, ChangelogDocBlock, ChangelogEntry, ChangelogJsonExport, ChangelogResult, SemanticVersion, VersionAnalysis, VersionAnalysisResult, VersionBumpType, isChangeType, isChangelogDocBlock, isVersionBumpType } from "./versioning/types.js";
152
153
  import { bumpVersion, compareVersions, determineBumpType, formatVersion, getBumpTypePriority, getMaxBumpType, isValidVersion, isVersionEqual, isVersionGreater, isVersionLess, parseVersion, parseVersionStrict, validateVersion } from "./versioning/utils.js";
153
154
  import { defineSchemaModel } from "@contractspec/lib.schema";
154
- export { AGENT_SYSTEM_PROMPTS, AccountBalanceRecord, Action, ActionExecutionResult, Actor, AgentPrompt, AgentType, AllocationStrategy, AnyEventSpec, AnyOperationSpec, AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppComposition, AppCompositionDeps, AppIntegrationBinding, AppIntegrationSlot, AppKnowledgeBinding, AppRouteConfig, AppThemeBinding, ArrayFieldSpec, Assertion, AssertionResult, AttributeMatcher, BankAccountRecord, BankTransactionRecord, BaseFieldSpec, BatchExportOptions, BehaviorSignal, BehaviorSignalEnvelope, BehaviorSignalProvider, BlueprintTranslationCatalog, BlueprintUpdater, BumpStrategy, BumpStrategySchema, CalendarAttendee, CalendarEvent, CalendarEventInput, CalendarEventUpdateInput, CalendarListEventsQuery, CalendarListEventsResult, CalendarProvider, CalendarReminder, CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, CapturePaymentInput, ChangeEntry, ChangeType, ChangelogDocBlock, ChangelogEntry, ChangelogFormat, ChangelogFormatSchema, ChangelogJsonExport, ChangelogResult, ChangelogTier, ChangelogTierSchema, Channel, CheckboxFieldSpec, CompensationStep, CompensationStrategy, CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, CompleteOnboardingBaseSpec, ComponentMap, ComponentVariantDefinition, ComponentVariantSpec, ComposeOptions, ComputationMap, ConnectionStatus, ConsentDefinition, ConstraintDecl, ConstraintHandler, ContractRegistryFile, ContractRegistryFileSchema, ContractRegistryItem, ContractRegistryItemParsed, ContractRegistryItemSchema, ContractRegistryItemType, ContractRegistryItemTypeSchema, ContractRegistryManifest, ContractRegistryManifestParsed, ContractRegistryManifestSchema, ContractSpecType, ContractsrcConfig, ContractsrcSchema, CoverageRequirement, CreateCustomerInput, CreateIntegrationConnection, CreateKnowledgeSource, CreatePaymentIntentInput, CreateRendererOptions, CrossValidationContext, DEFAULT_CONTRACTSRC, DataMigrationStep, DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewRef, DataViewRegistry, DataViewSections, DataViewSource, DataViewSpec, DataViewStates, DataViewTableColumn, DataViewTableConfig, DecisionContext, DeleteIntegrationConnection, DeleteKnowledgeSource, DeleteObjectInput, DeleteOnboardingDraftBaseSpec, DeleteOnboardingDraftOutput, DocBlock, DocBlockLink, DocId, DocKind, DocPresentationOptions, DocPresentationRoute, DocRegistry, DocVisibility, DriverSlots, EmailAddress, EmailAttachment, EmailInboundProvider, EmailMessage, EmailMessagesSinceQuery, EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult, EmailThread, EmailThreadListQuery, EmbeddingDocument, EmbeddingProvider, EmbeddingResult, EmbeddingVector, EmitDecl, EmitDeclInline, EmitDeclRef, EnhanceFields, ErrorSignal, ErrorSignalEnvelope, ErrorSignalProvider, EventEnvelope, EventKey, EventParam, EventPublisher, EventRef, EventRegistry, EventSpec, EventSpecMeta, ExampleDocumentation, ExampleDocumentationSchema, ExampleEntrypoints, ExampleEntrypointsSchema, ExampleKind, ExampleKindEnum, ExampleKindSchema, ExampleMcpSupport, ExampleMeta, ExampleMetaSchema, ExampleRegistry, ExampleSandboxMode, ExampleSandboxModeEnum, ExampleSandboxModeSchema, ExampleSandboxSupport, ExampleSpec, ExampleSpecSchema, ExampleStudioSupport, ExampleSurfaces, ExampleSurfacesSchema, ExampleValidationError, ExampleValidationWarning, ExampleVisibility, ExampleVisibilityEnum, ExampleVisibilitySchema, ExecutionStatus, ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, ExperimentContext, ExperimentEvaluation, ExperimentEvaluator, ExperimentEvaluatorConfig, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, ExportableItem, ExpressionContext, FeatureExportOptions, FeatureExportResult, FeatureFlagState, FeatureLookup, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FeatureRegistry, FieldLevelDecision, FieldPolicyRule, FieldSpec, FileStateStoreOptions, FilterableItem, Fixture, FolderConventions, FolderConventionsSchema, FormAction, FormOption, FormRef, FormRegistry, FormSpec, FormValuesFor, FormatterConfig, FormatterConfigSchema, FormatterType, FormatterTypeSchema, GetObjectResult, GetOnboardingDraftBaseSpec, GetOnboardingDraftOutput, GroupFieldSpec, GroupKeyFn, GroupedItems, GroupingStrategies, GuardCondition, GuardConditionKind, GuardContext, GuardEvaluator, HandlerCtx, HandlerForOperationSpec, ImplementationPlan, ImplementationRef, ImplementationType, InMemoryStateStore, InstallFeatureDeps, IntegrationByokSetup, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationHealthCheck, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, IntegrationUsageMetrics, JsonSchema, KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, LLMChatOptions, LLMContentPart, LLMExportFormat, LLMMessage, LLMProvider, LLMResponse, LLMRole, LLMStreamChunk, LLMTextPart, LLMTokenUsage, LLMToolCallPart, LLMToolDefinition, LLMToolResultPart, ListIntegrationConnections, ListInvoicesQuery, ListKnowledgeSources, ListObjectsQuery, ListObjectsResult, ListTransactionsQuery, Locale, MessageKey, MetricAggregation, MigrationCheck, MigrationExecutor, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, MissingReference, ModelRegistry, Money, OPAAdapterOptions, OPAClient, OPAEvaluationResult, OPAPolicyAdapter, OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, ObjectStorageProvider, OpKind, OpRef, OpenApiConfig, OpenApiConfigSchema, OpenApiDocument, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiExportOptions, OpenApiServer, OpenApiSourceConfig, OpenApiSourceConfigSchema, OpenBankingAccountBalance, OpenBankingAccountDetails, OpenBankingAccountOwnership, OpenBankingAccountSummary, OpenBankingBalanceType, OpenBankingConnectionStatus, OpenBankingFeature, OpenBankingGetAccount, OpenBankingGetAccountDetailsParams, OpenBankingGetBalances, OpenBankingGetBalancesParams, OpenBankingGetConnectionStatusParams, OpenBankingGuardResult, OpenBankingListAccounts, OpenBankingListAccountsParams, OpenBankingListAccountsResult, OpenBankingListTransactions, OpenBankingListTransactionsParams, OpenBankingListTransactionsResult, OpenBankingProvider, OpenBankingRefreshBalances, OpenBankingSyncAccounts, OpenBankingSyncTransactions, OpenBankingTelemetryEvent, OpenBankingTransaction, OperationExecutor, OperationExecutorContext, OperationKey, OperationSpec, OperationSpecInput, OperationSpecMeta, OperationSpecOutput, OperationSpecRegistry, OperationTargetRef, OptionsSource, Owner, OwnerShipMeta, Owners, OwnersEnum, PIIPolicy, PaymentCustomer, PaymentIntent, PaymentIntentStatus, PaymentInvoice, PaymentRefund, PaymentTransaction, PaymentsProvider, PlatformTranslationCatalog, PolicyCondition, PolicyDecider, PolicyDeciderInput, PolicyDecision, PolicyEffect, PolicyEngine, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRegistry, PolicyRule, PolicySpec, Predicate, PredicateOp, PresentationRef, PresentationRegistry, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationSpec, PresentationSpecMeta, PresentationTarget, PresentationValidator, PrismaStateStore, PromptArg, PromptContentPart, PromptMeta, PromptPolicy, PromptRegistry, PromptSpec, PromptStability, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, ProposalSink, ProposalTarget, PutObjectInput, RadioFieldSpec, RateLimitDefinition, RateLimiter, ReactRenderDescriptor, RefundPaymentInput, RegenerationContext, RegenerationRule, RegenerationTrigger, RegeneratorOptions, RegeneratorService, RegeneratorSignal, RegistryFilter, RelationshipDefinition, RelationshipMatcher, RenderContext, RenderOptions, ResolveAppConfigDeps, ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, ResolverMap, ResourceContext, ResourceMatcher, ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, RestOptions, RetryPolicy, RnReusablesDriver, RuleSyncConfig, RuleSyncConfigSchema, RuleSyncTarget, RuleSyncTargetSchema, RunMigrationsAction, RunTestsAction, RuntimeContract, RuntimeSpecOutput, RuntimeTelemetryProvider, SLA, SaveOnboardingDraftBaseSpec, SaveOnboardingDraftInput, SaveOnboardingDraftOutput, ScenarioRunResult, SchemaFormat, SchemaFormatSchema, SchemaMarkdownOptions, SchemaMigrationStep, SelectFieldSpec, SemanticVersion, SendSmsInput, ShadcnDriver, SignalAdapters, SignedUrlOptions, SmsDeliveryStatus, SmsMessage, SmsProvider, SpecChangeProposal, SpecExportOptions, SpecExportResult, SpecLookup, SpecPointer, SpecVariantResolver, Stability, StabilityEnum, StateStore, Step, StepAction, StepExecution, StepType, StorageObjectBody, StorageObjectMetadata, SubjectContext, SubjectMatcher, SubjectRelationship, SuccessMetric, SwitchFieldSpec, Tag, Tags, TagsEnum, TargetingRule, TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions, TelemetryAnomalyThreshold, TelemetryBinding, TelemetryConfig, TelemetryDispatch, TelemetryEventContext, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySignal, TelemetrySignalEnvelope, TelemetrySignalProvider, TelemetrySpec, TelemetryTracker, TelemetryTrackerOptions, TelemetryTrigger, TenantAppConfig, TenantAppConfigMeta, TenantConfigUpdater, TenantRouteOverride, TenantSpecOverride, TenantTranslationOverride, TestExecutor, TestIntegrationConnection, TestRegistry, TestRunResult, TestRunner, TestRunnerConfig, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, TextFieldSpec, TextareaFieldSpec, ThemeMeta, ThemeOverride, ThemeRef, ThemeRegistry, ThemeScope, ThemeSpec, ThemeToken, ThemeTokens, TokenCountResult, TransformEngine, Transition, TranslationCatalogMeta, TranslationCatalogPointer, TranslationEntry, TranslationResolver, TriggerKnowledgeSourceSync, TriggerRegenerationAction, TypedOptionsSource, TypedPredicate, TypedWhenClause, UpdateBlueprintAction, UpdateIntegrationConnection, UpdateKnowledgeSource, UpdateTenantConfigAction, ValidateExampleResult, ValidateExamplesResult, ValidateWorkflowSpecOptions, ValidationContext, ValidationIssue, ValidationMigrationStep, ValidationResult, ValidationSeverity, VectorDeleteRequest, VectorDocument, VectorSearchQuery, VectorSearchResult, VectorStoreProvider, VectorUpsertRequest, VerificationIssue, VerificationReport, VerificationTier, VersionAnalysis, VersionAnalysisResult, VersionBumpType, VersioningConfig, VersioningConfigSchema, Voice, VoiceProvider, VoiceSynthesisInput, VoiceSynthesisResult, WhenClause, WorkflowDefinition, WorkflowMeta, WorkflowPreFlightError, WorkflowPreFlightIssue, WorkflowPreFlightIssueSeverity, WorkflowPreFlightIssueType, WorkflowPreFlightResult, WorkflowRegistry, WorkflowRunner, WorkflowRunnerConfig, WorkflowSpec, WorkflowState, WorkflowStateFilters, WorkflowStatus, WorkflowTargetRef, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, ZodOperationSpecInput, assertPrimaryOpenBankingReady, assertWorkflowSpecValid, behaviorToEnvelope, buildOPAInput, buildZodWithRelations, bumpVersion, capabilityKey, compareVersions, composeAppConfig, createDefaultIntegrationSpecRegistry, createDefaultTransformEngine, createEngineWithDefaults, createFeatureModule, createFetchHandler, createFileStateStore, createFormRenderer, createMcpServer, dataViewKey, defaultDocRegistry, defaultGqlField, defaultMcpPrompt, defaultMcpTool, defaultRestPath, defineCapability, defineCommand, defineDataView, defineEvent, defineFeature, defineFormSpec, definePresentation, definePrompt, defineQuery, defineResourceTemplate, defineSchemaModel, determineBumpType, docBlockToMarkdown, docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, elevenLabsIntegrationSpec, elysiaPlugin, emailThreadsKnowledgeSpace, ensurePrimaryOpenBankingIntegration, errorToEnvelope, evalPredicate, evaluateExpression, eventKey, eventToMarkdown, exportFeature, exportSpec, expressRouter, featureToMarkdown, filterBy, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, formatPlanForAgent, formatVersion, gcsStorageIntegrationSpec, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt, getBumpTypePriority, getMaxBumpType, getUniqueDomains, getUniqueOwners, getUniqueTags, gmailIntegrationSpec, googleCalendarIntegrationSpec, groupBy, groupByMultiple, groupByToArray, installFeature, installOp, integrationContracts, isChangeType, isChangelogDocBlock, isEmitDeclRef, isExampleKind, isExampleVisibility, isFeatureRef, isResourceRef, isSpecPointer, isValidVersion, isVersionBumpType, isVersionEqual, isVersionGreater, isVersionLess, jsonSchemaForSpec, knowledgeContracts, listRegisteredDocBlocks, makeAppBlueprintKey, makeEmit, makeExperimentKey, makeIntegrationSpecKey, makeKnowledgeSpaceKey, makeNextAppHandler, makeNextPagesHandler, makeTelemetryKey, makeTestKey, makeThemeRef, mapDocRoutes, metaDocs, mistralIntegrationSpec, op, opKey, openApiForRegistry, openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, operationSpecToAgentPrompt, operationSpecToContextMarkdown, operationSpecToFullMarkdown, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, parseVersion, parseVersionStrict, postmarkIntegrationSpec, powensIntegrationSpec, presentationToMarkdown, productCanonKnowledgeSpace, qdrantIntegrationSpec, redactOpenBankingTelemetryPayload, registerBasicValidation, registerContractsOnBuilder, registerDefaultReactRenderer, registerDocBlocks, registerElevenLabsIntegration, registerEmailThreadsKnowledgeSpace, registerFeature, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerGcsStorageIntegration, registerGmailIntegration, registerGoogleCalendarIntegration, registerIntegrationContracts, registerKnowledgeContracts, registerMistralIntegration, registerOpenBankingCapabilities, registerOpenBankingContracts, registerPostmarkIntegration, registerPowensIntegration, registerProductCanonKnowledgeSpace, registerQdrantIntegration, registerReactToMarkdownRenderer, registerStripeIntegration, registerSupportFaqKnowledgeSpace, registerTwilioSmsIntegration, registerUploadedDocsKnowledgeSpace, renderFeaturePresentation, resolveAppConfig, resourceRef, rnReusablesDriver, safeParseExampleSpec, sanitizeMcpName, schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable, shadcnDriver, stripeIntegrationSpec, supportFaqKnowledgeSpace, techContractsDocs, telemetryToEnvelope, twilioSmsIntegrationSpec, uploadedDocsKnowledgeSpace, validateBlueprint, validateConfig, validateExample, validateExampleReferences, validateExamples, validateFeatureTargetsV2, validateResolvedConfig, validateTenantConfig, validateVersion, validateWorkflowSpec };
155
+ export { AGENT_SYSTEM_PROMPTS, AccountBalanceRecord, Action, ActionExecutionResult, Actor, AgentPrompt, AgentType, AllocationStrategy, AnyEventSpec, AnyOperationSpec, AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppComposition, AppCompositionDeps, AppIntegrationBinding, AppIntegrationSlot, AppKnowledgeBinding, AppRouteConfig, AppThemeBinding, ArrayFieldSpec, Assertion, AssertionResult, AttributeMatcher, BankAccountRecord, BankTransactionRecord, BaseFieldSpec, BatchExportOptions, BehaviorSignal, BehaviorSignalEnvelope, BehaviorSignalProvider, BlueprintTranslationCatalog, BlueprintUpdater, BumpStrategy, BumpStrategySchema, CalendarAttendee, CalendarEvent, CalendarEventInput, CalendarEventUpdateInput, CalendarListEventsQuery, CalendarListEventsResult, CalendarProvider, CalendarReminder, CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, CapturePaymentInput, ChangeEntry, ChangeType, ChangelogDocBlock, ChangelogEntry, ChangelogFormat, ChangelogFormatSchema, ChangelogJsonExport, ChangelogResult, ChangelogTier, ChangelogTierSchema, Channel, CheckboxFieldSpec, CompensationStep, CompensationStrategy, CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, CompleteOnboardingBaseSpec, ComponentMap, ComponentVariantDefinition, ComponentVariantSpec, ComposeOptions, ComputationMap, ConnectionStatus, ConsentDefinition, ConstraintDecl, ConstraintHandler, ContractRegistryFile, ContractRegistryFileSchema, ContractRegistryItem, ContractRegistryItemParsed, ContractRegistryItemSchema, ContractRegistryItemType, ContractRegistryItemTypeSchema, ContractRegistryManifest, ContractRegistryManifestParsed, ContractRegistryManifestSchema, ContractSpecType, ContractsrcConfig, ContractsrcFileConfig, ContractsrcSchema, CoverageRequirement, CreateCustomerInput, CreateIntegrationConnection, CreateKnowledgeSource, CreatePaymentIntentInput, CreateRendererOptions, CrossValidationContext, DEFAULT_CONTRACTSRC, DataMigrationStep, DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewRef, DataViewRegistry, DataViewSections, DataViewSource, DataViewSpec, DataViewStates, DataViewTableColumn, DataViewTableConfig, DecisionContext, DeleteIntegrationConnection, DeleteKnowledgeSource, DeleteObjectInput, DeleteOnboardingDraftBaseSpec, DeleteOnboardingDraftOutput, DocBlock, DocBlockLink, DocId, DocKind, DocPresentationOptions, DocPresentationRoute, DocRegistry, DocVisibility, DriverSlots, EmailAddress, EmailAttachment, EmailInboundProvider, EmailMessage, EmailMessagesSinceQuery, EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult, EmailThread, EmailThreadListQuery, EmbeddingDocument, EmbeddingProvider, EmbeddingResult, EmbeddingVector, EmitDecl, EmitDeclInline, EmitDeclRef, EnhanceFields, ErrorSignal, ErrorSignalEnvelope, ErrorSignalProvider, EventEnvelope, EventKey, EventParam, EventPublisher, EventRef, EventRegistry, EventSpec, EventSpecMeta, ExampleDocumentation, ExampleDocumentationSchema, ExampleEntrypoints, ExampleEntrypointsSchema, ExampleKind, ExampleKindEnum, ExampleKindSchema, ExampleMcpSupport, ExampleMeta, ExampleMetaSchema, ExampleRegistry, ExampleSandboxMode, ExampleSandboxModeEnum, ExampleSandboxModeSchema, ExampleSandboxSupport, ExampleSpec, ExampleSpecSchema, ExampleStudioSupport, ExampleSurfaces, ExampleSurfacesSchema, ExampleValidationError, ExampleValidationWarning, ExampleVisibility, ExampleVisibilityEnum, ExampleVisibilitySchema, ExecutionStatus, ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, ExperimentContext, ExperimentEvaluation, ExperimentEvaluator, ExperimentEvaluatorConfig, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, ExportableItem, ExpressionContext, FeatureExportOptions, FeatureExportResult, FeatureFlagState, FeatureLookup, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FeatureRegistry, FieldLevelDecision, FieldPolicyRule, FieldSpec, FileStateStoreOptions, FilterableItem, Fixture, FolderConventions, FolderConventionsSchema, FormAction, FormOption, FormRef, FormRegistry, FormSpec, FormValuesFor, FormatterConfig, FormatterConfigSchema, FormatterType, FormatterTypeSchema, GetObjectResult, GetOnboardingDraftBaseSpec, GetOnboardingDraftOutput, GroupFieldSpec, GroupKeyFn, GroupedItems, GroupingStrategies, GuardCondition, GuardConditionKind, GuardContext, GuardEvaluator, HandlerCtx, HandlerForOperationSpec, ImplementationPlan, ImplementationRef, ImplementationType, InMemoryStateStore, InstallFeatureDeps, IntegrationByokSetup, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationHealthCheck, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, IntegrationUsageMetrics, JsonSchema, KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, LLMChatOptions, LLMContentPart, LLMExportFormat, LLMMessage, LLMProvider, LLMResponse, LLMRole, LLMStreamChunk, LLMTextPart, LLMTokenUsage, LLMToolCallPart, LLMToolDefinition, LLMToolResultPart, ListIntegrationConnections, ListInvoicesQuery, ListKnowledgeSources, ListObjectsQuery, ListObjectsResult, ListTransactionsQuery, Locale, MessageKey, MetricAggregation, MigrationCheck, MigrationExecutor, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, MissingReference, ModelRegistry, Money, OPAAdapterOptions, OPAClient, OPAEvaluationResult, OPAPolicyAdapter, OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, ObjectStorageProvider, OpKind, OpRef, OpenApiConfig, OpenApiConfigSchema, OpenApiDocument, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiExportOptions, OpenApiServer, OpenApiSourceConfig, OpenApiSourceConfigSchema, OpenBankingAccountBalance, OpenBankingAccountDetails, OpenBankingAccountOwnership, OpenBankingAccountSummary, OpenBankingBalanceType, OpenBankingConnectionStatus, OpenBankingFeature, OpenBankingGetAccount, OpenBankingGetAccountDetailsParams, OpenBankingGetBalances, OpenBankingGetBalancesParams, OpenBankingGetConnectionStatusParams, OpenBankingGuardResult, OpenBankingListAccounts, OpenBankingListAccountsParams, OpenBankingListAccountsResult, OpenBankingListTransactions, OpenBankingListTransactionsParams, OpenBankingListTransactionsResult, OpenBankingProvider, OpenBankingRefreshBalances, OpenBankingSyncAccounts, OpenBankingSyncTransactions, OpenBankingTelemetryEvent, OpenBankingTransaction, OperationExecutor, OperationExecutorContext, OperationKey, OperationSpec, OperationSpecInput, OperationSpecMeta, OperationSpecOutput, OperationSpecRegistry, OperationTargetRef, OptionsSource, Owner, OwnerShipMeta, Owners, OwnersEnum, PIIPolicy, PaymentCustomer, PaymentIntent, PaymentIntentStatus, PaymentInvoice, PaymentRefund, PaymentTransaction, PaymentsProvider, PlatformTranslationCatalog, PolicyCondition, PolicyDecider, PolicyDeciderInput, PolicyDecision, PolicyEffect, PolicyEngine, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRegistry, PolicyRule, PolicySpec, Predicate, PredicateOp, PresentationRef, PresentationRegistry, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationSpec, PresentationSpecMeta, PresentationTarget, PresentationValidator, PrismaStateStore, PromptArg, PromptContentPart, PromptMeta, PromptPolicy, PromptRegistry, PromptSpec, PromptStability, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, ProposalSink, ProposalTarget, PutObjectInput, RadioFieldSpec, RateLimitDefinition, RateLimiter, ReactRenderDescriptor, RefundPaymentInput, RegenerationContext, RegenerationRule, RegenerationTrigger, RegeneratorOptions, RegeneratorService, RegeneratorSignal, RegistryFilter, RelationshipDefinition, RelationshipMatcher, RenderContext, RenderOptions, ResolveAppConfigDeps, ResolvedAppConfig, ResolvedContractsrcConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, ResolverMap, ResourceContext, ResourceMatcher, ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, RestOptions, RetryPolicy, RnReusablesDriver, RuleSyncConfig, RuleSyncConfigSchema, RuleSyncTarget, RuleSyncTargetSchema, RunMigrationsAction, RunTestsAction, RuntimeContract, RuntimeSpecOutput, RuntimeTelemetryProvider, SLA, SaveOnboardingDraftBaseSpec, SaveOnboardingDraftInput, SaveOnboardingDraftOutput, ScenarioRunResult, SchemaFormat, SchemaFormatSchema, SchemaMarkdownOptions, SchemaMigrationStep, SelectFieldSpec, SemanticVersion, SendSmsInput, ShadcnDriver, SignalAdapters, SignedUrlOptions, SmsDeliveryStatus, SmsMessage, SmsProvider, SpecChangeProposal, SpecExportOptions, SpecExportResult, SpecLookup, SpecPointer, SpecVariantResolver, Stability, StabilityEnum, StateStore, Step, StepAction, StepExecution, StepType, StorageObjectBody, StorageObjectMetadata, SubjectContext, SubjectMatcher, SubjectRelationship, SuccessMetric, SwitchFieldSpec, Tag, Tags, TagsEnum, TargetingRule, TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions, TelemetryAnomalyThreshold, TelemetryBinding, TelemetryConfig, TelemetryDispatch, TelemetryEventContext, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySignal, TelemetrySignalEnvelope, TelemetrySignalProvider, TelemetrySpec, TelemetryTracker, TelemetryTrackerOptions, TelemetryTrigger, TenantAppConfig, TenantAppConfigMeta, TenantConfigUpdater, TenantRouteOverride, TenantSpecOverride, TenantTranslationOverride, TestExecutor, TestIntegrationConnection, TestRegistry, TestRunResult, TestRunner, TestRunnerConfig, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, TextFieldSpec, TextareaFieldSpec, ThemeMeta, ThemeOverride, ThemeRef, ThemeRegistry, ThemeScope, ThemeSpec, ThemeToken, ThemeTokens, TokenCountResult, TransformEngine, Transition, TranslationCatalogMeta, TranslationCatalogPointer, TranslationEntry, TranslationResolver, TriggerKnowledgeSourceSync, TriggerRegenerationAction, TypedOptionsSource, TypedPredicate, TypedWhenClause, UpdateBlueprintAction, UpdateIntegrationConnection, UpdateKnowledgeSource, UpdateTenantConfigAction, ValidateExampleResult, ValidateExamplesResult, ValidateWorkflowSpecOptions, ValidationContext, ValidationIssue, ValidationMigrationStep, ValidationResult, ValidationSeverity, VectorDeleteRequest, VectorDocument, VectorSearchQuery, VectorSearchResult, VectorStoreProvider, VectorUpsertRequest, VerificationIssue, VerificationReport, VerificationTier, VersionAnalysis, VersionAnalysisResult, VersionBumpType, VersioningConfig, VersioningConfigSchema, Voice, VoiceProvider, VoiceSynthesisInput, VoiceSynthesisResult, WhenClause, WorkflowDefinition, WorkflowMeta, WorkflowPreFlightError, WorkflowPreFlightIssue, WorkflowPreFlightIssueSeverity, WorkflowPreFlightIssueType, WorkflowPreFlightResult, WorkflowRegistry, WorkflowRunner, WorkflowRunnerConfig, WorkflowSpec, WorkflowState, WorkflowStateFilters, WorkflowStatus, WorkflowTargetRef, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, ZodOperationSpecInput, assertPrimaryOpenBankingReady, assertWorkflowSpecValid, behaviorToEnvelope, buildOPAInput, buildZodWithRelations, bumpVersion, capabilityKey, compareVersions, composeAppConfig, createDefaultIntegrationSpecRegistry, createDefaultTransformEngine, createEngineWithDefaults, createFeatureModule, createFetchHandler, createFileStateStore, createFormRenderer, createMcpServer, dataViewKey, defaultDocRegistry, defaultGqlField, defaultMcpPrompt, defaultMcpTool, defaultRestPath, defineAppConfig, defineCapability, defineCommand, defineDataView, defineEvent, defineExample, defineFeature, defineFormSpec, defineIntegration, definePresentation, definePrompt, defineQuery, defineResourceTemplate, defineSchemaModel, defineTestSpec, defineWorkflow, determineBumpType, docBlockToMarkdown, docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, elevenLabsIntegrationSpec, elysiaPlugin, emailThreadsKnowledgeSpace, ensurePrimaryOpenBankingIntegration, errorToEnvelope, evalPredicate, evaluateExpression, eventKey, eventToMarkdown, exportFeature, exportSpec, expressRouter, featureToMarkdown, filterBy, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, formatPlanForAgent, formatVersion, gcsStorageIntegrationSpec, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt, getBumpTypePriority, getMaxBumpType, getUniqueDomains, getUniqueOwners, getUniqueTags, gmailIntegrationSpec, googleCalendarIntegrationSpec, groupBy, groupByMultiple, groupByToArray, installFeature, installOp, integrationContracts, isChangeType, isChangelogDocBlock, isEmitDeclRef, isExampleKind, isExampleVisibility, isFeatureRef, isResourceRef, isSpecPointer, isValidVersion, isVersionBumpType, isVersionEqual, isVersionGreater, isVersionLess, jsonSchemaForSpec, knowledgeContracts, listRegisteredDocBlocks, makeAppBlueprintKey, makeEmit, makeExperimentKey, makeIntegrationSpecKey, makeKnowledgeSpaceKey, makeNextAppHandler, makeNextPagesHandler, makeTelemetryKey, makeTestKey, makeThemeRef, mapDocRoutes, metaDocs, mistralIntegrationSpec, op, opKey, openApiForRegistry, openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, operationSpecToAgentPrompt, operationSpecToContextMarkdown, operationSpecToFullMarkdown, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, parseVersion, parseVersionStrict, postmarkIntegrationSpec, powensIntegrationSpec, presentationToMarkdown, productCanonKnowledgeSpace, qdrantIntegrationSpec, redactOpenBankingTelemetryPayload, registerBasicValidation, registerContractsOnBuilder, registerDefaultReactRenderer, registerDocBlocks, registerElevenLabsIntegration, registerEmailThreadsKnowledgeSpace, registerFeature, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerGcsStorageIntegration, registerGmailIntegration, registerGoogleCalendarIntegration, registerIntegrationContracts, registerKnowledgeContracts, registerMistralIntegration, registerOpenBankingCapabilities, registerOpenBankingContracts, registerPostmarkIntegration, registerPowensIntegration, registerProductCanonKnowledgeSpace, registerQdrantIntegration, registerReactToMarkdownRenderer, registerStripeIntegration, registerSupportFaqKnowledgeSpace, registerTwilioSmsIntegration, registerUploadedDocsKnowledgeSpace, renderFeaturePresentation, resolveAppConfig, resourceRef, rnReusablesDriver, safeParseExampleSpec, sanitizeMcpName, schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable, shadcnDriver, stripeIntegrationSpec, supportFaqKnowledgeSpace, techContractsDocs, telemetryToEnvelope, twilioSmsIntegrationSpec, uploadedDocsKnowledgeSpace, validateBlueprint, validateConfig, validateExample, validateExampleReferences, validateExamples, validateFeatureTargetsV2, validateResolvedConfig, validateTenantConfig, validateVersion, validateWorkflowSpec };