@x12i/memorix-service 0.0.0-bootstrap.0

package/dist/routes/operations.js

@@ -0,0 +1,66 @@
+import { resolveScope } from "../request-scope.js";
+export async function registerOperationsRoutes(app, platform) {
+    app.get("/api/operations/runs", async (req) => {
+        const scope = resolveScope(req);
+        const ports = platform.client ? platform.portsFor(scope) : null;
+        const pipelineRuns = ports
+            ? await ports.pipeline.listRuns?.() ?? []
+            : [];
+        return {
+            scope,
+            pipelineRuns,
+            memoryRuns: [],
+            relationshipRuns: [],
+            intelligenceArtifacts: platform.client
+                ? await platform.intelligenceArtifactsFor(scope.orgId).listProposalIds()
+                : [],
+        };
+    });
+    app.get("/api/operations/schedules", async (req) => {
+        const scope = resolveScope(req);
+        const effective = platform.metadata.resolveEffective(scope.agentIds);
+        const schedules = (effective.effective ?? [])
+            .filter((e) => e.kind === "schedules")
+            .map((e) => e.definition);
+        return { scope, schedules };
+    });
+    app.get("/api/operations/artifacts", async (req) => {
+        const scope = resolveScope(req);
+        const ports = platform.client ? platform.portsFor(scope) : null;
+        const runs = ports ? ((await ports.pipeline.listRuns?.()) ?? []) : [];
+        const artifacts = [];
+        for (const run of runs) {
+            const runId = String(run.runId ?? "");
+            const refs = [
+                run.capturedContextRef,
+                ...(Array.isArray(run.artifacts) ? run.artifacts : []),
+            ].filter(Boolean);
+            for (const ref of refs) {
+                if (ref && typeof ref === "object") {
+                    artifacts.push({
+                        ...ref,
+                        runId,
+                        pipelineId: run.pipelineId ?? null,
+                        runStatus: run.status ?? null,
+                    });
+                }
+            }
+            // Also surface run identity as operational context when DataRef missing but run exists
+            if (refs.length === 0 && runId) {
+                artifacts.push({
+                    kind: "pipeline-run",
+                    runId,
+                    pipelineId: run.pipelineId ?? null,
+                    status: run.status ?? null,
+                    note: "run ledger entry (no capturedContextRef on this run)",
+                });
+            }
+        }
+        return {
+            scope,
+            artifacts,
+            note: "DataRef / G8 artifact references from pipeline runs; no inline secrets",
+        };
+    });
+}
+//# sourceMappingURL=operations.js.map

package/dist/routes/operations.js.map

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

package/dist/routes/pipelines.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyInstance } from "fastify";
+import type { MemorixPlatform } from "../platform.js";
+export declare function registerPipelineRoutes(app: FastifyInstance, platform: MemorixPlatform): Promise<void>;
+//# sourceMappingURL=pipelines.d.ts.map

package/dist/routes/pipelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelines.d.ts","sourceRoot":"","sources":["../../src/routes/pipelines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CA0Jf"}

package/dist/routes/pipelines.js

@@ -0,0 +1,128 @@
+import { validatePipelineDefinition } from "@x12i/memorix-pipeline/v2";
+import { resolveScope } from "../request-scope.js";
+import { ServiceError } from "../errors.js";
+export async function registerPipelineRoutes(app, platform) {
+    app.get("/api/pipelines/definitions", async (req) => {
+        const scope = resolveScope(req);
+        const effective = platform.metadata.resolveEffective(scope.agentIds);
+        const definitions = (effective.effective ?? [])
+            .filter((e) => e.kind === "pipelines")
+            .map((e) => e.definition);
+        return { scope, definitions };
+    });
+    app.post("/api/pipelines/validate", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        let definition = body.definition;
+        if (!definition && body.pipelineId) {
+            const def = platform.metadata.getDefinition(scope.agentIds, "pipelines", body.pipelineId);
+            definition = def?.definition;
+        }
+        if (!definition) {
+            throw new ServiceError("VALIDATION", "definition or pipelineId required", 400);
+        }
+        try {
+            validatePipelineDefinition(definition);
+            return { scope, valid: true, compiled: true, issues: [] };
+        }
+        catch (err) {
+            return {
+                scope,
+                valid: false,
+                compiled: false,
+                issues: [err instanceof Error ? err.message : String(err)],
+            };
+        }
+    });
+    app.post("/api/pipelines/start", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body?.pipelineId && !body?.definition) {
+            throw new ServiceError("VALIDATION", "pipelineId or definition required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        let definition;
+        if (body.definition) {
+            definition = structuredClone(body.definition);
+        }
+        else {
+            const def = platform.metadata.getDefinition(scope.agentIds, "pipelines", body.pipelineId);
+            if (!def?.definition) {
+                throw new ServiceError("NOT_FOUND", `pipeline ${body.pipelineId} not found`, 404);
+            }
+            definition = structuredClone(def.definition);
+        }
+        if (body.forceFailStepId) {
+            const steps = definition.steps ?? [];
+            const step = steps.find((s) => s.id === body.forceFailStepId || s.stepId === body.forceFailStepId);
+            if (!step) {
+                throw new ServiceError("VALIDATION", `forceFailStepId ${body.forceFailStepId} not found on pipeline`, 400);
+            }
+            step.portConfig = { ...(step.portConfig ?? {}), forceFail: true };
+        }
+        const run = await ports.pipeline.start(definition, body.input, {
+            trigger: body.trigger ?? "on-demand",
+        });
+        return {
+            scope,
+            runId: run.runId,
+            pipelineId: body.pipelineId ?? definition.pipelineId ?? null,
+            trigger: body.trigger ?? "on-demand",
+            status: run.status,
+            forceFailStepId: body.forceFailStepId ?? null,
+            run,
+        };
+    });
+    app.get("/api/pipelines/runs/:runId", async (req) => {
+        const scope = resolveScope(req);
+        const { runId } = req.params;
+        const ports = platform.portsFor(scope);
+        const run = await ports.pipeline.getRun(runId);
+        const steps = run
+            ? await ports.pipeline.getStepAttempts(runId)
+            : [];
+        const captured = run?.capturedContextRef ?? null;
+        return {
+            scope,
+            runId,
+            status: run?.status ?? "unknown",
+            pipelineId: run?.pipelineId ?? null,
+            steps,
+            artifacts: captured ? [captured] : [],
+            capturedContextRef: captured,
+            run,
+        };
+    });
+    app.post("/api/pipelines/runs/:runId/retry-step", async (req) => {
+        const scope = resolveScope(req);
+        const { runId } = req.params;
+        const body = req.body;
+        if (!body?.confirm) {
+            throw new ServiceError("CONFIRMATION_REQUIRED", "confirm:true required", 400);
+        }
+        if (!body.stepId)
+            throw new ServiceError("VALIDATION", "stepId required", 400);
+        const ports = platform.portsFor(scope);
+        const result = await ports.pipeline.retryFailedStep(runId, body.stepId);
+        const run = await ports.pipeline.getRun(runId);
+        const steps = await ports.pipeline.getStepAttempts(runId);
+        return {
+            scope,
+            runId,
+            stepId: body.stepId,
+            status: run?.status ?? "unknown",
+            stepAttempt: result,
+            steps,
+            run,
+            note: "retry envelope; status is the refreshed pipeline run status",
+        };
+    });
+    app.post("/api/pipelines/runs/:runId/resume", async (req) => {
+        const scope = resolveScope(req);
+        const { runId } = req.params;
+        const ports = platform.portsFor(scope);
+        const result = await ports.pipeline.resume(runId);
+        return { scope, runId, status: "resume-accepted", result };
+    });
+}
+//# sourceMappingURL=pipelines.js.map

package/dist/routes/pipelines.js.map

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

package/dist/routes/relationships.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyInstance } from "fastify";
+import type { MemorixPlatform } from "../platform.js";
+export declare function registerRelationshipRoutes(app: FastifyInstance, platform: MemorixPlatform): Promise<void>;
+//# sourceMappingURL=relationships.d.ts.map

package/dist/routes/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/routes/relationships.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKtD,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CA6Kf"}

package/dist/routes/relationships.js

@@ -0,0 +1,138 @@
+import { resolveScope } from "../request-scope.js";
+import { ServiceError } from "../errors.js";
+import { normalizeOperatorRelationshipLink } from "../relationships/operator-links.js";
+export async function registerRelationshipRoutes(app, platform) {
+    app.get("/api/relationships/definitions", async (req) => {
+        const scope = resolveScope(req);
+        const ports = platform.portsFor(scope);
+        const definitions = platform.metadata
+            .resolveEffective(scope.agentIds)
+            .effective?.filter((e) => e.kind === "relationship-definitions")
+            .map((e) => e.definition) ?? [];
+        const compiledPlans = [];
+        for (const d of definitions) {
+            const id = String(d.id ?? "");
+            if (!id)
+                continue;
+            try {
+                compiledPlans.push(ports.relationships.compile(id, scope.agentIds));
+            }
+            catch {
+                /* skip */
+            }
+        }
+        return { scope, definitions, compiledPlans };
+    });
+    app.get("/api/relationships/query", async (req) => {
+        const scope = resolveScope(req);
+        const q = req.query;
+        if (!q.recordId) {
+            throw new ServiceError("VALIDATION", "recordId required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        const traversal = q.direction === "inverse" ? "inverse" : "forward";
+        const section = await ports.reader.getRelationships(scope, q.recordId, {
+            include: true,
+            definitionIds: q.definitionId ? [q.definitionId] : undefined,
+            traversal,
+            // Prefer snapshots for expansion proof; fall back to raw when snapshots absent.
+            expandContentTypes: q.expand === "true" ? ["snapshots", "raw"] : undefined,
+        });
+        const links = section.items.map((item) => normalizeOperatorRelationshipLink(q.recordId, item, traversal));
+        const unresolvedTargets = links.filter((i) => i.targetStatus === "unresolved");
+        return {
+            scope,
+            direction: q.direction ?? "forward",
+            definitionId: q.definitionId ?? null,
+            links,
+            unresolvedTargets,
+            pageInfo: section.pageInfo,
+        };
+    });
+    app.post("/api/relationships/discover", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body?.definitionId) {
+            throw new ServiceError("VALIDATION", "definitionId required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        const result = await ports.relationships.discoverAndMaterialize(scope, body.definitionId);
+        return {
+            scope,
+            runId: `rel-discover-${Date.now()}`,
+            definitionId: body.definitionId,
+            status: "completed",
+            result,
+        };
+    });
+    app.post("/api/relationships/verify", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body?.definitionId) {
+            throw new ServiceError("VALIDATION", "definitionId required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        const verify = await ports.relationships.verifyDefinition(scope, body.definitionId);
+        return { scope, definitionId: body.definitionId, verify };
+    });
+    app.post("/api/relationships/rebuild", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body?.confirm) {
+            throw new ServiceError("CONFIRMATION_REQUIRED", "confirm:true required", 400);
+        }
+        if (!body.definitionId) {
+            throw new ServiceError("VALIDATION", "definitionId required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        const rebuild = await ports.relationships.rebuildDefinition(scope, body.definitionId);
+        return { scope, definitionId: body.definitionId, rebuild };
+    });
+    app.post("/api/relationships/cleanup", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body?.confirm) {
+            throw new ServiceError("CONFIRMATION_REQUIRED", "confirm:true required", 400);
+        }
+        if (!body.definitionId) {
+            throw new ServiceError("VALIDATION", "definitionId required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        const engine = ports.relationships;
+        const cleanup = engine.removeDefinitionLinks
+            ? await engine.removeDefinitionLinks(scope, body.definitionId)
+            : { status: "noop" };
+        return { scope, definitionId: body.definitionId, cleanup };
+    });
+    app.get("/api/relationships/related-property", async (req) => {
+        const scope = resolveScope(req);
+        const q = req.query;
+        if (!q.definitionId || !q.subjectRecordId || !q.relatedObjectType) {
+            throw new ServiceError("VALIDATION", "definitionId, subjectRecordId, relatedObjectType required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        const results = await ports.reader.queryRelationshipsByRelatedProperties(scope, {
+            definitionId: q.definitionId,
+            subjectRecordId: q.subjectRecordId,
+            traversal: "forward",
+            relatedObjectType: q.relatedObjectType,
+            relatedContentType: q.relatedContentType ?? "snapshots",
+            relatedFilters: q.property
+                ? [{ field: q.property, op: "exists", value: true }]
+                : undefined,
+            relatedScanLimit: Math.min(Number(q.limit ?? 50), 200),
+            limit: Math.min(Number(q.limit ?? 50), 200),
+        });
+        return {
+            scope,
+            definitionId: q.definitionId,
+            property: q.property ?? null,
+            limit: Math.min(Number(q.limit ?? 50), 200),
+            results,
+        };
+    });
+    app.all("/api/relationships/links", async () => {
+        throw new ServiceError("FORBIDDEN_ROUTE", "ad-hoc/manual link mutation is not exposed", 405);
+    });
+}
+//# sourceMappingURL=relationships.js.map

package/dist/routes/relationships.js.map

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

package/dist/routes/workflow.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyInstance } from "fastify";
+import type { MemorixPlatform } from "../platform.js";
+export declare function registerWorkflowRoutes(app: FastifyInstance, platform: MemorixPlatform): Promise<void>;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/routes/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/routes/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAqHf"}

package/dist/routes/workflow.js

@@ -0,0 +1,104 @@
+import { resolveScope } from "../request-scope.js";
+import { ServiceError } from "../errors.js";
+export async function registerWorkflowRoutes(app, platform) {
+    app.get("/api/workflow", async (req) => {
+        const scope = resolveScope(req);
+        const q = req.query;
+        if (!q.id) {
+            return {
+                scope,
+                id: null,
+                contentType: "workflow",
+                record: null,
+                currentRevision: null,
+            };
+        }
+        const ports = platform.portsFor(scope);
+        const objectType = q.objectType ?? "work-items";
+        const record = await ports.reader.getContent(scope, {
+            objectType,
+            contentType: "workflow",
+            recordId: q.id,
+        });
+        return {
+            scope,
+            id: q.id,
+            objectType,
+            contentType: "workflow",
+            record,
+            currentRevision: record.revision,
+        };
+    });
+    app.put("/api/workflow", async (req) => {
+        const scope = resolveScope(req);
+        const body = req.body;
+        if (!body?.id || !body.record) {
+            throw new ServiceError("VALIDATION", "id and record required", 400);
+        }
+        if (body.expectedRevision === undefined) {
+            throw new ServiceError("VALIDATION", "exact revision precondition required (expectedRevision)", 400);
+        }
+        if (body.currentRevision !== undefined &&
+            body.currentRevision !== body.expectedRevision) {
+            throw new ServiceError("REVISION_CONFLICT", "stale expectedRevision — reload and retry", 409, {
+                id: body.id,
+                expectedRevision: body.expectedRevision,
+                currentRevision: body.currentRevision,
+            });
+        }
+        const ports = platform.portsFor(scope);
+        const objectType = body.objectType ?? "work-items";
+        try {
+            const record = {
+                ...body.record,
+                recordId: body.id,
+                objectType,
+                contentType: "workflow",
+                dataCategory: "entity",
+            };
+            let existing = null;
+            try {
+                existing = await ports.reader.getContent(scope, {
+                    objectType,
+                    contentType: "workflow",
+                    recordId: body.id,
+                });
+            }
+            catch {
+                existing = null;
+            }
+            let result;
+            if (!existing && Number(body.expectedRevision) === 0) {
+                result = await ports.writer.add({
+                    scope,
+                    precondition: { kind: "absent" },
+                    record,
+                });
+            }
+            else {
+                result = await ports.writer.upsert({
+                    scope,
+                    precondition: { kind: "revision", revision: Number(body.expectedRevision) },
+                    record,
+                });
+            }
+            return {
+                scope,
+                id: body.id,
+                expectedRevision: body.expectedRevision,
+                currentRevision: result.record.revision,
+                status: "accepted",
+                conflict: false,
+                result,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (/stale|revision|WRITE_STALE/i.test(msg)) {
+                throw new ServiceError("REVISION_CONFLICT", msg, 409);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=workflow.js.map

package/dist/routes/workflow.js.map

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

package/dist/scope.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Canonical request scope: exactly one orgId + one or more unique agentIds.
+ * orgId = data universe; agentIds = effective metadata only.
+ */
+export type MemorixScope = {
+    orgId: string;
+    agentIds: string[];
+};
+export declare class ScopeValidationError extends Error {
+    readonly code = "SCOPE_INVALID";
+    constructor(message: string);
+}
+export declare function canonicalizeScope(input: {
+    orgId?: unknown;
+    agentIds?: unknown;
+    agentId?: unknown;
+}): MemorixScope;
+export declare function scopeFromHeaders(headers: Record<string, string | string[] | undefined>): MemorixScope;
+//# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,mBAAmB;gBACpB,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,YAAY,CAkCf;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,YAAY,CAarG"}

package/dist/scope.js

@@ -0,0 +1,53 @@
+export class ScopeValidationError extends Error {
+    code = "SCOPE_INVALID";
+    constructor(message) {
+        super(message);
+        this.name = "ScopeValidationError";
+    }
+}
+export function canonicalizeScope(input) {
+    const orgId = typeof input.orgId === "string" ? input.orgId.trim() : "";
+    if (!orgId) {
+        throw new ScopeValidationError("orgId is required and must be a non-empty string");
+    }
+    // Reject singular agentId-only scope on new routes
+    if (input.agentId !== undefined && input.agentIds === undefined) {
+        throw new ScopeValidationError("singular agentId is rejected; provide agentIds[] (one or more)");
+    }
+    let raw = [];
+    if (Array.isArray(input.agentIds)) {
+        raw = input.agentIds;
+    }
+    else if (typeof input.agentIds === "string") {
+        raw = input.agentIds.split(",").map((s) => s.trim());
+    }
+    const agentIds = [
+        ...new Set(raw
+            .filter((a) => typeof a === "string")
+            .map((a) => a.trim())
+            .filter(Boolean)),
+    ].sort((a, b) => a.localeCompare(b));
+    if (agentIds.length === 0) {
+        throw new ScopeValidationError("agentIds[] must contain at least one non-empty agent id");
+    }
+    return { orgId, agentIds };
+}
+export function scopeFromHeaders(headers) {
+    const org = header(headers, "x-memorix-org-id") ??
+        header(headers, "x-org-id");
+    const agents = header(headers, "x-memorix-agent-ids") ??
+        header(headers, "x-agent-ids");
+    const singular = header(headers, "x-memorix-agent-id") ?? header(headers, "x-agent-id");
+    return canonicalizeScope({
+        orgId: org,
+        agentIds: agents,
+        agentId: singular !== undefined && agents === undefined ? singular : undefined,
+    });
+}
+function header(headers, name) {
+    const v = headers[name] ?? headers[name.toLowerCase()];
+    if (Array.isArray(v))
+        return v[0];
+    return typeof v === "string" ? v : undefined;
+}
+//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,GAAG,eAAe,CAAC;IAChC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,KAIjC;IACC,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,oBAAoB,CAAC,kDAAkD,CAAC,CAAC;IACrF,CAAC;IAED,mDAAmD;IACnD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChE,MAAM,IAAI,oBAAoB,CAC5B,gEAAgE,CACjE,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,GAAc,EAAE,CAAC;IACxB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC;IACvB,CAAC;SAAM,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,QAAQ,GAAG;QACf,GAAG,IAAI,GAAG,CACR,GAAG;aACA,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;aACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,CACnB;KACF,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAErC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,oBAAoB,CAAC,yDAAyD,CAAC,CAAC;IAC5F,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAsD;IACrF,MAAM,GAAG,GACP,MAAM,CAAC,OAAO,EAAE,kBAAkB,CAAC;QACnC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC9B,MAAM,MAAM,GACV,MAAM,CAAC,OAAO,EAAE,qBAAqB,CAAC;QACtC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,oBAAoB,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACxF,OAAO,iBAAiB,CAAC;QACvB,KAAK,EAAE,GAAG;QACV,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,QAAQ,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KAC/E,CAAC,CAAC;AACL,CAAC;AAED,SAAS,MAAM,CACb,OAAsD,EACtD,IAAY;IAEZ,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC"}