gogcli-mcp-contacts 2.1.0 → 2.3.0

package/dist/index.js

@@ -31074,7 +31074,7 @@ async function run(args, options = {}) {
 
 // ../gogcli-mcp/src/tools/utils.ts
 var accountParam = external_exports.string().optional().describe(
-  "Google account email to use (overrides GOG_ACCOUNT env var)"
+  "Google account email to use, e.g. you@gmail.com \u2014 must be the full address, not a bare username. Overrides the GOG_ACCOUNT env var. Omit to use the single configured account."
 );
 var ids = {
   course: external_exports.string().describe("Course ID"),
@@ -31133,26 +31133,41 @@ function toError(err) {
 }
 var AUTH_ERROR_PATTERN = /\b(401|unauthorized|token.*(expired|revoked)|invalid_grant)\b/i;
 var TRANSIENT_ERROR_PATTERN = /\b429\b|\b5\d\d\b|\bquota\b|rateLimit|\bDEADLINE_EXCEEDED\b/i;
+var GRID_LIMIT_ERROR_PATTERN = /exceeds grid limits/i;
 var AUTH_HINT = "\n\nAuthentication may have expired. Use gog_auth_add to re-authorize the account. Ask the user if they would like to re-authenticate.";
 var TRANSIENT_HINT = "\n\nThis error is often transient. Retry the same call before trying a different approach (do not fall back to smaller writes or row-by-row operations).";
+var GRID_LIMIT_HINT = "\n\nThe target range is outside the sheet's current grid. Add the missing rows or columns first with gog_sheets_insert (dimension: rows or cols), then retry the write.";
+function formatAccountList(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (Array.isArray(parsed?.accounts)) {
+      return parsed.accounts.map((a) => a?.email).filter(Boolean).join("\n");
+    }
+  } catch {
+  }
+  return raw.trim();
+}
+async function diagnose(err) {
+  const errText = toError(err).content[0].text;
+  const isAuthError = AUTH_ERROR_PATTERN.test(errText);
+  const isTransientError = !isAuthError && TRANSIENT_ERROR_PATTERN.test(errText);
+  const isGridLimitError = GRID_LIMIT_ERROR_PATTERN.test(errText);
+  const hint = isAuthError ? AUTH_HINT : isTransientError ? TRANSIENT_HINT : isGridLimitError ? GRID_LIMIT_HINT : "";
+  try {
+    const accounts = formatAccountList(await run(["auth", "list"]));
+    return toText(`${errText}
+
+Configured accounts:
+${accounts || "(none)"}${hint}`);
+  } catch {
+    return toText(`${errText}${hint}`);
+  }
+}
 async function runOrDiagnose(args, options) {
   try {
     return toText(await run(args, options));
   } catch (err) {
-    const base = toError(err);
-    const errText = base.content[0].text;
-    const isAuthError = AUTH_ERROR_PATTERN.test(errText);
-    const isTransientError = !isAuthError && TRANSIENT_ERROR_PATTERN.test(errText);
-    const hint = isAuthError ? AUTH_HINT : isTransientError ? TRANSIENT_HINT : "";
-    try {
-      const accounts = await run(["auth", "list"]);
-      return toText(`${errText}
-
-Configured accounts:
-${accounts}${hint}`);
-    } catch {
-      return toText(`${errText}${hint}`);
-    }
+    return diagnose(err);
   }
 }
 
@@ -31275,9 +31290,15 @@ function registerContactsTools(server2) {
 
 // ../gogcli-mcp/src/tools/sheets.ts
 var cellValueParam = external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean(), external_exports.null()]);
+var dryRunParam = external_exports.boolean().optional().describe(
+  "Preview the operation without modifying the sheet (gog --dry-run): reports the intended actions and exits without writing."
+);
+var failIfNotEmptyParam = external_exports.boolean().optional().describe(
+  'Safety guard against silent overwrites: before writing, read the target range and refuse the write if any target cell already holds data. Costs one extra read. Anchor ranges (e.g. "Sheet1!A1") are expanded to the full area your values will cover; explicit and named ranges are checked as-is.'
+);
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.1.0" : "0.0.0";
+var VERSION = true ? "2.3.0" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31337,6 +31358,129 @@ function registerExtraContactsTools(server2) {
     if (type) args.push(`--type=${type}`);
     return runOrDiagnose(args, { account });
   });
+  server2.registerTool("gog_contacts_update", {
+    description: "Update an existing Google Contact. Empty string clears a field; repeatable fields (url/address/custom/relation) take comma/semicolon-separated lists.",
+    inputSchema: {
+      resourceName: external_exports.string().describe("Contact resource name (people/...)"),
+      given: external_exports.string().optional().describe("Given (first) name"),
+      family: external_exports.string().optional().describe("Family (last) name"),
+      email: external_exports.string().optional().describe("Email address (empty string clears)"),
+      phone: external_exports.string().optional().describe("Phone number (empty string clears)"),
+      org: external_exports.string().optional().describe("Organization/company name (empty string clears)"),
+      title: external_exports.string().optional().describe("Job title (empty string clears)"),
+      url: external_exports.string().optional().describe("URL(s), comma-separated (empty string clears all)"),
+      note: external_exports.string().optional().describe("Note/biography (empty string clears)"),
+      address: external_exports.string().optional().describe("Postal address(es), semicolon-separated (empty string clears all)"),
+      birthday: external_exports.string().optional().describe("Birthday in YYYY-MM-DD (empty string clears)"),
+      ignoreEtag: external_exports.boolean().optional().describe("Allow update even if a supplied etag is stale (may overwrite concurrent changes)"),
+      account: accountParam
+    }
+  }, async ({ resourceName, given, family, email: email3, phone, org, title, url: url2, note, address, birthday, ignoreEtag, account }) => {
+    const args = ["contacts", "update", resourceName];
+    if (given !== void 0) args.push(`--given=${given}`);
+    if (family !== void 0) args.push(`--family=${family}`);
+    if (email3 !== void 0) args.push(`--email=${email3}`);
+    if (phone !== void 0) args.push(`--phone=${phone}`);
+    if (org !== void 0) args.push(`--org=${org}`);
+    if (title !== void 0) args.push(`--title=${title}`);
+    if (url2 !== void 0) args.push(`--url=${url2}`);
+    if (note !== void 0) args.push(`--note=${note}`);
+    if (address !== void 0) args.push(`--address=${address}`);
+    if (birthday !== void 0) args.push(`--birthday=${birthday}`);
+    if (ignoreEtag) args.push("--ignore-etag");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_contacts_delete", {
+    description: "Delete a Google Contact by resource name.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      resourceName: external_exports.string().describe("Contact resource name (people/...)"),
+      account: accountParam
+    }
+  }, async ({ resourceName, account }) => {
+    return runOrDiagnose(["contacts", "delete", resourceName], { account });
+  });
+  server2.registerTool("gog_contacts_export", {
+    description: "Export contacts as vCard (.vcf). Provide a selector (resource name, email, or name), or use query / all to export multiple.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      selector: external_exports.string().optional().describe("Contact resource name (people/...), email, or name"),
+      query: external_exports.string().optional().describe("Search query to export (max 30 results)"),
+      all: external_exports.boolean().optional().describe("Export all personal contacts"),
+      out: external_exports.string().optional().describe("Output path (.vcf), or - for stdout (default: stdout)"),
+      max: external_exports.number().optional().describe("Max results for query (1-30)"),
+      page: external_exports.string().optional().describe("Start page token for all"),
+      account: accountParam
+    }
+  }, async ({ selector, query, all, out, max, page, account }) => {
+    const args = ["contacts", "export"];
+    if (selector) args.push(selector);
+    if (query) args.push(`--query=${query}`);
+    if (all) args.push("--all");
+    if (out) args.push(`--out=${out}`);
+    if (max !== void 0) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_contacts_dedupe", {
+    description: "Find likely duplicate personal contacts (preview only \u2014 does not modify anything).",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      match: external_exports.string().optional().describe("Match fields, comma-separated from email,phone,name (default: email,phone)"),
+      max: external_exports.number().optional().describe("Max contacts to scan (0 = all)"),
+      account: accountParam
+    }
+  }, async ({ match, max, account }) => {
+    const args = ["contacts", "dedupe"];
+    if (match) args.push(`--match=${match}`);
+    if (max !== void 0) args.push(`--max=${max}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_contacts_directory_list", {
+    description: "List people from the Google Workspace directory (domain shared contacts).",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      max: external_exports.number().optional().describe("Max results (default: 50)"),
+      page: external_exports.string().optional().describe("Page token"),
+      all: external_exports.boolean().optional().describe("Fetch all pages"),
+      account: accountParam
+    }
+  }, async ({ max, page, all, account }) => {
+    const args = ["contacts", "directory", "list"];
+    if (max !== void 0) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    if (all) args.push("--all");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_contacts_other_list", {
+    description: 'List "other contacts" \u2014 auto-collected addresses (e.g. people you have emailed) that are not in your saved contacts.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      max: external_exports.number().optional().describe("Max results (default: 100)"),
+      page: external_exports.string().optional().describe("Page token"),
+      all: external_exports.boolean().optional().describe("Fetch all pages"),
+      account: accountParam
+    }
+  }, async ({ max, page, all, account }) => {
+    const args = ["contacts", "other", "list"];
+    if (max !== void 0) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    if (all) args.push("--all");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_contacts_other_search", {
+    description: 'Search "other contacts" \u2014 auto-collected addresses not in your saved contacts.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: external_exports.string().describe("Search query"),
+      max: external_exports.number().optional().describe("Max results (default: 50)"),
+      account: accountParam
+    }
+  }, async ({ query, max, account }) => {
+    const args = ["contacts", "other", "search", query];
+    if (max !== void 0) args.push(`--max=${max}`);
+    return runOrDiagnose(args, { account });
+  });
   server2.registerTool("gog_people_raw", {
     description: "Dump the raw People API response as JSON (lossless; for scripting and LLM consumption).",
     annotations: { readOnlyHint: true },

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-contacts",
   "display_name": "gogcli (Contacts)",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Extended Google Contacts for Claude via gogcli — auth + Contacts + Workspace directory (People API)",
   "author": {
     "name": "Chris Hall",
@@ -113,6 +113,34 @@
     {
       "name": "gog_people_raw",
       "description": "Dump raw People API JSON for a person"
+    },
+    {
+      "name": "gog_contacts_update",
+      "description": "Update an existing contact (empty string clears a field)"
+    },
+    {
+      "name": "gog_contacts_delete",
+      "description": "Delete a contact by resource name"
+    },
+    {
+      "name": "gog_contacts_export",
+      "description": "Export contacts as vCard (.vcf)"
+    },
+    {
+      "name": "gog_contacts_dedupe",
+      "description": "Find likely duplicate contacts (preview only)"
+    },
+    {
+      "name": "gog_contacts_directory_list",
+      "description": "List people from the Workspace directory"
+    },
+    {
+      "name": "gog_contacts_other_list",
+      "description": "List auto-collected other contacts"
+    },
+    {
+      "name": "gog_contacts_other_search",
+      "description": "Search auto-collected other contacts"
     }
   ],
   "compatibility": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp-contacts",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "mcpName": "io.github.chrischall/gogcli-mcp-contacts",
   "description": "Extended Google Contacts + People MCP server via gogcli — auth + Contacts + Workspace directory (People API)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/src/tools/contacts-extra.ts

@@ -59,6 +59,136 @@ export function registerExtraContactsTools(server: McpServer): void {
     return runOrDiagnose(args, { account });
   });
 
+  server.registerTool('gog_contacts_update', {
+    description: 'Update an existing Google Contact. Empty string clears a field; repeatable fields (url/address/custom/relation) take comma/semicolon-separated lists.',
+    inputSchema: {
+      resourceName: z.string().describe('Contact resource name (people/...)'),
+      given: z.string().optional().describe('Given (first) name'),
+      family: z.string().optional().describe('Family (last) name'),
+      email: z.string().optional().describe('Email address (empty string clears)'),
+      phone: z.string().optional().describe('Phone number (empty string clears)'),
+      org: z.string().optional().describe('Organization/company name (empty string clears)'),
+      title: z.string().optional().describe('Job title (empty string clears)'),
+      url: z.string().optional().describe('URL(s), comma-separated (empty string clears all)'),
+      note: z.string().optional().describe('Note/biography (empty string clears)'),
+      address: z.string().optional().describe('Postal address(es), semicolon-separated (empty string clears all)'),
+      birthday: z.string().optional().describe('Birthday in YYYY-MM-DD (empty string clears)'),
+      ignoreEtag: z.boolean().optional().describe('Allow update even if a supplied etag is stale (may overwrite concurrent changes)'),
+      account: accountParam,
+    },
+  }, async ({ resourceName, given, family, email, phone, org, title, url, note, address, birthday, ignoreEtag, account }) => {
+    const args = ['contacts', 'update', resourceName];
+    if (given !== undefined) args.push(`--given=${given}`);
+    if (family !== undefined) args.push(`--family=${family}`);
+    if (email !== undefined) args.push(`--email=${email}`);
+    if (phone !== undefined) args.push(`--phone=${phone}`);
+    if (org !== undefined) args.push(`--org=${org}`);
+    if (title !== undefined) args.push(`--title=${title}`);
+    if (url !== undefined) args.push(`--url=${url}`);
+    if (note !== undefined) args.push(`--note=${note}`);
+    if (address !== undefined) args.push(`--address=${address}`);
+    if (birthday !== undefined) args.push(`--birthday=${birthday}`);
+    if (ignoreEtag) args.push('--ignore-etag');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_contacts_delete', {
+    description: 'Delete a Google Contact by resource name.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      resourceName: z.string().describe('Contact resource name (people/...)'),
+      account: accountParam,
+    },
+  }, async ({ resourceName, account }) => {
+    return runOrDiagnose(['contacts', 'delete', resourceName], { account });
+  });
+
+  server.registerTool('gog_contacts_export', {
+    description: 'Export contacts as vCard (.vcf). Provide a selector (resource name, email, or name), or use query / all to export multiple.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      selector: z.string().optional().describe('Contact resource name (people/...), email, or name'),
+      query: z.string().optional().describe('Search query to export (max 30 results)'),
+      all: z.boolean().optional().describe('Export all personal contacts'),
+      out: z.string().optional().describe('Output path (.vcf), or - for stdout (default: stdout)'),
+      max: z.number().optional().describe('Max results for query (1-30)'),
+      page: z.string().optional().describe('Start page token for all'),
+      account: accountParam,
+    },
+  }, async ({ selector, query, all, out, max, page, account }) => {
+    const args = ['contacts', 'export'];
+    if (selector) args.push(selector);
+    if (query) args.push(`--query=${query}`);
+    if (all) args.push('--all');
+    if (out) args.push(`--out=${out}`);
+    if (max !== undefined) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_contacts_dedupe', {
+    description: 'Find likely duplicate personal contacts (preview only — does not modify anything).',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      match: z.string().optional().describe('Match fields, comma-separated from email,phone,name (default: email,phone)'),
+      max: z.number().optional().describe('Max contacts to scan (0 = all)'),
+      account: accountParam,
+    },
+  }, async ({ match, max, account }) => {
+    const args = ['contacts', 'dedupe'];
+    if (match) args.push(`--match=${match}`);
+    if (max !== undefined) args.push(`--max=${max}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_contacts_directory_list', {
+    description: 'List people from the Google Workspace directory (domain shared contacts).',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      max: z.number().optional().describe('Max results (default: 50)'),
+      page: z.string().optional().describe('Page token'),
+      all: z.boolean().optional().describe('Fetch all pages'),
+      account: accountParam,
+    },
+  }, async ({ max, page, all, account }) => {
+    const args = ['contacts', 'directory', 'list'];
+    if (max !== undefined) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    if (all) args.push('--all');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_contacts_other_list', {
+    description: 'List "other contacts" — auto-collected addresses (e.g. people you have emailed) that are not in your saved contacts.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      max: z.number().optional().describe('Max results (default: 100)'),
+      page: z.string().optional().describe('Page token'),
+      all: z.boolean().optional().describe('Fetch all pages'),
+      account: accountParam,
+    },
+  }, async ({ max, page, all, account }) => {
+    const args = ['contacts', 'other', 'list'];
+    if (max !== undefined) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    if (all) args.push('--all');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_contacts_other_search', {
+    description: 'Search "other contacts" — auto-collected addresses not in your saved contacts.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: z.string().describe('Search query'),
+      max: z.number().optional().describe('Max results (default: 50)'),
+      account: accountParam,
+    },
+  }, async ({ query, max, account }) => {
+    const args = ['contacts', 'other', 'search', query];
+    if (max !== undefined) args.push(`--max=${max}`);
+    return runOrDiagnose(args, { account });
+  });
+
   server.registerTool('gog_people_raw', {
     description: 'Dump the raw People API response as JSON (lossless; for scripting and LLM consumption).',
     annotations: { readOnlyHint: true },

package/tests/tools/contacts-extra.test.ts

@@ -73,6 +73,148 @@ describe('gog_people_relations', () => {
   });
 });
 
+describe('gog_contacts_update', () => {
+  it('calls runOrDiagnose with just resourceName', async () => {
+    await handlers.get('gog_contacts_update')!({ resourceName: 'people/c1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'update', 'people/c1'], { account: undefined });
+  });
+
+  it('passes all fields including empty-string clears', async () => {
+    await handlers.get('gog_contacts_update')!({
+      resourceName: 'people/c1',
+      given: 'Ada',
+      family: 'Lovelace',
+      email: '',
+      phone: '+1',
+      org: 'Analytical',
+      title: 'Engineer',
+      url: 'https://a.com',
+      note: 'hi',
+      address: '1 St;City',
+      birthday: '1815-12-10',
+      ignoreEtag: true,
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      [
+        'contacts', 'update', 'people/c1',
+        '--given=Ada', '--family=Lovelace', '--email=', '--phone=+1',
+        '--org=Analytical', '--title=Engineer', '--url=https://a.com',
+        '--note=hi', '--address=1 St;City', '--birthday=1815-12-10', '--ignore-etag',
+      ],
+      { account: undefined },
+    );
+  });
+
+  it('omits --ignore-etag when false', async () => {
+    await handlers.get('gog_contacts_update')!({ resourceName: 'people/c1', ignoreEtag: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'update', 'people/c1'], { account: undefined });
+  });
+});
+
+describe('gog_contacts_delete', () => {
+  it('calls runOrDiagnose with resourceName', async () => {
+    await handlers.get('gog_contacts_delete')!({ resourceName: 'people/c1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'delete', 'people/c1'], { account: undefined });
+  });
+});
+
+describe('gog_contacts_export', () => {
+  it('calls runOrDiagnose with no options', async () => {
+    await handlers.get('gog_contacts_export')!({});
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'export'], { account: undefined });
+  });
+
+  it('passes selector and all flags', async () => {
+    await handlers.get('gog_contacts_export')!({
+      selector: 'people/c1',
+      query: 'ada',
+      all: true,
+      out: 'out.vcf',
+      max: 10,
+      page: 'tok',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['contacts', 'export', 'people/c1', '--query=ada', '--all', '--out=out.vcf', '--max=10', '--page=tok'],
+      { account: undefined },
+    );
+  });
+
+  it('omits --all when false', async () => {
+    await handlers.get('gog_contacts_export')!({ all: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'export'], { account: undefined });
+  });
+});
+
+describe('gog_contacts_dedupe', () => {
+  it('calls runOrDiagnose with no options', async () => {
+    await handlers.get('gog_contacts_dedupe')!({});
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'dedupe'], { account: undefined });
+  });
+
+  it('passes --match and --max', async () => {
+    await handlers.get('gog_contacts_dedupe')!({ match: 'name', max: 100 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['contacts', 'dedupe', '--match=name', '--max=100'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_contacts_directory_list', () => {
+  it('calls runOrDiagnose with no options', async () => {
+    await handlers.get('gog_contacts_directory_list')!({});
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'directory', 'list'], { account: undefined });
+  });
+
+  it('passes pagination flags', async () => {
+    await handlers.get('gog_contacts_directory_list')!({ max: 50, page: 'tok', all: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['contacts', 'directory', 'list', '--max=50', '--page=tok', '--all'],
+      { account: undefined },
+    );
+  });
+
+  it('omits --all when false', async () => {
+    await handlers.get('gog_contacts_directory_list')!({ all: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'directory', 'list'], { account: undefined });
+  });
+});
+
+describe('gog_contacts_other_list', () => {
+  it('calls runOrDiagnose with no options', async () => {
+    await handlers.get('gog_contacts_other_list')!({});
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'other', 'list'], { account: undefined });
+  });
+
+  it('passes pagination flags', async () => {
+    await handlers.get('gog_contacts_other_list')!({ max: 100, page: 'tok', all: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['contacts', 'other', 'list', '--max=100', '--page=tok', '--all'],
+      { account: undefined },
+    );
+  });
+
+  it('omits --all when false', async () => {
+    await handlers.get('gog_contacts_other_list')!({ all: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'other', 'list'], { account: undefined });
+  });
+});
+
+describe('gog_contacts_other_search', () => {
+  it('calls runOrDiagnose with query', async () => {
+    await handlers.get('gog_contacts_other_search')!({ query: 'ada' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'other', 'search', 'ada'], { account: undefined });
+  });
+
+  it('passes --max when provided', async () => {
+    await handlers.get('gog_contacts_other_search')!({ query: 'ada', max: 25 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['contacts', 'other', 'search', 'ada', '--max=25'],
+      { account: undefined },
+    );
+  });
+});
+
 describe('gog_people_raw', () => {
   it('calls runOrDiagnose with userId', async () => {
     await handlers.get('gog_people_raw')!({ userId: 'people/c123' });