@lssm/lib.contracts 1.11.1 → 1.41.1

package/dist/docs/tech/telemetry-ingest.docblock.js

@@ -0,0 +1,122 @@
+import{registerDocBlocks as e}from"../registry.js";const t=[{id:`docs.tech.telemetry.ingest`,title:`Telemetry Ingest Endpoint`,summary:`Server-side telemetry ingestion for ContractSpec clients (VS Code extension, CLI, etc.).`,kind:`reference`,visibility:`internal`,route:`/docs/tech/telemetry/ingest`,tags:[`telemetry`,`api`,`posthog`,`analytics`],body:`# Telemetry Ingest Endpoint
+
+The ContractSpec API provides a telemetry ingest endpoint for clients to send product analytics events.
+
+## Endpoint
+
+\`\`\`
+POST /api/telemetry/ingest
+\`\`\`
+
+## Request
+
+\`\`\`json
+{
+  "event": "contractspec.vscode.command_run",
+  "distinct_id": "client-uuid",
+  "properties": {
+    "command": "validate"
+  },
+  "timestamp": "2024-01-15T10:30:00.000Z"
+}
+\`\`\`
+
+### Headers
+
+| Header | Description |
+|--------|-------------|
+| \`x-contractspec-client-id\` | Optional client identifier (used as fallback for distinct_id) |
+| \`Content-Type\` | Must be \`application/json\` |
+
+### Body
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| \`event\` | string | Yes | Event name (e.g., \`contractspec.vscode.activated\`) |
+| \`distinct_id\` | string | Yes | Anonymous client identifier |
+| \`properties\` | object | No | Event properties |
+| \`timestamp\` | string | No | ISO 8601 timestamp |
+
+## Response
+
+\`\`\`json
+{
+  "success": true
+}
+\`\`\`
+
+## Configuration
+
+The endpoint requires \`POSTHOG_PROJECT_KEY\` environment variable to be set. If not configured, events are accepted but not forwarded.
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| \`POSTHOG_HOST\` | PostHog host URL | \`https://eu.posthog.com\` |
+| \`POSTHOG_PROJECT_KEY\` | PostHog project API key | (required) |
+
+## Privacy
+
+- No PII is collected or stored
+- \`distinct_id\` is an anonymous client-generated UUID
+- File paths and source code are never included in events
+- Respects VS Code telemetry settings on the client side
+
+## Events
+
+### Extension Events
+
+| Event | Description | Properties |
+|-------|-------------|------------|
+| \`contractspec.vscode.activated\` | Extension activated | \`version\` |
+| \`contractspec.vscode.command_run\` | Command executed | \`command\` |
+| \`contractspec.vscode.mcp_call\` | MCP call made | \`endpoint\`, \`tool\` |
+
+### API Events
+
+| Event | Description | Properties |
+|-------|-------------|------------|
+| \`contractspec.api.mcp_request\` | MCP request processed | \`endpoint\`, \`method\`, \`success\`, \`duration_ms\` |
+`},{id:`docs.tech.telemetry.hybrid`,title:`Hybrid Telemetry Model`,summary:`How ContractSpec clients choose between direct PostHog and API-routed telemetry.`,kind:`usage`,visibility:`internal`,route:`/docs/tech/telemetry/hybrid`,tags:[`telemetry`,`architecture`,`posthog`],body:`# Hybrid Telemetry Model
+
+ContractSpec uses a hybrid telemetry model where clients can send events either directly to PostHog or via the API server.
+
+## Decision Flow
+
+\`\`\`
+Is contractspec.api.baseUrl configured?
+├── Yes → Send via /api/telemetry/ingest
+└── No → Is posthogProjectKey configured?
+    ├── Yes → Send directly to PostHog
+    └── No → Telemetry disabled
+\`\`\`
+
+## Benefits
+
+### Direct PostHog
+- No server dependency
+- Works offline (with batching)
+- Lower latency
+
+### Via API
+- Centralized key management (no client-side keys)
+- Server-side enrichment and validation
+- Rate limiting and abuse prevention
+- Easier migration to other providers
+
+## Recommendation
+
+- **Development**: Use direct PostHog with a dev project key
+- **Production**: Route via API for better governance
+
+## Future: OpenTelemetry
+
+The current PostHog implementation is behind a simple interface that can be swapped for OpenTelemetry:
+
+\`\`\`typescript
+interface TelemetryClient {
+  send(event: TelemetryEvent): Promise<void>;
+}
+\`\`\`
+
+This allows future migration without changing client code.
+`}];e(t);export{t as tech_telemetry_ingest_DocBlocks};

package/dist/docs/tech/templates/runtime.docblock.js

@@ -0,0 +1 @@
+import{registerDocBlocks as e}from"../../registry.js";const t=[{id:`docs.tech.templates.runtime`,title:`ContractSpec Template Runtime (Phase 9)`,summary:`Phase 9 introduces a full local-first runtime for templates so anyone can preview apps directly in the browser without provisioning any infrastructure.`,kind:`reference`,visibility:`public`,route:`/docs/tech/templates/runtime`,tags:[`tech`,`templates`,`runtime`],body:"## ContractSpec Template Runtime (Phase 9)\n\nPhase 9 introduces a full local-first runtime for templates so anyone can preview apps directly in the browser without provisioning any infrastructure.\n\n### Building Blocks\n\n- **Local database** – `@lssm/lib.runtime-local` wraps `sql.js` (SQLite WASM) and `IndexedDB` so we can seed demo data, run migrations, and persist state between sessions. Tests point the runtime to `node_modules/sql.js/dist` so CI doesn’t need a browser.\n- **Local GraphQL** – `LocalGraphQLClient` wires Apollo Client + SchemaLink to resolvers for tasks, messaging, and i18n recipes. All `/templates`, `/studio`, and `/sandbox` previews use those resolvers so we never call remote APIs during demos.\n- **Template registry + installer** – `.../templates/registry.ts` stores the catalog (todos, messaging, recipes). `TemplateInstaller` can seed the runtime (`install`) or export a base64 snapshot via the new `saveTemplateToStudio` mutation.\n- **TemplateShell** – Shared UI wrapper that creates a `TemplateRuntimeProvider`, shows `LocalDataIndicator`, and (optionally) surfaces the new `SaveToStudioButton`.\n\n### Runtime Flows\n\n1. `/templates` now opens a modal that renders `TemplateShell` for each template. Users can explore without leaving the marketing site.\n2. `/studio` switches to a tabbed mini-app (Projects, Canvas, Specs, Deploy) to showcase Studio surfaces with mock data. Visitors see a **preview** shell, while authenticated users (Better Auth via Sigil) unlock full persistence, versioning, and deployment controls.\n3. `/sandbox` lets visitors pick a template and mode (Playground, Spec Editor, Visual Builder). The console at the bottom streams runtime events for transparency.\n\n### GraphQL Mutations\n\n- `saveTemplateToStudio(input: SaveTemplateInput!): SaveTemplateResult!` writes a placeholder project + spec so that templates installed from the sandbox appear in Studio. The mutation is intentionally simple right now: it records which template was imported, stores metadata, and returns `{ projectId, status: 'QUEUED' }` for the UI.\n- `saveCanvasDraft(input: SaveCanvasDraftInput!): CanvasVersion!` snapshots the current Visual Builder nodes to a draft version tied to a canvas overlay. Inputs include `canvasId`, arbitrary `nodes` JSON, and an optional `label`. The resolver enforces org/org access before calling `CanvasVersionManager`.\n- `deployCanvasVersion(input: DeployCanvasVersionInput!): CanvasVersion!` promotes a previously saved draft (`versionId`) to the deployed state. The returned object includes `status`, `nodes`, `createdAt`, and `createdBy` for UI timelines.\n- `undoCanvasVersion(input: UndoCanvasInput!): CanvasVersion` rewinds the visual builder to the prior snapshot (returns `null` when history is empty) so Studio’s toolbar can surface “Undo” without shelling out to local storage.\n\n### Studio GraphQL endpoint\n\n- The landing app exposes the Studio schema at `/api/studio/graphql` via Yoga so React Query hooks (`useStudioProjects`, `useCreateStudioProject`, `useDeployStudioProject`, etc.) can talk to the bundle without spinning up a separate server.\n\n### Spec Editor typing\n\n- Studio’s spec editor now preloads Monaco with ambient declarations for `@lssm/lib.contracts` and `zod`, so snippets receive autocomplete and inline errors even before the spec ships to the backend. The helper lives in `presentation/components/studio/organisms/monaco-spec-types.ts` and registers the extra libs once per browser session via `monaco.languages.typescript.typescriptDefaults.addExtraLib`.\n- Compiler options are aligned with our frontend toolchain (ES2020 + React JSX) which means drafts written in the editor behave like the compiled artifacts that flow through Studio pipelines.\n\n### Spec templates\n\n- Selecting a spec type now injects a ready-to-edit scaffold (capability, workflow, policy, dataview, component) so authors start from a canonical layout instead of a blank file. Templates live alongside `SpecEditor.tsx`, and we only overwrite the content when the previous value is empty or when the author explicitly switches types via the dropdown.\n\n### Spec preview\n\n- The validation side panel now embeds a `SpecPreview` widget that shows validation errors alongside transport artifacts (GraphQL schema, REST endpoints, component summaries) once a preview run completes. Tabs let authors toggle between “Validation” and “Artifacts,” mirroring the UX described in the Studio plan.\n\n### Testing\n\n- `src/templates/__tests__/runtime.test.ts` covers todos CRUD, messaging delivery, and recipe locale switching through the local GraphQL API.\n- Studio infrastructure tests live in `src/__tests__/e2e/project-lifecycle.test.ts` and continue to exercise project creation + deploy flows.\n\n### Next Steps\n\nFuture templates can register their React components via `registerTemplateComponents(templateId, components)` so TemplateShell can render them automatically. When new templates are added, remember to:\n\n1. Update the registry entry (schema + tags).\n2. Register components inside `presentation/components/templates`.\n3. Document the template under `docs/templates/`.\n\n\n\n\n\n"}];e(t);export{t as tech_templates_runtime_DocBlocks};

package/dist/docs/tech/vscode-extension.docblock.js

@@ -0,0 +1,68 @@
+import{registerDocBlocks as e}from"../registry.js";const t=[{id:`docs.tech.vscode.extension`,title:`ContractSpec VS Code Extension`,summary:`VS Code extension for spec-first development with validation, scaffolding, and MCP integration.`,kind:`reference`,visibility:`public`,route:`/docs/tech/vscode/extension`,tags:[`vscode`,`extension`,`tooling`,`dx`],body:`# ContractSpec VS Code Extension
+
+The ContractSpec VS Code extension provides spec-first development tooling directly in your editor.
+
+## Features
+
+- **Real-time Validation**: Get instant feedback on spec errors and warnings as you save files
+- **Build/Scaffold**: Generate handler and component skeletons from specs (no AI required)
+- **Spec Explorer**: List and navigate all specs in your workspace
+- **Dependency Analysis**: Visualize spec dependencies and detect cycles
+- **MCP Integration**: Search ContractSpec documentation via Model Context Protocol
+- **Snippets**: Code snippets for common ContractSpec patterns
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| \`ContractSpec: Validate Current Spec\` | Validate the currently open spec file |
+| \`ContractSpec: Validate All Specs\` | Validate all spec files in the workspace |
+| \`ContractSpec: Build/Scaffold\` | Generate handler/component from the current spec |
+| \`ContractSpec: List All Specs\` | Show all specs in the workspace |
+| \`ContractSpec: Analyze Dependencies\` | Analyze and visualize spec dependencies |
+| \`ContractSpec: Search Docs (MCP)\` | Search documentation via MCP |
+
+## Configuration
+
+| Setting | Description | Default |
+|---------|-------------|---------|
+| \`contractspec.api.baseUrl\` | Base URL for ContractSpec API (enables MCP + remote telemetry) | \`""\` |
+| \`contractspec.telemetry.posthogHost\` | PostHog host URL for direct telemetry | \`"https://eu.posthog.com"\` |
+| \`contractspec.telemetry.posthogProjectKey\` | PostHog project key for direct telemetry | \`""\` |
+| \`contractspec.validation.onSave\` | Run validation on save | \`true\` |
+| \`contractspec.validation.onOpen\` | Run validation on open | \`true\` |
+
+## Architecture
+
+The extension uses:
+- \`@lssm/module.contractspec-workspace\` for pure analysis + templates
+- \`@lssm/bundle.contractspec-workspace\` for workspace services + adapters
+
+This allows the extension to work without requiring the CLI to be installed.
+
+## Telemetry
+
+The extension uses a hybrid telemetry approach:
+1. If \`contractspec.api.baseUrl\` is configured → send to API \`/api/telemetry/ingest\`
+2. Otherwise → send directly to PostHog (if project key configured)
+
+Telemetry respects VS Code's telemetry settings. No file paths, source code, or PII is collected.
+`},{id:`docs.tech.vscode.snippets`,title:`ContractSpec Snippets`,summary:`Code snippets for common ContractSpec patterns in VS Code.`,kind:`reference`,visibility:`public`,route:`/docs/tech/vscode/snippets`,tags:[`vscode`,`snippets`,`dx`],body:`# ContractSpec Snippets
+
+The VS Code extension includes snippets for common ContractSpec patterns.
+
+## Available Snippets
+
+| Prefix | Description |
+|--------|-------------|
+| \`contractspec-command\` | Create a new command (write operation) |
+| \`contractspec-query\` | Create a new query (read-only operation) |
+| \`contractspec-event\` | Create a new event |
+| \`contractspec-docblock\` | Create a new DocBlock |
+| \`contractspec-telemetry\` | Create a new TelemetrySpec |
+| \`contractspec-presentation\` | Create a new Presentation |
+
+## Usage
+
+Type the prefix in a TypeScript file and press Tab to expand the snippet. Tab through the placeholders to fill in your values.
+`}];e(t);export{t as tech_vscode_extension_DocBlocks};

package/dist/docs/tech/workflows/overview.docblock.js

@@ -0,0 +1 @@
+import{registerDocBlocks as e}from"../../registry.js";const t=[{id:`docs.tech.workflows.overview`,title:`WorkflowSpec Overview`,summary:"WorkflowSpec provides a declarative, versioned format for long-running flows that mix automation and human review. Specs stay inside `@lssm/lib.contracts` (`src/workflow/spec.ts`) so the same definition powers runtime execution, documentation, and future generation.",kind:`reference`,visibility:`public`,route:`/docs/tech/workflows/overview`,tags:[`tech`,`workflows`,`overview`],body:"# WorkflowSpec Overview\n\n## Purpose\n\nWorkflowSpec provides a declarative, versioned format for long-running flows that mix automation and human review. Specs stay inside `@lssm/lib.contracts` (`src/workflow/spec.ts`) so the same definition powers runtime execution, documentation, and future generation.\n\n## Core Types\n\n- `WorkflowMeta`: ownership metadata (`title`, `domain`, `owners`, `tags`, `stability`) plus `name` and `version`.\n- `WorkflowDefinition`:\n  - `entryStepId?`: optional explicit entry point (defaults to first step).\n  - `steps[]`: ordered list of `Step` descriptors.\n  - `transitions[]`: directed edges between steps with optional expressions.\n  - `sla?`: aggregated timing hints for the overall flow or per-step budgets.\n  - `compensation?`: fallback operations executed when a workflow is rolled back or fails.\n- `Step`:\n  - `type`: `human`, `automation`, or `decision`.\n  - `action`: references either a `ContractSpec` (`operation`) or `FormSpec` (`form`).\n  - Optional `guard`, `timeoutMs`, and retry policy (`maxAttempts`, `backoff`, `delayMs`, `maxDelayMs?`).\n  - `requiredIntegrations?`: integration slot ids that must be bound before the step may execute.\n  - `requiredCapabilities?`: `CapabilityRef[]` that must be enabled in the resolved app config.\n- `Transition`: `from` → `to` with optional `condition` string (simple data expressions).\n\n## Registry & Validation\n\n- `WorkflowRegistry` (`src/workflow/spec.ts`) stores specs by key `<name>.v<version>` and exposes `register`, `list`, and `get`.\n- `validateWorkflowSpec()` (`src/workflow/validation.ts`) checks:\n  - Duplicate step IDs.\n  - Unknown `from`/`to` transitions.\n  - Empty guards/conditions.\n  - Reachability from the entry step.\n  - Cycles in the graph.\n  - Operation/Form references against provided registries.\n- `assertWorkflowSpecValid()` wraps validation and throws `WorkflowValidationError` when errors remain.\n\n## Runtime\n\n- `WorkflowRunner` (`src/workflow/runner.ts`) executes workflows and coordinates steps.\n  - `start(name, version?, initialData?)` returns a `workflowId`.\n  - `executeStep(workflowId, input?)` runs the current step (automation or human).\n  - `getState(workflowId)` retrieves the latest state snapshot.\n  - `cancel(workflowId)` marks the workflow as cancelled.\n  - `preFlightCheck(name, version?, resolvedConfig?)` evaluates integration/capability requirements before the workflow starts.\n  - Throws `WorkflowPreFlightError` if required integration slots are unbound or required capabilities are disabled.\n- `StateStore` (`src/workflow/state.ts`) abstracts persistence. V1 ships with:\n  - `InMemoryStateStore` (`src/workflow/adapters/memory-store.ts`) for tests/dev.\n  - Placeholder factories for file/database adapters (`adapters/file-adapter.ts`, `adapters/db-adapter.ts`).\n- Guard evaluation: expression guards run through `evaluateExpression()` (`src/workflow/expression.ts`); custom policy guards can be provided via `guardEvaluator`.\n- Events: the runner emits `workflow.started`, `workflow.step_completed`, `workflow.step_failed`, and `workflow.cancelled` through the optional `eventEmitter`.\n- React bindings (`@lssm/lib.presentation-runtime-react`):\n  - `useWorkflow` hook (polls state, exposes `executeStep`, `cancel`, `refresh`).\n  - `WorkflowStepper` progress indicator using design-system Stepper.\n  - `WorkflowStepRenderer` helper to render human/automation/decision steps with sensible fallbacks.\n\n## Authoring Checklist\n\n1. Reuse existing operations/forms; create new specs when missing.\n2. Prefer explicit `entryStepId` for clarity (especially with decision branches).\n3. Give automation steps an `operation` and human steps a `form` (warnings surface otherwise).\n4. Use short, meaningful step IDs (`submit`, `review`, `finalize`) to simplify analytics.\n5. Keep guard expressions deterministic; complex policy logic should move to PolicySpec (Phase 2).\n\n## Testing\n\n- Add unit tests for new workflows via `assertWorkflowSpecValid`.\n- Use the new Vitest suites (`validation.test.ts`, `expression.test.ts`, `runner.test.ts`) as examples.\n- CLI support will arrive in Phase 1 PR 3 (`contractspec create --type workflow`).\n\n## Tooling\n\n- `contractspec create --type workflow` scaffolds a WorkflowSpec with interactive prompts.\n- `contractspec build <spec.workflow.ts>` generates a runner scaffold (`.runner.ts`) wired to `WorkflowRunner` and the in-memory store.\n- `contractspec validate` understands `.workflow.ts` files and checks core structure (meta, steps, transitions).\n\n## Next Steps (Non-MVP)\n\n- Persistence adapters (database/file) for workflow state (Phase 2).\n- React bindings (`useWorkflow`, `WorkflowStepper`) and presentation-runtime integration (PR 3).\n- Policy engine integration (`guard.type === 'policy'` validated against PolicySpec).\n- Telemetry hooks for step execution metrics.\n\n"}];e(t);export{t as tech_workflows_overview_DocBlocks};

package/dist/docs/tech-contracts.docs.js

@@ -0,0 +1,76 @@
+const e=[{id:`docs.tech.contracts.presentations-v2`,title:`Presentations V2 — Unified Descriptor & Transform Engine`,summary:`How PresentationDescriptorV2 and TransformEngine keep docs/renderers consistent.`,visibility:`public`,route:`/docs/tech/contracts/presentations-v2`,kind:`reference`,tags:[`presentations`,`docs`,`mcp`],body:`## Presentations V2 — Unified Descriptor & Transform Engine
+
+### Purpose
+
+Unify presentations into one descriptor (\`PresentationDescriptorV2\`) that declares a single source (React component key or BlockNote doc) and a list of output targets (react, markdown, application/json, application/xml). A pluggable \`TransformEngine\` renders any target and applies PII redaction.
+
+### Types
+
+\`\`\`ts
+type PresentationTarget =
+  | 'react'
+  | 'markdown'
+  | 'application/json'
+  | 'application/xml';
+
+type PresentationSource =
+  | {
+      type: 'component';
+      framework: 'react';
+      componentKey: string;
+      props?: AnySchemaModel;
+    }
+  | { type: 'blocknotejs'; docJson: unknown; blockConfig?: unknown };
+
+interface PresentationDescriptorV2 {
+  meta: PresentationV2Meta; // includes partial OwnerShipMeta + description
+  policy?: { flags?: string[]; pii?: string[] };
+  source: PresentationSource;
+  targets: PresentationTarget[];
+}
+
+// Shared ownership schema (source of truth in @lssm/lib.contracts/src/ownership.ts)
+interface OwnerShipMeta {
+  title: string;
+  description: string;
+  domain: string;
+  owners: Owner[];
+  tags: Tag[];
+  stability: Stability;
+}
+
+type Stability = 'experimental' | 'beta' | 'stable' | 'deprecated';
+type Owner = string; // curated list available in code (e.g., '@sigil-team', 'team-strit')
+type Tag = string; // curated list available in code (e.g., 'auth', 'spots')
+
+// For V2 presentations, meta is a Partial<OwnerShipMeta> plus description, name, version
+interface PresentationV2Meta extends Partial<OwnerShipMeta> {
+  name: string;
+  version: number;
+  description?: string;
+}
+\`\`\`
+
+### Engine
+
+Use \`createDefaultTransformEngine()\` and register custom renderers as needed (e.g., high-fidelity BlockNote → Markdown). The default engine supports markdown/json/xml; a React renderer returns a serializable descriptor the host app renders via a \`componentMap\` or a BlockNote renderer. The canonical source type string is \`blocknotejs\` (not \`blocknote\`).
+
+PII paths (JSON-like) are redacted from rendered outputs.
+
+### MCP Integration
+
+\`createMcpServer\` accepts \`presentationsV2\`. Each descriptor is exposed under \`presentation://<name>/v<version>\` and negotiated variants (\`.md/.json/.xml\`) are rendered by the engine.
+
+### Migration
+
+- V1 \`PresentationSpec\` remains supported; a back-compat helper converts V1 → V2 when convenient.
+- Prefer V2 for new work.
+
+### Examples (Sigil)
+
+- \`sigil.auth.webauth_tabs_v2\`: component source (\`componentKey: 'sigil.webauth.tabs'\`), targets \`react/json/xml\`.
+- \`sigil.signup.guide_v2\`: BlockNote doc source, targets \`react/markdown/json/xml\`.
+
+### React Rendering
+
+Host apps use a \`componentMap\` (e.g., \`'sigil.webauth.tabs' → WebAuthTabs\`) and a BlockNote renderer to turn the React render descriptor into elements.`}];export{e as techContractsDocs};

package/dist/events.js

@@ -1 +1 @@
-import"./schema/dist/index.js";function e(e){return e}const t=(e,t)=>`${e}.v${t}`;export{e as defineEvent,t as eventKey};
+import"@lssm/lib.schema";function e(e){return e}const t=(e,t)=>`${e}.v${t}`;export{e as defineEvent,t as eventKey};

package/dist/experiments/docs/experiments.docblock.js

@@ -0,0 +1,128 @@
+import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.experiments`,title:`ExperimentSpec & ExperimentEvaluator`,summary:`Use experiments to test alternative workflows, data views, or themes with controlled allocations and measurable outcomes.`,kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/experiments`,tags:[`tech`,`contracts`,`experiments`],body:`# ExperimentSpec & ExperimentEvaluator
+
+Use experiments to test alternative workflows, data views, or themes with controlled allocations and measurable outcomes.
+
+- Types & registry: \`packages/libs/contracts/src/experiments/spec.ts\`
+- Runtime evaluator: \`packages/libs/contracts/src/experiments/evaluator.ts\`
+- CLI wizard/template: \`contractspec create experiment\`
+
+## Structure
+
+\`\`\`ts
+export interface ExperimentSpec {
+  meta: ExperimentMeta;
+  controlVariant: string;
+  variants: ExperimentVariant[];
+  allocation: AllocationStrategy;
+  successMetrics?: SuccessMetric[];
+}
+\`\`\`
+
+- \`variants\`: define UI/behavior overrides (data views, workflows, themes, policies)
+- \`allocation\`:
+  - \`random\`: 50/50 or weighted via \`weight\`
+  - \`sticky\`: deterministic hash on user/organization/session
+  - \`targeted\`: rule-based (policy + expression + optional percentage)
+- \`successMetrics\`: telemetry events + aggregation (count/avg/p95) to track outcomes
+
+### Example
+
+\`\`\`ts
+export const OnboardingSplitFormExperiment: ExperimentSpec = {
+  meta: {
+    name: 'sigil.onboarding.split_form',
+    version: 1,
+    title: 'Split onboarding form',
+    description: 'Compare single vs multi-step onboarding',
+    domain: 'onboarding',
+    owners: ['@team.onboarding'],
+    tags: ['experiment'],
+    stability: StabilityEnum.Experimental,
+  },
+  controlVariant: 'control',
+  variants: [
+    { id: 'control', name: 'Single-step form' },
+    {
+      id: 'multi_step',
+      name: 'Multi-step form',
+      overrides: [
+        { type: 'workflow', target: 'sigil.onboarding.workflow.multi_step' },
+      ],
+    },
+  ],
+  allocation: {
+    type: 'targeted',
+    rules: [
+      {
+        variantId: 'multi_step',
+        expression: "context.attributes?.segment === 'vip'",
+      },
+    ],
+    fallback: 'random',
+  },
+  successMetrics: [
+    {
+      name: 'Completion rate',
+      telemetryEvent: { name: 'sigil.telemetry.onboarding_completed', version: 1 },
+      aggregation: 'count',
+    },
+  ],
+};
+\`\`\`
+
+## Variant evaluation
+
+\`\`\`ts
+const evaluator = new ExperimentEvaluator({
+  registry: experimentRegistry,
+  policyChecker: (policyRef, context) =>
+    policyEngine.decide({
+      action: 'experiment_targeting',
+      subject: { roles: context.flags },
+      resource: { type: 'experiment', attributes: { name: context.experiment } },
+      policies: [policyRef],
+    }).effect === 'allow',
+});
+
+const assignment = await evaluator.chooseVariant({
+  experiment: 'sigil.onboarding.split_form',
+  userId: ctx.userId,
+  organizationId: ctx.organizationId,
+  attributes: ctx.attributes,
+});
+
+if (assignment) {
+  // Apply overrides for the chosen variant
+  applyExperimentOverrides(assignment.variant);
+}
+\`\`\`
+
+- \`random\` uses deterministic hashing (\`salt\` optional) for stable splits
+- \`sticky\` hashes a specified attribute (userId/orgId/sessionId)
+- \`targeted\` evaluates rules in order; each rule can reference a PolicySpec and simple JS expressions (\`context\` input)
+
+## Integrations
+
+- **Feature modules**: \`FeatureModuleSpec.experiments\` references experiments owned by a module
+- **DataViewSpec / WorkflowSpec**: \`experiments?: ExperimentRef[]\` indicate which experiments modify the spec
+- **Telemetry**: success metrics reference \`TelemetrySpec\` events to ensure compliant tracking
+- **Policy**: targeting rules call into \`PolicyEngine\` via the evaluator callback to respect privacy/security
+
+## CLI workflow
+
+\`\`\`
+contractspec create experiment
+\`\`\`
+
+- Prompts for control/variants, allocation strategy, targeting rules, success metrics
+- Outputs a typed \`ExperimentSpec\` file alongside your contracts
+
+## Best practices
+
+1. Keep experiments short-lived; increment \`meta.version\` when changing allocation or variants.
+2. Always declare a control variant and ensure overrides are reversible.
+3. Tie success metrics to privacy-reviewed telemetry events.
+4. Use targeting rules sparingly; combine with PolicySpec to avoid exposing experiments to unauthorized users.
+5. When an experiment wins, promote the variant to the canonical spec and retire the experiment.
+
+`}];e(t);export{t as tech_contracts_experiments_DocBlocks};

package/dist/forms/docs/forms.docblock.js

@@ -0,0 +1 @@
+import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.forms`,title:`Contracts: FormSpec`,summary:`This document defines the canonical contracts for declarative forms.`,kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/forms`,tags:[`tech`,`contracts`,`forms`],body:"# Contracts: FormSpec\n\nThis document defines the canonical contracts for declarative forms.\n\n## Overview\n\n- `FormSpec` (in `@lssm/lib.contracts/forms`) declares:\n  - `meta` (extends `OwnerShipMeta`) + `key`/`version` for stability.\n  - `model` (`@lssm/lib.schema` `SchemaModel`) as the single source of truth.\n  - `fields` built from `FieldSpec` kinds: `text`, `textarea`, `select`, `checkbox`, `radio`, `switch`, `group`, `array`.\n  - Optional `actions`, `policy.flags`, `constraints` and `renderHints`.\n- Relations DSL provides `visibleWhen`, `enabledWhen`, `requiredWhen` based on predicates.\n- `buildZodWithRelations(spec)` augments the base zod with conditional rules and constraints.\n- React adapter renders with React Hook Form + driver API for UI components (shadcn driver provided).\n\n## Driver API (UI-agnostic)\n\nHost apps supply a driver mapping slots → components:\n\n- Required: `Field`, `FieldLabel`, `FieldDescription`, `FieldError`, `Input`, `Textarea`, `Select`, `Checkbox`, `RadioGroup`, `Switch`, `Button`.\n- Optional: `FieldGroup`, `FieldSet`, `FieldLegend` and input group helpers.\n\nUse `createFormRenderer({ driver })` to obtain a `render(spec)` function.\n\n## Arrays and Groups\n\n- `array` items are rendered with `useFieldArray`, honoring `min`/`max` and add/remove controls.\n- `group` composes nested fields and provides optional legend/description.\n\n## Feature Flags\n\n- Declare `policy.flags` on forms to signal gating. Gate usage at host boundary; avoid scattering flags across individual fields.\n\n## Example\n\nSee `packages/hcircle/apps/web-coliving/src/forms/bug-report.spec.ts` for a concrete form spec and `components/forms/BugReportFormDemo.tsx` for rendering with a minimal shadcn driver mapping.\n"}];e(t);export{t as tech_contracts_forms_DocBlocks};

package/dist/index.js

@@ -1 +1 @@
-import{CapabilityRegistry as e,capabilityKey as t,defineCapability as n}from"./capabilities.js";import{DataViewRegistry as r,dataViewKey as i}from"./data-views.js";import{defineEvent as a,eventKey as o}from"./events.js";import{FeatureRegistry as s,installFeature as c,validateFeatureTargetsV2 as l}from"./features.js";import{FormRegistry as u,buildZodWithRelations as d,defineFormSpec as f,evalPredicate as p}from"./forms.js";import{TransformEngine as m,createDefaultTransformEngine as h,registerBasicValidation as g,registerDefaultReactRenderer as _}from"./presentations.v2.js";import{createEngineWithDefaults as v,createFeatureModule as y,registerFeature as b,renderFeaturePresentation as x}from"./client/react/feature-render.js";import{createFormRenderer as S}from"./client/react/form-render.js";import{shadcnDriver as C}from"./client/react/drivers/shadcn.js";import{rnReusablesDriver as w}from"./client/react/drivers/rn-reusables.js";import"./client/index.js";import{defaultGqlField as T,defaultMcpTool as E,defaultRestPath as D,jsonSchemaForSpec as O}from"./jsonschema.js";import{registerContractsOnBuilder as k}from"./server/graphql-pothos.js";import{exportContractsToGraphQLSchema as A}from"./server/graphql-schema-export.js";import{PresentationRegistry as j,jsonSchemaForPresentation as M}from"./presentations.js";import{createMcpServer as N}from"./server/provider-mcp.js";import{createFetchHandler as P}from"./server/rest-generic.js";import{elysiaPlugin as F}from"./server/rest-elysia.js";import{expressRouter as I}from"./server/rest-express.js";import{makeNextAppHandler as L}from"./server/rest-next-app.js";import{makeNextPagesHandler as R}from"./server/rest-next-pages.js";import"./server/index.js";import{defineCommand as z,defineQuery as B,isEmitDeclRef as V}from"./spec.js";import{SpecRegistry as H,opKey as U}from"./registry.js";import{installOp as W,makeEmit as G,op as K}from"./install.js";import{definePrompt as q}from"./prompt.js";import{PromptRegistry as J}from"./promptRegistry.js";import{ResourceRegistry as Y,defineResourceTemplate as X,isResourceRef as Z,resourceRef as Q}from"./resources.js";import{toV2FromV1 as $}from"./presentations.backcompat.js";import{Owners as ee,OwnersEnum as te,StabilityEnum as ne,Tags as re,TagsEnum as ie}from"./ownership.js";import{CompleteOnboardingBaseInput as ae,CompleteOnboardingBaseOutput as oe,CompleteOnboardingBaseSpec as se,DeleteOnboardingDraftBaseSpec as ce,DeleteOnboardingDraftOutput as le,GetOnboardingDraftBaseSpec as ue,GetOnboardingDraftOutput as de,SaveOnboardingDraftBaseSpec as fe,SaveOnboardingDraftInput as pe,SaveOnboardingDraftOutput as me}from"./onboarding-base.js";import{openBankingAccountsReadCapability as he,openBankingBalancesReadCapability as ge,openBankingTransactionsReadCapability as _e,registerOpenBankingCapabilities as ve}from"./capabilities/openbanking.js";import{PolicyRegistry as ye,makePolicyKey as be}from"./policy/spec.js";import{PolicyEngine as xe}from"./policy/engine.js";import{OPAPolicyAdapter as Se,buildOPAInput as Ce}from"./policy/opa-adapter.js";import{ThemeRegistry as we,makeThemeRef as Te}from"./themes.js";import{MigrationRegistry as Ee}from"./migrations.js";import{TelemetryRegistry as De,makeTelemetryKey as Oe}from"./telemetry/spec.js";import{TelemetryTracker as ke}from"./telemetry/tracker.js";import{TelemetryAnomalyMonitor as Ae}from"./telemetry/anomaly.js";import"./telemetry/index.js";import{TestRegistry as je,makeTestKey as Me}from"./tests/spec.js";import{TestRunner as Ne}from"./tests/runner.js";import"./tests/index.js";import{ExperimentRegistry as Pe,makeExperimentKey as Fe}from"./experiments/spec.js";import{ExperimentEvaluator as Ie}from"./experiments/evaluator.js";import{AppBlueprintRegistry as Le,makeAppBlueprintKey as Re}from"./app-config/spec.js";import{composeAppConfig as ze,resolveAppConfig as Be}from"./app-config/runtime.js";import{IntegrationSpecRegistry as Ve,makeIntegrationSpecKey as He}from"./integrations/spec.js";import{registerStripeIntegration as Ue,stripeIntegrationSpec as We}from"./integrations/providers/stripe.js";import{postmarkIntegrationSpec as Ge,registerPostmarkIntegration as Ke}from"./integrations/providers/postmark.js";import{qdrantIntegrationSpec as qe,registerQdrantIntegration as Je}from"./integrations/providers/qdrant.js";import{mistralIntegrationSpec as Ye,registerMistralIntegration as Xe}from"./integrations/providers/mistral.js";import{elevenLabsIntegrationSpec as Ze,registerElevenLabsIntegration as Qe}from"./integrations/providers/elevenlabs.js";import{gmailIntegrationSpec as $e,registerGmailIntegration as et}from"./integrations/providers/gmail.js";import{googleCalendarIntegrationSpec as tt,registerGoogleCalendarIntegration as nt}from"./integrations/providers/google-calendar.js";import{registerTwilioSmsIntegration as rt,twilioSmsIntegrationSpec as it}from"./integrations/providers/twilio-sms.js";import{gcsStorageIntegrationSpec as at,registerGcsStorageIntegration as ot}from"./integrations/providers/gcs-storage.js";import{powensIntegrationSpec as st,registerPowensIntegration as ct}from"./integrations/providers/powens.js";import{MistralLLMProvider as lt}from"./integrations/providers/impls/mistral-llm.js";import{MistralEmbeddingProvider as ut}from"./integrations/providers/impls/mistral-embedding.js";import{QdrantVectorProvider as dt}from"./integrations/providers/impls/qdrant-vector.js";import{GmailInboundProvider as ft}from"./integrations/providers/impls/gmail-inbound.js";import{GmailOutboundProvider as pt}from"./integrations/providers/impls/gmail-outbound.js";import{GoogleCalendarProvider as mt}from"./integrations/providers/impls/google-calendar.js";import{ElevenLabsVoiceProvider as ht}from"./integrations/providers/impls/elevenlabs-voice.js";import{GoogleCloudStorageProvider as gt}from"./integrations/providers/impls/gcs-storage.js";import{StripePaymentsProvider as _t}from"./integrations/providers/impls/stripe-payments.js";import{PostmarkEmailProvider as vt}from"./integrations/providers/impls/postmark-email.js";import{TwilioSmsProvider as yt}from"./integrations/providers/impls/twilio-sms.js";import{PowensClient as bt,PowensClientError as xt}from"./integrations/providers/impls/powens-client.js";import{PowensOpenBankingProvider as St}from"./integrations/providers/impls/powens-openbanking.js";import{IntegrationProviderFactory as Ct}from"./integrations/providers/impls/provider-factory.js";import{SecretProviderError as wt,normalizeSecretPayload as Tt,parseSecretUri as Et}from"./integrations/secrets/provider.js";import{GcpSecretManagerProvider as Dt}from"./integrations/secrets/gcp-secret-manager.js";import{EnvSecretProvider as Ot}from"./integrations/secrets/env-secret-provider.js";import{SecretProviderManager as kt}from"./integrations/secrets/manager.js";import{IntegrationCallGuard as At,connectionStatusLabel as jt,ensureConnectionReady as Mt}from"./integrations/runtime.js";import{IntegrationHealthService as Nt}from"./integrations/health.js";import{AccountBalanceRecord as Pt,BankAccountRecord as Ft,BankTransactionRecord as It}from"./integrations/openbanking/models.js";import{OPENBANKING_PII_FIELDS as Lt,OPENBANKING_TELEMETRY_EVENTS as Rt,redactOpenBankingTelemetryPayload as zt}from"./integrations/openbanking/telemetry.js";import{OpenBankingGetAccount as Bt,OpenBankingListAccounts as Vt,OpenBankingSyncAccounts as Ht}from"./integrations/openbanking/contracts/accounts.js";import{OpenBankingListTransactions as Ut,OpenBankingSyncTransactions as Wt}from"./integrations/openbanking/contracts/transactions.js";import{OpenBankingGetBalances as Gt,OpenBankingRefreshBalances as Kt}from"./integrations/openbanking/contracts/balances.js";import{registerOpenBankingContracts as qt}from"./integrations/openbanking/contracts/index.js";import{assertPrimaryOpenBankingReady as Jt,ensurePrimaryOpenBankingIntegration as Yt}from"./integrations/openbanking/guards.js";import"./integrations/index.js";import{KnowledgeSpaceRegistry as Xt,makeKnowledgeSpaceKey as Zt}from"./knowledge/spec.js";import{productCanonKnowledgeSpace as Qt,registerProductCanonKnowledgeSpace as $t}from"./knowledge/spaces/product-canon.js";import{registerSupportFaqKnowledgeSpace as en,supportFaqKnowledgeSpace as tn}from"./knowledge/spaces/support-faq.js";import{emailThreadsKnowledgeSpace as nn,registerEmailThreadsKnowledgeSpace as rn}from"./knowledge/spaces/email-threads.js";import{registerUploadedDocsKnowledgeSpace as an,uploadedDocsKnowledgeSpace as on}from"./knowledge/spaces/uploaded-docs.js";import{financialDocsKnowledgeSpace as sn,registerFinancialDocsKnowledgeSpace as cn}from"./knowledge/spaces/financial-docs.js";import{financialOverviewKnowledgeSpace as ln,registerFinancialOverviewKnowledgeSpace as un}from"./knowledge/spaces/financial-overview.js";import"./knowledge/index.js";import{CreateIntegrationConnection as dn,DeleteIntegrationConnection as fn,ListIntegrationConnections as pn,TestIntegrationConnection as mn,UpdateIntegrationConnection as hn,integrationContracts as gn,registerIntegrationContracts as _n}from"./integrations/contracts.js";import{CreateKnowledgeSource as vn,DeleteKnowledgeSource as yn,ListKnowledgeSources as bn,TriggerKnowledgeSourceSync as xn,UpdateKnowledgeSource as Sn,knowledgeContracts as Cn,registerKnowledgeContracts as wn}from"./knowledge/contracts.js";import{behaviorToEnvelope as Tn,errorToEnvelope as En,telemetryToEnvelope as Dn}from"./regenerator/utils.js";import{RegeneratorService as On}from"./regenerator/service.js";import{ProposalExecutor as kn}from"./regenerator/executor.js";import{ExecutorProposalSink as An}from"./regenerator/sinks.js";import"./regenerator/index.js";import{WorkflowRegistry as jn}from"./workflow/spec.js";import{WorkflowValidationError as Mn,assertWorkflowSpecValid as Nn,validateWorkflowSpec as Pn}from"./workflow/validation.js";import{evaluateExpression as Fn}from"./workflow/expression.js";import{WorkflowPreFlightError as In,WorkflowRunner as Ln}from"./workflow/runner.js";import{InMemoryStateStore as Rn}from"./workflow/adapters/memory-store.js";import{PrismaStateStore as zn}from"./workflow/adapters/db-adapter.js";import{createFileStateStore as Bn}from"./workflow/adapters/file-adapter.js";import"./workflow/index.js";export{Pt as AccountBalanceRecord,Le as AppBlueprintRegistry,Ft as BankAccountRecord,It as BankTransactionRecord,e as CapabilityRegistry,ae as CompleteOnboardingBaseInput,oe as CompleteOnboardingBaseOutput,se as CompleteOnboardingBaseSpec,dn as CreateIntegrationConnection,vn as CreateKnowledgeSource,r as DataViewRegistry,fn as DeleteIntegrationConnection,yn as DeleteKnowledgeSource,ce as DeleteOnboardingDraftBaseSpec,le as DeleteOnboardingDraftOutput,ht as ElevenLabsVoiceProvider,Ot as EnvSecretProvider,An as ExecutorProposalSink,Ie as ExperimentEvaluator,Pe as ExperimentRegistry,s as FeatureRegistry,u as FormRegistry,Dt as GcpSecretManagerProvider,ue as GetOnboardingDraftBaseSpec,de as GetOnboardingDraftOutput,ft as GmailInboundProvider,pt as GmailOutboundProvider,mt as GoogleCalendarProvider,gt as GoogleCloudStorageProvider,Rn as InMemoryStateStore,At as IntegrationCallGuard,Nt as IntegrationHealthService,Ct as IntegrationProviderFactory,Ve as IntegrationSpecRegistry,Xt as KnowledgeSpaceRegistry,pn as ListIntegrationConnections,bn as ListKnowledgeSources,Ee as MigrationRegistry,ut as MistralEmbeddingProvider,lt as MistralLLMProvider,Se as OPAPolicyAdapter,Lt as OPENBANKING_PII_FIELDS,Rt as OPENBANKING_TELEMETRY_EVENTS,Bt as OpenBankingGetAccount,Gt as OpenBankingGetBalances,Vt as OpenBankingListAccounts,Ut as OpenBankingListTransactions,Kt as OpenBankingRefreshBalances,Ht as OpenBankingSyncAccounts,Wt as OpenBankingSyncTransactions,ee as Owners,te as OwnersEnum,xe as PolicyEngine,ye as PolicyRegistry,vt as PostmarkEmailProvider,bt as PowensClient,xt as PowensClientError,St as PowensOpenBankingProvider,j as PresentationRegistry,zn as PrismaStateStore,J as PromptRegistry,kn as ProposalExecutor,dt as QdrantVectorProvider,On as RegeneratorService,Y as ResourceRegistry,fe as SaveOnboardingDraftBaseSpec,pe as SaveOnboardingDraftInput,me as SaveOnboardingDraftOutput,wt as SecretProviderError,kt as SecretProviderManager,H as SpecRegistry,ne as StabilityEnum,_t as StripePaymentsProvider,re as Tags,ie as TagsEnum,Ae as TelemetryAnomalyMonitor,De as TelemetryRegistry,ke as TelemetryTracker,mn as TestIntegrationConnection,je as TestRegistry,Ne as TestRunner,we as ThemeRegistry,m as TransformEngine,xn as TriggerKnowledgeSourceSync,yt as TwilioSmsProvider,hn as UpdateIntegrationConnection,Sn as UpdateKnowledgeSource,In as WorkflowPreFlightError,jn as WorkflowRegistry,Ln as WorkflowRunner,Mn as WorkflowValidationError,Jt as assertPrimaryOpenBankingReady,Nn as assertWorkflowSpecValid,Tn as behaviorToEnvelope,Ce as buildOPAInput,d as buildZodWithRelations,t as capabilityKey,ze as composeAppConfig,jt as connectionStatusLabel,h as createDefaultTransformEngine,v as createEngineWithDefaults,y as createFeatureModule,P as createFetchHandler,Bn as createFileStateStore,S as createFormRenderer,N as createMcpServer,i as dataViewKey,T as defaultGqlField,E as defaultMcpTool,D as defaultRestPath,n as defineCapability,z as defineCommand,a as defineEvent,f as defineFormSpec,q as definePrompt,B as defineQuery,X as defineResourceTemplate,Ze as elevenLabsIntegrationSpec,F as elysiaPlugin,nn as emailThreadsKnowledgeSpace,Mt as ensureConnectionReady,Yt as ensurePrimaryOpenBankingIntegration,En as errorToEnvelope,p as evalPredicate,Fn as evaluateExpression,o as eventKey,A as exportContractsToGraphQLSchema,I as expressRouter,sn as financialDocsKnowledgeSpace,ln as financialOverviewKnowledgeSpace,at as gcsStorageIntegrationSpec,$e as gmailIntegrationSpec,tt as googleCalendarIntegrationSpec,c as installFeature,W as installOp,gn as integrationContracts,V as isEmitDeclRef,Z as isResourceRef,M as jsonSchemaForPresentation,O as jsonSchemaForSpec,Cn as knowledgeContracts,Re as makeAppBlueprintKey,G as makeEmit,Fe as makeExperimentKey,He as makeIntegrationSpecKey,Zt as makeKnowledgeSpaceKey,L as makeNextAppHandler,R as makeNextPagesHandler,be as makePolicyKey,Oe as makeTelemetryKey,Me as makeTestKey,Te as makeThemeRef,Ye as mistralIntegrationSpec,Tt as normalizeSecretPayload,K as op,U as opKey,he as openBankingAccountsReadCapability,ge as openBankingBalancesReadCapability,_e as openBankingTransactionsReadCapability,Et as parseSecretUri,Ge as postmarkIntegrationSpec,st as powensIntegrationSpec,Qt as productCanonKnowledgeSpace,qe as qdrantIntegrationSpec,zt as redactOpenBankingTelemetryPayload,g as registerBasicValidation,k as registerContractsOnBuilder,_ as registerDefaultReactRenderer,Qe as registerElevenLabsIntegration,rn as registerEmailThreadsKnowledgeSpace,b as registerFeature,cn as registerFinancialDocsKnowledgeSpace,un as registerFinancialOverviewKnowledgeSpace,ot as registerGcsStorageIntegration,et as registerGmailIntegration,nt as registerGoogleCalendarIntegration,_n as registerIntegrationContracts,wn as registerKnowledgeContracts,Xe as registerMistralIntegration,ve as registerOpenBankingCapabilities,qt as registerOpenBankingContracts,Ke as registerPostmarkIntegration,ct as registerPowensIntegration,$t as registerProductCanonKnowledgeSpace,Je as registerQdrantIntegration,Ue as registerStripeIntegration,en as registerSupportFaqKnowledgeSpace,rt as registerTwilioSmsIntegration,an as registerUploadedDocsKnowledgeSpace,x as renderFeaturePresentation,Be as resolveAppConfig,Q as resourceRef,w as rnReusablesDriver,C as shadcnDriver,We as stripeIntegrationSpec,tn as supportFaqKnowledgeSpace,Dn as telemetryToEnvelope,$ as toV2FromV1,it as twilioSmsIntegrationSpec,on as uploadedDocsKnowledgeSpace,l as validateFeatureTargetsV2,Pn as validateWorkflowSpec};
+import{CapabilityRegistry as e,capabilityKey as t,defineCapability as n}from"./capabilities.js";import{DataViewRegistry as r,dataViewKey as i}from"./data-views.js";import{defineEvent as a,eventKey as o}from"./events.js";import{FeatureRegistry as s,installFeature as c,validateFeatureTargetsV2 as l}from"./features.js";import{FormRegistry as u,buildZodWithRelations as d,defineFormSpec as f,evalPredicate as p}from"./forms.js";import{schemaToMarkdown as m,schemaToMarkdownDetail as h,schemaToMarkdownList as g,schemaToMarkdownSummary as _,schemaToMarkdownTable as v}from"./schema-to-markdown.js";import{TransformEngine as y,createDefaultTransformEngine as b,registerBasicValidation as x,registerDefaultReactRenderer as S,registerReactToMarkdownRenderer as C}from"./presentations.v2.js";import{createEngineWithDefaults as w,createFeatureModule as T,registerFeature as E,renderFeaturePresentation as D}from"./client/react/feature-render.js";import{createFormRenderer as O}from"./client/react/form-render.js";import{shadcnDriver as k}from"./client/react/drivers/shadcn.js";import{rnReusablesDriver as A}from"./client/react/drivers/rn-reusables.js";import"./client/index.js";import{defaultGqlField as j,defaultMcpTool as M,defaultRestPath as N,jsonSchemaForSpec as P}from"./jsonschema.js";import{registerContractsOnBuilder as F}from"./server/graphql-pothos.js";import{PresentationRegistry as I,jsonSchemaForPresentation as L}from"./presentations.js";import{createMcpServer as R}from"./server/mcp/createMcpServer.js";import{createFetchHandler as z}from"./server/rest-generic.js";import{elysiaPlugin as B}from"./server/rest-elysia.js";import{expressRouter as V}from"./server/rest-express.js";import{makeNextAppHandler as H}from"./server/rest-next-app.js";import{makeNextPagesHandler as U}from"./server/rest-next-pages.js";import"./server/index.js";import{defineCommand as W,defineQuery as G,isEmitDeclRef as K}from"./spec.js";import{docBlockToPresentationSpec as q,docBlockToPresentationV2 as J,docBlocksToPresentationRoutes as Y,docBlocksToPresentationSpecs as X,mapDocRoutes as Z}from"./docs/presentations.js";import{DocRegistry as Q,defaultDocRegistry as $,docId as ee,listRegisteredDocBlocks as te,registerDocBlocks as ne}from"./docs/registry.js";import{SpecRegistry as re,opKey as ie}from"./registry.js";import{Owners as ae,OwnersEnum as oe,StabilityEnum as se,Tags as ce,TagsEnum as le}from"./ownership.js";import{ContractRegistryFileSchema as ue,ContractRegistryItemSchema as de,ContractRegistryItemTypeSchema as fe,ContractRegistryManifestSchema as pe}from"./contract-registry/schemas.js";import"./contract-registry/index.js";import{installOp as me,makeEmit as he,op as ge}from"./install.js";import{openApiForRegistry as _e}from"./openapi.js";import{definePrompt as ve}from"./prompt.js";import{PromptRegistry as ye}from"./promptRegistry.js";import{ResourceRegistry as be,defineResourceTemplate as xe,isResourceRef as Se,resourceRef as Ce}from"./resources.js";import{toV2FromV1 as we}from"./presentations.backcompat.js";import{CompleteOnboardingBaseInput as Te,CompleteOnboardingBaseOutput as Ee,CompleteOnboardingBaseSpec as De,DeleteOnboardingDraftBaseSpec as Oe,DeleteOnboardingDraftOutput as ke,GetOnboardingDraftBaseSpec as Ae,GetOnboardingDraftOutput as je,SaveOnboardingDraftBaseSpec as Me,SaveOnboardingDraftInput as Ne,SaveOnboardingDraftOutput as Pe}from"./onboarding-base.js";import{openBankingAccountsReadCapability as Fe,openBankingBalancesReadCapability as Ie,openBankingTransactionsReadCapability as Le,registerOpenBankingCapabilities as Re}from"./capabilities/openbanking.js";import{PolicyRegistry as ze,makePolicyKey as Be}from"./policy/spec.js";import{PolicyEngine as Ve}from"./policy/engine.js";import{OPAPolicyAdapter as He,buildOPAInput as Ue}from"./policy/opa-adapter.js";import{ThemeRegistry as We,makeThemeRef as Ge}from"./themes.js";import{MigrationRegistry as Ke}from"./migrations.js";import{TelemetryRegistry as qe,makeTelemetryKey as Je}from"./telemetry/spec.js";import{TelemetryTracker as Ye}from"./telemetry/tracker.js";import{TelemetryAnomalyMonitor as Xe}from"./telemetry/anomaly.js";import"./telemetry/index.js";import{TestRegistry as Ze,makeTestKey as Qe}from"./tests/spec.js";import{TestRunner as $e}from"./tests/runner.js";import"./tests/index.js";import{ExperimentRegistry as et,makeExperimentKey as tt}from"./experiments/spec.js";import{ExperimentEvaluator as nt}from"./experiments/evaluator.js";import{AppBlueprintRegistry as rt,makeAppBlueprintKey as it}from"./app-config/spec.js";import{composeAppConfig as at,resolveAppConfig as ot}from"./app-config/runtime.js";import{IntegrationSpecRegistry as st,makeIntegrationSpecKey as ct}from"./integrations/spec.js";import{registerStripeIntegration as lt,stripeIntegrationSpec as ut}from"./integrations/providers/stripe.js";import{postmarkIntegrationSpec as dt,registerPostmarkIntegration as ft}from"./integrations/providers/postmark.js";import{qdrantIntegrationSpec as pt,registerQdrantIntegration as mt}from"./integrations/providers/qdrant.js";import{mistralIntegrationSpec as ht,registerMistralIntegration as gt}from"./integrations/providers/mistral.js";import{elevenLabsIntegrationSpec as _t,registerElevenLabsIntegration as vt}from"./integrations/providers/elevenlabs.js";import{gmailIntegrationSpec as yt,registerGmailIntegration as bt}from"./integrations/providers/gmail.js";import{googleCalendarIntegrationSpec as xt,registerGoogleCalendarIntegration as St}from"./integrations/providers/google-calendar.js";import{registerTwilioSmsIntegration as Ct,twilioSmsIntegrationSpec as wt}from"./integrations/providers/twilio-sms.js";import{gcsStorageIntegrationSpec as Tt,registerGcsStorageIntegration as Et}from"./integrations/providers/gcs-storage.js";import{powensIntegrationSpec as Dt,registerPowensIntegration as Ot}from"./integrations/providers/powens.js";import{createDefaultIntegrationSpecRegistry as kt}from"./integrations/providers/registry.js";import{AccountBalanceRecord as At,BankAccountRecord as jt,BankTransactionRecord as Mt}from"./integrations/openbanking/models.js";import{OPENBANKING_PII_FIELDS as Nt,OPENBANKING_TELEMETRY_EVENTS as Pt,redactOpenBankingTelemetryPayload as Ft}from"./integrations/openbanking/telemetry.js";import{OpenBankingGetAccount as It,OpenBankingListAccounts as Lt,OpenBankingSyncAccounts as Rt}from"./integrations/openbanking/contracts/accounts.js";import{OpenBankingListTransactions as zt,OpenBankingSyncTransactions as Bt}from"./integrations/openbanking/contracts/transactions.js";import{OpenBankingGetBalances as Vt,OpenBankingRefreshBalances as Ht}from"./integrations/openbanking/contracts/balances.js";import{OpenBankingFeature as Ut}from"./integrations/openbanking/openbanking.feature.js";import{registerOpenBankingContracts as Wt}from"./integrations/openbanking/contracts/index.js";import{assertPrimaryOpenBankingReady as Gt,ensurePrimaryOpenBankingIntegration as Kt}from"./integrations/openbanking/guards.js";import"./integrations/index.js";import{KnowledgeSpaceRegistry as qt,makeKnowledgeSpaceKey as Jt}from"./knowledge/spec.js";import{productCanonKnowledgeSpace as Yt,registerProductCanonKnowledgeSpace as Xt}from"./knowledge/spaces/product-canon.js";import{registerSupportFaqKnowledgeSpace as Zt,supportFaqKnowledgeSpace as Qt}from"./knowledge/spaces/support-faq.js";import{emailThreadsKnowledgeSpace as $t,registerEmailThreadsKnowledgeSpace as en}from"./knowledge/spaces/email-threads.js";import{registerUploadedDocsKnowledgeSpace as tn,uploadedDocsKnowledgeSpace as nn}from"./knowledge/spaces/uploaded-docs.js";import{financialDocsKnowledgeSpace as rn,registerFinancialDocsKnowledgeSpace as an}from"./knowledge/spaces/financial-docs.js";import{financialOverviewKnowledgeSpace as on,registerFinancialOverviewKnowledgeSpace as sn}from"./knowledge/spaces/financial-overview.js";import"./knowledge/index.js";import{CreateIntegrationConnection as cn,DeleteIntegrationConnection as ln,ListIntegrationConnections as un,TestIntegrationConnection as dn,UpdateIntegrationConnection as fn,integrationContracts as pn,registerIntegrationContracts as mn}from"./integrations/contracts.js";import{CreateKnowledgeSource as hn,DeleteKnowledgeSource as gn,ListKnowledgeSources as _n,TriggerKnowledgeSourceSync as vn,UpdateKnowledgeSource as yn,knowledgeContracts as bn,registerKnowledgeContracts as xn}from"./knowledge/contracts.js";import{behaviorToEnvelope as Sn,errorToEnvelope as Cn,telemetryToEnvelope as wn}from"./regenerator/utils.js";import{RegeneratorService as Tn}from"./regenerator/service.js";import{ProposalExecutor as En}from"./regenerator/executor.js";import{ExecutorProposalSink as Dn}from"./regenerator/sinks.js";import"./regenerator/index.js";import{WorkflowRegistry as On}from"./workflow/spec.js";import{WorkflowValidationError as kn,assertWorkflowSpecValid as An,validateWorkflowSpec as jn}from"./workflow/validation.js";import{evaluateExpression as Mn}from"./workflow/expression.js";import{WorkflowPreFlightError as Nn,WorkflowRunner as Pn}from"./workflow/runner.js";import{InMemoryStateStore as Fn}from"./workflow/adapters/memory-store.js";import{PrismaStateStore as In}from"./workflow/adapters/db-adapter.js";import{createFileStateStore as Ln}from"./workflow/adapters/file-adapter.js";import"./workflow/index.js";import{techContractsDocs as Rn}from"./docs/tech-contracts.docs.js";import{metaDocs as zn}from"./docs/meta.docs.js";import"./docs/index.js";import{docBlockToMarkdown as Bn,eventToMarkdown as Vn,exportFeature as Hn,exportSpec as Un,featureToMarkdown as Wn,presentationToMarkdown as Gn,specToAgentPrompt as Kn,specToContextMarkdown as qn,specToFullMarkdown as Jn}from"./llm/exporters.js";import{AGENT_SYSTEM_PROMPTS as Yn,formatPlanForAgent as Xn,generateFixViolationsPrompt as Zn,generateImplementationPlan as Qn,generateImplementationPrompt as $n,generateReviewPrompt as er,generateTestPrompt as tr,generateVerificationPrompt as nr}from"./llm/prompts.js";import"./llm/index.js";import{defineSchemaModel as rr}from"@lssm/lib.schema";export{Yn as AGENT_SYSTEM_PROMPTS,At as AccountBalanceRecord,rt as AppBlueprintRegistry,jt as BankAccountRecord,Mt as BankTransactionRecord,e as CapabilityRegistry,Te as CompleteOnboardingBaseInput,Ee as CompleteOnboardingBaseOutput,De as CompleteOnboardingBaseSpec,ue as ContractRegistryFileSchema,de as ContractRegistryItemSchema,fe as ContractRegistryItemTypeSchema,pe as ContractRegistryManifestSchema,cn as CreateIntegrationConnection,hn as CreateKnowledgeSource,r as DataViewRegistry,ln as DeleteIntegrationConnection,gn as DeleteKnowledgeSource,Oe as DeleteOnboardingDraftBaseSpec,ke as DeleteOnboardingDraftOutput,Q as DocRegistry,Dn as ExecutorProposalSink,nt as ExperimentEvaluator,et as ExperimentRegistry,s as FeatureRegistry,u as FormRegistry,Ae as GetOnboardingDraftBaseSpec,je as GetOnboardingDraftOutput,Fn as InMemoryStateStore,st as IntegrationSpecRegistry,qt as KnowledgeSpaceRegistry,un as ListIntegrationConnections,_n as ListKnowledgeSources,Ke as MigrationRegistry,He as OPAPolicyAdapter,Nt as OPENBANKING_PII_FIELDS,Pt as OPENBANKING_TELEMETRY_EVENTS,Ut as OpenBankingFeature,It as OpenBankingGetAccount,Vt as OpenBankingGetBalances,Lt as OpenBankingListAccounts,zt as OpenBankingListTransactions,Ht as OpenBankingRefreshBalances,Rt as OpenBankingSyncAccounts,Bt as OpenBankingSyncTransactions,ae as Owners,oe as OwnersEnum,Ve as PolicyEngine,ze as PolicyRegistry,I as PresentationRegistry,In as PrismaStateStore,ye as PromptRegistry,En as ProposalExecutor,Tn as RegeneratorService,be as ResourceRegistry,Me as SaveOnboardingDraftBaseSpec,Ne as SaveOnboardingDraftInput,Pe as SaveOnboardingDraftOutput,re as SpecRegistry,se as StabilityEnum,ce as Tags,le as TagsEnum,Xe as TelemetryAnomalyMonitor,qe as TelemetryRegistry,Ye as TelemetryTracker,dn as TestIntegrationConnection,Ze as TestRegistry,$e as TestRunner,We as ThemeRegistry,y as TransformEngine,vn as TriggerKnowledgeSourceSync,fn as UpdateIntegrationConnection,yn as UpdateKnowledgeSource,Nn as WorkflowPreFlightError,On as WorkflowRegistry,Pn as WorkflowRunner,kn as WorkflowValidationError,Gt as assertPrimaryOpenBankingReady,An as assertWorkflowSpecValid,Sn as behaviorToEnvelope,Ue as buildOPAInput,d as buildZodWithRelations,t as capabilityKey,at as composeAppConfig,kt as createDefaultIntegrationSpecRegistry,b as createDefaultTransformEngine,w as createEngineWithDefaults,T as createFeatureModule,z as createFetchHandler,Ln as createFileStateStore,O as createFormRenderer,R as createMcpServer,i as dataViewKey,$ as defaultDocRegistry,j as defaultGqlField,M as defaultMcpTool,N as defaultRestPath,n as defineCapability,W as defineCommand,a as defineEvent,f as defineFormSpec,ve as definePrompt,G as defineQuery,xe as defineResourceTemplate,rr as defineSchemaModel,Bn as docBlockToMarkdown,q as docBlockToPresentationSpec,J as docBlockToPresentationV2,Y as docBlocksToPresentationRoutes,X as docBlocksToPresentationSpecs,ee as docId,_t as elevenLabsIntegrationSpec,B as elysiaPlugin,$t as emailThreadsKnowledgeSpace,Kt as ensurePrimaryOpenBankingIntegration,Cn as errorToEnvelope,p as evalPredicate,Mn as evaluateExpression,o as eventKey,Vn as eventToMarkdown,Hn as exportFeature,Un as exportSpec,V as expressRouter,Wn as featureToMarkdown,rn as financialDocsKnowledgeSpace,on as financialOverviewKnowledgeSpace,Xn as formatPlanForAgent,Tt as gcsStorageIntegrationSpec,Zn as generateFixViolationsPrompt,Qn as generateImplementationPlan,$n as generateImplementationPrompt,er as generateReviewPrompt,tr as generateTestPrompt,nr as generateVerificationPrompt,yt as gmailIntegrationSpec,xt as googleCalendarIntegrationSpec,c as installFeature,me as installOp,pn as integrationContracts,K as isEmitDeclRef,Se as isResourceRef,L as jsonSchemaForPresentation,P as jsonSchemaForSpec,bn as knowledgeContracts,te as listRegisteredDocBlocks,it as makeAppBlueprintKey,he as makeEmit,tt as makeExperimentKey,ct as makeIntegrationSpecKey,Jt as makeKnowledgeSpaceKey,H as makeNextAppHandler,U as makeNextPagesHandler,Be as makePolicyKey,Je as makeTelemetryKey,Qe as makeTestKey,Ge as makeThemeRef,Z as mapDocRoutes,zn as metaDocs,ht as mistralIntegrationSpec,ge as op,ie as opKey,_e as openApiForRegistry,Fe as openBankingAccountsReadCapability,Ie as openBankingBalancesReadCapability,Le as openBankingTransactionsReadCapability,dt as postmarkIntegrationSpec,Dt as powensIntegrationSpec,Gn as presentationToMarkdown,Yt as productCanonKnowledgeSpace,pt as qdrantIntegrationSpec,Ft as redactOpenBankingTelemetryPayload,x as registerBasicValidation,F as registerContractsOnBuilder,S as registerDefaultReactRenderer,ne as registerDocBlocks,vt as registerElevenLabsIntegration,en as registerEmailThreadsKnowledgeSpace,E as registerFeature,an as registerFinancialDocsKnowledgeSpace,sn as registerFinancialOverviewKnowledgeSpace,Et as registerGcsStorageIntegration,bt as registerGmailIntegration,St as registerGoogleCalendarIntegration,mn as registerIntegrationContracts,xn as registerKnowledgeContracts,gt as registerMistralIntegration,Re as registerOpenBankingCapabilities,Wt as registerOpenBankingContracts,ft as registerPostmarkIntegration,Ot as registerPowensIntegration,Xt as registerProductCanonKnowledgeSpace,mt as registerQdrantIntegration,C as registerReactToMarkdownRenderer,lt as registerStripeIntegration,Zt as registerSupportFaqKnowledgeSpace,Ct as registerTwilioSmsIntegration,tn as registerUploadedDocsKnowledgeSpace,D as renderFeaturePresentation,ot as resolveAppConfig,Ce as resourceRef,A as rnReusablesDriver,m as schemaToMarkdown,h as schemaToMarkdownDetail,g as schemaToMarkdownList,_ as schemaToMarkdownSummary,v as schemaToMarkdownTable,k as shadcnDriver,Kn as specToAgentPrompt,qn as specToContextMarkdown,Jn as specToFullMarkdown,ut as stripeIntegrationSpec,Qt as supportFaqKnowledgeSpace,Rn as techContractsDocs,wn as telemetryToEnvelope,we as toV2FromV1,wt as twilioSmsIntegrationSpec,nn as uploadedDocsKnowledgeSpace,l as validateFeatureTargetsV2,jn as validateWorkflowSpec};

package/dist/install.js

@@ -1 +1 @@
-import"./registry.js";import{z as e}from"zod";function t(e,t){return{ref:async(e,n)=>{await t.__emitGuard__?.(e.name,e.version,n)},named:async(e,n,r)=>{await t.__emitGuard__?.(e,n,r)},object:async e=>{await t.__emitGuard__?.(e.name,e.version,e.payload)}}}function n(e,t,n){return e.register(t).bind(t,n)}function r(e,t){return{spec:e,handler:t,install:r=>n(r,e,t)}}export{n as installOp,t as makeEmit,r as op};
+import"./registry.js";import"zod";function e(e,t){return{ref:async(e,n)=>{await t.__emitGuard__?.(e.name,e.version,n)},named:async(e,n,r)=>{await t.__emitGuard__?.(e,n,r)},object:async e=>{await t.__emitGuard__?.(e.name,e.version,e.payload)}}}function t(e,t,n){return e.register(t).bind(t,n)}function n(e,n){return{spec:e,handler:n,install:r=>t(r,e,n)}}export{t as installOp,e as makeEmit,n as op};

package/dist/integrations/contracts.js

@@ -1 +1 @@
-import{l as e}from"../schema/dist/ScalarTypeEnum.js";import{t}from"../schema/dist/SchemaModel.js";import"../schema/dist/index.js";import{defineCommand as n,defineQuery as r}from"../spec.js";const i=new t({name:`IntegrationConnectionRecord`,fields:{id:{type:e.ID(),isOptional:!1},tenantId:{type:e.ID(),isOptional:!1},integrationKey:{type:e.NonEmptyString(),isOptional:!1},integrationVersion:{type:e.Int_unsecure(),isOptional:!1},label:{type:e.String_unsecure(),isOptional:!1},ownershipMode:{type:e.String_unsecure(),isOptional:!1},externalAccountId:{type:e.String_unsecure(),isOptional:!0},secretProvider:{type:e.String_unsecure(),isOptional:!1},secretRef:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},environment:{type:e.String_unsecure(),isOptional:!0},healthStatus:{type:e.String_unsecure(),isOptional:!0},healthCheckedAt:{type:e.DateTime(),isOptional:!0},healthLatencyMs:{type:e.Float_unsecure(),isOptional:!0},healthErrorCode:{type:e.String_unsecure(),isOptional:!0},healthErrorMessage:{type:e.String_unsecure(),isOptional:!0},usageRequestCount:{type:e.Int_unsecure(),isOptional:!0},usageSuccessCount:{type:e.Int_unsecure(),isOptional:!0},usageErrorCount:{type:e.Int_unsecure(),isOptional:!0},usageLastUsedAt:{type:e.DateTime(),isOptional:!0},usageLastErrorAt:{type:e.DateTime(),isOptional:!0},usageLastErrorCode:{type:e.String_unsecure(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!0},updatedAt:{type:e.DateTime(),isOptional:!0}}}),a=new t({name:`CreateIntegrationConnectionInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},integrationKey:{type:e.NonEmptyString(),isOptional:!1},integrationVersion:{type:e.Int_unsecure(),isOptional:!1},label:{type:e.String_unsecure(),isOptional:!1},ownershipMode:{type:e.String_unsecure(),isOptional:!1},externalAccountId:{type:e.String_unsecure(),isOptional:!0},secretProvider:{type:e.String_unsecure(),isOptional:!1},secretRef:{type:e.String_unsecure(),isOptional:!1},environment:{type:e.String_unsecure(),isOptional:!0},config:{type:e.JSONObject(),isOptional:!1}}}),o=new t({name:`UpdateIntegrationConnectionInput`,fields:{connectionId:{type:e.ID(),isOptional:!1},label:{type:e.String_unsecure(),isOptional:!0},status:{type:e.String_unsecure(),isOptional:!0},ownershipMode:{type:e.String_unsecure(),isOptional:!0},externalAccountId:{type:e.String_unsecure(),isOptional:!0},secretProvider:{type:e.String_unsecure(),isOptional:!0},secretRef:{type:e.String_unsecure(),isOptional:!0},config:{type:e.JSONObject(),isOptional:!0}}}),s=new t({name:`DeleteIntegrationConnectionInput`,fields:{connectionId:{type:e.ID(),isOptional:!1}}}),c=new t({name:`ListIntegrationConnectionsInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},category:{type:e.String_unsecure(),isOptional:!0},status:{type:e.String_unsecure(),isOptional:!0}}}),l=new t({name:`ListIntegrationConnectionsOutput`,fields:{connections:{type:i,isOptional:!1,isArray:!0}}}),u=new t({name:`TestIntegrationConnectionInput`,fields:{connectionId:{type:e.ID(),isOptional:!1}}}),d=new t({name:`TestIntegrationConnectionOutput`,fields:{success:{type:e.Boolean(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!0},latencyMs:{type:e.Float_unsecure(),isOptional:!0},error:{type:e.String_unsecure(),isOptional:!0},errorCode:{type:e.String_unsecure(),isOptional:!0}}}),f=new t({name:`DeleteIntegrationConnectionOutput`,fields:{success:{type:e.Boolean(),isOptional:!1}}}),p=n({meta:{name:`integrations.connection.create`,version:1,description:`Create a new integration connection for a tenant.`,goal:`Provision a tenant-scoped connection to an external provider.`,context:`Used by Ops or the App Studio to configure external integrations such as Stripe or Qdrant.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:a,output:i},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),m=n({meta:{name:`integrations.connection.update`,version:1,description:`Update metadata or credentials for an integration connection.`,goal:`Allow secure rotation of credentials and metadata adjustments.`,context:`Supports rotating API keys, toggling status, or updating labels for tenant integrations.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:o,output:i},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),h=n({meta:{name:`integrations.connection.delete`,version:1,description:`Delete an integration connection for a tenant.`,goal:`Safely remove credentials and disable connector usage.`,context:`Ensures connections are de-provisioned when no longer needed or breached.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:s,output:f},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),g=r({meta:{name:`integrations.connection.list`,version:1,description:`List integration connections for a tenant.`,goal:`Provide visibility into configured integrations and their status.`,context:`Used by the App Studio and Ops flows to show bindings and health.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:c,output:l},policy:{auth:`admin`,policies:[{name:`platform.integration.read`,version:1}]}}),_=n({meta:{name:`integrations.connection.test`,version:1,description:`Run a health check against a configured integration connection.`,goal:`Validate credentials and connectivity for external providers.`,context:`Triggered manually or by background monitors to confirm provider availability.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:u,output:d},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),v={CreateIntegrationConnection:p,UpdateIntegrationConnection:m,DeleteIntegrationConnection:h,ListIntegrationConnections:g,TestIntegrationConnection:_};function y(e){return e.register(p).register(m).register(h).register(g).register(_)}export{p as CreateIntegrationConnection,h as DeleteIntegrationConnection,g as ListIntegrationConnections,_ as TestIntegrationConnection,m as UpdateIntegrationConnection,v as integrationContracts,y as registerIntegrationContracts};
+import{defineCommand as e,defineQuery as t}from"../spec.js";import{ScalarTypeEnum as n,SchemaModel as r}from"@lssm/lib.schema";const i=new r({name:`IntegrationConnectionRecord`,fields:{id:{type:n.ID(),isOptional:!1},tenantId:{type:n.ID(),isOptional:!1},integrationKey:{type:n.NonEmptyString(),isOptional:!1},integrationVersion:{type:n.Int_unsecure(),isOptional:!1},label:{type:n.String_unsecure(),isOptional:!1},ownershipMode:{type:n.String_unsecure(),isOptional:!1},externalAccountId:{type:n.String_unsecure(),isOptional:!0},secretProvider:{type:n.String_unsecure(),isOptional:!1},secretRef:{type:n.String_unsecure(),isOptional:!1},status:{type:n.String_unsecure(),isOptional:!1},environment:{type:n.String_unsecure(),isOptional:!0},healthStatus:{type:n.String_unsecure(),isOptional:!0},healthCheckedAt:{type:n.DateTime(),isOptional:!0},healthLatencyMs:{type:n.Float_unsecure(),isOptional:!0},healthErrorCode:{type:n.String_unsecure(),isOptional:!0},healthErrorMessage:{type:n.String_unsecure(),isOptional:!0},usageRequestCount:{type:n.Int_unsecure(),isOptional:!0},usageSuccessCount:{type:n.Int_unsecure(),isOptional:!0},usageErrorCount:{type:n.Int_unsecure(),isOptional:!0},usageLastUsedAt:{type:n.DateTime(),isOptional:!0},usageLastErrorAt:{type:n.DateTime(),isOptional:!0},usageLastErrorCode:{type:n.String_unsecure(),isOptional:!0},createdAt:{type:n.DateTime(),isOptional:!0},updatedAt:{type:n.DateTime(),isOptional:!0}}}),a=new r({name:`CreateIntegrationConnectionInput`,fields:{tenantId:{type:n.ID(),isOptional:!1},integrationKey:{type:n.NonEmptyString(),isOptional:!1},integrationVersion:{type:n.Int_unsecure(),isOptional:!1},label:{type:n.String_unsecure(),isOptional:!1},ownershipMode:{type:n.String_unsecure(),isOptional:!1},externalAccountId:{type:n.String_unsecure(),isOptional:!0},secretProvider:{type:n.String_unsecure(),isOptional:!1},secretRef:{type:n.String_unsecure(),isOptional:!1},environment:{type:n.String_unsecure(),isOptional:!0},config:{type:n.JSONObject(),isOptional:!1}}}),o=new r({name:`UpdateIntegrationConnectionInput`,fields:{connectionId:{type:n.ID(),isOptional:!1},label:{type:n.String_unsecure(),isOptional:!0},status:{type:n.String_unsecure(),isOptional:!0},ownershipMode:{type:n.String_unsecure(),isOptional:!0},externalAccountId:{type:n.String_unsecure(),isOptional:!0},secretProvider:{type:n.String_unsecure(),isOptional:!0},secretRef:{type:n.String_unsecure(),isOptional:!0},config:{type:n.JSONObject(),isOptional:!0}}}),s=new r({name:`DeleteIntegrationConnectionInput`,fields:{connectionId:{type:n.ID(),isOptional:!1}}}),c=new r({name:`ListIntegrationConnectionsInput`,fields:{tenantId:{type:n.ID(),isOptional:!1},category:{type:n.String_unsecure(),isOptional:!0},status:{type:n.String_unsecure(),isOptional:!0}}}),l=new r({name:`ListIntegrationConnectionsOutput`,fields:{connections:{type:i,isOptional:!1,isArray:!0}}}),u=new r({name:`TestIntegrationConnectionInput`,fields:{connectionId:{type:n.ID(),isOptional:!1}}}),d=new r({name:`TestIntegrationConnectionOutput`,fields:{success:{type:n.Boolean(),isOptional:!1},status:{type:n.String_unsecure(),isOptional:!0},latencyMs:{type:n.Float_unsecure(),isOptional:!0},error:{type:n.String_unsecure(),isOptional:!0},errorCode:{type:n.String_unsecure(),isOptional:!0}}}),f=new r({name:`DeleteIntegrationConnectionOutput`,fields:{success:{type:n.Boolean(),isOptional:!1}}}),p=e({meta:{name:`integrations.connection.create`,version:1,description:`Create a new integration connection for a tenant.`,goal:`Provision a tenant-scoped connection to an external provider.`,context:`Used by Ops or the App Studio to configure external integrations such as Stripe or Qdrant.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:a,output:i},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),m=e({meta:{name:`integrations.connection.update`,version:1,description:`Update metadata or credentials for an integration connection.`,goal:`Allow secure rotation of credentials and metadata adjustments.`,context:`Supports rotating API keys, toggling status, or updating labels for tenant integrations.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:o,output:i},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),h=e({meta:{name:`integrations.connection.delete`,version:1,description:`Delete an integration connection for a tenant.`,goal:`Safely remove credentials and disable connector usage.`,context:`Ensures connections are de-provisioned when no longer needed or breached.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:s,output:f},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),g=t({meta:{name:`integrations.connection.list`,version:1,description:`List integration connections for a tenant.`,goal:`Provide visibility into configured integrations and their status.`,context:`Used by the App Studio and Ops flows to show bindings and health.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:c,output:l},policy:{auth:`admin`,policies:[{name:`platform.integration.read`,version:1}]}}),_=e({meta:{name:`integrations.connection.test`,version:1,description:`Run a health check against a configured integration connection.`,goal:`Validate credentials and connectivity for external providers.`,context:`Triggered manually or by background monitors to confirm provider availability.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:u,output:d},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),v={CreateIntegrationConnection:p,UpdateIntegrationConnection:m,DeleteIntegrationConnection:h,ListIntegrationConnections:g,TestIntegrationConnection:_};function y(e){return e.register(p).register(m).register(h).register(g).register(_)}export{p as CreateIntegrationConnection,h as DeleteIntegrationConnection,g as ListIntegrationConnections,_ as TestIntegrationConnection,m as UpdateIntegrationConnection,v as integrationContracts,y as registerIntegrationContracts};

package/dist/integrations/docs/integrations.docblock.js

@@ -0,0 +1 @@
+import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.integrations`,title:`ContractSpec Integrations`,summary:`Provider-agnostic integration contracts: specs, connections, secrets, health checks, and runtime guards.`,kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/integrations`,tags:[`tech`,`contracts`,`integrations`],body:"# ContractSpec Integrations\n\nThis document describes the integration architecture that powers ContractSpec-based apps. It focuses on provider-agnostic contracts, secret management, health checks, and runtime guards.\n\n## Core Concepts\n\n- **IntegrationSpec** – declarative description of a provider that lists supported ownership modes, capability mappings, configuration schema, secret schema, health check policy, and documentation metadata.\n- **IntegrationConnection** – tenant/environment binding to a provider (`meta` + ownership mode + config + `secretRef`). Secrets are never embedded in specs or configs.\n- **AppIntegrationSlot** – blueprint-level requirement that declares which integration categories/capabilities must be satisfied at runtime (e.g. `primaryLLM`, `primaryVectorDb`).\n- **AppIntegrationBinding** – tenant-level slot → connection mapping.\n- **ResolvedIntegration** – runtime view containing slot metadata, connection details, and the resolved IntegrationSpec.\n\n## Registered Providers\n\nThe contracts library ships ten priority providers in `packages/libs/contracts/src/integrations/providers`:\n\n| Category      | Provider         | Key                         | Notes                                             |\n| ------------- | ---------------- | --------------------------- | ------------------------------------------------- |\n| payments      | Stripe           | `payments.stripe`          | Card + invoice flows, managed or BYOK credentials |\n| email (out)   | Postmark         | `email.postmark`           | Transactional email delivery                      |\n| email (in)    | Gmail API        | `email.gmail`              | Thread ingestion (OAuth BYOK or service account)  |\n| calendar      | Google Calendar  | `calendar.google`          | Event scheduling via service account              |\n| vector-db     | Qdrant           | `vectordb.qdrant`          | Embedding storage & search                        |\n| storage       | Google Cloud     | `storage.gcs`              | Object storage                                    |\n| ai-llm        | Mistral          | `ai-llm.mistral`           | Primary chat + embedding provider                 |\n| ai-voice      | ElevenLabs       | `ai-voice.elevenlabs`      | Text-to-speech synthesis                          |\n| sms           | Twilio SMS       | `sms.twilio`               | Urgent and fallback reminders                     |\n| open-banking  | Powens           | `openbanking.powens`       | Read-only account, transaction, and balance sync  |\n\nEach provider ships with:\n\n- Strongly typed adapter interfaces (`payments.ts`, `llm.ts`, etc.)\n- A concrete SDK-backed implementation under `providers/impls`\n- Unit tests validating adapter behaviour and health checks\n\n### Canonical registry builder\n\nTo list all shipped specs at runtime, use:\n\n- `createDefaultIntegrationSpecRegistry()` from `@lssm/lib.contracts/integrations/providers/registry`\n\n## Secret Management\n\nAll integrations rely on the `SecretProvider` abstraction defined in `integrations/secrets`. Providers ship with the contracts library and are orchestrated by the `SecretProviderManager` composite:\n\n- **EnvSecretProvider** (`env-secret-provider.ts`) – high-priority, read-only overrides backed by environment variables.\n  - Supports the `env://VARIABLE_NAME` scheme\n  - Supports overrides for other schemes via `?env=ALIAS` or derived uppercase keys\n- **GcpSecretManagerProvider** (`gcp-secret-manager.ts`) – versioned secrets stored in Google Cloud Secret Manager.\n  - Example: `gcp://projects/demo/secrets/stripe-key/versions/latest`\n- **AwsSecretsManagerProvider** (`aws-secret-manager.ts`) – AWS Secrets Manager backend.\n  - Example: `aws://secretsmanager/eu-west-1/my-secret?version=AWSCURRENT`\n  - Region may be in the reference or provided via `AWS_REGION` / `AWS_DEFAULT_REGION`\n- **ScalewaySecretManagerProvider** (`scaleway-secret-manager.ts`) – Scaleway Secret Manager backend.\n  - Example (id): `scw://secret-manager/fr-par/1234...-uuid?version=latest`\n  - Example (name, create+write): `scw://secret-manager/fr-par/my-secret-name`\n  - Requires `SCW_SECRET_KEY` (token) and `SCW_DEFAULT_PROJECT_ID` when creating secrets by name\n\nThe manager attempts providers in priority order (environment first, then cloud providers). Key points:\n\n- `secretRef` is a URI-like reference; raw secrets are never returned.\n- `IntegrationCallGuard` fetches and parses secrets before executing a provider adapter.\n- Local development can rely on `.env` files, while staging/production reference cloud secret stores.\n\n## Health Checks & Telemetry\n\n- Each IntegrationSpec optionally declares `healthCheck.method` and timeouts.\n- `IntegrationCallGuard` enforces connection status, wraps retries with exponential back-off, and emits telemetry events tagged with tenant/app/slot metadata.\n- Validation rules (`app-config/validation.ts`) surface issues at publish time (slot mismatch, unsupported ownership modes, missing capabilities, etc.).\n\n## Studio persistence (ContractSpec Studio)\n\nContractSpec Studio persists tenant `IntegrationConnection` records in Postgres (Prisma model `IntegrationConnection` in `@lssm/lib.database-contractspec-studio`) and exposes a platform-admin management surface (see the Studio platform admin panel).\n"}];e(t);export{t as tech_contracts_integrations_DocBlocks};

package/dist/integrations/index.js

@@ -1 +1 @@
-import{IntegrationSpecRegistry as e,makeIntegrationSpecKey as t}from"./spec.js";import{registerStripeIntegration as n,stripeIntegrationSpec as r}from"./providers/stripe.js";import{postmarkIntegrationSpec as i,registerPostmarkIntegration as a}from"./providers/postmark.js";import{qdrantIntegrationSpec as o,registerQdrantIntegration as s}from"./providers/qdrant.js";import{mistralIntegrationSpec as c,registerMistralIntegration as l}from"./providers/mistral.js";import{elevenLabsIntegrationSpec as u,registerElevenLabsIntegration as d}from"./providers/elevenlabs.js";import{gmailIntegrationSpec as f,registerGmailIntegration as p}from"./providers/gmail.js";import{googleCalendarIntegrationSpec as m,registerGoogleCalendarIntegration as h}from"./providers/google-calendar.js";import{registerTwilioSmsIntegration as g,twilioSmsIntegrationSpec as _}from"./providers/twilio-sms.js";import{gcsStorageIntegrationSpec as v,registerGcsStorageIntegration as y}from"./providers/gcs-storage.js";import{powensIntegrationSpec as b,registerPowensIntegration as x}from"./providers/powens.js";import{MistralLLMProvider as S}from"./providers/impls/mistral-llm.js";import{MistralEmbeddingProvider as C}from"./providers/impls/mistral-embedding.js";import{QdrantVectorProvider as w}from"./providers/impls/qdrant-vector.js";import{GmailInboundProvider as T}from"./providers/impls/gmail-inbound.js";import{GmailOutboundProvider as E}from"./providers/impls/gmail-outbound.js";import{GoogleCalendarProvider as D}from"./providers/impls/google-calendar.js";import{ElevenLabsVoiceProvider as O}from"./providers/impls/elevenlabs-voice.js";import{GoogleCloudStorageProvider as k}from"./providers/impls/gcs-storage.js";import{StripePaymentsProvider as A}from"./providers/impls/stripe-payments.js";import{PostmarkEmailProvider as j}from"./providers/impls/postmark-email.js";import{TwilioSmsProvider as M}from"./providers/impls/twilio-sms.js";import{PowensClient as N,PowensClientError as P}from"./providers/impls/powens-client.js";import{PowensOpenBankingProvider as F}from"./providers/impls/powens-openbanking.js";import{IntegrationProviderFactory as I}from"./providers/impls/provider-factory.js";import"./providers/index.js";import{SecretProviderError as L,normalizeSecretPayload as R,parseSecretUri as z}from"./secrets/provider.js";import{GcpSecretManagerProvider as B}from"./secrets/gcp-secret-manager.js";import{EnvSecretProvider as V}from"./secrets/env-secret-provider.js";import{SecretProviderManager as H}from"./secrets/manager.js";import"./secrets/index.js";import{IntegrationCallGuard as U,connectionStatusLabel as W,ensureConnectionReady as G}from"./runtime.js";import{IntegrationHealthService as K}from"./health.js";import{AccountBalanceRecord as q,BankAccountRecord as J,BankTransactionRecord as Y}from"./openbanking/models.js";import{OPENBANKING_PII_FIELDS as X,OPENBANKING_TELEMETRY_EVENTS as Z,redactOpenBankingTelemetryPayload as Q}from"./openbanking/telemetry.js";import{OpenBankingGetAccount as $,OpenBankingListAccounts as ee,OpenBankingSyncAccounts as te}from"./openbanking/contracts/accounts.js";import{OpenBankingListTransactions as ne,OpenBankingSyncTransactions as re}from"./openbanking/contracts/transactions.js";import{OpenBankingGetBalances as ie,OpenBankingRefreshBalances as ae}from"./openbanking/contracts/balances.js";import{registerOpenBankingContracts as oe}from"./openbanking/contracts/index.js";import{assertPrimaryOpenBankingReady as se,ensurePrimaryOpenBankingIntegration as ce}from"./openbanking/guards.js";export{q as AccountBalanceRecord,J as BankAccountRecord,Y as BankTransactionRecord,O as ElevenLabsVoiceProvider,V as EnvSecretProvider,B as GcpSecretManagerProvider,T as GmailInboundProvider,E as GmailOutboundProvider,D as GoogleCalendarProvider,k as GoogleCloudStorageProvider,U as IntegrationCallGuard,K as IntegrationHealthService,I as IntegrationProviderFactory,e as IntegrationSpecRegistry,C as MistralEmbeddingProvider,S as MistralLLMProvider,X as OPENBANKING_PII_FIELDS,Z as OPENBANKING_TELEMETRY_EVENTS,$ as OpenBankingGetAccount,ie as OpenBankingGetBalances,ee as OpenBankingListAccounts,ne as OpenBankingListTransactions,ae as OpenBankingRefreshBalances,te as OpenBankingSyncAccounts,re as OpenBankingSyncTransactions,j as PostmarkEmailProvider,N as PowensClient,P as PowensClientError,F as PowensOpenBankingProvider,w as QdrantVectorProvider,L as SecretProviderError,H as SecretProviderManager,A as StripePaymentsProvider,M as TwilioSmsProvider,se as assertPrimaryOpenBankingReady,W as connectionStatusLabel,u as elevenLabsIntegrationSpec,G as ensureConnectionReady,ce as ensurePrimaryOpenBankingIntegration,v as gcsStorageIntegrationSpec,f as gmailIntegrationSpec,m as googleCalendarIntegrationSpec,t as makeIntegrationSpecKey,c as mistralIntegrationSpec,R as normalizeSecretPayload,z as parseSecretUri,i as postmarkIntegrationSpec,b as powensIntegrationSpec,o as qdrantIntegrationSpec,Q as redactOpenBankingTelemetryPayload,d as registerElevenLabsIntegration,y as registerGcsStorageIntegration,p as registerGmailIntegration,h as registerGoogleCalendarIntegration,l as registerMistralIntegration,oe as registerOpenBankingContracts,a as registerPostmarkIntegration,x as registerPowensIntegration,s as registerQdrantIntegration,n as registerStripeIntegration,g as registerTwilioSmsIntegration,r as stripeIntegrationSpec,_ as twilioSmsIntegrationSpec};
+import{IntegrationSpecRegistry as e,makeIntegrationSpecKey as t}from"./spec.js";import{registerStripeIntegration as n,stripeIntegrationSpec as r}from"./providers/stripe.js";import{postmarkIntegrationSpec as i,registerPostmarkIntegration as a}from"./providers/postmark.js";import{qdrantIntegrationSpec as o,registerQdrantIntegration as s}from"./providers/qdrant.js";import{mistralIntegrationSpec as c,registerMistralIntegration as l}from"./providers/mistral.js";import{elevenLabsIntegrationSpec as u,registerElevenLabsIntegration as d}from"./providers/elevenlabs.js";import{gmailIntegrationSpec as f,registerGmailIntegration as p}from"./providers/gmail.js";import{googleCalendarIntegrationSpec as m,registerGoogleCalendarIntegration as h}from"./providers/google-calendar.js";import{registerTwilioSmsIntegration as g,twilioSmsIntegrationSpec as _}from"./providers/twilio-sms.js";import{gcsStorageIntegrationSpec as v,registerGcsStorageIntegration as y}from"./providers/gcs-storage.js";import{powensIntegrationSpec as b,registerPowensIntegration as x}from"./providers/powens.js";import{createDefaultIntegrationSpecRegistry as S}from"./providers/registry.js";import"./providers/index.js";import{AccountBalanceRecord as C,BankAccountRecord as w,BankTransactionRecord as T}from"./openbanking/models.js";import{OPENBANKING_PII_FIELDS as E,OPENBANKING_TELEMETRY_EVENTS as D,redactOpenBankingTelemetryPayload as O}from"./openbanking/telemetry.js";import{OpenBankingGetAccount as k,OpenBankingListAccounts as A,OpenBankingSyncAccounts as j}from"./openbanking/contracts/accounts.js";import{OpenBankingListTransactions as M,OpenBankingSyncTransactions as N}from"./openbanking/contracts/transactions.js";import{OpenBankingGetBalances as P,OpenBankingRefreshBalances as F}from"./openbanking/contracts/balances.js";import{OpenBankingFeature as I}from"./openbanking/openbanking.feature.js";import{registerOpenBankingContracts as L}from"./openbanking/contracts/index.js";import{assertPrimaryOpenBankingReady as R,ensurePrimaryOpenBankingIntegration as z}from"./openbanking/guards.js";export{C as AccountBalanceRecord,w as BankAccountRecord,T as BankTransactionRecord,e as IntegrationSpecRegistry,E as OPENBANKING_PII_FIELDS,D as OPENBANKING_TELEMETRY_EVENTS,I as OpenBankingFeature,k as OpenBankingGetAccount,P as OpenBankingGetBalances,A as OpenBankingListAccounts,M as OpenBankingListTransactions,F as OpenBankingRefreshBalances,j as OpenBankingSyncAccounts,N as OpenBankingSyncTransactions,R as assertPrimaryOpenBankingReady,S as createDefaultIntegrationSpecRegistry,u as elevenLabsIntegrationSpec,z as ensurePrimaryOpenBankingIntegration,v as gcsStorageIntegrationSpec,f as gmailIntegrationSpec,m as googleCalendarIntegrationSpec,t as makeIntegrationSpecKey,c as mistralIntegrationSpec,i as postmarkIntegrationSpec,b as powensIntegrationSpec,o as qdrantIntegrationSpec,O as redactOpenBankingTelemetryPayload,d as registerElevenLabsIntegration,y as registerGcsStorageIntegration,p as registerGmailIntegration,h as registerGoogleCalendarIntegration,l as registerMistralIntegration,L as registerOpenBankingContracts,a as registerPostmarkIntegration,x as registerPowensIntegration,s as registerQdrantIntegration,n as registerStripeIntegration,g as registerTwilioSmsIntegration,r as stripeIntegrationSpec,_ as twilioSmsIntegrationSpec};

package/dist/integrations/openbanking/contracts/accounts.js

@@ -1 +1 @@
-import{l as e}from"../../../schema/dist/ScalarTypeEnum.js";import{t}from"../../../schema/dist/SchemaModel.js";import"../../../schema/dist/index.js";import{defineCommand as n,defineQuery as r}from"../../../spec.js";import{BankAccountRecord as i}from"../models.js";import{OPENBANKING_TELEMETRY_EVENTS as a}from"../telemetry.js";const o=new t({name:`OpenBankingListAccountsInput`,description:`Parameters for listing bank accounts through the open banking provider.`,fields:{tenantId:{type:e.ID(),isOptional:!1},userId:{type:e.ID(),isOptional:!1},connectionId:{type:e.ID(),isOptional:!0},includeBalances:{type:e.Boolean(),isOptional:!0},institutionId:{type:e.String_unsecure(),isOptional:!0},cursor:{type:e.String_unsecure(),isOptional:!0},pageSize:{type:e.Int_unsecure(),isOptional:!0}}}),s=new t({name:`OpenBankingListAccountsOutput`,description:`Paginated list of bank accounts available to the tenant and user.`,fields:{accounts:{type:i,isOptional:!1,isArray:!0},nextCursor:{type:e.String_unsecure(),isOptional:!0},hasMore:{type:e.Boolean(),isOptional:!0}}}),c=new t({name:`OpenBankingGetAccountInput`,description:`Parameters for retrieving a specific bank account.`,fields:{tenantId:{type:e.ID(),isOptional:!1},accountId:{type:e.ID(),isOptional:!1},includeBalances:{type:e.Boolean(),isOptional:!0},includeLatestTransactions:{type:e.Boolean(),isOptional:!0}}}),l=new t({name:`OpenBankingSyncAccountsInput`,description:`Command payload to trigger an account synchronisation against the open banking provider.`,fields:{tenantId:{type:e.ID(),isOptional:!1},userId:{type:e.ID(),isOptional:!0},connectionId:{type:e.ID(),isOptional:!1},accountIds:{type:e.ID(),isArray:!0,isOptional:!0},forceFullRefresh:{type:e.Boolean(),isOptional:!0},triggerWorkflows:{type:e.Boolean(),isOptional:!0}}}),u=new t({name:`OpenBankingSyncAccountsOutput`,description:`Result of a bank account synchronisation run.`,fields:{synced:{type:e.Int_unsecure(),isOptional:!1},failed:{type:e.Int_unsecure(),isOptional:!1},errors:{type:e.String_unsecure(),isArray:!0,isOptional:!0},nextSyncSuggestedAt:{type:e.DateTime(),isOptional:!0}}}),d=r({meta:{name:`openbanking.accounts.list`,version:1,description:`List bank accounts available to a tenant/user via Powens Open Banking.`,goal:`Provide downstream workflows with the set of accounts accessible via the configured open banking connection.`,context:`Used by Pocket Family Office dashboards and sync workflows to enumerate bank accounts prior to syncing balances or transactions.`,owners:[`platform.finance`],tags:[`open-banking`,`powens`,`accounts`],stability:`experimental`},io:{input:o,output:s},policy:{auth:`user`}}),f=r({meta:{name:`openbanking.accounts.get`,version:1,description:`Retrieve the canonical bank account record for the given account identifier.`,goal:`Allow user-facing experiences and automations to display up-to-date account metadata.`,context:`Invoked by UI surfaces and workflow automation steps that require detailed metadata for a specific bank account.`,owners:[`platform.finance`],tags:[`open-banking`,`powens`,`accounts`],stability:`experimental`},io:{input:c,output:i},policy:{auth:`user`}}),p=n({meta:{name:`openbanking.accounts.sync`,version:1,description:`Initiate a synchronisation run to refresh bank account metadata from Powens.`,goal:`Keep canonical bank account records aligned with the external open banking provider.`,context:`Triggered by scheduled workflows or manual operator actions to reconcile account metadata prior to transaction/balance syncs.`,owners:[`platform.finance`],tags:[`open-banking`,`powens`,`accounts`],stability:`experimental`},io:{input:l,output:u},policy:{auth:`admin`},telemetry:{success:{event:{name:a.accountsSynced},properties:({input:e,output:t})=>{let n=e,r=t;return{tenantId:n?.tenantId,connectionId:n?.connectionId,synced:r?.synced,failed:r?.failed}}},failure:{event:{name:a.accountsSyncFailed},properties:({input:e,error:t})=>{let n=e;return{tenantId:n?.tenantId,connectionId:n?.connectionId,error:t instanceof Error?t.message:String(t??`unknown`)}}}}}),m={OpenBankingListAccounts:d,OpenBankingGetAccount:f,OpenBankingSyncAccounts:p};function h(e){return e.register(d).register(f).register(p)}export{f as OpenBankingGetAccount,d as OpenBankingListAccounts,p as OpenBankingSyncAccounts,m as openBankingAccountContracts,h as registerOpenBankingAccountContracts};
+import{defineCommand as e,defineQuery as t}from"../../../spec.js";import{BankAccountRecord as n}from"../models.js";import{OPENBANKING_TELEMETRY_EVENTS as r}from"../telemetry.js";import{ScalarTypeEnum as i,SchemaModel as a}from"@lssm/lib.schema";const o=new a({name:`OpenBankingListAccountsInput`,description:`Parameters for listing bank accounts through the open banking provider.`,fields:{tenantId:{type:i.ID(),isOptional:!1},userId:{type:i.ID(),isOptional:!1},connectionId:{type:i.ID(),isOptional:!0},includeBalances:{type:i.Boolean(),isOptional:!0},institutionId:{type:i.String_unsecure(),isOptional:!0},cursor:{type:i.String_unsecure(),isOptional:!0},pageSize:{type:i.Int_unsecure(),isOptional:!0}}}),s=new a({name:`OpenBankingListAccountsOutput`,description:`Paginated list of bank accounts available to the tenant and user.`,fields:{accounts:{type:n,isOptional:!1,isArray:!0},nextCursor:{type:i.String_unsecure(),isOptional:!0},hasMore:{type:i.Boolean(),isOptional:!0}}}),c=new a({name:`OpenBankingGetAccountInput`,description:`Parameters for retrieving a specific bank account.`,fields:{tenantId:{type:i.ID(),isOptional:!1},accountId:{type:i.ID(),isOptional:!1},includeBalances:{type:i.Boolean(),isOptional:!0},includeLatestTransactions:{type:i.Boolean(),isOptional:!0}}}),l=new a({name:`OpenBankingSyncAccountsInput`,description:`Command payload to trigger an account synchronisation against the open banking provider.`,fields:{tenantId:{type:i.ID(),isOptional:!1},userId:{type:i.ID(),isOptional:!0},connectionId:{type:i.ID(),isOptional:!1},accountIds:{type:i.ID(),isArray:!0,isOptional:!0},forceFullRefresh:{type:i.Boolean(),isOptional:!0},triggerWorkflows:{type:i.Boolean(),isOptional:!0}}}),u=new a({name:`OpenBankingSyncAccountsOutput`,description:`Result of a bank account synchronisation run.`,fields:{synced:{type:i.Int_unsecure(),isOptional:!1},failed:{type:i.Int_unsecure(),isOptional:!1},errors:{type:i.String_unsecure(),isArray:!0,isOptional:!0},nextSyncSuggestedAt:{type:i.DateTime(),isOptional:!0}}}),d=t({meta:{name:`openbanking.accounts.list`,version:1,description:`List bank accounts available to a tenant/user via Powens Open Banking.`,goal:`Provide downstream workflows with the set of accounts accessible via the configured open banking connection.`,context:`Used by Pocket Family Office dashboards and sync workflows to enumerate bank accounts prior to syncing balances or transactions.`,owners:[`platform.finance`],tags:[`open-banking`,`powens`,`accounts`],stability:`experimental`},io:{input:o,output:s},policy:{auth:`user`}}),f=t({meta:{name:`openbanking.accounts.get`,version:1,description:`Retrieve the canonical bank account record for the given account identifier.`,goal:`Allow user-facing experiences and automations to display up-to-date account metadata.`,context:`Invoked by UI surfaces and workflow automation steps that require detailed metadata for a specific bank account.`,owners:[`platform.finance`],tags:[`open-banking`,`powens`,`accounts`],stability:`experimental`},io:{input:c,output:n},policy:{auth:`user`}}),p=e({meta:{name:`openbanking.accounts.sync`,version:1,description:`Initiate a synchronisation run to refresh bank account metadata from Powens.`,goal:`Keep canonical bank account records aligned with the external open banking provider.`,context:`Triggered by scheduled workflows or manual operator actions to reconcile account metadata prior to transaction/balance syncs.`,owners:[`platform.finance`],tags:[`open-banking`,`powens`,`accounts`],stability:`experimental`},io:{input:l,output:u},policy:{auth:`admin`},telemetry:{success:{event:{name:r.accountsSynced},properties:({input:e,output:t})=>{let n=e,r=t;return{tenantId:n?.tenantId,connectionId:n?.connectionId,synced:r?.synced,failed:r?.failed}}},failure:{event:{name:r.accountsSyncFailed},properties:({input:e,error:t})=>{let n=e;return{tenantId:n?.tenantId,connectionId:n?.connectionId,error:t instanceof Error?t.message:String(t??`unknown`)}}}}}),m={OpenBankingListAccounts:d,OpenBankingGetAccount:f,OpenBankingSyncAccounts:p};function h(e){return e.register(d).register(f).register(p)}export{f as OpenBankingGetAccount,d as OpenBankingListAccounts,p as OpenBankingSyncAccounts,m as openBankingAccountContracts,h as registerOpenBankingAccountContracts};