@tool-bridge/server 0.1.1 → 0.3.0

package/dist/unsplash-EDPTNEHJ.js

@@ -0,0 +1,364 @@
+import {
+  createProviderPlugin,
+  guardedFetch,
+  requireApiKey,
+  upstreamError
+} from "./chunk-CSJEZHQO.js";
+import "./chunk-K7FVSFUX.js";
+import {
+  TBError,
+  external_exports
+} from "./chunk-JLTYA2B3.js";
+import "./chunk-MLKGABMK.js";
+
+// ../plugins/src/unsplash/api.ts
+var SERVICE = "unsplash";
+var API_BASE = "https://api.unsplash.com";
+function text(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function numeric(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function requireRecord(value, label) {
+  const result = record(value);
+  if (result === void 0) {
+    throw new TBError("unavailable", `${label}\u4E0D\u662F\u5BF9\u8C61`, { retryable: true });
+  }
+  return result;
+}
+function objectArray(value) {
+  if (!Array.isArray(value)) {
+    throw new TBError("unavailable", "Unsplash \u54CD\u5E94\u4E0D\u662F\u6570\u7EC4", { retryable: true });
+  }
+  return value.map((item) => requireRecord(item, "Unsplash \u6570\u7EC4\u5143\u7D20"));
+}
+function requireText(value, field) {
+  const result = text(value);
+  if (result === void 0) throw new TBError("invalid_argument", `${field} \u4E0D\u80FD\u662F\u7A7A\u767D`);
+  return result;
+}
+function csv(value) {
+  if (value === void 0) return void 0;
+  const items = value.map((item) => text(item)).filter((item) => item !== void 0);
+  return items.length > 0 ? items.join(",") : void 0;
+}
+function buildUrl(path, query) {
+  const url = new URL(`${API_BASE}${path}`);
+  for (const [key, value] of Object.entries(query)) {
+    if (value !== void 0) url.searchParams.set(key, String(value));
+  }
+  return url.toString();
+}
+function errorMessage(payload) {
+  const body = record(payload);
+  if (body === void 0) return void 0;
+  if (Array.isArray(body.errors)) {
+    for (const item of body.errors) {
+      const message = text(item);
+      if (message !== void 0) return message;
+    }
+  }
+  return text(body.error) ?? text(body.message);
+}
+async function request(ctx, path, query = {}) {
+  const response = await guardedFetch(buildUrl(path, query), {
+    method: "GET",
+    headers: {
+      "accept": "application/json",
+      // Unsplash 自有的方案名,不是 Bearer。
+      "authorization": `Client-ID ${requireApiKey(ctx, SERVICE)}`,
+      "accept-version": "v1"
+    }
+  });
+  const body = await response.text();
+  let payload = null;
+  if (body !== "") {
+    try {
+      payload = JSON.parse(body);
+    } catch {
+      if (response.ok) {
+        throw new TBError("unavailable", "Unsplash \u8FD4\u56DE\u4E86\u975E JSON \u54CD\u5E94", { retryable: true });
+      }
+    }
+  }
+  if (!response.ok) {
+    throw upstreamError(response.status, errorMessage(payload) ?? `Unsplash \u8FD4\u56DE HTTP ${response.status}`);
+  }
+  return payload;
+}
+async function listPhotos(input, ctx) {
+  const payload = await request(ctx, "/photos", {
+    page: input.page,
+    per_page: input.perPage,
+    order_by: input.orderBy
+  });
+  return { photos: objectArray(payload) };
+}
+async function searchPhotos(input, ctx) {
+  const payload = await request(ctx, "/search/photos", {
+    // 参数名是 `query`,不是各家搜索 API 常见的 `q`。
+    query: requireText(input.query, "query"),
+    page: input.page,
+    per_page: input.perPage,
+    order_by: input.orderBy,
+    color: input.color,
+    orientation: input.orientation,
+    content_filter: input.contentFilter,
+    collections: csv(input.collections)
+  });
+  const result = requireRecord(payload, "Unsplash \u641C\u7D22\u54CD\u5E94");
+  return {
+    total: numeric(result.total) ?? 0,
+    totalPages: numeric(result.total_pages) ?? 0,
+    results: objectArray(result.results)
+  };
+}
+async function getPhoto(input, ctx) {
+  const id = requireText(input.id, "id");
+  const payload = await request(ctx, `/photos/${encodeURIComponent(id)}`);
+  return { photo: requireRecord(payload, "Unsplash \u7167\u7247\u54CD\u5E94") };
+}
+async function getRandomPhoto(input, ctx) {
+  const query = text(input.query);
+  const collections = csv(input.collections);
+  const topics = csv(input.topics);
+  if (query !== void 0 && (collections !== void 0 || topics !== void 0)) {
+    throw new TBError("invalid_argument", "get_random_photo \u7684 query \u4E0D\u80FD\u4E0E collections \u6216 topics \u540C\u65F6\u4F7F\u7528");
+  }
+  const payload = await request(ctx, "/photos/random", {
+    query,
+    collections,
+    topics,
+    username: text(input.username),
+    orientation: input.orientation,
+    content_filter: input.contentFilter,
+    count: input.count
+  });
+  return {
+    photos: Array.isArray(payload) ? objectArray(payload) : [requireRecord(payload, "Unsplash \u968F\u673A\u7167\u7247\u54CD\u5E94")]
+  };
+}
+async function listTopics(input, ctx) {
+  const payload = await request(ctx, "/topics", {
+    page: input.page,
+    per_page: input.perPage,
+    order_by: input.orderBy
+  });
+  return { topics: objectArray(payload) };
+}
+async function getTopicPhotos(input, ctx) {
+  const topic = requireText(input.topicIdOrSlug, "topicIdOrSlug");
+  const payload = await request(ctx, `/topics/${encodeURIComponent(topic)}/photos`, {
+    page: input.page,
+    per_page: input.perPage,
+    orientation: input.orientation,
+    order_by: input.orderBy
+  });
+  return { photos: objectArray(payload) };
+}
+
+// ../plugins/src/unsplash/schema.ts
+var listPhotosInput = external_exports.strictObject({
+  page: external_exports.int().min(1).describe("The 1-based page number to retrieve.").optional(),
+  perPage: external_exports.int().min(1).max(30).describe("The number of items to return per page, between 1 and 30.").optional(),
+  orderBy: external_exports.enum(["latest", "oldest", "popular"]).describe("The sort order supported by the Unsplash photo listing endpoints.").optional()
+}).describe("The input payload for listing the latest public photos from Unsplash.");
+var listPhotosOutput = external_exports.strictObject({
+  photos: external_exports.array(external_exports.strictObject({
+    id: external_exports.string().describe("The unique identifier of the photo."),
+    slug: external_exports.string().describe("The public slug of the photo.").optional(),
+    description: external_exports.string().describe("The description of the photo when Unsplash provides it.").nullable().optional(),
+    alt_description: external_exports.string().describe("The alternative description of the photo when Unsplash provides it.").nullable().optional(),
+    width: external_exports.number().describe("The width of the photo in pixels.").optional(),
+    height: external_exports.number().describe("The height of the photo in pixels.").optional(),
+    color: external_exports.string().describe("The representative HEX color of the photo.").optional(),
+    blur_hash: external_exports.string().describe("The blur hash value of the photo.").optional(),
+    urls: external_exports.looseObject({}).describe("The photo URLs returned by Unsplash in multiple sizes.").optional(),
+    links: external_exports.looseObject({}).describe("The related links attached to the Unsplash photo resource.").optional(),
+    user: external_exports.looseObject({}).describe("The user metadata attached to the photo.").optional()
+  }).describe("A summary photo resource returned by Unsplash.")).describe("The public photo summaries returned by Unsplash.")
+}).describe("The latest public photos returned by Unsplash.");
+var searchPhotosInput = external_exports.strictObject({
+  query: external_exports.string().min(1).describe("The search query to run against Unsplash photos."),
+  page: external_exports.int().min(1).describe("The 1-based page number to retrieve.").optional(),
+  perPage: external_exports.int().min(1).max(30).describe("The number of items to return per page, between 1 and 30.").optional(),
+  orderBy: external_exports.enum(["relevant", "latest"]).describe("The sort order supported by the Unsplash photo search endpoint.").optional(),
+  color: external_exports.enum(["black_and_white", "black", "white", "yellow", "orange", "red", "purple", "magenta", "green", "teal", "blue"]).describe("The color filter to apply to photo search results.").optional(),
+  orientation: external_exports.enum(["landscape", "portrait", "squarish"]).describe("The photo orientation filter to apply.").optional(),
+  contentFilter: external_exports.enum(["low", "high"]).describe("The safety filter level to apply to supported Unsplash requests.").optional(),
+  collections: external_exports.array(external_exports.string().min(1).describe("One identifier value.")).min(1).describe("The collection identifiers to filter the search results by.").optional()
+}).describe("The input payload for searching photos on Unsplash.");
+var searchPhotosOutput = external_exports.strictObject({
+  total: external_exports.number().describe("The total number of matching photo results."),
+  totalPages: external_exports.number().describe("The total number of result pages."),
+  results: external_exports.array(external_exports.strictObject({
+    id: external_exports.string().describe("The unique identifier of the photo."),
+    slug: external_exports.string().describe("The public slug of the photo.").optional(),
+    description: external_exports.string().describe("The description of the photo when Unsplash provides it.").nullable().optional(),
+    alt_description: external_exports.string().describe("The alternative description of the photo when Unsplash provides it.").nullable().optional(),
+    width: external_exports.number().describe("The width of the photo in pixels.").optional(),
+    height: external_exports.number().describe("The height of the photo in pixels.").optional(),
+    color: external_exports.string().describe("The representative HEX color of the photo.").optional(),
+    blur_hash: external_exports.string().describe("The blur hash value of the photo.").optional(),
+    urls: external_exports.looseObject({}).describe("The photo URLs returned by Unsplash in multiple sizes.").optional(),
+    links: external_exports.looseObject({}).describe("The related links attached to the Unsplash photo resource.").optional(),
+    user: external_exports.looseObject({}).describe("The user metadata attached to the photo.").optional()
+  }).describe("A summary photo resource returned by Unsplash.")).describe("The matching photo summaries returned by Unsplash.")
+}).describe("The photo search results returned by Unsplash.");
+var getPhotoInput = external_exports.strictObject({
+  id: external_exports.string().min(1).describe("The Unsplash photo identifier to retrieve.")
+}).describe("The input payload for fetching a single Unsplash photo.");
+var getPhotoOutput = external_exports.strictObject({
+  photo: external_exports.strictObject({
+    id: external_exports.string().describe("The unique identifier of the photo."),
+    slug: external_exports.string().describe("The public slug of the photo.").optional(),
+    description: external_exports.string().describe("The description of the photo when Unsplash provides it.").nullable().optional(),
+    alt_description: external_exports.string().describe("The alternative description of the photo when Unsplash provides it.").nullable().optional(),
+    width: external_exports.number().describe("The width of the photo in pixels.").optional(),
+    height: external_exports.number().describe("The height of the photo in pixels.").optional(),
+    color: external_exports.string().describe("The representative HEX color of the photo.").optional(),
+    blur_hash: external_exports.string().describe("The blur hash value of the photo.").optional(),
+    urls: external_exports.looseObject({}).describe("The photo URLs returned by Unsplash in multiple sizes.").optional(),
+    links: external_exports.looseObject({}).describe("The related links attached to the Unsplash photo resource.").optional(),
+    user: external_exports.looseObject({}).describe("The user metadata attached to the photo.").optional(),
+    created_at: external_exports.string().describe("The creation timestamp of the photo.").optional(),
+    liked_by_user: external_exports.boolean().describe("Whether the authenticated user liked the photo.").optional(),
+    likes: external_exports.number().describe("The total number of likes on the photo.").optional(),
+    current_user_collections: external_exports.array(external_exports.looseObject({}).describe("One current user collection reference.")).describe("The current user collections returned with the photo.").optional()
+  }).describe("A detailed photo resource returned by Unsplash.")
+}).describe("The detailed photo payload returned by Unsplash.");
+var getRandomPhotoInput = external_exports.strictObject({
+  query: external_exports.string().min(1).describe("The search query used to constrain the random photo.").optional(),
+  collections: external_exports.array(external_exports.string().min(1).describe("One identifier value.")).min(1).describe("The collection identifiers used to constrain the random photo.").optional(),
+  topics: external_exports.array(external_exports.string().min(1).describe("One identifier value.")).min(1).describe("The topic identifiers used to constrain the random photo.").optional(),
+  username: external_exports.string().min(1).describe("The username used to constrain the random photo.").optional(),
+  orientation: external_exports.enum(["landscape", "portrait", "squarish"]).describe("The photo orientation filter to apply.").optional(),
+  contentFilter: external_exports.enum(["low", "high"]).describe("The safety filter level to apply to supported Unsplash requests.").optional(),
+  count: external_exports.int().min(1).max(30).describe("The number of random photos to request, between 1 and 30.").optional()
+}).describe("The input payload for fetching one or more random Unsplash photos.");
+var getRandomPhotoOutput = external_exports.strictObject({
+  photos: external_exports.array(external_exports.strictObject({
+    id: external_exports.string().describe("The unique identifier of the photo."),
+    slug: external_exports.string().describe("The public slug of the photo.").optional(),
+    description: external_exports.string().describe("The description of the photo when Unsplash provides it.").nullable().optional(),
+    alt_description: external_exports.string().describe("The alternative description of the photo when Unsplash provides it.").nullable().optional(),
+    width: external_exports.number().describe("The width of the photo in pixels.").optional(),
+    height: external_exports.number().describe("The height of the photo in pixels.").optional(),
+    color: external_exports.string().describe("The representative HEX color of the photo.").optional(),
+    blur_hash: external_exports.string().describe("The blur hash value of the photo.").optional(),
+    urls: external_exports.looseObject({}).describe("The photo URLs returned by Unsplash in multiple sizes.").optional(),
+    links: external_exports.looseObject({}).describe("The related links attached to the Unsplash photo resource.").optional(),
+    user: external_exports.looseObject({}).describe("The user metadata attached to the photo.").optional(),
+    created_at: external_exports.string().describe("The creation timestamp of the photo.").optional(),
+    liked_by_user: external_exports.boolean().describe("Whether the authenticated user liked the photo.").optional(),
+    likes: external_exports.number().describe("The total number of likes on the photo.").optional(),
+    current_user_collections: external_exports.array(external_exports.looseObject({}).describe("One current user collection reference.")).describe("The current user collections returned with the photo.").optional()
+  }).describe("A detailed photo resource returned by Unsplash.")).describe("The random photo resources returned by Unsplash.")
+}).describe("The normalized random photo payload returned by Unsplash.");
+var listTopicsInput = external_exports.strictObject({
+  page: external_exports.int().min(1).describe("The 1-based page number to retrieve.").optional(),
+  perPage: external_exports.int().min(1).max(30).describe("The number of items to return per page, between 1 and 30.").optional(),
+  orderBy: external_exports.enum(["position", "latest", "oldest", "popular"]).describe("The sort order supported by the Unsplash topic listing endpoint.").optional()
+}).describe("The input payload for listing Unsplash topics.");
+var listTopicsOutput = external_exports.strictObject({
+  topics: external_exports.array(external_exports.strictObject({
+    id: external_exports.string().describe("The unique identifier of the topic."),
+    slug: external_exports.string().describe("The topic slug.").optional(),
+    title: external_exports.string().describe("The display title of the topic."),
+    description: external_exports.string().describe("The description of the topic when Unsplash provides it.").nullable().optional(),
+    featured: external_exports.boolean().describe("Whether the topic is marked as featured.").optional(),
+    total_photos: external_exports.number().describe("The total number of photos in the topic.").optional(),
+    links: external_exports.looseObject({}).describe("The related links attached to the Unsplash topic resource.").optional(),
+    cover_photo: external_exports.looseObject({}).describe("The cover photo attached to the topic when Unsplash provides it.").optional()
+  }).describe("A topic resource returned by Unsplash.")).describe("The topics returned by Unsplash.")
+}).describe("The topic listing returned by Unsplash.");
+var getTopicPhotosInput = external_exports.strictObject({
+  topicIdOrSlug: external_exports.string().min(1).describe("The topic identifier or slug to read photos from."),
+  page: external_exports.int().min(1).describe("The 1-based page number to retrieve.").optional(),
+  perPage: external_exports.int().min(1).max(30).describe("The number of items to return per page, between 1 and 30.").optional(),
+  orientation: external_exports.enum(["landscape", "portrait", "squarish"]).describe("The photo orientation filter to apply.").optional(),
+  orderBy: external_exports.enum(["latest", "oldest", "popular"]).describe("The sort order supported by the Unsplash photo listing endpoints.").optional()
+}).describe("The input payload for listing photos from an Unsplash topic.");
+var getTopicPhotosOutput = external_exports.strictObject({
+  photos: external_exports.array(external_exports.strictObject({
+    id: external_exports.string().describe("The unique identifier of the photo."),
+    slug: external_exports.string().describe("The public slug of the photo.").optional(),
+    description: external_exports.string().describe("The description of the photo when Unsplash provides it.").nullable().optional(),
+    alt_description: external_exports.string().describe("The alternative description of the photo when Unsplash provides it.").nullable().optional(),
+    width: external_exports.number().describe("The width of the photo in pixels.").optional(),
+    height: external_exports.number().describe("The height of the photo in pixels.").optional(),
+    color: external_exports.string().describe("The representative HEX color of the photo.").optional(),
+    blur_hash: external_exports.string().describe("The blur hash value of the photo.").optional(),
+    urls: external_exports.looseObject({}).describe("The photo URLs returned by Unsplash in multiple sizes.").optional(),
+    links: external_exports.looseObject({}).describe("The related links attached to the Unsplash photo resource.").optional(),
+    user: external_exports.looseObject({}).describe("The user metadata attached to the photo.").optional()
+  }).describe("A summary photo resource returned by Unsplash.")).describe("The photo summaries returned for the requested Unsplash topic.")
+}).describe("The topic photo listing returned by Unsplash.");
+var unsplashActions = {
+  list_photos: {
+    description: "List the latest public photos from Unsplash.",
+    effect: "read",
+    inputSchema: listPhotosInput,
+    outputSchema: external_exports.toJSONSchema(listPhotosOutput, { io: "output", unrepresentable: "any" })
+  },
+  search_photos: {
+    description: "Search photos on Unsplash using keyword and filter inputs.",
+    effect: "read",
+    inputSchema: searchPhotosInput,
+    outputSchema: external_exports.toJSONSchema(searchPhotosOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_photo: {
+    description: "Fetch the detailed payload for a single Unsplash photo.",
+    effect: "read",
+    inputSchema: getPhotoInput,
+    outputSchema: external_exports.toJSONSchema(getPhotoOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_random_photo: {
+    description: "Fetch one or more random Unsplash photos using optional filters.",
+    effect: "read",
+    inputSchema: getRandomPhotoInput,
+    outputSchema: external_exports.toJSONSchema(getRandomPhotoOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_topics: {
+    description: "List topics curated by Unsplash.",
+    effect: "read",
+    inputSchema: listTopicsInput,
+    outputSchema: external_exports.toJSONSchema(listTopicsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_topic_photos: {
+    description: "List photos from a specific Unsplash topic.",
+    effect: "read",
+    inputSchema: getTopicPhotosInput,
+    outputSchema: external_exports.toJSONSchema(getTopicPhotosOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/unsplash/index.ts
+function createUnsplashPlugin() {
+  return createProviderPlugin({
+    description: "Unsplash",
+    actions: unsplashActions,
+    // 上游 `credentialValidators.apiKey` 打的就是 `/photos?page=1&per_page=1`,
+    // 对应这里的 list_photos:read、无必填入参,平台空参调它即可验证 access key。
+    credentialProbe: "list_photos",
+    handlers: {
+      list_photos: listPhotos,
+      search_photos: searchPhotos,
+      get_photo: getPhoto,
+      get_random_photo: getRandomPhoto,
+      list_topics: listTopics,
+      get_topic_photos: getTopicPhotos
+    }
+  });
+}
+var unsplash_default = createUnsplashPlugin();
+export {
+  createUnsplashPlugin,
+  unsplash_default as default
+};

package/dist/upstash_redis-GC2CLIWD.js

@@ -0,0 +1,299 @@
+import {
+  createProviderPlugin,
+  guardedFetch,
+  requireCredential,
+  upstreamError
+} from "./chunk-CSJEZHQO.js";
+import "./chunk-K7FVSFUX.js";
+import {
+  TBError,
+  external_exports
+} from "./chunk-JLTYA2B3.js";
+import "./chunk-MLKGABMK.js";
+
+// ../plugins/src/upstash_redis/api.ts
+var SERVICE = "upstash_redis";
+var HOSTNAME_SUFFIX = ".upstash.io";
+function text(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function responseError(message) {
+  return new TBError("unavailable", message, { retryable: true });
+}
+function configError(message) {
+  return new TBError("invalid_argument", `${SERVICE} \u7684 restUrl ${message}`);
+}
+function isQuotaMessage(message) {
+  const normalized = message.toLowerCase();
+  return normalized.includes("limit exceeded") || normalized.includes("connections exceeded");
+}
+function restUrl(ctx) {
+  const raw = requireCredential(ctx, SERVICE, "restUrl");
+  let url;
+  try {
+    url = new URL(raw.trim());
+  } catch {
+    throw configError("\u4E0D\u662F\u5408\u6CD5 URL");
+  }
+  if (url.protocol !== "https:") throw configError("\u5FC5\u987B\u7528 https");
+  if (url.username !== "" || url.password !== "") throw configError("\u4E0D\u80FD\u5E26\u7528\u6237\u540D\u6216\u5BC6\u7801");
+  if (url.port !== "") throw configError("\u4E0D\u80FD\u5E26\u7AEF\u53E3");
+  if (url.pathname !== "/" || url.search !== "" || url.hash !== "") {
+    throw configError("\u4E0D\u80FD\u5E26\u8DEF\u5F84\u3001\u67E5\u8BE2\u4E32\u6216\u7247\u6BB5");
+  }
+  if (!url.hostname.endsWith(HOSTNAME_SUFFIX)) {
+    throw configError(`\u5FC5\u987B\u662F\u5B98\u65B9 ${HOSTNAME_SUFFIX} \u7AEF\u70B9`);
+  }
+  return url;
+}
+function commandError(status, payload, fallbackBody) {
+  const body = record(payload);
+  const message = text(body?.error) ?? text(body?.message) ?? text(fallbackBody) ?? `Upstash Redis \u8FD4\u56DE HTTP ${status}`;
+  if (isQuotaMessage(message)) return upstreamError(429, message);
+  return upstreamError(status, message);
+}
+function unwrap(payload) {
+  const body = record(payload);
+  if (body === void 0) throw responseError("Upstash Redis \u54CD\u5E94\u4E0D\u662F\u5BF9\u8C61");
+  const error = text(body.error);
+  if (error !== void 0) {
+    if (isQuotaMessage(error)) throw upstreamError(429, error);
+    throw new TBError("invalid_argument", error);
+  }
+  if (!Object.hasOwn(body, "result")) throw responseError("Upstash Redis \u54CD\u5E94\u7F3A result");
+  return body.result;
+}
+async function command(ctx, args) {
+  const response = await guardedFetch(restUrl(ctx), {
+    method: "POST",
+    headers: {
+      "accept": "application/json",
+      "authorization": `Bearer ${requireCredential(ctx, SERVICE, "restToken")}`,
+      "content-type": "application/json"
+    },
+    body: JSON.stringify(args)
+  });
+  const body = await response.text();
+  let payload;
+  let parsed = false;
+  if (body !== "") {
+    try {
+      payload = JSON.parse(body);
+      parsed = true;
+    } catch {
+      if (response.ok) throw responseError("Upstash Redis \u8FD4\u56DE\u4E86\u975E JSON \u54CD\u5E94");
+    }
+  }
+  if (!response.ok) throw commandError(response.status, parsed ? payload : void 0, body);
+  return unwrap(payload);
+}
+function redisKey(value) {
+  const key = text(value);
+  if (key === void 0) throw new TBError("invalid_argument", "key \u4E0D\u80FD\u662F\u7A7A\u767D");
+  return key;
+}
+function stringOrNull(result, name) {
+  if (result === null || typeof result === "string") return result;
+  throw responseError(`Upstash Redis \u7684 ${name} \u8FD4\u56DE\u503C\u4E0D\u5408\u5951\u7EA6`);
+}
+function integer(result, name) {
+  if (typeof result !== "number" || !Number.isInteger(result)) {
+    throw responseError(`Upstash Redis \u7684 ${name} \u8FD4\u56DE\u503C\u4E0D\u5408\u5951\u7EA6`);
+  }
+  return result;
+}
+function flag(result, name) {
+  const value = integer(result, name);
+  if (value !== 0 && value !== 1) throw responseError(`Upstash Redis \u7684 ${name} \u8FD4\u56DE\u503C\u4E0D\u5408\u5951\u7EA6`);
+  return value === 1;
+}
+function scanPage(result) {
+  if (!Array.isArray(result) || result.length !== 2) {
+    throw responseError("Upstash Redis \u7684 SCAN \u8FD4\u56DE\u503C\u4E0D\u5408\u5951\u7EA6");
+  }
+  const [cursor, keys] = result;
+  if (typeof cursor !== "string" && typeof cursor !== "number" || !Array.isArray(keys)) {
+    throw responseError("Upstash Redis \u7684 SCAN \u8FD4\u56DE\u503C\u4E0D\u5408\u5951\u7EA6");
+  }
+  if (keys.some((key) => typeof key !== "string")) {
+    throw responseError("Upstash Redis \u7684 SCAN \u8FD4\u56DE\u4E86\u975E\u5B57\u7B26\u4E32\u952E");
+  }
+  return { nextCursor: String(cursor), keys };
+}
+async function get(input, ctx) {
+  const result = await command(ctx, ["GET", redisKey(input.key)]);
+  return { value: stringOrNull(result, "GET") };
+}
+async function set(input, ctx) {
+  const args = ["SET", redisKey(input.key), input.value];
+  if (input.expirationSeconds !== void 0) args.push("EX", input.expirationSeconds);
+  if (input.condition !== void 0) args.push(input.condition);
+  const result = await command(ctx, args);
+  if (result !== "OK" && result !== null) {
+    throw responseError("Upstash Redis \u7684 SET \u8FD4\u56DE\u503C\u4E0D\u5408\u5951\u7EA6");
+  }
+  return { stored: result === "OK" };
+}
+async function deleteKey(input, ctx) {
+  const result = await command(ctx, ["DEL", redisKey(input.key)]);
+  return { deleted: flag(result, "DEL") };
+}
+async function exists(input, ctx) {
+  const result = await command(ctx, ["EXISTS", redisKey(input.key)]);
+  return { exists: flag(result, "EXISTS") };
+}
+async function expire(input, ctx) {
+  const result = await command(ctx, ["EXPIRE", redisKey(input.key), input.expirationSeconds]);
+  return { updated: flag(result, "EXPIRE") };
+}
+async function ttl(input, ctx) {
+  const result = await command(ctx, ["TTL", redisKey(input.key)]);
+  return { ttlSeconds: integer(result, "TTL") };
+}
+async function scan(input, ctx) {
+  const args = ["SCAN", text(input.cursor) ?? "0"];
+  const match = text(input.match);
+  if (match !== void 0) args.push("MATCH", match);
+  if (input.count !== void 0) args.push("COUNT", input.count);
+  const page = scanPage(await command(ctx, args));
+  return { ...page, complete: page.nextCursor === "0" };
+}
+
+// ../plugins/src/upstash_redis/schema.ts
+var getInput = external_exports.strictObject({
+  key: external_exports.string().min(1).describe("The Redis key.")
+}).describe("The Redis key to retrieve.");
+var getOutput = external_exports.strictObject({
+  value: external_exports.string().describe("The stored string value, or null when the key does not exist. Upstash replaces bytes that are not valid UTF-8 with U+FFFD, so only text values round-trip exactly.").nullable()
+}).describe("The value returned for the Redis key.");
+var setInput = external_exports.strictObject({
+  key: external_exports.string().min(1).describe("The Redis key."),
+  value: external_exports.string().min(1).describe("The string value stored for the Redis key."),
+  expirationSeconds: external_exports.int().min(1).describe("Expiration time in seconds.").optional(),
+  condition: external_exports.enum(["NX", "XX"]).describe("Optional Redis write condition: NX stores only a new key; XX stores only an existing key.").optional()
+}).describe("The Redis string value to store.");
+var setOutput = external_exports.strictObject({
+  stored: external_exports.boolean().describe("Whether Redis stored the value. False means the requested condition was not met.")
+}).describe("The result of the Redis SET command.");
+var deleteInput = external_exports.strictObject({
+  key: external_exports.string().min(1).describe("The Redis key.")
+}).describe("The Redis key to delete.");
+var deleteOutput = external_exports.strictObject({
+  deleted: external_exports.boolean().describe("Whether Redis deleted an existing key.")
+}).describe("The result of the Redis DEL command.");
+var existsInput = external_exports.strictObject({
+  key: external_exports.string().min(1).describe("The Redis key.")
+}).describe("The Redis key to check.");
+var existsOutput = external_exports.strictObject({
+  exists: external_exports.boolean().describe("Whether the Redis key exists.")
+}).describe("The result of the Redis EXISTS command.");
+var expireInput = external_exports.strictObject({
+  key: external_exports.string().min(1).describe("The Redis key."),
+  expirationSeconds: external_exports.int().min(1).describe("Expiration time in seconds.")
+}).describe("The Redis key and its new expiration time.");
+var expireOutput = external_exports.strictObject({
+  updated: external_exports.boolean().describe("Whether Redis updated the expiration for an existing key.")
+}).describe("The result of the Redis EXPIRE command.");
+var ttlInput = external_exports.strictObject({
+  key: external_exports.string().min(1).describe("The Redis key.")
+}).describe("The Redis key whose expiration to retrieve.");
+var ttlOutput = external_exports.strictObject({
+  ttlSeconds: external_exports.int().describe("Remaining expiration in seconds. -2 means the key does not exist; -1 means the key has no expiration.")
+}).describe("The result of the Redis TTL command.");
+var scanInput = external_exports.strictObject({
+  cursor: external_exports.string().min(1).describe("The cursor returned by a previous scan. Omit it to start at cursor 0.").optional(),
+  match: external_exports.string().min(1).describe("Optional Redis glob pattern used to filter keys.").optional(),
+  count: external_exports.int().min(1).max(1e3).describe("Optional scan work hint from 1 to 1000.").optional()
+}).describe("Cursor pagination and optional filters for Redis SCAN.");
+var scanOutput = external_exports.strictObject({
+  nextCursor: external_exports.string().min(1).describe("Cursor to pass to the next scan request. A value of 0 means scanning is complete."),
+  keys: external_exports.array(external_exports.string().min(1)).describe("Keys returned in this scan page."),
+  complete: external_exports.boolean().describe("Whether this scan reached cursor 0.")
+}).describe("One page returned by Redis SCAN.");
+var upstashRedisActions = {
+  get: {
+    description: "Get the string value stored for one Redis key.",
+    effect: "write",
+    inputSchema: getInput,
+    outputSchema: external_exports.toJSONSchema(getOutput, { io: "output", unrepresentable: "any" })
+  },
+  set: {
+    description: "Store a string value for one Redis key, optionally with an expiration or conditional write.",
+    effect: "write",
+    inputSchema: setInput,
+    outputSchema: external_exports.toJSONSchema(setOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete: {
+    description: "Delete one Redis key.",
+    effect: "write",
+    inputSchema: deleteInput,
+    outputSchema: external_exports.toJSONSchema(deleteOutput, { io: "output", unrepresentable: "any" })
+  },
+  exists: {
+    description: "Check whether one Redis key exists.",
+    effect: "write",
+    inputSchema: existsInput,
+    outputSchema: external_exports.toJSONSchema(existsOutput, { io: "output", unrepresentable: "any" })
+  },
+  expire: {
+    description: "Set or replace the expiration time for one Redis key.",
+    effect: "write",
+    inputSchema: expireInput,
+    outputSchema: external_exports.toJSONSchema(expireOutput, { io: "output", unrepresentable: "any" })
+  },
+  ttl: {
+    description: "Get the remaining expiration time for one Redis key.",
+    effect: "write",
+    inputSchema: ttlInput,
+    outputSchema: external_exports.toJSONSchema(ttlOutput, { io: "output", unrepresentable: "any" })
+  },
+  scan: {
+    description: "Scan one page of Redis keys without reading the full keyspace.",
+    effect: "write",
+    inputSchema: scanInput,
+    outputSchema: external_exports.toJSONSchema(scanOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/upstash_redis/index.ts
+function createUpstashRedisPlugin() {
+  return createProviderPlugin({
+    description: "Upstash Redis",
+    credentialFields: [
+      {
+        key: "restUrl",
+        label: "REST URL",
+        required: true,
+        secret: false,
+        description: "Upstash \u63A7\u5236\u53F0\u91CC\u90A3\u4E2A\u6570\u636E\u5E93\u7684 HTTPS REST \u5730\u5740(https://<db>.upstash.io);\u53EA\u63A5\u53D7\u5B98\u65B9 upstash.io \u7AEF\u70B9"
+      },
+      {
+        key: "restToken",
+        label: "REST Token",
+        required: true,
+        secret: true,
+        description: "\u4EE5 Bearer \u53D1\u9001\u7684 Upstash REST \u4EE4\u724C\u3002\u53EA\u8BFB\u4EE4\u724C\u80FD\u8DD1 get/exists/ttl,\u4F46 scan \u4E0E\u6240\u6709\u5199\u64CD\u4F5C\u8981\u6807\u51C6\u4EE4\u724C"
+      }
+    ],
+    actions: upstashRedisActions,
+    handlers: {
+      get,
+      set,
+      delete: deleteKey,
+      exists,
+      expire,
+      ttl,
+      scan
+    }
+  });
+}
+var upstash_redis_default = createUpstashRedisPlugin();
+export {
+  createUpstashRedisPlugin,
+  upstash_redis_default as default
+};