@agimon-ai/log-sink-mcp 0.8.0 → 0.8.2

package/dist/cli.d.cts

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

package/dist/cli.d.mts

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

package/dist/index.d.cts

@@ -0,0 +1,508 @@
+import { NodeTelemetryHandle, NodeTelemetryLogOptions, NodeTelemetryLogger, NodeTelemetryOptions, TelemetryLevel, createNodeTelemetry, getLogSinkOtelEndpoint, log as logs, trace } from "./telemetry/node.cjs";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { Container } from "inversify";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import * as _$drizzle_orm_sqlite_core0 from "drizzle-orm/sqlite-core";
+
+//#region src/server/index.d.ts
+declare function createServer(existingContainer?: Container): Server;
+//#endregion
+//#region src/types/container.types.d.ts
+/**
+ * Dependency Injection Container Types
+ *
+ * DESIGN PATTERNS:
+ * - Dependency Injection with InversifyJS
+ * - Symbol-based service identifiers
+ *
+ * CODING STANDARDS:
+ * - Use symbols for DI identifiers to avoid naming collisions
+ * - Group symbols by service category
+ * - Export TYPES constant for centralized access
+ *
+ * AVOID:
+ * - String-based identifiers (use symbols)
+ * - Hardcoded type values
+ */
+/**
+ * InversifyJS DI symbols for service identification
+ */
+declare const TYPES: {
+  readonly LogStorageService: symbol;
+  readonly EmbeddingService: symbol;
+  readonly LogQueryService: symbol;
+  readonly LogSearchService: symbol;
+  readonly SemanticSearchService: symbol;
+  readonly LogRetentionService: symbol;
+  readonly HttpServerHealthCheck: symbol;
+  readonly HttpServerManager: symbol;
+  readonly Database: symbol;
+  readonly Logger: symbol;
+  readonly HttpServer: symbol;
+  readonly McpServer: symbol;
+};
+/**
+ * Type for TYPES constant keys
+ */
+type TypeKey = keyof typeof TYPES;
+/**
+ * Type for TYPES constant values
+ */
+type TypeSymbol = (typeof TYPES)[TypeKey];
+//#endregion
+//#region src/models/schema.d.ts
+/**
+ * Log Sink Schema
+ *
+ * DESIGN PATTERNS:
+ * - Schema-first design with Drizzle ORM
+ * - Type inference from schema definition
+ * - FTS5 virtual table for full-text search
+ *
+ * CODING STANDARDS:
+ * - Use text() for string columns (IDs, names, messages)
+ * - Use integer() for numeric columns (pids)
+ * - Use integer({ mode: 'timestamp' }) for dates
+ * - Use text({ mode: 'json' }) for complex objects
+ * - Always define primary keys with $defaultFn for ULID generation
+ * - Add indexes for foreign keys and frequently queried columns
+ * - Table names should be snake_case singular
+ *
+ * AVOID:
+ * - Storing JSON as strings without proper typing
+ * - Missing indexes on foreign keys
+ * - Nullable primary keys
+ * - Using any for column types
+ */
+/**
+ * Logs table schema
+ *
+ * Database table: logs
+ */
+declare const logs$1: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
+  name: "logs";
+  schema: undefined;
+  columns: {
+    id: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "id";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: true;
+      isAutoincrement: false;
+      hasRuntimeDefault: true;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    timestamp: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "timestamp";
+      tableName: "logs";
+      dataType: "date";
+      columnType: "SQLiteTimestamp";
+      data: Date;
+      driverParam: number;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: true;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    level: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "level";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    message: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "message";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    traceId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "trace_id";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    spanId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "span_id";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    parentSpanId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "parent_span_id";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    service: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "service";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    hostname: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "hostname";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    pid: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "pid";
+      tableName: "logs";
+      dataType: "number";
+      columnType: "SQLiteInteger";
+      data: number;
+      driverParam: number;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    metadata: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "metadata";
+      tableName: "logs";
+      dataType: "json";
+      columnType: "SQLiteTextJson";
+      data: unknown;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    errorType: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "error_type";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    errorMessage: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "error_message";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    errorStack: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "error_stack";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    createdAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "created_at";
+      tableName: "logs";
+      dataType: "date";
+      columnType: "SQLiteTimestamp";
+      data: Date;
+      driverParam: number;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: true;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+  };
+  dialect: "sqlite";
+}>;
+/**
+ * Type for selecting a log from database
+ */
+type Log = typeof logs$1.$inferSelect;
+/**
+ * Type for inserting a log into database
+ */
+type NewLog = typeof logs$1.$inferInsert;
+//#endregion
+//#region src/types/log.types.d.ts
+/**
+ * Log entry from database (inferred from Drizzle schema)
+ */
+type LogEntry = Log;
+/**
+ * New log entry for insertion (inferred from Drizzle schema)
+ */
+type NewLogEntry = NewLog;
+/**
+ * Log level enum
+ */
+declare enum LogLevel {
+  TRACE = "trace",
+  DEBUG = "debug",
+  INFO = "info",
+  WARN = "warn",
+  ERROR = "error",
+  FATAL = "fatal"
+}
+/**
+ * Query filters for log retrieval
+ */
+interface QueryFilters {
+  level?: LogLevel | LogLevel[];
+  service?: string | string[];
+  traceId?: string;
+  spanId?: string;
+  errorType?: string;
+  startTime?: Date;
+  endTime?: Date;
+  limit?: number;
+  offset?: number;
+}
+/**
+ * Search options for full-text search
+ */
+interface SearchOptions {
+  query: string;
+  service?: string | string[];
+  level?: LogLevel | LogLevel[];
+  startTime?: Date;
+  endTime?: Date;
+  limit?: number;
+  offset?: number;
+}
+/**
+ * Log aggregation result
+ */
+interface LogAggregation {
+  service: string;
+  level: LogLevel;
+  count: number;
+}
+/**
+ * Trace timeline entry
+ */
+interface TraceTimelineEntry {
+  timestamp: Date;
+  service: string;
+  spanId: string | null;
+  parentSpanId?: string | null;
+  level: LogLevel;
+  message: string;
+  duration?: number;
+}
+//#endregion
+//#region src/types/index.d.ts
+/**
+ * Tool definition for MCP
+ */
+interface ToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: Record<string, unknown>;
+}
+/**
+ * Base tool interface following MCP SDK patterns
+ */
+interface Tool<TInput = unknown> {
+  getDefinition(): ToolDefinition;
+  getInputSchema(): z.ZodObject<z.ZodRawShape>;
+  execute(input: TInput): Promise<CallToolResult>;
+}
+/**
+ * Transport mode types
+ */
+declare enum TransportMode {
+  STDIO = "stdio"
+}
+/**
+ * Transport configuration options
+ */
+interface TransportConfig {
+  mode: TransportMode;
+}
+/**
+ * Base interface for all transport handlers
+ */
+interface TransportHandler {
+  start(): Promise<void>;
+  stop(): Promise<void>;
+}
+//#endregion
+//#region src/transports/stdio.d.ts
+/**
+ * Stdio transport handler for MCP server
+ * Used for command-line and direct integrations
+ */
+declare class StdioTransportHandler implements TransportHandler {
+  private server;
+  private transport;
+  constructor(server: Server);
+  start(): Promise<void>;
+  stop(): Promise<void>;
+}
+//#endregion
+//#region src/utils/resolveLogSinkPort.d.ts
+interface LogSinkPortResult {
+  port: number;
+  host: string;
+  endpoint: string;
+}
+interface ResolveLogSinkPortOptions {
+  env?: NodeJS.ProcessEnv;
+  workspaceRoot: string;
+  healthCheck?: boolean;
+}
+declare function resolveLogSinkPort(options: ResolveLogSinkPortOptions): Promise<LogSinkPortResult | undefined>;
+declare function resolveLogSinkOtelEndpoint(options: ResolveLogSinkPortOptions): Promise<string | undefined>;
+//#endregion
+export { LogAggregation, LogEntry, LogLevel, type LogSinkPortResult, NewLogEntry, type NodeTelemetryHandle, type NodeTelemetryLogOptions, type NodeTelemetryLogger, type NodeTelemetryOptions, QueryFilters, type ResolveLogSinkPortOptions, SearchOptions, StdioTransportHandler, TYPES, type TelemetryLevel, Tool, ToolDefinition, TraceTimelineEntry, TransportConfig, TransportHandler, TransportMode, TypeKey, TypeSymbol, createNodeTelemetry, createServer, getLogSinkOtelEndpoint, logs as log, resolveLogSinkOtelEndpoint, resolveLogSinkPort, trace };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,508 @@
+import { NodeTelemetryHandle, NodeTelemetryLogOptions, NodeTelemetryLogger, NodeTelemetryOptions, TelemetryLevel, createNodeTelemetry, getLogSinkOtelEndpoint, log as logs, trace } from "./telemetry/node.mjs";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { Container } from "inversify";
+import * as _$drizzle_orm_sqlite_core0 from "drizzle-orm/sqlite-core";
+
+//#region src/server/index.d.ts
+declare function createServer(existingContainer?: Container): Server;
+//#endregion
+//#region src/types/container.types.d.ts
+/**
+ * Dependency Injection Container Types
+ *
+ * DESIGN PATTERNS:
+ * - Dependency Injection with InversifyJS
+ * - Symbol-based service identifiers
+ *
+ * CODING STANDARDS:
+ * - Use symbols for DI identifiers to avoid naming collisions
+ * - Group symbols by service category
+ * - Export TYPES constant for centralized access
+ *
+ * AVOID:
+ * - String-based identifiers (use symbols)
+ * - Hardcoded type values
+ */
+/**
+ * InversifyJS DI symbols for service identification
+ */
+declare const TYPES: {
+  readonly LogStorageService: symbol;
+  readonly EmbeddingService: symbol;
+  readonly LogQueryService: symbol;
+  readonly LogSearchService: symbol;
+  readonly SemanticSearchService: symbol;
+  readonly LogRetentionService: symbol;
+  readonly HttpServerHealthCheck: symbol;
+  readonly HttpServerManager: symbol;
+  readonly Database: symbol;
+  readonly Logger: symbol;
+  readonly HttpServer: symbol;
+  readonly McpServer: symbol;
+};
+/**
+ * Type for TYPES constant keys
+ */
+type TypeKey = keyof typeof TYPES;
+/**
+ * Type for TYPES constant values
+ */
+type TypeSymbol = (typeof TYPES)[TypeKey];
+//#endregion
+//#region src/models/schema.d.ts
+/**
+ * Log Sink Schema
+ *
+ * DESIGN PATTERNS:
+ * - Schema-first design with Drizzle ORM
+ * - Type inference from schema definition
+ * - FTS5 virtual table for full-text search
+ *
+ * CODING STANDARDS:
+ * - Use text() for string columns (IDs, names, messages)
+ * - Use integer() for numeric columns (pids)
+ * - Use integer({ mode: 'timestamp' }) for dates
+ * - Use text({ mode: 'json' }) for complex objects
+ * - Always define primary keys with $defaultFn for ULID generation
+ * - Add indexes for foreign keys and frequently queried columns
+ * - Table names should be snake_case singular
+ *
+ * AVOID:
+ * - Storing JSON as strings without proper typing
+ * - Missing indexes on foreign keys
+ * - Nullable primary keys
+ * - Using any for column types
+ */
+/**
+ * Logs table schema
+ *
+ * Database table: logs
+ */
+declare const logs$1: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
+  name: "logs";
+  schema: undefined;
+  columns: {
+    id: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "id";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: true;
+      isAutoincrement: false;
+      hasRuntimeDefault: true;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    timestamp: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "timestamp";
+      tableName: "logs";
+      dataType: "date";
+      columnType: "SQLiteTimestamp";
+      data: Date;
+      driverParam: number;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: true;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    level: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "level";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    message: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "message";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    traceId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "trace_id";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    spanId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "span_id";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    parentSpanId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "parent_span_id";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    service: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "service";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    hostname: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "hostname";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    pid: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "pid";
+      tableName: "logs";
+      dataType: "number";
+      columnType: "SQLiteInteger";
+      data: number;
+      driverParam: number;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    metadata: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "metadata";
+      tableName: "logs";
+      dataType: "json";
+      columnType: "SQLiteTextJson";
+      data: unknown;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    errorType: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "error_type";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    errorMessage: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "error_message";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    errorStack: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "error_stack";
+      tableName: "logs";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
+    createdAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "created_at";
+      tableName: "logs";
+      dataType: "date";
+      columnType: "SQLiteTimestamp";
+      data: Date;
+      driverParam: number;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: true;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+  };
+  dialect: "sqlite";
+}>;
+/**
+ * Type for selecting a log from database
+ */
+type Log = typeof logs$1.$inferSelect;
+/**
+ * Type for inserting a log into database
+ */
+type NewLog = typeof logs$1.$inferInsert;
+//#endregion
+//#region src/types/log.types.d.ts
+/**
+ * Log entry from database (inferred from Drizzle schema)
+ */
+type LogEntry = Log;
+/**
+ * New log entry for insertion (inferred from Drizzle schema)
+ */
+type NewLogEntry = NewLog;
+/**
+ * Log level enum
+ */
+declare enum LogLevel {
+  TRACE = "trace",
+  DEBUG = "debug",
+  INFO = "info",
+  WARN = "warn",
+  ERROR = "error",
+  FATAL = "fatal"
+}
+/**
+ * Query filters for log retrieval
+ */
+interface QueryFilters {
+  level?: LogLevel | LogLevel[];
+  service?: string | string[];
+  traceId?: string;
+  spanId?: string;
+  errorType?: string;
+  startTime?: Date;
+  endTime?: Date;
+  limit?: number;
+  offset?: number;
+}
+/**
+ * Search options for full-text search
+ */
+interface SearchOptions {
+  query: string;
+  service?: string | string[];
+  level?: LogLevel | LogLevel[];
+  startTime?: Date;
+  endTime?: Date;
+  limit?: number;
+  offset?: number;
+}
+/**
+ * Log aggregation result
+ */
+interface LogAggregation {
+  service: string;
+  level: LogLevel;
+  count: number;
+}
+/**
+ * Trace timeline entry
+ */
+interface TraceTimelineEntry {
+  timestamp: Date;
+  service: string;
+  spanId: string | null;
+  parentSpanId?: string | null;
+  level: LogLevel;
+  message: string;
+  duration?: number;
+}
+//#endregion
+//#region src/types/index.d.ts
+/**
+ * Tool definition for MCP
+ */
+interface ToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: Record<string, unknown>;
+}
+/**
+ * Base tool interface following MCP SDK patterns
+ */
+interface Tool<TInput = unknown> {
+  getDefinition(): ToolDefinition;
+  getInputSchema(): z.ZodObject<z.ZodRawShape>;
+  execute(input: TInput): Promise<CallToolResult>;
+}
+/**
+ * Transport mode types
+ */
+declare enum TransportMode {
+  STDIO = "stdio"
+}
+/**
+ * Transport configuration options
+ */
+interface TransportConfig {
+  mode: TransportMode;
+}
+/**
+ * Base interface for all transport handlers
+ */
+interface TransportHandler {
+  start(): Promise<void>;
+  stop(): Promise<void>;
+}
+//#endregion
+//#region src/transports/stdio.d.ts
+/**
+ * Stdio transport handler for MCP server
+ * Used for command-line and direct integrations
+ */
+declare class StdioTransportHandler implements TransportHandler {
+  private server;
+  private transport;
+  constructor(server: Server);
+  start(): Promise<void>;
+  stop(): Promise<void>;
+}
+//#endregion
+//#region src/utils/resolveLogSinkPort.d.ts
+interface LogSinkPortResult {
+  port: number;
+  host: string;
+  endpoint: string;
+}
+interface ResolveLogSinkPortOptions {
+  env?: NodeJS.ProcessEnv;
+  workspaceRoot: string;
+  healthCheck?: boolean;
+}
+declare function resolveLogSinkPort(options: ResolveLogSinkPortOptions): Promise<LogSinkPortResult | undefined>;
+declare function resolveLogSinkOtelEndpoint(options: ResolveLogSinkPortOptions): Promise<string | undefined>;
+//#endregion
+export { LogAggregation, LogEntry, LogLevel, type LogSinkPortResult, NewLogEntry, type NodeTelemetryHandle, type NodeTelemetryLogOptions, type NodeTelemetryLogger, type NodeTelemetryOptions, QueryFilters, type ResolveLogSinkPortOptions, SearchOptions, StdioTransportHandler, TYPES, type TelemetryLevel, Tool, ToolDefinition, TraceTimelineEntry, TransportConfig, TransportHandler, TransportMode, TypeKey, TypeSymbol, createNodeTelemetry, createServer, getLogSinkOtelEndpoint, logs as log, resolveLogSinkOtelEndpoint, resolveLogSinkPort, trace };
+//# sourceMappingURL=index.d.mts.map

package/dist/telemetry/node.d.cts

@@ -0,0 +1,56 @@
+import { Attributes, Context, trace } from "@opentelemetry/api";
+import { logs } from "@opentelemetry/api-logs";
+
+//#region src/telemetry/node.d.ts
+type TelemetryLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+interface NodeTelemetryLogOptions {
+  attributes?: Attributes;
+  context?: Context;
+  exception?: unknown;
+}
+interface NodeTelemetryLogger {
+  trace(message: string, options?: NodeTelemetryLogOptions): void;
+  debug(message: string, options?: NodeTelemetryLogOptions): void;
+  info(message: string, options?: NodeTelemetryLogOptions): void;
+  warn(message: string, options?: NodeTelemetryLogOptions): void;
+  error(message: string, options?: NodeTelemetryLogOptions): void;
+  fatal(message: string, options?: NodeTelemetryLogOptions): void;
+  getTraceContext(): {
+    traceId?: string;
+    spanId?: string;
+  };
+  flush(): Promise<void>;
+  shutdown(): Promise<void>;
+}
+interface NodeTelemetryOptions {
+  env?: NodeJS.ProcessEnv;
+  serviceName: string;
+  serviceVersion?: string;
+  workspaceRoot?: string;
+  enableTraces?: boolean;
+  enableLogs?: boolean;
+  logDir?: string;
+  logFileName?: string;
+  maxFileSizeBytes?: number;
+  maxFileCount?: number;
+}
+interface NodeTelemetryHandle {
+  backend: 'logsink' | 'file';
+  enabled: boolean;
+  trace: typeof trace;
+  log: typeof logs;
+  logger: NodeTelemetryLogger;
+  endpoint?: string;
+  filePath?: string;
+  flush(): Promise<void>;
+  shutdown(): Promise<void>;
+}
+declare function getLogSinkOtelEndpoint(options: {
+  env?: NodeJS.ProcessEnv;
+  workspaceRoot: string;
+  healthCheck?: boolean;
+}): Promise<string | undefined>;
+declare function createNodeTelemetry(options: NodeTelemetryOptions): Promise<NodeTelemetryHandle>;
+//#endregion
+export { NodeTelemetryHandle, NodeTelemetryLogOptions, NodeTelemetryLogger, NodeTelemetryOptions, TelemetryLevel, createNodeTelemetry, getLogSinkOtelEndpoint, logs as log, trace };
+//# sourceMappingURL=node.d.cts.map

package/dist/telemetry/node.d.mts

@@ -0,0 +1,56 @@
+import { Attributes, Context, trace } from "@opentelemetry/api";
+import { logs } from "@opentelemetry/api-logs";
+
+//#region src/telemetry/node.d.ts
+type TelemetryLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+interface NodeTelemetryLogOptions {
+  attributes?: Attributes;
+  context?: Context;
+  exception?: unknown;
+}
+interface NodeTelemetryLogger {
+  trace(message: string, options?: NodeTelemetryLogOptions): void;
+  debug(message: string, options?: NodeTelemetryLogOptions): void;
+  info(message: string, options?: NodeTelemetryLogOptions): void;
+  warn(message: string, options?: NodeTelemetryLogOptions): void;
+  error(message: string, options?: NodeTelemetryLogOptions): void;
+  fatal(message: string, options?: NodeTelemetryLogOptions): void;
+  getTraceContext(): {
+    traceId?: string;
+    spanId?: string;
+  };
+  flush(): Promise<void>;
+  shutdown(): Promise<void>;
+}
+interface NodeTelemetryOptions {
+  env?: NodeJS.ProcessEnv;
+  serviceName: string;
+  serviceVersion?: string;
+  workspaceRoot?: string;
+  enableTraces?: boolean;
+  enableLogs?: boolean;
+  logDir?: string;
+  logFileName?: string;
+  maxFileSizeBytes?: number;
+  maxFileCount?: number;
+}
+interface NodeTelemetryHandle {
+  backend: 'logsink' | 'file';
+  enabled: boolean;
+  trace: typeof trace;
+  log: typeof logs;
+  logger: NodeTelemetryLogger;
+  endpoint?: string;
+  filePath?: string;
+  flush(): Promise<void>;
+  shutdown(): Promise<void>;
+}
+declare function getLogSinkOtelEndpoint(options: {
+  env?: NodeJS.ProcessEnv;
+  workspaceRoot: string;
+  healthCheck?: boolean;
+}): Promise<string | undefined>;
+declare function createNodeTelemetry(options: NodeTelemetryOptions): Promise<NodeTelemetryHandle>;
+//#endregion
+export { NodeTelemetryHandle, NodeTelemetryLogOptions, NodeTelemetryLogger, NodeTelemetryOptions, TelemetryLevel, createNodeTelemetry, getLogSinkOtelEndpoint, logs as log, trace };
+//# sourceMappingURL=node.d.mts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agimon-ai/log-sink-mcp",
   "description": "Log sink MCP server with HTTP ingestion and AI analysis",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "license": "BUSL-1.1",
   "keywords": [
     "mcp",
@@ -41,9 +41,9 @@
     "sqlite-vec": "0.1.9",
     "ulidx": "2.4.1",
     "zod": "4.3.6",
-    "@agimon-ai/foundation-validator": "0.5.0",
-    "@agimon-ai/foundation-process-registry": "0.8.0",
-    "@agimon-ai/foundation-port-registry": "0.8.0"
+    "@agimon-ai/foundation-process-registry": "0.8.2",
+    "@agimon-ai/foundation-validator": "0.5.2",
+    "@agimon-ai/foundation-port-registry": "0.8.2"
   },
   "devDependencies": {
     "@types/bun": "1.3.11",