@tool-bridge/server 0.1.1 → 0.3.0

package/dist/memos-UWFAMBZC.js

@@ -0,0 +1,781 @@
+import {
+  assertPublicHttpUrl,
+  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/memos/api.ts
+var SERVICE = "memos";
+var API_SUFFIX = "/api/v1";
+var ATTACHMENT_MAX_BYTES = 20 * 1024 * 1024;
+var BASE64_CHUNK = 8192;
+var UPDATE_MASKS = [
+  ["content", "content"],
+  ["visibility", "visibility"],
+  ["pinned", "pinned"],
+  ["state", "state"],
+  ["createTime", "create_time"],
+  ["location", "location"]
+];
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function text(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function requireText(value, field) {
+  const result = text(value);
+  if (result === void 0) throw new TBError("invalid_argument", `${field} is required.`);
+  return result;
+}
+function compact(input) {
+  return Object.fromEntries(
+    Object.entries(input).filter(([, value]) => value !== void 0)
+  );
+}
+function responseError(message) {
+  return new TBError("unavailable", message, { retryable: true });
+}
+function requireResponseObject(value, operation) {
+  const object = record(value);
+  if (object === void 0) throw responseError(`Memos ${operation} response did not include an object`);
+  return object;
+}
+function requireResponseObjects(value, operation) {
+  if (!Array.isArray(value)) throw responseError(`Memos ${operation} response did not include an array`);
+  return value.map((item) => requireResponseObject(item, operation));
+}
+function configError(message) {
+  return new TBError("invalid_argument", `${SERVICE} \u7684 baseUrl ${message}`);
+}
+function resolveBaseUrl(ctx) {
+  const configured = ctx.config?.baseUrl;
+  if (configured !== void 0 && typeof configured !== "string") throw configError("\u5FC5\u987B\u662F\u5B57\u7B26\u4E32");
+  const candidate = text(configured);
+  if (candidate === void 0) {
+    throw configError(
+      "\u662F\u5FC5\u914D\u9879:\u7ED9\u6302\u8F7D\u8282\u70B9\u914D providerConfig.baseUrl \u6307\u5411\u4F60\u7684 Memos \u5B9E\u4F8B(\u5982 https://memos.example.com)\u3002Memos \u53EA\u6709\u81EA\u5EFA\u5B9E\u4F8B,\u6CA1\u6709\u516C\u5171\u7F3A\u7701\u5730\u5740"
+    );
+  }
+  let url;
+  try {
+    url = assertPublicHttpUrl(candidate);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : "\u4E0D\u53EF\u7528";
+    throw configError(
+      `\u4E0D\u53EF\u7528(${detail})\u3002\u81EA\u5EFA Memos \u5FC5\u987B\u662F**\u516C\u7F51\u53EF\u8FBE**\u7684\u5730\u5740:\u63D2\u4EF6\u4E0E\u7F51\u5173\u540C\u8FDB\u7A0B,\u6307\u5411\u5185\u7F51\u6216\u4FDD\u7559\u5730\u5740\u4F1A\u88AB\u51FA\u7AD9\u6821\u9A8C\u62D2\u7EDD`
+    );
+  }
+  if (url.username !== "" || url.password !== "") throw configError("\u4E0D\u80FD\u5E26\u7528\u6237\u540D/\u5BC6\u7801");
+  url.search = "";
+  url.hash = "";
+  const path = url.pathname.replace(/\/+$/, "");
+  const normalized = `${url.origin}${path}`;
+  return normalized.endsWith(API_SUFFIX) ? normalized : `${normalized}${API_SUFFIX}`;
+}
+function resolveTarget(ctx) {
+  return { apiKey: requireApiKey(ctx, SERVICE), baseUrl: resolveBaseUrl(ctx) };
+}
+function resourcePath(name, collection) {
+  const segments = name.split("/");
+  const id = segments[1];
+  if (segments.length !== 2 || segments[0] !== collection || id === void 0 || id === "" || id === "." || id === "..") {
+    throw new TBError("invalid_argument", `name must use the ${collection}/{id} resource format`);
+  }
+  return `/${collection}/${encodeURIComponent(id)}`;
+}
+function readPayload(response, body) {
+  if (body.trim() === "") return null;
+  try {
+    return JSON.parse(body);
+  } catch {
+    if (response.ok) throw responseError("Memos returned invalid JSON");
+    return body;
+  }
+}
+function errorMessage(payload) {
+  const direct = text(payload);
+  if (direct !== void 0) return direct;
+  return text(record(payload)?.message) ?? "Memos request failed";
+}
+async function request(target, input) {
+  const url = new URL(`${target.baseUrl}${input.path}`);
+  for (const [key, value] of Object.entries(input.query ?? {})) {
+    if (value !== void 0) url.searchParams.set(key, String(value));
+  }
+  let response;
+  let payload;
+  try {
+    response = await guardedFetch(url.toString(), {
+      method: input.method ?? "GET",
+      headers: {
+        accept: "application/json",
+        authorization: `Bearer ${target.apiKey}`,
+        ...input.body === void 0 ? {} : { "content-type": "application/json" }
+      },
+      body: input.body === void 0 ? void 0 : JSON.stringify(input.body)
+    });
+    payload = readPayload(response, await response.text());
+  } catch (error) {
+    if (error instanceof TBError) throw error;
+    const detail = error instanceof Error ? error.message : "unknown network error";
+    throw upstreamError(502, `Memos ${input.path} request failed: ${detail}`);
+  }
+  if (!response.ok) throw upstreamError(response.status, errorMessage(payload));
+  return payload;
+}
+async function readBoundedBytes(response) {
+  const tooLarge = () => new TBError(
+    "invalid_argument",
+    `fileUrl \u6307\u5411\u7684\u6587\u4EF6\u8D85\u8FC7 ${ATTACHMENT_MAX_BYTES} \u5B57\u8282\u7684\u4E0A\u9650`
+  );
+  const declared = Number(response.headers.get("content-length"));
+  if (Number.isFinite(declared) && declared > ATTACHMENT_MAX_BYTES) throw tooLarge();
+  const body = response.body;
+  if (body === null) {
+    const bytes2 = new Uint8Array(await response.arrayBuffer());
+    if (bytes2.byteLength > ATTACHMENT_MAX_BYTES) throw tooLarge();
+    return bytes2;
+  }
+  const reader = body.getReader();
+  const chunks = [];
+  let total = 0;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    total += value.byteLength;
+    if (total > ATTACHMENT_MAX_BYTES) {
+      await reader.cancel();
+      throw tooLarge();
+    }
+    chunks.push(value);
+  }
+  const bytes = new Uint8Array(total);
+  let offset = 0;
+  for (const chunk of chunks) {
+    bytes.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return bytes;
+}
+function base64(bytes) {
+  let binary = "";
+  for (let offset = 0; offset < bytes.length; offset += BASE64_CHUNK) {
+    binary += String.fromCharCode(...bytes.subarray(offset, offset + BASE64_CHUNK));
+  }
+  return btoa(binary);
+}
+async function downloadAttachment(fileUrl, declaredType) {
+  let response;
+  try {
+    response = await guardedFetch(fileUrl, { method: "GET" });
+  } catch (error) {
+    if (error instanceof TBError) throw error;
+    const detail = error instanceof Error ? error.message : "unknown network error";
+    throw upstreamError(502, `failed to fetch fileUrl: ${detail}`);
+  }
+  if (!response.ok) throw upstreamError(502, `failed to fetch fileUrl: ${response.status}`);
+  const bytes = await readBoundedBytes(response);
+  const responseType = text(response.headers.get("content-type")?.split(";", 1)[0]);
+  return { bytes, mimeType: declaredType ?? responseType ?? "application/octet-stream" };
+}
+async function createMemo(input, ctx) {
+  const payload = await request(resolveTarget(ctx), {
+    method: "POST",
+    path: "/memos",
+    // memoId 是**query** 参数而不是 body 字段(Memos 的 AIP 风格:资源 id 走 query)。
+    query: compact({ memoId: text(input.memoId) }),
+    body: compact({
+      content: input.content,
+      visibility: text(input.visibility),
+      createTime: text(input.createTime),
+      pinned: input.pinned,
+      location: input.location
+    })
+  });
+  return { memo: requireResponseObject(payload, "create memo") };
+}
+async function listMemos(input, ctx) {
+  const payload = requireResponseObject(await request(resolveTarget(ctx), {
+    path: "/memos",
+    query: compact({
+      pageSize: input.pageSize,
+      pageToken: text(input.pageToken),
+      state: text(input.state),
+      orderBy: text(input.orderBy),
+      filter: text(input.filter),
+      showDeleted: input.showDeleted
+    })
+  }), "list memos");
+  return {
+    // 一页都没有时 Memos 干脆不给 `memos` 键,补成空数组;非数组则是上游坏了。
+    memos: requireResponseObjects(payload.memos ?? [], "list memos"),
+    nextPageToken: text(payload.nextPageToken) ?? null
+  };
+}
+async function getMemo(input, ctx) {
+  const path = resourcePath(requireText(input.name, "name"), "memos");
+  const payload = await request(resolveTarget(ctx), { path });
+  return { memo: requireResponseObject(payload, "get memo") };
+}
+async function updateMemo(input, ctx) {
+  const name = requireText(input.name, "name");
+  const updateMask = UPDATE_MASKS.filter(([field]) => Object.hasOwn(input, field)).map(([, mask]) => mask);
+  if (updateMask.length === 0) {
+    throw new TBError("invalid_argument", "Provide at least one memo field to update.");
+  }
+  const payload = await request(resolveTarget(ctx), {
+    method: "PATCH",
+    path: resourcePath(name, "memos"),
+    query: { updateMask: updateMask.join(",") },
+    body: compact({
+      name,
+      content: input.content,
+      visibility: input.visibility,
+      pinned: input.pinned,
+      state: input.state,
+      createTime: input.createTime,
+      location: input.location
+    })
+  });
+  return { memo: requireResponseObject(payload, "update memo") };
+}
+async function deleteMemo(input, ctx) {
+  const name = requireText(input.name, "name");
+  await request(resolveTarget(ctx), {
+    method: "DELETE",
+    path: resourcePath(name, "memos"),
+    query: compact({ force: input.force })
+  });
+  return { deleted: true, name };
+}
+async function uploadAttachment(input, ctx) {
+  const target = resolveTarget(ctx);
+  const source = await downloadAttachment(requireText(input.fileUrl, "fileUrl"), text(input.type));
+  const payload = await request(target, {
+    method: "POST",
+    path: "/attachments",
+    query: compact({ attachmentId: text(input.attachmentId) }),
+    body: compact({
+      filename: requireText(input.filename, "filename"),
+      content: base64(source.bytes),
+      type: source.mimeType,
+      memo: text(input.memo)
+    })
+  });
+  return { attachment: requireResponseObject(payload, "upload attachment") };
+}
+async function listAttachments(input, ctx) {
+  const payload = requireResponseObject(await request(resolveTarget(ctx), {
+    path: "/attachments",
+    query: compact({
+      pageSize: input.pageSize,
+      pageToken: text(input.pageToken),
+      filter: text(input.filter),
+      orderBy: text(input.orderBy)
+    })
+  }), "list attachments");
+  return {
+    attachments: requireResponseObjects(payload.attachments ?? [], "list attachments"),
+    nextPageToken: text(payload.nextPageToken) ?? null
+  };
+}
+async function getAttachment(input, ctx) {
+  const path = resourcePath(requireText(input.name, "name"), "attachments");
+  const payload = await request(resolveTarget(ctx), { path });
+  return { attachment: requireResponseObject(payload, "get attachment") };
+}
+async function deleteAttachment(input, ctx) {
+  const name = requireText(input.name, "name");
+  await request(resolveTarget(ctx), { method: "DELETE", path: resourcePath(name, "attachments") });
+  return { deleted: true, name };
+}
+async function listMemoAttachments(input, ctx) {
+  const name = requireText(input.name, "name");
+  const payload = requireResponseObject(await request(resolveTarget(ctx), {
+    path: `${resourcePath(name, "memos")}/attachments`,
+    query: compact({ pageSize: input.pageSize, pageToken: text(input.pageToken) })
+  }), "list memo attachments");
+  return {
+    attachments: requireResponseObjects(payload.attachments ?? [], "list memo attachments"),
+    nextPageToken: text(payload.nextPageToken) ?? null
+  };
+}
+async function setMemoAttachments(input, ctx) {
+  const name = requireText(input.name, "name");
+  const attachmentNames = input.attachmentNames.map((item) => requireText(item, "attachmentNames"));
+  for (const attachmentName of attachmentNames) resourcePath(attachmentName, "attachments");
+  await request(resolveTarget(ctx), {
+    method: "PATCH",
+    path: `${resourcePath(name, "memos")}/attachments`,
+    body: { name, attachments: attachmentNames.map((attachmentName) => ({ name: attachmentName })) }
+  });
+  return { updated: true, name, attachmentNames };
+}
+async function getCurrentUser(_input, ctx) {
+  const payload = requireResponseObject(await request(resolveTarget(ctx), { path: "/auth/me" }), "get current user");
+  return { user: requireResponseObject(payload.user, "get current user") };
+}
+async function listUsers(input, ctx) {
+  const payload = requireResponseObject(await request(resolveTarget(ctx), {
+    path: "/users",
+    query: compact({
+      pageSize: input.pageSize,
+      pageToken: text(input.pageToken),
+      filter: text(input.filter),
+      showDeleted: input.showDeleted
+    })
+  }), "list users");
+  return {
+    users: requireResponseObjects(payload.users ?? [], "list users"),
+    nextPageToken: text(payload.nextPageToken) ?? null
+  };
+}
+async function getUser(input, ctx) {
+  const path = resourcePath(requireText(input.name, "name"), "users");
+  const payload = await request(resolveTarget(ctx), {
+    path,
+    query: compact({ readMask: text(input.readMask) })
+  });
+  return { user: requireResponseObject(payload, "get user") };
+}
+
+// ../plugins/src/memos/schema.handwritten.ts
+var UPDATABLE = ["content", "visibility", "pinned", "state", "createTime", "location"];
+var updateMemoInput = external_exports.strictObject({
+  name: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}."),
+  content: external_exports.string().describe("The replacement memo content. Provide at least one updatable field.").optional(),
+  visibility: external_exports.enum(["PRIVATE", "PROTECTED", "PUBLIC"]).describe("The memo visibility. Provide at least one updatable field.").optional(),
+  pinned: external_exports.boolean().describe("Whether the memo should be pinned. Provide at least one updatable field.").optional(),
+  state: external_exports.enum(["NORMAL", "ARCHIVED"]).describe("The memo state. Provide at least one updatable field.").optional(),
+  createTime: external_exports.iso.datetime({ offset: true }).describe("The replacement memo creation time. Provide at least one updatable field.").optional(),
+  location: external_exports.strictObject({
+    placeholder: external_exports.string().describe("The location label.").optional(),
+    latitude: external_exports.number().describe("The latitude in decimal degrees.").optional(),
+    longitude: external_exports.number().describe("The longitude in decimal degrees.").optional()
+  }).describe("A geographic location to attach to a memo; null clears it. Provide at least one updatable field.").nullable().optional()
+}).refine(
+  // 按"键在不在"判,不是"值是不是 undefined":显式给 `location: null` 也算"要改这个字段"。
+  (input) => UPDATABLE.some((field) => Object.hasOwn(input, field)),
+  {
+    message: `at least one of ${UPDATABLE.join(", ")} is required`,
+    path: ["content"]
+  }
+).describe("Input parameters for updating selected memo fields.");
+var updateMemoOutput = external_exports.strictObject({
+  memo: external_exports.looseObject({
+    name: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional(),
+    state: external_exports.string().describe("The memo state returned by Memos.").optional(),
+    creator: external_exports.string().min(7).describe("The Memos user resource name in the format users/{user}.").optional(),
+    createTime: external_exports.iso.datetime({ offset: true }).describe("The memo creation time.").optional(),
+    updateTime: external_exports.iso.datetime({ offset: true }).describe("The memo update time.").optional(),
+    content: external_exports.string().describe("The memo Markdown content.").optional(),
+    visibility: external_exports.string().describe("The memo visibility returned by Memos.").optional(),
+    tags: external_exports.array(external_exports.string().describe("An extracted memo tag.")).describe("Tags extracted from the memo content.").optional(),
+    pinned: external_exports.boolean().describe("Whether the memo is pinned.").optional(),
+    attachments: external_exports.array(external_exports.looseObject({
+      name: external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.").optional(),
+      createTime: external_exports.iso.datetime({ offset: true }).describe("The attachment creation time.").optional(),
+      filename: external_exports.string().describe("The attachment filename.").optional(),
+      externalLink: external_exports.string().describe("The external storage URL when returned by Memos.").optional(),
+      type: external_exports.string().describe("The attachment MIME type.").optional(),
+      size: external_exports.string().describe("The attachment size in bytes, encoded as a string by the Memos API.").optional(),
+      memo: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional()
+    }).describe("Memos attachment metadata.")).describe("Attachments associated with the memo.").optional(),
+    parent: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional(),
+    snippet: external_exports.string().describe("A plain-text preview of the memo content.").optional(),
+    location: external_exports.looseObject({
+      placeholder: external_exports.string().describe("The location label.").optional(),
+      latitude: external_exports.number().describe("The latitude in decimal degrees.").optional(),
+      longitude: external_exports.number().describe("The longitude in decimal degrees.").optional()
+    }).describe("A geographic location attached to a memo.").optional(),
+    property: external_exports.looseObject({}).describe("Computed memo properties.").optional()
+  }).describe("A Memos memo resource.")
+}).describe("The updated memo response.");
+
+// ../plugins/src/memos/schema.ts
+var createMemoInput = external_exports.strictObject({
+  content: external_exports.string().min(1).describe("The memo content in Markdown format."),
+  visibility: external_exports.enum(["PRIVATE", "PROTECTED", "PUBLIC"]).describe("The memo visibility.").optional(),
+  memoId: external_exports.string().min(1).max(36).describe("An optional caller-selected memo ID.").optional(),
+  createTime: external_exports.iso.datetime({ offset: true }).describe("An optional creation time for imported content.").optional(),
+  pinned: external_exports.boolean().describe("Whether the new memo should be pinned.").optional(),
+  location: external_exports.strictObject({
+    placeholder: external_exports.string().describe("The location label.").optional(),
+    latitude: external_exports.number().describe("The latitude in decimal degrees.").optional(),
+    longitude: external_exports.number().describe("The longitude in decimal degrees.").optional()
+  }).describe("A geographic location to attach to a memo.").optional()
+}).describe("Input parameters for creating a memo.");
+var createMemoOutput = external_exports.strictObject({
+  memo: external_exports.looseObject({
+    name: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional(),
+    state: external_exports.string().describe("The memo state returned by Memos.").optional(),
+    creator: external_exports.string().min(7).describe("The Memos user resource name in the format users/{user}.").optional(),
+    createTime: external_exports.iso.datetime({ offset: true }).describe("The memo creation time.").optional(),
+    updateTime: external_exports.iso.datetime({ offset: true }).describe("The memo update time.").optional(),
+    content: external_exports.string().describe("The memo Markdown content.").optional(),
+    visibility: external_exports.string().describe("The memo visibility returned by Memos.").optional(),
+    tags: external_exports.array(external_exports.string().describe("An extracted memo tag.")).describe("Tags extracted from the memo content.").optional(),
+    pinned: external_exports.boolean().describe("Whether the memo is pinned.").optional(),
+    attachments: external_exports.array(external_exports.looseObject({
+      name: external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.").optional(),
+      createTime: external_exports.iso.datetime({ offset: true }).describe("The attachment creation time.").optional(),
+      filename: external_exports.string().describe("The attachment filename.").optional(),
+      externalLink: external_exports.string().describe("The external storage URL when returned by Memos.").optional(),
+      type: external_exports.string().describe("The attachment MIME type.").optional(),
+      size: external_exports.string().describe("The attachment size in bytes, encoded as a string by the Memos API.").optional(),
+      memo: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional()
+    }).describe("Memos attachment metadata.")).describe("Attachments associated with the memo.").optional(),
+    parent: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional(),
+    snippet: external_exports.string().describe("A plain-text preview of the memo content.").optional(),
+    location: external_exports.looseObject({
+      placeholder: external_exports.string().describe("The location label.").optional(),
+      latitude: external_exports.number().describe("The latitude in decimal degrees.").optional(),
+      longitude: external_exports.number().describe("The longitude in decimal degrees.").optional()
+    }).describe("A geographic location attached to a memo.").optional(),
+    property: external_exports.looseObject({}).describe("Computed memo properties.").optional()
+  }).describe("A Memos memo resource.")
+}).describe("The created memo response.");
+var listMemosInput = external_exports.strictObject({
+  pageSize: external_exports.int().min(1).max(1e3).describe("The maximum number of resources to return.").optional(),
+  pageToken: external_exports.string().min(1).describe("The continuation token returned by a previous list action.").optional(),
+  state: external_exports.enum(["NORMAL", "ARCHIVED"]).describe("The memo state.").optional(),
+  orderBy: external_exports.string().min(1).describe("The AIP-132 ordering expression, such as pinned desc, create_time desc.").optional(),
+  filter: external_exports.string().min(1).describe("The Memos CEL filter expression, including content, creator, visibility, tags, timestamps, and computed properties.").optional(),
+  showDeleted: external_exports.boolean().describe("Whether deleted memos should be included.").optional()
+}).describe("Input parameters for listing memos.");
+var listMemosOutput = external_exports.strictObject({
+  memos: external_exports.array(external_exports.looseObject({
+    name: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional(),
+    state: external_exports.string().describe("The memo state returned by Memos.").optional(),
+    creator: external_exports.string().min(7).describe("The Memos user resource name in the format users/{user}.").optional(),
+    createTime: external_exports.iso.datetime({ offset: true }).describe("The memo creation time.").optional(),
+    updateTime: external_exports.iso.datetime({ offset: true }).describe("The memo update time.").optional(),
+    content: external_exports.string().describe("The memo Markdown content.").optional(),
+    visibility: external_exports.string().describe("The memo visibility returned by Memos.").optional(),
+    tags: external_exports.array(external_exports.string().describe("An extracted memo tag.")).describe("Tags extracted from the memo content.").optional(),
+    pinned: external_exports.boolean().describe("Whether the memo is pinned.").optional(),
+    attachments: external_exports.array(external_exports.looseObject({
+      name: external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.").optional(),
+      createTime: external_exports.iso.datetime({ offset: true }).describe("The attachment creation time.").optional(),
+      filename: external_exports.string().describe("The attachment filename.").optional(),
+      externalLink: external_exports.string().describe("The external storage URL when returned by Memos.").optional(),
+      type: external_exports.string().describe("The attachment MIME type.").optional(),
+      size: external_exports.string().describe("The attachment size in bytes, encoded as a string by the Memos API.").optional(),
+      memo: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional()
+    }).describe("Memos attachment metadata.")).describe("Attachments associated with the memo.").optional(),
+    parent: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional(),
+    snippet: external_exports.string().describe("A plain-text preview of the memo content.").optional(),
+    location: external_exports.looseObject({
+      placeholder: external_exports.string().describe("The location label.").optional(),
+      latitude: external_exports.number().describe("The latitude in decimal degrees.").optional(),
+      longitude: external_exports.number().describe("The longitude in decimal degrees.").optional()
+    }).describe("A geographic location attached to a memo.").optional(),
+    property: external_exports.looseObject({}).describe("Computed memo properties.").optional()
+  }).describe("A Memos memo resource.")).describe("The memos returned by the instance."),
+  nextPageToken: external_exports.string().describe("The continuation token for the next page, or null when no next page exists.").nullable()
+}).describe("A page of Memos memo resources.");
+var getMemoInput = external_exports.strictObject({
+  name: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.")
+}).describe("Input parameters for reading a memo.");
+var getMemoOutput = external_exports.strictObject({
+  memo: external_exports.looseObject({
+    name: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional(),
+    state: external_exports.string().describe("The memo state returned by Memos.").optional(),
+    creator: external_exports.string().min(7).describe("The Memos user resource name in the format users/{user}.").optional(),
+    createTime: external_exports.iso.datetime({ offset: true }).describe("The memo creation time.").optional(),
+    updateTime: external_exports.iso.datetime({ offset: true }).describe("The memo update time.").optional(),
+    content: external_exports.string().describe("The memo Markdown content.").optional(),
+    visibility: external_exports.string().describe("The memo visibility returned by Memos.").optional(),
+    tags: external_exports.array(external_exports.string().describe("An extracted memo tag.")).describe("Tags extracted from the memo content.").optional(),
+    pinned: external_exports.boolean().describe("Whether the memo is pinned.").optional(),
+    attachments: external_exports.array(external_exports.looseObject({
+      name: external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.").optional(),
+      createTime: external_exports.iso.datetime({ offset: true }).describe("The attachment creation time.").optional(),
+      filename: external_exports.string().describe("The attachment filename.").optional(),
+      externalLink: external_exports.string().describe("The external storage URL when returned by Memos.").optional(),
+      type: external_exports.string().describe("The attachment MIME type.").optional(),
+      size: external_exports.string().describe("The attachment size in bytes, encoded as a string by the Memos API.").optional(),
+      memo: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional()
+    }).describe("Memos attachment metadata.")).describe("Attachments associated with the memo.").optional(),
+    parent: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional(),
+    snippet: external_exports.string().describe("A plain-text preview of the memo content.").optional(),
+    location: external_exports.looseObject({
+      placeholder: external_exports.string().describe("The location label.").optional(),
+      latitude: external_exports.number().describe("The latitude in decimal degrees.").optional(),
+      longitude: external_exports.number().describe("The longitude in decimal degrees.").optional()
+    }).describe("A geographic location attached to a memo.").optional(),
+    property: external_exports.looseObject({}).describe("Computed memo properties.").optional()
+  }).describe("A Memos memo resource.")
+}).describe("The memo response.");
+var deleteMemoInput = external_exports.strictObject({
+  name: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}."),
+  force: external_exports.boolean().describe("Whether to force deletion when the memo has associated data.").optional()
+}).describe("Input parameters for deleting a memo.");
+var deleteMemoOutput = external_exports.strictObject({
+  deleted: external_exports.boolean().describe("Whether Memos accepted the deletion."),
+  name: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.")
+}).describe("The memo deletion result.");
+var uploadAttachmentInput = external_exports.strictObject({
+  fileUrl: external_exports.url().describe("The public HTTP or HTTPS URL of the file to upload."),
+  filename: external_exports.string().min(1).describe("The filename to store in Memos."),
+  type: external_exports.string().min(1).describe("The MIME type; inferred from the download response when omitted.").optional(),
+  memo: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional(),
+  attachmentId: external_exports.string().min(1).max(36).describe("An optional caller-selected attachment ID.").optional()
+}).describe("Input parameters for uploading an attachment from a URL.");
+var uploadAttachmentOutput = external_exports.strictObject({
+  attachment: external_exports.looseObject({
+    name: external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.").optional(),
+    createTime: external_exports.iso.datetime({ offset: true }).describe("The attachment creation time.").optional(),
+    filename: external_exports.string().describe("The attachment filename.").optional(),
+    externalLink: external_exports.string().describe("The external storage URL when returned by Memos.").optional(),
+    type: external_exports.string().describe("The attachment MIME type.").optional(),
+    size: external_exports.string().describe("The attachment size in bytes, encoded as a string by the Memos API.").optional(),
+    memo: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional()
+  }).describe("Memos attachment metadata.")
+}).describe("The uploaded attachment response.");
+var listAttachmentsInput = external_exports.strictObject({
+  pageSize: external_exports.int().min(1).max(1e3).describe("The maximum number of resources to return.").optional(),
+  pageToken: external_exports.string().min(1).describe("The continuation token returned by a previous list action.").optional(),
+  filter: external_exports.string().min(1).describe("The Memos attachment filter expression.").optional(),
+  orderBy: external_exports.string().min(1).describe("The attachment ordering expression, such as create_time desc.").optional()
+}).describe("Input parameters for listing attachments.");
+var listAttachmentsOutput = external_exports.strictObject({
+  attachments: external_exports.array(external_exports.looseObject({
+    name: external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.").optional(),
+    createTime: external_exports.iso.datetime({ offset: true }).describe("The attachment creation time.").optional(),
+    filename: external_exports.string().describe("The attachment filename.").optional(),
+    externalLink: external_exports.string().describe("The external storage URL when returned by Memos.").optional(),
+    type: external_exports.string().describe("The attachment MIME type.").optional(),
+    size: external_exports.string().describe("The attachment size in bytes, encoded as a string by the Memos API.").optional(),
+    memo: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional()
+  }).describe("Memos attachment metadata.")).describe("The attachments returned by Memos."),
+  nextPageToken: external_exports.string().describe("The continuation token for the next page, or null when no next page exists.").nullable()
+}).describe("A page of Memos attachment metadata.");
+var getAttachmentInput = external_exports.strictObject({
+  name: external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.")
+}).describe("Input parameters for reading an attachment.");
+var getAttachmentOutput = external_exports.strictObject({
+  attachment: external_exports.looseObject({
+    name: external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.").optional(),
+    createTime: external_exports.iso.datetime({ offset: true }).describe("The attachment creation time.").optional(),
+    filename: external_exports.string().describe("The attachment filename.").optional(),
+    externalLink: external_exports.string().describe("The external storage URL when returned by Memos.").optional(),
+    type: external_exports.string().describe("The attachment MIME type.").optional(),
+    size: external_exports.string().describe("The attachment size in bytes, encoded as a string by the Memos API.").optional(),
+    memo: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional()
+  }).describe("Memos attachment metadata.")
+}).describe("The attachment metadata response.");
+var deleteAttachmentInput = external_exports.strictObject({
+  name: external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.")
+}).describe("Input parameters for deleting an attachment.");
+var deleteAttachmentOutput = external_exports.strictObject({
+  deleted: external_exports.boolean().describe("Whether Memos accepted the deletion."),
+  name: external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.")
+}).describe("The attachment deletion result.");
+var listMemoAttachmentsInput = external_exports.strictObject({
+  name: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}."),
+  pageSize: external_exports.int().min(1).max(1e3).describe("The maximum number of resources to return.").optional(),
+  pageToken: external_exports.string().min(1).describe("The continuation token returned by a previous list action.").optional()
+}).describe("Input parameters for listing a memo's attachments.");
+var listMemoAttachmentsOutput = external_exports.strictObject({
+  attachments: external_exports.array(external_exports.looseObject({
+    name: external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.").optional(),
+    createTime: external_exports.iso.datetime({ offset: true }).describe("The attachment creation time.").optional(),
+    filename: external_exports.string().describe("The attachment filename.").optional(),
+    externalLink: external_exports.string().describe("The external storage URL when returned by Memos.").optional(),
+    type: external_exports.string().describe("The attachment MIME type.").optional(),
+    size: external_exports.string().describe("The attachment size in bytes, encoded as a string by the Memos API.").optional(),
+    memo: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}.").optional()
+  }).describe("Memos attachment metadata.")).describe("The memo attachments returned by Memos."),
+  nextPageToken: external_exports.string().describe("The continuation token for the next page, or null when no next page exists.").nullable()
+}).describe("A page of attachments associated with the memo.");
+var setMemoAttachmentsInput = external_exports.strictObject({
+  name: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}."),
+  attachmentNames: external_exports.array(external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.")).describe("The complete desired list of attachment resource names; use an empty array to clear all attachments.")
+}).describe("Input parameters for replacing a memo's attachment set.");
+var setMemoAttachmentsOutput = external_exports.strictObject({
+  updated: external_exports.boolean().describe("Whether Memos accepted the attachment replacement."),
+  name: external_exports.string().min(7).describe("The Memos memo resource name in the format memos/{memo}."),
+  attachmentNames: external_exports.array(external_exports.string().min(13).describe("The Memos attachment resource name in the format attachments/{attachment}.")).describe("The attachment resource names sent to Memos.")
+}).describe("The memo attachment replacement result.");
+var getCurrentUserInput = external_exports.strictObject({}).describe("The input payload for reading the current Memos user.");
+var getCurrentUserOutput = external_exports.strictObject({
+  user: external_exports.looseObject({
+    name: external_exports.string().min(7).describe("The Memos user resource name in the format users/{user}.").optional(),
+    role: external_exports.string().describe("The user role returned by Memos.").optional(),
+    username: external_exports.string().describe("The unique Memos username.").optional(),
+    email: external_exports.string().describe("The user's email address.").optional(),
+    displayName: external_exports.string().describe("The user's display name.").optional(),
+    avatarUrl: external_exports.string().describe("The user's avatar URL.").optional(),
+    description: external_exports.string().describe("The user's profile description.").optional(),
+    state: external_exports.string().describe("The user state returned by Memos.").optional(),
+    createTime: external_exports.iso.datetime({ offset: true }).describe("The user creation time.").optional(),
+    updateTime: external_exports.iso.datetime({ offset: true }).describe("The user update time.").optional()
+  }).describe("A Memos user resource.")
+}).describe("The current Memos user response.");
+var listUsersInput = external_exports.strictObject({
+  pageSize: external_exports.int().min(1).max(1e3).describe("The maximum number of resources to return.").optional(),
+  pageToken: external_exports.string().min(1).describe("The continuation token returned by a previous list action.").optional(),
+  filter: external_exports.string().min(1).describe("The user filter expression; Memos v0.29 supports username equality.").optional(),
+  showDeleted: external_exports.boolean().describe("Whether deleted users should be included.").optional()
+}).describe("Input parameters for listing Memos users.");
+var listUsersOutput = external_exports.strictObject({
+  users: external_exports.array(external_exports.looseObject({
+    name: external_exports.string().min(7).describe("The Memos user resource name in the format users/{user}.").optional(),
+    role: external_exports.string().describe("The user role returned by Memos.").optional(),
+    username: external_exports.string().describe("The unique Memos username.").optional(),
+    email: external_exports.string().describe("The user's email address.").optional(),
+    displayName: external_exports.string().describe("The user's display name.").optional(),
+    avatarUrl: external_exports.string().describe("The user's avatar URL.").optional(),
+    description: external_exports.string().describe("The user's profile description.").optional(),
+    state: external_exports.string().describe("The user state returned by Memos.").optional(),
+    createTime: external_exports.iso.datetime({ offset: true }).describe("The user creation time.").optional(),
+    updateTime: external_exports.iso.datetime({ offset: true }).describe("The user update time.").optional()
+  }).describe("A Memos user resource.")).describe("The users returned by Memos."),
+  nextPageToken: external_exports.string().describe("The continuation token for the next page, or null when no next page exists.").nullable()
+}).describe("A page of Memos users.");
+var getUserInput = external_exports.strictObject({
+  name: external_exports.string().min(7).describe("The Memos user resource name in the format users/{user}."),
+  readMask: external_exports.string().min(1).describe("An optional comma-separated field mask for the user response.").optional()
+}).describe("Input parameters for reading a Memos user.");
+var getUserOutput = external_exports.strictObject({
+  user: external_exports.looseObject({
+    name: external_exports.string().min(7).describe("The Memos user resource name in the format users/{user}.").optional(),
+    role: external_exports.string().describe("The user role returned by Memos.").optional(),
+    username: external_exports.string().describe("The unique Memos username.").optional(),
+    email: external_exports.string().describe("The user's email address.").optional(),
+    displayName: external_exports.string().describe("The user's display name.").optional(),
+    avatarUrl: external_exports.string().describe("The user's avatar URL.").optional(),
+    description: external_exports.string().describe("The user's profile description.").optional(),
+    state: external_exports.string().describe("The user state returned by Memos.").optional(),
+    createTime: external_exports.iso.datetime({ offset: true }).describe("The user creation time.").optional(),
+    updateTime: external_exports.iso.datetime({ offset: true }).describe("The user update time.").optional()
+  }).describe("A Memos user resource.")
+}).describe("The Memos user response.");
+var memosActions = {
+  create_memo: {
+    description: "Create a Markdown memo on the connected Memos instance.",
+    effect: "write",
+    inputSchema: createMemoInput,
+    outputSchema: external_exports.toJSONSchema(createMemoOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_memos: {
+    description: "List memos with pagination, state selection, ordering, and CEL filtering.",
+    effect: "read",
+    inputSchema: listMemosInput,
+    outputSchema: external_exports.toJSONSchema(listMemosOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_memo: {
+    description: "Retrieve one memo by its Memos resource name.",
+    effect: "read",
+    inputSchema: getMemoInput,
+    outputSchema: external_exports.toJSONSchema(getMemoOutput, { io: "output", unrepresentable: "any" })
+  },
+  update_memo: {
+    description: "Update selected content, visibility, pin, state, time, or location fields on a memo.",
+    effect: "write",
+    inputSchema: updateMemoInput,
+    outputSchema: external_exports.toJSONSchema(updateMemoOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_memo: {
+    description: "Delete one memo, optionally forcing deletion when associated data exists.",
+    effect: "destructive",
+    inputSchema: deleteMemoInput,
+    outputSchema: external_exports.toJSONSchema(deleteMemoOutput, { io: "output", unrepresentable: "any" })
+  },
+  upload_attachment: {
+    description: "Download a public file URL and upload its bytes to the connected Memos instance.",
+    effect: "write",
+    inputSchema: uploadAttachmentInput,
+    outputSchema: external_exports.toJSONSchema(uploadAttachmentOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_attachments: {
+    description: "List attachment metadata with pagination, filtering, and ordering.",
+    effect: "read",
+    inputSchema: listAttachmentsInput,
+    outputSchema: external_exports.toJSONSchema(listAttachmentsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_attachment: {
+    description: "Retrieve one attachment's metadata by resource name.",
+    effect: "read",
+    inputSchema: getAttachmentInput,
+    outputSchema: external_exports.toJSONSchema(getAttachmentOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_attachment: {
+    description: "Delete one attachment by resource name.",
+    effect: "destructive",
+    inputSchema: deleteAttachmentInput,
+    outputSchema: external_exports.toJSONSchema(deleteAttachmentOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_memo_attachments: {
+    description: "List attachments associated with one memo.",
+    effect: "read",
+    inputSchema: listMemoAttachmentsInput,
+    outputSchema: external_exports.toJSONSchema(listMemoAttachmentsOutput, { io: "output", unrepresentable: "any" })
+  },
+  set_memo_attachments: {
+    description: "Replace the complete attachment set associated with one memo.",
+    effect: "write",
+    inputSchema: setMemoAttachmentsInput,
+    outputSchema: external_exports.toJSONSchema(setMemoAttachmentsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_current_user: {
+    description: "Retrieve the Memos user associated with the connected personal access token.",
+    effect: "read",
+    inputSchema: getCurrentUserInput,
+    outputSchema: external_exports.toJSONSchema(getCurrentUserOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_users: {
+    description: "List users visible to the connected Memos account.",
+    effect: "read",
+    inputSchema: listUsersInput,
+    outputSchema: external_exports.toJSONSchema(listUsersOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_user: {
+    description: "Retrieve one Memos user by resource name.",
+    effect: "read",
+    inputSchema: getUserInput,
+    outputSchema: external_exports.toJSONSchema(getUserOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/memos/index.ts
+function createMemosPlugin() {
+  return createProviderPlugin({
+    description: "Memos",
+    actions: memosActions,
+    credentialProbe: "get_current_user",
+    handlers: {
+      create_memo: createMemo,
+      list_memos: listMemos,
+      get_memo: getMemo,
+      update_memo: updateMemo,
+      delete_memo: deleteMemo,
+      upload_attachment: uploadAttachment,
+      list_attachments: listAttachments,
+      get_attachment: getAttachment,
+      delete_attachment: deleteAttachment,
+      list_memo_attachments: listMemoAttachments,
+      set_memo_attachments: setMemoAttachments,
+      get_current_user: getCurrentUser,
+      list_users: listUsers,
+      get_user: getUser
+    }
+  });
+}
+var memos_default = createMemosPlugin();
+export {
+  createMemosPlugin,
+  memos_default as default
+};