@lssm/lib.contracts 0.0.0-canary-20251217052941 → 0.0.0-canary-20251217060433

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. package/dist/app-config/app-config.feature.d.ts +11 -0
  2. package/dist/app-config/branding.d.ts +55 -0
  3. package/dist/app-config/contracts.d.ts +244 -0
  4. package/dist/app-config/docs/app-config.docblock.d.ts +6 -0
  5. package/dist/app-config/events.d.ts +122 -0
  6. package/dist/app-config/index.d.ts +9 -0
  7. package/dist/app-config/lifecycle-contracts.d.ts +382 -0
  8. package/dist/app-config/lifecycle.d.ts +27 -0
  9. package/dist/app-config/runtime.d.ts +114 -0
  10. package/dist/app-config/spec.d.ts +175 -0
  11. package/dist/app-config/validation.d.ts +47 -0
  12. package/dist/capabilities/docs/capabilities.docblock.d.ts +6 -0
  13. package/dist/capabilities/openbanking.d.ts +9 -0
  14. package/dist/capabilities.d.ts +48 -0
  15. package/dist/client/index.d.ts +6 -0
  16. package/dist/client/react/drivers/rn-reusables.d.ts +22 -0
  17. package/dist/client/react/drivers/shadcn.d.ts +12 -0
  18. package/dist/client/react/feature-render.d.ts +19 -0
  19. package/dist/client/react/form-render.d.ts +91 -0
  20. package/dist/client/react/index.d.ts +5 -0
  21. package/dist/contract-registry/index.d.ts +3 -0
  22. package/dist/contract-registry/schemas.d.ts +124 -0
  23. package/dist/contract-registry/types.d.ts +46 -0
  24. package/dist/contracts-adapter-hydration.d.ts +15 -0
  25. package/dist/contracts-adapter-input.d.ts +10 -0
  26. package/dist/data-views/docs/data-views.docblock.d.ts +6 -0
  27. package/dist/data-views/query-generator.d.ts +39 -0
  28. package/dist/data-views/runtime.d.ts +26 -0
  29. package/dist/data-views.d.ts +131 -0
  30. package/dist/docs/PUBLISHING.docblock.d.ts +6 -0
  31. package/dist/docs/accessibility_wcag_compliance_specs.docblock.d.ts +6 -0
  32. package/dist/docs/index.d.ts +6 -0
  33. package/dist/docs/meta.docs.d.ts +6 -0
  34. package/dist/docs/presentations.d.ts +33 -0
  35. package/dist/docs/registry.d.ts +24 -0
  36. package/dist/docs/tech/PHASE_1_QUICKSTART.docblock.d.ts +6 -0
  37. package/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.d.ts +6 -0
  38. package/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.d.ts +6 -0
  39. package/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.d.ts +6 -0
  40. package/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.d.ts +6 -0
  41. package/dist/docs/tech/auth/better-auth-nextjs.docblock.d.ts +6 -0
  42. package/dist/docs/tech/contracts/README.docblock.d.ts +6 -0
  43. package/dist/docs/tech/contracts/create-subscription.docblock.d.ts +6 -0
  44. package/dist/docs/tech/contracts/graphql-typed-outputs.docblock.d.ts +6 -0
  45. package/dist/docs/tech/contracts/migrations.docblock.d.ts +6 -0
  46. package/dist/docs/tech/contracts/openapi-export.docblock.d.ts +6 -0
  47. package/dist/docs/tech/contracts/ops-to-presentation-linking.docblock.d.ts +6 -0
  48. package/dist/docs/tech/contracts/overlays.docblock.d.ts +6 -0
  49. package/dist/docs/tech/contracts/tests.docblock.d.ts +6 -0
  50. package/dist/docs/tech/contracts/themes.docblock.d.ts +6 -0
  51. package/dist/docs/tech/contracts/vertical-pocket-family-office.docblock.d.ts +6 -0
  52. package/dist/docs/tech/lifecycle-stage-system.docblock.d.ts +6 -0
  53. package/dist/docs/tech/llm/llm-integration.docblock.d.ts +7 -0
  54. package/dist/docs/tech/mcp-endpoints.docblock.d.ts +6 -0
  55. package/dist/docs/tech/presentation-runtime.docblock.d.ts +6 -0
  56. package/dist/docs/tech/schema/README.docblock.d.ts +6 -0
  57. package/dist/docs/tech/studio/learning-events.docblock.d.ts +6 -0
  58. package/dist/docs/tech/studio/learning-journeys.docblock.d.ts +6 -0
  59. package/dist/docs/tech/studio/platform-admin-panel.docblock.d.ts +6 -0
  60. package/dist/docs/tech/studio/project-access-teams.docblock.d.ts +6 -0
  61. package/dist/docs/tech/studio/project-routing.docblock.d.ts +6 -0
  62. package/dist/docs/tech/studio/sandbox-unlogged.docblock.d.ts +6 -0
  63. package/dist/docs/tech/studio/team-invitations.docblock.d.ts +6 -0
  64. package/dist/docs/tech/studio/workspace-ops.docblock.d.ts +6 -0
  65. package/dist/docs/tech/studio/workspaces.docblock.d.ts +6 -0
  66. package/dist/docs/tech/telemetry-ingest.docblock.d.ts +6 -0
  67. package/dist/docs/tech/templates/runtime.docblock.d.ts +6 -0
  68. package/dist/docs/tech/vscode-extension.docblock.d.ts +6 -0
  69. package/dist/docs/tech/workflows/overview.docblock.d.ts +6 -0
  70. package/dist/docs/tech-contracts.docs.d.ts +6 -0
  71. package/dist/docs/types.d.ts +41 -0
  72. package/dist/events.d.ts +47 -0
  73. package/dist/experiments/docs/experiments.docblock.d.ts +6 -0
  74. package/dist/experiments/evaluator.d.ts +37 -0
  75. package/dist/experiments/spec-resolver.d.ts +16 -0
  76. package/dist/experiments/spec.d.ts +89 -0
  77. package/dist/features.d.ts +96 -0
  78. package/dist/forms/docs/forms.docblock.d.ts +6 -0
  79. package/dist/forms.d.ts +258 -0
  80. package/dist/index.d.ts +127 -0
  81. package/dist/install.d.ts +76 -0
  82. package/dist/integrations/binding.d.ts +17 -0
  83. package/dist/integrations/connection.d.ts +51 -0
  84. package/dist/integrations/contracts.d.ts +435 -0
  85. package/dist/integrations/docs/integrations.docblock.d.ts +6 -0
  86. package/dist/integrations/health.d.ts +21 -0
  87. package/dist/integrations/index.d.ts +34 -0
  88. package/dist/integrations/openbanking/contracts/accounts.d.ts +287 -0
  89. package/dist/integrations/openbanking/contracts/balances.d.ts +163 -0
  90. package/dist/integrations/openbanking/contracts/index.d.ts +10 -0
  91. package/dist/integrations/openbanking/contracts/transactions.d.ts +211 -0
  92. package/dist/integrations/openbanking/guards.d.ts +12 -0
  93. package/dist/integrations/openbanking/models.d.ts +228 -0
  94. package/dist/integrations/openbanking/openbanking.feature.d.ts +11 -0
  95. package/dist/integrations/openbanking/telemetry.d.ts +15 -0
  96. package/dist/integrations/providers/calendar.d.ts +78 -0
  97. package/dist/integrations/providers/elevenlabs.d.ts +7 -0
  98. package/dist/integrations/providers/email.d.ts +86 -0
  99. package/dist/integrations/providers/embedding.d.ts +24 -0
  100. package/dist/integrations/providers/gcs-storage.d.ts +7 -0
  101. package/dist/integrations/providers/gmail.d.ts +7 -0
  102. package/dist/integrations/providers/google-calendar.d.ts +7 -0
  103. package/dist/integrations/providers/impls/elevenlabs-voice.d.ts +20 -0
  104. package/dist/integrations/providers/impls/gcs-storage.d.ts +24 -0
  105. package/dist/integrations/providers/impls/gmail-inbound.d.ts +26 -0
  106. package/dist/integrations/providers/impls/gmail-outbound.d.ts +18 -0
  107. package/dist/integrations/providers/impls/google-calendar.d.ts +23 -0
  108. package/dist/integrations/providers/impls/index.d.ts +15 -0
  109. package/dist/integrations/providers/impls/mistral-embedding.d.ts +23 -0
  110. package/dist/integrations/providers/impls/mistral-llm.d.ts +31 -0
  111. package/dist/integrations/providers/impls/postmark-email.d.ts +19 -0
  112. package/dist/integrations/providers/impls/powens-client.d.ts +124 -0
  113. package/dist/integrations/providers/impls/powens-openbanking.d.ts +27 -0
  114. package/dist/integrations/providers/impls/provider-factory.d.ts +26 -0
  115. package/dist/integrations/providers/impls/qdrant-vector.d.ts +24 -0
  116. package/dist/integrations/providers/impls/stripe-payments.d.ts +28 -0
  117. package/dist/integrations/providers/impls/twilio-sms.d.ts +20 -0
  118. package/dist/integrations/providers/index.d.ts +22 -0
  119. package/dist/integrations/providers/llm.d.ts +82 -0
  120. package/dist/integrations/providers/mistral.d.ts +7 -0
  121. package/dist/integrations/providers/openbanking.d.ts +128 -0
  122. package/dist/integrations/providers/payments.d.ts +109 -0
  123. package/dist/integrations/providers/postmark.d.ts +7 -0
  124. package/dist/integrations/providers/powens.d.ts +7 -0
  125. package/dist/integrations/providers/qdrant.d.ts +7 -0
  126. package/dist/integrations/providers/registry.d.ts +11 -0
  127. package/dist/integrations/providers/sms.d.ts +34 -0
  128. package/dist/integrations/providers/storage.d.ts +60 -0
  129. package/dist/integrations/providers/stripe.d.ts +7 -0
  130. package/dist/integrations/providers/twilio-sms.d.ts +7 -0
  131. package/dist/integrations/providers/vector-store.d.ts +43 -0
  132. package/dist/integrations/providers/voice.d.ts +34 -0
  133. package/dist/integrations/runtime.d.ts +99 -0
  134. package/dist/integrations/secrets/aws-secret-manager.d.ts +31 -0
  135. package/dist/integrations/secrets/env-secret-provider.d.ts +31 -0
  136. package/dist/integrations/secrets/gcp-secret-manager.d.ts +32 -0
  137. package/dist/integrations/secrets/gcp-secret-manager.js +1 -1
  138. package/dist/integrations/secrets/index.d.ts +7 -0
  139. package/dist/integrations/secrets/manager.d.ts +47 -0
  140. package/dist/integrations/secrets/provider.d.ts +52 -0
  141. package/dist/integrations/secrets/scaleway-secret-manager.d.ts +38 -0
  142. package/dist/integrations/spec.d.ts +79 -0
  143. package/dist/jobs/define-job.d.ts +18 -0
  144. package/dist/jobs/gcp-cloud-tasks.d.ts +41 -0
  145. package/dist/jobs/gcp-pubsub.d.ts +25 -0
  146. package/dist/jobs/handlers/gmail-sync-handler.d.ts +9 -0
  147. package/dist/jobs/handlers/index.d.ts +9 -0
  148. package/dist/jobs/handlers/ping-handler.d.ts +10 -0
  149. package/dist/jobs/handlers/storage-document-handler.d.ts +12 -0
  150. package/dist/jobs/index.d.ts +3 -0
  151. package/dist/jobs/memory-queue.d.ts +18 -0
  152. package/dist/jobs/queue.d.ts +131 -0
  153. package/dist/jobs/scaleway-sqs-queue.d.ts +30 -0
  154. package/dist/jsonschema.d.ts +27 -0
  155. package/dist/knowledge/binding.d.ts +25 -0
  156. package/dist/knowledge/contracts.d.ts +316 -0
  157. package/dist/knowledge/docs/knowledge.docblock.d.ts +6 -0
  158. package/dist/knowledge/index.d.ts +10 -0
  159. package/dist/knowledge/ingestion/document-processor.d.ts +24 -0
  160. package/dist/knowledge/ingestion/embedding-service.d.ts +12 -0
  161. package/dist/knowledge/ingestion/gmail-adapter.d.ts +18 -0
  162. package/dist/knowledge/ingestion/index.d.ts +6 -0
  163. package/dist/knowledge/ingestion/storage-adapter.d.ts +15 -0
  164. package/dist/knowledge/ingestion/vector-indexer.d.ts +18 -0
  165. package/dist/knowledge/query/index.d.ts +2 -0
  166. package/dist/knowledge/query/service.d.ts +29 -0
  167. package/dist/knowledge/runtime.d.ts +32 -0
  168. package/dist/knowledge/source.d.ts +32 -0
  169. package/dist/knowledge/spaces/email-threads.d.ts +7 -0
  170. package/dist/knowledge/spaces/financial-docs.d.ts +7 -0
  171. package/dist/knowledge/spaces/financial-overview.d.ts +7 -0
  172. package/dist/knowledge/spaces/index.d.ts +7 -0
  173. package/dist/knowledge/spaces/product-canon.d.ts +7 -0
  174. package/dist/knowledge/spaces/support-faq.d.ts +7 -0
  175. package/dist/knowledge/spaces/uploaded-docs.d.ts +7 -0
  176. package/dist/knowledge/spec.d.ts +52 -0
  177. package/dist/llm/exporters.d.ts +67 -0
  178. package/dist/llm/index.d.ts +4 -0
  179. package/dist/llm/prompts.d.ts +51 -0
  180. package/dist/llm/types.d.ts +213 -0
  181. package/dist/markdown.d.ts +21 -0
  182. package/dist/migrations.d.ts +52 -0
  183. package/dist/onboarding-base.d.ts +137 -0
  184. package/dist/openapi.d.ts +31 -0
  185. package/dist/openbanking/docs/openbanking.docblock.d.ts +6 -0
  186. package/dist/ownership.d.ts +75 -0
  187. package/dist/policy/docs/policy.docblock.d.ts +6 -0
  188. package/dist/policy/engine.d.ts +39 -0
  189. package/dist/policy/opa-adapter.d.ts +45 -0
  190. package/dist/policy/spec.d.ts +114 -0
  191. package/dist/presentations/docs/presentations-conventions.docblock.d.ts +6 -0
  192. package/dist/presentations.backcompat.d.ts +7 -0
  193. package/dist/presentations.d.ts +98 -0
  194. package/dist/presentations.v2.d.ts +114 -0
  195. package/dist/prompt.d.ts +60 -0
  196. package/dist/promptRegistry.d.ts +15 -0
  197. package/dist/regenerator/adapters.d.ts +19 -0
  198. package/dist/regenerator/docs/regenerator.docblock.d.ts +6 -0
  199. package/dist/regenerator/executor.d.ts +70 -0
  200. package/dist/regenerator/index.d.ts +7 -0
  201. package/dist/regenerator/service.d.ts +33 -0
  202. package/dist/regenerator/sinks.d.ts +26 -0
  203. package/dist/regenerator/types.d.ts +107 -0
  204. package/dist/regenerator/utils.d.ts +9 -0
  205. package/dist/registry.d.ts +73 -0
  206. package/dist/resources.d.ts +64 -0
  207. package/dist/schema-to-markdown.d.ts +54 -0
  208. package/dist/server/graphql-pothos.d.ts +27 -0
  209. package/dist/server/index.d.ts +9 -0
  210. package/dist/server/mcp/createMcpServer.d.ts +15 -0
  211. package/dist/server/mcp/mcpTypes.d.ts +29 -0
  212. package/dist/server/mcp/registerPresentations.d.ts +7 -0
  213. package/dist/server/mcp/registerPrompts.d.ts +8 -0
  214. package/dist/server/mcp/registerResources.d.ts +8 -0
  215. package/dist/server/mcp/registerTools.d.ts +8 -0
  216. package/dist/server/provider-mcp.d.ts +2 -0
  217. package/dist/server/rest-elysia.d.ts +40 -0
  218. package/dist/server/rest-express.d.ts +16 -0
  219. package/dist/server/rest-generic.d.ts +32 -0
  220. package/dist/server/rest-next-app.d.ts +35 -0
  221. package/dist/server/rest-next-mcp.d.ts +11 -0
  222. package/dist/server/rest-next-pages.d.ts +9 -0
  223. package/dist/spec.d.ts +195 -0
  224. package/dist/telemetry/anomaly.d.ts +27 -0
  225. package/dist/telemetry/docs/telemetry.docblock.d.ts +6 -0
  226. package/dist/telemetry/index.d.ts +4 -0
  227. package/dist/telemetry/spec.d.ts +98 -0
  228. package/dist/telemetry/tracker.d.ts +51 -0
  229. package/dist/tests/index.d.ts +3 -0
  230. package/dist/tests/runner.d.ts +43 -0
  231. package/dist/tests/spec.d.ts +89 -0
  232. package/dist/themes.d.ts +55 -0
  233. package/dist/translations/catalog.d.ts +28 -0
  234. package/dist/translations/tenant.d.ts +15 -0
  235. package/dist/types/all.d.ts +60 -0
  236. package/dist/types.d.ts +88 -0
  237. package/dist/workflow/adapters/db-adapter.d.ts +34 -0
  238. package/dist/workflow/adapters/file-adapter.d.ts +14 -0
  239. package/dist/workflow/adapters/index.d.ts +4 -0
  240. package/dist/workflow/adapters/memory-store.d.ts +18 -0
  241. package/dist/workflow/expression.d.ts +9 -0
  242. package/dist/workflow/index.d.ts +10 -0
  243. package/dist/workflow/runner.d.ts +74 -0
  244. package/dist/workflow/sla-monitor.d.ts +20 -0
  245. package/dist/workflow/spec.d.ts +99 -0
  246. package/dist/workflow/state.d.ts +35 -0
  247. package/dist/workflow/validation.d.ts +28 -0
  248. package/package.json +250 -250
@@ -0,0 +1,41 @@
1
+ import { EnqueueOptions, Job, JobHandler, JobQueue } from "./queue.js";
2
+
3
+ //#region src/jobs/gcp-cloud-tasks.d.ts
4
+ interface CloudTasksClientLike {
5
+ createTask(request: {
6
+ parent: string;
7
+ task: {
8
+ httpRequest: {
9
+ httpMethod: number | string;
10
+ url: string;
11
+ body: Buffer;
12
+ headers?: Record<string, string>;
13
+ oidcToken?: {
14
+ serviceAccountEmail: string;
15
+ };
16
+ };
17
+ scheduleTime?: {
18
+ seconds: number;
19
+ };
20
+ };
21
+ }): Promise<unknown>;
22
+ }
23
+ interface GcpCloudTasksQueueOptions {
24
+ client: CloudTasksClientLike;
25
+ projectId: string;
26
+ location: string;
27
+ queue: string;
28
+ resolveUrl(jobType: string): string;
29
+ serviceAccountEmail?: string;
30
+ }
31
+ declare class GcpCloudTasksQueue implements JobQueue {
32
+ private readonly options;
33
+ private readonly handlers;
34
+ constructor(options: GcpCloudTasksQueueOptions);
35
+ enqueue<TPayload>(jobType: string, payload: TPayload, options?: EnqueueOptions): Promise<Job<TPayload>>;
36
+ register<TPayload, TResult = void>(jobType: string, handler: JobHandler<TPayload, TResult>): void;
37
+ start(): void;
38
+ stop(): Promise<void>;
39
+ }
40
+ //#endregion
41
+ export { GcpCloudTasksQueue, GcpCloudTasksQueueOptions };
@@ -0,0 +1,25 @@
1
+ import { EnqueueOptions, Job, JobHandler, JobQueue } from "./queue.js";
2
+
3
+ //#region src/jobs/gcp-pubsub.d.ts
4
+ interface PubSubClientLike {
5
+ topic(name: string): {
6
+ publishMessage(message: {
7
+ data: Buffer;
8
+ }): Promise<string>;
9
+ };
10
+ }
11
+ interface GcpPubSubQueueOptions {
12
+ client: PubSubClientLike;
13
+ topicName: string;
14
+ }
15
+ declare class GcpPubSubQueue implements JobQueue {
16
+ private readonly options;
17
+ private readonly handlers;
18
+ constructor(options: GcpPubSubQueueOptions);
19
+ enqueue<TPayload>(jobType: string, payload: TPayload, options?: EnqueueOptions): Promise<Job<TPayload>>;
20
+ register<TPayload, TResult = void>(jobType: string, handler: JobHandler<TPayload, TResult>): void;
21
+ start(): void;
22
+ stop(): Promise<void>;
23
+ }
24
+ //#endregion
25
+ export { GcpPubSubQueue, GcpPubSubQueueOptions };
@@ -0,0 +1,9 @@
1
+ import { EmailThreadListQuery } from "../../integrations/providers/email.js";
2
+ import { JobHandler } from "../queue.js";
3
+ import { GmailIngestionAdapter } from "../../knowledge/ingestion/gmail-adapter.js";
4
+
5
+ //#region src/jobs/handlers/gmail-sync-handler.d.ts
6
+ interface GmailSyncJobPayload extends EmailThreadListQuery {}
7
+ declare function createGmailSyncHandler(adapter: GmailIngestionAdapter): JobHandler<GmailSyncJobPayload>;
8
+ //#endregion
9
+ export { GmailSyncJobPayload, createGmailSyncHandler };
@@ -0,0 +1,9 @@
1
+ import { JobQueue } from "../queue.js";
2
+ import { GmailSyncJobPayload, createGmailSyncHandler } from "./gmail-sync-handler.js";
3
+ import { PING_JOB_TYPE, PingPayload, PingPayloadSchema, pingJob } from "./ping-handler.js";
4
+ import { StorageDocumentJobPayload, createStorageDocumentHandler } from "./storage-document-handler.js";
5
+
6
+ //#region src/jobs/handlers/index.d.ts
7
+ declare function registerAllJobs(queue: JobQueue): void;
8
+ //#endregion
9
+ export { GmailSyncJobPayload, PING_JOB_TYPE, PingPayload, PingPayloadSchema, StorageDocumentJobPayload, createGmailSyncHandler, createStorageDocumentHandler, pingJob, registerAllJobs };
@@ -0,0 +1,10 @@
1
+ import { DefinedJob } from "../define-job.js";
2
+ import * as z$1 from "zod";
3
+
4
+ //#region src/jobs/handlers/ping-handler.d.ts
5
+ declare const PING_JOB_TYPE: "core.ping";
6
+ declare const PingPayloadSchema: z$1.ZodObject<{}, z$1.core.$strip>;
7
+ type PingPayload = z$1.infer<typeof PingPayloadSchema>;
8
+ declare const pingJob: DefinedJob<PingPayload>;
9
+ //#endregion
10
+ export { PING_JOB_TYPE, PingPayload, PingPayloadSchema, pingJob };
@@ -0,0 +1,12 @@
1
+ import { ObjectStorageProvider } from "../../integrations/providers/storage.js";
2
+ import { JobHandler } from "../queue.js";
3
+ import { StorageIngestionAdapter } from "../../knowledge/ingestion/storage-adapter.js";
4
+
5
+ //#region src/jobs/handlers/storage-document-handler.d.ts
6
+ interface StorageDocumentJobPayload {
7
+ bucket: string;
8
+ key: string;
9
+ }
10
+ declare function createStorageDocumentHandler(storage: ObjectStorageProvider, adapter: StorageIngestionAdapter): JobHandler<StorageDocumentJobPayload>;
11
+ //#endregion
12
+ export { StorageDocumentJobPayload, createStorageDocumentHandler };
@@ -0,0 +1,3 @@
1
+ import { DEFAULT_RETRY_POLICY, EnqueueOptions, Job, JobHandler, JobQueue, JobStatus, JobTypeDef, QueueStats, RetryPolicy, calculateBackoff, defineJobType } from "./queue.js";
2
+ import { DefinedJob, registerDefinedJob } from "./define-job.js";
3
+ export { DEFAULT_RETRY_POLICY, DefinedJob, EnqueueOptions, Job, JobHandler, JobQueue, JobStatus, JobTypeDef, QueueStats, RetryPolicy, calculateBackoff, defineJobType, registerDefinedJob };
@@ -0,0 +1,18 @@
1
+ import { EnqueueOptions, Job, JobHandler, JobQueue } from "./queue.js";
2
+
3
+ //#region src/jobs/memory-queue.d.ts
4
+ declare class MemoryJobQueue implements JobQueue {
5
+ private readonly pollIntervalMs;
6
+ private readonly jobs;
7
+ private readonly handlers;
8
+ private timer?;
9
+ private processing;
10
+ constructor(pollIntervalMs?: number);
11
+ enqueue<TPayload>(jobType: string, payload: TPayload, options?: EnqueueOptions): Promise<Job<TPayload>>;
12
+ register<TPayload, TResult = void>(jobType: string, handler: JobHandler<TPayload, TResult>): void;
13
+ start(): void;
14
+ stop(): Promise<void>;
15
+ private processNext;
16
+ }
17
+ //#endregion
18
+ export { MemoryJobQueue };
@@ -0,0 +1,131 @@
1
+ import * as z$1 from "zod";
2
+
3
+ //#region src/jobs/queue.d.ts
4
+
5
+ /**
6
+ * Job status values.
7
+ */
8
+ type JobStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'dead_letter';
9
+ /**
10
+ * A job in the queue.
11
+ */
12
+ interface Job<TPayload = unknown> {
13
+ id: string;
14
+ type: string;
15
+ version: number;
16
+ payload: TPayload;
17
+ status: JobStatus;
18
+ priority: number;
19
+ attempts: number;
20
+ maxRetries: number;
21
+ createdAt: Date;
22
+ updatedAt: Date;
23
+ scheduledAt?: Date;
24
+ startedAt?: Date;
25
+ completedAt?: Date;
26
+ timeoutAt?: Date;
27
+ lastError?: string;
28
+ dedupeKey?: string;
29
+ tenantId?: string;
30
+ userId?: string;
31
+ traceId?: string;
32
+ metadata?: Record<string, unknown>;
33
+ result?: unknown;
34
+ }
35
+ /**
36
+ * Options for enqueueing a job.
37
+ */
38
+ interface EnqueueOptions {
39
+ /** Delay execution by this many seconds */
40
+ delaySeconds?: number;
41
+ /** Key for deduplication (only one job with this key can be pending) */
42
+ dedupeKey?: string;
43
+ /** Maximum retry attempts (overrides job type default) */
44
+ maxRetries?: number;
45
+ /** Job priority (higher = more urgent) */
46
+ priority?: number;
47
+ /** Timeout in milliseconds */
48
+ timeoutMs?: number;
49
+ /** Tenant context */
50
+ tenantId?: string;
51
+ /** User who enqueued */
52
+ userId?: string;
53
+ /** Trace ID for distributed tracing */
54
+ traceId?: string;
55
+ /** Additional metadata */
56
+ metadata?: Record<string, unknown>;
57
+ }
58
+ /**
59
+ * Job handler function.
60
+ */
61
+ type JobHandler<TPayload = unknown, TResult = void> = (job: Job<TPayload>) => Promise<TResult>;
62
+ /**
63
+ * Job queue interface.
64
+ */
65
+ interface JobQueue {
66
+ /** Enqueue a new job */
67
+ enqueue<TPayload>(jobType: string, payload: TPayload, options?: EnqueueOptions): Promise<Job<TPayload>>;
68
+ /** Register a handler for a job type */
69
+ register<TPayload, TResult = void>(jobType: string, handler: JobHandler<TPayload, TResult>): void;
70
+ /** Start processing jobs */
71
+ start(): void;
72
+ /** Stop processing jobs gracefully */
73
+ stop(): Promise<void>;
74
+ /** Get job by ID */
75
+ getJob?(jobId: string): Promise<Job | null>;
76
+ /** Cancel a pending job */
77
+ cancelJob?(jobId: string): Promise<boolean>;
78
+ /** Get queue stats */
79
+ getStats?(): Promise<QueueStats>;
80
+ }
81
+ /**
82
+ * Queue statistics.
83
+ */
84
+ interface QueueStats {
85
+ pending: number;
86
+ running: number;
87
+ completed: number;
88
+ failed: number;
89
+ deadLetter: number;
90
+ }
91
+ /**
92
+ * Retry policy configuration.
93
+ */
94
+ interface RetryPolicy {
95
+ /** Maximum number of retry attempts */
96
+ maxRetries: number;
97
+ /** Initial backoff in milliseconds */
98
+ initialBackoffMs: number;
99
+ /** Maximum backoff in milliseconds */
100
+ maxBackoffMs: number;
101
+ /** Backoff multiplier (exponential) */
102
+ multiplier: number;
103
+ /** Add jitter to backoff */
104
+ jitter: boolean;
105
+ }
106
+ /**
107
+ * Default retry policy.
108
+ */
109
+ declare const DEFAULT_RETRY_POLICY: RetryPolicy;
110
+ /**
111
+ * Calculate backoff delay for a retry attempt.
112
+ */
113
+ declare function calculateBackoff(attempt: number, policy?: RetryPolicy): number;
114
+ /**
115
+ * Job type definition.
116
+ */
117
+ interface JobTypeDef<TPayload = unknown> {
118
+ type: string;
119
+ version: number;
120
+ payload: z$1.ZodType<TPayload>;
121
+ options?: Partial<RetryPolicy & {
122
+ timeoutMs: number;
123
+ }>;
124
+ description?: string;
125
+ }
126
+ /**
127
+ * Define a typed job type.
128
+ */
129
+ declare function defineJobType<TPayload>(def: JobTypeDef<TPayload>): JobTypeDef<TPayload>;
130
+ //#endregion
131
+ export { DEFAULT_RETRY_POLICY, EnqueueOptions, Job, JobHandler, JobQueue, JobStatus, JobTypeDef, QueueStats, RetryPolicy, calculateBackoff, defineJobType };
@@ -0,0 +1,30 @@
1
+ import { EnqueueOptions, Job, JobHandler, JobQueue } from "./queue.js";
2
+
3
+ //#region src/jobs/scaleway-sqs-queue.d.ts
4
+ interface ScalewaySqsQueueConfig {
5
+ queueUrl: string;
6
+ region?: string;
7
+ endpoint?: string;
8
+ waitTimeSeconds?: number;
9
+ maxNumberOfMessages?: number;
10
+ visibilityTimeoutSeconds?: number;
11
+ }
12
+ declare class ScalewaySqsJobQueue implements JobQueue {
13
+ private readonly sqs;
14
+ private readonly queueUrl;
15
+ private readonly waitTimeSeconds;
16
+ private readonly maxNumberOfMessages;
17
+ private readonly visibilityTimeoutSeconds;
18
+ private readonly handlers;
19
+ private running;
20
+ constructor(config: ScalewaySqsQueueConfig);
21
+ enqueue<TPayload>(jobType: string, payload: TPayload, options?: EnqueueOptions): Promise<Job<TPayload>>;
22
+ register<TPayload, TResult = void>(jobType: string, handler: JobHandler<TPayload, TResult>): void;
23
+ start(): void;
24
+ stop(): Promise<void>;
25
+ private pollLoop;
26
+ private deleteMessage;
27
+ private sleep;
28
+ }
29
+ //#endregion
30
+ export { ScalewaySqsJobQueue };
@@ -0,0 +1,27 @@
1
+ import { Stability, Tag } from "./ownership.js";
2
+ import { ContractSpec, OpKind } from "./spec.js";
3
+ import * as _lssm_lib_schema0 from "@lssm/lib.schema";
4
+ import { AnySchemaModel } from "@lssm/lib.schema";
5
+ import z from "zod";
6
+
7
+ //#region src/jsonschema.d.ts
8
+ declare function jsonSchemaForSpec(spec: ContractSpec<AnySchemaModel, AnySchemaModel>): {
9
+ input: z.core.ZodStandardJSONSchemaPayload<_lssm_lib_schema0.TopLevelZodFromModel<_lssm_lib_schema0.SchemaModelFieldsAnyConfig<AnySchemaModel | _lssm_lib_schema0.AnyFieldType | _lssm_lib_schema0.AnyEnumType>>> | null;
10
+ output: z.core.ZodStandardJSONSchemaPayload<_lssm_lib_schema0.TopLevelZodFromModel<_lssm_lib_schema0.SchemaModelFieldsAnyConfig<AnySchemaModel | _lssm_lib_schema0.AnyFieldType | _lssm_lib_schema0.AnyEnumType>>> | null;
11
+ meta: {
12
+ name: string;
13
+ version: number;
14
+ kind: OpKind;
15
+ description: string;
16
+ tags: Tag[];
17
+ stability: Stability;
18
+ };
19
+ };
20
+ /** Helper to derive default REST path */
21
+ declare function defaultRestPath(name: string, version: number): string;
22
+ /** Helper to derive default MCP tool name */
23
+ declare function defaultMcpTool(name: string, version: number): string;
24
+ /** Helper to derive default GraphQL field name */
25
+ declare function defaultGqlField(name: string, version: number): string;
26
+ //#endregion
27
+ export { defaultGqlField, defaultMcpTool, defaultRestPath, jsonSchemaForSpec };
@@ -0,0 +1,25 @@
1
+ //#region src/knowledge/binding.d.ts
2
+ interface AppKnowledgeBinding {
3
+ /** Which KnowledgeSpace to use. */
4
+ spaceKey: string;
5
+ spaceVersion?: number;
6
+ /** Optional: scope to specific workflows/agents. */
7
+ scope?: {
8
+ workflows?: string[];
9
+ agents?: string[];
10
+ operations?: string[];
11
+ };
12
+ /** Usage constraints. */
13
+ constraints?: {
14
+ /** Max tokens per query. */
15
+ maxTokensPerQuery?: number;
16
+ /** Max queries per minute. */
17
+ maxQueriesPerMinute?: number;
18
+ };
19
+ /** Priority when multiple spaces overlap. */
20
+ priority?: number;
21
+ /** Whether access to the space is required (blocking) or optional. */
22
+ required?: boolean;
23
+ }
24
+ //#endregion
25
+ export { AppKnowledgeBinding };
@@ -0,0 +1,316 @@
1
+ import { ContractSpec } from "../spec.js";
2
+ import { SpecRegistry } from "../registry.js";
3
+ import * as _lssm_lib_schema316 from "@lssm/lib.schema";
4
+ import { SchemaModel } from "@lssm/lib.schema";
5
+
6
+ //#region src/knowledge/contracts.d.ts
7
+ declare const CreateKnowledgeSource: ContractSpec<SchemaModel<{
8
+ tenantId: {
9
+ type: _lssm_lib_schema316.FieldType<string, string>;
10
+ isOptional: false;
11
+ };
12
+ spaceKey: {
13
+ type: _lssm_lib_schema316.FieldType<string, string>;
14
+ isOptional: false;
15
+ };
16
+ spaceVersion: {
17
+ type: _lssm_lib_schema316.FieldType<number, number>;
18
+ isOptional: false;
19
+ };
20
+ label: {
21
+ type: _lssm_lib_schema316.FieldType<string, string>;
22
+ isOptional: false;
23
+ };
24
+ sourceType: {
25
+ type: _lssm_lib_schema316.FieldType<string, string>;
26
+ isOptional: false;
27
+ };
28
+ config: {
29
+ type: _lssm_lib_schema316.FieldType<Record<string, unknown>, Record<string, unknown>>;
30
+ isOptional: false;
31
+ };
32
+ syncSchedule: {
33
+ type: SchemaModel<{
34
+ enabled: {
35
+ type: _lssm_lib_schema316.FieldType<boolean, boolean>;
36
+ isOptional: false;
37
+ };
38
+ cron: {
39
+ type: _lssm_lib_schema316.FieldType<string, string>;
40
+ isOptional: true;
41
+ };
42
+ intervalMs: {
43
+ type: _lssm_lib_schema316.FieldType<number, number>;
44
+ isOptional: true;
45
+ };
46
+ }>;
47
+ isOptional: true;
48
+ };
49
+ }>, SchemaModel<{
50
+ id: {
51
+ type: _lssm_lib_schema316.FieldType<string, string>;
52
+ isOptional: false;
53
+ };
54
+ tenantId: {
55
+ type: _lssm_lib_schema316.FieldType<string, string>;
56
+ isOptional: false;
57
+ };
58
+ spaceKey: {
59
+ type: _lssm_lib_schema316.FieldType<string, string>;
60
+ isOptional: false;
61
+ };
62
+ spaceVersion: {
63
+ type: _lssm_lib_schema316.FieldType<number, number>;
64
+ isOptional: false;
65
+ };
66
+ label: {
67
+ type: _lssm_lib_schema316.FieldType<string, string>;
68
+ isOptional: false;
69
+ };
70
+ sourceType: {
71
+ type: _lssm_lib_schema316.FieldType<string, string>;
72
+ isOptional: false;
73
+ };
74
+ syncSchedule: {
75
+ type: SchemaModel<{
76
+ enabled: {
77
+ type: _lssm_lib_schema316.FieldType<boolean, boolean>;
78
+ isOptional: false;
79
+ };
80
+ cron: {
81
+ type: _lssm_lib_schema316.FieldType<string, string>;
82
+ isOptional: true;
83
+ };
84
+ intervalMs: {
85
+ type: _lssm_lib_schema316.FieldType<number, number>;
86
+ isOptional: true;
87
+ };
88
+ }>;
89
+ isOptional: true;
90
+ };
91
+ lastSyncStatus: {
92
+ type: _lssm_lib_schema316.FieldType<string, string>;
93
+ isOptional: true;
94
+ };
95
+ lastSyncAt: {
96
+ type: _lssm_lib_schema316.FieldType<Date, string>;
97
+ isOptional: true;
98
+ };
99
+ itemsProcessed: {
100
+ type: _lssm_lib_schema316.FieldType<number, number>;
101
+ isOptional: true;
102
+ };
103
+ createdAt: {
104
+ type: _lssm_lib_schema316.FieldType<Date, string>;
105
+ isOptional: true;
106
+ };
107
+ updatedAt: {
108
+ type: _lssm_lib_schema316.FieldType<Date, string>;
109
+ isOptional: true;
110
+ };
111
+ }>, undefined>;
112
+ declare const UpdateKnowledgeSource: ContractSpec<SchemaModel<{
113
+ sourceId: {
114
+ type: _lssm_lib_schema316.FieldType<string, string>;
115
+ isOptional: false;
116
+ };
117
+ label: {
118
+ type: _lssm_lib_schema316.FieldType<string, string>;
119
+ isOptional: true;
120
+ };
121
+ config: {
122
+ type: _lssm_lib_schema316.FieldType<Record<string, unknown>, Record<string, unknown>>;
123
+ isOptional: true;
124
+ };
125
+ syncSchedule: {
126
+ type: SchemaModel<{
127
+ enabled: {
128
+ type: _lssm_lib_schema316.FieldType<boolean, boolean>;
129
+ isOptional: false;
130
+ };
131
+ cron: {
132
+ type: _lssm_lib_schema316.FieldType<string, string>;
133
+ isOptional: true;
134
+ };
135
+ intervalMs: {
136
+ type: _lssm_lib_schema316.FieldType<number, number>;
137
+ isOptional: true;
138
+ };
139
+ }>;
140
+ isOptional: true;
141
+ };
142
+ }>, SchemaModel<{
143
+ id: {
144
+ type: _lssm_lib_schema316.FieldType<string, string>;
145
+ isOptional: false;
146
+ };
147
+ tenantId: {
148
+ type: _lssm_lib_schema316.FieldType<string, string>;
149
+ isOptional: false;
150
+ };
151
+ spaceKey: {
152
+ type: _lssm_lib_schema316.FieldType<string, string>;
153
+ isOptional: false;
154
+ };
155
+ spaceVersion: {
156
+ type: _lssm_lib_schema316.FieldType<number, number>;
157
+ isOptional: false;
158
+ };
159
+ label: {
160
+ type: _lssm_lib_schema316.FieldType<string, string>;
161
+ isOptional: false;
162
+ };
163
+ sourceType: {
164
+ type: _lssm_lib_schema316.FieldType<string, string>;
165
+ isOptional: false;
166
+ };
167
+ syncSchedule: {
168
+ type: SchemaModel<{
169
+ enabled: {
170
+ type: _lssm_lib_schema316.FieldType<boolean, boolean>;
171
+ isOptional: false;
172
+ };
173
+ cron: {
174
+ type: _lssm_lib_schema316.FieldType<string, string>;
175
+ isOptional: true;
176
+ };
177
+ intervalMs: {
178
+ type: _lssm_lib_schema316.FieldType<number, number>;
179
+ isOptional: true;
180
+ };
181
+ }>;
182
+ isOptional: true;
183
+ };
184
+ lastSyncStatus: {
185
+ type: _lssm_lib_schema316.FieldType<string, string>;
186
+ isOptional: true;
187
+ };
188
+ lastSyncAt: {
189
+ type: _lssm_lib_schema316.FieldType<Date, string>;
190
+ isOptional: true;
191
+ };
192
+ itemsProcessed: {
193
+ type: _lssm_lib_schema316.FieldType<number, number>;
194
+ isOptional: true;
195
+ };
196
+ createdAt: {
197
+ type: _lssm_lib_schema316.FieldType<Date, string>;
198
+ isOptional: true;
199
+ };
200
+ updatedAt: {
201
+ type: _lssm_lib_schema316.FieldType<Date, string>;
202
+ isOptional: true;
203
+ };
204
+ }>, undefined>;
205
+ declare const DeleteKnowledgeSource: ContractSpec<SchemaModel<{
206
+ sourceId: {
207
+ type: _lssm_lib_schema316.FieldType<string, string>;
208
+ isOptional: false;
209
+ };
210
+ }>, SchemaModel<{
211
+ success: {
212
+ type: _lssm_lib_schema316.FieldType<boolean, boolean>;
213
+ isOptional: false;
214
+ };
215
+ }>, undefined>;
216
+ declare const ListKnowledgeSources: ContractSpec<SchemaModel<{
217
+ tenantId: {
218
+ type: _lssm_lib_schema316.FieldType<string, string>;
219
+ isOptional: false;
220
+ };
221
+ spaceKey: {
222
+ type: _lssm_lib_schema316.FieldType<string, string>;
223
+ isOptional: true;
224
+ };
225
+ }>, SchemaModel<{
226
+ sources: {
227
+ type: SchemaModel<{
228
+ id: {
229
+ type: _lssm_lib_schema316.FieldType<string, string>;
230
+ isOptional: false;
231
+ };
232
+ tenantId: {
233
+ type: _lssm_lib_schema316.FieldType<string, string>;
234
+ isOptional: false;
235
+ };
236
+ spaceKey: {
237
+ type: _lssm_lib_schema316.FieldType<string, string>;
238
+ isOptional: false;
239
+ };
240
+ spaceVersion: {
241
+ type: _lssm_lib_schema316.FieldType<number, number>;
242
+ isOptional: false;
243
+ };
244
+ label: {
245
+ type: _lssm_lib_schema316.FieldType<string, string>;
246
+ isOptional: false;
247
+ };
248
+ sourceType: {
249
+ type: _lssm_lib_schema316.FieldType<string, string>;
250
+ isOptional: false;
251
+ };
252
+ syncSchedule: {
253
+ type: SchemaModel<{
254
+ enabled: {
255
+ type: _lssm_lib_schema316.FieldType<boolean, boolean>;
256
+ isOptional: false;
257
+ };
258
+ cron: {
259
+ type: _lssm_lib_schema316.FieldType<string, string>;
260
+ isOptional: true;
261
+ };
262
+ intervalMs: {
263
+ type: _lssm_lib_schema316.FieldType<number, number>;
264
+ isOptional: true;
265
+ };
266
+ }>;
267
+ isOptional: true;
268
+ };
269
+ lastSyncStatus: {
270
+ type: _lssm_lib_schema316.FieldType<string, string>;
271
+ isOptional: true;
272
+ };
273
+ lastSyncAt: {
274
+ type: _lssm_lib_schema316.FieldType<Date, string>;
275
+ isOptional: true;
276
+ };
277
+ itemsProcessed: {
278
+ type: _lssm_lib_schema316.FieldType<number, number>;
279
+ isOptional: true;
280
+ };
281
+ createdAt: {
282
+ type: _lssm_lib_schema316.FieldType<Date, string>;
283
+ isOptional: true;
284
+ };
285
+ updatedAt: {
286
+ type: _lssm_lib_schema316.FieldType<Date, string>;
287
+ isOptional: true;
288
+ };
289
+ }>;
290
+ isOptional: false;
291
+ isArray: true;
292
+ };
293
+ }>, undefined>;
294
+ declare const TriggerKnowledgeSourceSync: ContractSpec<SchemaModel<{
295
+ sourceId: {
296
+ type: _lssm_lib_schema316.FieldType<string, string>;
297
+ isOptional: false;
298
+ };
299
+ }>, SchemaModel<{
300
+ success: {
301
+ type: _lssm_lib_schema316.FieldType<boolean, boolean>;
302
+ isOptional: false;
303
+ };
304
+ itemsProcessed: {
305
+ type: _lssm_lib_schema316.FieldType<number, number>;
306
+ isOptional: true;
307
+ };
308
+ error: {
309
+ type: _lssm_lib_schema316.FieldType<string, string>;
310
+ isOptional: true;
311
+ };
312
+ }>, undefined>;
313
+ declare const knowledgeContracts: Record<string, ContractSpec<any, any>>;
314
+ declare function registerKnowledgeContracts(registry: SpecRegistry): SpecRegistry;
315
+ //#endregion
316
+ export { CreateKnowledgeSource, DeleteKnowledgeSource, ListKnowledgeSources, TriggerKnowledgeSourceSync, UpdateKnowledgeSource, knowledgeContracts, registerKnowledgeContracts };
@@ -0,0 +1,6 @@
1
+ import { DocBlock } from "@lssm/lib.contracts/docs";
2
+
3
+ //#region src/knowledge/docs/knowledge.docblock.d.ts
4
+ declare const tech_contracts_knowledge_DocBlocks: DocBlock[];
5
+ //#endregion
6
+ export { tech_contracts_knowledge_DocBlocks };
@@ -0,0 +1,10 @@
1
+ import { KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, makeKnowledgeSpaceKey } from "./spec.js";
2
+ import { KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType } from "./source.js";
3
+ import { AppKnowledgeBinding } from "./binding.js";
4
+ import { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace } from "./spaces/product-canon.js";
5
+ import { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace } from "./spaces/support-faq.js";
6
+ import { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace } from "./spaces/email-threads.js";
7
+ import { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace } from "./spaces/uploaded-docs.js";
8
+ import { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace } from "./spaces/financial-docs.js";
9
+ import { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace } from "./spaces/financial-overview.js";
10
+ export { AppKnowledgeBinding, KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, emailThreadsKnowledgeSpace, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, makeKnowledgeSpaceKey, productCanonKnowledgeSpace, registerEmailThreadsKnowledgeSpace, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerProductCanonKnowledgeSpace, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, supportFaqKnowledgeSpace, uploadedDocsKnowledgeSpace };