@hasna/logs 0.3.11 → 0.3.13

package/LICENSE

@@ -0,0 +1,170 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship made available under
+the License, as indicated by a copyright notice that is included in
+or attached to the work (an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean, as submitted to the Licensor for inclusion
+in the Work by the copyright owner or by an individual or Legal Entity
+authorized to submit on behalf of the copyright owner. For the purposes
+of this definition, "submitted" means any form of electronic, verbal,
+or written communication sent to the Licensor or its representatives,
+including but not limited to communication on electronic mailing lists,
+source code control systems, and issue tracking systems that are managed
+by, or on behalf of, the Licensor for the purpose of recording and
+discussing the Work, but excluding communication that is conspicuously
+marked or designated in writing by the copyright owner as "Not a
+Contribution."
+
+"Contributor" shall mean Licensor and any Legal Entity on behalf of
+whom a Contribution has been received by the Licensor and included
+within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent contributions
+Licensors can make available under this License.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative Works
+a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+that You distribute, all copyright, patent, trademark, and
+attribution notices from the Source form of the Work,
+excluding those notices that do not pertain to any part of
+the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+distribution, You must include a readable copy of the attribution
+notices contained within such NOTICE file, in at least one
+of the following places: within a NOTICE text file distributed
+as part of the Derivative Works; within the Source form or
+documentation, if provided along with the Derivative Works; or,
+within a display generated by the Derivative Works, if and
+wherever such third-party notices normally appear. The contents
+of the NOTICE file are for informational purposes only and
+do not modify the License. You may add Your own attribution
+notices within Derivative Works that You distribute, alongside
+or as an addendum to the NOTICE text from the Work, provided
+that such additional attribution notices cannot be construed
+as modifying the License.
+
+You may add Your own license statement for Your modifications and
+may provide additional grant of rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or exemplary damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or all other
+commercial damages or losses), even if such Contributor has been
+advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may offer only
+conditions consistent with this License.
+
+END OF TERMS AND CONDITIONS
+
+Copyright 2024 hasna.com
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/dist/cli/index.js

@@ -20,7 +20,7 @@ import {
 import {
   searchLogs,
   tailLogs
-} from "../index-exeq2gs6.js";
+} from "../index-ww5ggfv3.js";
 import"../index-997bkzr2.js";
 import {
   __commonJS,
@@ -2323,7 +2323,7 @@ ${C.bold}Perf Regressions:${C.reset}`);
 });
 program2.command("watch").description("Stream new logs in real time with color coding").option("--project <name|id>", "Filter by project name or ID").option("--level <levels>", "Comma-separated levels (debug,info,warn,error,fatal)").option("--service <name>", "Filter by service name").option("--interval <ms>", "Poll interval in milliseconds (default: 500)", "500").option("--since <time>", "Start from this time (default: now)").action(async (opts) => {
   const db = getDb();
-  const { searchLogs: searchLogs2 } = await import("../query-6s5gqkck.js");
+  const { searchLogs: searchLogs2 } = await import("../query-7jwj05er.js");
   let projectId = opts.project;
   if (projectId) {
     const proj = db.query("SELECT id FROM projects WHERE id = ? OR name = ?").get(projectId, projectId);

package/dist/index-ww5ggfv3.js

@@ -0,0 +1,90 @@
+// @bun
+import {
+  parseTime
+} from "./index-997bkzr2.js";
+
+// src/lib/query.ts
+function searchLogs(db, q) {
+  const conditions = [];
+  const params = {};
+  if (q.project_id) {
+    conditions.push("l.project_id = $project_id");
+    params.$project_id = q.project_id;
+  }
+  if (q.page_id) {
+    conditions.push("l.page_id = $page_id");
+    params.$page_id = q.page_id;
+  }
+  if (q.service) {
+    conditions.push("l.service = $service");
+    params.$service = q.service;
+  }
+  if (q.trace_id) {
+    conditions.push("l.trace_id = $trace_id");
+    params.$trace_id = q.trace_id;
+  }
+  if (q.since) {
+    conditions.push("l.timestamp >= $since");
+    params.$since = parseTime(q.since) ?? q.since;
+  }
+  if (q.until) {
+    conditions.push("l.timestamp <= $until");
+    params.$until = parseTime(q.until) ?? q.until;
+  }
+  if (q.level) {
+    const levels = Array.isArray(q.level) ? q.level : [q.level];
+    const placeholders = levels.map((_, i) => `$level${i}`).join(",");
+    levels.forEach((lv, i) => {
+      params[`$level${i}`] = lv;
+    });
+    conditions.push(`l.level IN (${placeholders})`);
+  }
+  const limit = q.limit ?? 100;
+  const offset = q.offset ?? 0;
+  params.$limit = limit;
+  params.$offset = offset;
+  if (q.text) {
+    params.$text = q.text;
+    const where2 = conditions.length ? `WHERE ${conditions.join(" AND ")} AND` : "WHERE";
+    const sql2 = `
+      SELECT l.* FROM logs l
+      ${where2} l.rowid IN (SELECT rowid FROM logs_fts WHERE logs_fts MATCH $text)
+      ORDER BY l.timestamp DESC
+      LIMIT $limit OFFSET $offset
+    `;
+    return db.prepare(sql2).all(params);
+  }
+  const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
+  const sql = `SELECT * FROM logs l ${where} ORDER BY l.timestamp DESC LIMIT $limit OFFSET $offset`;
+  return db.prepare(sql).all(params);
+}
+function tailLogs(db, projectId, n = 50) {
+  if (projectId) {
+    return db.prepare("SELECT * FROM logs WHERE project_id = $p ORDER BY timestamp DESC LIMIT $n").all({ $p: projectId, $n: n });
+  }
+  return db.prepare("SELECT * FROM logs ORDER BY timestamp DESC LIMIT $n").all({ $n: n });
+}
+function getLogContext(db, traceId) {
+  return db.prepare("SELECT * FROM logs WHERE trace_id = $t ORDER BY timestamp ASC").all({ $t: traceId });
+}
+function getLogContextFromId(db, logId, window = 0) {
+  const log = db.prepare("SELECT * FROM logs WHERE id = $id").get({ $id: logId });
+  if (!log)
+    return [];
+  const trace = log.trace_id ? getLogContext(db, log.trace_id) : [log];
+  if (window <= 0)
+    return trace;
+  const before = db.prepare(`SELECT * FROM logs WHERE id != $id AND timestamp <= $ts ORDER BY timestamp DESC LIMIT $n`).all({ $id: logId, $ts: log.timestamp, $n: window });
+  const after = db.prepare(`SELECT * FROM logs WHERE id != $id AND timestamp > $ts ORDER BY timestamp ASC LIMIT $n`).all({ $id: logId, $ts: log.timestamp, $n: window });
+  const seen = new Set;
+  const merged = [];
+  for (const row of [...before.reverse(), ...trace, ...after]) {
+    if (!seen.has(row.id)) {
+      seen.add(row.id);
+      merged.push(row);
+    }
+  }
+  return merged.sort((a, b) => a.timestamp < b.timestamp ? -1 : a.timestamp > b.timestamp ? 1 : 0);
+}
+
+export { searchLogs, tailLogs, getLogContext, getLogContextFromId };

package/dist/mcp/index.js

@@ -34,7 +34,7 @@ import {
   getLogContextFromId,
   searchLogs,
   tailLogs
-} from "../index-exeq2gs6.js";
+} from "../index-ww5ggfv3.js";
 import {
   countLogs
 } from "../index-edn08m6f.js";
@@ -28660,9 +28660,10 @@ server.tool("log_context", {
 }));
 server.tool("log_context_from_id", {
   log_id: exports_external.string(),
-  brief: exports_external.boolean().optional()
-}, ({ log_id, brief }) => ({
-  content: [{ type: "text", text: JSON.stringify(applyBrief(getLogContextFromId(db, log_id), brief !== false)) }]
+  brief: exports_external.boolean().optional(),
+  window: exports_external.number().int().min(0).optional().describe("Return N logs before and after the target log's timestamp (in addition to trace context)")
+}, ({ log_id, brief, window }) => ({
+  content: [{ type: "text", text: JSON.stringify(applyBrief(getLogContextFromId(db, log_id, window ?? 0), brief !== false)) }]
 }));
 server.tool("log_export", {
   project_id: exports_external.string().optional().describe("Project name or ID"),

package/dist/query-7jwj05er.js

@@ -0,0 +1,15 @@
+// @bun
+import {
+  getLogContext,
+  getLogContextFromId,
+  searchLogs,
+  tailLogs
+} from "./index-ww5ggfv3.js";
+import"./index-997bkzr2.js";
+import"./index-re3ntm60.js";
+export {
+  tailLogs,
+  searchLogs,
+  getLogContextFromId,
+  getLogContext
+};

package/dist/server/index.js

@@ -42,7 +42,7 @@ import {
   getLogContext,
   searchLogs,
   tailLogs
-} from "../index-exeq2gs6.js";
+} from "../index-ww5ggfv3.js";
 import {
   countLogs
 } from "../index-edn08m6f.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/logs",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "Log aggregation + browser script + headless page scanner + performance monitoring for AI agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,8 +24,8 @@
     "url": "https://github.com/hasna/logs.git"
   },
   "publishConfig": {
-    "access": "restricted",
-    "registry": "https://registry.npmjs.org/"
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
   },
   "keywords": [
     "logs",
@@ -37,7 +37,7 @@
     "lighthouse"
   ],
   "author": "Andrei Hasna <andrei@hasna.com>",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
     "commander": "^14.0.0",

package/src/lib/query.ts

@@ -56,9 +56,29 @@ export function getLogContext(db: Database, traceId: string): LogRow[] {
     .all({ $t: traceId }) as LogRow[]
 }
 
-export function getLogContextFromId(db: Database, logId: string): LogRow[] {
+export function getLogContextFromId(db: Database, logId: string, window = 0): LogRow[] {
   const log = db.prepare("SELECT * FROM logs WHERE id = $id").get({ $id: logId }) as LogRow | null
   if (!log) return []
-  if (log.trace_id) return getLogContext(db, log.trace_id)
-  return [log]
+
+  // Get trace context (or just the log itself if no trace)
+  const trace: LogRow[] = log.trace_id ? getLogContext(db, log.trace_id) : [log]
+
+  if (window <= 0) return trace
+
+  // Fetch N rows before and after the target log's timestamp
+  const before = db.prepare(
+    `SELECT * FROM logs WHERE id != $id AND timestamp <= $ts ORDER BY timestamp DESC LIMIT $n`
+  ).all({ $id: logId, $ts: log.timestamp, $n: window }) as LogRow[]
+
+  const after = db.prepare(
+    `SELECT * FROM logs WHERE id != $id AND timestamp > $ts ORDER BY timestamp ASC LIMIT $n`
+  ).all({ $id: logId, $ts: log.timestamp, $n: window }) as LogRow[]
+
+  // Merge: before (oldest first) + trace + after, deduplicate by id
+  const seen = new Set<string>()
+  const merged: LogRow[] = []
+  for (const row of [...before.reverse(), ...trace, ...after]) {
+    if (!seen.has(row.id)) { seen.add(row.id); merged.push(row) }
+  }
+  return merged.sort((a, b) => a.timestamp < b.timestamp ? -1 : a.timestamp > b.timestamp ? 1 : 0)
 }

package/src/mcp/index.test.ts

@@ -0,0 +1,25 @@
+import { test, expect } from "bun:test"
+import { fileURLToPath } from "url"
+import { Client } from "@modelcontextprotocol/sdk/client/index.js"
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js"
+
+test("logs MCP lists tools over stdio", async () => {
+  const entry = fileURLToPath(new URL("./index.ts", import.meta.url))
+  const transport = new StdioClientTransport({
+    command: "bun",
+    args: ["run", entry],
+  })
+  const client = new Client({ name: "logs-mcp-test", version: "0.0.0" }, { capabilities: {} })
+
+  try {
+    await client.connect(transport)
+    const result = await client.listTools()
+    const toolNames = result.tools.map((tool) => tool.name)
+
+    expect(toolNames.length).toBeGreaterThan(0)
+    expect(toolNames).toContain("get_health")
+    expect(toolNames).toContain("log_search")
+  } finally {
+    await client.close().catch(() => {})
+  }
+})

package/src/mcp/index.ts

@@ -75,53 +75,62 @@ const TOOLS: Record<string, { desc: string; params: string }> = {
   describe_tools:          { desc: "List all tools with descriptions and param signatures", params: "()" },
 }
 
-server.tool("search_tools", { query: z.string() }, ({ query }) => {
+// Fellow agents: keep MCP registrations behind this helper so descriptions and schemas stay aligned with the current SDK.
+function registerTool(
+  name: keyof typeof TOOLS,
+  schema: Record<string, z.ZodTypeAny>,
+  handler: (...args: any[]) => any,
+) {
+  return server.tool(name, TOOLS[name].desc, schema, handler)
+}
+
+registerTool("search_tools", { query: z.string() }, ({ query }) => {
   const q = query.toLowerCase()
   const matches = Object.entries(TOOLS).filter(([k, v]) => k.includes(q) || v.desc.toLowerCase().includes(q))
   const text = matches.map(([k, v]) => `${k}${v.params} — ${v.desc}`).join("\n") || "No matches"
   return { content: [{ type: "text", text }] }
 })
 
-server.tool("describe_tools", {}, () => ({
+registerTool("describe_tools", {}, () => ({
   content: [{ type: "text", text: Object.entries(TOOLS).map(([k, v]) => `${k}${v.params} — ${v.desc}`).join("\n") }]
 }))
 
-server.tool("resolve_project", { name: z.string() }, ({ name }) => {
+registerTool("resolve_project", { name: z.string() }, ({ name }) => {
   const id = resolveProjectId(db, name)
   const project = id ? db.prepare("SELECT * FROM projects WHERE id = $id").get({ $id: id }) : null
   return { content: [{ type: "text", text: JSON.stringify(project ?? { error: `Project '${name}' not found` }) }] }
 })
 
-server.tool("register_project", {
+registerTool("register_project", {
   name: z.string(), github_repo: z.string().optional(), base_url: z.string().optional(), description: z.string().optional(),
 }, (args) => ({ content: [{ type: "text", text: JSON.stringify(createProject(db, args)) }] }))
 
-server.tool("register_page", {
+registerTool("register_page", {
   project_id: z.string(), url: z.string(), path: z.string().optional(), name: z.string().optional(),
 }, (args) => ({ content: [{ type: "text", text: JSON.stringify(createPage(db, { ...args, project_id: rp(args.project_id) ?? args.project_id })) }] }))
 
-server.tool("create_scan_job", {
+registerTool("create_scan_job", {
   project_id: z.string(), schedule: z.string(), page_id: z.string().optional(),
 }, (args) => ({ content: [{ type: "text", text: JSON.stringify(createJob(db, { ...args, project_id: rp(args.project_id) ?? args.project_id })) }] }))
 
-server.tool("log_push", {
+registerTool("log_push", {
   level: z.enum(["debug", "info", "warn", "error", "fatal"]),
   message: z.string(),
   project_id: z.string().optional(), service: z.string().optional(),
   trace_id: z.string().optional(), session_id: z.string().optional(),
   agent: z.string().optional(), url: z.string().optional(),
-  metadata: z.record(z.unknown()).optional(),
+  metadata: z.record(z.string(), z.unknown()).optional(),
 }, (args) => {
   const row = ingestLog(db, { ...args, project_id: rp(args.project_id) })
   return { content: [{ type: "text", text: `Logged: ${row.id}` }] }
 })
 
-server.tool("log_push_batch", {
+registerTool("log_push_batch", {
   entries: z.array(z.object({
     level: z.enum(["debug", "info", "warn", "error", "fatal"]),
     message: z.string(),
     project_id: z.string().optional(), service: z.string().optional(),
-    trace_id: z.string().optional(), metadata: z.record(z.unknown()).optional(),
+    trace_id: z.string().optional(), metadata: z.record(z.string(), z.unknown()).optional(),
   })),
   trace_id: z.string().optional().describe("Shared trace_id applied to all entries that don't have their own trace_id"),
   project_id: z.string().optional().describe("Shared project_id applied to all entries (individual entry project_id takes precedence)"),
@@ -134,7 +143,7 @@ server.tool("log_push_batch", {
   return { content: [{ type: "text", text: `Logged ${rows.length} entries${trace_id ? ` (trace: ${trace_id})` : ''}` }] }
 })
 
-server.tool("log_search", {
+registerTool("log_search", {
   project_id: z.string().optional(), page_id: z.string().optional(),
   level: z.string().optional(), service: z.string().optional(),
   since: z.string().optional(), until: z.string().optional(),
@@ -151,14 +160,14 @@ server.tool("log_search", {
   return { content: [{ type: "text", text: JSON.stringify(applyBrief(rows, args.brief !== false)) }] }
 })
 
-server.tool("log_tail", {
+registerTool("log_tail", {
   project_id: z.string().optional(), n: z.number().optional(), brief: z.boolean().optional(),
 }, ({ project_id, n, brief }) => {
   const rows = tailLogs(db, rp(project_id), n ?? 50)
   return { content: [{ type: "text", text: JSON.stringify(applyBrief(rows, brief !== false)) }] }
 })
 
-server.tool("log_count", {
+registerTool("log_count", {
   project_id: z.string().optional(), service: z.string().optional(),
   level: z.string().optional(), since: z.string().optional(), until: z.string().optional(),
   group_by: z.enum(["level", "service"]).optional().describe("Return breakdown by 'level' or 'service' in addition to totals"),
@@ -166,7 +175,7 @@ server.tool("log_count", {
   content: [{ type: "text", text: JSON.stringify(countLogs(db, { ...args, project_id: rp(args.project_id) })) }]
 }))
 
-server.tool("log_recent_errors", {
+registerTool("log_recent_errors", {
   project_id: z.string().optional(), since: z.string().optional(), limit: z.number().optional(),
 }, ({ project_id, since, limit }) => {
   const rows = searchLogs(db, {
@@ -178,25 +187,27 @@ server.tool("log_recent_errors", {
   return { content: [{ type: "text", text: JSON.stringify(applyBrief(rows, true)) }] }
 })
 
-server.tool("log_summary", {
+registerTool("log_summary", {
   project_id: z.string().optional(), since: z.string().optional(),
 }, ({ project_id, since }) => ({
   content: [{ type: "text", text: JSON.stringify(summarizeLogs(db, rp(project_id), parseTime(since) ?? since)) }]
 }))
 
-server.tool("log_context", {
+registerTool("log_context", {
   trace_id: z.string(), brief: z.boolean().optional(),
 }, ({ trace_id, brief }) => ({
   content: [{ type: "text", text: JSON.stringify(applyBrief(getLogContext(db, trace_id), brief !== false)) }]
 }))
 
-server.tool("log_context_from_id", {
-  log_id: z.string(), brief: z.boolean().optional(),
-}, ({ log_id, brief }) => ({
-  content: [{ type: "text", text: JSON.stringify(applyBrief(getLogContextFromId(db, log_id), brief !== false)) }]
+registerTool("log_context_from_id", {
+  log_id: z.string(),
+  brief: z.boolean().optional(),
+  window: z.number().int().min(0).optional().describe("Return N logs before and after the target log's timestamp (in addition to trace context)"),
+}, ({ log_id, brief, window }) => ({
+  content: [{ type: "text", text: JSON.stringify(applyBrief(getLogContextFromId(db, log_id, window ?? 0), brief !== false)) }]
 }))
 
-server.tool("log_export", {
+registerTool("log_export", {
   project_id: z.string().optional().describe("Project name or ID"),
   format: z.enum(["json", "csv"]).optional().default("json").describe("Output format"),
   since: z.string().optional().describe("Since time (1h, 24h, 7d, ISO)"),
@@ -220,7 +231,7 @@ server.tool("log_export", {
   return { content: [{ type: "text" as const, text: chunks.join("") }] }
 })
 
-server.tool("log_diagnose", {
+registerTool("log_diagnose", {
   project_id: z.string(),
   since: z.string().optional(),
   include: z.array(z.enum(["top_errors", "error_rate", "failing_pages", "perf"])).optional(),
@@ -228,7 +239,7 @@ server.tool("log_diagnose", {
   content: [{ type: "text", text: JSON.stringify(diagnose(db, rp(project_id) ?? project_id, since, include)) }]
 }))
 
-server.tool("log_compare", {
+registerTool("log_compare", {
   project_id: z.string(),
   a_since: z.string(), a_until: z.string(),
   b_since: z.string(), b_until: z.string(),
@@ -238,71 +249,71 @@ server.tool("log_compare", {
     parseTime(b_since) ?? b_since, parseTime(b_until) ?? b_until)) }]
 }))
 
-server.tool("log_session_context", {
+registerTool("log_session_context", {
   session_id: z.string(), brief: z.boolean().optional(),
 }, async ({ session_id, brief }) => {
   const ctx = await getSessionContext(db, session_id)
   return { content: [{ type: "text", text: JSON.stringify({ ...ctx, logs: applyBrief(ctx.logs, brief !== false) }) }] }
 })
 
-server.tool("perf_snapshot", {
+registerTool("perf_snapshot", {
   project_id: z.string(), page_id: z.string().optional(),
 }, ({ project_id, page_id }) => {
   const snap = getLatestSnapshot(db, rp(project_id) ?? project_id, page_id)
   return { content: [{ type: "text", text: JSON.stringify(snap ? { ...snap, label: scoreLabel(snap.score) } : null) }] }
 })
 
-server.tool("perf_trend", {
+registerTool("perf_trend", {
   project_id: z.string(), page_id: z.string().optional(), since: z.string().optional(), limit: z.number().optional(),
 }, ({ project_id, page_id, since, limit }) => ({
   content: [{ type: "text", text: JSON.stringify(getPerfTrend(db, rp(project_id) ?? project_id, page_id, parseTime(since) ?? since, limit ?? 50)) }]
 }))
 
-server.tool("scan_status", {
+registerTool("scan_status", {
   project_id: z.string().optional(),
 }, ({ project_id }) => ({
   content: [{ type: "text", text: JSON.stringify(listJobs(db, rp(project_id))) }]
 }))
 
-server.tool("list_projects", {}, () => ({
+registerTool("list_projects", {}, () => ({
   content: [{ type: "text", text: JSON.stringify(listProjects(db)) }]
 }))
 
-server.tool("list_pages", { project_id: z.string() }, ({ project_id }) => ({
+registerTool("list_pages", { project_id: z.string() }, ({ project_id }) => ({
   content: [{ type: "text", text: JSON.stringify(listPages(db, rp(project_id) ?? project_id)) }]
 }))
 
-server.tool("list_issues", {
+registerTool("list_issues", {
   project_id: z.string().optional(), status: z.string().optional(), limit: z.number().optional(),
 }, ({ project_id, status, limit }) => ({
   content: [{ type: "text", text: JSON.stringify(listIssues(db, rp(project_id), status, limit ?? 50)) }]
 }))
 
-server.tool("resolve_issue", {
+registerTool("resolve_issue", {
   id: z.string(), status: z.enum(["open", "resolved", "ignored"]),
 }, ({ id, status }) => ({
   content: [{ type: "text", text: JSON.stringify(updateIssueStatus(db, id, status)) }]
 }))
 
-server.tool("create_alert_rule", {
+registerTool("create_alert_rule", {
   project_id: z.string(), name: z.string(),
   level: z.string().optional(), service: z.string().optional(),
   threshold_count: z.number().optional(), window_seconds: z.number().optional(),
   action: z.enum(["webhook", "log"]).optional(), webhook_url: z.string().optional(),
 }, (args) => ({ content: [{ type: "text", text: JSON.stringify(createAlertRule(db, { ...args, project_id: rp(args.project_id) ?? args.project_id })) }] }))
 
-server.tool("list_alert_rules", {
+registerTool("list_alert_rules", {
   project_id: z.string().optional(),
 }, ({ project_id }) => ({
   content: [{ type: "text", text: JSON.stringify(listAlertRules(db, rp(project_id))) }]
 }))
 
-server.tool("delete_alert_rule", { id: z.string() }, ({ id }) => {
+registerTool("delete_alert_rule", { id: z.string() }, ({ id }) => {
   deleteAlertRule(db, id)
   return { content: [{ type: "text", text: "deleted" }] }
 })
 
-server.tool("get_health", {}, () => ({
+registerTool("get_health", {}, () => ({
   content: [{ type: "text", text: JSON.stringify(getHealth(db)) }]
 }))