@guyghost/swarm-dao-core 0.1.0

package/dist/intelligence/swarm.d.ts

@@ -0,0 +1,27 @@
+import type { AgentOutput, DAOAgent, HostAdapter, Proposal } from "../types/index.js";
+export interface SwarmProgressUpdate {
+    agentId: string;
+    agentName: string;
+    phase: "pending" | "started" | "completed" | "error";
+    output?: AgentOutput;
+    isRetry?: boolean;
+}
+export interface DispatchInstruction {
+    agentId: string;
+    agentName: string;
+    prompt: string;
+    model?: string;
+    timeoutMs: number;
+}
+/**
+ * Build dispatch instructions for each agent.
+ * Host adapters use these to spawn sub-agents.
+ */
+export declare function buildDispatchInstructions(proposal: Proposal, agents: DAOAgent[]): DispatchInstruction[];
+export declare function formatDispatchPlan(proposal: Proposal, instructions: DispatchInstruction[]): string;
+/**
+ * Dispatch swarm via a host adapter.
+ * This is the host-agnostic version — adapters implement the actual spawning.
+ */
+export declare function dispatchSwarm(proposal: Proposal, agents: DAOAgent[], adapter: HostAdapter, maxConcurrent: number, onUpdate?: (update: SwarmProgressUpdate) => void): Promise<AgentOutput[]>;
+//# sourceMappingURL=swarm.d.ts.map

package/dist/intelligence/swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/intelligence/swarm.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEtF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IACrD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CA0BvG;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAuBlG;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,QAAQ,EAAE,EAClB,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAC/C,OAAO,CAAC,WAAW,EAAE,CAAC,CA+DxB"}

package/dist/intelligence/swarm.js

@@ -0,0 +1,113 @@
+// ============================================================
+// Swarm DAO Core — Swarm Dispatch
+// ============================================================
+/**
+ * Build dispatch instructions for each agent.
+ * Host adapters use these to spawn sub-agents.
+ */
+export function buildDispatchInstructions(proposal, agents) {
+    const basePrompt = `You are participating in DAO governance deliberation for the following proposal.
+
+## Proposal #${proposal.id}: ${proposal.title}
+**Type:** ${proposal.type}
+**Description:**
+${proposal.description}
+
+${proposal.problemStatement ? `**Problem Statement:**\n${proposal.problemStatement}\n\n` : ""}
+${proposal.context ? `**Context:**\n${proposal.context}\n\n` : ""}
+${Array.isArray(proposal.acceptanceCriteria) && proposal.acceptanceCriteria.length > 0
+        ? `**Acceptance Criteria:**\n${proposal.acceptanceCriteria.map((ac, _i) => `- ${typeof ac === "string" ? ac : ac.id}: ${typeof ac === "string" ? ac : `${ac.given} / ${ac.when} / ${ac.then}`}`).join("\n")}\n\n`
+        : ""}
+${proposal.successMetrics?.length ? `**Success Metrics:**\n${proposal.successMetrics.map((m) => `- ${m}`).join("\n")}\n\n` : ""}
+
+Evaluate this proposal carefully. Provide your analysis, vote, and scoring.`;
+    return agents.map((agent) => ({
+        agentId: agent.id,
+        agentName: agent.name,
+        prompt: `${agent.systemPrompt}\n\n${basePrompt}`,
+        model: agent.model,
+        timeoutMs: 120_000,
+    }));
+}
+export function formatDispatchPlan(proposal, instructions) {
+    return `# 🐝 Swarm Dispatch Plan — Proposal #${proposal.id}
+
+**Title:** ${proposal.title}
+**Agents to spawn:** ${instructions.length}
+
+## Instructions
+${instructions
+        .map((inst) => `### @${inst.agentId} (${inst.agentName})
+- Model: ${inst.model ?? "default"}
+- Timeout: ${inst.timeoutMs}ms
+
+Spawn this sub-agent with the following task:
+\`\`\`
+${inst.prompt.slice(0, 500)}${inst.prompt.length > 500 ? "..." : ""}
+\`\`\`
+`)
+        .join("\n")}
+
+## Next Step
+After collecting all outputs, call \`dao_record_outputs\` with the collected responses.`;
+}
+/**
+ * Dispatch swarm via a host adapter.
+ * This is the host-agnostic version — adapters implement the actual spawning.
+ */
+export async function dispatchSwarm(proposal, agents, adapter, maxConcurrent, onUpdate) {
+    const instructions = buildDispatchInstructions(proposal, agents);
+    const outputs = [];
+    // Process in batches based on maxConcurrent
+    for (let i = 0; i < instructions.length; i += maxConcurrent) {
+        const batch = instructions.slice(i, i + maxConcurrent);
+        const batchPromises = batch.map(async (inst) => {
+            const agent = agents.find((a) => a.id === inst.agentId);
+            if (!agent)
+                throw new Error(`Agent ${inst.agentId} not found`);
+            onUpdate?.({
+                agentId: inst.agentId,
+                agentName: inst.agentName,
+                phase: "started",
+            });
+            try {
+                const output = await adapter.spawnAgent({
+                    agent,
+                    proposal,
+                    systemPrompt: inst.prompt,
+                    timeoutMs: inst.timeoutMs,
+                });
+                outputs.push(output);
+                onUpdate?.({
+                    agentId: inst.agentId,
+                    agentName: inst.agentName,
+                    phase: output.error ? "error" : "completed",
+                    output,
+                });
+                return output;
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : "Unknown error";
+                const errorOutput = {
+                    agentId: inst.agentId,
+                    agentName: inst.agentName,
+                    role: agent.role,
+                    content: "",
+                    durationMs: 0,
+                    error: message,
+                };
+                outputs.push(errorOutput);
+                onUpdate?.({
+                    agentId: inst.agentId,
+                    agentName: inst.agentName,
+                    phase: "error",
+                    output: errorOutput,
+                });
+                return errorOutput;
+            }
+        });
+        await Promise.all(batchPromises);
+    }
+    return outputs;
+}
+//# sourceMappingURL=swarm.js.map

package/dist/intelligence/swarm.js.map

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

package/dist/intelligence/synthesis.d.ts

@@ -0,0 +1,4 @@
+import type { AgentOutput, DAOAgent, Proposal, TallyResult } from "../types/index.js";
+export declare function synthesize(proposal: Proposal, _agents: DAOAgent[], outputs: AgentOutput[], tally?: TallyResult): string;
+export declare function formatSynthesis(synthesis: string): string;
+//# sourceMappingURL=synthesis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"synthesis.d.ts","sourceRoot":"","sources":["../../src/intelligence/synthesis.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEtF,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,QAAQ,EAAE,EACnB,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,CAAC,EAAE,WAAW,GAClB,MAAM,CAiER;AAyBD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/intelligence/synthesis.js

@@ -0,0 +1,84 @@
+// ============================================================
+// Swarm DAO Core — Deliberation Synthesis
+// ============================================================
+export function synthesize(proposal, _agents, outputs, tally) {
+    const approved = tally?.approved ?? false;
+    const forVotes = outputs.filter((o) => o.vote?.position === "for");
+    const againstVotes = outputs.filter((o) => o.vote?.position === "against");
+    const abstentions = outputs.filter((o) => o.vote?.position === "abstain" || !o.vote);
+    const errors = outputs.filter((o) => o.error);
+    let synthesis = `## Synthesis — Proposal #${proposal.id}\n\n`;
+    synthesis += `**Result:** ${approved ? "✅ APPROVED" : "❌ REJECTED"}\n`;
+    synthesis += `**Agents Participated:** ${outputs.length}\n`;
+    synthesis += `**For:** ${forVotes.length} | **Against:** ${againstVotes.length} | **Abstain:** ${abstentions.length}`;
+    if (errors.length > 0) {
+        synthesis += ` | **Errors:** ${errors.length}`;
+    }
+    synthesis += "\n\n";
+    if (forVotes.length > 0) {
+        synthesis += "### Supporting Arguments\n";
+        for (const vote of forVotes) {
+            synthesis += `- **${vote.agentName}:** ${vote.vote?.reasoning?.slice(0, 200) ?? "No reasoning"}${(vote.vote?.reasoning?.length ?? 0) > 200 ? "..." : ""}\n`;
+        }
+        synthesis += "\n";
+    }
+    if (againstVotes.length > 0) {
+        synthesis += "### Opposing Arguments\n";
+        for (const vote of againstVotes) {
+            synthesis += `- **${vote.agentName}:** ${vote.vote?.reasoning?.slice(0, 200) ?? "No reasoning"}${(vote.vote?.reasoning?.length ?? 0) > 200 ? "..." : ""}\n`;
+        }
+        synthesis += "\n";
+    }
+    if (errors.length > 0) {
+        synthesis += "### Agent Errors\n";
+        for (const err of errors) {
+            synthesis += `- **${err.agentName}:** ${err.error}\n`;
+        }
+        synthesis += "\n";
+    }
+    // Key themes
+    const allReasoning = outputs
+        .filter((o) => o.vote?.reasoning)
+        .map((o) => o.vote?.reasoning)
+        .join(" ");
+    const themes = extractThemes(allReasoning);
+    if (themes.length > 0) {
+        synthesis += "### Key Themes\n";
+        for (const theme of themes) {
+            synthesis += `- ${theme}\n`;
+        }
+        synthesis += "\n";
+    }
+    synthesis += "### Recommendation\n";
+    if (approved) {
+        synthesis += "The swarm recommends approving this proposal. Proceed to quality control gates.\n";
+    }
+    else {
+        synthesis += "The swarm recommends rejecting this proposal. Review the opposing arguments and consider revising.\n";
+    }
+    return synthesis;
+}
+function extractThemes(text) {
+    // Simple keyword-based theme extraction
+    const themes = [];
+    const themeKeywords = {
+        "Security concerns": ["security", "vulnerability", "exploit", "attack"],
+        "Performance impact": ["performance", "latency", "slow", "bottleneck"],
+        "User experience": ["ux", "user", "experience", "usability"],
+        "Technical debt": ["debt", "legacy", "refactor", "cleanup"],
+        Scalability: ["scale", "scaling", "concurrent", "load"],
+        "Maintenance burden": ["maintain", "support", "operational"],
+        Alignment: ["vision", "strategy", "roadmap", "goal"],
+    };
+    const lowerText = text.toLowerCase();
+    for (const [theme, keywords] of Object.entries(themeKeywords)) {
+        if (keywords.some((k) => lowerText.includes(k))) {
+            themes.push(theme);
+        }
+    }
+    return themes.slice(0, 5); // Max 5 themes
+}
+export function formatSynthesis(synthesis) {
+    return synthesis;
+}
+//# sourceMappingURL=synthesis.js.map

package/dist/intelligence/synthesis.js.map

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

package/dist/observability/alerts.d.ts

@@ -0,0 +1,40 @@
+export type AlertSeverity = "info" | "warning" | "critical";
+export type AlertCondition = "gt" | "lt" | "eq" | "gte" | "lte";
+export interface AlertRule {
+    id: string;
+    name: string;
+    description: string;
+    metric: string;
+    condition: AlertCondition;
+    threshold: number;
+    severity: AlertSeverity;
+    duration?: number;
+    enabled: boolean;
+}
+export interface Alert {
+    id: string;
+    ruleId: string;
+    name: string;
+    description: string;
+    severity: AlertSeverity;
+    metric: string;
+    value: number;
+    threshold: number;
+    condition: AlertCondition;
+    triggeredAt: string;
+    resolvedAt?: string;
+    status: "firing" | "resolved";
+}
+export declare function createAlertRule(rule: Omit<AlertRule, "id">): AlertRule;
+export declare function removeAlertRule(ruleId: string): boolean;
+export declare function getAlertRules(): AlertRule[];
+export declare function getActiveAlerts(): Alert[];
+export declare function getAllAlerts(): Alert[];
+export declare function resolveAlert(alertId: string): boolean;
+export declare function evaluateRules(): Alert[];
+export declare function formatAlert(alert: Alert): string;
+export declare function formatAlerts(): string;
+export declare const DEFAULT_ALERT_RULES: Omit<AlertRule, "id">[];
+export declare function resetAlerts(): void;
+export declare function initializeDefaultAlertRules(): void;
+//# sourceMappingURL=alerts.d.ts.map

package/dist/observability/alerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/observability/alerts.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;AAEhE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,cAAc,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAMD,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,SAAS,CAItE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKvD;AAED,wBAAgB,aAAa,IAAI,SAAS,EAAE,CAE3C;AAED,wBAAgB,eAAe,IAAI,KAAK,EAAE,CAEzC;AAED,wBAAgB,YAAY,IAAI,KAAK,EAAE,CAEtC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMrD;AAgCD,wBAAgB,aAAa,IAAI,KAAK,EAAE,CAiCvC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAShD;AAED,wBAAgB,YAAY,IAAI,MAAM,CASrC;AAID,eAAO,MAAM,mBAAmB,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAqCtD,CAAC;AAEF,wBAAgB,WAAW,IAAI,IAAI,CAIlC;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAIlD"}

package/dist/observability/alerts.js

@@ -0,0 +1,162 @@
+// ============================================================
+// Swarm DAO Core — Alerting System
+// ============================================================
+import { getCounter, getGauge, getHistogram } from "./metrics.js";
+const rules = [];
+const alerts = [];
+let alertIdCounter = 1;
+export function createAlertRule(rule) {
+    const newRule = { ...rule, id: `rule-${alertIdCounter++}` };
+    rules.push(newRule);
+    return newRule;
+}
+export function removeAlertRule(ruleId) {
+    const index = rules.findIndex((r) => r.id === ruleId);
+    if (index === -1)
+        return false;
+    rules.splice(index, 1);
+    return true;
+}
+export function getAlertRules() {
+    return [...rules];
+}
+export function getActiveAlerts() {
+    return alerts.filter((a) => a.status === "firing");
+}
+export function getAllAlerts() {
+    return [...alerts];
+}
+export function resolveAlert(alertId) {
+    const alert = alerts.find((a) => a.id === alertId);
+    if (!alert || alert.status === "resolved")
+        return false;
+    alert.status = "resolved";
+    alert.resolvedAt = new Date().toISOString();
+    return true;
+}
+function evaluateCondition(value, condition, threshold) {
+    switch (condition) {
+        case "gt":
+            return value > threshold;
+        case "lt":
+            return value < threshold;
+        case "eq":
+            return value === threshold;
+        case "gte":
+            return value >= threshold;
+        case "lte":
+            return value <= threshold;
+        default:
+            return false;
+    }
+}
+function getMetricValue(metricName) {
+    const counter = getCounter(metricName);
+    if (counter)
+        return counter.getCount();
+    const gauge = getGauge(metricName);
+    if (gauge)
+        return gauge.getValue();
+    const histogram = getHistogram(metricName);
+    if (histogram)
+        return histogram.getCount();
+    return 0;
+}
+export function evaluateRules() {
+    const newAlerts = [];
+    for (const rule of rules) {
+        if (!rule.enabled)
+            continue;
+        const value = getMetricValue(rule.metric);
+        const triggered = evaluateCondition(value, rule.condition, rule.threshold);
+        const existing = alerts.find((a) => a.ruleId === rule.id && a.status === "firing");
+        if (triggered && !existing) {
+            const alert = {
+                id: `alert-${alertIdCounter++}`,
+                ruleId: rule.id,
+                name: rule.name,
+                description: rule.description,
+                severity: rule.severity,
+                metric: rule.metric,
+                value,
+                threshold: rule.threshold,
+                condition: rule.condition,
+                triggeredAt: new Date().toISOString(),
+                status: "firing",
+            };
+            alerts.push(alert);
+            newAlerts.push(alert);
+        }
+        else if (!triggered && existing) {
+            resolveAlert(existing.id);
+        }
+    }
+    return newAlerts;
+}
+export function formatAlert(alert) {
+    const emoji = { info: "ℹ️", warning: "⚠️", critical: "🚨" }[alert.severity];
+    const status = alert.status === "firing" ? "🔥 FIRING" : "✅ RESOLVED";
+    return (`${emoji} **${alert.name}** — ${status}\n` +
+        `Metric: \`${alert.metric}\` = ${alert.value} (threshold: ${alert.condition} ${alert.threshold})\n` +
+        `Triggered: ${alert.triggeredAt}${alert.resolvedAt ? ` | Resolved: ${alert.resolvedAt}` : ""}`);
+}
+export function formatAlerts() {
+    const active = getActiveAlerts();
+    if (active.length === 0)
+        return "# 🟢 No Active Alerts\n\nAll systems nominal.";
+    let output = "# 🚨 Active Alerts\n\n";
+    for (const alert of active) {
+        output += `${formatAlert(alert)}\n\n`;
+    }
+    return output;
+}
+// ── Default Rules ────────────────────────────────────────────
+export const DEFAULT_ALERT_RULES = [
+    {
+        name: "Low Approval Rate",
+        description: "Approval rate has dropped below 40%",
+        metric: "dao_approval_rate_percent",
+        condition: "lt",
+        threshold: 40,
+        severity: "warning",
+        enabled: true,
+    },
+    {
+        name: "High Deliberation Time",
+        description: "P95 deliberation time exceeds 30 seconds",
+        metric: "dao_deliberation_duration_ms",
+        condition: "gt",
+        threshold: 30000,
+        severity: "warning",
+        enabled: true,
+    },
+    {
+        name: "No Active Agents",
+        description: "Number of active agents has dropped to 0",
+        metric: "dao_agent_count",
+        condition: "lte",
+        threshold: 0,
+        severity: "critical",
+        enabled: true,
+    },
+    {
+        name: "Too Many Open Proposals",
+        description: "More than 20 proposals are open simultaneously",
+        metric: "dao_active_proposals",
+        condition: "gt",
+        threshold: 20,
+        severity: "info",
+        enabled: true,
+    },
+];
+export function resetAlerts() {
+    rules.length = 0;
+    alerts.length = 0;
+    alertIdCounter = 1;
+}
+export function initializeDefaultAlertRules() {
+    for (const rule of DEFAULT_ALERT_RULES) {
+        createAlertRule(rule);
+    }
+}
+//# sourceMappingURL=alerts.js.map

package/dist/observability/alerts.js.map

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

package/dist/observability/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./alerts.js";
+export * from "./metrics.js";
+export * from "./tracing.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,5 @@
+// Observability Layer — Metrics, Tracing, Alerts
+export * from "./alerts.js";
+export * from "./metrics.js";
+export * from "./tracing.js";
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/observability/metrics.d.ts

@@ -0,0 +1,64 @@
+export interface MetricValue {
+    name: string;
+    value: number;
+    timestamp: string;
+    labels?: Record<string, string>;
+}
+export interface Counter {
+    name: string;
+    description: string;
+    values: MetricValue[];
+    increment(labels?: Record<string, string>): void;
+    getCount(labels?: Record<string, string>): number;
+}
+export interface Gauge {
+    name: string;
+    description: string;
+    values: MetricValue[];
+    set(value: number, labels?: Record<string, string>): void;
+    getValue(labels?: Record<string, string>): number;
+}
+export interface Histogram {
+    name: string;
+    description: string;
+    buckets: number[];
+    values: MetricValue[];
+    observe(value: number, labels?: Record<string, string>): void;
+    getPercentile(p: number, labels?: Record<string, string>): number;
+    getCount(labels?: Record<string, string>): number;
+    getBucketCounts(labels?: Record<string, string>): Record<string, number>;
+}
+export declare function createCounter(name: string, description: string): Counter;
+export declare function createGauge(name: string, description: string): Gauge;
+export declare function createHistogram(name: string, description: string, buckets?: number[]): Histogram;
+export declare function getCounter(name: string): Counter | undefined;
+export declare function getGauge(name: string): Gauge | undefined;
+export declare function getHistogram(name: string): Histogram | undefined;
+export declare function getAllMetrics(): {
+    counters: Counter[];
+    gauges: Gauge[];
+    histograms: Histogram[];
+};
+export declare function resetMetrics(): void;
+export declare const DAO_METRICS: {
+    proposalsCreated: Counter;
+    proposalsApproved: Counter;
+    proposalsRejected: Counter;
+    proposalsExecuted: Counter;
+    votesCast: Counter;
+    deliberationDuration: Histogram;
+    agentResponseTime: Histogram;
+    activeProposals: Gauge;
+    agentCount: Gauge;
+    approvalRate: Gauge;
+};
+export declare function recordProposalCreated(type: string): void;
+export declare function recordProposalApproved(_id: number, type: string): void;
+export declare function recordProposalRejected(_id: number, type: string): void;
+export declare function recordProposalExecuted(_id: number, type: string): void;
+export declare function recordVoteCast(agentId: string, position: string, weight: number): void;
+export declare function recordDeliberationDuration(durationMs: number, proposalId: number): void;
+export declare function recordAgentResponseTime(durationMs: number, agentId: string): void;
+export declare function formatMetrics(): string;
+export declare function formatMetricsPrometheus(): string;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAQD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;CACnD;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;CACnD;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9D,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IAClD,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1E;AA6FD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAIxE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,KAAK,CAIpE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAIhG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAExD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEhE;AAED,wBAAgB,aAAa,IAAI;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,UAAU,EAAE,SAAS,EAAE,CAAA;CAAE,CAMjG;AAED,wBAAgB,YAAY,IAAI,IAAI,CAUnC;AAID,eAAO,MAAM,WAAW;;;;;;;;;;;CAWvB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAOxD;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGtE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGtE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGtE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEtF;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAEvF;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjF;AASD,wBAAgB,aAAa,IAAI,MAAM,CAiBtC;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CA4BhD"}