@hasna/mementos 0.14.86 → 0.14.87

package/dist/db/synthesis.d.ts

@@ -0,0 +1,101 @@
+import { SqliteAdapter as Database } from "../storage.js";
+export interface SynthesisRun {
+    id: string;
+    triggered_by: "scheduler" | "manual" | "threshold" | "hook";
+    project_id: string | null;
+    agent_id: string | null;
+    corpus_size: number;
+    proposals_generated: number;
+    proposals_accepted: number;
+    proposals_rejected: number;
+    status: "pending" | "running" | "completed" | "failed" | "rolled_back";
+    error: string | null;
+    started_at: string;
+    completed_at: string | null;
+}
+export interface SynthesisProposal {
+    id: string;
+    run_id: string;
+    proposal_type: "merge" | "archive" | "promote" | "update_value" | "add_tag" | "remove_duplicate";
+    memory_ids: string[];
+    target_memory_id: string | null;
+    proposed_changes: Record<string, unknown>;
+    reasoning: string | null;
+    confidence: number;
+    status: "pending" | "accepted" | "rejected" | "rolled_back";
+    created_at: string;
+    executed_at: string | null;
+    rollback_data: Record<string, unknown> | null;
+}
+export interface SynthesisMetric {
+    id: string;
+    run_id: string;
+    metric_type: string;
+    value: number;
+    baseline: number | null;
+    created_at: string;
+}
+export interface SynthesisEvent {
+    id: string;
+    event_type: "recalled" | "searched" | "saved" | "updated" | "deleted" | "injected";
+    memory_id: string | null;
+    agent_id: string | null;
+    project_id: string | null;
+    session_id: string | null;
+    query: string | null;
+    importance_at_time: number | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+export declare function createSynthesisRun(input: {
+    triggered_by: SynthesisRun["triggered_by"];
+    project_id?: string | null;
+    agent_id?: string | null;
+    corpus_size?: number;
+}, db?: Database): SynthesisRun;
+export declare function getSynthesisRun(id: string, db?: Database): SynthesisRun | null;
+export declare function listSynthesisRuns(filter: {
+    project_id?: string | null;
+    status?: SynthesisRun["status"];
+    limit?: number;
+}, db?: Database): SynthesisRun[];
+export declare function updateSynthesisRun(id: string, updates: Partial<Pick<SynthesisRun, "status" | "error" | "corpus_size" | "proposals_generated" | "proposals_accepted" | "proposals_rejected" | "completed_at">>, db?: Database): SynthesisRun;
+export declare function createProposal(input: {
+    run_id: string;
+    proposal_type: SynthesisProposal["proposal_type"];
+    memory_ids: string[];
+    target_memory_id?: string | null;
+    proposed_changes: Record<string, unknown>;
+    reasoning?: string | null;
+    confidence: number;
+}, db?: Database): SynthesisProposal;
+export declare function getProposal(id: string, db?: Database): SynthesisProposal | null;
+export declare function listProposals(run_id: string, filter?: {
+    status?: SynthesisProposal["status"];
+}, db?: Database): SynthesisProposal[];
+export declare function updateProposal(id: string, updates: Partial<Pick<SynthesisProposal, "status" | "executed_at" | "rollback_data">>, db?: Database): SynthesisProposal;
+export declare function createMetric(input: {
+    run_id: string;
+    metric_type: string;
+    value: number;
+    baseline?: number | null;
+}, db?: Database): SynthesisMetric;
+export declare function listMetrics(run_id: string, db?: Database): SynthesisMetric[];
+export declare function recordSynthesisEvent(input: {
+    event_type: SynthesisEvent["event_type"];
+    memory_id?: string | null;
+    agent_id?: string | null;
+    project_id?: string | null;
+    session_id?: string | null;
+    query?: string | null;
+    importance_at_time?: number | null;
+    metadata?: Record<string, unknown>;
+}, db?: Database): void;
+export declare function listSynthesisEvents(filter: {
+    memory_id?: string;
+    project_id?: string;
+    event_type?: SynthesisEvent["event_type"];
+    since?: string;
+    limit?: number;
+}, db?: Database): SynthesisEvent[];
+//# sourceMappingURL=synthesis.d.ts.map

package/dist/db/synthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesis.d.ts","sourceRoot":"","sources":["../../src/db/synthesis.ts"],"names":[],"mappings":"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"}

package/dist/db/tasks.d.ts

@@ -0,0 +1,89 @@
+import { SqliteAdapter as Database } from "../storage.js";
+export type TaskStatus = "pending" | "in_progress" | "completed" | "failed" | "cancelled";
+export type TaskPriority = "critical" | "high" | "medium" | "low";
+export interface Task {
+    id: string;
+    subject: string;
+    description: string;
+    status: TaskStatus;
+    priority: TaskPriority;
+    tags: string[];
+    assigned_agent_id: string | null;
+    project_id: string | null;
+    session_id: string | null;
+    parent_task_id: string | null;
+    metadata: Record<string, unknown>;
+    progress: number;
+    due_at: string | null;
+    started_at: string | null;
+    completed_at: string | null;
+    failed_at: string | null;
+    error: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface TaskComment {
+    id: string;
+    task_id: string;
+    agent_id: string | null;
+    body: string;
+    created_at: string;
+}
+export interface CreateTaskInput {
+    subject: string;
+    description?: string;
+    priority?: TaskPriority;
+    tags?: string[];
+    assigned_agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+    parent_task_id?: string;
+    metadata?: Record<string, unknown>;
+    due_at?: string;
+}
+export interface UpdateTaskInput {
+    subject?: string;
+    description?: string;
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    tags?: string[];
+    assigned_agent_id?: string | null;
+    metadata?: Record<string, unknown>;
+    progress?: number;
+    due_at?: string | null;
+    error?: string | null;
+}
+export declare function createTask(db: Database, input: CreateTaskInput): Task;
+export declare function getTask(db: Database, id: string): Task | null;
+export declare function listTasks(db: Database, filter?: {
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    assigned_agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+    parent_task_id?: string | null;
+    tags?: string[];
+    limit?: number;
+    offset?: number;
+}): {
+    tasks: Task[];
+    count: number;
+};
+export declare function updateTask(db: Database, id: string, input: UpdateTaskInput): Task | null;
+export declare function deleteTask(db: Database, id: string): boolean;
+export declare function addTaskComment(db: Database, taskId: string, body: string, agentId?: string): TaskComment;
+export declare function listTaskComments(db: Database, taskId: string): {
+    comments: TaskComment[];
+    count: number;
+};
+export declare function deleteTaskComment(db: Database, id: string): boolean;
+export declare function getTaskStats(db: Database, filter?: {
+    project_id?: string;
+    agent_id?: string;
+}): {
+    total: number;
+    by_status: Record<TaskStatus, number>;
+    by_priority: Record<TaskPriority, number>;
+    overdue: number;
+};
+//# sourceMappingURL=tasks.d.ts.map

package/dist/db/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/db/tasks.ts"],"names":[],"mappings":"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"}

package/dist/db/tool-events.d.ts

@@ -0,0 +1,27 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { ToolEvent, CreateToolEventInput, ToolStats } from "../types/index.js";
+export declare function saveToolEvent(input: CreateToolEventInput, db?: Database): ToolEvent;
+export declare function getToolEvent(id: string, db?: Database): ToolEvent | null;
+export declare function getToolEvents(filters: {
+    tool_name?: string;
+    agent_id?: string;
+    project_id?: string;
+    success?: boolean;
+    from_date?: string;
+    to_date?: string;
+    limit?: number;
+    offset?: number;
+}, db?: Database): ToolEvent[];
+export declare function getToolStats(tool_name: string, project_id?: string, db?: Database): ToolStats;
+export declare function getToolLessons(tool_name: string, project_id?: string, limit?: number, db?: Database): {
+    lesson: string;
+    when_to_use: string | null;
+    created_at: string;
+}[];
+export declare function deleteToolEvents(filters: {
+    tool_name?: string;
+    agent_id?: string;
+    project_id?: string;
+    before_date?: string;
+}, db?: Database): number;
+//# sourceMappingURL=tool-events.d.ts.map

package/dist/db/tool-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-events.d.ts","sourceRoot":"","sources":["../../src/db/tool-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAiCpF,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,SAAS,CAkCnF;AAMD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAKxE;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,EAAE,CAqDb;AAMD,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,CAkDX;AAMD,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,CAuBtE;AAMD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CA8BR"}

package/dist/db/webhook_hooks.d.ts

@@ -0,0 +1,48 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { LookupAddress } from "node:dns";
+import type { WebhookHook, HookType } from "../types/hooks.js";
+/**
+ * Resolver signature: returns every A/AAAA address for a hostname.
+ * Defaults to node:dns/promises lookup (all addresses, verbatim order).
+ */
+export type HostResolver = (hostname: string) => Promise<LookupAddress[]>;
+export interface WebhookUrlValidationOptions {
+    /**
+     * Hostname resolver override — a deterministic test seam. Production call
+     * sites never pass it; when absent the real system resolver is used.
+     */
+    lookup?: HostResolver;
+}
+/**
+ * Validate a webhook handler URL. Rejects (async) when the URL is not a
+ * public http(s) endpoint: unparseable, wrong scheme, embedded credentials,
+ * or a loopback / link-local / private / metadata target — whether named
+ * directly as an IP literal or indirectly via a DNS name that resolves to one
+ * of those ranges. A hostname that cannot be resolved is rejected (fail
+ * closed): it could never be delivered, and rejecting it closes the SSRF
+ * class.
+ */
+export declare function validateWebhookHandlerUrl(url: string, opts?: WebhookUrlValidationOptions): Promise<void>;
+export interface CreateWebhookHookInput {
+    type: HookType;
+    handlerUrl: string;
+    priority?: number;
+    blocking?: boolean;
+    agentId?: string;
+    projectId?: string;
+    description?: string;
+}
+export declare function createWebhookHook(input: CreateWebhookHookInput, db?: Database, opts?: WebhookUrlValidationOptions): Promise<WebhookHook>;
+export declare function getWebhookHook(id: string, db?: Database): WebhookHook | null;
+export declare function listWebhookHooks(filter?: {
+    type?: HookType;
+    enabled?: boolean;
+}, db?: Database): WebhookHook[];
+export declare function updateWebhookHook(id: string, updates: {
+    enabled?: boolean;
+    description?: string;
+    priority?: number;
+}, db?: Database): WebhookHook | null;
+export declare function deleteWebhookHook(id: string, db?: Database): boolean;
+export declare function recordWebhookInvocation(id: string, success: boolean, db?: Database): void;
+//# sourceMappingURL=webhook_hooks.d.ts.map

package/dist/db/webhook_hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook_hooks.d.ts","sourceRoot":"","sources":["../../src/db/webhook_hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAM1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA6H/D;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;AAE1E,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAwBD;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,2BAA2B,GACjC,OAAO,CAAC,IAAI,CAAC,CA+Df;AAMD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,EAC7B,EAAE,CAAC,EAAE,QAAQ,EACb,IAAI,CAAC,EAAE,2BAA2B,GACjC,OAAO,CAAC,WAAW,CAAC,CAoCtB;AAMD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAW5E;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,GAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,EACnD,EAAE,CAAC,EAAE,QAAQ,GACZ,WAAW,EAAE,CAyBf;AAMD,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EACvE,EAAE,CAAC,EAAE,QAAQ,GACZ,WAAW,GAAG,IAAI,CAoCpB;AAMD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAQpE;AAMD,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,IAAI,CAmBN"}

package/dist/diagnostics/historical-project-registration-receipt.d.ts

@@ -0,0 +1,39 @@
+export interface HistoricalReceiptDiagnosticQuery {
+    query<T = Record<string, unknown>>(sql: string, values?: unknown[]): Promise<{
+        rows: T[];
+        rowCount: number | null;
+    }>;
+}
+export interface HistoricalReceiptDiagnosticReport {
+    schema: "mementos.historical-project-registration-receipt-diagnostic.v1";
+    status: "PASS";
+    transaction_read_only: true;
+    exact_receipt_count: 1;
+    table_count_before: string;
+    table_count_after: string;
+    table_digest_before: string;
+    table_digest_after: string;
+    table_count_unchanged: true;
+    table_digest_unchanged: true;
+    authority_id: string;
+    tenant_id: string;
+    corpus_id: string;
+    operation_id: string;
+    step_id: string;
+    target_selector: string;
+    target_id: string;
+    receipt_id: string;
+    identity_digest: string;
+    target_digest: string;
+    operation_digest: string;
+    idempotency_digest: string;
+    result_digest: string;
+    receipt_digest: string;
+    response_digest: string;
+}
+export declare class HistoricalReceiptDiagnosticError extends Error {
+    readonly code: string;
+    constructor(code: string);
+}
+export declare function diagnoseHistoricalProjectRegistrationReceipt(query: HistoricalReceiptDiagnosticQuery): Promise<HistoricalReceiptDiagnosticReport>;
+//# sourceMappingURL=historical-project-registration-receipt.d.ts.map

package/dist/diagnostics/historical-project-registration-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historical-project-registration-receipt.d.ts","sourceRoot":"","sources":["../../src/diagnostics/historical-project-registration-receipt.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,gCAAgC;IAC/C,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACpD;AAYD,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,gEAAgE,CAAC;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,IAAI,CAAC;IAC5B,mBAAmB,EAAE,CAAC,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,IAAI,CAAC;IAC5B,sBAAsB,EAAE,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIlC;AAyFD,wBAAsB,4CAA4C,CAChE,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,iCAAiC,CAAC,CAgH5C"}

package/dist/generated/storage-kit/backend.d.ts

@@ -0,0 +1,20 @@
+export declare const SERVER_DATA_BACKENDS: readonly ["sqlite", "postgresql"];
+export type ServerDataBackend = (typeof SERVER_DATA_BACKENDS)[number];
+export type Env = Record<string, string | undefined>;
+/** Upper-snake env token for an app name, e.g. `todos` -> `TODOS`. */
+export declare function envToken(name: string): string;
+export interface ServerDataBackendEnvKeys {
+    databaseUrlKeys: string[];
+}
+export declare function serverDataBackendEnvKeys(name: string): ServerDataBackendEnvKeys;
+export declare function assertNoLegacyStorageMode(name: string, env?: Env): void;
+export interface ServerDataBackendResolution {
+    backend: ServerDataBackend;
+    source: string;
+    databaseUrlPresent: boolean;
+    databaseUrlSource: string | null;
+}
+export declare function resolveServerDataBackend(name: string, env?: Env): ServerDataBackendResolution;
+/** Resolve the database URL without logging it. Returns `null` when unset. */
+export declare function resolveDatabaseUrl(name: string, env?: Env): string | null;
+//# sourceMappingURL=backend.d.ts.map

package/dist/generated/storage-kit/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/backend.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,oBAAoB,mCAAoC,CAAC;AACtE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAErD,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAK/E;AA+BD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,GAAiB,GAAG,IAAI,CASpF;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,GAAiB,GACrB,2BAA2B,CAiB7B;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,GAAiB,GAAG,MAAM,GAAG,IAAI,CAItF"}

package/dist/generated/storage-kit/health.d.ts

@@ -0,0 +1,20 @@
+import type { TypedQueryClient } from "./query.js";
+import { type Migration, type MigrationRunnerOptions } from "./migrations.js";
+export interface HealthResult {
+    ok: boolean;
+    /** Round-trip latency of the probe query, in milliseconds. */
+    latencyMs: number;
+    error?: string;
+}
+/** Cheap reachability probe: `SELECT 1`. Never throws — reports `ok: false`. */
+export declare function checkHealth(client: TypedQueryClient): Promise<HealthResult>;
+export interface ReadyResult extends HealthResult {
+    /** Migration ids that are defined but not yet applied. */
+    pendingMigrations: string[];
+}
+/**
+ * Readiness probe: reachable AND fully migrated. Reports `ok: false` with the
+ * list of pending migration ids when the schema is behind.
+ */
+export declare function checkReady(client: TypedQueryClient, migrations: readonly Migration[], options?: MigrationRunnerOptions): Promise<ReadyResult>;
+//# sourceMappingURL=health.d.ts.map

package/dist/generated/storage-kit/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/health.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE/F,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gFAAgF;AAChF,wBAAsB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAYjF;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,WAAW,CAAC,CAetB"}

package/dist/generated/storage-kit/index.d.ts

@@ -0,0 +1,8 @@
+export declare const KIT_VERSION = "0.10.6";
+export * from "./backend.js";
+export * from "./tls.js";
+export * from "./query.js";
+export * from "./pool.js";
+export * from "./migrations.js";
+export * from "./health.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/generated/storage-kit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/index.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/generated/storage-kit/migrations.d.ts

@@ -0,0 +1,48 @@
+import type { TypedQueryClient } from "./query.js";
+/** Default ledger table name. Override per app if a legacy name exists. */
+export declare const DEFAULT_MIGRATION_LEDGER_TABLE = "schema_migrations";
+export interface Migration {
+    readonly id: string;
+    readonly sql: string;
+    readonly checksum: string;
+}
+export type MigrationState = "already_applied" | "pending";
+export interface MigrationPlanItem {
+    readonly migration: Migration;
+    readonly state: MigrationState;
+}
+export interface AppliedMigration {
+    readonly id: string;
+    readonly checksum: string;
+    readonly appliedAt: string;
+}
+export interface MigrationResult {
+    readonly dryRun: boolean;
+    readonly applied: AppliedMigration[];
+    readonly plan: MigrationPlanItem[];
+}
+/** Stable sha256 checksum for a migration's SQL text. */
+export declare function checksumSql(sql: string): string;
+/** Freeze a migration definition, computing its checksum from the SQL. */
+export declare function defineMigration(id: string, sql: string): Migration;
+export interface MigrationRunnerOptions {
+    ledgerTable?: string;
+}
+export declare class MigrationLedger {
+    private readonly client;
+    private readonly migrations;
+    private readonly ledgerTable;
+    constructor(client: TypedQueryClient, migrations: readonly Migration[], options?: MigrationRunnerOptions);
+    ensureLedger(): Promise<void>;
+    listApplied(): Promise<AppliedMigration[]>;
+    private readApplied;
+    /** Compute the migration plan and guard against drift/downgrade. */
+    private buildPlan;
+    /** Apply all pending migrations. With `dryRun`, report the plan only. */
+    migrate(opts?: {
+        dryRun?: boolean;
+    }): Promise<MigrationResult>;
+}
+/** Convenience: build a ledger and run all pending migrations. */
+export declare function createMigrationLedger(client: TypedQueryClient, migrations: readonly Migration[], options?: MigrationRunnerOptions): MigrationLedger;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/generated/storage-kit/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/migrations.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,2EAA2E;AAC3E,eAAO,MAAM,8BAA8B,sBAAsB,CAAC;AAElE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAC;CACpC;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAElE;AAQD,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAGlB,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,SAAS,SAAS,EAAE,EACjD,OAAO,GAAE,sBAA2B;IAahC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAU7B,WAAW,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAKlC,WAAW;IAWzB,oEAAoE;IACpE,OAAO,CAAC,SAAS;IAsBjB,yEAAyE;IACnE,OAAO,CAAC,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC;CAmBzE;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAEjB"}

package/dist/generated/storage-kit/own.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Read `key` from `source` only when `source` OWNS it.
+ *
+ * Returns `undefined` for an inherited property and for a null/undefined or
+ * non-object source, so a guarded read is a drop-in for `source?.[key]` that
+ * cannot be answered by the prototype chain.
+ */
+export declare function ownProp<T>(source: unknown, key: string): T | undefined;
+/** `ownProp` narrowed to a string, so a polluted non-string cannot slip through. */
+export declare function ownString(source: unknown, key: string): string | undefined;
+//# sourceMappingURL=own.d.ts.map

package/dist/generated/storage-kit/own.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"own.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/own.ts"],"names":[],"mappings":"AAyCA;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAMtE;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1E"}

package/dist/generated/storage-kit/pool.d.ts

@@ -0,0 +1,35 @@
+import type { Pool } from "pg";
+import { type TlsResolveOptions } from "./tls.js";
+import { type PoolQueryClient } from "./query.js";
+export interface CreatePgPoolOptions extends TlsResolveOptions {
+    connectionString: string;
+    /** Max clients in the pool. Defaults to pg's default (10). */
+    max?: number;
+    /** Idle client timeout (ms). */
+    idleTimeoutMillis?: number;
+    /** Connection acquisition timeout (ms). */
+    connectionTimeoutMillis?: number;
+    /** Application name reported to Postgres (shows in pg_stat_activity). */
+    applicationName?: string;
+}
+/** Build a `pg.Pool` with fleet-standard TLS handling. */
+export declare function createPgPool(options: CreatePgPoolOptions): Pool;
+export interface CreateServerPoolFromEnvOptions extends TlsResolveOptions {
+    max?: number;
+    idleTimeoutMillis?: number;
+    connectionTimeoutMillis?: number;
+    applicationName?: string;
+}
+export interface ServerPoolFromEnv {
+    client: PoolQueryClient;
+    connectionSource: string;
+}
+/**
+ * Resolve backend + database URL from the environment and build the server's
+ * PostgreSQL pool.
+ *
+ * Throws when no database URL selects the `postgresql` backend. Never logs the
+ * URL.
+ */
+export declare function createServerPoolFromEnv(appName: string, options?: CreateServerPoolFromEnvOptions): ServerPoolFromEnv;
+//# sourceMappingURL=pool.d.ts.map

package/dist/generated/storage-kit/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/pool.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AAE3C,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAgDrE,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAmC/D;AAED,MAAM,WAAW,8BAA+B,SAAQ,iBAAiB;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,8BAAmC,GAC3C,iBAAiB,CAoBnB"}

package/dist/generated/storage-kit/query.d.ts

@@ -0,0 +1,36 @@
+import type { Pool, QueryResultRow } from "pg";
+export interface QueryResult<T extends QueryResultRow> {
+    rows: T[];
+    rowCount: number;
+}
+/**
+ * Minimal executor contract. `pg.Pool` and `pg.PoolClient` both satisfy the
+ * `query` method; the wrapper builds the rest on top so tests can substitute a
+ * lightweight shim without pulling in a live Postgres.
+ */
+export interface PgExecutor {
+    query<T extends QueryResultRow>(sql: string, params?: readonly unknown[]): Promise<{
+        rows: T[];
+        rowCount: number | null;
+    }>;
+}
+export interface TypedQueryClient {
+    query<T extends QueryResultRow>(sql: string, params?: readonly unknown[]): Promise<QueryResult<T>>;
+    many<T extends QueryResultRow>(sql: string, params?: readonly unknown[]): Promise<T[]>;
+    /** First row or `null`. Restored here after open-knowledge dropped it. */
+    get<T extends QueryResultRow>(sql: string, params?: readonly unknown[]): Promise<T | null>;
+    /** Exactly one row; throws if zero or more than one row is returned. */
+    one<T extends QueryResultRow>(sql: string, params?: readonly unknown[]): Promise<T>;
+    execute(sql: string, params?: readonly unknown[]): Promise<void>;
+}
+/** Wrap any `PgExecutor` (a Pool, a PoolClient, or a test shim) with the typed vocabulary. */
+export declare function wrapExecutor(executor: PgExecutor): TypedQueryClient;
+export interface PoolQueryClient extends TypedQueryClient {
+    readonly pool: Pool;
+    /** Run a callback inside a `BEGIN`/`COMMIT` transaction on a dedicated client. */
+    transaction<T>(fn: (client: TypedQueryClient) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+}
+/** Build a `PoolQueryClient` around a live `pg.Pool`. */
+export declare function createQueryClient(pool: Pool): PoolQueryClient;
+//# sourceMappingURL=query.d.ts.map

package/dist/generated/storage-kit/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/query.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,IAAI,EAAc,cAAc,EAAE,MAAM,IAAI,CAAC;AAE3D,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,cAAc;IACnD,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,CAAC,SAAS,cAAc,EAC5B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAC1B,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,CAAC,SAAS,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACnG,IAAI,CAAC,CAAC,SAAS,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACvF,0EAA0E;IAC1E,GAAG,CAAC,CAAC,SAAS,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3F,wEAAwE;IACxE,GAAG,CAAC,CAAC,SAAS,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,GAAG,gBAAgB,CAyBnE;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,kFAAkF;IAClF,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe,CA2B7D"}

package/dist/generated/storage-kit/tls.d.ts

@@ -0,0 +1,53 @@
+/** The `ssl` field shape accepted by `pg.Pool` / `pg.Client`. */
+export type PgSslConfig = boolean | {
+    rejectUnauthorized: boolean;
+    ca?: string;
+    cert?: string;
+    key?: string;
+    passphrase?: string;
+};
+export interface TlsResolveOptions {
+    /** Inline CA bundle (PEM). Wins over every other CA source. */
+    ca?: string;
+    /** Path to a CA bundle PEM file, e.g. the Amazon RDS global bundle. */
+    caCertPath?: string;
+    /** Environment used to discover PGSSLROOTCERT / NODE_EXTRA_CA_CERTS. */
+    env?: Record<string, string | undefined>;
+}
+export type SslMode = "disable" | "prefer" | "require" | "verify-ca" | "verify-full";
+/**
+ * Remove the TLS query parameters once this module has resolved them into an
+ * explicit `ssl` option. pg re-parses `connectionString` AFTER merging pool
+ * options and lets the parse win, so leaving `sslmode` (or `ssl`, `sslcert`,
+ * `sslkey`, `sslrootcert`, `sslnegotiation`) in the URL replaces the resolved
+ * SSL object with pg's own — discarding the CA bundle with it.
+ *
+ * Non-TLS parameters and any fragment are preserved exactly.
+ */
+export declare function connectionStringWithoutTlsParameters(connectionString: string): string;
+/**
+ * Preserve pg's transport negotiation choice outside the stripped URL, so
+ * `sslnegotiation=direct` survives as an explicit pool option instead of being
+ * silently dropped.
+ */
+export declare function sslNegotiationFromConnectionString(connectionString: string): "postgres" | "direct" | undefined;
+/**
+ * Extract the effective `sslmode` from a Postgres connection string. Honors the
+ * `sslmode` query param, the legacy `ssl=true` boolean, and pg's rule that
+ * `sslnegotiation=direct` implies TLS when no explicit SSL setting is present.
+ * Returns `disable` when TLS is not requested.
+ */
+export declare function sslModeFromConnectionString(connectionString: string): SslMode;
+/**
+ * Resolve the `pg` ssl config for a connection string. See the module header
+ * for the full mode table.
+ *
+ * Returns `false` when TLS was explicitly switched off, and `undefined` when the
+ * DSN expressed no TLS policy at all — those are different answers, and pg
+ * treats them differently: only `undefined` lets `PGSSLMODE` decide.
+ *
+ * The caller MUST hand pg `connectionStringWithoutTlsParameters(connectionString)`
+ * rather than the original DSN, or pg discards everything resolved here.
+ */
+export declare function resolveTlsConfig(connectionString: string, options?: TlsResolveOptions): PgSslConfig | undefined;
+//# sourceMappingURL=tls.d.ts.map

package/dist/generated/storage-kit/tls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tls.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/tls.ts"],"names":[],"mappings":"AAwNA,iEAAiE;AACjE,MAAM,MAAM,WAAW,GACnB,OAAO,GACP;IACE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;AA+BrF;;;;;;;;GAQG;AACH,wBAAgB,oCAAoC,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAOrF;AAgBD;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,gBAAgB,EAAE,MAAM,GACvB,UAAU,GAAG,QAAQ,GAAG,SAAS,CAKnC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAmD7E;AA6CD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,OAAO,GAAE,iBAAsB,GAC9B,WAAW,GAAG,SAAS,CAgEzB"}