@hasna/logs 0.3.12 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/logs",
-  "version": "0.3.12",
+  "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/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,19 +187,19 @@ 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", {
+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)"),
@@ -198,7 +207,7 @@ server.tool("log_context_from_id", {
   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)"),
@@ -222,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(),
@@ -230,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(),
@@ -240,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)) }]
 }))