@decibelsystems/tools 2.1.2 → 2.1.3

package/dist/agentPresence.js

@@ -0,0 +1,227 @@
+// ============================================================================
+// Agent-presence writer — heartbeats live claude-peers sessions into Core
+// ============================================================================
+// Daemon-side telemetry writer for the Plan D agent-presence domain. On a 30s
+// loop it:
+//   1. reads live peers from the claude-peers broker (POST /list-peers),
+//   2. upserts each into hq.agent_sessions via SERVICE_ROLE (deliberate scoped
+//      exception — presence is telemetry, peers carry no user JWT, v1 single-org),
+//   3. stale-sweeps active rows that stopped heartbeating → idle (>90s) / ended (>5min).
+// Never throws into the daemon; no-ops if Supabase isn't configured or the broker
+// is down. Contract co-designed with decibel-hq (migration 20260524000005). EPIC-0033.
+// ============================================================================
+import os from 'os';
+import path from 'path';
+import { createClient } from '@supabase/supabase-js';
+import { log } from './config.js';
+import { withRetryResult } from './supabaseRetry.js';
+const BROKER_URL = `http://127.0.0.1:${process.env.CLAUDE_PEERS_PORT ?? '7899'}`;
+const ORG_ID = process.env.DECIBEL_ORG_ID || '1cb79e24-e06f-46c9-8a22-5ee025ffb0f4';
+/**
+ * The daemon's host identity for presence + command targeting. Defaults to
+ * os.hostname() but is overridable via DECIBEL_PRESENCE_HOST — needed where the
+ * OS hostname isn't a stable/unique daemon identity (containers with shared
+ * hostnames, or two daemons on one machine, e.g. a rolling restart or a test
+ * harness). target_host on hq.agent_commands matches this, so it must be the same
+ * value the presence writer stamps. Shared by the dispatcher (agentCommands.ts).
+ */
+export function resolveHost() {
+    return process.env.DECIBEL_PRESENCE_HOST || os.hostname();
+}
+const HEARTBEAT_MS = 30_000;
+const IDLE_AFTER_MS = 90_000;
+const ENDED_AFTER_MS = 5 * 60_000;
+function serviceClient() {
+    const url = process.env.SUPABASE_URL;
+    const key = process.env.SUPABASE_SERVICE_KEY;
+    if (!url || !key)
+        return null;
+    return createClient(url, key, {
+        auth: { persistSession: false, autoRefreshToken: false },
+        db: { schema: 'hq' },
+    });
+}
+async function fetchPeers() {
+    try {
+        const res = await fetch(`${BROKER_URL}/list-peers`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ requester_id: 'decibel-presence', scope: 'machine' }),
+            signal: AbortSignal.timeout(2000),
+        });
+        if (!res.ok)
+            return [];
+        return (await res.json());
+    }
+    catch {
+        return [];
+    }
+}
+// project label (repo dir basename) → hq.projects.id within the org. Cached;
+// refreshed on a miss so newly-onboarded projects resolve.
+let projectMap = null;
+async function loadProjects(client) {
+    const { data, error } = await client.from('projects').select('id,key').eq('org_id', ORG_ID);
+    const m = new Map();
+    if (!error && data)
+        for (const r of data)
+            m.set(r.key, r.id);
+    return m;
+}
+async function resolveProjectId(client, cwd) {
+    const key = path.basename(cwd || '');
+    if (!key)
+        return null;
+    if (!projectMap)
+        projectMap = await loadProjects(client);
+    if (!projectMap.has(key))
+        projectMap = await loadProjects(client); // refresh once on miss
+    return projectMap.get(key) ?? null;
+}
+async function tick(client) {
+    const host = resolveHost();
+    const nowMs = Date.now();
+    const nowIso = new Date(nowMs).toISOString();
+    const peers = await fetchPeers();
+    for (const p of peers) {
+        if (!p.id)
+            continue;
+        const project_id = await resolveProjectId(client, p.cwd);
+        const row = {
+            org_id: ORG_ID,
+            host,
+            session_key: p.id,
+            agent: null,
+            // These are Claude Code sessions read from the claude-peers broker; tag the
+            // runtime so HQ's /agents board renders the runtime badge + filter (P1/P5).
+            runtime: 'claude-code',
+            summary: p.summary || null,
+            cwd: p.cwd || null,
+            project_id,
+            status: 'active',
+            started_at: p.registered_at || nowIso,
+            last_seen_at: nowIso,
+            ended_at: null,
+            // last_action_at = the broker's per-peer last_seen → HQ's ActivityLine renders
+            // a tool-call pulse from it. Richer self-report fields (tokens, current_file)
+            // are a follow-on (agent-side self-report; not daemon-observable).
+            meta: { last_action_at: p.last_seen || nowIso },
+        };
+        const { error } = await withRetryResult(() => client.from('agent_sessions').upsert(row, { onConflict: 'org_id,host,session_key' }), `presence.upsert ${p.id}`);
+        if (error)
+            log(`Presence: upsert ${p.id} failed: ${error.message}`);
+    }
+    // Stale-sweep: sessions that stopped heartbeating (broker dropped them, or daemon
+    // missed beats). idle first, then ended (ended uses status<>'ended' so it also
+    // catches idle rows past the longer cutoff).
+    const idleCut = new Date(nowMs - IDLE_AFTER_MS).toISOString();
+    const endedCut = new Date(nowMs - ENDED_AFTER_MS).toISOString();
+    await client.from('agent_sessions').update({ status: 'idle' })
+        .eq('org_id', ORG_ID).eq('status', 'active').lt('last_seen_at', idleCut);
+    await client.from('agent_sessions').update({ status: 'ended', ended_at: nowIso })
+        .eq('org_id', ORG_ID).neq('status', 'ended').lt('last_seen_at', endedCut);
+}
+// ---------------------------------------------------------------------------
+// Write-time presence-field belt (NON-encoding) — co-designed with decibel-hq.
+// ---------------------------------------------------------------------------
+// HQ's /agents board already escapes these at render (React JSX text children),
+// so the daemon MUST NOT HTML-encode here — that would double-escape and corrupt
+// legitimate data (a real summary like "fix <Button> when a < b"). The correct
+// write-time defense-in-depth is non-encoding: cap length + strip control chars /
+// null bytes (preserving \t\n\r) so the stored value stays faithful but bounded.
+// Also closes the review's "no validation on meta/result blobs" finding.
+const FIELD_CAPS = { agent: 200, summary: 500, cwd: 1024 };
+const META_VALUE_CAP = 1000;
+const META_MAX_BYTES = 4096;
+// C0 controls (U+0000..U+001F) + DEL (U+007F), EXCEPT tab/newline/carriage-return.
+// eslint-disable-next-line no-control-regex
+const CONTROL_CHARS = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g;
+/** Strip control chars/null bytes and cap length. Empty-after-clean → null. */
+export function sanitizeText(s, maxLen) {
+    if (s == null)
+        return null;
+    const cleaned = String(s).replace(CONTROL_CHARS, '').slice(0, maxLen);
+    return cleaned.length ? cleaned : null;
+}
+/**
+ * Flatten meta to display-safe primitives: strings cleaned + capped, numbers/
+ * booleans/null kept, nested objects/arrays dropped (HQ typeof-guards numeric
+ * meta and renders strings as text). If the result still exceeds META_MAX_BYTES,
+ * drop it entirely — the caller re-adds the trusted last_action_at.
+ */
+export function sanitizeMeta(meta) {
+    if (!meta || typeof meta !== 'object')
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(meta)) {
+        if (typeof v === 'string')
+            out[k] = v.replace(CONTROL_CHARS, '').slice(0, META_VALUE_CAP);
+        else if (typeof v === 'number' || typeof v === 'boolean' || v === null)
+            out[k] = v;
+        // nested objects/arrays intentionally dropped
+    }
+    if (Buffer.byteLength(JSON.stringify(out)) > META_MAX_BYTES)
+        return {};
+    return out;
+}
+/**
+ * Upsert a local-runtime session into hq.agent_sessions (register or heartbeat).
+ * Returns true on success, false if Supabase is unconfigured or the write failed.
+ * Reuses the presence writer's org config + cwd→project resolution.
+ */
+export async function writeLocalAgentSession(reg) {
+    const client = serviceClient();
+    if (!client)
+        return false;
+    if (!reg.session_key || !reg.runtime)
+        return false;
+    const host = resolveHost();
+    const nowIso = new Date().toISOString();
+    const project_id = await resolveProjectId(client, reg.cwd || '');
+    const ended = reg.status === 'ended';
+    const row = {
+        org_id: ORG_ID,
+        host,
+        session_key: reg.session_key,
+        runtime: reg.runtime,
+        // Non-encoding belt on caller-supplied display fields (store-raw / escape-at-
+        // render is HQ's job; we only cap length + strip control chars/null bytes).
+        agent: sanitizeText(reg.agent, FIELD_CAPS.agent),
+        summary: sanitizeText(reg.summary, FIELD_CAPS.summary),
+        cwd: sanitizeText(reg.cwd, FIELD_CAPS.cwd),
+        project_id,
+        status: ended ? 'ended' : 'active',
+        started_at: nowIso,
+        last_seen_at: nowIso,
+        ended_at: ended ? nowIso : null,
+        // Default last_action_at to now; a self-reporting SDK may override it via meta
+        // (intended richer signal — HQ reads last_seen_at, not this, for liveness).
+        meta: { last_action_at: nowIso, ...sanitizeMeta(reg.meta) },
+    };
+    // started_at only matters on first insert; onConflict updates the rest. We let it
+    // re-send started_at — harmless on heartbeat since HQ reads last_seen_at for liveness.
+    const { error } = await withRetryResult(() => client.from('agent_sessions').upsert(row, { onConflict: 'org_id,host,session_key' }), `presence.local-register ${reg.session_key}`);
+    if (error) {
+        log(`Presence: local register ${reg.session_key} (${reg.runtime}) failed: ${error.message}`);
+        return false;
+    }
+    return true;
+}
+/** Start the presence writer loop. Returns a stop function. No-ops if Supabase unconfigured. */
+export function startPresenceWriter() {
+    const client = serviceClient();
+    if (!client) {
+        log('Presence: SUPABASE_URL/SERVICE_KEY not set — agent-presence writer disabled.');
+        return () => { };
+    }
+    log(`Presence: writer started (30s heartbeat → hq.agent_sessions, org ${ORG_ID}).`);
+    const run = () => {
+        tick(client).catch((e) => log(`Presence: tick error: ${e instanceof Error ? e.message : String(e)}`));
+    };
+    run();
+    const iv = setInterval(run, HEARTBEAT_MS);
+    if (typeof iv.unref === 'function')
+        iv.unref();
+    return () => clearInterval(iv);
+}
+//# sourceMappingURL=agentPresence.js.map

package/dist/agentPresence.js.map

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

package/dist/agenticJobs.d.ts

@@ -0,0 +1,49 @@
+export type JobStatus = 'queued' | 'claimed' | 'running' | 'done' | 'cancelled' | 'failed';
+export interface AgenticJob {
+    id: string;
+    project_id: string;
+    prompt: string;
+    status: JobStatus;
+    claimed_by?: string;
+    claimed_at?: string;
+    completed_at?: string;
+    result?: {
+        output?: string;
+        files_changed?: string[];
+    };
+    created_at: string;
+    created_by?: string;
+    [key: string]: unknown;
+}
+export interface EnqueueJobInput {
+    projectId: string;
+    prompt: string;
+    createdBy?: string;
+}
+export interface EnqueueJobOutput {
+    jobId: string;
+    queuePosition: number;
+    filePath: string;
+}
+export interface CancelJobInput {
+    projectId: string;
+    jobId: string;
+}
+/**
+ * List all jobs for a project. Returns oldest-first (creation order). Reads
+ * from both .decibel/ and decibel/ paths, deduplicating by id.
+ */
+export declare function listJobs(projectId: string): Promise<AgenticJob[]>;
+/**
+ * Enqueue a new dispatch job. Allocates the next JOB-NNNN id, writes the
+ * YAML file, and returns the id + queue position (number of active jobs
+ * ahead of this one, inclusive).
+ */
+export declare function enqueueJob(input: EnqueueJobInput): Promise<EnqueueJobOutput>;
+/**
+ * Cancel a queued / claimed job. No-op if the job is already terminal
+ * (done / cancelled / failed). Marks status: cancelled and stamps
+ * completed_at.
+ */
+export declare function cancelJob(input: CancelJobInput): Promise<AgenticJob>;
+//# sourceMappingURL=agenticJobs.d.ts.map

package/dist/agenticJobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agenticJobs.d.ts","sourceRoot":"","sources":["../src/agenticJobs.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,SAAS,GACT,SAAS,GACT,MAAM,GACN,WAAW,GACX,QAAQ,CAAC;AAEb,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AA2FD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAoBvE;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsClF;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA6B1E"}

package/dist/agenticJobs.js

@@ -0,0 +1,190 @@
+// ============================================================================
+// Agentic Dispatch Jobs
+// ============================================================================
+// User-queued prompts that agents (Claude Code, Codex, etc.) read from the
+// project's `.decibel/agentic/jobs/` directory and execute. HQ writes via
+// agentic.enqueue; agents claim and complete via their MCP tool calls.
+//
+// See docs-hq/AGENTIC_DISPATCH.md (in the HQ repo) for the full 3-layer
+// contract this implements.
+// ============================================================================
+import fs from 'fs/promises';
+import path from 'path';
+import { parse as parseYaml, parseAllDocuments, stringify as stringifyYaml } from 'yaml';
+import { log } from './config.js';
+import { getWritePath, readFilesFromBothPaths } from './decibelPaths.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const JOBS_SUBPATH = 'agentic/jobs';
+// ============================================================================
+// Helpers
+// ============================================================================
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .substring(0, 40);
+}
+function extractJobNumber(id) {
+    const match = id.match(/^JOB-(\d+)$/i);
+    return match ? parseInt(match[1], 10) : 0;
+}
+function formatJobId(num) {
+    return `JOB-${num.toString().padStart(4, '0')}`;
+}
+async function ensureDir(dirPath) {
+    try {
+        await fs.mkdir(dirPath, { recursive: true });
+    }
+    catch {
+        // Directory already exists or other error — list/write will surface real issues
+    }
+}
+/**
+ * Multi-document YAML parser. Frontmatter format (--- delimited) returns
+ * the first doc; plain YAML returns directly. Mirrors sentinelIssues.ts.
+ */
+function safeParseYaml(content) {
+    try {
+        return parseYaml(content);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (!message.includes('multiple documents'))
+            throw err;
+    }
+    const docs = parseAllDocuments(content);
+    if (docs.length === 0)
+        throw new Error('No YAML documents found');
+    const first = docs[0].toJSON();
+    if (typeof first !== 'object' || first === null) {
+        throw new Error('First YAML document is not an object');
+    }
+    return first;
+}
+function parseJobFile(content, fallbackProjectId) {
+    let parsed;
+    try {
+        parsed = safeParseYaml(content);
+    }
+    catch (err) {
+        log(`agenticJobs: failed to parse job YAML: ${err.message}`);
+        return null;
+    }
+    const id = parsed.id;
+    const prompt = parsed.prompt;
+    if (!id || !prompt)
+        return null;
+    return {
+        id,
+        project_id: parsed.project_id || fallbackProjectId,
+        prompt,
+        status: parsed.status || 'queued',
+        claimed_by: parsed.claimed_by,
+        claimed_at: parsed.claimed_at,
+        completed_at: parsed.completed_at,
+        result: parsed.result,
+        created_at: parsed.created_at || new Date().toISOString(),
+        created_by: parsed.created_by,
+    };
+}
+function jobToYaml(job) {
+    return stringifyYaml(job);
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * List all jobs for a project. Returns oldest-first (creation order). Reads
+ * from both .decibel/ and decibel/ paths, deduplicating by id.
+ */
+export async function listJobs(projectId) {
+    const seen = new Set();
+    const jobs = [];
+    const files = await readFilesFromBothPaths(projectId, JOBS_SUBPATH);
+    for (const { filePath } of files) {
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const job = parseJobFile(content, projectId);
+            if (!job || seen.has(job.id))
+                continue;
+            seen.add(job.id);
+            jobs.push(job);
+        }
+        catch (err) {
+            log(`agenticJobs: skipping ${filePath} — ${err.message}`);
+        }
+    }
+    // Sort oldest-first by creation timestamp
+    jobs.sort((a, b) => a.created_at.localeCompare(b.created_at));
+    return jobs;
+}
+/**
+ * Enqueue a new dispatch job. Allocates the next JOB-NNNN id, writes the
+ * YAML file, and returns the id + queue position (number of active jobs
+ * ahead of this one, inclusive).
+ */
+export async function enqueueJob(input) {
+    const { projectId, prompt, createdBy } = input;
+    if (!prompt || !prompt.trim()) {
+        throw new Error('prompt is required');
+    }
+    const dir = await getWritePath(projectId, JOBS_SUBPATH);
+    await ensureDir(dir);
+    const existing = await listJobs(projectId);
+    const maxNum = existing.reduce((max, j) => Math.max(max, extractJobNumber(j.id)), 0);
+    const newId = formatJobId(maxNum + 1);
+    const slug = slugify(prompt);
+    const filename = slug ? `${newId}-${slug}.yml` : `${newId}.yml`;
+    const filePath = path.join(dir, filename);
+    const now = new Date().toISOString();
+    const job = {
+        id: newId,
+        project_id: projectId,
+        prompt: prompt.trim(),
+        status: 'queued',
+        created_at: now,
+        ...(createdBy ? { created_by: createdBy } : {}),
+    };
+    await fs.writeFile(filePath, jobToYaml(job), 'utf-8');
+    log(`agenticJobs: enqueued ${newId} for project ${projectId}`);
+    // Queue position = count of "active" jobs (not done / cancelled / failed)
+    // including this new one. Useful for UX.
+    const activeCount = existing.filter((j) => j.status === 'queued' || j.status === 'claimed' || j.status === 'running').length + 1;
+    return { jobId: newId, queuePosition: activeCount, filePath };
+}
+/**
+ * Cancel a queued / claimed job. No-op if the job is already terminal
+ * (done / cancelled / failed). Marks status: cancelled and stamps
+ * completed_at.
+ */
+export async function cancelJob(input) {
+    const { projectId, jobId } = input;
+    if (!jobId.match(/^JOB-\d+$/)) {
+        throw new Error(`Invalid job id: ${jobId} (expected JOB-NNNN)`);
+    }
+    const files = await readFilesFromBothPaths(projectId, JOBS_SUBPATH);
+    for (const { filePath } of files) {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const job = parseJobFile(content, projectId);
+        if (!job || job.id !== jobId)
+            continue;
+        // Already-terminal jobs are not re-cancelled but still return the
+        // current state so callers can refresh UI.
+        if (job.status === 'done' || job.status === 'cancelled' || job.status === 'failed') {
+            return job;
+        }
+        const updated = {
+            ...job,
+            status: 'cancelled',
+            completed_at: new Date().toISOString(),
+        };
+        await fs.writeFile(filePath, jobToYaml(updated), 'utf-8');
+        log(`agenticJobs: cancelled ${jobId} for project ${projectId}`);
+        return updated;
+    }
+    throw new Error(`Job not found: ${jobId}`);
+}
+//# sourceMappingURL=agenticJobs.js.map

package/dist/agenticJobs.js.map

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

package/dist/architectAdrs.d.ts

@@ -12,6 +12,13 @@ export interface AdrOutput {
     id: string;
     path: string;
 }
+/**
+ * Parse an ADR file into a uniform record, handling BOTH the new markdown shape
+ * (frontmatter + ## Context/## Decision/## Consequences) AND legacy .yml ADRs.
+ * Exported so tests and external readers can assert against the canonical
+ * uniform shape rather than having to know which on-disk format produced the file.
+ */
+export declare function parseAdrContent(filename: string, content: string): Record<string, unknown>;
 /**
  * Create a new project-level ADR
  */

package/dist/architectAdrs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"architectAdrs.d.ts","sourceRoot":"","sources":["../src/architectAdrs.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;AAE9E,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAiFD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CA2D1E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC,CAqBF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAazC"}
+{"version":3,"file":"architectAdrs.d.ts","sourceRoot":"","sources":["../src/architectAdrs.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;AAE9E,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AA4FD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4B1F;AAMD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAmE1E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC,CAqBF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAazC"}