@fre4x/hn 1.0.50 → 1.0.53

package/dist/index.js

@@ -40847,6 +40847,250 @@ var ExperimentalMcpServerTasks = class {
   }
 };
 
+// ../node_modules/zod/index.js
+var zod_exports = {};
+__export(zod_exports, {
+  $brand: () => $brand,
+  $input: () => $input,
+  $output: () => $output,
+  NEVER: () => NEVER,
+  TimePrecision: () => TimePrecision,
+  ZodAny: () => ZodAny2,
+  ZodArray: () => ZodArray2,
+  ZodBase64: () => ZodBase64,
+  ZodBase64URL: () => ZodBase64URL,
+  ZodBigInt: () => ZodBigInt2,
+  ZodBigIntFormat: () => ZodBigIntFormat,
+  ZodBoolean: () => ZodBoolean2,
+  ZodCIDRv4: () => ZodCIDRv4,
+  ZodCIDRv6: () => ZodCIDRv6,
+  ZodCUID: () => ZodCUID,
+  ZodCUID2: () => ZodCUID2,
+  ZodCatch: () => ZodCatch2,
+  ZodCodec: () => ZodCodec,
+  ZodCustom: () => ZodCustom,
+  ZodCustomStringFormat: () => ZodCustomStringFormat,
+  ZodDate: () => ZodDate2,
+  ZodDefault: () => ZodDefault2,
+  ZodDiscriminatedUnion: () => ZodDiscriminatedUnion2,
+  ZodE164: () => ZodE164,
+  ZodEmail: () => ZodEmail,
+  ZodEmoji: () => ZodEmoji,
+  ZodEnum: () => ZodEnum2,
+  ZodError: () => ZodError2,
+  ZodExactOptional: () => ZodExactOptional,
+  ZodFile: () => ZodFile,
+  ZodFirstPartyTypeKind: () => ZodFirstPartyTypeKind2,
+  ZodFunction: () => ZodFunction2,
+  ZodGUID: () => ZodGUID,
+  ZodIPv4: () => ZodIPv4,
+  ZodIPv6: () => ZodIPv6,
+  ZodISODate: () => ZodISODate,
+  ZodISODateTime: () => ZodISODateTime,
+  ZodISODuration: () => ZodISODuration,
+  ZodISOTime: () => ZodISOTime,
+  ZodIntersection: () => ZodIntersection2,
+  ZodIssueCode: () => ZodIssueCode2,
+  ZodJWT: () => ZodJWT,
+  ZodKSUID: () => ZodKSUID,
+  ZodLazy: () => ZodLazy2,
+  ZodLiteral: () => ZodLiteral2,
+  ZodMAC: () => ZodMAC,
+  ZodMap: () => ZodMap2,
+  ZodNaN: () => ZodNaN2,
+  ZodNanoID: () => ZodNanoID,
+  ZodNever: () => ZodNever2,
+  ZodNonOptional: () => ZodNonOptional,
+  ZodNull: () => ZodNull2,
+  ZodNullable: () => ZodNullable2,
+  ZodNumber: () => ZodNumber2,
+  ZodNumberFormat: () => ZodNumberFormat,
+  ZodObject: () => ZodObject2,
+  ZodOptional: () => ZodOptional2,
+  ZodPipe: () => ZodPipe,
+  ZodPrefault: () => ZodPrefault,
+  ZodPromise: () => ZodPromise2,
+  ZodReadonly: () => ZodReadonly2,
+  ZodRealError: () => ZodRealError,
+  ZodRecord: () => ZodRecord2,
+  ZodSet: () => ZodSet2,
+  ZodString: () => ZodString2,
+  ZodStringFormat: () => ZodStringFormat,
+  ZodSuccess: () => ZodSuccess,
+  ZodSymbol: () => ZodSymbol2,
+  ZodTemplateLiteral: () => ZodTemplateLiteral,
+  ZodTransform: () => ZodTransform,
+  ZodTuple: () => ZodTuple2,
+  ZodType: () => ZodType2,
+  ZodULID: () => ZodULID,
+  ZodURL: () => ZodURL,
+  ZodUUID: () => ZodUUID,
+  ZodUndefined: () => ZodUndefined2,
+  ZodUnion: () => ZodUnion2,
+  ZodUnknown: () => ZodUnknown2,
+  ZodVoid: () => ZodVoid2,
+  ZodXID: () => ZodXID,
+  ZodXor: () => ZodXor,
+  _ZodString: () => _ZodString,
+  _default: () => _default2,
+  _function: () => _function,
+  any: () => any,
+  array: () => array,
+  base64: () => base642,
+  base64url: () => base64url2,
+  bigint: () => bigint2,
+  boolean: () => boolean2,
+  catch: () => _catch2,
+  check: () => check,
+  cidrv4: () => cidrv42,
+  cidrv6: () => cidrv62,
+  clone: () => clone,
+  codec: () => codec,
+  coerce: () => coerce_exports2,
+  config: () => config,
+  core: () => core_exports2,
+  cuid: () => cuid3,
+  cuid2: () => cuid22,
+  custom: () => custom,
+  date: () => date3,
+  decode: () => decode2,
+  decodeAsync: () => decodeAsync2,
+  default: () => zod_default,
+  describe: () => describe2,
+  discriminatedUnion: () => discriminatedUnion,
+  e164: () => e1642,
+  email: () => email2,
+  emoji: () => emoji2,
+  encode: () => encode2,
+  encodeAsync: () => encodeAsync2,
+  endsWith: () => _endsWith,
+  enum: () => _enum2,
+  exactOptional: () => exactOptional,
+  file: () => file,
+  flattenError: () => flattenError,
+  float32: () => float32,
+  float64: () => float64,
+  formatError: () => formatError,
+  fromJSONSchema: () => fromJSONSchema,
+  function: () => _function,
+  getErrorMap: () => getErrorMap2,
+  globalRegistry: () => globalRegistry,
+  gt: () => _gt,
+  gte: () => _gte,
+  guid: () => guid2,
+  hash: () => hash,
+  hex: () => hex2,
+  hostname: () => hostname2,
+  httpUrl: () => httpUrl,
+  includes: () => _includes,
+  instanceof: () => _instanceof,
+  int: () => int,
+  int32: () => int32,
+  int64: () => int64,
+  intersection: () => intersection,
+  ipv4: () => ipv42,
+  ipv6: () => ipv62,
+  iso: () => iso_exports2,
+  json: () => json,
+  jwt: () => jwt,
+  keyof: () => keyof,
+  ksuid: () => ksuid2,
+  lazy: () => lazy,
+  length: () => _length,
+  literal: () => literal,
+  locales: () => locales_exports,
+  looseObject: () => looseObject,
+  looseRecord: () => looseRecord,
+  lowercase: () => _lowercase,
+  lt: () => _lt,
+  lte: () => _lte,
+  mac: () => mac2,
+  map: () => map,
+  maxLength: () => _maxLength,
+  maxSize: () => _maxSize,
+  meta: () => meta2,
+  mime: () => _mime,
+  minLength: () => _minLength,
+  minSize: () => _minSize,
+  multipleOf: () => _multipleOf,
+  nan: () => nan,
+  nanoid: () => nanoid2,
+  nativeEnum: () => nativeEnum,
+  negative: () => _negative,
+  never: () => never,
+  nonnegative: () => _nonnegative,
+  nonoptional: () => nonoptional,
+  nonpositive: () => _nonpositive,
+  normalize: () => _normalize,
+  null: () => _null3,
+  nullable: () => nullable,
+  nullish: () => nullish2,
+  number: () => number2,
+  object: () => object2,
+  optional: () => optional,
+  overwrite: () => _overwrite,
+  parse: () => parse2,
+  parseAsync: () => parseAsync2,
+  partialRecord: () => partialRecord,
+  pipe: () => pipe,
+  positive: () => _positive,
+  prefault: () => prefault,
+  preprocess: () => preprocess,
+  prettifyError: () => prettifyError,
+  promise: () => promise,
+  property: () => _property,
+  readonly: () => readonly,
+  record: () => record,
+  refine: () => refine,
+  regex: () => _regex,
+  regexes: () => regexes_exports,
+  registry: () => registry,
+  safeDecode: () => safeDecode2,
+  safeDecodeAsync: () => safeDecodeAsync2,
+  safeEncode: () => safeEncode2,
+  safeEncodeAsync: () => safeEncodeAsync2,
+  safeParse: () => safeParse3,
+  safeParseAsync: () => safeParseAsync3,
+  set: () => set,
+  setErrorMap: () => setErrorMap,
+  size: () => _size,
+  slugify: () => _slugify,
+  startsWith: () => _startsWith,
+  strictObject: () => strictObject,
+  string: () => string2,
+  stringFormat: () => stringFormat,
+  stringbool: () => stringbool,
+  success: () => success,
+  superRefine: () => superRefine,
+  symbol: () => symbol,
+  templateLiteral: () => templateLiteral,
+  toJSONSchema: () => toJSONSchema,
+  toLowerCase: () => _toLowerCase,
+  toUpperCase: () => _toUpperCase,
+  transform: () => transform,
+  treeifyError: () => treeifyError,
+  trim: () => _trim,
+  tuple: () => tuple,
+  uint32: () => uint32,
+  uint64: () => uint64,
+  ulid: () => ulid2,
+  undefined: () => _undefined3,
+  union: () => union,
+  unknown: () => unknown,
+  uppercase: () => _uppercase,
+  url: () => url,
+  util: () => util_exports,
+  uuid: () => uuid2,
+  uuidv4: () => uuidv4,
+  uuidv6: () => uuidv6,
+  uuidv7: () => uuidv7,
+  void: () => _void2,
+  xid: () => xid2,
+  xor: () => xor,
+  z: () => external_exports3
+});
+var zod_default = external_exports3;
+
 // ../node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
 var McpServer = class {
   constructor(serverInfo, options) {
@@ -41725,6 +41969,71 @@ var StdioServerTransport = class {
   }
 };
 
+// ../packages/shared/dist/errors.js
+function createInternalError(error48) {
+  const message = error48 instanceof Error ? error48.message : String(error48);
+  return {
+    isError: true,
+    content: [
+      {
+        type: "text",
+        text: `Internal Error: ${message}
+
+Suggestion: If the problem persists, check server logs.`
+      }
+    ]
+  };
+}
+
+// ../packages/shared/dist/format.js
+function formatListItems(items, renderer, emptyMessage = "_No results found._") {
+  if (items.length === 0)
+    return emptyMessage;
+  return items.map((item, i) => renderer(item, i)).join("\n\n");
+}
+function formatField(label, value) {
+  if (value === null || value === void 0 || value === "")
+    return "";
+  return `**${label}:** ${value}`;
+}
+function formatFields(fields) {
+  return fields.map(([label, value]) => formatField(label, value)).filter(Boolean).join("  \n");
+}
+function formatPaginationFooter(offset, limit, total) {
+  const start = offset + 1;
+  const end = Math.min(offset + limit, total);
+  return `
+---
+_Showing ${start}\u2013${end} of ${total}. Use \`offset: ${offset + limit}\` for the next page._`;
+}
+
+// ../packages/shared/dist/pagination.js
+var z2 = external_exports3 || zod_default || zod_exports;
+var paginationSchema = z2.object({
+  limit: z2.number().int().min(1).max(100).default(20).describe("Maximum results to return (1\u2013100, default 20)"),
+  offset: z2.number().int().min(0).default(0).describe("Number of results to skip for pagination (default 0)")
+});
+function applyPagination(items, params) {
+  const { limit, offset } = params;
+  const total = items.length;
+  const sliced = items.slice(offset, offset + limit);
+  return {
+    items: sliced,
+    total,
+    offset,
+    limit,
+    hasMore: offset + limit < total
+  };
+}
+
+// ../packages/shared/dist/package.js
+import { createRequire as createJsonRequire } from "node:module";
+function getPackageVersion(moduleUrl) {
+  const require2 = createJsonRequire(moduleUrl);
+  const packageJson = require2("../package.json");
+  return packageJson.version ?? "0.0.0";
+}
+
 // src/api.ts
 import https2 from "node:https";
 
@@ -45505,6 +45814,46 @@ var {
   mergeConfig: mergeConfig2
 } = axios_default;
 
+// src/mock.ts
+function isMock() {
+  return process.env.MOCK === "true" || process.env.HN_MOCK === "true";
+}
+var MOCK_ITEM = {
+  id: 1001,
+  type: "story",
+  by: "fre4x",
+  time: 1712232e3,
+  title: "Mock HN Story",
+  url: "https://example.com/mock-hn-story",
+  score: 42,
+  descendants: 7,
+  kids: [1002, 1003],
+  text: "Mock story content for offline development."
+};
+var MOCK_USER = {
+  id: "fre4x",
+  created: 16e8,
+  karma: 1337,
+  about: "Mock Hacker News user for MCP development.",
+  submitted: [1001, 1002, 1003]
+};
+var MOCK_UPDATES = {
+  items: [1003, 1002, 1001],
+  profiles: ["fre4x", "b1te"]
+};
+var MOCK_FIXTURES = {
+  item: MOCK_ITEM,
+  user: MOCK_USER,
+  maxItem: 1003,
+  topStories: [1003, 1002, 1001],
+  newStories: [1003, 1002, 1001],
+  bestStories: [1001, 1003, 1002],
+  askStories: [2003, 2002, 2001],
+  showStories: [3003, 3002, 3001],
+  jobStories: [4003, 4002, 4001],
+  updates: MOCK_UPDATES
+};
+
 // src/api.ts
 var BASE_URL = "https://hacker-news.firebaseio.com/v0";
 var httpClient = axios_default.create({
@@ -45541,36 +45890,69 @@ var HNApiClient = class {
     return response.data;
   }
   async getItem(id) {
+    if (isMock()) {
+      return { ...MOCK_FIXTURES.item, id };
+    }
     const response = await httpClient.get(`/item/${id}.json`);
     return response.data;
   }
   async getUser(id) {
+    if (isMock()) {
+      return { ...MOCK_FIXTURES.user, id };
+    }
     const response = await httpClient.get(`/user/${id}.json`);
     return response.data;
   }
   async getMaxItem() {
+    if (isMock()) {
+      return MOCK_FIXTURES.maxItem;
+    }
     const response = await httpClient.get(`/maxitem.json`);
     return response.data;
   }
   async getTopStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.topStories];
+    }
     return this.fetchWithCache(`/topstories`);
   }
   async getNewStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.newStories];
+    }
     return this.fetchWithCache(`/newstories`);
   }
   async getBestStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.bestStories];
+    }
     return this.fetchWithCache(`/beststories`);
   }
   async getAskStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.askStories];
+    }
     return this.fetchWithCache(`/askstories`);
   }
   async getShowStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.showStories];
+    }
     return this.fetchWithCache(`/showstories`);
   }
   async getJobStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.jobStories];
+    }
     return this.fetchWithCache(`/jobstories`);
   }
   async getUpdates() {
+    if (isMock()) {
+      return {
+        items: [...MOCK_FIXTURES.updates.items],
+        profiles: [...MOCK_FIXTURES.updates.profiles]
+      };
+    }
     const response = await httpClient.get(`/updates.json`);
     return response.data;
   }
@@ -45586,24 +45968,30 @@ var CHARACTER_LIMIT = 12e3;
 
 // src/index.ts
 var api = new HNApiClient();
+var PACKAGE_VERSION = getPackageVersion(import.meta.url);
 var server = new McpServer({
   name: "hackernews-mcp-server",
-  version: "1.0.0"
+  version: PACKAGE_VERSION
 });
 function formatItemMarkdown(item) {
   if (!item) return "Item not found.";
   const lines = [];
-  if (item.title) lines.push(`# ${item.title}`);
-  if (item.by) lines.push(`**By**: ${item.by}`);
-  if (item.time)
-    lines.push(`**Time**: ${new Date(item.time * 1e3).toLocaleString()}`);
-  if (item.score !== void 0) lines.push(`**Score**: ${item.score}`);
-  if (item.url) lines.push(`**URL**: ${item.url}`);
+  if (item.title) lines.push(`# ${item.title}
+`);
+  lines.push(
+    formatFields([
+      ["By", item.by],
+      [
+        "Time",
+        item.time ? new Date(item.time * 1e3).toLocaleString() : void 0
+      ],
+      ["Score", item.score],
+      ["URL", item.url],
+      ["Comments", item.descendants]
+    ])
+  );
   if (item.text) lines.push(`
 ${item.text}`);
-  if (item.descendants !== void 0)
-    lines.push(`
-**Comments**: ${item.descendants}`);
   if (item.kids && item.kids.length > 0) {
     lines.push(`
 **Kids/Replies**: ${item.kids.join(", ")}`);
@@ -45617,27 +46005,24 @@ function handleLimit(content, format) {
 
 > [!NOTE]
 > Content truncated due to size limit. Use pagination (limit/offset) to fetch specific parts if applicable.`;
-  } else {
-    return JSON.stringify({
-      content: content.substring(0, CHARACTER_LIMIT),
-      truncated: true,
-      hint: "Content truncated due to size limit. Use limit/offset for lists."
-    });
   }
+  return JSON.stringify({
+    content: content.substring(0, CHARACTER_LIMIT),
+    truncated: true,
+    hint: "Content truncated due to size limit. Use limit/offset for lists."
+  });
 }
-var storySchema = {
-  limit: external_exports3.number().int().min(1).max(500).default(20).describe("Number of stories to return"),
-  offset: external_exports3.number().int().min(0).default(0).describe("Offset for pagination"),
+var storySchema = paginationSchema.extend({
   response_format: external_exports3.enum(Object.values(ResponseFormat)).default("markdown" /* MARKDOWN */).describe("Output format (markdown or json)")
-};
-async function handleStories(ids, params) {
-  const paginatedIds = ids.slice(params.offset, params.offset + params.limit);
+});
+async function handleHNStories(ids, params) {
+  const paginated = applyPagination(ids, params);
   const result = {
-    total: ids.length,
-    count: paginatedIds.length,
-    offset: params.offset,
-    items: paginatedIds,
-    has_more: ids.length > params.offset + params.limit
+    total: paginated.total,
+    count: paginated.items.length,
+    offset: paginated.offset,
+    items: paginated.items,
+    has_more: paginated.hasMore
   };
   if (params.response_format === "json" /* JSON */) {
     return {
@@ -45655,13 +46040,14 @@ async function handleStories(ids, params) {
   }
   const markdown = `# Hacker News Stories
 
-Showing ${paginatedIds.length} of ${ids.length} stories (Offset: ${params.offset})
-
-` + paginatedIds.map(
-    (id, i) => `${i + 1 + params.offset}. [${id}](https://news.ycombinator.com/item?id=${id})`
-  ).join("\n") + (result.has_more ? `
-
-*More stories available. Use offset=${params.offset + params.limit}*` : "");
+` + formatListItems(
+    paginated.items,
+    (id, i) => `${i + 1 + paginated.offset}. [${id}](https://news.ycombinator.com/item?id=${id})`
+  ) + (paginated.hasMore ? formatPaginationFooter(
+    paginated.offset,
+    paginated.limit,
+    paginated.total
+  ) : "");
   return {
     content: [
       {
@@ -45671,89 +46057,174 @@ Showing ${paginatedIds.length} of ${ids.length} stories (Offset: ${params.offset
     ]
   };
 }
+async function handleHNGetTopStories(params) {
+  try {
+    return await handleHNStories(await api.getTopStories(), params);
+  } catch (error48) {
+    return createInternalError(error48);
+  }
+}
+async function handleHNGetItem(params) {
+  try {
+    const item = await api.getItem(params.id);
+    if (params.response_format === "json" /* JSON */) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: handleLimit(
+              JSON.stringify(item, null, 2),
+              "json" /* JSON */
+            )
+          }
+        ],
+        structuredContent: item
+      };
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: handleLimit(
+            formatItemMarkdown(item),
+            "markdown" /* MARKDOWN */
+          )
+        }
+      ]
+    };
+  } catch (error48) {
+    return createInternalError(error48);
+  }
+}
 server.registerTool(
   "hn_get_top_stories",
   {
     title: "Get Top Stories",
     description: "Retrieve IDs of the current top stories on Hacker News.",
-    inputSchema: external_exports3.object(storySchema),
+    inputSchema: storySchema,
     annotations: {
       readOnlyHint: true,
       idempotentHint: true,
       openWorldHint: true
     }
   },
-  async (params) => handleStories(await api.getTopStories(), params)
+  // @ts-expect-error
+  handleHNGetTopStories
 );
 server.registerTool(
   "hn_get_new_stories",
   {
     title: "Get New Stories",
     description: "Retrieve IDs of the newest stories on Hacker News.",
-    inputSchema: external_exports3.object(storySchema),
+    inputSchema: storySchema,
     annotations: {
       readOnlyHint: true,
       idempotentHint: true,
       openWorldHint: true
     }
   },
-  async (params) => handleStories(await api.getNewStories(), params)
+  async (params) => {
+    try {
+      return await handleHNStories(
+        await api.getNewStories(),
+        params
+      );
+    } catch (error48) {
+      return createInternalError(error48);
+    }
+  }
 );
 server.registerTool(
   "hn_get_best_stories",
   {
     title: "Get Best Stories",
     description: "Retrieve IDs of the best stories on Hacker News.",
-    inputSchema: external_exports3.object(storySchema),
+    inputSchema: storySchema,
     annotations: {
       readOnlyHint: true,
       idempotentHint: true,
       openWorldHint: true
     }
   },
-  async (params) => handleStories(await api.getBestStories(), params)
+  async (params) => {
+    try {
+      return await handleHNStories(
+        await api.getBestStories(),
+        params
+      );
+    } catch (error48) {
+      return createInternalError(error48);
+    }
+  }
 );
 server.registerTool(
   "hn_get_ask_stories",
   {
     title: "Get Ask HN Stories",
     description: "Retrieve IDs of the latest Ask HN stories.",
-    inputSchema: external_exports3.object(storySchema),
+    inputSchema: storySchema,
     annotations: {
       readOnlyHint: true,
       idempotentHint: true,
       openWorldHint: true
     }
   },
-  async (params) => handleStories(await api.getAskStories(), params)
+  async (params) => {
+    try {
+      return await handleHNStories(
+        await api.getAskStories(),
+        params
+      );
+    } catch (error48) {
+      return createInternalError(error48);
+    }
+  }
 );
 server.registerTool(
   "hn_get_show_stories",
   {
     title: "Get Show HN Stories",
     description: "Retrieve IDs of the latest Show HN stories.",
-    inputSchema: external_exports3.object(storySchema),
+    inputSchema: storySchema,
     annotations: {
       readOnlyHint: true,
       idempotentHint: true,
       openWorldHint: true
     }
   },
-  async (params) => handleStories(await api.getShowStories(), params)
+  async (params) => {
+    try {
+      return await handleHNStories(
+        await api.getShowStories(),
+        params
+      );
+    } catch (error48) {
+      return createInternalError(error48);
+    }
+  }
 );
 server.registerTool(
   "hn_get_job_stories",
   {
     title: "Get Job Stories",
     description: "Retrieve IDs of the latest Job stories.",
-    inputSchema: external_exports3.object(storySchema),
+    inputSchema: storySchema,
     annotations: {
       readOnlyHint: true,
       idempotentHint: true,
       openWorldHint: true
     }
   },
-  async (params) => handleStories(await api.getJobStories(), params)
+  async (params) => {
+    try {
+      return await handleHNStories(
+        await api.getJobStories(),
+        params
+      );
+    } catch (error48) {
+      return createInternalError(error48);
+    }
+  }
 );
 server.registerTool(
   "hn_get_item",
@@ -45770,34 +46241,8 @@ server.registerTool(
       openWorldHint: true
     }
   },
-  async (params) => {
-    const item = await api.getItem(params.id);
-    if (params.response_format === "json" /* JSON */) {
-      return {
-        content: [
-          {
-            type: "text",
-            text: handleLimit(
-              JSON.stringify(item, null, 2),
-              "json" /* JSON */
-            )
-          }
-        ],
-        structuredContent: item
-      };
-    }
-    return {
-      content: [
-        {
-          type: "text",
-          text: handleLimit(
-            formatItemMarkdown(item),
-            "markdown" /* MARKDOWN */
-          )
-        }
-      ]
-    };
-  }
+  // @ts-expect-error
+  handleHNGetItem
 );
 server.registerTool(
   "hn_get_user",
@@ -45815,43 +46260,48 @@ server.registerTool(
     }
   },
   async (params) => {
-    const user = await api.getUser(params.id);
-    if (params.response_format === "json" /* JSON */) {
+    try {
+      const user = await api.getUser(params.id);
+      if (params.response_format === "json" /* JSON */) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: handleLimit(
+                JSON.stringify(user, null, 2),
+                "json" /* JSON */
+              )
+            }
+          ],
+          structuredContent: user
+        };
+      }
+      const lines = [
+        `# User: ${user.id}
+`,
+        formatFields([
+          ["Karma", user.karma],
+          ["Created", new Date(user.created * 1e3).toLocaleString()],
+          ["Submitted Items Count", user.submitted?.length]
+        ])
+      ];
+      if (user.about) lines.push(`
+**About**:
+${user.about}`);
       return {
         content: [
           {
             type: "text",
             text: handleLimit(
-              JSON.stringify(user, null, 2),
-              "json" /* JSON */
+              lines.join("\n"),
+              "markdown" /* MARKDOWN */
             )
           }
-        ],
-        structuredContent: user
+        ]
       };
+    } catch (error48) {
+      return createInternalError(error48);
     }
-    const lines = [
-      `# User: ${user.id}`,
-      `**Karma**: ${user.karma}`,
-      `**Created**: ${new Date(user.created * 1e3).toLocaleString()}`
-    ];
-    if (user.about) lines.push(`
-**About**:
-${user.about}`);
-    if (user.submitted)
-      lines.push(`
-**Submitted Items Count**: ${user.submitted.length}`);
-    return {
-      content: [
-        {
-          type: "text",
-          text: handleLimit(
-            lines.join("\n"),
-            "markdown" /* MARKDOWN */
-          )
-        }
-      ]
-    };
   }
 );
 server.registerTool(
@@ -45859,9 +46309,7 @@ server.registerTool(
   {
     title: "Get Updates",
     description: "Retrieve recently updated item and profile IDs.",
-    inputSchema: external_exports3.object({
-      response_format: external_exports3.enum(Object.values(ResponseFormat)).default("markdown" /* MARKDOWN */)
-    }),
+    inputSchema: storySchema,
     annotations: {
       readOnlyHint: true,
       idempotentHint: true,
@@ -45869,34 +46317,68 @@ server.registerTool(
     }
   },
   async (params) => {
-    const updates = await api.getUpdates();
-    if (params.response_format === "json" /* JSON */) {
+    try {
+      const updates = await api.getUpdates();
+      const paginatedItems = applyPagination(updates.items, params);
+      const paginatedProfiles = applyPagination(updates.profiles, params);
+      if (params.response_format === "json" /* JSON */) {
+        const result = {
+          items: {
+            total: paginatedItems.total,
+            count: paginatedItems.items.length,
+            offset: paginatedItems.offset,
+            data: paginatedItems.items,
+            has_more: paginatedItems.hasMore
+          },
+          profiles: {
+            total: paginatedProfiles.total,
+            count: paginatedProfiles.items.length,
+            offset: paginatedProfiles.offset,
+            data: paginatedProfiles.items,
+            has_more: paginatedProfiles.hasMore
+          }
+        };
+        return {
+          content: [
+            {
+              type: "text",
+              text: handleLimit(
+                JSON.stringify(result, null, 2),
+                "json" /* JSON */
+              )
+            }
+          ],
+          structuredContent: result
+        };
+      }
+      let markdown = "# HN Recent Updates\n\n";
+      markdown += "## Items\n" + formatListItems(
+        paginatedItems.items,
+        (id) => `- [${id}](https://news.ycombinator.com/item?id=${id})`
+      ) + (paginatedItems.hasMore ? formatPaginationFooter(
+        paginatedItems.offset,
+        paginatedItems.limit,
+        paginatedItems.total
+      ) : "") + "\n\n";
+      markdown += "## Profiles\n" + formatListItems(
+        paginatedProfiles.items,
+        (profile) => `- [${profile}](https://news.ycombinator.com/user?id=${profile})`
+      ) + (paginatedProfiles.hasMore ? formatPaginationFooter(
+        paginatedProfiles.offset,
+        paginatedProfiles.limit,
+        paginatedProfiles.total
+      ) : "");
       return {
         content: [
           {
             type: "text",
-            text: handleLimit(
-              JSON.stringify(updates, null, 2),
-              "json" /* JSON */
-            )
+            text: handleLimit(markdown, "markdown" /* MARKDOWN */)
           }
-        ],
-        structuredContent: updates
+        ]
       };
+    } catch (error48) {
+      return createInternalError(error48);
     }
-    const markdown = `# HN Recent Updates
-
-**Items**: ${updates.items.slice(0, 50).join(", ")}${updates.items.length > 50 ? "..." : ""}
-
-**Profiles**: ${updates.profiles.slice(0, 50).join(", ")}${updates.profiles.length > 50 ? "..." : ""}`;
-    return {
-      content: [
-        {
-          type: "text",
-          text: handleLimit(markdown, "markdown" /* MARKDOWN */)
-        }
-      ]
-    };
   }
 );
 server.registerTool(
@@ -45912,16 +46394,20 @@ server.registerTool(
     }
   },
   async () => {
-    const maxId = await api.getMaxItem();
-    return {
-      content: [
-        {
-          type: "text",
-          text: `Current Max Item ID: ${maxId}
+    try {
+      const maxId = await api.getMaxItem();
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Current Max Item ID: ${maxId}
 URL: https://news.ycombinator.com/item?id=${maxId}`
-        }
-      ]
-    };
+          }
+        ]
+      };
+    } catch (error48) {
+      return createInternalError(error48);
+    }
   }
 );
 async function run() {
@@ -45929,10 +46415,18 @@ async function run() {
   await server.connect(transport);
   console.error("Hacker News MCP server running via stdio");
 }
-run().catch((error48) => {
-  console.error("Fatal error:", error48);
-  process.exit(1);
-});
+if (process.env.NODE_ENV !== "test") {
+  run().catch((error48) => {
+    console.error("Fatal error:", error48);
+    process.exit(1);
+  });
+}
+export {
+  handleHNGetItem,
+  handleHNGetTopStories,
+  handleHNStories,
+  server
+};
 /*! Bundled license information:
 
 mime-db/index.js:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fre4x/hn",
-  "version": "1.0.50",
+  "version": "1.0.53",
   "description": "A Hacker News MCP server for LLMs.",
   "type": "module",
   "main": "dist/index.js",
@@ -11,7 +11,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && npx esbuild src/index.ts --bundle --outfile=dist/index.js --platform=node --format=esm --banner:js=\"import{createRequire}from'module';const require=createRequire(import.meta.url);\" && node -e \"const fs=require('fs');const p='dist/index.js';const c=fs.readFileSync(p,'utf8');const next=c.startsWith('#!/usr/bin/env node')?c:'#!/usr/bin/env node\\n'+c;fs.writeFileSync(p,next);fs.chmodSync(p,0o755);\"",
+    "build": "node ../scripts/build-package.mjs",
     "typecheck": "cross-env NODE_OPTIONS=--max-old-space-size=4096 tsc --noEmit",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
@@ -28,12 +28,12 @@
   "author": "fritzprix",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "axios": "^1.13.5",
-    "zod": "^4.0.0"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.3.5",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"