@hasna/logs 0.3.14 → 0.3.16

package/dist/mcp/index.js

@@ -6527,7 +6527,7 @@ var require_dist = __commonJS((exports, module) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/logs",
-    version: "0.3.14",
+    version: "0.3.16",
     description: "Log aggregation + browser script + headless page scanner + performance monitoring for AI agents",
     type: "module",
     main: "./dist/index.js",
@@ -6544,7 +6544,8 @@ var require_package = __commonJS((exports, module) => {
       dev: "bun run src/server/index.ts",
       test: "bun test",
       "test:coverage": "bun test --coverage",
-      lint: "biome check src/"
+      lint: "biome check src/",
+      postinstall: "mkdir -p $HOME/.hasna/logs 2>/dev/null || true"
     },
     repository: {
       type: "git",
@@ -23996,6 +23997,7 @@ async function getSessionContext(db, sessionId) {
 // src/mcp/index.ts
 var db = getDb();
 var server = new McpServer({ name: "logs", version: "0.3.0" });
+var _logsAgents = new Map;
 function applyBrief(rows, brief = true) {
   if (!brief)
     return rows;
@@ -24027,6 +24029,7 @@ var TOOLS = {
   log_summary: { desc: "Error/warn counts by service", params: "(project_id?, since?)" },
   log_context: { desc: "All logs for a trace_id", params: "(trace_id, brief?=true)" },
   log_context_from_id: { desc: "Trace context from a log ID (no trace_id needed)", params: "(log_id, brief?=true)" },
+  log_export: { desc: "Export matching logs as JSON or CSV", params: "(project_id?, format?='json', since?, until?, level?, service?, limit?=100000)" },
   log_diagnose: { desc: "Full diagnosis: score, top errors, failing pages, perf regressions", params: "(project_id, since?='24h', include?=['top_errors','error_rate','failing_pages','perf'])" },
   log_compare: { desc: "Diff two time windows for new/resolved errors", params: "(project_id, a_since, a_until, b_since, b_until)" },
   log_session_context: { desc: "Logs + session metadata for a session_id", params: "(session_id, brief?=true)" },
@@ -24041,6 +24044,7 @@ var TOOLS = {
   list_alert_rules: { desc: "List alert rules", params: "(project_id?)" },
   delete_alert_rule: { desc: "Delete alert rule", params: "(id)" },
   get_health: { desc: "Server health + DB stats", params: "()" },
+  log_stats: { desc: "Aggregate DB-level log statistics for a project", params: "(project_id?)" },
   search_tools: { desc: "Search tools by keyword \u2014 returns names, descriptions, param signatures", params: "(query)" },
   describe_tools: { desc: "List all tools with descriptions and param signatures", params: "()" }
 };
@@ -24296,7 +24300,7 @@ registerTool("delete_alert_rule", { id: exports_external.string() }, ({ id }) =>
 registerTool("get_health", {}, () => ({
   content: [{ type: "text", text: JSON.stringify(getHealth(db)) }]
 }));
-server.tool("log_stats", {
+registerTool("log_stats", {
   project_id: exports_external.string().optional().describe("Project name or ID (scope stats to a project)")
 }, (args) => {
   const projectId = rp(args.project_id);
@@ -24333,5 +24337,43 @@ server.tool("send_feedback", "Send feedback about this service", {
     return { content: [{ type: "text", text: String(e) }], isError: true };
   }
 });
+server.tool("register_agent", "Register an agent session. Returns agent_id. Auto-triggers a heartbeat.", {
+  name: exports_external.string(),
+  session_id: exports_external.string().optional()
+}, async (params) => {
+  const existing = [..._logsAgents.values()].find((a) => a.name === params.name);
+  if (existing) {
+    existing.last_seen_at = new Date().toISOString();
+    if (params.session_id)
+      existing.session_id = params.session_id;
+    return { content: [{ type: "text", text: JSON.stringify(existing) }] };
+  }
+  const id = Math.random().toString(36).slice(2, 10);
+  const ag = { id, name: params.name, session_id: params.session_id, last_seen_at: new Date().toISOString() };
+  _logsAgents.set(id, ag);
+  return { content: [{ type: "text", text: JSON.stringify(ag) }] };
+});
+server.tool("heartbeat", "Update last_seen_at to signal agent is active.", {
+  agent_id: exports_external.string()
+}, async (params) => {
+  const ag = _logsAgents.get(params.agent_id);
+  if (!ag)
+    return { content: [{ type: "text", text: `Agent not found: ${params.agent_id}` }], isError: true };
+  ag.last_seen_at = new Date().toISOString();
+  return { content: [{ type: "text", text: JSON.stringify({ agent_id: ag.id, last_seen_at: ag.last_seen_at }) }] };
+});
+server.tool("set_focus", "Set active project context for this agent session.", {
+  agent_id: exports_external.string(),
+  project_id: exports_external.string().optional()
+}, async (params) => {
+  const ag = _logsAgents.get(params.agent_id);
+  if (!ag)
+    return { content: [{ type: "text", text: `Agent not found: ${params.agent_id}` }], isError: true };
+  ag.project_id = params.project_id;
+  return { content: [{ type: "text", text: JSON.stringify({ agent_id: ag.id, project_id: ag.project_id ?? null }) }] };
+});
+server.tool("list_agents", "List all registered agents.", {}, async () => {
+  return { content: [{ type: "text", text: JSON.stringify([..._logsAgents.values()]) }] };
+});
 var transport = new StdioServerTransport;
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/logs",
-  "version": "0.3.14",
+  "version": "0.3.16",
   "description": "Log aggregation + browser script + headless page scanner + performance monitoring for AI agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,8 @@
     "dev": "bun run src/server/index.ts",
     "test": "bun test",
     "test:coverage": "bun test --coverage",
-    "lint": "biome check src/"
+    "lint": "biome check src/",
+    "postinstall": "mkdir -p $HOME/.hasna/logs 2>/dev/null || true"
   },
   "repository": {
     "type": "git",
@@ -55,4 +56,4 @@
     "@types/react": "^19.1.4",
     "typescript": "^5.9.3"
   }
-}
+}

package/src/db/pg-migrations.ts

@@ -0,0 +1,167 @@
+/**
+ * PostgreSQL migrations for open-logs cloud sync.
+ *
+ * Equivalent to the SQLite schema in index.ts + migrations/, translated for PostgreSQL.
+ */
+
+export const PG_MIGRATIONS: string[] = [
+  // Migration 1: projects table
+  `CREATE TABLE IF NOT EXISTS projects (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    name TEXT NOT NULL UNIQUE,
+    github_repo TEXT,
+    base_url TEXT,
+    description TEXT,
+    github_description TEXT,
+    github_branch TEXT,
+    github_sha TEXT,
+    last_synced_at TEXT,
+    max_rows INTEGER NOT NULL DEFAULT 100000,
+    debug_ttl_hours INTEGER NOT NULL DEFAULT 24,
+    info_ttl_hours INTEGER NOT NULL DEFAULT 168,
+    warn_ttl_hours INTEGER NOT NULL DEFAULT 720,
+    error_ttl_hours INTEGER NOT NULL DEFAULT 2160,
+    created_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+
+  // Migration 2: pages table
+  `CREATE TABLE IF NOT EXISTS pages (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+    url TEXT NOT NULL,
+    path TEXT NOT NULL DEFAULT '/',
+    name TEXT,
+    last_scanned_at TEXT,
+    created_at TEXT NOT NULL DEFAULT NOW()::text,
+    UNIQUE(project_id, url)
+  )`,
+
+  // Migration 3: logs table
+  `CREATE TABLE IF NOT EXISTS logs (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    timestamp TEXT NOT NULL DEFAULT NOW()::text,
+    project_id TEXT REFERENCES projects(id) ON DELETE SET NULL,
+    page_id TEXT REFERENCES pages(id) ON DELETE SET NULL,
+    level TEXT NOT NULL CHECK(level IN ('debug','info','warn','error','fatal')),
+    source TEXT NOT NULL DEFAULT 'sdk' CHECK(source IN ('sdk','script','scanner')),
+    service TEXT,
+    message TEXT NOT NULL,
+    trace_id TEXT,
+    session_id TEXT,
+    agent TEXT,
+    url TEXT,
+    stack_trace TEXT,
+    metadata TEXT
+  )`,
+
+  `CREATE INDEX IF NOT EXISTS idx_logs_project_level_ts ON logs(project_id, level, timestamp DESC)`,
+
+  `CREATE INDEX IF NOT EXISTS idx_logs_trace ON logs(trace_id)`,
+
+  `CREATE INDEX IF NOT EXISTS idx_logs_service ON logs(service)`,
+
+  `CREATE INDEX IF NOT EXISTS idx_logs_page ON logs(page_id)`,
+
+  `CREATE INDEX IF NOT EXISTS idx_logs_timestamp ON logs(timestamp DESC)`,
+
+  // Migration 4: scan_jobs table
+  `CREATE TABLE IF NOT EXISTS scan_jobs (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+    page_id TEXT REFERENCES pages(id) ON DELETE SET NULL,
+    schedule TEXT NOT NULL DEFAULT '*/30 * * * *',
+    enabled BOOLEAN NOT NULL DEFAULT TRUE,
+    last_run_at TEXT,
+    created_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+
+  // Migration 5: scan_runs table
+  `CREATE TABLE IF NOT EXISTS scan_runs (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    job_id TEXT NOT NULL REFERENCES scan_jobs(id) ON DELETE CASCADE,
+    page_id TEXT REFERENCES pages(id) ON DELETE SET NULL,
+    started_at TEXT NOT NULL DEFAULT NOW()::text,
+    finished_at TEXT,
+    status TEXT NOT NULL DEFAULT 'running' CHECK(status IN ('running','completed','failed')),
+    logs_collected INTEGER NOT NULL DEFAULT 0,
+    errors_found INTEGER NOT NULL DEFAULT 0,
+    perf_score REAL
+  )`,
+
+  // Migration 6: performance_snapshots table
+  `CREATE TABLE IF NOT EXISTS performance_snapshots (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    timestamp TEXT NOT NULL DEFAULT NOW()::text,
+    project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+    page_id TEXT REFERENCES pages(id) ON DELETE SET NULL,
+    url TEXT NOT NULL,
+    lcp REAL,
+    fcp REAL,
+    cls REAL,
+    tti REAL,
+    ttfb REAL,
+    score REAL,
+    raw_audit TEXT
+  )`,
+
+  `CREATE INDEX IF NOT EXISTS idx_perf_project_ts ON performance_snapshots(project_id, timestamp DESC)`,
+
+  `CREATE INDEX IF NOT EXISTS idx_perf_page ON performance_snapshots(page_id)`,
+
+  // Migration 7: alert_rules table
+  `CREATE TABLE IF NOT EXISTS alert_rules (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+    name TEXT NOT NULL,
+    service TEXT,
+    level TEXT NOT NULL DEFAULT 'error' CHECK(level IN ('debug','info','warn','error','fatal')),
+    threshold_count INTEGER NOT NULL DEFAULT 10,
+    window_seconds INTEGER NOT NULL DEFAULT 60,
+    action TEXT NOT NULL DEFAULT 'webhook' CHECK(action IN ('webhook','log')),
+    webhook_url TEXT,
+    enabled BOOLEAN NOT NULL DEFAULT TRUE,
+    last_fired_at TEXT,
+    created_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+
+  `CREATE INDEX IF NOT EXISTS idx_alert_rules_project ON alert_rules(project_id)`,
+
+  // Migration 8: issues table
+  `CREATE TABLE IF NOT EXISTS issues (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
+    fingerprint TEXT NOT NULL,
+    level TEXT NOT NULL,
+    service TEXT,
+    message_template TEXT NOT NULL,
+    first_seen TEXT NOT NULL DEFAULT NOW()::text,
+    last_seen TEXT NOT NULL DEFAULT NOW()::text,
+    count INTEGER NOT NULL DEFAULT 1,
+    status TEXT NOT NULL DEFAULT 'open' CHECK(status IN ('open','resolved','ignored')),
+    UNIQUE(project_id, fingerprint)
+  )`,
+
+  `CREATE INDEX IF NOT EXISTS idx_issues_project ON issues(project_id, status)`,
+
+  `CREATE INDEX IF NOT EXISTS idx_issues_fingerprint ON issues(fingerprint)`,
+
+  // Migration 9: page_auth table
+  `CREATE TABLE IF NOT EXISTS page_auth (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    page_id TEXT NOT NULL UNIQUE REFERENCES pages(id) ON DELETE CASCADE,
+    type TEXT NOT NULL CHECK(type IN ('cookie','bearer','basic')),
+    credentials TEXT NOT NULL,
+    created_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+
+  // Migration 10: feedback table
+  `CREATE TABLE IF NOT EXISTS feedback (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    message TEXT NOT NULL,
+    email TEXT,
+    category TEXT DEFAULT 'general',
+    version TEXT,
+    machine_id TEXT,
+    created_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+];

package/src/mcp/index.test.ts

@@ -18,7 +18,9 @@ test("logs MCP lists tools over stdio", async () => {
 
     expect(toolNames.length).toBeGreaterThan(0)
     expect(toolNames).toContain("get_health")
+    expect(toolNames).toContain("log_export")
     expect(toolNames).toContain("log_search")
+    expect(toolNames).toContain("log_stats")
   } finally {
     await client.close().catch(() => {})
   }

package/src/mcp/index.ts

@@ -23,6 +23,10 @@ import type { LogLevel, LogRow } from "../types/index.ts"
 const db = getDb()
 const server = new McpServer({ name: "logs", version: "0.3.0" })
 
+// --- in-memory agent registry ---
+interface _LogsAgent { id: string; name: string; session_id?: string; last_seen_at: string; project_id?: string }
+const _logsAgents = new Map<string, _LogsAgent>()
+
 const BRIEF_FIELDS: (keyof LogRow)[] = ["id", "timestamp", "level", "message", "service"]
 
 function applyBrief(rows: LogRow[], brief = true): unknown[] {
@@ -57,6 +61,7 @@ const TOOLS: Record<string, { desc: string; params: string }> = {
   log_summary:             { desc: "Error/warn counts by service", params: "(project_id?, since?)" },
   log_context:             { desc: "All logs for a trace_id", params: "(trace_id, brief?=true)" },
   log_context_from_id:     { desc: "Trace context from a log ID (no trace_id needed)", params: "(log_id, brief?=true)" },
+  log_export:              { desc: "Export matching logs as JSON or CSV", params: "(project_id?, format?='json', since?, until?, level?, service?, limit?=100000)" },
   log_diagnose:            { desc: "Full diagnosis: score, top errors, failing pages, perf regressions", params: "(project_id, since?='24h', include?=['top_errors','error_rate','failing_pages','perf'])" },
   log_compare:             { desc: "Diff two time windows for new/resolved errors", params: "(project_id, a_since, a_until, b_since, b_until)" },
   log_session_context:     { desc: "Logs + session metadata for a session_id", params: "(session_id, brief?=true)" },
@@ -71,6 +76,7 @@ const TOOLS: Record<string, { desc: string; params: string }> = {
   list_alert_rules:        { desc: "List alert rules", params: "(project_id?)" },
   delete_alert_rule:       { desc: "Delete alert rule", params: "(id)" },
   get_health:              { desc: "Server health + DB stats", params: "()" },
+  log_stats:               { desc: "Aggregate DB-level log statistics for a project", params: "(project_id?)" },
   search_tools:            { desc: "Search tools by keyword — returns names, descriptions, param signatures", params: "(query)" },
   describe_tools:          { desc: "List all tools with descriptions and param signatures", params: "()" },
 }
@@ -317,7 +323,7 @@ registerTool("get_health", {}, () => ({
   content: [{ type: "text", text: JSON.stringify(getHealth(db)) }]
 }))
 
-server.tool("log_stats", {
+registerTool("log_stats", {
   project_id: z.string().optional().describe("Project name or ID (scope stats to a project)"),
 }, (args) => {
   const projectId = rp(args.project_id)
@@ -359,5 +365,42 @@ server.tool(
   },
 )
 
+// --- Agent Tools ---
+
+server.tool("register_agent", "Register an agent session. Returns agent_id. Auto-triggers a heartbeat.", {
+  name: z.string(),
+  session_id: z.string().optional(),
+}, async (params) => {
+  const existing = [..._logsAgents.values()].find(a => a.name === params.name)
+  if (existing) { existing.last_seen_at = new Date().toISOString(); if (params.session_id) existing.session_id = params.session_id; return { content: [{ type: "text" as const, text: JSON.stringify(existing) }] } }
+  const id = Math.random().toString(36).slice(2, 10)
+  const ag: _LogsAgent = { id, name: params.name, session_id: params.session_id, last_seen_at: new Date().toISOString() }
+  _logsAgents.set(id, ag)
+  return { content: [{ type: "text" as const, text: JSON.stringify(ag) }] }
+})
+
+server.tool("heartbeat", "Update last_seen_at to signal agent is active.", {
+  agent_id: z.string(),
+}, async (params) => {
+  const ag = _logsAgents.get(params.agent_id)
+  if (!ag) return { content: [{ type: "text" as const, text: `Agent not found: ${params.agent_id}` }], isError: true }
+  ag.last_seen_at = new Date().toISOString()
+  return { content: [{ type: "text" as const, text: JSON.stringify({ agent_id: ag.id, last_seen_at: ag.last_seen_at }) }] }
+})
+
+server.tool("set_focus", "Set active project context for this agent session.", {
+  agent_id: z.string(),
+  project_id: z.string().optional(),
+}, async (params) => {
+  const ag = _logsAgents.get(params.agent_id)
+  if (!ag) return { content: [{ type: "text" as const, text: `Agent not found: ${params.agent_id}` }], isError: true }
+  ag.project_id = params.project_id
+  return { content: [{ type: "text" as const, text: JSON.stringify({ agent_id: ag.id, project_id: ag.project_id ?? null }) }] }
+})
+
+server.tool("list_agents", "List all registered agents.", {}, async () => {
+  return { content: [{ type: "text" as const, text: JSON.stringify([..._logsAgents.values()]) }] }
+})
+
 const transport = new StdioServerTransport()
 await server.connect(transport)