family-ai-agent 1.0.0

package/dist/utils/errors.js

@@ -0,0 +1,94 @@
+export class FamilyAIError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(message, code, statusCode = 500, details) {
+        super(message);
+        this.name = 'FamilyAIError';
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+export class ConfigurationError extends FamilyAIError {
+    constructor(message, details) {
+        super(message, 'CONFIGURATION_ERROR', 500, details);
+        this.name = 'ConfigurationError';
+    }
+}
+export class LLMError extends FamilyAIError {
+    constructor(message, details) {
+        super(message, 'LLM_ERROR', 502, details);
+        this.name = 'LLMError';
+    }
+}
+export class MemoryError extends FamilyAIError {
+    constructor(message, details) {
+        super(message, 'MEMORY_ERROR', 500, details);
+        this.name = 'MemoryError';
+    }
+}
+export class ToolExecutionError extends FamilyAIError {
+    constructor(message, toolName, details) {
+        super(message, 'TOOL_EXECUTION_ERROR', 500, { toolName, ...details });
+        this.name = 'ToolExecutionError';
+    }
+}
+export class SafetyError extends FamilyAIError {
+    constructor(message, details) {
+        super(message, 'SAFETY_ERROR', 403, details);
+        this.name = 'SafetyError';
+    }
+}
+export class ValidationError extends FamilyAIError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', 400, details);
+        this.name = 'ValidationError';
+    }
+}
+export class AgentError extends FamilyAIError {
+    constructor(message, agentId, details) {
+        super(message, 'AGENT_ERROR', 500, { agentId, ...details });
+        this.name = 'AgentError';
+    }
+}
+export class RateLimitError extends FamilyAIError {
+    constructor(retryAfter) {
+        super('Rate limit exceeded', 'RATE_LIMIT_ERROR', 429, { retryAfter });
+        this.name = 'RateLimitError';
+    }
+}
+export class SandboxError extends FamilyAIError {
+    constructor(message, details) {
+        super(message, 'SANDBOX_ERROR', 500, details);
+        this.name = 'SandboxError';
+    }
+}
+export function isRetryableError(error) {
+    if (error instanceof FamilyAIError) {
+        return (error.code === 'LLM_ERROR' ||
+            error.code === 'RATE_LIMIT_ERROR' ||
+            error.statusCode >= 500);
+    }
+    return false;
+}
+export function formatErrorForUser(error) {
+    if (error instanceof SafetyError) {
+        return `Request blocked: ${error.message}`;
+    }
+    if (error instanceof ValidationError) {
+        return `Invalid input: ${error.message}`;
+    }
+    if (error instanceof RateLimitError) {
+        return 'Too many requests. Please wait a moment and try again.';
+    }
+    if (error instanceof FamilyAIError) {
+        return `An error occurred: ${error.message}`;
+    }
+    if (error instanceof Error) {
+        return `Unexpected error: ${error.message}`;
+    }
+    return 'An unexpected error occurred';
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,8 @@
+import winston from 'winston';
+export declare const logger: winston.Logger;
+export declare function createLogger(component: string): winston.Logger;
+export declare function logAgentAction(agentId: string, action: string, details: Record<string, unknown>): void;
+export declare function logToolExecution(toolName: string, input: unknown, output: unknown, durationMs: number): void;
+export declare function logMemoryOperation(operation: 'read' | 'write' | 'search', memoryType: string, details: Record<string, unknown>): void;
+export declare function logSafetyEvent(eventType: string, blocked: boolean, reason?: string, details?: Record<string, unknown>): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAkB9B,eAAO,MAAM,MAAM,gBAcjB,CAAC;AAGH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,kBAE7C;AAGD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAGjC;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,QAGnB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,EACtC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAGjC;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAIlC"}

package/dist/utils/logger.js

@@ -0,0 +1,47 @@
+import winston from 'winston';
+import { config } from '../config/index.js';
+const { combine, timestamp, printf, colorize, json } = winston.format;
+const prettyFormat = printf(({ level, message, timestamp, ...metadata }) => {
+    let msg = `${timestamp} [${level}]: ${message}`;
+    if (Object.keys(metadata).length > 0) {
+        msg += ` ${JSON.stringify(metadata)}`;
+    }
+    return msg;
+});
+const logFormat = config.LOG_FORMAT === 'pretty'
+    ? combine(colorize(), timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), prettyFormat)
+    : combine(timestamp(), json());
+export const logger = winston.createLogger({
+    level: config.LOG_LEVEL,
+    format: logFormat,
+    defaultMeta: { service: 'family-ai-agent' },
+    transports: [
+        new winston.transports.Console(),
+        new winston.transports.File({
+            filename: 'logs/error.log',
+            level: 'error',
+        }),
+        new winston.transports.File({
+            filename: 'logs/combined.log',
+        }),
+    ],
+});
+// Create a child logger for specific components
+export function createLogger(component) {
+    return logger.child({ component });
+}
+// Structured logging helpers
+export function logAgentAction(agentId, action, details) {
+    logger.info('Agent action', { agentId, action, ...details });
+}
+export function logToolExecution(toolName, input, output, durationMs) {
+    logger.debug('Tool execution', { toolName, input, output, durationMs });
+}
+export function logMemoryOperation(operation, memoryType, details) {
+    logger.debug('Memory operation', { operation, memoryType, ...details });
+}
+export function logSafetyEvent(eventType, blocked, reason, details) {
+    const level = blocked ? 'warn' : 'info';
+    logger.log(level, 'Safety event', { eventType, blocked, reason, ...details });
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;AAEtE,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE;IACzE,IAAI,GAAG,GAAG,GAAG,SAAS,KAAK,KAAK,MAAM,OAAO,EAAE,CAAC;IAChD,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC,CAAC;AAEH,MAAM,SAAS,GACb,MAAM,CAAC,UAAU,KAAK,QAAQ;IAC5B,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,EAAE,YAAY,CAAC;IACjF,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AAEnC,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC,SAAS;IACvB,MAAM,EAAE,SAAS;IACjB,WAAW,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE;IAC3C,UAAU,EAAE;QACV,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE;QAChC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAC1B,QAAQ,EAAE,gBAAgB;YAC1B,KAAK,EAAE,OAAO;SACf,CAAC;QACF,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAC1B,QAAQ,EAAE,mBAAmB;SAC9B,CAAC;KACH;CACF,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,MAAc,EACd,OAAgC;IAEhC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,KAAc,EACd,MAAe,EACf,UAAkB;IAElB,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,SAAsC,EACtC,UAAkB,EAClB,OAAgC;IAEhC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,OAAgB,EAChB,MAAe,EACf,OAAiC;IAEjC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/docker/init-db.sql

@@ -0,0 +1,149 @@
+-- Enable pgvector extension
+CREATE EXTENSION IF NOT EXISTS vector;
+
+-- Memory tables
+CREATE TABLE IF NOT EXISTS conversations (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    thread_id VARCHAR(255) NOT NULL,
+    user_id VARCHAR(255),
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+CREATE TABLE IF NOT EXISTS messages (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    conversation_id UUID REFERENCES conversations(id) ON DELETE CASCADE,
+    role VARCHAR(50) NOT NULL,
+    content TEXT NOT NULL,
+    metadata JSONB DEFAULT '{}',
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+-- Long-term memory with vector embeddings
+CREATE TABLE IF NOT EXISTS long_term_memories (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    user_id VARCHAR(255),
+    memory_type VARCHAR(50) NOT NULL, -- 'semantic', 'episodic', 'procedural'
+    content TEXT NOT NULL,
+    embedding vector(1536), -- OpenAI embedding dimension
+    importance FLOAT DEFAULT 0.5,
+    access_count INTEGER DEFAULT 0,
+    last_accessed TIMESTAMP WITH TIME ZONE,
+    metadata JSONB DEFAULT '{}',
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+-- Create HNSW index for fast similarity search
+CREATE INDEX IF NOT EXISTS long_term_memories_embedding_idx
+ON long_term_memories
+USING hnsw (embedding vector_cosine_ops);
+
+-- Knowledge base documents
+CREATE TABLE IF NOT EXISTS documents (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    user_id VARCHAR(255),
+    filename VARCHAR(500) NOT NULL,
+    file_type VARCHAR(50),
+    file_size INTEGER,
+    content TEXT,
+    metadata JSONB DEFAULT '{}',
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+-- Document chunks with embeddings (for RAG)
+CREATE TABLE IF NOT EXISTS document_chunks (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    document_id UUID REFERENCES documents(id) ON DELETE CASCADE,
+    chunk_index INTEGER NOT NULL,
+    content TEXT NOT NULL,
+    embedding vector(1536),
+    metadata JSONB DEFAULT '{}',
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS document_chunks_embedding_idx
+ON document_chunks
+USING hnsw (embedding vector_cosine_ops);
+
+-- LangGraph checkpointer tables
+CREATE TABLE IF NOT EXISTS checkpoints (
+    thread_id VARCHAR(255) NOT NULL,
+    checkpoint_ns VARCHAR(255) NOT NULL DEFAULT '',
+    checkpoint_id VARCHAR(255) NOT NULL,
+    parent_checkpoint_id VARCHAR(255),
+    type VARCHAR(50),
+    checkpoint JSONB NOT NULL,
+    metadata JSONB DEFAULT '{}',
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    PRIMARY KEY (thread_id, checkpoint_ns, checkpoint_id)
+);
+
+CREATE TABLE IF NOT EXISTS checkpoint_writes (
+    thread_id VARCHAR(255) NOT NULL,
+    checkpoint_ns VARCHAR(255) NOT NULL DEFAULT '',
+    checkpoint_id VARCHAR(255) NOT NULL,
+    task_id VARCHAR(255) NOT NULL,
+    idx INTEGER NOT NULL,
+    channel VARCHAR(255) NOT NULL,
+    type VARCHAR(50),
+    value JSONB,
+    PRIMARY KEY (thread_id, checkpoint_ns, checkpoint_id, task_id, idx)
+);
+
+-- Audit log for safety
+CREATE TABLE IF NOT EXISTS audit_logs (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    user_id VARCHAR(255),
+    agent_id VARCHAR(255),
+    action_type VARCHAR(100) NOT NULL,
+    action_details JSONB NOT NULL,
+    input_hash VARCHAR(64),
+    output_hash VARCHAR(64),
+    status VARCHAR(50) DEFAULT 'success',
+    error_message TEXT,
+    execution_time_ms INTEGER,
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS audit_logs_user_idx ON audit_logs(user_id);
+CREATE INDEX IF NOT EXISTS audit_logs_agent_idx ON audit_logs(agent_id);
+CREATE INDEX IF NOT EXISTS audit_logs_created_idx ON audit_logs(created_at);
+
+-- Task queue for automation
+CREATE TABLE IF NOT EXISTS tasks (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    user_id VARCHAR(255),
+    task_type VARCHAR(100) NOT NULL,
+    priority INTEGER DEFAULT 5,
+    status VARCHAR(50) DEFAULT 'pending', -- pending, running, completed, failed
+    payload JSONB NOT NULL,
+    result JSONB,
+    scheduled_at TIMESTAMP WITH TIME ZONE,
+    started_at TIMESTAMP WITH TIME ZONE,
+    completed_at TIMESTAMP WITH TIME ZONE,
+    error_message TEXT,
+    retry_count INTEGER DEFAULT 0,
+    max_retries INTEGER DEFAULT 3,
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS tasks_status_idx ON tasks(status);
+CREATE INDEX IF NOT EXISTS tasks_scheduled_idx ON tasks(scheduled_at);
+
+-- Update timestamp trigger
+CREATE OR REPLACE FUNCTION update_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+    NEW.updated_at = NOW();
+    RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER conversations_updated_at
+    BEFORE UPDATE ON conversations
+    FOR EACH ROW EXECUTE FUNCTION update_updated_at();
+
+CREATE TRIGGER long_term_memories_updated_at
+    BEFORE UPDATE ON long_term_memories
+    FOR EACH ROW EXECUTE FUNCTION update_updated_at();

package/docker/sandbox/Dockerfile.sandbox

@@ -0,0 +1,29 @@
+# Sandbox container for isolated code execution
+FROM node:20-alpine
+
+# Install Python and common tools
+RUN apk add --no-cache \
+    python3 \
+    py3-pip \
+    bash \
+    curl \
+    git \
+    && rm -rf /var/cache/apk/*
+
+# Create non-root user for security
+RUN addgroup -g 1001 sandbox && \
+    adduser -D -u 1001 -G sandbox sandbox
+
+# Create workspace directory
+WORKDIR /workspace
+RUN chown sandbox:sandbox /workspace
+
+# Switch to non-root user
+USER sandbox
+
+# Set resource limits via environment
+ENV NODE_OPTIONS="--max-old-space-size=256"
+ENV PYTHONDONTWRITEBYTECODE=1
+
+# Default command
+CMD ["sh"]

package/docker-compose.yml

@@ -0,0 +1,61 @@
+version: '3.8'
+
+services:
+  postgres:
+    image: pgvector/pgvector:pg16
+    container_name: family-ai-db
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: ${DB_USER:-familyai}
+      POSTGRES_PASSWORD: ${DB_PASSWORD:-familyai123}
+      POSTGRES_DB: ${DB_NAME:-familyai}
+    ports:
+      - "${DB_PORT:-5432}:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+      - ./docker/init-db.sql:/docker-entrypoint-initdb.d/init.sql
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${DB_USER:-familyai} -d ${DB_NAME:-familyai}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  redis:
+    image: redis:7-alpine
+    container_name: family-ai-redis
+    restart: unless-stopped
+    ports:
+      - "${REDIS_PORT:-6379}:6379"
+    volumes:
+      - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  sandbox:
+    build:
+      context: ./docker/sandbox
+      dockerfile: Dockerfile.sandbox
+    container_name: family-ai-sandbox
+    restart: unless-stopped
+    privileged: false
+    security_opt:
+      - no-new-privileges:true
+    read_only: true
+    tmpfs:
+      - /tmp:size=256M
+    mem_limit: 512m
+    cpus: 1
+    networks:
+      - sandbox_network
+
+volumes:
+  postgres_data:
+  redis_data:
+
+networks:
+  sandbox_network:
+    driver: bridge
+    internal: true

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "family-ai-agent",
+  "version": "1.0.0",
+  "description": "Multi-agent AI system with memory and autonomous capabilities",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "cli": "tsx src/cli/index.ts",
+    "db:migrate": "tsx scripts/migrate.ts",
+    "db:setup": "docker-compose up -d && npm run db:migrate",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write src/**/*.ts",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage"
+  },
+  "dependencies": {
+    "@langchain/core": "^0.3.26",
+    "@langchain/langgraph": "^0.2.42",
+    "@langchain/openai": "^0.3.17",
+    "@langchain/community": "^0.3.24",
+    "@langchain/textsplitters": "^0.1.0",
+    "@fastify/cors": "^10.0.1",
+    "@fastify/rate-limit": "^10.2.0",
+    "@fastify/websocket": "^11.0.1",
+    "fastify": "^5.1.0",
+    "pg": "^8.13.1",
+    "pgvector": "^0.2.0",
+    "drizzle-orm": "^0.38.2",
+    "playwright": "^1.49.1",
+    "cheerio": "^1.0.0",
+    "pdf-parse": "^1.1.1",
+    "mammoth": "^1.8.0",
+    "commander": "^12.1.0",
+    "inquirer": "^12.2.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.1.1",
+    "boxen": "^8.0.1",
+    "winston": "^3.17.0",
+    "nanoid": "^5.0.9",
+    "p-retry": "^6.2.1",
+    "dotenv": "^16.4.7",
+    "zod": "^3.24.1",
+    "dompurify": "^3.2.2",
+    "jsdom": "^25.0.1",
+    "validator": "^13.12.0",
+    "dockerode": "^4.0.2",
+    "marked": "^15.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/pg": "^8.11.10",
+    "@types/dompurify": "^3.0.5",
+    "@types/jsdom": "^21.1.7",
+    "@types/validator": "^13.12.2",
+    "typescript": "^5.7.2",
+    "tsx": "^4.19.2",
+    "vitest": "^2.1.8",
+    "eslint": "^9.17.0",
+    "prettier": "^3.4.2",
+    "drizzle-kit": "^0.30.1",
+    "@typescript-eslint/eslint-plugin": "^8.18.1",
+    "@typescript-eslint/parser": "^8.18.1"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "multi-agent",
+    "langchain",
+    "langgraph",
+    "openrouter"
+  ],
+  "author": "",
+  "license": "MIT"
+}