@hasna/connectors 1.3.45 → 1.3.46

package/bin/index.js

@@ -1909,7 +1909,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/connectors",
-    version: "1.3.45",
+    version: "1.3.46",
     description: "Open source connector library - Install API connectors with a single command",
     type: "module",
     bin: {
@@ -1941,11 +1941,12 @@ var init_package = __esm(() => {
       "build:dashboard": "cd dashboard && bun run build",
       postinstall: 'mkdir -p $HOME/.hasna/connectors 2>/dev/null || true; [ "$SKIP_DASHBOARD" = "1" ] || [ ! -f dashboard/package.json ] || [ -d dashboard/node_modules ] || (cd dashboard && bun install)',
       dev: "bun run ./src/cli/index.tsx",
+      "check:package-secrets": "bun run scripts/check-package-secrets.ts",
       typecheck: "tsc --noEmit && tsc -p tsconfig.social.json --noEmit",
       test: "bun test",
       "secrets:scan:npmrc": "bun run scripts/scan-npmrc-auth.mjs",
       "sdk:build": "cd sdk && bun run build",
-      prepublishOnly: "bun run secrets:scan:npmrc && bun run build && bun test"
+      prepublishOnly: "bun run secrets:scan:npmrc && bun run check:package-secrets && bun run build && bun test"
     },
     keywords: [
       "connectors",
@@ -22235,6 +22236,13 @@ var init_ai_ml = __esm(() => {
       category: "AI & ML",
       tags: ["transcription", "meetings", "ai"]
     },
+    {
+      name: "wandb",
+      displayName: "Weights & Biases",
+      description: "ML experiment tracking and run management via GraphQL",
+      category: "AI & ML",
+      tags: ["ml", "experiments", "tracking"]
+    },
     {
       name: "wato",
       displayName: "Wato",
@@ -22242,6 +22250,13 @@ var init_ai_ml = __esm(() => {
       category: "AI & ML",
       tags: ["ai", "agents", "memory", "workflows"]
     },
+    {
+      name: "weights-biases",
+      displayName: "Weights & Biases",
+      description: "ML experiment tracking (runs, events, search)",
+      category: "AI & ML",
+      tags: ["ai", "ml", "wandb", "experiment-tracking"]
+    },
     {
       name: "wavelineextract",
       displayName: "Waveline Extract",
@@ -23886,6 +23901,20 @@ var init_business_tools = __esm(() => {
       description: "HR platform for employees, leave, attendance, and timesheets",
       category: "Business Tools",
       tags: ["hr", "employees", "zoho"]
+    },
+    {
+      name: "zymbly",
+      displayName: "Zymbly",
+      description: "Aircraft maintenance and CMMS platform for work orders, parts, and maintenance notes",
+      category: "Business Tools",
+      tags: ["maintenance", "aircraft", "work-orders", "cmms"]
+    },
+    {
+      name: "zotero",
+      displayName: "Zotero",
+      description: "Bibliography and reference library API for items, collections, and attachments",
+      category: "Business Tools",
+      tags: ["bibliography", "citations", "research", "library", "references"]
     }
   ];
 });
@@ -26414,6 +26443,13 @@ var init_developer_tools = __esm(() => {
       category: "Developer Tools",
       tags: ["cdn", "dns", "edge"]
     },
+    {
+      name: "cloudflare-workers",
+      displayName: "Cloudflare Workers",
+      description: "Cloudflare Workers REST API connector for scripts, multipart uploads, routes, deployments, versions, secrets, cron schedules, tails, subdomains, beta Workers, and scoped raw account or zone requests",
+      category: "Developer Tools",
+      tags: ["cloudflare", "workers", "serverless", "edge", "deployments", "developer-tools"]
+    },
     {
       name: "googlecloud",
       displayName: "Google Cloud",
@@ -28821,6 +28857,13 @@ var init_marketing_sales = __esm(() => {
       description: "Reviews and user-generated content platform for e-commerce",
       category: "Marketing & Sales",
       tags: ["reviews", "ugc", "ecommerce", "marketing"]
+    },
+    {
+      name: "zoominfo",
+      displayName: "ZoomInfo",
+      description: "ZoomInfo B2B sales intelligence API for contact and company search, enrichment, lookup, and output field discovery",
+      category: "Marketing & Sales",
+      tags: ["sales-intelligence", "enrichment", "contacts", "companies", "b2b"]
     }
   ];
 });
@@ -31471,6 +31514,79 @@ var init_installer = __esm(() => {
   CONNECTORS_DIR = resolveConnectorsDir();
 });
 
+// src/lib/compact-output.ts
+function parseNonNegativeInt(raw, flag) {
+  if (raw === undefined)
+    return { value: undefined };
+  if (!/^\d+$/.test(raw)) {
+    return {
+      value: undefined,
+      error: `Invalid value for ${flag}: '${raw}'. Expected a non-negative integer.`
+    };
+  }
+  return { value: parseInt(raw, 10) };
+}
+function normalizeLimit(value, fallback, max = MAX_COMPACT_LIMIT) {
+  if (value === undefined || !Number.isFinite(value))
+    return fallback;
+  return Math.min(Math.max(1, Math.floor(value)), max);
+}
+function parseCursor(raw) {
+  if (raw === undefined || raw === "")
+    return { value: 0 };
+  return parseNonNegativeInt(raw, "--cursor");
+}
+function pageItems(items, options) {
+  const offset = Math.max(0, options.offset ?? 0);
+  const limit = options.limit === undefined ? undefined : Math.max(1, Math.floor(options.limit));
+  const paged = limit === undefined ? items.slice(offset) : items.slice(offset, offset + limit);
+  const nextOffset = limit === undefined || offset + paged.length >= items.length ? null : offset + paged.length;
+  return {
+    items: paged,
+    total: items.length,
+    offset,
+    limit: limit ?? null,
+    nextOffset
+  };
+}
+function truncateText(value, max = DEFAULT_TEXT_WIDTH) {
+  const text = (value ?? "").replace(/\s+/g, " ").trim();
+  if (text.length <= max)
+    return text;
+  if (max <= 3)
+    return text.slice(0, max);
+  return `${text.slice(0, max - 3).trimEnd()}...`;
+}
+function firstNonEmptyLines(value, maxLines, maxWidth = DEFAULT_TEXT_WIDTH) {
+  return (value ?? "").split(`
+`).map((line) => line.trim()).filter(Boolean).slice(0, maxLines).map((line) => truncateText(line, maxWidth));
+}
+function compactConnector(connector, descriptionWidth = DEFAULT_TEXT_WIDTH) {
+  return {
+    name: connector.name,
+    displayName: connector.displayName,
+    version: connector.version,
+    category: connector.category,
+    description: truncateText(connector.description, descriptionWidth)
+  };
+}
+function maybeTruncateOutput(text, options = {}) {
+  const enabled = options.enabled ?? true;
+  const maxChars = options.maxChars ?? DEFAULT_OUTPUT_CHARS;
+  if (!enabled || text.length <= maxChars) {
+    return { text, truncated: false };
+  }
+  const hint = options.hint ?? "Use --verbose for full output.";
+  const omitted = text.length - maxChars;
+  return {
+    text: `${text.slice(0, maxChars).trimEnd()}
+
+[truncated ${omitted} chars] ${hint}`,
+    truncated: true
+  };
+}
+var DEFAULT_COMPACT_LIMIT = 20, DEFAULT_MCP_LIMIT = 20, MAX_COMPACT_LIMIT = 100, DEFAULT_TEXT_WIDTH = 96, DEFAULT_OUTPUT_CHARS = 6000;
+
 // src/lib/lock.ts
 import { openSync, closeSync, unlinkSync as unlinkSync2, existsSync as existsSync14, statSync as statSync6 } from "fs";
 import { mkdirSync as mkdirSync7 } from "fs";
@@ -49612,26 +49728,44 @@ function registerDiscoveryTools(server, stripped) {
   server.registerTool("search_connectors", {
     title: "Search Connectors",
     description: "Search connectors by name or keyword.",
-    inputSchema: { query: exports_external.string() }
-  }, async ({ query }) => {
+    inputSchema: {
+      query: exports_external.string(),
+      limit: exports_external.number().optional(),
+      verbose: exports_external.boolean().optional()
+    }
+  }, async ({ query, limit, verbose }) => {
     const { getInstalledConnectors: getInstalledConnectors2 } = await Promise.resolve().then(() => (init_installer(), exports_installer));
     const { getPromotedConnectors: getPromotedConnectors2 } = await Promise.resolve().then(() => (init_promotions(), exports_promotions));
     const { getUsageMap: getUsageMap2 } = await Promise.resolve().then(() => (init_usage(), exports_usage));
+    const resultLimit = normalizeLimit(limit, DEFAULT_MCP_LIMIT);
     const results = searchConnectors(query, {
       installed: getInstalledConnectors2(),
       promoted: getPromotedConnectors2(),
-      usage: getUsageMap2()
+      usage: getUsageMap2(),
+      limit: resultLimit
     });
-    return stripped(JSON.stringify(results.map((c) => ({ name: c.name, displayName: c.displayName, version: c.version, category: c.category, description: c.description, score: c.score, badges: c.badges })), null, 2));
+    return stripped(JSON.stringify(results.map((c) => ({
+      name: c.name,
+      displayName: c.displayName,
+      version: c.version,
+      category: c.category,
+      description: verbose ? c.description : truncateText(c.description, 120),
+      score: c.score,
+      badges: c.badges,
+      ...verbose ? { matchReasons: c.matchReasons } : {}
+    })), null, 2));
   });
   server.registerTool("list_connectors", {
     title: "List Connectors",
-    description: "List connectors. category filters; compact=true returns names only.",
+    description: "List connectors with compact, paged defaults. Use verbose=true or compact=false for full metadata.",
     inputSchema: {
       category: exports_external.string().optional(),
-      compact: exports_external.boolean().optional()
+      compact: exports_external.boolean().optional(),
+      limit: exports_external.number().optional(),
+      cursor: exports_external.string().optional(),
+      verbose: exports_external.boolean().optional()
     }
-  }, async ({ category, compact }) => {
+  }, async ({ category, compact, limit, cursor, verbose }) => {
     let connectors18 = CONNECTORS;
     if (category) {
       const matched = CATEGORIES.find((c) => c.toLowerCase() === category.toLowerCase());
@@ -49648,23 +49782,42 @@ function registerDiscoveryTools(server, stripped) {
       }
       connectors18 = getConnectorsByCategory(matched);
     }
-    const data = compact ? connectors18.map((c) => c.name) : connectors18.map((c) => ({
+    const parsedCursor = parseCursor(cursor);
+    if (parsedCursor.error) {
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: parsedCursor.error }) }],
+        isError: true
+      };
+    }
+    const page = pageItems(connectors18, {
+      offset: parsedCursor.value ?? 0,
+      limit: normalizeLimit(limit, DEFAULT_MCP_LIMIT)
+    });
+    const data = compact === true ? page.items.map((c) => c.name) : verbose || compact === false ? page.items.map((c) => ({
       name: c.name,
       displayName: c.displayName,
       version: c.version,
       category: c.category,
-      description: c.description
-    }));
-    return stripped(JSON.stringify(data, null, 2));
+      description: c.description,
+      tags: c.tags
+    })) : page.items.map((c) => compactConnector(c, 120));
+    return stripped(JSON.stringify({
+      connectors: data,
+      total: connectors18.length,
+      count: data.length,
+      nextCursor: page.nextOffset === null ? null : String(page.nextOffset),
+      hint: page.nextOffset === null ? "Use verbose=true or compact=false for full connector metadata." : `Call again with cursor="${page.nextOffset}", or use verbose=true / compact=false for full connector metadata.`
+    }, null, 2));
   });
   server.registerTool("connector_docs", {
     title: "Connector Documentation",
-    description: "Get connector docs. essential=true returns auth+envVars only.",
+    description: "Get compact connector docs by default. Use verbose=true for full parsed docs or essential=true for auth+env only.",
     inputSchema: {
       name: exports_external.string(),
-      essential: exports_external.boolean().optional()
+      essential: exports_external.boolean().optional(),
+      verbose: exports_external.boolean().optional()
     }
-  }, async ({ name, essential }) => {
+  }, async ({ name, essential, verbose }) => {
     const meta = getConnector(name);
     if (!meta) {
       return {
@@ -49680,7 +49833,7 @@ function registerDiscoveryTools(server, stripped) {
         isError: true
       };
     }
-    const data = essential ? { name: meta.name, auth: docs.auth, envVars: docs.envVars } : {
+    const data = essential ? { name: meta.name, auth: docs.auth, envVars: docs.envVars } : verbose ? {
       name: meta.name,
       displayName: meta.displayName,
       version: meta.version,
@@ -49691,6 +49844,19 @@ function registerDiscoveryTools(server, stripped) {
       envVars: docs.envVars,
       cliCommands: docs.cliCommands,
       dataStorage: docs.dataStorage
+    } : {
+      name: meta.name,
+      displayName: meta.displayName,
+      version: meta.version,
+      category: meta.category,
+      description: truncateText(meta.description, 120),
+      overview: firstNonEmptyLines(docs.overview, 1, 140)[0] ?? "",
+      auth: firstNonEmptyLines(docs.auth, 4, 140),
+      envVars: docs.envVars.slice(0, 8),
+      envVarCount: docs.envVars.length,
+      cliCommands: firstNonEmptyLines(docs.cliCommands, 8, 140),
+      dataStorage: firstNonEmptyLines(docs.dataStorage, 2, 140),
+      hint: `Use connector_docs({ name: "${name}", verbose: true }) for full parsed docs, or raw CLI docs with connectors docs ${name} --raw.`
     };
     return {
       content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
@@ -50125,9 +50291,11 @@ function registerOperationsTools(server, stripped) {
     description: "Discover available API operations for a connector. Returns CLI commands the connector supports (e.g. messages, products, customers). Use this before run_connector_operation to know what's available.",
     inputSchema: {
       name: exports_external.string().describe("Connector name (e.g. stripe, gmail, anthropic)"),
-      command: exports_external.string().optional().describe("Get detailed help for a specific subcommand (e.g. products, messages)")
+      command: exports_external.string().optional().describe("Get detailed help for a specific subcommand (e.g. products, messages)"),
+      verbose: exports_external.boolean().optional().describe("Include full auth status and raw help text."),
+      limit: exports_external.number().optional().describe("Limit operation rows in compact mode.")
     }
-  }, async ({ name, command }) => {
+  }, async ({ name, command, verbose, limit }) => {
     const meta = getConnector(name);
     if (!meta) {
       return {
@@ -50159,6 +50327,32 @@ function registerOperationsTools(server, stripped) {
     }
     const ops = await getConnectorOperations(name);
     const auth = getAuthStatus(name);
+    if (!verbose) {
+      const operationLimit = normalizeLimit(limit, 50);
+      const operations = ops.operations.slice(0, operationLimit).map((operation) => ({
+        name: operation.name,
+        aliases: operation.aliases,
+        usage: operation.usage,
+        summary: truncateText(operation.summary || "", 140),
+        source: operation.source
+      }));
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              connector: name,
+              displayName: meta.displayName,
+              auth: { type: auth.type, configured: auth.configured },
+              commands: ops.commands,
+              operations,
+              totalOperations: ops.operations.length,
+              hint: `Use list_connector_operations({ name: "${name}", verbose: true }) for full help text, or command="<subcommand>" for one command.`
+            }, null, 2)
+          }
+        ]
+      };
+    }
     return {
       content: [
         {
@@ -50182,9 +50376,11 @@ function registerOperationsTools(server, stripped) {
       name: exports_external.string().describe("Connector name (e.g. stripe, gmail, anthropic)"),
       args: exports_external.array(exports_external.string()).describe("CLI arguments for the connector command (e.g. ['products', 'list', '--limit', '5'])"),
       format: exports_external.enum(["json", "pretty"]).optional().describe("Output format (default: json for structured parsing)"),
-      timeout: exports_external.number().optional().describe("Timeout in milliseconds (default: 30000)")
+      timeout: exports_external.number().optional().describe("Timeout in milliseconds (default: 30000)"),
+      verbose: exports_external.boolean().optional().describe("Return full stdout/stderr without output truncation."),
+      maxOutputChars: exports_external.number().optional().describe("Maximum output characters when verbose is false (default: 6000).")
     }
-  }, async ({ name, args, format, timeout }) => {
+  }, async ({ name, args, format, timeout, verbose, maxOutputChars }) => {
     const meta = getConnector(name);
     if (!meta) {
       return {
@@ -50207,6 +50403,11 @@ function registerOperationsTools(server, stripped) {
 ${result.stderr}`;
     const looksLikeHelp = /Usage:|Commands:|Options:/i.test(combinedOutput);
     if (!result.success && !looksLikeHelp) {
+      const output = maybeTruncateOutput(result.stderr || result.stdout, {
+        enabled: !verbose,
+        maxChars: maxOutputChars ?? DEFAULT_OUTPUT_CHARS,
+        hint: "Set verbose=true or maxOutputChars higher for full error output."
+      });
       return {
         content: [
           {
@@ -50214,7 +50415,9 @@ ${result.stderr}`;
             text: JSON.stringify({
               connector: name,
               success: false,
-              error: result.stderr || result.stdout
+              error: output.text,
+              outputTruncated: output.truncated,
+              hint: verbose ? undefined : "MCP error output is compact by default. Set verbose=true or maxOutputChars for more output."
             }, null, 2)
           }
         ],
@@ -50228,7 +50431,11 @@ ${result.stderr}`;
           text: JSON.stringify({
             connector: name,
             success: true,
-            output: looksLikeHelp ? (result.stdout || result.stderr).trim() : result.stdout
+            output: maybeTruncateOutput(looksLikeHelp ? (result.stdout || result.stderr).trim() : result.stdout, {
+              enabled: !verbose,
+              maxChars: maxOutputChars ?? DEFAULT_OUTPUT_CHARS,
+              hint: "Set verbose=true or maxOutputChars higher for full output."
+            }).text
           }, null, 2)
         }
       ]
@@ -50249,11 +50456,14 @@ function registerSearchTools(server, stripped) {
     description: "Search for available operations across installed connectors.",
     inputSchema: {
       query: exports_external.string(),
-      installedOnly: exports_external.boolean().optional()
+      installedOnly: exports_external.boolean().optional(),
+      limit: exports_external.number().optional(),
+      verbose: exports_external.boolean().optional()
     }
-  }, async ({ query, installedOnly }) => {
+  }, async ({ query, installedOnly, limit, verbose }) => {
     const installed = installedOnly ? getInstalledConnectors() : null;
     const results = [];
+    const resultLimit = normalizeLimit(limit, DEFAULT_MCP_LIMIT);
     const connectors18 = installed || getInstalledConnectors();
     for (const name of connectors18) {
       try {
@@ -50272,22 +50482,31 @@ function registerSearchTools(server, stripped) {
             results.push({
               connector: name,
               operation: operation.name,
-              description: operation.summary || ops.helpText || ""
+              description: verbose ? operation.summary || ops.helpText || "" : truncateText(operation.summary || ops.helpText || "", 160)
             });
+            if (results.length >= resultLimit)
+              break;
           }
         }
+        if (results.length >= resultLimit)
+          break;
       } catch {}
     }
-    return stripped(JSON.stringify(results, null, 2));
+    return stripped(JSON.stringify({
+      results,
+      count: results.length,
+      hint: "Use limit=<n> for more rows and verbose=true for longer descriptions."
+    }, null, 2));
   });
   server.registerTool("describe_tools", {
     title: "Describe Tools",
     description: "Get detailed documentation for a connector's operations.",
     inputSchema: {
       name: exports_external.string(),
-      operation: exports_external.string().optional()
+      operation: exports_external.string().optional(),
+      verbose: exports_external.boolean().optional()
     }
-  }, async ({ name, operation }) => {
+  }, async ({ name, operation, verbose }) => {
     const meta = getConnector(name);
     if (!meta) {
       return {
@@ -50303,7 +50522,23 @@ function registerSearchTools(server, stripped) {
       };
     }
     const ops = await getConnectorOperations(name);
-    return stripped(JSON.stringify({ connector: name, displayName: meta.displayName, ...ops }, null, 2));
+    if (verbose) {
+      return stripped(JSON.stringify({ connector: name, displayName: meta.displayName, ...ops }, null, 2));
+    }
+    return stripped(JSON.stringify({
+      connector: name,
+      displayName: meta.displayName,
+      commands: ops.commands,
+      operations: ops.operations.map((item) => ({
+        name: item.name,
+        aliases: item.aliases,
+        usage: item.usage,
+        summary: truncateText(item.summary || "", 140),
+        source: item.source
+      })),
+      totalOperations: ops.operations.length,
+      hint: `Use describe_tools({ name: "${name}", verbose: true }) for full help text.`
+    }, null, 2));
   });
 }
 var init_search = __esm(() => {
@@ -50357,62 +50592,180 @@ var init_ranking = __esm(() => {
 });
 
 // src/mcp/tools/jobs.ts
+function normalizeOutputChars(value) {
+  return normalizeLimit(value, DEFAULT_EXECUTION_OUTPUT_CHARS, MAX_EXECUTION_OUTPUT_CHARS);
+}
+function compactExecutionText(text, options, label) {
+  return maybeTruncateOutput(text, {
+    enabled: !options.verbose,
+    maxChars: normalizeOutputChars(options.maxOutputChars),
+    hint: `Set verbose=true or maxOutputChars higher for full ${label} output.`
+  });
+}
+function compactJobExecutionResult(result, options = {}) {
+  const output = compactExecutionText(result.output, options, "job");
+  return {
+    ...result,
+    output: output.text,
+    outputTruncated: output.truncated,
+    hint: options.verbose ? undefined : "MCP job output is compact by default. Set verbose=true or maxOutputChars for more output."
+  };
+}
+function compactWorkflowExecutionResult(result, options = {}) {
+  let truncatedOutputs = 0;
+  const steps = result.steps.map((step) => {
+    const output = compactExecutionText(step.output, options, "workflow step");
+    if (output.truncated)
+      truncatedOutputs++;
+    return {
+      ...step,
+      output: output.text,
+      outputTruncated: output.truncated
+    };
+  });
+  const finalOutput = compactExecutionText(result.final_output, options, "workflow final");
+  if (finalOutput.truncated)
+    truncatedOutputs++;
+  return {
+    ...result,
+    steps,
+    final_output: finalOutput.text,
+    finalOutputTruncated: finalOutput.truncated,
+    truncatedOutputs,
+    hint: options.verbose ? undefined : "MCP workflow output is compact by default. Set verbose=true or maxOutputChars for more output."
+  };
+}
 function registerJobsTools(server, stripped) {
   server.registerTool("list_jobs", {
     title: "List Jobs",
-    description: "List scheduled connector jobs.",
-    inputSchema: {}
-  }, async () => {
+    description: "List scheduled connector jobs with compact, paged defaults.",
+    inputSchema: {
+      limit: exports_external.number().optional(),
+      cursor: exports_external.string().optional(),
+      verbose: exports_external.boolean().optional()
+    }
+  }, async ({ limit, cursor, verbose }) => {
+    const parsedCursor = parseCursor(cursor);
+    if (parsedCursor.error) {
+      return { content: [{ type: "text", text: JSON.stringify({ error: parsedCursor.error }) }], isError: true };
+    }
     const db = getDatabase();
     const jobs = listJobs(db);
-    return stripped(JSON.stringify(jobs, null, 2));
+    const page = pageItems(jobs, {
+      offset: parsedCursor.value ?? 0,
+      limit: normalizeLimit(limit, DEFAULT_MCP_LIMIT)
+    });
+    const data = verbose ? page.items : page.items.map((job) => ({
+      name: job.name,
+      connector: job.connector,
+      command: `${job.command}${job.args.length ? ` ${job.args.join(" ")}` : ""}`,
+      cron: job.cron,
+      enabled: job.enabled,
+      strip: job.strip,
+      lastRunAt: job.last_run_at
+    }));
+    return stripped(JSON.stringify({
+      jobs: data,
+      total: jobs.length,
+      count: data.length,
+      nextCursor: page.nextOffset === null ? null : String(page.nextOffset),
+      hint: "Use verbose=true for full job records, get_latest_job_run for run output, or connectors jobs show <name>."
+    }, null, 2));
   });
   server.registerTool("get_latest_job_run", {
     title: "Get Latest Job Run",
-    description: "Get the most recent run output for a job.",
-    inputSchema: { name: exports_external.string() }
-  }, async ({ name }) => {
+    description: "Get the most recent run output for a job. Output is truncated unless verbose=true.",
+    inputSchema: {
+      name: exports_external.string(),
+      verbose: exports_external.boolean().optional(),
+      maxOutputChars: exports_external.number().optional()
+    }
+  }, async ({ name, verbose, maxOutputChars }) => {
     const db = getDatabase();
     const job = getJobByName(name, db);
     if (!job)
       return { content: [{ type: "text", text: JSON.stringify({ error: `Job "${name}" not found` }) }], isError: true };
     const run = getLatestRun(job.id, db);
-    return stripped(JSON.stringify(run ?? { message: "No runs yet" }, null, 2));
+    if (!run)
+      return stripped(JSON.stringify({ message: "No runs yet" }, null, 2));
+    const outputLimit = normalizeLimit(maxOutputChars, 2000, 50000);
+    return stripped(JSON.stringify({
+      ...run,
+      raw_output: run.raw_output && !verbose ? truncateText(run.raw_output, outputLimit) : run.raw_output,
+      stripped_output: run.stripped_output && !verbose ? truncateText(run.stripped_output, outputLimit) : run.stripped_output,
+      hint: verbose ? undefined : "Long run output is truncated in MCP. Use verbose=true or maxOutputChars for more output."
+    }, null, 2));
   });
   server.registerTool("run_job", {
     title: "Run Job",
     description: "Manually trigger a scheduled job.",
-    inputSchema: { name: exports_external.string() }
-  }, async ({ name }) => {
+    inputSchema: {
+      name: exports_external.string(),
+      verbose: exports_external.boolean().optional().describe("Return full job output without truncation."),
+      maxOutputChars: exports_external.number().optional().describe("Maximum output characters when verbose is false (default: 2000).")
+    }
+  }, async ({ name, verbose, maxOutputChars }) => {
     const db = getDatabase();
     const job = getJobByName(name, db);
     if (!job)
       return { content: [{ type: "text", text: JSON.stringify({ error: `Job "${name}" not found` }) }], isError: true };
     const result = await triggerJob(job, db);
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    return stripped(JSON.stringify(compactJobExecutionResult(result, { verbose, maxOutputChars }), null, 2));
   });
   server.registerTool("list_workflows", {
     title: "List Workflows",
-    description: "List connector workflows.",
-    inputSchema: {}
-  }, async () => {
+    description: "List connector workflows with compact, paged defaults.",
+    inputSchema: {
+      limit: exports_external.number().optional(),
+      cursor: exports_external.string().optional(),
+      verbose: exports_external.boolean().optional()
+    }
+  }, async ({ limit, cursor, verbose }) => {
+    const parsedCursor = parseCursor(cursor);
+    if (parsedCursor.error) {
+      return { content: [{ type: "text", text: JSON.stringify({ error: parsedCursor.error }) }], isError: true };
+    }
     const db = getDatabase();
     const workflows = listWorkflows(db);
-    return stripped(JSON.stringify(workflows, null, 2));
+    const page = pageItems(workflows, {
+      offset: parsedCursor.value ?? 0,
+      limit: normalizeLimit(limit, DEFAULT_MCP_LIMIT)
+    });
+    const data = verbose ? page.items : page.items.map((workflow) => ({
+      name: workflow.name,
+      enabled: workflow.enabled,
+      stepCount: workflow.steps.length,
+      steps: workflow.steps.slice(0, 5).map((step) => ({
+        connector: step.connector,
+        command: step.command
+      }))
+    }));
+    return stripped(JSON.stringify({
+      workflows: data,
+      total: workflows.length,
+      count: data.length,
+      nextCursor: page.nextOffset === null ? null : String(page.nextOffset),
+      hint: "Use verbose=true for full workflow records, or connectors workflows show <name>."
+    }, null, 2));
   });
   server.registerTool("run_workflow", {
     title: "Run Workflow",
     description: "Execute a connector workflow pipeline.",
-    inputSchema: { name: exports_external.string() }
-  }, async ({ name }) => {
+    inputSchema: {
+      name: exports_external.string(),
+      verbose: exports_external.boolean().optional().describe("Return full workflow step output without truncation."),
+      maxOutputChars: exports_external.number().optional().describe("Maximum output characters per output field when verbose is false (default: 2000).")
+    }
+  }, async ({ name, verbose, maxOutputChars }) => {
     const db = getDatabase();
     const wf = getWorkflowByName(name, db);
     if (!wf)
       return { content: [{ type: "text", text: JSON.stringify({ error: `Workflow "${name}" not found` }) }], isError: true };
     const result = await runWorkflow(wf);
-    return stripped(JSON.stringify(result, null, 2));
+    return stripped(JSON.stringify(compactWorkflowExecutionResult(result, { verbose, maxOutputChars }), null, 2));
   });
 }
+var DEFAULT_EXECUTION_OUTPUT_CHARS = 2000, MAX_EXECUTION_OUTPUT_CHARS = 50000;
 var init_jobs2 = __esm(() => {
   init_zod();
   init_database();
@@ -50472,11 +50825,38 @@ function registerAgentTools(server, stripped) {
   });
   server.registerTool("list_agents", {
     title: "List Agents",
-    description: "List all registered agents.",
-    inputSchema: {}
-  }, async () => {
+    description: "List registered agents with compact, paged defaults.",
+    inputSchema: {
+      limit: exports_external.number().optional(),
+      cursor: exports_external.string().optional(),
+      verbose: exports_external.boolean().optional()
+    }
+  }, async ({ limit, cursor, verbose }) => {
+    const parsedCursor = parseCursor(cursor);
+    if (parsedCursor.error) {
+      return { content: [{ type: "text", text: JSON.stringify({ error: parsedCursor.error }) }], isError: true };
+    }
     const agents = listAgents();
-    return { content: [{ type: "text", text: JSON.stringify(agents, null, 2) }] };
+    const page = pageItems(agents, {
+      offset: parsedCursor.value ?? 0,
+      limit: normalizeLimit(limit, DEFAULT_MCP_LIMIT)
+    });
+    const data = verbose ? page.items : page.items.map((agent) => ({
+      id: agent.id,
+      name: agent.name,
+      role: agent.role,
+      lastSeenAt: agent.last_seen_at,
+      projectId: agent.project_id
+    }));
+    return {
+      content: [{ type: "text", text: JSON.stringify({
+        agents: data,
+        total: agents.length,
+        count: data.length,
+        nextCursor: page.nextOffset === null ? null : String(page.nextOffset),
+        hint: "Use verbose=true for full agent records."
+      }, null, 2) }]
+    };
   });
   server.registerTool("heartbeat", {
     title: "Heartbeat",
@@ -53679,7 +54059,7 @@ function listFilesRecursive(dir, base = dir) {
   return files;
 }
 function registerCommands(program2) {
-  program2.command("install").alias("add").argument("[connectors...]", "Connectors to install").option("-o, --overwrite", "Overwrite existing connectors", false).option("-d, --dry-run", "Preview what would be installed without making changes", false).option("-c, --category <category>", "Install all connectors in a category").option("--preset <preset>", "Install a preset bundle (e.g. ai, fullstack, google)").option("--json", "Output results as JSON", false).description("Install one or more connectors").action((connectors18, options) => {
+  program2.command("install").alias("add").argument("[connectors...]", "Connectors to install").option("-o, --overwrite", "Overwrite existing connectors", false).option("-d, --dry-run", "Preview what would be installed without making changes", false).option("-c, --category <category>", "Install all connectors in a category").option("--preset <preset>", "Install a preset bundle (e.g. ai, fullstack, google)").option("--json", "Output results as JSON", false).option("-v, --verbose", "Show full dry-run file lists", false).description("Install one or more connectors").action((connectors18, options) => {
     if (options.category) {
       const category = CATEGORIES.find((c) => c.toLowerCase() === options.category.toLowerCase());
       if (!category) {
@@ -53783,9 +54163,13 @@ Dry run \u2014 no changes will be made
         console.log(chalk2.dim(`    manifest: ${a.manifestPath}`));
         console.log(chalk2.dim(`    index:    ${a.indexPath}`));
         if (a.files && a.files.length > 0) {
+          const visibleFiles = options.verbose ? a.files : a.files.slice(0, 12);
           console.log(chalk2.dim(`    packaged runtime files (${a.files.length}):`));
-          for (const f of a.files) {
-            console.log(chalk2.dim(`      ${f}`));
+          for (const f of visibleFiles) {
+            console.log(chalk2.dim(`      ${truncateText(f, 120)}`));
+          }
+          if (!options.verbose && a.files.length > visibleFiles.length) {
+            console.log(chalk2.dim(`      ... ${a.files.length - visibleFiles.length} more files (use --verbose)`));
           }
         }
         console.log();
@@ -53915,20 +54299,42 @@ init_registry2();
 init_installer();
 init_auth();
 import chalk3 from "chalk";
-function parseNonNegativeInt(raw, flag) {
-  if (raw === undefined)
-    return { value: undefined };
-  if (!/^\d+$/.test(raw)) {
-    return { value: undefined, error: `Invalid value for ${flag}: '${raw}'. Expected a non-negative integer.` };
+function printConnectorRows(connectors18, options = {}) {
+  const nameWidth = 22;
+  const versionWidth = 10;
+  const categoryWidth = options.includeCategory ? 22 : 0;
+  const descWidth = options.verbose ? 160 : 80;
+  const categoryHeader = options.includeCategory ? chalk3.dim("Category".padEnd(categoryWidth)) : "";
+  console.log(`  ${chalk3.dim("Name".padEnd(nameWidth))}` + `${chalk3.dim("Version".padEnd(versionWidth))}` + categoryHeader + `${chalk3.dim("Description")}`);
+  console.log(chalk3.dim(`  ${"-".repeat(nameWidth + versionWidth + categoryWidth + 40)}`));
+  for (const c of connectors18) {
+    const description = options.verbose ? c.description : truncateText(c.description, descWidth);
+    const category = options.includeCategory ? chalk3.dim(c.category.padEnd(categoryWidth)) : "";
+    console.log(`  ${chalk3.cyan(c.name.padEnd(nameWidth))}` + `${chalk3.dim((c.version || "-").padEnd(versionWidth))}` + category + description);
+  }
+}
+function printPaginationHint(command, total, nextOffset, detailHint = true) {
+  const parts = [
+    nextOffset !== null ? `${command} --cursor ${nextOffset}` : null,
+    detailHint ? "connectors info <name>" : null,
+    `${command} --verbose`,
+    `${command} --json`
+  ].filter(Boolean);
+  if (parts.length > 0) {
+    console.log(chalk3.dim(`
+  More detail: ${parts.join(" | ")}`));
+  }
+  if (nextOffset !== null) {
+    console.log(chalk3.dim(`  Showing a compact page of ${total} total results.`));
   }
-  return { value: parseInt(raw, 10) };
 }
 function registerCommands2(program2) {
-  program2.command("list").alias("ls").option("-c, --category <category>", "Filter by category").option("-a, --all", "Show all available connectors", false).option("-i, --installed", "Show only installed connectors", false).option("-b, --brief", "Output only connector names", false).option("--limit <n>", "Limit results").option("--offset <n>", "Skip first N results").option("--json", "Output as JSON", false).description("List available or installed connectors").action((options) => {
+  program2.command("list").alias("ls").option("-c, --category <category>", "Filter by category").option("-a, --all", "Show all available connectors", false).option("-i, --installed", "Show only installed connectors", false).option("-b, --brief", "Output only connector names", false).option("--limit <n>", "Limit results").option("--offset <n>", "Skip first N results").option("--cursor <n>", "Cursor returned by compact output (same as --offset)").option("--json", "Output as JSON", false).option("-v, --verbose", "Show full human output instead of compact pages", false).description("List available or installed connectors").action((options) => {
     const parsedLimit = parseNonNegativeInt(options.limit, "--limit");
     const parsedOffset = parseNonNegativeInt(options.offset, "--offset");
-    if (parsedLimit.error || parsedOffset.error) {
-      const error2 = parsedLimit.error || parsedOffset.error || "Invalid pagination options";
+    const parsedCursor = parseNonNegativeInt(options.cursor, "--cursor");
+    if (parsedLimit.error || parsedOffset.error || parsedCursor.error) {
+      const error2 = parsedLimit.error || parsedOffset.error || parsedCursor.error || "Invalid pagination options";
       if (options.json) {
         console.log(JSON.stringify({ error: error2 }));
       } else {
@@ -53938,11 +54344,12 @@ function registerCommands2(program2) {
       return;
     }
     const limit = parsedLimit.value;
-    const offset = parsedOffset.value ?? 0;
+    const offset = parsedCursor.value ?? parsedOffset.value ?? 0;
+    const jsonLimit = limit === undefined ? undefined : Math.max(1, Math.floor(limit));
     const page = (items) => {
-      if (limit === undefined)
+      if (jsonLimit === undefined)
         return items.slice(offset);
-      return items.slice(offset, offset + limit);
+      return items.slice(offset, offset + jsonLimit);
     };
     if (options.brief) {
       if (options.installed) {
@@ -53954,9 +54361,10 @@ function registerCommands2(program2) {
             console.log(name);
         }
       } else if (options.category) {
-        const category = CATEGORIES.find((c) => c.toLowerCase() === options.category.toLowerCase());
+        const requestedCategory = options.category;
+        const category = CATEGORIES.find((c) => c.toLowerCase() === requestedCategory.toLowerCase());
         if (!category) {
-          console.error(`Unknown category: ${options.category}`);
+          console.error(`Unknown category: ${requestedCategory}`);
           process.exit(1);
           return;
         }
@@ -53979,7 +54387,12 @@ function registerCommands2(program2) {
       return;
     }
     if (options.installed) {
-      const installed = page(getInstalledConnectors());
+      const installedSource = getInstalledConnectors();
+      const installedPage = pageItems(installedSource, {
+        offset,
+        limit: limit ?? (options.verbose || options.all ? undefined : DEFAULT_COMPACT_LIMIT)
+      });
+      const installed = options.json ? page(installedSource) : installedPage.items;
       if (installed.length === 0) {
         if (options.json) {
           console.log(JSON.stringify([]));
@@ -54026,8 +54439,9 @@ function registerCommands2(program2) {
       const nameWidth = Math.max(6, ...statuses.map((s) => s.name.length)) + 2;
       const catWidth = Math.max(10, ...statuses.map((s) => s.category.length)) + 2;
       const authWidth = 10;
+      const installedTitle = installedPage.limit === null ? `Installed connectors (${installedSource.length})` : `Installed connectors (showing ${installed.length} of ${installedSource.length})`;
       console.log(chalk3.bold(`
-Installed connectors (${installed.length}):
+${installedTitle}:
 `));
       console.log(`  ${chalk3.dim("Name".padEnd(nameWidth))}` + `${chalk3.dim("Category".padEnd(catWidth))}` + `${chalk3.dim("Auth Type".padEnd(authWidth))}` + `${chalk3.dim("Status")}`);
       console.log(chalk3.dim(`  ${"\u2500".repeat(nameWidth + catWidth + authWidth + 24)}`));
@@ -54048,49 +54462,55 @@ Installed connectors (${installed.length}):
         console.log(`  ${chalk3.cyan(s.name.padEnd(nameWidth))}` + `${s.category.padEnd(catWidth)}` + `${authTypeLabel.padEnd(authWidth)}` + `${statusLabel}${expiryStr}`);
       }
       console.log();
+      printPaginationHint("connectors list --installed", installedSource.length, installedPage.nextOffset);
       return;
     }
     if (options.category) {
-      const category = CATEGORIES.find((c) => c.toLowerCase() === options.category.toLowerCase());
+      const requestedCategory = options.category;
+      const category = CATEGORIES.find((c) => c.toLowerCase() === requestedCategory.toLowerCase());
       if (!category) {
         if (options.json) {
-          console.log(JSON.stringify({ error: `Unknown category: ${options.category}` }));
+          console.log(JSON.stringify({ error: `Unknown category: ${requestedCategory}` }));
           process.exit(1);
         }
-        console.log(chalk3.red(`Unknown category: ${options.category}`));
+        console.log(chalk3.red(`Unknown category: ${requestedCategory}`));
         console.log(chalk3.dim(`Available: ${CATEGORIES.join(", ")}`));
         return;
       }
       const connectors18 = getConnectorsByCategory(category);
-      const pagedConnectors = page(connectors18);
+      const humanPage = pageItems(connectors18, {
+        offset,
+        limit: limit ?? (options.verbose || options.all ? undefined : DEFAULT_COMPACT_LIMIT)
+      });
+      const pagedConnectors = options.json ? page(connectors18) : humanPage.items;
       if (options.json) {
         console.log(JSON.stringify(pagedConnectors));
         return;
       }
+      const title = humanPage.limit === null ? `${category} (${connectors18.length})` : `${category} (showing ${pagedConnectors.length} of ${connectors18.length})`;
       console.log(chalk3.bold(`
-${category} (${pagedConnectors.length}):
+${title}:
 `));
-      console.log(`  ${chalk3.dim("Name".padEnd(20))}${chalk3.dim("Version".padEnd(10))}${chalk3.dim("Description")}`);
-      console.log(chalk3.dim(`  ${"\u2500".repeat(60)}`));
-      for (const c of pagedConnectors) {
-        console.log(`  ${chalk3.cyan(c.name.padEnd(20))}${chalk3.dim((c.version || "-").padEnd(10))}${c.description}`);
-      }
+      printConnectorRows(pagedConnectors, { verbose: options.verbose });
+      printPaginationHint(`connectors list --category "${category}"`, connectors18.length, humanPage.nextOffset);
       return;
     }
     if (options.json) {
       console.log(JSON.stringify(page(CONNECTORS)));
       return;
     }
-    if (options.limit || options.offset) {
-      const connectors18 = page(CONNECTORS);
+    if (options.limit || options.offset || options.cursor || !options.all) {
+      const humanPage = pageItems(CONNECTORS, {
+        offset,
+        limit: limit ?? (options.verbose || options.all ? undefined : DEFAULT_COMPACT_LIMIT)
+      });
+      const connectors18 = humanPage.items;
+      const title = humanPage.limit === null ? `Available connectors (${CONNECTORS.length})` : `Available connectors (showing ${connectors18.length} of ${CONNECTORS.length})`;
       console.log(chalk3.bold(`
-Available connectors (${connectors18.length}):
+${title}:
 `));
-      console.log(`  ${chalk3.dim("Name".padEnd(20))}${chalk3.dim("Version".padEnd(10))}${chalk3.dim("Category".padEnd(24))}${chalk3.dim("Description")}`);
-      console.log(chalk3.dim(`  ${"\u2500".repeat(96)}`));
-      for (const c of connectors18) {
-        console.log(`  ${chalk3.cyan(c.name.padEnd(20))}` + `${chalk3.dim((c.version || "-").padEnd(10))}` + `${chalk3.dim(c.category.padEnd(24))}` + `${c.description}`);
-      }
+      printConnectorRows(connectors18, { includeCategory: true, verbose: options.verbose });
+      printPaginationHint("connectors list", CONNECTORS.length, humanPage.nextOffset);
       return;
     }
     console.log(chalk3.bold(`
@@ -54099,15 +54519,11 @@ Available connectors (${CONNECTORS.length}):
     for (const category of CATEGORIES) {
       const connectors18 = getConnectorsByCategory(category);
       console.log(chalk3.bold(`${category} (${connectors18.length}):`));
-      console.log(`  ${chalk3.dim("Name".padEnd(20))}${chalk3.dim("Version".padEnd(10))}${chalk3.dim("Description")}`);
-      console.log(chalk3.dim(`  ${"\u2500".repeat(60)}`));
-      for (const c of connectors18) {
-        console.log(`  ${chalk3.cyan(c.name.padEnd(20))}${chalk3.dim((c.version || "-").padEnd(10))}${c.description}`);
-      }
+      printConnectorRows(connectors18, { verbose: true });
       console.log();
     }
   });
-  program2.command("search").argument("<query>", "Search term").option("--json", "Output as JSON", false).option("--limit <n>", "Max results", "20").description("Search for connectors (ranked with fuzzy matching)").action((query, options) => {
+  program2.command("search").argument("<query>", "Search term").option("--json", "Output as JSON", false).option("--limit <n>", "Max results", "20").option("-v, --verbose", "Show match details and full descriptions", false).description("Search for connectors (ranked with fuzzy matching)").action((query, options) => {
     const parsedLimit = parseNonNegativeInt(options.limit, "--limit");
     if (parsedLimit.error || parsedLimit.value === undefined) {
       const error2 = parsedLimit.error || "Invalid --limit value";
@@ -54140,12 +54556,16 @@ Available connectors (${CONNECTORS.length}):
 Found ${results.length} connector(s):
 `));
     console.log(`  ${chalk3.dim("Name".padEnd(22))}${chalk3.dim("Score".padEnd(7))}${chalk3.dim("Category".padEnd(20))}${chalk3.dim("Description")}`);
-    console.log(chalk3.dim(`  ${"\u2500".repeat(75)}`));
+    console.log(chalk3.dim(`  ${"-".repeat(75)}`));
     for (const c of results) {
       const badges = c.badges.map((b) => b === "installed" ? chalk3.green("[INS]") : b === "hot" ? chalk3.red("[HOT]") : b === "promoted" ? chalk3.yellow("[PRO]") : "").join(" ");
       const badgeStr = badges ? " " + badges : "";
-      console.log(`  ${chalk3.cyan(c.name.padEnd(22))}${String(c.score).padEnd(7)}${chalk3.dim(c.category.padEnd(20))}${c.description}${badgeStr}`);
+      const description = options.verbose ? c.description : truncateText(c.description, 72);
+      const reasons = options.verbose && c.matchReasons.length > 0 ? chalk3.dim(` matches: ${c.matchReasons.join(", ")}`) : "";
+      console.log(`  ${chalk3.cyan(c.name.padEnd(22))}${String(c.score).padEnd(7)}${chalk3.dim(c.category.padEnd(20))}${description}${badgeStr}${reasons}`);
     }
+    console.log(chalk3.dim(`
+  More detail: connectors info <name> | connectors search "${query}" --verbose | connectors search "${query}" --json`));
   });
   program2.command("info").argument("<connector>", "Connector name").option("--json", "Output as JSON", false).description("Show detailed info about a connector").action((connector, options) => {
     const meta = getConnector(connector);
@@ -54176,7 +54596,7 @@ ${meta.displayName}`));
     console.log(`  Installed:   ${isInstalled ? chalk3.green("yes") : "no"}`);
     console.log(`  Package:     @hasna/connect-${meta.name}`);
   });
-  program2.command("docs").argument("<connector>", "Connector name").option("--json", "Output as structured JSON", false).option("--raw", "Output raw markdown", false).option("--essential", "Show auth and env vars only (no full docs)", false).description("Show connector documentation (auth, env vars, API, CLI commands)").action((connector, options) => {
+  program2.command("docs").argument("<connector>", "Connector name").option("--json", "Output as structured JSON", false).option("--raw", "Output raw markdown", false).option("--essential", "Show auth and env vars only (no full docs)", false).option("-v, --verbose", "Show full parsed documentation sections", false).description("Show connector documentation (auth, env vars, API, CLI commands)").action((connector, options) => {
     const meta = getConnector(connector);
     if (!meta) {
       if (options.json) {
@@ -54244,9 +54664,60 @@ Environment Variables`));
       }, null, 2));
       return;
     }
+    if (!options.verbose) {
+      console.log(chalk3.bold(`
+${meta.displayName} - Documentation Summary`));
+      console.log(chalk3.dim("-".repeat(50)));
+      console.log(`  Name:        ${chalk3.cyan(meta.name)}`);
+      console.log(`  Version:     ${meta.version || "-"}`);
+      console.log(`  Category:    ${meta.category}`);
+      console.log(`  Description: ${truncateText(meta.description, 100)}`);
+      const overview = firstNonEmptyLines(docs.overview, 1, 100);
+      if (overview.length > 0) {
+        console.log(chalk3.bold(`
+Overview`));
+        console.log(`  ${overview[0]}`);
+      }
+      const authLines = firstNonEmptyLines(docs.auth, 4, 100);
+      if (authLines.length > 0) {
+        console.log(chalk3.bold(`
+Authentication`));
+        for (const line of authLines)
+          console.log(`  ${line}`);
+      }
+      if (docs.envVars.length > 0) {
+        const visible = docs.envVars.slice(0, 8);
+        console.log(chalk3.bold(`
+Environment Variables`));
+        for (const v of visible) {
+          console.log(`  ${chalk3.cyan(v.variable.padEnd(30))}${truncateText(v.description, 80)}`);
+        }
+        if (docs.envVars.length > visible.length) {
+          console.log(chalk3.dim(`  ... ${docs.envVars.length - visible.length} more env vars`));
+        }
+      }
+      const commandLines = firstNonEmptyLines(docs.cliCommands, 8, 100);
+      if (commandLines.length > 0) {
+        console.log(chalk3.bold(`
+CLI Commands`));
+        for (const line of commandLines)
+          console.log(`  ${line}`);
+      }
+      const storageLines = firstNonEmptyLines(docs.dataStorage, 2, 100);
+      if (storageLines.length > 0) {
+        console.log(chalk3.bold(`
+Data Storage`));
+        for (const line of storageLines)
+          console.log(`  ${line}`);
+      }
+      console.log(chalk3.dim(`
+  More detail: connectors docs ${connector} --verbose | connectors docs ${connector} --raw | connectors docs ${connector} --json`));
+      console.log();
+      return;
+    }
     console.log(chalk3.bold(`
 ${meta.displayName} \u2014 Documentation`));
-    console.log(chalk3.dim("\u2500".repeat(50)));
+    console.log(chalk3.dim("-".repeat(50)));
     if (docs.overview) {
       console.log(chalk3.bold(`
 Overview`));
@@ -54343,7 +54814,18 @@ import chalk4 from "chalk";
 import { existsSync as existsSync20, readFileSync as readFileSync11 } from "fs";
 import { join as join20 } from "path";
 function registerCommands3(program2) {
-  program2.command("status").option("--json", "Output as JSON", false).description("Show auth status of all configured connectors (project + global)").action((options) => {
+  program2.command("status").option("--json", "Output as JSON", false).option("--limit <n>", "Limit rows per section in human output").option("--offset <n>", "Skip first N rows per section in human output").option("-v, --verbose", "Show all human rows", false).description("Show auth status of all configured connectors (project + global)").action((options) => {
+    const parsedLimit = parseNonNegativeInt(options.limit, "--limit");
+    const parsedOffset = parseNonNegativeInt(options.offset, "--offset");
+    if (parsedLimit.error || parsedOffset.error) {
+      const error2 = parsedLimit.error || parsedOffset.error || "Invalid pagination options";
+      if (options.json)
+        console.log(JSON.stringify({ error: error2 }));
+      else
+        console.log(chalk4.red(error2));
+      process.exit(1);
+      return;
+    }
     const installed = getInstalledConnectors();
     const configDir = getConnectorsHome();
     const seen = new Set;
@@ -54463,28 +54945,52 @@ function registerCommands3(program2) {
     console.log(chalk4.bold(`
 Connector Status
 `));
+    const humanLimit = options.verbose ? undefined : parsedLimit.value ?? DEFAULT_COMPACT_LIMIT;
+    const humanOffset = parsedOffset.value ?? 0;
     if (configuredList.length > 0) {
-      console.log(chalk4.green.bold(`  Configured (${configuredList.length})
+      const page = pageItems(configuredList, { offset: humanOffset, limit: humanLimit });
+      const title = page.limit === null ? `  Configured (${configuredList.length})` : `  Configured (showing ${page.items.length} of ${configuredList.length})`;
+      console.log(chalk4.green.bold(`${title}
 `));
       printHeader();
-      for (const s of configuredList) {
+      for (const s of page.items) {
         printRow(s);
       }
+      if (page.nextOffset !== null) {
+        console.log(chalk4.dim(`  More configured rows: connectors status --offset ${page.nextOffset}`));
+      }
       console.log();
     }
     if (unconfiguredList.length > 0) {
-      console.log(chalk4.red.bold(`  Unconfigured (${unconfiguredList.length})
+      const page = pageItems(unconfiguredList, { offset: humanOffset, limit: humanLimit });
+      const title = page.limit === null ? `  Unconfigured (${unconfiguredList.length})` : `  Unconfigured (showing ${page.items.length} of ${unconfiguredList.length})`;
+      console.log(chalk4.red.bold(`${title}
 `));
       printHeader();
-      for (const s of unconfiguredList) {
+      for (const s of page.items) {
         printRow(s);
       }
+      if (page.nextOffset !== null) {
+        console.log(chalk4.dim(`  More unconfigured rows: connectors status --offset ${page.nextOffset}`));
+      }
       console.log();
     }
     console.log(chalk4.dim(`  Total: ${allStatuses.length}  |  Configured: ${configuredList.length}  |  Unconfigured: ${unconfiguredList.length}`));
+    console.log(chalk4.dim("  More detail: connectors status --verbose | connectors status --json"));
     console.log();
   });
-  program2.command("doctor").option("--json", "Output as JSON", false).description("Check all installed connectors for issues and output a health report").action((options) => {
+  program2.command("doctor").option("--json", "Output as JSON", false).option("--limit <n>", "Limit rows in human output").option("--offset <n>", "Skip first N rows in human output").option("-v, --verbose", "Show all human rows and full suggestions", false).description("Check all installed connectors for issues and output a health report").action((options) => {
+    const parsedLimit = parseNonNegativeInt(options.limit, "--limit");
+    const parsedOffset = parseNonNegativeInt(options.offset, "--offset");
+    if (parsedLimit.error || parsedOffset.error) {
+      const error2 = parsedLimit.error || parsedOffset.error || "Invalid pagination options";
+      if (options.json)
+        console.log(JSON.stringify({ error: error2 }));
+      else
+        console.log(chalk4.red(error2));
+      process.exit(1);
+      return;
+    }
     const installed = getInstalledConnectors();
     if (installed.length === 0) {
       if (options.json) {
@@ -54556,7 +55062,11 @@ Connector Status
     console.log(chalk4.bold(`
 Connector Health Report
 `));
-    for (const r of results) {
+    const page = pageItems(results, {
+      offset: parsedOffset.value ?? 0,
+      limit: options.verbose ? undefined : parsedLimit.value ?? DEFAULT_COMPACT_LIMIT
+    });
+    for (const r of page.items) {
       let icon;
       if (r.level === "healthy") {
         icon = chalk4.green("\u2713");
@@ -54569,12 +55079,20 @@ Connector Health Report
       if (r.issues.length === 0) {
         console.log(`  ${icon} ${nameStr} \u2014 ${chalk4.green("healthy")}`);
       } else {
-        console.log(`  ${icon} ${nameStr} \u2014 ${r.issues.join(", ")}`);
-        for (const suggestion of r.suggestions) {
-          console.log(chalk4.dim(`      \u2192 ${suggestion}`));
+        console.log(`  ${icon} ${nameStr} \u2014 ${truncateText(r.issues.join(", "), options.verbose ? 200 : 120)}`);
+        const suggestions = options.verbose ? r.suggestions : r.suggestions.slice(0, 2);
+        for (const suggestion of suggestions) {
+          console.log(chalk4.dim(`      -> ${truncateText(suggestion, options.verbose ? 200 : 120)}`));
+        }
+        if (!options.verbose && r.suggestions.length > suggestions.length) {
+          console.log(chalk4.dim(`      ... ${r.suggestions.length - suggestions.length} more suggestion(s)`));
         }
       }
     }
+    if (page.nextOffset !== null) {
+      console.log(chalk4.dim(`
+  More rows: connectors doctor --offset ${page.nextOffset}`));
+    }
     const parts = [];
     if (summary.healthy > 0)
       parts.push(chalk4.green(`${summary.healthy} healthy`));
@@ -55746,7 +56264,7 @@ complete -F _connectors connectors`);
       console.log(output);
     }
   });
-  program2.command("presets").option("--json", "Output as JSON", false).description("List available connector preset bundles").action((options) => {
+  program2.command("presets").option("--json", "Output as JSON", false).option("-v, --verbose", "Show every connector in each preset", false).description("List available connector preset bundles").action((options) => {
     if (options.json) {
       console.log(JSON.stringify(Object.entries(PRESETS).map(([name, p]) => ({
         name,
@@ -55761,13 +56279,16 @@ Available presets:
 `));
     for (const [name, preset] of Object.entries(PRESETS)) {
       console.log(`  ${chalk6.cyan(name.padEnd(12))} ${preset.description}`);
-      console.log(chalk6.dim(`  ${"".padEnd(12)} ${preset.connectors.join(", ")}`));
+      const visible = options.verbose ? preset.connectors : preset.connectors.slice(0, 5);
+      const suffix = !options.verbose && preset.connectors.length > visible.length ? `, ... +${preset.connectors.length - visible.length} more` : "";
+      console.log(chalk6.dim(`  ${"".padEnd(12)} ${visible.join(", ")}${suffix}`));
       console.log();
     }
-    console.log(chalk6.dim(`  Install with: connectors install --preset <name>
+    console.log(chalk6.dim(`  Install with: connectors install --preset <name>`));
+    console.log(chalk6.dim(`  More detail: connectors presets --verbose | connectors presets --json
 `));
   });
-  program2.command("whoami").option("--json", "Output as JSON", false).description("Show current setup: config dir, installed connectors, auth status").action((options) => {
+  program2.command("whoami").option("--json", "Output as JSON", false).option("-v, --verbose", "Show all connector rows", false).description("Show current setup: config dir, installed connectors, auth status").action((options) => {
     const configDir = getConnectorsHome();
     const installed = getInstalledConnectors();
     const version2 = "0.3.1";
@@ -55840,32 +56361,46 @@ Connectors Setup
     const projectConnectors = connectorDetails.filter((c) => c.source === "project");
     const globalConnectors = connectorDetails.filter((c) => c.source === "global");
     if (projectConnectors.length > 0) {
+      const page = pageItems(projectConnectors, {
+        limit: options.verbose ? undefined : DEFAULT_COMPACT_LIMIT
+      });
       console.log(chalk6.bold(`
-  Project Connectors:
+  Project Connectors (${page.items.length}/${projectConnectors.length}):
 `));
       const nameWidth = Math.max(10, ...projectConnectors.map((c) => c.name.length)) + 2;
-      for (const c of projectConnectors) {
+      for (const c of page.items) {
         const status = c.configured ? chalk6.green("\u2713") : chalk6.red("\u2717");
         const profileLabel = c.profile !== "default" ? chalk6.dim(` [${c.profile}]`) : "";
-        console.log(`    ${status} ${chalk6.cyan(c.name.padEnd(nameWidth))}${c.authType.padEnd(8)}${profileLabel}`);
+        console.log(`    ${status} ${chalk6.cyan(truncateText(c.name, nameWidth - 2).padEnd(nameWidth))}${c.authType.padEnd(8)}${profileLabel}`);
+      }
+      if (page.nextOffset !== null) {
+        console.log(chalk6.dim(`    ... ${projectConnectors.length - page.items.length} more (use --verbose)`));
       }
     }
     if (globalConnectors.length > 0) {
+      const page = pageItems(globalConnectors, {
+        limit: options.verbose ? undefined : DEFAULT_COMPACT_LIMIT
+      });
       console.log(chalk6.bold(`
-  Global Connectors`) + chalk6.dim(" (~/.hasna/connectors)") + chalk6.bold(`:
+  Global Connectors (${page.items.length}/${globalConnectors.length})`) + chalk6.dim(" (~/.hasna/connectors)") + chalk6.bold(`:
 `));
       const nameWidth = Math.max(10, ...globalConnectors.map((c) => c.name.length)) + 2;
-      for (const c of globalConnectors) {
+      for (const c of page.items) {
         const status = c.configured ? chalk6.green("\u2713") : chalk6.red("\u2717");
         const profileLabel = c.profile !== "default" ? chalk6.dim(` [${c.profile}]`) : "";
-        console.log(`    ${status} ${chalk6.cyan(c.name.padEnd(nameWidth))}${c.authType.padEnd(8)}${profileLabel}`);
+        console.log(`    ${status} ${chalk6.cyan(truncateText(c.name, nameWidth - 2).padEnd(nameWidth))}${c.authType.padEnd(8)}${profileLabel}`);
+      }
+      if (page.nextOffset !== null) {
+        console.log(chalk6.dim(`    ... ${globalConnectors.length - page.items.length} more (use --verbose)`));
       }
     }
     if (connectorDetails.length === 0) {
       console.log(chalk6.dim(`
   No connectors installed or configured.`));
     }
-    console.log();
+    console.log(chalk6.dim(`
+  More detail: connectors whoami --verbose | connectors whoami --json
+`));
   });
   program2.command("test").argument("[connector]", "Connector to test (default: all installed)").option("--json", "Output as JSON", false).option("--timeout <ms>", "Request timeout in milliseconds", "10000").description("Verify API credentials by making a real request to the connector's API").action(async (connector, options) => {
     const timeout = parseInt(options.timeout, 10) || 1e4;
@@ -56058,6 +56593,18 @@ init_registry2();
 init_auth();
 init_runner();
 import chalk7 from "chalk";
+function argsRequestJson(args) {
+  for (let i = 0;i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--json")
+      return true;
+    if ((arg === "--format" || arg === "-f") && args[i + 1] === "json")
+      return true;
+    if (arg === "--format=json" || arg === "-f=json")
+      return true;
+  }
+  return false;
+}
 function registerCommands6(program2) {
   program2.command("ops").description("List available API operations for a connector").argument("<name>", "Connector name (e.g. stripe, gmail)").argument("[command]", "Get detailed help for a specific subcommand").option("--json", "Output as JSON").action(async (name, command, options) => {
     const meta = getConnector(name);
@@ -56111,7 +56658,7 @@ ${meta.displayName} operations:
       }
     }
   });
-  program2.command("run").description("Execute an API operation on a connector").argument("<name>", "Connector name (e.g. stripe, gmail)").argument("[args...]", "Command arguments (e.g. products list --limit 5)").option("--timeout <ms>", "Timeout in milliseconds", "30000").passThroughOptions().action(async (name, args, options) => {
+  program2.command("run").description("Execute an API operation on a connector").argument("<name>", "Connector name (e.g. stripe, gmail)").argument("[args...]", "Command arguments (e.g. products list --limit 5)").option("--timeout <ms>", "Timeout in milliseconds", "30000").option("-v, --verbose", "Print full command output without truncation", false).passThroughOptions().action(async (name, args, options) => {
     const meta = getConnector(name);
     if (!meta) {
       console.error(chalk7.red(`Connector '${name}' not found.`));
@@ -56129,7 +56676,12 @@ ${meta.displayName} operations:
     }
     const result = await runConnectorCommand2(name, args, parseInt(options.timeout));
     if (result.stdout) {
-      console.log(result.stdout);
+      const preserveMachineOutput = argsRequestJson(args);
+      const output = maybeTruncateOutput(result.stdout, {
+        enabled: !options.verbose && !preserveMachineOutput,
+        hint: "Use `connectors run --verbose <connector> ...` for full output."
+      });
+      console.log(output.text);
     }
     if (result.stderr) {
       console.error(result.stderr);
@@ -56346,6 +56898,15 @@ init_workflow_runner();
 init_database();
 init_registry2();
 import chalk8 from "chalk";
+function parsePagingOptions(options) {
+  const parsedLimit = parseNonNegativeInt(options.limit, "--limit");
+  const parsedOffset = parseNonNegativeInt(options.offset, "--offset");
+  return {
+    limit: parsedLimit.value,
+    offset: parsedOffset.value ?? 0,
+    error: parsedLimit.error || parsedOffset.error
+  };
+}
 function registerCommands7(program2) {
   program2.command("hot").description("Show top connectors by usage").option("--limit <n>", "Max results", "10").option("--days <n>", "Time window in days", "7").option("--json", "Output as JSON").action((options) => {
     const { getTopConnectors: getTopConnectors2 } = (init_usage(), __toCommonJS(exports_usage));
@@ -56403,21 +56964,74 @@ Top connectors (last ${options.days} days):
     }
     console.log(chalk8.green("\u2713") + ` Job created: ${job.name} (${job.cron})`);
   });
-  jobsCmd.command("list").description("List all jobs").option("--json", "Output as JSON").action((options) => {
+  jobsCmd.command("list").description("List all jobs").option("--limit <n>", "Limit rows").option("--offset <n>", "Skip first N rows").option("-v, --verbose", "Show all rows in human output", false).option("--json", "Output as JSON").action((options) => {
+    const paging = parsePagingOptions(options);
+    if (paging.error) {
+      if (options.json)
+        console.log(JSON.stringify({ error: paging.error }));
+      else
+        console.log(chalk8.red(paging.error));
+      process.exit(1);
+      return;
+    }
     const jobs = listJobs(getDatabase());
+    const page = pageItems(jobs, {
+      offset: paging.offset,
+      limit: paging.limit ?? (options.verbose ? undefined : DEFAULT_COMPACT_LIMIT)
+    });
     if (options.json) {
-      console.log(JSON.stringify(jobs));
+      const data = options.limit || options.offset ? page.items : jobs;
+      console.log(JSON.stringify(data));
       return;
     }
     if (jobs.length === 0) {
       console.log(chalk8.dim("No jobs configured."));
       return;
     }
-    for (const j of jobs) {
+    console.log(chalk8.bold(`
+Jobs (showing ${page.items.length} of ${jobs.length})
+`));
+    for (const j of page.items) {
       const status = j.enabled ? chalk8.green("enabled") : chalk8.dim("disabled");
       const strip = j.strip ? chalk8.cyan(" [strip]") : "";
       console.log(`  ${j.name.padEnd(20)} ${j.connector}.${j.command.padEnd(16)} ${j.cron.padEnd(15)} ${status}${strip}`);
     }
+    if (page.nextOffset !== null)
+      console.log(chalk8.dim(`
+  More rows: connectors jobs list --offset ${page.nextOffset}`));
+    console.log(chalk8.dim("  More detail: connectors jobs show <name> | connectors jobs list --verbose | connectors jobs list --json"));
+  });
+  jobsCmd.command("show").alias("inspect").description("Show full details for one job").argument("<name>", "Job name").option("--json", "Output as JSON").action((name, options) => {
+    const db = getDatabase();
+    const job = getJobByName(name, db);
+    if (!job) {
+      console.error(chalk8.red(`Job "${name}" not found`));
+      process.exit(1);
+    }
+    const latestRun = getLatestRun(job.id, db);
+    if (options.json) {
+      console.log(JSON.stringify({ job, latestRun }, null, 2));
+      return;
+    }
+    console.log(chalk8.bold(`
+Job: ${job.name}
+`));
+    console.log(`  Connector: ${job.connector}`);
+    console.log(`  Command:   ${job.command}${job.args.length ? ` ${job.args.join(" ")}` : ""}`);
+    console.log(`  Cron:      ${job.cron}`);
+    console.log(`  Enabled:   ${job.enabled ? "yes" : "no"}`);
+    console.log(`  Strip:     ${job.strip ? "yes" : "no"}`);
+    if (latestRun) {
+      console.log(chalk8.bold(`
+Latest Run`));
+      console.log(`  Started: ${latestRun.started_at}`);
+      console.log(`  Exit:    ${latestRun.exit_code ?? "?"}`);
+      const latestOutput = latestRun.stripped_output ?? latestRun.raw_output;
+      if (latestOutput)
+        console.log(`  Output:  ${truncateText(latestOutput, 160)}`);
+    }
+    console.log(chalk8.dim(`
+  More detail: connectors jobs show ${name} --json | connectors jobs logs ${name}`));
   });
   jobsCmd.command("run").description("Manually trigger a job").argument("<name>", "Job name").option("--json", "Output as JSON").action(async (name, options) => {
     const db = getDatabase();
@@ -56435,8 +57049,13 @@ Top connectors (last ${options.days} days):
     }
     const icon = result.exit_code === 0 ? chalk8.green("\u2713") : chalk8.red("\u2717");
     console.log(`${icon} Run ${result.run_id} \u2014 exit ${result.exit_code}`);
-    if (result.output)
-      console.log(result.output.slice(0, 2000));
+    if (result.output) {
+      const output = maybeTruncateOutput(result.output, {
+        maxChars: 2000,
+        hint: `Run connectors jobs run ${name} --json for structured full output.`
+      });
+      console.log(output.text);
+    }
   });
   jobsCmd.command("logs").description("Show recent runs for a job").argument("<name>", "Job name").option("--limit <n>", "Max results", "10").option("--json", "Output as JSON").action((name, options) => {
     const db = getDatabase();
@@ -56505,20 +57124,63 @@ Top connectors (last ${options.days} days):
     }
     console.log(chalk8.green("\u2713") + ` Workflow "${wf.name}" created (${wf.steps.length} steps)`);
   });
-  workflowsCmd.command("list").description("List all workflows").option("--json", "Output as JSON").action((options) => {
+  workflowsCmd.command("list").description("List all workflows").option("--limit <n>", "Limit rows").option("--offset <n>", "Skip first N rows").option("-v, --verbose", "Show all rows in human output", false).option("--json", "Output as JSON").action((options) => {
+    const paging = parsePagingOptions(options);
+    if (paging.error) {
+      if (options.json)
+        console.log(JSON.stringify({ error: paging.error }));
+      else
+        console.log(chalk8.red(paging.error));
+      process.exit(1);
+      return;
+    }
     const wfs = listWorkflows(getDatabase());
+    const page = pageItems(wfs, {
+      offset: paging.offset,
+      limit: paging.limit ?? (options.verbose ? undefined : DEFAULT_COMPACT_LIMIT)
+    });
     if (options.json) {
-      console.log(JSON.stringify(wfs));
+      const data = options.limit || options.offset ? page.items : wfs;
+      console.log(JSON.stringify(data));
       return;
     }
     if (wfs.length === 0) {
       console.log(chalk8.dim("No workflows configured."));
       return;
     }
-    for (const wf of wfs) {
+    console.log(chalk8.bold(`
+Workflows (showing ${page.items.length} of ${wfs.length})
+`));
+    for (const wf of page.items) {
       const status = wf.enabled ? chalk8.green("enabled") : chalk8.dim("disabled");
       console.log(`  ${wf.name.padEnd(20)} ${String(wf.steps.length).padStart(2)} steps  ${status}`);
     }
+    if (page.nextOffset !== null)
+      console.log(chalk8.dim(`
+  More rows: connectors workflows list --offset ${page.nextOffset}`));
+    console.log(chalk8.dim("  More detail: connectors workflows show <name> | connectors workflows list --verbose | connectors workflows list --json"));
+  });
+  workflowsCmd.command("show").alias("inspect").description("Show full details for one workflow").argument("<name>", "Workflow name").option("--json", "Output as JSON").action((name, options) => {
+    const wf = getWorkflowByName(name, getDatabase());
+    if (!wf) {
+      console.error(chalk8.red(`Workflow "${name}" not found`));
+      process.exit(1);
+    }
+    if (options.json) {
+      console.log(JSON.stringify(wf, null, 2));
+      return;
+    }
+    console.log(chalk8.bold(`
+Workflow: ${wf.name}
+`));
+    console.log(`  Enabled: ${wf.enabled ? "yes" : "no"}`);
+    console.log(`  Steps:   ${wf.steps.length}`);
+    for (const [index, step] of wf.steps.entries()) {
+      const args = Array.isArray(step.args) && step.args.length > 0 ? ` ${step.args.join(" ")}` : "";
+      console.log(`  ${String(index + 1).padStart(2)}. ${step.connector} ${step.command}${args}`);
+    }
+    console.log(chalk8.dim(`
+  More detail: connectors workflows show ${name} --json`));
   });
   workflowsCmd.command("run").description("Run a workflow").argument("<name>", "Workflow name").option("--json", "Output as JSON").action(async (name, options) => {
     const wf = getWorkflowByName(name, getDatabase());