@cavi-ai/api-client 0.1.0

package/dist/extensions/cavi/discourse/normalize.js

@@ -0,0 +1,287 @@
+import { asBoolean, asNumber, asString, asStringArray, isRecord, } from "../../../core/data/guards.js";
+import { asBlockerSeverity, asCompletionOutcome, asDiscourseMessageText, asDiscourseScalarToken, asDiscourseSummaryOutcome, asResolutionMethod, coerceDiscourseDataRecord, isDiscourseEventType, } from "./normalize-helpers.js";
+export function normalizeDiscourseEvent(raw, fallbackTaskId) {
+    const record = isRecord(raw) ? raw : null;
+    if (!record) {
+        return null;
+    }
+    const type = isDiscourseEventType(record.type) ? record.type : null;
+    if (!type) {
+        return null;
+    }
+    const data = coerceDiscourseDataRecord(record.data);
+    const eventBase = {
+        id: asString(record.id) ?? `discourse-${type}-${Date.now()}`,
+        ts: asNumber(record.ts) ?? Date.now(),
+        taskId: asString(record.taskId) ?? fallbackTaskId,
+        parentTaskId: record.parentTaskId === null ? null : asString(record.parentTaskId),
+        agentId: asString(record.agentId) ?? "unknown-agent",
+        sessionKey: asString(record.sessionKey) ?? "unknown-session",
+        runId: asString(record.runId) ?? "unknown-run",
+    };
+    switch (type) {
+        case "discourse.dispatch":
+            return {
+                ...eventBase,
+                type,
+                data: {
+                    targetAgentId: asString(data.targetAgentId) ?? "unknown-agent",
+                    objective: asDiscourseMessageText(data.objective, "No objective recorded."),
+                    tier: asDiscourseScalarToken(data.tier, "STANDARD"),
+                    packetType: asDiscourseScalarToken(data.packetType, "L1_TASK_V1"),
+                    approachRationale: (() => {
+                        const text = asDiscourseMessageText(data.approachRationale, "");
+                        return text.trim().length > 0 ? text : undefined;
+                    })(),
+                    alternativesConsidered: asStringArray(data.alternativesConsidered),
+                },
+            };
+        case "discourse.delegation":
+            return {
+                ...eventBase,
+                type,
+                data: {
+                    targetAgentId: asString(data.targetAgentId) ?? "unknown-agent",
+                    objective: asDiscourseMessageText(data.objective, "No delegation objective recorded."),
+                    teamId: asString(data.teamId) ?? undefined,
+                    rationale: (() => {
+                        const text = asDiscourseMessageText(data.rationale, "");
+                        return text.trim().length > 0 ? text : undefined;
+                    })(),
+                },
+            };
+        case "discourse.decision":
+            return {
+                ...eventBase,
+                type,
+                data: {
+                    question: asDiscourseMessageText(data.question, "Decision point"),
+                    chosenApproach: asDiscourseMessageText(data.chosenApproach, "unknown"),
+                    rationale: asDiscourseMessageText(data.rationale, "No rationale recorded."),
+                    alternatives: Array.isArray(data.alternatives)
+                        ? data.alternatives
+                            .map((entry) => {
+                            if (!isRecord(entry)) {
+                                return null;
+                            }
+                            return {
+                                approach: asDiscourseMessageText(entry.approach, "unknown"),
+                                reasonRejected: asDiscourseMessageText(entry.reasonRejected, "Not provided"),
+                            };
+                        })
+                            .filter((entry) => entry !== null)
+                        : [],
+                },
+            };
+        case "discourse.blocker":
+            return {
+                ...eventBase,
+                type,
+                data: {
+                    blockerCode: asString(data.blockerCode) ?? "unknown_blocker",
+                    description: asDiscourseMessageText(data.description, "No blocker details provided."),
+                    severity: asBlockerSeverity(data.severity),
+                    retryable: asBoolean(data.retryable) ?? false,
+                },
+            };
+        case "discourse.resolution":
+            return {
+                ...eventBase,
+                type,
+                data: {
+                    originalBlockerEventId: asString(data.originalBlockerEventId) ?? "unknown-blocker",
+                    resolution: asDiscourseMessageText(data.resolution, "No resolution details recorded."),
+                    method: asResolutionMethod(data.method),
+                },
+            };
+        case "discourse.status":
+            return {
+                ...eventBase,
+                type,
+                data: {
+                    prevState: asString(data.prevState) ?? "unknown",
+                    nextState: asString(data.nextState) ?? "unknown",
+                    note: (() => {
+                        const text = asDiscourseMessageText(data.note, "");
+                        return text.trim().length > 0 ? text : undefined;
+                    })(),
+                },
+            };
+        case "discourse.escalation":
+            return {
+                ...eventBase,
+                type,
+                data: {
+                    reason: asDiscourseMessageText(data.reason, "No escalation reason provided."),
+                    target: asString(data.target) ?? "unknown",
+                    severity: asString(data.severity),
+                },
+            };
+        case "discourse.completion":
+            return {
+                ...eventBase,
+                type,
+                data: {
+                    outcome: asCompletionOutcome(data.outcome),
+                    resultSummary: asDiscourseMessageText(data.resultSummary, "No completion summary recorded."),
+                    tokensUsed: asNumber(data.tokensUsed) ?? 0,
+                    costUsd: asNumber(data.costUsd) ?? 0,
+                    durationMs: asNumber(data.durationMs) ?? 0,
+                },
+            };
+        case "discourse.spawn.dedup":
+            return {
+                ...eventBase,
+                type,
+                data: {
+                    targetAgentId: asString(data.targetAgentId) ?? "unknown-agent",
+                    existingChildSessionKey: asString(data.existingChildSessionKey) ?? "unknown-session",
+                    ttlMs: asNumber(data.ttlMs) ?? 0,
+                },
+            };
+        case "discourse.spawn.guard":
+            return {
+                ...eventBase,
+                type,
+                data: {
+                    targetAgentId: asString(data.targetAgentId) ?? "unknown-agent",
+                    failureCode: asString(data.failureCode) ?? "unknown_failure",
+                    strikeCount: asNumber(data.strikeCount) ?? 0,
+                    ttlMs: asNumber(data.ttlMs) ?? 0,
+                },
+            };
+        case "discourse.spawn.budget":
+            return {
+                ...eventBase,
+                type,
+                data: {
+                    recentFailureCount: asNumber(data.recentFailureCount) ?? 0,
+                    blockStrikeCount: asNumber(data.blockStrikeCount) ?? 0,
+                    retryAfterMs: asNumber(data.retryAfterMs) ?? 0,
+                },
+            };
+    }
+}
+function normalizeTaskDiscourseAgent(raw) {
+    const record = isRecord(raw) ? raw : null;
+    if (!record) {
+        return null;
+    }
+    const agentId = asString(record.agentId);
+    if (!agentId) {
+        return null;
+    }
+    return {
+        agentId,
+        role: asString(record.role) ?? "unknown-role",
+        eventCount: asNumber(record.eventCount) ?? 0,
+        tokensUsed: asNumber(record.tokensUsed) ?? 0,
+        costUsd: asNumber(record.costUsd) ?? 0,
+    };
+}
+function normalizeDelegationNode(raw, fallbackTaskId) {
+    const record = isRecord(raw) ? raw : null;
+    if (!record) {
+        return null;
+    }
+    const childrenRaw = Array.isArray(record.children) ? record.children : [];
+    const eventsRaw = Array.isArray(record.events) ? record.events : [];
+    const costRaw = isRecord(record.cost) ? record.cost : {};
+    return {
+        taskId: asString(record.taskId) ?? fallbackTaskId,
+        agentId: asString(record.agentId) ?? "unknown-agent",
+        objective: asString(record.objective) ?? "No objective recorded.",
+        status: asString(record.status) ?? "unknown",
+        children: childrenRaw
+            .map((entry) => normalizeDelegationNode(entry, fallbackTaskId))
+            .filter((entry) => entry !== null),
+        events: eventsRaw
+            .map((entry) => normalizeDiscourseEvent(entry, fallbackTaskId))
+            .filter((entry) => entry !== null)
+            .sort((left, right) => left.ts - right.ts),
+        cost: {
+            tokens: asNumber(costRaw.tokens) ?? 0,
+            costUsd: asNumber(costRaw.costUsd) ?? 0,
+            durationMs: asNumber(costRaw.durationMs),
+        },
+    };
+}
+function inferDiscourseOutcome(events) {
+    const completionEvents = events.filter((event) => event.type === "discourse.completion");
+    if (completionEvents.some((event) => event.type === "discourse.completion" &&
+        (event.data.outcome === "error" || event.data.outcome === "timeout"))) {
+        return "fail";
+    }
+    if (completionEvents.some((event) => event.type === "discourse.completion" &&
+        event.data.outcome === "partial")) {
+        return "partial";
+    }
+    if (completionEvents.some((event) => event.type === "discourse.completion" && event.data.outcome === "ok")) {
+        return "success";
+    }
+    if (events.some((event) => event.type === "discourse.blocker")) {
+        return "blocked";
+    }
+    return "pending";
+}
+function resolveDiscourseDuration(events) {
+    if (events.length < 2) {
+        return null;
+    }
+    const timestamps = events.map((event) => event.ts).filter((ts) => ts > 0);
+    if (timestamps.length < 2) {
+        return null;
+    }
+    const minTs = Math.min(...timestamps);
+    const maxTs = Math.max(...timestamps);
+    return maxTs > minTs ? maxTs - minTs : null;
+}
+function normalizeTaskDiscourseSummary(params) {
+    const record = isRecord(params.raw) ? params.raw : {};
+    const totalTokensFallback = params.agents.reduce((sum, agent) => sum + agent.tokensUsed, 0);
+    const totalCostFallback = params.agents.reduce((sum, agent) => sum + agent.costUsd, 0);
+    const blockerCountFallback = params.events.filter((event) => event.type === "discourse.blocker").length;
+    const decisionCountFallback = params.events.filter((event) => event.type === "discourse.decision").length;
+    return {
+        totalAgents: asNumber(record.totalAgents) ?? params.agents.length,
+        totalEvents: asNumber(record.totalEvents) ?? params.events.length,
+        totalTokens: asNumber(record.totalTokens) ?? totalTokensFallback,
+        totalCostUsd: asNumber(record.totalCostUsd) ?? totalCostFallback,
+        durationMs: asNumber(record.durationMs) ?? resolveDiscourseDuration(params.events),
+        blockerCount: asNumber(record.blockerCount) ?? blockerCountFallback,
+        decisionCount: asNumber(record.decisionCount) ?? decisionCountFallback,
+        outcome: asDiscourseSummaryOutcome(record.outcome) ??
+            inferDiscourseOutcome(params.events),
+    };
+}
+export function normalizeTaskDiscourseSnapshot(raw, fallbackTaskId) {
+    const record = isRecord(raw) ? raw : {};
+    const rootTaskId = asString(record.rootTaskId) ?? fallbackTaskId;
+    const eventsRaw = Array.isArray(record.events) ? record.events : [];
+    const agentsRaw = Array.isArray(record.agents) ? record.agents : [];
+    const treeRaw = Array.isArray(record.delegationTree)
+        ? record.delegationTree
+        : [];
+    const events = eventsRaw
+        .map((entry) => normalizeDiscourseEvent(entry, rootTaskId))
+        .filter((entry) => entry !== null)
+        .sort((left, right) => left.ts - right.ts);
+    const agents = agentsRaw
+        .map((entry) => normalizeTaskDiscourseAgent(entry))
+        .filter((entry) => entry !== null);
+    const delegationTree = treeRaw
+        .map((entry) => normalizeDelegationNode(entry, rootTaskId))
+        .filter((entry) => entry !== null);
+    const summary = normalizeTaskDiscourseSummary({
+        raw: record.summary,
+        agents,
+        events,
+    });
+    return {
+        rootTaskId,
+        agents,
+        events,
+        delegationTree,
+        summary,
+    };
+}

package/dist/extensions/cavi/domain/discourse.d.ts

@@ -0,0 +1,161 @@
+export type DiscourseEventType = "discourse.dispatch" | "discourse.delegation" | "discourse.decision" | "discourse.blocker" | "discourse.resolution" | "discourse.status" | "discourse.escalation" | "discourse.completion" | "discourse.spawn.dedup" | "discourse.spawn.guard" | "discourse.spawn.budget";
+type DiscourseEventBase = {
+    id: string;
+    ts: number;
+    taskId: string;
+    parentTaskId: string | null;
+    agentId: string;
+    sessionKey: string;
+    runId: string;
+};
+export type DiscourseDispatchData = {
+    targetAgentId: string;
+    objective: string;
+    tier: string;
+    packetType: string;
+    approachRationale?: string;
+    alternativesConsidered?: string[];
+};
+export type DiscourseDelegationData = {
+    targetAgentId: string;
+    objective: string;
+    teamId?: string;
+    rationale?: string;
+};
+export type DiscourseDecisionData = {
+    question: string;
+    chosenApproach: string;
+    rationale: string;
+    alternatives: Array<{
+        approach: string;
+        reasonRejected: string;
+    }>;
+};
+export type DiscourseBlockerData = {
+    blockerCode: string;
+    description: string;
+    severity: "low" | "medium" | "high" | "critical";
+    retryable: boolean;
+};
+export type DiscourseResolutionData = {
+    originalBlockerEventId: string;
+    resolution: string;
+    method: "retry" | "workaround" | "escalate" | "skip";
+};
+export type DiscourseStatusData = {
+    prevState: string;
+    nextState: string;
+    note?: string;
+};
+export type DiscourseEscalationData = {
+    reason: string;
+    target: string;
+    severity?: "low" | "medium" | "high" | "critical";
+};
+export type DiscourseCompletionData = {
+    outcome: "ok" | "error" | "timeout" | "partial";
+    resultSummary: string;
+    tokensUsed: number;
+    costUsd: number;
+    durationMs: number;
+};
+export type DiscourseSpawnDedupData = {
+    targetAgentId: string;
+    existingChildSessionKey: string;
+    ttlMs: number;
+};
+export type DiscourseSpawnGuardData = {
+    targetAgentId: string;
+    failureCode: string;
+    strikeCount: number;
+    ttlMs: number;
+};
+export type DiscourseSpawnBudgetData = {
+    recentFailureCount: number;
+    blockStrikeCount: number;
+    retryAfterMs: number;
+};
+export type DiscourseDispatchEvent = DiscourseEventBase & {
+    type: "discourse.dispatch";
+    data: DiscourseDispatchData;
+};
+export type DiscourseDelegationEvent = DiscourseEventBase & {
+    type: "discourse.delegation";
+    data: DiscourseDelegationData;
+};
+export type DiscourseDecisionEvent = DiscourseEventBase & {
+    type: "discourse.decision";
+    data: DiscourseDecisionData;
+};
+export type DiscourseBlockerEvent = DiscourseEventBase & {
+    type: "discourse.blocker";
+    data: DiscourseBlockerData;
+};
+export type DiscourseResolutionEvent = DiscourseEventBase & {
+    type: "discourse.resolution";
+    data: DiscourseResolutionData;
+};
+export type DiscourseStatusEvent = DiscourseEventBase & {
+    type: "discourse.status";
+    data: DiscourseStatusData;
+};
+export type DiscourseEscalationEvent = DiscourseEventBase & {
+    type: "discourse.escalation";
+    data: DiscourseEscalationData;
+};
+export type DiscourseCompletionEvent = DiscourseEventBase & {
+    type: "discourse.completion";
+    data: DiscourseCompletionData;
+};
+export type DiscourseSpawnDedupEvent = DiscourseEventBase & {
+    type: "discourse.spawn.dedup";
+    data: DiscourseSpawnDedupData;
+};
+export type DiscourseSpawnGuardEvent = DiscourseEventBase & {
+    type: "discourse.spawn.guard";
+    data: DiscourseSpawnGuardData;
+};
+export type DiscourseSpawnBudgetEvent = DiscourseEventBase & {
+    type: "discourse.spawn.budget";
+    data: DiscourseSpawnBudgetData;
+};
+export type DiscourseEvent = DiscourseDispatchEvent | DiscourseDelegationEvent | DiscourseDecisionEvent | DiscourseBlockerEvent | DiscourseResolutionEvent | DiscourseStatusEvent | DiscourseEscalationEvent | DiscourseCompletionEvent | DiscourseSpawnDedupEvent | DiscourseSpawnGuardEvent | DiscourseSpawnBudgetEvent;
+export type TaskDiscourseAgent = {
+    agentId: string;
+    role: string;
+    eventCount: number;
+    tokensUsed: number;
+    costUsd: number;
+};
+export type DelegationNode = {
+    taskId: string;
+    agentId: string;
+    objective: string;
+    status: string;
+    children: DelegationNode[];
+    events: DiscourseEvent[];
+    cost: {
+        tokens: number;
+        costUsd: number;
+        durationMs: number | null;
+    };
+};
+export type TaskDiscourseSummary = {
+    totalAgents: number;
+    totalEvents: number;
+    totalTokens: number;
+    totalCostUsd: number;
+    durationMs: number | null;
+    blockerCount: number;
+    decisionCount: number;
+    outcome: "success" | "partial" | "fail" | "blocked" | "pending";
+};
+export type TaskDiscourseSnapshot = {
+    rootTaskId: string;
+    agents: TaskDiscourseAgent[];
+    events: DiscourseEvent[];
+    delegationTree: DelegationNode[];
+    summary: TaskDiscourseSummary;
+};
+export {};
+//# sourceMappingURL=discourse.d.ts.map

package/dist/extensions/cavi/domain/discourse.d.ts.map

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

package/dist/extensions/cavi/domain/discourse.js

@@ -0,0 +1 @@
+export {};

package/dist/extensions/cavi/domain/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./operator.js";
+export * from "./discourse.js";
+export * from "./library.js";
+export * from "./observability.js";
+export * from "./project-board.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/cavi/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/extensions/cavi/domain/index.js

@@ -0,0 +1,5 @@
+export * from "./operator.js";
+export * from "./discourse.js";
+export * from "./library.js";
+export * from "./observability.js";
+export * from "./project-board.js";

package/dist/extensions/cavi/domain/library.d.ts

@@ -0,0 +1,80 @@
+/** Fleet Library Schema v1 — team library status and candidate data for Cavi Control. */
+export type LibraryNoteType = "concept" | "source" | "meeting" | "decision" | "transcript" | "synthesis" | "person" | "org" | "project";
+export type LibraryStatus = "draft" | "active" | "archived";
+export type LibraryVerification = "unreviewed" | "reviewed" | "disputed";
+export type LibrarySensitivity = "public" | "internal" | "confidential";
+export type LibrarySourceEntry = {
+    uri: string;
+    title?: string;
+    kind: "web" | "file" | "repo" | "meeting" | "chat" | "manual";
+    format: "html" | "pdf" | "md" | "txt" | "audio" | "video" | "email" | "json";
+    capture_method: "clip" | "upload" | "transcription" | "manual" | "agent";
+    captured_at: string;
+    author?: string;
+    site?: string;
+    published_at?: string;
+};
+export type LibraryNote = {
+    schema_version: number;
+    id: string;
+    note_type: LibraryNoteType;
+    title: string;
+    aliases: string[];
+    tags: string[];
+    domains: string[];
+    summary: string;
+    status: LibraryStatus;
+    verification: LibraryVerification;
+    language: string;
+    sensitivity: LibrarySensitivity;
+    compiled_at: string;
+    compiled_by: string;
+    content_hash: string;
+    reviewed_at: string | null;
+    reviewed_by: string | null;
+    sources: LibrarySourceEntry[];
+};
+export type TeamLibraryStatus = {
+    teamId: string;
+    teamName: string;
+    lead: string;
+    inboxCount: number;
+    candidatesCount: number;
+    promotedCount: number;
+    rejectedCount: number;
+    recentPromotions: Array<{
+        id: string;
+        title: string;
+        note_type: LibraryNoteType;
+        promoted_at: string;
+        promoted_by: string;
+        /** When set, mobile/web can open this path in the gateway wiki vault reader. */
+        wiki_path?: string;
+    }>;
+    qmdHealth: {
+        lastIndexedAt: number | null;
+        collectionSize: number;
+        healthy: boolean;
+    };
+};
+export type FleetLibrarySnapshot = {
+    generatedAt: number;
+    teams: TeamLibraryStatus[];
+    sigmund: {
+        status: "online" | "offline" | "unknown";
+        lastIngestAt: number | null;
+        totalProcessed: number;
+    };
+};
+export type AgentMemoryFile = {
+    filename: string;
+    content: string;
+    lastModified: number;
+};
+export type AgentMemorySnapshot = {
+    agentId: string;
+    activeFiles: AgentMemoryFile[];
+    journalCount: number;
+    lastJournalDate: string | null;
+};
+//# sourceMappingURL=library.d.ts.map

package/dist/extensions/cavi/domain/library.d.ts.map

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

package/dist/extensions/cavi/domain/library.js

@@ -0,0 +1,2 @@
+/** Fleet Library Schema v1 — team library status and candidate data for Cavi Control. */
+export {};

package/dist/extensions/cavi/domain/observability.d.ts

@@ -0,0 +1,34 @@
+import type { OperatorTaskState } from "./operator.js";
+import type { AgentRun, AgentRunStatus } from "../../../core/gateway/run/contracts.js";
+export type RunTaskLinkCandidate = {
+    runKey: string;
+    taskId: string | null;
+};
+export type EnrichedAgentRun = AgentRun & {
+    taskId: string | null;
+    taskState: OperatorTaskState | null;
+    taskObjective: string | null;
+    taskOwner: string | null;
+    teamId: string | null;
+    verification: string | null;
+    discourseTaskId: string | null;
+};
+export type TaskObservabilitySummary = {
+    taskId: string;
+    taskState: OperatorTaskState | null;
+    taskObjective: string | null;
+    taskOwner: string | null;
+    teamId: string | null;
+    verification: string | null;
+    primaryRunKey: string | null;
+    runStatus: AgentRunStatus | null;
+    runUpdatedAt: number | null;
+    totalTokens: number | null;
+    totalCostUsd: number | null;
+    errorCount: number;
+    model: string | null;
+    provider: string | null;
+    degraded: boolean;
+    discourseTaskId: string;
+};
+//# sourceMappingURL=observability.d.ts.map

package/dist/extensions/cavi/domain/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/domain/observability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAEvF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG;IACxC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC"}

package/dist/extensions/cavi/domain/observability.js

@@ -0,0 +1 @@
+export {};