@tool-bridge/server 0.21.1 → 0.22.1

package/dist/v2ex-4TVRNMLS.js

@@ -0,0 +1,667 @@
+import {
+  createAuthedClient
+} from "./chunk-RTW5VRTK.js";
+import "./chunk-BNMLA2RC.js";
+import {
+  asJsonObject,
+  trimmedText
+} from "./chunk-JXHMDBAY.js";
+import {
+  createProviderPlugin,
+  requireApiKey,
+  upstreamError
+} from "./chunk-X7ZUTKHR.js";
+import "./chunk-7ISGFRC6.js";
+import "./chunk-UY6ANCOY.js";
+import {
+  TBError
+} from "./chunk-HA4BGL6C.js";
+import "./chunk-U67V476Y.js";
+
+// ../plugins/src/v2ex/api.ts
+var SERVICE = "v2ex";
+var API_BASE = "https://www.v2ex.com/api/v2";
+var LEGACY_API_BASE = "https://www.v2ex.com/api";
+var REQUEST_TIMEOUT_MS = 3e4;
+function invalidResponse(message) {
+  return new TBError("unavailable", message, { retryable: true });
+}
+function requireRecord(value, label) {
+  const result = asJsonObject(value);
+  if (result === void 0) throw invalidResponse(`${label} must be an object`);
+  return result;
+}
+function errorMessage(payload) {
+  if (typeof payload === "string") return trimmedText(payload);
+  const body = asJsonObject(payload);
+  if (body === void 0) return void 0;
+  const direct = trimmedText(body.message) ?? trimmedText(body.error);
+  if (direct !== void 0) return direct;
+  if (Array.isArray(body.errors)) {
+    for (const item of body.errors) {
+      const detail = trimmedText(asJsonObject(item)?.detail) ?? trimmedText(asJsonObject(item)?.message);
+      if (detail !== void 0) return detail;
+    }
+  }
+  return void 0;
+}
+function envelopeError(payload) {
+  return new TBError("invalid_argument", errorMessage(payload) ?? "V2EX request failed");
+}
+var v2Http = createAuthedClient({
+  baseUrl: `${API_BASE}/`,
+  service: SERVICE,
+  auth: { kind: "bearer" },
+  headers: { accept: "application/json" },
+  mapError: ({ data, status }) => upstreamError(status, errorMessage(data) ?? "V2EX request failed")
+});
+var legacyHttp = createAuthedClient({
+  baseUrl: `${LEGACY_API_BASE}/`,
+  service: SERVICE,
+  // legacy API **不带 Authorization** —— 上游这条路径压根不调 `buildV2exHeaders`,加上 Bearer
+  // 也没用。但仍然先 `requireApiKey`:上游整个 provider 的 authType 是 `api_key`,没配凭证时
+  // 连 context 都建不起来,这两个 action 一样调不通。这里保留那道闸 —— 否则"配了才能用"
+  // 会因为迁移悄悄变成"这两个不用配",挂载语义就不一致了。
+  auth: {
+    kind: "custom",
+    headers: (ctx) => {
+      requireApiKey(ctx, SERVICE);
+      return {};
+    }
+  },
+  headers: { accept: "application/json" },
+  mapError: ({ data, status }) => upstreamError(status, errorMessage(data) ?? "V2EX request failed")
+});
+async function send(client, ctx, request2, label) {
+  const response = await client.request(ctx, {
+    ...request2,
+    timeoutMs: REQUEST_TIMEOUT_MS,
+    invalidJson: "text",
+    mapTransportError: ({ kind, message }) => kind === "timeout" ? upstreamError(504, `${label} request timed out after ${REQUEST_TIMEOUT_MS / 1e3} seconds`) : upstreamError(502, message === void 0 ? `${label} request failed` : `${label} request failed: ${message}`)
+  });
+  return response.bodyKind === "empty" ? null : response.data;
+}
+async function request(ctx, options) {
+  return send(v2Http, ctx, {
+    method: options.method,
+    path: options.path,
+    // 上游连**空串**也当作"没给",不只是 undefined/null。
+    query: Object.entries(options.query ?? {}).filter(([, value]) => value !== void 0 && value !== ""),
+    ...options.body === void 0 ? {} : { json: options.body }
+  }, `V2EX ${options.path}`);
+}
+async function legacyRequest(ctx, path) {
+  const payload = await send(
+    legacyHttp,
+    ctx,
+    { method: "GET", path },
+    `V2EX legacy ${path}`
+  );
+  if (!Array.isArray(payload)) {
+    throw invalidResponse(`V2EX legacy ${path} response must be an array`);
+  }
+  return payload;
+}
+function unwrapEnvelope(payload, label) {
+  const envelope = requireRecord(payload, `V2EX ${label} response`);
+  if (envelope.success === false) throw envelopeError(envelope);
+  if (!("result" in envelope)) {
+    throw invalidResponse(`V2EX ${label} response missing result`);
+  }
+  return { message: trimmedText(envelope.message), result: envelope.result };
+}
+function ensureAccepted(payload, label) {
+  if (payload === null) return;
+  const envelope = requireRecord(payload, `V2EX ${label} response`);
+  if (envelope.success === false) throw envelopeError(envelope);
+  if (envelope.success === true) return;
+  throw invalidResponse(`V2EX ${label} response missing success=true`);
+}
+function objectResult(envelope, label) {
+  return requireRecord(envelope.result, `V2EX ${label} result`);
+}
+function arrayResult(envelope, label) {
+  if (!Array.isArray(envelope.result)) {
+    throw invalidResponse(`V2EX ${label} result must be an array`);
+  }
+  return envelope.result;
+}
+function parseTotal(message, result) {
+  if (message !== void 0) {
+    const slashIndex = message.indexOf("/");
+    if (slashIndex >= 0) {
+      const parsed = Number.parseInt(message.slice(slashIndex + 1), 10);
+      if (Number.isInteger(parsed) && parsed >= 0) return parsed;
+    }
+  }
+  return Array.isArray(result) ? result.length : 0;
+}
+async function listNotifications(input, ctx) {
+  const envelope = unwrapEnvelope(
+    await request(ctx, { method: "GET", path: "/notifications", query: { p: input.p } }),
+    "notifications"
+  );
+  return {
+    notifications: arrayResult(envelope, "notifications"),
+    total: parseTotal(envelope.message, envelope.result)
+  };
+}
+async function deleteNotification(input, ctx) {
+  const payload = await request(ctx, {
+    method: "DELETE",
+    path: `/notifications/${input.notification_id}`
+  });
+  ensureAccepted(payload, "notification deletion");
+  return { success: true };
+}
+async function listHotTopics(_input, ctx) {
+  return { topics: await legacyRequest(ctx, "/topics/hot.json") };
+}
+async function listLatestTopics(_input, ctx) {
+  return { topics: await legacyRequest(ctx, "/topics/latest.json") };
+}
+async function getCurrentMember(_input, ctx) {
+  const envelope = unwrapEnvelope(await request(ctx, { method: "GET", path: "/member" }), "member");
+  return { member: objectResult(envelope, "member") };
+}
+async function getCurrentToken(_input, ctx) {
+  const envelope = unwrapEnvelope(await request(ctx, { method: "GET", path: "/token" }), "token");
+  return { token: objectResult(envelope, "token") };
+}
+async function createToken(input, ctx) {
+  const envelope = unwrapEnvelope(
+    await request(ctx, {
+      method: "POST",
+      path: "/tokens",
+      body: { scope: input.scope, expiration: input.expiration }
+    }),
+    "token creation"
+  );
+  const token = trimmedText(objectResult(envelope, "token creation").token);
+  if (token === void 0) {
+    throw invalidResponse("V2EX token creation response missing token");
+  }
+  return { token };
+}
+async function getNode(input, ctx) {
+  const envelope = unwrapEnvelope(
+    await request(ctx, { method: "GET", path: `/nodes/${encodeURIComponent(input.node_name)}` }),
+    "node"
+  );
+  return { node: objectResult(envelope, "node") };
+}
+async function listNodeTopics(input, ctx) {
+  const envelope = unwrapEnvelope(
+    await request(ctx, {
+      method: "GET",
+      path: `/nodes/${encodeURIComponent(input.node_name)}/topics`,
+      query: { p: input.p }
+    }),
+    "topics"
+  );
+  return { topics: arrayResult(envelope, "topics") };
+}
+async function getTopic(input, ctx) {
+  const envelope = unwrapEnvelope(
+    await request(ctx, { method: "GET", path: `/topics/${input.topic_id}` }),
+    "topic"
+  );
+  return { topic: objectResult(envelope, "topic") };
+}
+async function listTopicReplies(input, ctx) {
+  const envelope = unwrapEnvelope(
+    await request(ctx, {
+      method: "GET",
+      path: `/topics/${input.topic_id}/replies`,
+      query: { p: input.p }
+    }),
+    "replies"
+  );
+  return { replies: arrayResult(envelope, "replies") };
+}
+async function setTopicSticky(input, ctx) {
+  const payload = await request(ctx, {
+    method: "POST",
+    path: `/topics/${input.topic_id}/set-sticky`,
+    query: { duration: input.duration }
+  });
+  ensureAccepted(payload, "topic sticky");
+  return { success: true };
+}
+async function boostTopic(input, ctx) {
+  const payload = await request(ctx, { method: "POST", path: `/topics/${input.topic_id}/boost` });
+  ensureAccepted(payload, "topic boost");
+  return { success: true };
+}
+
+// ../plugins/src/v2ex/schema.ts
+import { z } from "zod/v4";
+var listNotificationsInput = z.strictObject({
+  p: z.int().min(1).describe("Optional page number to request. Defaults to 1.").optional()
+}).describe("Input parameters for fetching V2EX notifications.");
+var listNotificationsOutput = z.strictObject({
+  notifications: z.array(z.looseObject({
+    id: z.int().describe("The V2EX notification identifier.").optional(),
+    member_id: z.int().describe("The member identifier that triggered the notification.").optional(),
+    for_member_id: z.int().describe("The member identifier that received the notification.").optional(),
+    text: z.string().describe("The notification text.").optional(),
+    payload: z.string().describe("The notification payload string.").nullable().optional(),
+    payload_rendered: z.string().describe("The rendered notification payload.").optional(),
+    created: z.int().describe("The Unix timestamp when the notification was created.").optional(),
+    member: z.looseObject({}).describe("The member object associated with the notification.").optional()
+  }).describe("A V2EX notification object.")).describe("The notifications returned for this page."),
+  total: z.int().describe("The total notification count parsed from the V2EX pagination message.")
+}).describe("The V2EX notifications response.");
+var deleteNotificationInput = z.strictObject({
+  notification_id: z.int().min(1).describe("The V2EX numeric identifier.")
+}).describe("Input parameters for deleting a V2EX notification.");
+var deleteNotificationOutput = z.strictObject({
+  success: z.boolean().describe("Whether the V2EX request was accepted.")
+}).describe("The empty response returned after V2EX accepts the request.");
+var listHotTopicsInput = z.strictObject({}).describe("Input parameters for fetching V2EX legacy hot topics.");
+var listHotTopicsOutput = z.strictObject({
+  topics: z.array(z.looseObject({
+    id: z.int().describe("The V2EX topic identifier.").optional(),
+    title: z.string().describe("The topic title.").optional(),
+    content: z.string().describe("The raw topic content.").optional(),
+    content_rendered: z.string().describe("The rendered topic content.").optional(),
+    url: z.url().describe("The V2EX URL for the topic.").optional(),
+    replies: z.int().describe("The number of replies on the topic.").optional(),
+    deleted: z.int().describe("Whether the topic has been deleted as returned by V2EX.").optional(),
+    last_reply_by: z.string().describe("The username of the latest reply author, or empty string.").optional(),
+    created: z.int().describe("The Unix timestamp when the topic was created.").optional(),
+    last_modified: z.int().describe("The Unix timestamp when the topic was last modified.").optional(),
+    last_touched: z.int().describe("The Unix timestamp when the topic was last touched.").optional(),
+    member: z.looseObject({
+      id: z.int().describe("The V2EX member identifier.").optional(),
+      username: z.string().describe("The V2EX username.").optional(),
+      url: z.url().describe("The V2EX URL for the member profile.").optional(),
+      website: z.string().describe("The member website URL, empty string, or null.").nullable().optional(),
+      twitter: z.string().describe("The member Twitter handle, empty string, or null.").nullable().optional(),
+      psn: z.string().describe("The member PlayStation Network handle, empty string, or null.").nullable().optional(),
+      github: z.string().describe("The member GitHub username, profile value, empty string, or null.").nullable().optional(),
+      btc: z.string().describe("The member Bitcoin address, empty string, or null.").nullable().optional(),
+      location: z.string().describe("The member location, empty string, or null.").nullable().optional(),
+      tagline: z.string().describe("The member tagline, empty string, or null.").nullable().optional(),
+      bio: z.string().describe("The member biography text, empty string, or null.").nullable().optional(),
+      avatar_mini: z.url().describe("The mini avatar URL.").optional(),
+      avatar_normal: z.url().describe("The normal avatar URL.").optional(),
+      avatar_large: z.url().describe("The large avatar URL.").optional(),
+      avatar_xlarge: z.url().describe("The extra-large avatar URL.").optional(),
+      avatar_xxlarge: z.url().describe("The double extra-large avatar URL.").optional(),
+      avatar_xxxlarge: z.url().describe("The triple extra-large avatar URL.").optional(),
+      created: z.int().describe("The Unix timestamp when the member account was created.").optional(),
+      last_modified: z.int().describe("The Unix timestamp when the member profile was last modified.").optional(),
+      pro: z.int().describe("Whether the member has V2EX Pro status as returned by V2EX.").optional()
+    }).describe("A member object returned by the V2EX legacy public API.").optional(),
+    node: z.looseObject({
+      id: z.int().describe("The V2EX node identifier.").optional(),
+      name: z.string().describe("The V2EX node name.").optional(),
+      url: z.url().describe("The V2EX URL for the node.").optional(),
+      title: z.string().describe("The human-readable node title.").optional(),
+      title_alternative: z.string().describe("The alternative node title.").optional(),
+      header: z.string().describe("The node header text.").optional(),
+      footer: z.string().describe("The node footer text.").optional(),
+      topics: z.int().describe("The number of topics in the node.").optional(),
+      avatar_mini: z.url().describe("The mini node avatar URL.").optional(),
+      avatar_normal: z.url().describe("The normal node avatar URL.").optional(),
+      avatar_large: z.url().describe("The large node avatar URL.").optional(),
+      stars: z.int().describe("The number of stars on the node.").optional(),
+      founder_id: z.int().describe("The member identifier of the node founder.").optional(),
+      aliases: z.array(z.string().describe("One node alias.")).describe("Alternative names for the node.").optional(),
+      root: z.boolean().describe("Whether this node is a root node.").optional(),
+      parent_node_name: z.string().describe("The parent node name, empty string, or null.").nullable().optional()
+    }).describe("A node object returned by the V2EX legacy public API.").optional()
+  }).describe("A topic object returned by the V2EX legacy public API.")).describe("The public topics returned by the V2EX legacy endpoint.")
+}).describe("The V2EX legacy public topic list response.");
+var listLatestTopicsInput = z.strictObject({}).describe("Input parameters for fetching V2EX legacy latest topics.");
+var listLatestTopicsOutput = z.strictObject({
+  topics: z.array(z.looseObject({
+    id: z.int().describe("The V2EX topic identifier.").optional(),
+    title: z.string().describe("The topic title.").optional(),
+    content: z.string().describe("The raw topic content.").optional(),
+    content_rendered: z.string().describe("The rendered topic content.").optional(),
+    url: z.url().describe("The V2EX URL for the topic.").optional(),
+    replies: z.int().describe("The number of replies on the topic.").optional(),
+    deleted: z.int().describe("Whether the topic has been deleted as returned by V2EX.").optional(),
+    last_reply_by: z.string().describe("The username of the latest reply author, or empty string.").optional(),
+    created: z.int().describe("The Unix timestamp when the topic was created.").optional(),
+    last_modified: z.int().describe("The Unix timestamp when the topic was last modified.").optional(),
+    last_touched: z.int().describe("The Unix timestamp when the topic was last touched.").optional(),
+    member: z.looseObject({
+      id: z.int().describe("The V2EX member identifier.").optional(),
+      username: z.string().describe("The V2EX username.").optional(),
+      url: z.url().describe("The V2EX URL for the member profile.").optional(),
+      website: z.string().describe("The member website URL, empty string, or null.").nullable().optional(),
+      twitter: z.string().describe("The member Twitter handle, empty string, or null.").nullable().optional(),
+      psn: z.string().describe("The member PlayStation Network handle, empty string, or null.").nullable().optional(),
+      github: z.string().describe("The member GitHub username, profile value, empty string, or null.").nullable().optional(),
+      btc: z.string().describe("The member Bitcoin address, empty string, or null.").nullable().optional(),
+      location: z.string().describe("The member location, empty string, or null.").nullable().optional(),
+      tagline: z.string().describe("The member tagline, empty string, or null.").nullable().optional(),
+      bio: z.string().describe("The member biography text, empty string, or null.").nullable().optional(),
+      avatar_mini: z.url().describe("The mini avatar URL.").optional(),
+      avatar_normal: z.url().describe("The normal avatar URL.").optional(),
+      avatar_large: z.url().describe("The large avatar URL.").optional(),
+      avatar_xlarge: z.url().describe("The extra-large avatar URL.").optional(),
+      avatar_xxlarge: z.url().describe("The double extra-large avatar URL.").optional(),
+      avatar_xxxlarge: z.url().describe("The triple extra-large avatar URL.").optional(),
+      created: z.int().describe("The Unix timestamp when the member account was created.").optional(),
+      last_modified: z.int().describe("The Unix timestamp when the member profile was last modified.").optional(),
+      pro: z.int().describe("Whether the member has V2EX Pro status as returned by V2EX.").optional()
+    }).describe("A member object returned by the V2EX legacy public API.").optional(),
+    node: z.looseObject({
+      id: z.int().describe("The V2EX node identifier.").optional(),
+      name: z.string().describe("The V2EX node name.").optional(),
+      url: z.url().describe("The V2EX URL for the node.").optional(),
+      title: z.string().describe("The human-readable node title.").optional(),
+      title_alternative: z.string().describe("The alternative node title.").optional(),
+      header: z.string().describe("The node header text.").optional(),
+      footer: z.string().describe("The node footer text.").optional(),
+      topics: z.int().describe("The number of topics in the node.").optional(),
+      avatar_mini: z.url().describe("The mini node avatar URL.").optional(),
+      avatar_normal: z.url().describe("The normal node avatar URL.").optional(),
+      avatar_large: z.url().describe("The large node avatar URL.").optional(),
+      stars: z.int().describe("The number of stars on the node.").optional(),
+      founder_id: z.int().describe("The member identifier of the node founder.").optional(),
+      aliases: z.array(z.string().describe("One node alias.")).describe("Alternative names for the node.").optional(),
+      root: z.boolean().describe("Whether this node is a root node.").optional(),
+      parent_node_name: z.string().describe("The parent node name, empty string, or null.").nullable().optional()
+    }).describe("A node object returned by the V2EX legacy public API.").optional()
+  }).describe("A topic object returned by the V2EX legacy public API.")).describe("The public topics returned by the V2EX legacy endpoint.")
+}).describe("The V2EX legacy public topic list response.");
+var getCurrentMemberInput = z.strictObject({}).describe("Input parameters for fetching the authenticated V2EX member.");
+var getCurrentMemberOutput = z.strictObject({
+  member: z.looseObject({
+    id: z.int().describe("The V2EX member identifier.").optional(),
+    username: z.string().describe("The V2EX username.").optional(),
+    url: z.url().describe("The V2EX URL for the member profile.").optional(),
+    website: z.string().describe("The member website URL or empty string.").optional(),
+    twitter: z.string().describe("The member Twitter handle or empty string.").optional(),
+    psn: z.string().describe("The member PlayStation Network handle or empty string.").optional(),
+    github: z.string().describe("The member GitHub username or profile value.").optional(),
+    btc: z.string().describe("The member Bitcoin address or empty string.").optional(),
+    location: z.string().describe("The member location or empty string.").optional(),
+    tagline: z.string().describe("The member tagline or empty string.").optional(),
+    bio: z.string().describe("The member biography text.").optional(),
+    avatar_mini: z.url().describe("The mini avatar URL.").optional(),
+    avatar_normal: z.url().describe("The normal avatar URL.").optional(),
+    avatar_large: z.url().describe("The large avatar URL.").optional(),
+    created: z.int().describe("The Unix timestamp when the member account was created.").optional(),
+    last_modified: z.int().describe("The Unix timestamp when the profile was last modified.").optional(),
+    pro: z.int().describe("Whether the member has V2EX Pro status as returned by V2EX.").optional()
+  }).describe("The authenticated V2EX member profile.")
+}).describe("The V2EX member profile response.");
+var getCurrentTokenInput = z.strictObject({}).describe("Input parameters for fetching current V2EX token metadata.");
+var getCurrentTokenOutput = z.strictObject({
+  token: z.looseObject({
+    token: z.string().describe("The token value as returned by V2EX. It may be masked after creation.").optional(),
+    scope: z.enum(["everything", "regular"]).describe("The token scope.").optional(),
+    expiration: z.int().describe("The token lifetime in seconds.").optional(),
+    good_for_days: z.int().describe("The remaining token lifetime in days.").optional(),
+    total_used: z.int().describe("The total number of times the token has been used.").optional(),
+    last_used: z.int().describe("The Unix timestamp when the token was last used.").optional(),
+    created: z.int().describe("The Unix timestamp when the token was created.").optional()
+  }).describe("Metadata for a V2EX Personal Access Token.")
+}).describe("The V2EX token metadata response.");
+var createTokenInput = z.strictObject({
+  scope: z.enum(["everything", "regular"]).describe("The access scope for the new V2EX token."),
+  expiration: z.union([z.literal(2592e3).describe("A 30-day token lifetime in seconds."), z.literal(5184e3).describe("A 60-day token lifetime in seconds."), z.literal(7776e3).describe("A 90-day token lifetime in seconds."), z.literal(15552e3).describe("A 180-day token lifetime in seconds.")]).describe("The token lifetime in seconds.")
+}).describe("Input parameters for creating a V2EX Personal Access Token.");
+var createTokenOutput = z.strictObject({
+  token: z.string().describe("The newly created Personal Access Token value.")
+}).describe("The V2EX token creation response.");
+var getNodeInput = z.strictObject({
+  node_name: z.string().min(1).describe("The V2EX node name, such as `python`.")
+}).describe("Input parameters for fetching a V2EX node.");
+var getNodeOutput = z.strictObject({
+  node: z.looseObject({
+    id: z.int().describe("The V2EX node identifier.").optional(),
+    founder_id: z.int().describe("The member identifier of the node founder.").optional(),
+    url: z.url().describe("The V2EX URL for the node.").optional(),
+    name: z.string().describe("The V2EX node name.").optional(),
+    title: z.string().describe("The human-readable node title.").optional(),
+    header: z.string().describe("The node header text.").optional(),
+    footer: z.string().describe("The node footer text.").optional(),
+    avatar: z.url().describe("The node avatar URL.").optional(),
+    topics: z.int().describe("The number of topics in the node.").optional(),
+    created: z.int().describe("The Unix timestamp when the node was created.").optional(),
+    last_modified: z.int().describe("The Unix timestamp when the node was last modified.").optional()
+  }).describe("A V2EX node object.")
+}).describe("The V2EX node response.");
+var listNodeTopicsInput = z.strictObject({
+  node_name: z.string().min(1).describe("The V2EX node name, such as `python`."),
+  p: z.int().min(1).describe("Optional page number to request. Defaults to 1.").optional()
+}).describe("Input parameters for fetching topics from a V2EX node.");
+var listNodeTopicsOutput = z.strictObject({
+  topics: z.array(z.looseObject({
+    id: z.int().describe("The V2EX topic identifier.").optional(),
+    title: z.string().describe("The topic title.").optional(),
+    content: z.string().describe("The raw topic content.").optional(),
+    content_rendered: z.string().describe("The rendered topic content.").optional(),
+    syntax: z.int().describe("The content syntax mode returned by V2EX.").optional(),
+    url: z.url().describe("The V2EX URL for the topic.").optional(),
+    replies: z.int().describe("The number of replies on the topic.").optional(),
+    stars: z.int().describe("The number of stars on the topic.").optional(),
+    thanks: z.int().describe("The number of thanks on the topic.").optional(),
+    last_reply_by: z.string().describe("The username of the latest reply author, or empty string.").optional(),
+    created: z.int().describe("The Unix timestamp when the topic was created.").optional(),
+    last_modified: z.int().describe("The Unix timestamp when the topic was last modified.").optional(),
+    last_touched: z.int().describe("The Unix timestamp when the topic was last touched.").optional(),
+    member: z.looseObject({
+      id: z.int().describe("The V2EX member identifier.").optional(),
+      username: z.string().describe("The V2EX username.").optional(),
+      bio: z.string().describe("The member biography text.").optional(),
+      website: z.string().describe("The member website URL or empty string.").optional(),
+      github: z.string().describe("The member GitHub username or profile value.").optional(),
+      url: z.url().describe("The V2EX URL for the member profile.").optional(),
+      avatar: z.url().describe("The member avatar URL.").optional(),
+      created: z.int().describe("The Unix timestamp when the member account was created.").optional(),
+      pro: z.int().describe("Whether the member has V2EX Pro status as returned by V2EX.").optional()
+    }).describe("A compact V2EX member object.").optional(),
+    node: z.looseObject({
+      id: z.int().describe("The V2EX node identifier.").optional(),
+      founder_id: z.int().describe("The member identifier of the node founder.").optional(),
+      url: z.url().describe("The V2EX URL for the node.").optional(),
+      name: z.string().describe("The V2EX node name.").optional(),
+      title: z.string().describe("The human-readable node title.").optional(),
+      header: z.string().describe("The node header text.").optional(),
+      footer: z.string().describe("The node footer text.").optional(),
+      avatar: z.url().describe("The node avatar URL.").optional(),
+      topics: z.int().describe("The number of topics in the node.").optional(),
+      created: z.int().describe("The Unix timestamp when the node was created.").optional(),
+      last_modified: z.int().describe("The Unix timestamp when the node was last modified.").optional()
+    }).describe("A V2EX node object.").optional(),
+    supplements: z.array(z.unknown().describe("One supplement.")).describe("Supplement objects attached to the topic.").optional()
+  }).describe("A V2EX topic object.")).describe("The topics returned for this node page.")
+}).describe("The V2EX node topics response.");
+var getTopicInput = z.strictObject({
+  topic_id: z.int().min(1).describe("The V2EX numeric identifier.")
+}).describe("Input parameters for fetching a V2EX topic.");
+var getTopicOutput = z.strictObject({
+  topic: z.looseObject({
+    id: z.int().describe("The V2EX topic identifier.").optional(),
+    title: z.string().describe("The topic title.").optional(),
+    content: z.string().describe("The raw topic content.").optional(),
+    content_rendered: z.string().describe("The rendered topic content.").optional(),
+    syntax: z.int().describe("The content syntax mode returned by V2EX.").optional(),
+    url: z.url().describe("The V2EX URL for the topic.").optional(),
+    replies: z.int().describe("The number of replies on the topic.").optional(),
+    stars: z.int().describe("The number of stars on the topic.").optional(),
+    thanks: z.int().describe("The number of thanks on the topic.").optional(),
+    last_reply_by: z.string().describe("The username of the latest reply author, or empty string.").optional(),
+    created: z.int().describe("The Unix timestamp when the topic was created.").optional(),
+    last_modified: z.int().describe("The Unix timestamp when the topic was last modified.").optional(),
+    last_touched: z.int().describe("The Unix timestamp when the topic was last touched.").optional(),
+    member: z.looseObject({
+      id: z.int().describe("The V2EX member identifier.").optional(),
+      username: z.string().describe("The V2EX username.").optional(),
+      bio: z.string().describe("The member biography text.").optional(),
+      website: z.string().describe("The member website URL or empty string.").optional(),
+      github: z.string().describe("The member GitHub username or profile value.").optional(),
+      url: z.url().describe("The V2EX URL for the member profile.").optional(),
+      avatar: z.url().describe("The member avatar URL.").optional(),
+      created: z.int().describe("The Unix timestamp when the member account was created.").optional(),
+      pro: z.int().describe("Whether the member has V2EX Pro status as returned by V2EX.").optional()
+    }).describe("A compact V2EX member object.").optional(),
+    node: z.looseObject({
+      id: z.int().describe("The V2EX node identifier.").optional(),
+      founder_id: z.int().describe("The member identifier of the node founder.").optional(),
+      url: z.url().describe("The V2EX URL for the node.").optional(),
+      name: z.string().describe("The V2EX node name.").optional(),
+      title: z.string().describe("The human-readable node title.").optional(),
+      header: z.string().describe("The node header text.").optional(),
+      footer: z.string().describe("The node footer text.").optional(),
+      avatar: z.url().describe("The node avatar URL.").optional(),
+      topics: z.int().describe("The number of topics in the node.").optional(),
+      created: z.int().describe("The Unix timestamp when the node was created.").optional(),
+      last_modified: z.int().describe("The Unix timestamp when the node was last modified.").optional()
+    }).describe("A V2EX node object.").optional(),
+    supplements: z.array(z.unknown().describe("One supplement.")).describe("Supplement objects attached to the topic.").optional()
+  }).describe("A V2EX topic object.")
+}).describe("The V2EX topic response.");
+var listTopicRepliesInput = z.strictObject({
+  topic_id: z.int().min(1).describe("The V2EX numeric identifier."),
+  p: z.int().min(1).describe("Optional page number to request. Defaults to 1.").optional()
+}).describe("Input parameters for fetching replies for a V2EX topic.");
+var listTopicRepliesOutput = z.strictObject({
+  replies: z.array(z.looseObject({
+    id: z.int().describe("The V2EX reply identifier.").optional(),
+    content: z.string().describe("The raw reply content.").optional(),
+    content_rendered: z.string().describe("The rendered reply content.").optional(),
+    created: z.int().describe("The Unix timestamp when the reply was created.").optional(),
+    member: z.looseObject({
+      id: z.int().describe("The V2EX member identifier.").optional(),
+      username: z.string().describe("The V2EX username.").optional(),
+      bio: z.string().describe("The member biography text.").optional(),
+      website: z.string().describe("The member website URL or empty string.").optional(),
+      github: z.string().describe("The member GitHub username or profile value.").optional(),
+      url: z.url().describe("The V2EX URL for the member profile.").optional(),
+      avatar: z.url().describe("The member avatar URL.").optional(),
+      created: z.int().describe("The Unix timestamp when the member account was created.").optional(),
+      pro: z.int().describe("Whether the member has V2EX Pro status as returned by V2EX.").optional()
+    }).describe("A compact V2EX member object.").optional()
+  }).describe("A V2EX topic reply object.")).describe("The replies returned for this topic page.")
+}).describe("The V2EX topic replies response.");
+var setTopicStickyInput = z.strictObject({
+  topic_id: z.int().min(1).describe("The V2EX numeric identifier."),
+  duration: z.enum(["15min", "1hr", "8hr"]).describe("Optional sticky duration. Defaults to 15min.").optional()
+}).describe("Input parameters for setting a V2EX topic as sticky.");
+var setTopicStickyOutput = z.strictObject({
+  success: z.boolean().describe("Whether the V2EX request was accepted.")
+}).describe("The empty response returned after V2EX accepts the request.");
+var boostTopicInput = z.strictObject({
+  topic_id: z.int().min(1).describe("The V2EX numeric identifier.")
+}).describe("Input parameters for boosting a V2EX topic.");
+var boostTopicOutput = z.strictObject({
+  success: z.boolean().describe("Whether the V2EX request was accepted.")
+}).describe("The empty response returned after V2EX accepts the request.");
+var v2exActions = {
+  list_notifications: {
+    description: "Fetch the latest V2EX notifications for the authenticated member.",
+    effect: "read",
+    inputSchema: listNotificationsInput,
+    outputSchema: z.toJSONSchema(listNotificationsOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_notification: {
+    description: "Delete one V2EX notification by its numeric identifier.",
+    effect: "destructive",
+    inputSchema: deleteNotificationInput,
+    outputSchema: z.toJSONSchema(deleteNotificationOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_hot_topics: {
+    description: "Fetch public hot topics from the V2EX legacy JSON API.",
+    effect: "read",
+    inputSchema: listHotTopicsInput,
+    outputSchema: z.toJSONSchema(listHotTopicsOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_latest_topics: {
+    description: "Fetch public latest topics from the V2EX legacy JSON API.",
+    effect: "read",
+    inputSchema: listLatestTopicsInput,
+    outputSchema: z.toJSONSchema(listLatestTopicsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_current_member: {
+    description: "Fetch the authenticated V2EX member profile.",
+    effect: "read",
+    inputSchema: getCurrentMemberInput,
+    outputSchema: z.toJSONSchema(getCurrentMemberOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_current_token: {
+    description: "Fetch metadata for the V2EX Personal Access Token used by this connection.",
+    effect: "read",
+    inputSchema: getCurrentTokenInput,
+    outputSchema: z.toJSONSchema(getCurrentTokenOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_token: {
+    description: "Create a new V2EX Personal Access Token from an existing token.",
+    effect: "write",
+    inputSchema: createTokenInput,
+    outputSchema: z.toJSONSchema(createTokenOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_node: {
+    description: "Fetch a V2EX node by node name.",
+    effect: "read",
+    inputSchema: getNodeInput,
+    outputSchema: z.toJSONSchema(getNodeOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_node_topics: {
+    description: "Fetch topics from a V2EX node.",
+    effect: "read",
+    inputSchema: listNodeTopicsInput,
+    outputSchema: z.toJSONSchema(listNodeTopicsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_topic: {
+    description: "Fetch a V2EX topic by numeric identifier.",
+    effect: "read",
+    inputSchema: getTopicInput,
+    outputSchema: z.toJSONSchema(getTopicOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_topic_replies: {
+    description: "Fetch replies for a V2EX topic.",
+    effect: "read",
+    inputSchema: listTopicRepliesInput,
+    outputSchema: z.toJSONSchema(listTopicRepliesOutput, { io: "output", unrepresentable: "any" })
+  },
+  set_topic_sticky: {
+    description: "Set one of the authenticated member's V2EX topics as sticky.",
+    effect: "write",
+    inputSchema: setTopicStickyInput,
+    outputSchema: z.toJSONSchema(setTopicStickyOutput, { io: "output", unrepresentable: "any" })
+  },
+  boost_topic: {
+    description: "Boost one of the authenticated member's V2EX topics to the homepage.",
+    effect: "write",
+    inputSchema: boostTopicInput,
+    outputSchema: z.toJSONSchema(boostTopicOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/v2ex/index.ts
+function createV2exPlugin() {
+  return createProviderPlugin({
+    description: "V2EX",
+    credentialProbe: "get_current_member",
+    actions: v2exActions,
+    handlers: {
+      list_notifications: listNotifications,
+      delete_notification: deleteNotification,
+      list_hot_topics: listHotTopics,
+      list_latest_topics: listLatestTopics,
+      get_current_member: getCurrentMember,
+      get_current_token: getCurrentToken,
+      create_token: createToken,
+      get_node: getNode,
+      list_node_topics: listNodeTopics,
+      get_topic: getTopic,
+      list_topic_replies: listTopicReplies,
+      set_topic_sticky: setTopicSticky,
+      boost_topic: boostTopic
+    }
+  });
+}
+var v2ex_default = createV2exPlugin();
+export {
+  createV2exPlugin,
+  v2ex_default as default
+};