@jterrats/open-orchestra 0.5.5 → 1.0.1

package/dist/visual-validation.js

@@ -0,0 +1,290 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { appendEvent, writeArtifact } from "./workspace.js";
+export const DEFAULT_VISUAL_VALIDATION_CONFIG = {
+    duplicateThresholdPx: 200,
+    minIconTextGapPx: 10,
+    fallbackTextPatterns: [
+        "aws-general-*",
+        "plugin-flowchart-shape-*",
+        "Type something",
+    ],
+    maxLabelOverflowPx: 0,
+    rotationToleranceRadians: 0.01,
+    requirePngExport: true,
+};
+export async function readVisualArtifactManifest(manifestPath) {
+    return JSON.parse(await readFile(manifestPath, "utf8"));
+}
+export async function readVisualValidationConfig(configPath) {
+    if (!configPath)
+        return DEFAULT_VISUAL_VALIDATION_CONFIG;
+    const parsed = JSON.parse(await readFile(configPath, "utf8"));
+    return { ...DEFAULT_VISUAL_VALIDATION_CONFIG, ...parsed };
+}
+export function validateVisualManifest(manifest, config = DEFAULT_VISUAL_VALIDATION_CONFIG) {
+    const findings = [
+        ...pngExportFindings(manifest, config),
+        ...duplicateTextFindings(manifest, config),
+        ...fallbackTextFindings(manifest, config),
+        ...orphanFindings(manifest),
+        ...boundsFindings(manifest, config),
+        ...iconTextGapFindings(manifest, config),
+        ...rotationFindings(manifest, config),
+    ];
+    const blocking = findings.some((finding) => finding.severity === "blocking");
+    const remediations = findings
+        .filter((finding) => finding.remediable)
+        .map((finding) => remediationFor(finding));
+    return {
+        gateId: "visual_validation",
+        passed: !blocking,
+        blocking,
+        summary: blocking
+            ? "Visual validation blocked"
+            : "Visual validation passed",
+        tool: manifest.tool,
+        documentId: manifest.documentId,
+        ...(manifest.pageId ? { pageId: manifest.pageId } : {}),
+        itemCount: manifest.items.length,
+        pngExports: (manifest.exports ?? [])
+            .filter((artifact) => artifact.type === "png")
+            .map((artifact) => artifact.path),
+        findings,
+        remediations,
+    };
+}
+export async function recordVisualArtifactsManifest({ taskId, manifest, root = process.cwd(), }) {
+    await appendEvent(root, {
+        type: "VISUAL_ARTIFACTS_RECORDED",
+        taskId,
+        actor: "architect",
+        summary: `Visual artifacts manifest recorded for ${manifest.tool}`,
+        artifacts: manifest.exports?.map((artifact) => artifact.path) ?? [],
+        metadata: { manifest },
+    });
+}
+export async function recordVisualValidationEvidence({ taskId, result, root = process.cwd(), }) {
+    const content = renderVisualValidationReport(taskId, result);
+    const artifact = await writeArtifact(root, "evidence", `${taskId}-${Date.now()}-visual-validation.md`, content);
+    await appendEvent(root, {
+        type: "VISUAL_VALIDATION_RECORDED",
+        taskId,
+        actor: "qa",
+        summary: result.summary,
+        artifacts: [artifact, ...result.pngExports],
+        metadata: { ...result, findingCount: result.findings.length },
+    });
+    await appendEvent(root, {
+        type: "EVIDENCE_ADDED",
+        taskId,
+        actor: "qa",
+        summary: result.summary,
+        artifacts: [artifact, ...result.pngExports],
+        metadata: {
+            type: result.pngExports.length > 0 ? "screenshot" : "report",
+            visualValidation: true,
+            gateId: result.gateId,
+            passed: result.passed,
+            findingCount: result.findings.length,
+            pngExports: result.pngExports,
+        },
+    });
+    return { artifact, content };
+}
+export function renderVisualValidationReport(taskId, result) {
+    return [
+        `# Visual Validation ${taskId}`,
+        "",
+        `- Status: ${result.passed ? "passed" : "blocked"}`,
+        `- Tool: ${result.tool}`,
+        `- Document: ${result.documentId}`,
+        `- Page: ${result.pageId ?? "not applicable"}`,
+        `- Items: ${result.itemCount}`,
+        `- PNG exports: ${result.pngExports.length}`,
+        "",
+        "## Findings",
+        ...(result.findings.length === 0
+            ? ["- none"]
+            : result.findings.map((finding) => `- ${finding.severity} ${finding.type}: ${finding.message}`)),
+        "",
+        "## Remediations",
+        ...(result.remediations.length === 0
+            ? ["- none"]
+            : result.remediations.map((remediation) => `- ${remediation}`)),
+        "",
+    ].join("\n");
+}
+export function rotationToRadians(value, unit, tool) {
+    if (unit === "degrees")
+        return (value * Math.PI) / 180;
+    if (unit === "radians")
+        return value;
+    return tool === "lucid" ? value : (value * Math.PI) / 180;
+}
+function pngExportFindings(manifest, config) {
+    if (!config.requirePngExport)
+        return [];
+    const hasPng = (manifest.exports ?? []).some((artifact) => artifact.type === "png");
+    return hasPng
+        ? []
+        : [
+            {
+                id: "png-export-required",
+                severity: "blocking",
+                type: "png_export",
+                message: "PNG export artifact is required for visual validation",
+                itemIds: [],
+                remediable: false,
+            },
+        ];
+}
+function duplicateTextFindings(manifest, config) {
+    const findings = [];
+    for (let leftIndex = 0; leftIndex < manifest.items.length; leftIndex += 1) {
+        const left = manifest.items[leftIndex];
+        if (!left?.text?.trim())
+            continue;
+        for (let rightIndex = leftIndex + 1; rightIndex < manifest.items.length; rightIndex += 1) {
+            const right = manifest.items[rightIndex];
+            if (!right?.text?.trim())
+                continue;
+            if (left.text.trim() !== right.text.trim())
+                continue;
+            const distance = Math.hypot(left.x - right.x, left.y - right.y);
+            if (distance <= config.duplicateThresholdPx) {
+                findings.push({
+                    id: `duplicate-${left.id}-${right.id}`,
+                    severity: "blocking",
+                    type: "duplicate",
+                    message: `Duplicate text '${left.text.trim()}' within ${Math.round(distance)}px`,
+                    itemIds: [left.id, right.id],
+                    remediable: true,
+                });
+            }
+        }
+    }
+    return findings;
+}
+function fallbackTextFindings(manifest, config) {
+    return manifest.items
+        .filter((item) => config.fallbackTextPatterns.some((pattern) => wildcardMatch(pattern, item.text ?? "")))
+        .map((item) => ({
+        id: `fallback-${item.id}`,
+        severity: "blocking",
+        type: "fallback_text",
+        message: `Fallback text is visible: '${item.text}'`,
+        itemIds: [item.id],
+        remediable: true,
+    }));
+}
+function orphanFindings(manifest) {
+    return manifest.items
+        .filter((item) => item.requiredContent && !(item.text ?? "").trim())
+        .map((item) => ({
+        id: `orphan-${item.id}`,
+        severity: "blocking",
+        type: "orphan",
+        message: "Required visual item has no text content",
+        itemIds: [item.id],
+        remediable: false,
+    }));
+}
+function boundsFindings(manifest, config) {
+    const byId = new Map(manifest.items.map((item) => [item.id, item]));
+    return manifest.items
+        .filter((item) => item.containerId && byId.has(item.containerId))
+        .filter((item) => {
+        const container = byId.get(item.containerId);
+        return container
+            ? overflowPx(item, container) > config.maxLabelOverflowPx
+            : false;
+    })
+        .map((item) => ({
+        id: `bounds-${item.id}`,
+        severity: "blocking",
+        type: "bounds",
+        message: `Item ${item.id} exceeds container ${item.containerId}`,
+        itemIds: [item.id, item.containerId],
+        remediable: false,
+    }));
+}
+function iconTextGapFindings(manifest, config) {
+    const groups = new Map();
+    for (const item of manifest.items) {
+        if (!item.groupId)
+            continue;
+        groups.set(item.groupId, [...(groups.get(item.groupId) ?? []), item]);
+    }
+    const findings = [];
+    for (const [groupId, items] of groups) {
+        const icon = items.find((item) => item.kind === "icon");
+        const label = items.find((item) => item.kind === "label");
+        if (!icon || !label)
+            continue;
+        const gap = label.x - (icon.x + icon.width);
+        if (gap < config.minIconTextGapPx) {
+            findings.push({
+                id: `gap-${groupId}`,
+                severity: "blocking",
+                type: "icon_text_gap",
+                message: `Icon/text gap is ${Math.round(gap)}px; expected at least ${config.minIconTextGapPx}px`,
+                itemIds: [icon.id, label.id],
+                remediable: true,
+            });
+        }
+    }
+    return findings;
+}
+function rotationFindings(manifest, config) {
+    return manifest.items
+        .filter((item) => typeof item.rotation === "number" &&
+        typeof item.expectedRotation === "number")
+        .filter((item) => {
+        const actual = rotationToRadians(item.rotation, item.rotationUnit, manifest.tool);
+        const expected = rotationToRadians(item.expectedRotation, item.expectedRotationUnit, manifest.tool);
+        return Math.abs(actual - expected) > config.rotationToleranceRadians;
+    })
+        .map((item) => ({
+        id: `rotation-${item.id}`,
+        severity: "blocking",
+        type: "rotation",
+        message: `Rotation mismatch for ${item.id}; Lucid values are normalized as radians`,
+        itemIds: [item.id],
+        remediable: true,
+    }));
+}
+function overflowPx(item, container) {
+    const rightOverflow = item.x + item.width - (container.x + container.width);
+    const bottomOverflow = item.y + item.height - (container.y + container.height);
+    const leftOverflow = container.x - item.x;
+    const topOverflow = container.y - item.y;
+    return Math.max(0, rightOverflow, bottomOverflow, leftOverflow, topOverflow);
+}
+function wildcardMatch(pattern, value) {
+    const escaped = pattern
+        .replace(/[.+?^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*/g, ".*");
+    return new RegExp(`^${escaped}$`, "i").test(value);
+}
+function remediationFor(finding) {
+    if (finding.type === "duplicate") {
+        return `Delete duplicate item ${finding.itemIds[1]} after fresh fetch confirms same text.`;
+    }
+    if (finding.type === "fallback_text") {
+        return `Clear fallback text on ${finding.itemIds.join(", ")}.`;
+    }
+    if (finding.type === "icon_text_gap") {
+        return `Reposition label ${finding.itemIds[1]} to satisfy minimum icon/text gap.`;
+    }
+    if (finding.type === "rotation") {
+        return `Normalize rotation for ${finding.itemIds[0]} to radians before writing through Lucid MCP.`;
+    }
+    return `Review ${finding.itemIds.join(", ")} manually.`;
+}
+export function visualArtifactPath(root, artifactPath) {
+    return path.isAbsolute(artifactPath)
+        ? artifactPath
+        : path.resolve(root, artifactPath);
+}
+//# sourceMappingURL=visual-validation.js.map

package/dist/visual-validation.js.map

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

package/dist/web-action-security.d.ts

@@ -0,0 +1,11 @@
+export interface WebActionAuthorizationInput {
+    root: string;
+    taskId?: string;
+    actor: string;
+    action: string;
+    command?: string;
+    paths?: string[];
+    confirmed?: boolean;
+}
+export declare function authorizeWebAction({ root, taskId, actor, action, command, paths, confirmed, }: WebActionAuthorizationInput): Promise<void>;
+export declare const WEB_ACTION_AUTHORIZED_EVENT = "WEB_ACTION_AUTHORIZED";

package/dist/web-action-security.js

@@ -0,0 +1,45 @@
+import { resolveWorkspaceLocalPath } from "./web-evidence.js";
+import { appendEvent } from "./workspace.js";
+import { evaluateActionPolicy } from "./policy.js";
+import { removeUndefined } from "./command-utils.js";
+export async function authorizeWebAction({ root, taskId, actor, action, command, paths = [], confirmed = false, }) {
+    validateWorkspaceRelativePaths(root, paths);
+    const evaluation = await evaluateActionPolicy(removeUndefined({
+        root,
+        taskId,
+        action,
+        command,
+        paths,
+    }));
+    if (!evaluation.allowed) {
+        throw new Error([
+            "web action blocked by policy",
+            evaluation.tier,
+            evaluation.approvalCommand ?? "approval required",
+        ].join(": "));
+    }
+    if (evaluation.tier !== "routine" && !confirmed) {
+        throw new Error(`web action requires explicit confirmation: ${action}`);
+    }
+    await appendEvent(root, removeUndefined({
+        type: WEB_ACTION_AUTHORIZED_EVENT,
+        taskId,
+        actor,
+        summary: `Web action authorized: ${action}`,
+        metadata: removeUndefined({
+            action,
+            command,
+            paths,
+            tier: evaluation.tier,
+            confirmed,
+            reasons: evaluation.reasons,
+        }),
+    }));
+}
+export const WEB_ACTION_AUTHORIZED_EVENT = "WEB_ACTION_AUTHORIZED";
+function validateWorkspaceRelativePaths(root, paths) {
+    for (const item of paths) {
+        resolveWorkspaceLocalPath(root, item);
+    }
+}
+//# sourceMappingURL=web-action-security.js.map

package/dist/web-action-security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-action-security.js","sourceRoot":"","sources":["../src/web-action-security.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAYrD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,IAAI,EACJ,MAAM,EACN,KAAK,EACL,MAAM,EACN,OAAO,EACP,KAAK,GAAG,EAAE,EACV,SAAS,GAAG,KAAK,GACW;IAC5B,8BAA8B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAC3C,eAAe,CAAC;QACd,IAAI;QACJ,MAAM;QACN,MAAM;QACN,OAAO;QACP,KAAK;KACN,CAAC,CACH,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb;YACE,8BAA8B;YAC9B,UAAU,CAAC,IAAI;YACf,UAAU,CAAC,eAAe,IAAI,mBAAmB;SAClD,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,8CAA8C,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,WAAW,CACf,IAAI,EACJ,eAAe,CAAC;QACd,IAAI,EAAE,2BAA2B;QACjC,MAAM;QACN,KAAK;QACL,OAAO,EAAE,0BAA0B,MAAM,EAAE;QAC3C,QAAQ,EAAE,eAAe,CAAC;YACxB,MAAM;YACN,OAAO;YACP,KAAK;YACL,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,SAAS;YACT,OAAO,EAAE,UAAU,CAAC,OAAO;SAC5B,CAAC;KACH,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,uBAAuB,CAAC;AAEnE,SAAS,8BAA8B,CAAC,IAAY,EAAE,KAAe;IACnE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/web-api-read-routes.js

@@ -1,28 +1,98 @@
 import { listAutonomousRuns } from "./autonomous-workflow.js";
-import { checkUsageBudget, generateTaskGraphPlan, getUsageReport, getWorkflowConfig, getWorkflowStatus, listApprovals, listEvidence, listRoles, listTasks, } from "./workflow-services.js";
+import { readEvents } from "./workspace.js";
+import { checkUsageBudget, generateTaskGraphPlan, getUsageReport, getWorkflowConfig, getWorkflowStatus, listApprovals, listConfiguredModelProviders, listDecisions, listEvidence, listProviderRuntimeProfiles, listReviews, listRoles, listTasks, } from "./workflow-services.js";
 import { validateWorkspace } from "./workspace-validator.js";
 import { getLocalHealthReport } from "./health-checks.js";
 import { classifyWorkspace } from "./workspace-classification.js";
-import { listRuntimeAdapters } from "./runtime-adapters.js";
+import { listRuntimeAdapterCatalog, listRuntimeExecutionAdapters, } from "./runtime-adapters.js";
+import { normalizeRuntimeDelegationGuardrails, summarizeRuntimeDelegationOperations, } from "./runtime-guardrails.js";
+import { planRuntimeInvocation } from "./runtime-execution.js";
 import { listCollaborationFlows } from "./collaboration-flows.js";
 import { listWorkflowTemplates, validateWorkflowTemplates, } from "./workflow-templates.js";
+import { listWorkflowProgress } from "./web-workflow-progress.js";
 import { listAgentLessons, listSkills, readSourceOfTruth, validateSkills, } from "./skills.js";
+import { getRecoveryState } from "./web-recovery.js";
+import { listWebArtifacts } from "./web-artifacts.js";
+import { listMcpIntegrationStatuses } from "./mcp-integrations.js";
 export function createWebReadRoutes() {
     return {
         "/api/status": ({ root }) => getWorkflowStatus(root),
         "/api/validate": ({ root }) => validateWorkspace(root),
+        "/api/recovery/state": ({ root }) => getRecoveryState(root),
+        "/api/artifacts/list": ({ root }) => listWebArtifacts(root),
+        "/api/mcp/integrations": ({ root }) => listMcpIntegrationStatuses(root),
         "/api/health": ({ root }) => getLocalHealthReport({ root }),
         "/api/workspace/classification": ({ root }) => classifyWorkspace({ root }),
-        "/api/runtime/adapters": async () => listRuntimeAdapters(),
+        "/api/runtime/adapters": async () => listRuntimeAdapterCatalog(),
+        "/api/runtime/sessions": async ({ root }) => {
+            const config = await getWorkflowConfig(root);
+            const policy = normalizeRuntimeDelegationGuardrails(config.runtimePolicy?.delegation?.guardrails);
+            const report = summarizeRuntimeDelegationOperations({
+                policy,
+                events: await readEvents(root),
+                includeClosed: true,
+            });
+            const tasks = await listTasks(root);
+            return {
+                ...report,
+                duplicateWarnings: runtimeDuplicateWarnings(report.sessions, tasks),
+                circuitBreaker: runtimeCircuitBreaker(report, policy),
+            };
+        },
+        "/api/runtime/invocation-plans": async () => listRuntimeExecutionAdapters().map((adapter) => ({
+            runtime: adapter.id,
+            gated: planRuntimeInvocation({
+                runtime: adapter.id,
+                gates: "phase",
+            }),
+            autonomous: planRuntimeInvocation({
+                runtime: adapter.id,
+                gates: "none",
+            }),
+        })),
         "/api/graph/plan": ({ root }) => generateTaskGraphPlan(root),
         "/api/roles": ({ root }) => listRoles(root),
         "/api/evidence": ({ root }) => listEvidence(undefined, root),
+        "/api/reviews": ({ root }) => listReviews(undefined, root),
+        "/api/decisions": ({ root }) => listDecisions(undefined, root),
+        "/api/provider/health": async ({ root }) => {
+            const config = await getWorkflowConfig(root);
+            const providers = await listConfiguredModelProviders(root);
+            const blocked = new Set(config.providerPolicy?.blockedProviders ?? []);
+            const allowed = config.providerPolicy?.allowedProviders ?? [];
+            return providers.map((provider) => ({
+                ...provider,
+                status: blocked.has(provider.provider)
+                    ? "fail"
+                    : allowed.length > 0 && !allowed.includes(provider.provider)
+                        ? "warn"
+                        : "pass",
+                detail: blocked.has(provider.provider)
+                    ? "provider is blocked by policy"
+                    : allowed.length > 0 && !allowed.includes(provider.provider)
+                        ? "provider is not in allowedProviders"
+                        : "routing policy allows this provider",
+            }));
+        },
+        "/api/provider/profiles": async ({ root }) => {
+            const config = await getWorkflowConfig(root);
+            return {
+                policy: {
+                    allowedProviders: config.providerPolicy?.allowedProviders ?? [],
+                    blockedProviders: config.providerPolicy?.blockedProviders ?? [],
+                    allowVendorFallbackWithoutApproval: config.providerPolicy?.allowVendorFallbackWithoutApproval ?? false,
+                },
+                routing: await listConfiguredModelProviders(root),
+                profiles: await listProviderRuntimeProfiles(root),
+            };
+        },
         "/api/approvals": ({ root }) => listApprovals(undefined, root),
         "/api/config": ({ root }) => getWorkflowConfig(root),
         "/api/usage": ({ root }) => getUsageReport(undefined, root),
         "/api/budget": ({ root }) => checkUsageBudget(undefined, root),
         "/api/tasks": ({ root }) => listTasks(root),
         "/api/workflow/runs": ({ root }) => listAutonomousRuns(root),
+        "/api/workflow/progress": ({ root }) => listWorkflowProgress(root),
         "/api/skills": async () => listSkills(),
         "/api/skills/validate": async () => validateSkills(),
         "/api/collaboration/flows": async () => listCollaborationFlows(),
@@ -34,4 +104,46 @@ export function createWebReadRoutes() {
         "/api/lessons": ({ root }) => listAgentLessons(root),
     };
 }
+function runtimeCircuitBreaker(report, policy) {
+    if (report.counts.stale > 0) {
+        return {
+            active: true,
+            reason: "stale delegation sessions require recovery before spawning more work",
+        };
+    }
+    if (report.counts.active >= policy.maxConcurrentDelegates) {
+        return {
+            active: true,
+            reason: `active delegates reached maxConcurrentDelegates ${policy.maxConcurrentDelegates}`,
+        };
+    }
+    return {
+        active: false,
+        reason: "delegation guardrails allow new sessions within configured limits",
+    };
+}
+function runtimeDuplicateWarnings(sessions, tasks) {
+    const active = sessions.filter((session) => session.active);
+    const tasksById = new Map(tasks.map((task) => [task.id, task]));
+    const warnings = [];
+    for (let index = 0; index < active.length; index += 1) {
+        for (let nextIndex = index + 1; nextIndex < active.length; nextIndex += 1) {
+            const left = active[index];
+            const right = active[nextIndex];
+            const duplicateRoles = intersection(left.roles, right.roles);
+            const duplicatePaths = intersection(tasksById.get(left.taskId)?.paths ?? [], tasksById.get(right.taskId)?.paths ?? []);
+            if (duplicateRoles.length > 0) {
+                warnings.push(`${left.sessionId} and ${right.sessionId} share roles: ${duplicateRoles.join(", ")}`);
+            }
+            if (duplicatePaths.length > 0) {
+                warnings.push(`${left.sessionId} and ${right.sessionId} share paths: ${duplicatePaths.join(", ")}`);
+            }
+        }
+    }
+    return warnings;
+}
+function intersection(left, right) {
+    const rightSet = new Set(right);
+    return [...new Set(left.filter((item) => rightSet.has(item)))];
+}
 //# sourceMappingURL=web-api-read-routes.js.map

package/dist/web-api-read-routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-api-read-routes.js","sourceRoot":"","sources":["../src/web-api-read-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,SAAS,GACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AAQrB,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACpD,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACtD,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC;QAC3D,+BAA+B,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC;QAC1E,uBAAuB,EAAE,KAAK,IAAI,EAAE,CAAC,mBAAmB,EAAE;QAC1D,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC;QAC5D,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;QAC3C,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC;QAC5D,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC;QAC9D,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACpD,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC;QAC3D,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC;QAC9D,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;QAC3C,oBAAoB,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAC5D,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,UAAU,EAAE;QACvC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,cAAc,EAAE;QACpD,0BAA0B,EAAE,KAAK,IAAI,EAAE,CAAC,sBAAsB,EAAE;QAChE,yBAAyB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACtC,SAAS,EAAE,qBAAqB,EAAE;YAClC,gBAAgB,EAAE,yBAAyB,EAAE;SAC9C,CAAC;QACF,cAAc,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACrD,cAAc,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;KACrD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"web-api-read-routes.js","sourceRoot":"","sources":["../src/web-api-read-routes.ts"],"names":[],"mappings":"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"}