@zegazone_mcp/mcp 2.0.1 → 2.0.3

package/dist/ops.js

@@ -6,6 +6,8 @@ export const OP_TOOL_MAP = {
     ui_state_get: "ui.state.get",
     ui_state_set: "ui.state.set",
     collections_list: "collections.list",
+    collections_get: "collections.get",
+    collections_get_by_slug: "collections.get_by_slug",
     collections_batch_get: "collections.batch.get",
     collections_export: "collections.export",
     collections_create: "collections.create",
@@ -38,6 +40,7 @@ export const OP_TOOL_MAP = {
     collaborators_invite_accept: "collaborators.invite.accept",
     collaborators_invite_decline: "collaborators.invite.decline",
     media_list: "media.list",
+    media_get: "media.get",
     media_search: "media.search",
     media_batch_list: "media.batch.list",
     media_download: "media.download",

package/dist/tool-metadata.js

@@ -6,6 +6,8 @@ export const TOOL_CATEGORIES = {
     ui_state_get: "UI",
     ui_state_set: "UI",
     collections_list: "Collections",
+    collections_get: "Collections",
+    collections_get_by_slug: "Collections",
     collections_batch_get: "Collections",
     collections_export: "Collections",
     collections_create: "Collections",
@@ -38,6 +40,7 @@ export const TOOL_CATEGORIES = {
     collaborators_invite_accept: "Collaboration",
     collaborators_invite_decline: "Collaboration",
     media_list: "Media",
+    media_get: "Media",
     media_search: "Media",
     media_batch_list: "Media",
     media_download: "Media",
@@ -66,6 +69,8 @@ export const TOOL_DESCRIPTIONS = {
     ui_state_get: "Use when you need to know which collection and media item are currently open in the user's Zegazone UI — keeps agent actions aligned with what they see.",
     ui_state_set: "Use when the agent should drive the app: open a collection, select a media item, or sync the UI to match your workflow.",
     collections_list: "Use when you need to see what collections the user owns — names, tags, sharing level, thumbnails — before uploading media, publishing, or inviting collaborators.",
+    collections_get: "Look up a specific collection by its ID. Use this when you know the collection ID and need its name, description, sharing status, or other details.",
+    collections_get_by_slug: "Resolve a collection from a public share URL handle and slug (e.g. charliefairbairn/boating). Use when the agent has a link and needs the collection id or metadata.",
     collections_batch_get: "Use when you already have a list of collection ids and need full metadata for several at once without listing everything.",
     collections_export: "Use when the user wants a portable dump of a collection (metadata and media references) for backup or migration.",
     collections_create: "Use when starting a new collection from scratch. Set name, tags, NSFW flag, and optional parent for sub-collections.",
@@ -97,8 +102,9 @@ export const TOOL_DESCRIPTIONS = {
     collaborators_invites_received: "Use when the user asks what collections they were invited to.",
     collaborators_invite_accept: "Use after the user confirms they want access to a shared collection.",
     collaborators_invite_decline: "Use when refusing a collaboration invite.",
-    media_list: "Use to list media inside a collection — the main way to see what's already uploaded before adding more.",
-    media_search: "Use when filtering media within one or more collections by name, tag, or type.",
+    media_list: "Use to list media inside accessible collections — filter by collection_id, viewer type, tags, or other metadata before adding more.",
+    media_get: "Look up a specific media item by its ID. Use this when you know the media ID and need its description, tags, thumbnail, or other details.",
+    media_search: "Search for media items by name, description, or tags. Use this to find a specific item when you don't know its ID.",
     media_batch_list: "Use when you have many media ids and need rows for all of them in one call.",
     media_download: "Use when you need a time-limited download URL for a media item's main file.",
     media_create: "Use when adding new content to a collection from a URL (image, video, website, etc.). Requires viewer type.",

package/dist/tool-schemas.js

@@ -136,11 +136,63 @@ export const mediaDescribeSchema = z
     media_id: z.number().int().positive(),
 })
     .catchall(z.unknown());
+export const mediaGetSchema = z
+    .object({
+    args: z.record(z.unknown()).optional(),
+    media_id: z.number().int().positive(),
+})
+    .catchall(z.unknown());
+export const collectionsGetSchema = z
+    .object({
+    args: z.record(z.unknown()).optional(),
+    collection_id: z.number().int().positive(),
+})
+    .catchall(z.unknown());
+export const collectionsGetBySlugSchema = z
+    .object({
+    args: z.record(z.unknown()).optional(),
+    handle: z.string().min(1).describe("Publish handle from the share URL, without @."),
+    slug: z.string().min(1).describe("Collection slug from the share URL."),
+})
+    .catchall(z.unknown());
+export const mediaSearchSchema = z
+    .object({
+    args: z.record(z.unknown()).optional(),
+    query: z.string().min(1).describe("Search text matched against name, description, and tags."),
+    collection_id: z.number().int().positive().optional(),
+    include_archived: z.boolean().optional(),
+    limit: z.number().int().positive().optional(),
+    offset: z.number().int().min(0).optional(),
+})
+    .catchall(z.unknown());
+export const mediaListSchema = z
+    .object({
+    args: z.record(z.unknown()).optional(),
+    collection_id: z.number().int().positive().optional(),
+    tag: z.string().optional(),
+    tags: tagsSchema,
+    name_contains: z.string().optional(),
+    description_contains: z.string().optional(),
+    type: z.string().optional(),
+    viewer: viewerEnum.optional(),
+    created_after: z.string().optional(),
+    created_before: z.string().optional(),
+    is_nsfw: z.boolean().optional(),
+    include_archived: z.boolean().optional(),
+    limit: z.number().int().positive().optional(),
+    offset: z.number().int().min(0).optional(),
+})
+    .catchall(z.unknown());
 export const TYPED_TOOL_SCHEMAS = {
     collections_create: collectionsCreateSchema,
     collections_update: collectionsUpdateSchema,
+    collections_get: collectionsGetSchema,
+    collections_get_by_slug: collectionsGetBySlugSchema,
     media_create: mediaCreateSchema,
     media_update: mediaUpdateSchema,
+    media_list: mediaListSchema,
+    media_get: mediaGetSchema,
+    media_search: mediaSearchSchema,
     ui_state_set: uiStateSetSchema,
     media_describe: mediaDescribeSchema,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zegazone_mcp/mcp",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "type": "module",
   "description": "MCP server wrapper for Zegazone thirdparty-v1 API",
   "publishConfig": {

package/scripts/oauth-pair.mjs

@@ -13,7 +13,8 @@
  */
 
 import crypto from "node:crypto";
-import fs from "node:fs/promises";
+import fs from "node:fs";
+import fsPromises from "node:fs/promises";
 import http from "node:http";
 import path from "node:path";
 import os from "node:os";
@@ -52,6 +53,14 @@ function randomState() {
   return base64url(crypto.randomBytes(16));
 }
 
+function isWsl() {
+  try {
+    return fs.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft");
+  } catch {
+    return false;
+  }
+}
+
 function openBrowser(url) {
   const plat = process.platform;
   const detached = { detached: true, stdio: "ignore" };
@@ -103,10 +112,10 @@ async function writeCredentials(filePath, tokens) {
     access_token: tokens.access_token,
     access_expires_at_ms,
   };
-  await fs.mkdir(path.dirname(filePath), { recursive: true });
+  await fsPromises.mkdir(path.dirname(filePath), { recursive: true });
   const tmp = `${filePath}.${process.pid}.tmp`;
-  await fs.writeFile(tmp, `${JSON.stringify(doc, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
-  await fs.rename(tmp, filePath);
+  await fsPromises.writeFile(tmp, `${JSON.stringify(doc, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+  await fsPromises.rename(tmp, filePath);
 }
 
 function buildAuthorizeUrl(redirectUri, codeChallenge, state) {
@@ -210,9 +219,20 @@ async function main() {
     });
   });
 
-  console.error("Opening browser for Zegazone login…");
-  console.error(`If it does not open, visit:\n${authorizeUrl}\n`);
-  openBrowser(authorizeUrl);
+  if (isWsl()) {
+    console.error("Running in WSL2 — cannot open a browser automatically.");
+    console.error("Open this URL in your Windows browser to authorise:\n");
+    console.error(`  ${authorizeUrl}\n`);
+    console.error("Waiting for the browser callback (up to 10 minutes)…");
+  } else {
+    console.error("Opening browser for Zegazone login…");
+    console.error(`If the browser does not open, visit:\n  ${authorizeUrl}\n`);
+    openBrowser(authorizeUrl);
+  }
+
+  const heartbeat = setInterval(() => {
+    process.stderr.write(".");
+  }, 10_000);
 
   try {
     await done;
@@ -222,6 +242,9 @@ async function main() {
     const msg = e instanceof Error ? e.message : String(e);
     console.error(msg);
     process.exit(1);
+  } finally {
+    clearInterval(heartbeat);
+    process.stderr.write("\n");
   }
 }