@swarmdo/cli 1.4.8

package/vendor/shared/dist/types.d.ts.map

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

package/vendor/shared/dist/types.js

@@ -0,0 +1,21 @@
+/**
+ * V3 Swarmdo Shared Types
+ * Core type definitions for the 15-agent swarm coordination system
+ *
+ * Based on ADR-002 (DDD) and ADR-003 (Single Coordination Engine)
+ */
+export const V3_PERFORMANCE_TARGETS = {
+    flashAttention: { minSpeedup: 2.49, maxSpeedup: 7.47 },
+    agentDbSearch: { minSpeedup: 150, maxSpeedup: 12500 },
+    memoryReduction: { minPercent: 50, maxPercent: 75 },
+    codeReduction: { targetLines: 5000, currentLines: 15000 },
+    startupTime: { targetMs: 500 },
+    sonaLearning: { targetMs: 0.05 }
+};
+export function success(value) {
+    return { success: true, value };
+}
+export function failure(error) {
+    return { success: false, error };
+}
+//# sourceMappingURL=types.js.map

package/vendor/shared/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0UH,MAAM,CAAC,MAAM,sBAAsB,GAAuB;IACxD,cAAc,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IACtD,aAAa,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE;IACrD,eAAe,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IACnD,aAAa,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE;IACzD,WAAW,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE;IAC9B,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;CACjC,CAAC;AAkBF,MAAM,UAAU,OAAO,CAAI,KAAQ;IACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,OAAO,CAAY,KAAQ;IACzC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC"}

package/vendor/shared/dist/utils/secure-logger.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Secure Logger Utility
+ *
+ * Provides sanitized error logging that strips sensitive information
+ * before logging to prevent information disclosure.
+ *
+ * Security features:
+ * - Removes stack traces in production
+ * - Sanitizes file paths to prevent internal structure disclosure
+ * - Filters sensitive keys from error objects
+ * - Truncates long messages to prevent log injection
+ *
+ * @module @swarmdo/shared/utils/secure-logger
+ */
+interface LoggerConfig {
+    /** Environment mode */
+    environment: 'development' | 'production' | 'test';
+    /** Maximum message length */
+    maxMessageLength: number;
+    /** Whether to include stack traces */
+    includeStackTrace: boolean;
+    /** Sensitive keys to filter */
+    sensitiveKeys: string[];
+    /** Path patterns to sanitize */
+    pathPatterns: RegExp[];
+}
+export declare class SecureLogger {
+    private config;
+    private prefix;
+    constructor(prefix?: string, config?: Partial<LoggerConfig>);
+    /**
+     * Log an info message
+     */
+    info(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log an error (sanitized for security)
+     */
+    error(message: string, error?: unknown): void;
+    /**
+     * Log debug message (only in development)
+     */
+    debug(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Create a child logger with a sub-prefix
+     */
+    child(subPrefix: string): SecureLogger;
+}
+/**
+ * Create a secure logger instance
+ */
+export declare function createSecureLogger(prefix?: string, config?: Partial<LoggerConfig>): SecureLogger;
+/**
+ * Default logger instance
+ */
+export declare const logger: SecureLogger;
+/**
+ * Sanitize an error for safe logging/display
+ */
+export declare function sanitizeErrorForLogging(error: unknown): Record<string, unknown>;
+/**
+ * Sanitize a message for safe logging/display
+ */
+export declare function sanitizeMessageForLogging(message: string): string;
+export default SecureLogger;
+//# sourceMappingURL=secure-logger.d.ts.map

package/vendor/shared/dist/utils/secure-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-logger.d.ts","sourceRoot":"","sources":["../../src/utils/secure-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,UAAU,YAAY;IACpB,uBAAuB;IACvB,WAAW,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;IACnD,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gCAAgC;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAsHD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,MAAW,EAAE,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAKnE;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAW3D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAW3D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAW7C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAe5D;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;CAIvC;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAEhG;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,cAAgC,CAAC;AAEpD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE/E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,eAAe,YAAY,CAAC"}

package/vendor/shared/dist/utils/secure-logger.js

@@ -0,0 +1,208 @@
+/**
+ * Secure Logger Utility
+ *
+ * Provides sanitized error logging that strips sensitive information
+ * before logging to prevent information disclosure.
+ *
+ * Security features:
+ * - Removes stack traces in production
+ * - Sanitizes file paths to prevent internal structure disclosure
+ * - Filters sensitive keys from error objects
+ * - Truncates long messages to prevent log injection
+ *
+ * @module @swarmdo/shared/utils/secure-logger
+ */
+const DEFAULT_CONFIG = {
+    environment: process.env.NODE_ENV || 'development',
+    maxMessageLength: 1000,
+    includeStackTrace: process.env.NODE_ENV === 'development',
+    sensitiveKeys: [
+        'password', 'passwd', 'secret', 'token', 'apikey', 'api_key',
+        'authorization', 'auth', 'credential', 'private', 'key',
+        'session', 'cookie', 'jwt', 'bearer', 'access_token', 'refresh_token',
+    ],
+    pathPatterns: [
+        /\/home\/[^/]+/g, // Unix home directories
+        /\/Users\/[^/]+/g, // macOS home directories
+        /C:\\Users\\[^\\]+/gi, // Windows user directories
+        /\/var\/[^/]+/g, // Var directories
+        /\/tmp\/[^/]+/g, // Temp directories
+    ],
+};
+// ============================================================================
+// Sanitization Functions
+// ============================================================================
+/**
+ * Sanitize a string message
+ */
+function sanitizeMessage(message, config) {
+    let sanitized = message;
+    // Truncate long messages
+    if (sanitized.length > config.maxMessageLength) {
+        sanitized = sanitized.substring(0, config.maxMessageLength) + '... [truncated]';
+    }
+    // Sanitize paths
+    for (const pattern of config.pathPatterns) {
+        sanitized = sanitized.replace(pattern, '[PATH]');
+    }
+    // Remove potential sensitive data patterns
+    sanitized = sanitized.replace(/[a-zA-Z0-9+/]{40,}={0,2}/g, '[REDACTED_KEY]');
+    sanitized = sanitized.replace(/Bearer\s+[^\s]+/gi, 'Bearer [REDACTED]');
+    sanitized = sanitized.replace(/token[=:]\s*[^\s&]+/gi, 'token=[REDACTED]');
+    return sanitized;
+}
+/**
+ * Sanitize an error object
+ */
+function sanitizeError(error, config) {
+    if (error === null || error === undefined) {
+        return { message: 'Unknown error' };
+    }
+    if (typeof error === 'string') {
+        return { message: sanitizeMessage(error, config) };
+    }
+    if (error instanceof Error) {
+        const sanitized = {
+            name: error.name,
+            message: sanitizeMessage(error.message, config),
+        };
+        // Only include stack in development
+        if (config.includeStackTrace && error.stack) {
+            sanitized.stack = sanitizeMessage(error.stack, config);
+        }
+        // Include code if present (common in Node.js errors)
+        if ('code' in error) {
+            sanitized.code = error.code;
+        }
+        return sanitized;
+    }
+    if (typeof error === 'object') {
+        return sanitizeObject(error, config);
+    }
+    return { message: String(error) };
+}
+/**
+ * Sanitize a plain object
+ */
+function sanitizeObject(obj, config) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const lowerKey = key.toLowerCase();
+        // Skip sensitive keys
+        if (config.sensitiveKeys.some(sk => lowerKey.includes(sk))) {
+            sanitized[key] = '[REDACTED]';
+            continue;
+        }
+        // Recursively sanitize nested objects
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            sanitized[key] = sanitizeObject(value, config);
+        }
+        else if (typeof value === 'string') {
+            sanitized[key] = sanitizeMessage(value, config);
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+// ============================================================================
+// Logger Class
+// ============================================================================
+export class SecureLogger {
+    config;
+    prefix;
+    constructor(prefix = '', config = {}) {
+        this.prefix = prefix;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Log an info message
+     */
+    info(message, data) {
+        const sanitizedMessage = sanitizeMessage(message, this.config);
+        const sanitizedData = data ? sanitizeObject(data, this.config) : undefined;
+        if (sanitizedData) {
+            console.info(`[INFO]${this.prefix ? ` [${this.prefix}]` : ''} ${sanitizedMessage}`, sanitizedData);
+        }
+        else {
+            console.info(`[INFO]${this.prefix ? ` [${this.prefix}]` : ''} ${sanitizedMessage}`);
+        }
+    }
+    /**
+     * Log a warning message
+     */
+    warn(message, data) {
+        const sanitizedMessage = sanitizeMessage(message, this.config);
+        const sanitizedData = data ? sanitizeObject(data, this.config) : undefined;
+        if (sanitizedData) {
+            console.warn(`[WARN]${this.prefix ? ` [${this.prefix}]` : ''} ${sanitizedMessage}`, sanitizedData);
+        }
+        else {
+            console.warn(`[WARN]${this.prefix ? ` [${this.prefix}]` : ''} ${sanitizedMessage}`);
+        }
+    }
+    /**
+     * Log an error (sanitized for security)
+     */
+    error(message, error) {
+        const sanitizedMessage = sanitizeMessage(message, this.config);
+        const sanitizedError = error ? sanitizeError(error, this.config) : undefined;
+        if (sanitizedError) {
+            console.error(`[ERROR]${this.prefix ? ` [${this.prefix}]` : ''} ${sanitizedMessage}`, sanitizedError);
+        }
+        else {
+            console.error(`[ERROR]${this.prefix ? ` [${this.prefix}]` : ''} ${sanitizedMessage}`);
+        }
+    }
+    /**
+     * Log debug message (only in development)
+     */
+    debug(message, data) {
+        if (this.config.environment !== 'development') {
+            return;
+        }
+        const sanitizedMessage = sanitizeMessage(message, this.config);
+        const sanitizedData = data ? sanitizeObject(data, this.config) : undefined;
+        if (sanitizedData) {
+            console.debug(`[DEBUG]${this.prefix ? ` [${this.prefix}]` : ''} ${sanitizedMessage}`, sanitizedData);
+        }
+        else {
+            console.debug(`[DEBUG]${this.prefix ? ` [${this.prefix}]` : ''} ${sanitizedMessage}`);
+        }
+    }
+    /**
+     * Create a child logger with a sub-prefix
+     */
+    child(subPrefix) {
+        const newPrefix = this.prefix ? `${this.prefix}:${subPrefix}` : subPrefix;
+        return new SecureLogger(newPrefix, this.config);
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create a secure logger instance
+ */
+export function createSecureLogger(prefix, config) {
+    return new SecureLogger(prefix, config);
+}
+/**
+ * Default logger instance
+ */
+export const logger = createSecureLogger('swarmdo');
+/**
+ * Sanitize an error for safe logging/display
+ */
+export function sanitizeErrorForLogging(error) {
+    return sanitizeError(error, DEFAULT_CONFIG);
+}
+/**
+ * Sanitize a message for safe logging/display
+ */
+export function sanitizeMessageForLogging(message) {
+    return sanitizeMessage(message, DEFAULT_CONFIG);
+}
+export default SecureLogger;
+//# sourceMappingURL=secure-logger.js.map

package/vendor/shared/dist/utils/secure-logger.js.map

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

package/vendor/shared/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@swarmdo/shared",
+  "version": "3.0.0-alpha.11",
+  "type": "module",
+  "description": "Shared module - common types, events, utilities, core interfaces",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./types": "./dist/types/index.js",
+    "./core": "./dist/core/index.js",
+    "./events": "./dist/events/index.js",
+    "./hooks": "./dist/hooks/index.js",
+    "./mcp": "./dist/mcp/index.js",
+    "./security": "./dist/security/index.js",
+    "./resilience": "./dist/resilience/index.js",
+    "./src/plugin-interface.js": "./dist/plugin-interface.js"
+  },
+  "dependencies": {
+    "sql.js": "^1.10.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "v3alpha"
+  }
+}

package/vendor/shared/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/vendor/sona/index.cjs

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * @swarmvector/sona - CommonJS wrapper
+ *
+ * Swarmdo in-repo fork of the upstream SONA engine. Loads the bundled native
+ * napi binding and re-exports SonaEngine.
+ */
+const { existsSync } = require("node:fs");
+const { join } = require("node:path");
+const { platform, arch } = require("node:os");
+
+const TRIPLE = {
+  "linux-x64": "linux-x64-gnu",
+  "linux-arm64": "linux-arm64-gnu",
+  "darwin-x64": "darwin-x64",
+  "darwin-arm64": "darwin-arm64",
+  "win32-x64": "win32-x64-msvc",
+};
+
+function loadNativeBinding() {
+  const key = `${platform()}-${arch()}`;
+  const triple = TRIPLE[key];
+  const errors = [];
+  if (triple) {
+    const local = join(__dirname, "platforms", triple, "swarmvector-sona.node");
+    if (existsSync(local)) {
+      try {
+        return require(local);
+      } catch (e) {
+        errors.push(`bundled: ${e.message}`);
+      }
+    }
+    try {
+      return require(`@swarmvector/sona-${triple}`);
+    } catch (e) {
+      errors.push(`@swarmvector/sona-${triple}: ${e.message}`);
+    }
+  }
+  throw new Error(
+    `@swarmvector/sona: no native binding for ${key}.\n` + errors.join("\n")
+  );
+}
+
+const nativeBinding = loadNativeBinding();
+module.exports = nativeBinding;
+module.exports.default = nativeBinding;

package/vendor/sona/index.d.ts

@@ -0,0 +1,145 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/** SONA configuration for Node.js */
+export interface JsSonaConfig {
+  /** Hidden dimension size */
+  hiddenDim: number
+  /** Embedding dimension (defaults to hidden_dim) */
+  embeddingDim?: number
+  /** Micro-LoRA rank (1-2, default: 1) */
+  microLoraRank?: number
+  /** Base LoRA rank (default: 8) */
+  baseLoraRank?: number
+  /** Micro-LoRA learning rate (default: 0.001) */
+  microLoraLr?: number
+  /** Base LoRA learning rate (default: 0.0001) */
+  baseLoraLr?: number
+  /** EWC lambda regularization (default: 1000.0) */
+  ewcLambda?: number
+  /** Number of pattern clusters (default: 50) */
+  patternClusters?: number
+  /** Trajectory buffer capacity (default: 10000) */
+  trajectoryCapacity?: number
+  /** Background learning interval in ms (default: 3600000 = 1 hour) */
+  backgroundIntervalMs?: number
+  /** Quality threshold for learning (default: 0.5) */
+  qualityThreshold?: number
+  /** Enable SIMD optimizations (default: true) */
+  enableSimd?: boolean
+}
+/** Learned pattern for Node.js */
+export interface JsLearnedPattern {
+  /** Pattern identifier */
+  id: string
+  /** Cluster centroid embedding */
+  centroid: Array<number>
+  /** Number of trajectories in cluster */
+  clusterSize: number
+  /** Total weight of trajectories */
+  totalWeight: number
+  /** Average quality of member trajectories */
+  avgQuality: number
+  /** Creation timestamp (Unix seconds) */
+  createdAt: string
+  /** Last access timestamp (Unix seconds) */
+  lastAccessed: string
+  /** Total access count */
+  accessCount: number
+  /** Pattern type */
+  patternType: string
+}
+/** Node.js SONA Engine wrapper */
+export declare class SonaEngine {
+  /**
+   * Create a new SONA engine with default configuration
+   * @param hidden_dim - Hidden dimension size (e.g., 256, 512)
+   */
+  constructor(hiddenDim: number)
+  /**
+   * Create with custom configuration
+   * @param config - Custom SONA configuration object
+   */
+  static withConfig(config: JsSonaConfig): SonaEngine
+  /**
+   * Start a new trajectory recording
+   * @param query_embedding - Query embedding vector (Float64Array)
+   * @returns Trajectory ID for adding steps
+   */
+  beginTrajectory(queryEmbedding: Array<number>): number
+  /**
+   * Add a step to trajectory
+   * @param trajectory_id - Trajectory ID from beginTrajectory
+   * @param activations - Layer activations (Float64Array)
+   * @param attention_weights - Attention weights (Float64Array)
+   * @param reward - Reward signal for this step
+   */
+  addTrajectoryStep(trajectoryId: number, activations: Array<number>, attentionWeights: Array<number>, reward: number): void
+  /**
+   * Set model route for trajectory
+   * @param trajectory_id - Trajectory ID
+   * @param route - Model route identifier
+   */
+  setTrajectoryRoute(trajectoryId: number, route: string): void
+  /**
+   * Add context to trajectory
+   * @param trajectory_id - Trajectory ID
+   * @param context_id - Context identifier
+   */
+  addTrajectoryContext(trajectoryId: number, contextId: string): void
+  /**
+   * Complete a trajectory and submit for learning
+   * @param trajectory_id - Trajectory ID
+   * @param quality - Final quality score [0.0, 1.0]
+   */
+  endTrajectory(trajectoryId: number, quality: number): void
+  /**
+   * Apply micro-LoRA transformation to input
+   * @param input - Input vector (Float64Array)
+   * @returns Transformed output vector
+   */
+  applyMicroLora(input: Array<number>): Array<number>
+  /**
+   * Apply base-LoRA transformation to layer output
+   * @param layer_idx - Layer index
+   * @param input - Input vector (Float64Array)
+   * @returns Transformed output vector
+   */
+  applyBaseLora(layerIdx: number, input: Array<number>): Array<number>
+  /**
+   * Run background learning cycle if due
+   * @returns Optional status message if cycle was executed
+   */
+  tick(): string | null
+  /**
+   * Force background learning cycle immediately
+   * @returns Status message with learning results
+   */
+  forceLearn(): string
+  /** Flush instant loop updates */
+  flush(): void
+  /**
+   * Find similar learned patterns to query
+   * @param query_embedding - Query embedding vector
+   * @param k - Number of patterns to return
+   * @returns Array of learned patterns
+   */
+  findPatterns(queryEmbedding: Array<number>, k: number): Array<JsLearnedPattern>
+  /**
+   * Get engine statistics as JSON string
+   * @returns Statistics object as JSON string
+   */
+  getStats(): string
+  /**
+   * Enable or disable the engine
+   * @param enabled - Whether to enable the engine
+   */
+  setEnabled(enabled: boolean): void
+  /**
+   * Check if engine is enabled
+   * @returns Whether the engine is enabled
+   */
+  isEnabled(): boolean
+}

package/vendor/sona/index.mjs

@@ -0,0 +1,6 @@
+/** @swarmvector/sona - ESM wrapper (re-exports the full native surface via the CJS entry). */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const mod = require("./index.cjs");
+export default mod;
+export const { SonaEngine } = mod;

package/vendor/sona/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@swarmvector/sona",
+  "version": "0.2.1",
+  "description": "Self-Optimizing Neural Architecture (SONA) — adaptive learning for LLM routers. Swarmdo in-repo fork of the upstream sona engine.",
+  "main": "./index.cjs",
+  "module": "./index.mjs",
+  "types": "./index.d.ts",
+  "type": "commonjs",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.mjs",
+      "require": "./index.cjs"
+    }
+  },
+  "files": [
+    "index.cjs",
+    "index.mjs",
+    "index.d.ts",
+    "platforms"
+  ],
+  "engines": {
+    "node": ">= 18"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SwarmDo/swarmdo.git",
+    "directory": "v3/@swarmvector/sona"
+  }
+}