network-ai 5.10.1 → 5.11.0

package/dist/esm/lib/metrics.js

@@ -0,0 +1,284 @@
+"use strict";
+/**
+ * MetricsRegistry — Zero-dependency Prometheus-compatible metrics.
+ *
+ * Provides Counter, Gauge, and Histogram metric types with label support.
+ * Exports metrics in Prometheus text exposition format for scraping.
+ *
+ * No runtime dependencies — drop-in for any HTTP server or the MCP endpoint.
+ *
+ * @module Metrics
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsRegistry = exports.Histogram = exports.Gauge = exports.Counter = void 0;
+exports.createOrchestratorMetrics = createOrchestratorMetrics;
+/** Default latency buckets (ms) */
+const DEFAULT_BUCKETS = [5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000, 10000];
+// ============================================================================
+// METRIC PRIMITIVES
+// ============================================================================
+/** Serialise labels into the Prometheus `{k="v",k2="v2"}` format */
+function labelsToString(labels) {
+    const entries = Object.entries(labels);
+    if (entries.length === 0)
+        return '';
+    return '{' + entries.map(([k, v]) => `${k}="${escapeLabel(v)}"`).join(',') + '}';
+}
+function escapeLabel(v) {
+    return v.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+}
+function labelKey(labels) {
+    return Object.entries(labels).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${k}=${v}`).join(',');
+}
+// ============================================================================
+// METRIC CLASSES
+// ============================================================================
+/** Monotonically increasing counter */
+class Counter {
+    name;
+    help;
+    series = new Map();
+    labelMap = new Map();
+    constructor(name, help) {
+        this.name = name;
+        this.help = help;
+    }
+    inc(labels = {}, amount = 1) {
+        if (amount < 0)
+            throw new Error('Counter can only be incremented');
+        const key = labelKey(labels);
+        const s = this.series.get(key);
+        if (s) {
+            s.value += amount;
+        }
+        else {
+            this.series.set(key, { value: amount });
+            this.labelMap.set(key, labels);
+        }
+    }
+    get(labels = {}) {
+        return this.series.get(labelKey(labels))?.value ?? 0;
+    }
+    /** Prometheus text lines */
+    expose() {
+        const lines = [`# HELP ${this.name} ${this.help}`, `# TYPE ${this.name} counter`];
+        for (const [key, s] of this.series) {
+            lines.push(`${this.name}${labelsToString(this.labelMap.get(key))} ${s.value}`);
+        }
+        return lines.join('\n');
+    }
+}
+exports.Counter = Counter;
+/** Gauge — can go up or down */
+class Gauge {
+    name;
+    help;
+    series = new Map();
+    labelMap = new Map();
+    constructor(name, help) {
+        this.name = name;
+        this.help = help;
+    }
+    set(labelsOrValue, value) {
+        if (typeof labelsOrValue === 'number') {
+            const key = labelKey({});
+            const s = this.series.get(key);
+            if (s) {
+                s.value = labelsOrValue;
+            }
+            else {
+                this.series.set(key, { value: labelsOrValue });
+                this.labelMap.set(key, {});
+            }
+        }
+        else {
+            const key = labelKey(labelsOrValue);
+            const s = this.series.get(key);
+            if (s) {
+                s.value = value;
+            }
+            else {
+                this.series.set(key, { value: value });
+                this.labelMap.set(key, labelsOrValue);
+            }
+        }
+    }
+    inc(labels = {}, amount = 1) {
+        const key = labelKey(labels);
+        const s = this.series.get(key);
+        if (s) {
+            s.value += amount;
+        }
+        else {
+            this.series.set(key, { value: amount });
+            this.labelMap.set(key, labels);
+        }
+    }
+    dec(labels = {}, amount = 1) {
+        this.inc(labels, -amount);
+    }
+    get(labels = {}) {
+        return this.series.get(labelKey(labels))?.value ?? 0;
+    }
+    expose() {
+        const lines = [`# HELP ${this.name} ${this.help}`, `# TYPE ${this.name} gauge`];
+        for (const [key, s] of this.series) {
+            lines.push(`${this.name}${labelsToString(this.labelMap.get(key))} ${s.value}`);
+        }
+        return lines.join('\n');
+    }
+}
+exports.Gauge = Gauge;
+/** Histogram with configurable buckets */
+class Histogram {
+    name;
+    help;
+    boundaries;
+    series = new Map();
+    labelMap = new Map();
+    constructor(name, help, buckets) {
+        this.name = name;
+        this.help = help;
+        this.boundaries = buckets?.boundaries ?? DEFAULT_BUCKETS;
+    }
+    observe(labelsOrValue, value) {
+        const labels = typeof labelsOrValue === 'number' ? {} : labelsOrValue;
+        const v = typeof labelsOrValue === 'number' ? labelsOrValue : value;
+        const key = labelKey(labels);
+        let s = this.series.get(key);
+        if (!s) {
+            s = { bucketCounts: new Array(this.boundaries.length + 1).fill(0), sum: 0, count: 0 };
+            this.series.set(key, s);
+            this.labelMap.set(key, labels);
+        }
+        s.sum += v;
+        s.count++;
+        for (let i = 0; i < this.boundaries.length; i++) {
+            if (v <= this.boundaries[i]) {
+                s.bucketCounts[i]++;
+            }
+        }
+        s.bucketCounts[this.boundaries.length]++; // +Inf bucket
+    }
+    expose() {
+        const lines = [`# HELP ${this.name} ${this.help}`, `# TYPE ${this.name} histogram`];
+        for (const [key, s] of this.series) {
+            const lbl = this.labelMap.get(key);
+            const base = labelsToString(lbl);
+            const comma = Object.keys(lbl).length > 0 ? ',' : '';
+            for (let i = 0; i < this.boundaries.length; i++) {
+                const le = this.boundaries[i];
+                lines.push(`${this.name}_bucket{${comma ? base.slice(1, -1) + ',' : ''}le="${le}"} ${s.bucketCounts[i]}`);
+            }
+            lines.push(`${this.name}_bucket{${comma ? base.slice(1, -1) + ',' : ''}le="+Inf"} ${s.bucketCounts[this.boundaries.length]}`);
+            lines.push(`${this.name}_sum${base} ${s.sum}`);
+            lines.push(`${this.name}_count${base} ${s.count}`);
+        }
+        return lines.join('\n');
+    }
+}
+exports.Histogram = Histogram;
+// ============================================================================
+// REGISTRY
+// ============================================================================
+/**
+ * Central metrics registry. Collects all metrics and exposes them in
+ * Prometheus text format.
+ *
+ * @example
+ * ```ts
+ * const registry = new MetricsRegistry();
+ * const delegations = registry.counter('nai_delegations_total', 'Total delegations');
+ * const activeAgents = registry.gauge('nai_active_agents', 'Currently active agents');
+ * const latency = registry.histogram('nai_delegation_duration_ms', 'Delegation latency');
+ *
+ * delegations.inc({ agent: 'planner' });
+ * activeAgents.set(5);
+ * latency.observe({ agent: 'planner' }, 142);
+ *
+ * const text = registry.expose(); // Prometheus text exposition format
+ * ```
+ */
+class MetricsRegistry {
+    counters = new Map();
+    gauges = new Map();
+    histograms = new Map();
+    /** Create or retrieve a counter */
+    counter(name, help) {
+        let c = this.counters.get(name);
+        if (!c) {
+            c = new Counter(name, help);
+            this.counters.set(name, c);
+        }
+        return c;
+    }
+    /** Create or retrieve a gauge */
+    gauge(name, help) {
+        let g = this.gauges.get(name);
+        if (!g) {
+            g = new Gauge(name, help);
+            this.gauges.set(name, g);
+        }
+        return g;
+    }
+    /** Create or retrieve a histogram */
+    histogram(name, help, buckets) {
+        let h = this.histograms.get(name);
+        if (!h) {
+            h = new Histogram(name, help, buckets);
+            this.histograms.set(name, h);
+        }
+        return h;
+    }
+    /**
+     * Export all registered metrics in Prometheus text exposition format.
+     */
+    expose() {
+        const parts = [];
+        for (const c of this.counters.values())
+            parts.push(c.expose());
+        for (const g of this.gauges.values())
+            parts.push(g.expose());
+        for (const h of this.histograms.values())
+            parts.push(h.expose());
+        return parts.join('\n\n') + '\n';
+    }
+    /** Get a specific counter by name */
+    getCounter(name) { return this.counters.get(name); }
+    /** Get a specific gauge by name */
+    getGauge(name) { return this.gauges.get(name); }
+    /** Get a specific histogram by name */
+    getHistogram(name) { return this.histograms.get(name); }
+    /** Total number of registered metrics */
+    get size() {
+        return this.counters.size + this.gauges.size + this.histograms.size;
+    }
+}
+exports.MetricsRegistry = MetricsRegistry;
+// ============================================================================
+// PRE-BUILT ORCHESTRATOR METRICS
+// ============================================================================
+/**
+ * Create a pre-configured MetricsRegistry with standard orchestrator metrics.
+ *
+ * Returns the registry and named handles to the individual metrics.
+ */
+function createOrchestratorMetrics() {
+    const registry = new MetricsRegistry();
+    return {
+        registry,
+        delegationsTotal: registry.counter('nai_delegations_total', 'Total task delegations'),
+        delegationErrors: registry.counter('nai_delegation_errors_total', 'Delegation failures'),
+        permissionChecks: registry.counter('nai_permission_checks_total', 'Permission check requests'),
+        permissionDenials: registry.counter('nai_permission_denials_total', 'Permission denials'),
+        injectionBlocks: registry.counter('nai_injection_blocks_total', 'Prompt injection blocks'),
+        qualityRejections: registry.counter('nai_quality_rejections_total', 'Quality gate rejections'),
+        blackboardWrites: registry.counter('nai_blackboard_writes_total', 'Blackboard write operations'),
+        activeAgents: registry.gauge('nai_active_agents', 'Currently active agents'),
+        blackboardSize: registry.gauge('nai_blackboard_size', 'Blackboard entry count'),
+        budgetUsedPercent: registry.gauge('nai_budget_used_percent', 'Budget utilization percentage'),
+        delegationDurationMs: registry.histogram('nai_delegation_duration_ms', 'Delegation latency in milliseconds'),
+        adapterDurationMs: registry.histogram('nai_adapter_duration_ms', 'Adapter execution latency in milliseconds'),
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/esm/lib/metrics.js.map

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

package/dist/esm/lib/orchestrator-types.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Shared type definitions, configuration, and default profiles for the
+ * SwarmOrchestrator engine.
+ *
+ * Extracted from index.ts to break the god-file pattern. All types are
+ * re-exported from the main index.ts barrel.
+ *
+ * @module OrchestratorTypes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_AGENT_TRUST = exports.DEFAULT_RESOURCE_PROFILES = exports.CONFIG = void 0;
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+exports.CONFIG = {
+    blackboardPath: './swarm-blackboard.md',
+    maxParallelAgents: Infinity,
+    defaultTimeout: 30000,
+    enableTracing: true,
+    grantTokenTTL: 300000, // 5 minutes in milliseconds
+    maxBlackboardValueSize: 1024 * 1024, // 1 MB max per entry
+    auditLogPath: './data/audit_log.jsonl',
+    trustConfigPath: './data/trust_levels.json',
+};
+// ============================================================================
+// DEFAULT RESOURCE PROFILES -- Universal, domain-agnostic
+// Users can override/extend these for any domain (coding, finance, devops, etc.)
+// ============================================================================
+exports.DEFAULT_RESOURCE_PROFILES = {
+    // --- Financial / Enterprise ---
+    SAP_API: { baseRisk: 0.5, defaultRestrictions: ['read_only', 'max_records:100'], description: 'SAP enterprise API' },
+    FINANCIAL_API: { baseRisk: 0.7, defaultRestrictions: ['read_only', 'no_pii_fields', 'audit_required'], description: 'Financial data API' },
+    DATA_EXPORT: { baseRisk: 0.6, defaultRestrictions: ['anonymize_pii', 'local_only'], description: 'Data export operations' },
+    // --- Coding / Development ---
+    FILE_SYSTEM: { baseRisk: 0.5, defaultRestrictions: ['workspace_only', 'no_system_dirs', 'max_file_size:10mb'], description: 'Read/write files in workspace' },
+    SHELL_EXEC: { baseRisk: 0.8, defaultRestrictions: ['sandbox_only', 'no_sudo', 'timeout:30s', 'audit_required'], description: 'Execute shell commands' },
+    GIT: { baseRisk: 0.4, defaultRestrictions: ['local_repo_only', 'no_force_push'], description: 'Git operations' },
+    PACKAGE_MANAGER: { baseRisk: 0.6, defaultRestrictions: ['audit_required', 'no_global_install', 'lockfile_required'], description: 'npm/pip/cargo package management' },
+    BUILD_TOOL: { baseRisk: 0.5, defaultRestrictions: ['workspace_only', 'timeout:120s'], description: 'Build and compilation' },
+    // --- Infrastructure / DevOps ---
+    DOCKER: { baseRisk: 0.7, defaultRestrictions: ['no_privileged', 'no_host_network', 'audit_required'], description: 'Container operations' },
+    CLOUD_DEPLOY: { baseRisk: 0.9, defaultRestrictions: ['staging_only', 'approval_required', 'rollback_ready'], description: 'Cloud deployment' },
+    DATABASE: { baseRisk: 0.6, defaultRestrictions: ['read_only', 'max_records:1000', 'no_schema_changes'], description: 'Database access' },
+    // --- Communication / External ---
+    EXTERNAL_SERVICE: { baseRisk: 0.4, defaultRestrictions: ['rate_limit:10_per_minute'], description: 'External API calls' },
+    EMAIL: { baseRisk: 0.5, defaultRestrictions: ['rate_limit:5_per_minute', 'no_attachments'], description: 'Email sending' },
+    WEBHOOK: { baseRisk: 0.4, defaultRestrictions: ['allowed_domains_only', 'no_credentials'], description: 'Webhook dispatch' },
+    // --- Basis tier (infrastructure administration) ---
+    ENVIRONMENT_PROMOTE: { baseRisk: 0.95, defaultRestrictions: ['basis_tier_only', 'audit_required', 'approval_required'], description: 'Promote configuration artefacts between deployment environments — Basis-tier agents only' },
+};
+exports.DEFAULT_AGENT_TRUST = [
+    { agentId: 'orchestrator', trustLevel: 0.9, allowedNamespaces: ['*'], allowedResources: ['*'] },
+    // Basis tier — only these agents may request ENVIRONMENT_PROMOTE
+    { agentId: 'basis:transport', trustLevel: 0.95, allowedNamespaces: ['transport:', 'landscape:'], allowedResources: ['ENVIRONMENT_PROMOTE'] },
+    { agentId: 'basis:landscape', trustLevel: 0.9, allowedNamespaces: ['landscape:', 'transport:'], allowedResources: ['ENVIRONMENT_PROMOTE'] },
+    { agentId: 'data_analyst', trustLevel: 0.8, allowedNamespaces: ['task:', 'analytics:', 'agent:'], allowedResources: ['SAP_API', 'DATABASE', 'DATA_EXPORT', 'EXTERNAL_SERVICE'] },
+    { agentId: 'strategy_advisor', trustLevel: 0.7, allowedNamespaces: ['task:', 'strategy:'], allowedResources: ['EXTERNAL_SERVICE', 'DATA_EXPORT'] },
+    { agentId: 'risk_assessor', trustLevel: 0.85, allowedNamespaces: ['task:', 'risk:', 'analytics:'], allowedResources: ['EXTERNAL_SERVICE', 'DATABASE'] },
+    // Coding agents
+    { agentId: 'code_writer', trustLevel: 0.75, allowedNamespaces: ['task:', 'code:', 'build:'], allowedResources: ['FILE_SYSTEM', 'GIT', 'BUILD_TOOL', 'PACKAGE_MANAGER'] },
+    { agentId: 'code_reviewer', trustLevel: 0.8, allowedNamespaces: ['task:', 'code:', 'review:'], allowedResources: ['FILE_SYSTEM', 'GIT'] },
+    { agentId: 'test_runner', trustLevel: 0.75, allowedNamespaces: ['task:', 'test:', 'build:'], allowedResources: ['FILE_SYSTEM', 'SHELL_EXEC', 'BUILD_TOOL'] },
+    { agentId: 'devops_agent', trustLevel: 0.7, allowedNamespaces: ['task:', 'deploy:', 'infra:'], allowedResources: ['DOCKER', 'SHELL_EXEC', 'CLOUD_DEPLOY', 'GIT'] },
+];
+//# sourceMappingURL=orchestrator-types.js.map

package/dist/esm/lib/orchestrator-types.js.map

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

package/dist/esm/lib/otel-bridge.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * OTelBridge — Zero-dependency OpenTelemetry bridge (BYOC pattern).
+ *
+ * Users inject their own OTel `Tracer` instance; the bridge wraps agent
+ * executions, blackboard operations, and permission checks in proper OTel
+ * spans with semantic attributes.  If no tracer is provided, all calls are
+ * no-ops (zero overhead).
+ *
+ * @module OTelBridge
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OTelBridge = exports.SpanStatus = void 0;
+// ============================================================================
+// BYOC Tracer Interface (subset of @opentelemetry/api)
+// ============================================================================
+/** Minimal subset of OTel SpanStatusCode */
+var SpanStatus;
+(function (SpanStatus) {
+    SpanStatus[SpanStatus["UNSET"] = 0] = "UNSET";
+    SpanStatus[SpanStatus["OK"] = 1] = "OK";
+    SpanStatus[SpanStatus["ERROR"] = 2] = "ERROR";
+})(SpanStatus || (exports.SpanStatus = SpanStatus = {}));
+// ============================================================================
+// NO-OP IMPLEMENTATION
+// ============================================================================
+class NoOpSpan {
+    setAttribute() { return this; }
+    setStatus() { return this; }
+    recordException() { return this; }
+    end() { }
+}
+const NOOP_SPAN = new NoOpSpan();
+class NoOpTracer {
+    startSpan() { return NOOP_SPAN; }
+}
+const NOOP_TRACER = new NoOpTracer();
+// ============================================================================
+// BRIDGE
+// ============================================================================
+/**
+ * Wraps orchestrator operations in OTel spans.
+ *
+ * @example
+ * ```ts
+ * import { trace } from '@opentelemetry/api';
+ * const bridge = new OTelBridge(trace.getTracer('network-ai'));
+ *
+ * // Or zero-config (no-op):
+ * const bridge = new OTelBridge();
+ * ```
+ */
+class OTelBridge {
+    tracer;
+    constructor(tracer) {
+        this.tracer = tracer ?? NOOP_TRACER;
+    }
+    /** Replace the tracer at runtime (e.g. after late initialization). */
+    setTracer(tracer) {
+        this.tracer = tracer;
+    }
+    /** Whether a real tracer (not no-op) is configured. */
+    get isEnabled() {
+        return this.tracer !== NOOP_TRACER;
+    }
+    /**
+     * Wrap an async function in a span. Automatically sets status and records
+     * exceptions on failure.
+     */
+    async trace(spanName, attributes, fn) {
+        const span = this.tracer.startSpan(spanName, { attributes });
+        try {
+            const result = await fn(span);
+            span.setStatus({ code: SpanStatus.OK });
+            return result;
+        }
+        catch (error) {
+            span.setStatus({
+                code: SpanStatus.ERROR,
+                message: error instanceof Error ? error.message : String(error),
+            });
+            if (error instanceof Error) {
+                span.recordException(error);
+            }
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    }
+    /**
+     * Wrap a synchronous function in a span.
+     */
+    traceSync(spanName, attributes, fn) {
+        const span = this.tracer.startSpan(spanName, { attributes });
+        try {
+            const result = fn(span);
+            span.setStatus({ code: SpanStatus.OK });
+            return result;
+        }
+        catch (error) {
+            span.setStatus({
+                code: SpanStatus.ERROR,
+                message: error instanceof Error ? error.message : String(error),
+            });
+            if (error instanceof Error) {
+                span.recordException(error);
+            }
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Pre-built span helpers for common orchestrator operations
+    // -----------------------------------------------------------------------
+    /** Start a span for an agent delegation. Returns the span for manual end(). */
+    startDelegation(sourceAgent, targetAgent, taskId) {
+        return this.tracer.startSpan('agent.delegation', {
+            attributes: {
+                'agent.source': sourceAgent,
+                'agent.target': targetAgent,
+                'task.id': taskId,
+            },
+        });
+    }
+    /** Start a span for adapter execution. */
+    startAdapterExecution(adapterId, agentId) {
+        return this.tracer.startSpan('adapter.execute', {
+            attributes: {
+                'adapter.id': adapterId,
+                'agent.id': agentId,
+            },
+        });
+    }
+    /** Start a span for a blackboard operation. */
+    startBlackboardOp(operation, key, agentId) {
+        return this.tracer.startSpan(`blackboard.${operation}`, {
+            attributes: {
+                'blackboard.operation': operation,
+                'blackboard.key': key,
+                'agent.id': agentId,
+            },
+        });
+    }
+    /** Start a span for a permission check. */
+    startPermissionCheck(agentId, resourceType) {
+        return this.tracer.startSpan('auth.permission_check', {
+            attributes: {
+                'agent.id': agentId,
+                'auth.resource_type': resourceType,
+            },
+        });
+    }
+    /** Start a span for quality gate validation. */
+    startQualityGate(agentId, key) {
+        return this.tracer.startSpan('quality.gate', {
+            attributes: {
+                'agent.id': agentId,
+                'quality.key': key,
+            },
+        });
+    }
+}
+exports.OTelBridge = OTelBridge;
+//# sourceMappingURL=otel-bridge.js.map

package/dist/esm/lib/otel-bridge.js.map

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