scoutline 0.1.0

package/dist/commands/read.js

@@ -0,0 +1,166 @@
+/**
+ * Web reader command using Z.AI WebReader MCP
+ */
+import { ZaiMcpClient } from "../lib/mcp-client.js";
+import { outputSuccess, getOutputMode } from "../lib/output.js";
+import { formatErrorOutput, ValidationError } from "../lib/errors.js";
+import { silenceConsole, restoreConsole } from "../lib/silence.js";
+import { extract, isExtractMode } from "../lib/extract.js";
+/**
+ * Rewrite rendered GitHub gist/file URLs to their raw form so Z.AI's reader
+ * returns pure file content instead of the rendered HTML page chrome
+ * (Sign in / Star / Fork / Embed / etc.).
+ *
+ *   gist.github.com/<user>/<id>            -> gist.github.com/<user>/<id>/raw
+ *   gist.github.com/<user>/<id>#file-...   -> gist.github.com/<user>/<id>/raw
+ *
+ * Leaves alone: URLs that already end in /raw, /raw/<rev>, or have a query string.
+ */
+function maybeRewriteToRaw(url) {
+    // Already raw? Leave alone.
+    if (/\/raw(\/|$|\?|#)/.test(url))
+        return url;
+    // Only rewrite gist.github.com (not github.com/owner/repo — that's different)
+    const m = url.match(/^(https?:\/\/gist\.github\.com\/[^/]+\/[^/#?]+)(?:[/?#]|$)/);
+    if (!m)
+        return url;
+    const base = m[1];
+    // Append /raw, preserve any fragment (file anchor still meaningful)
+    const frag = url.indexOf("#") >= 0 ? url.slice(url.indexOf("#")) : "";
+    return `${base}/raw${frag}`;
+}
+/**
+ * Pull just the content string out of a Z.AI reader response. The full envelope
+ * (title, url, metadata, external) is rarely useful for agents — it just bloats
+ * output and makes truncation limits harder to reason about.
+ */
+function extractContent(response) {
+    if (typeof response === "string")
+        return { content: response, original: response };
+    if (response && typeof response === "object") {
+        const obj = response;
+        if (typeof obj.content === "string") {
+            return { content: obj.content, original: response };
+        }
+    }
+    // Fallback: stringify whatever we got
+    return { content: JSON.stringify(response), original: response };
+}
+/**
+ * Truncate to max chars. Returns the (possibly truncated) content plus the
+ * original length so the caller can warn about truncation.
+ */
+function truncate(content, max) {
+    const originalLen = content.length;
+    if (!max || max <= 0 || originalLen <= max) {
+        return { text: content, originalLen, truncated: false };
+    }
+    return { text: content.slice(0, max - 1).trimEnd() + "…", originalLen, truncated: true };
+}
+export async function read(url, options = {}) {
+    // Validate URL first (before silencing)
+    if (!url.startsWith("http://") && !url.startsWith("https://")) {
+        console.error(formatErrorOutput(new ValidationError("URL must start with http:// or https://")));
+        process.exit(1);
+    }
+    if (options.extract && !isExtractMode(options.extract)) {
+        console.error(formatErrorOutput(new ValidationError(`Invalid --extract mode: ${options.extract}. Use one of: code, links, tables, headings`)));
+        process.exit(1);
+    }
+    const finalUrl = maybeRewriteToRaw(url);
+    if (finalUrl !== url) {
+        process.stderr.write(`ℹ️  rewrote gist URL to raw form: ${finalUrl}\n`);
+    }
+    silenceConsole();
+    const client = new ZaiMcpClient({ enableVision: false, noCache: options.noCache });
+    try {
+        try {
+            const response = await client.webRead({
+                url: finalUrl,
+                format: options.format || "markdown",
+                retainImages: !options.noImages,
+                withLinksSummary: options.withLinks,
+                timeout: options.timeout,
+                noCache: options.noCache,
+                noGfm: options.noGfm,
+                keepImgDataUrl: options.keepImgDataUrl,
+                withImagesSummary: options.withImagesSummary,
+            });
+            const { content: rawContent } = extractContent(response);
+            // --extract short-circuits: returns the extracted slice as a JSON array,
+            // bypassing truncation and envelope logic.
+            if (options.extract) {
+                const extracted = extract(rawContent, options.extract);
+                process.stderr.write(`ℹ️  extracted ${extracted.length} ${options.extract}\n`);
+                outputSuccess(extracted);
+                return;
+            }
+            const { text, originalLen, truncated } = truncate(rawContent, options.maxChars);
+            if (truncated) {
+                process.stderr.write(`⚠️  content truncated from ${originalLen.toLocaleString()} to ${text.length.toLocaleString()} chars; use a higher --max-chars or omit it for full content\n`);
+            }
+            // Default: content-only (drops title/metadata/external envelope).
+            // --full-envelope or --output-format json/pretty keeps the structured object.
+            const wantEnvelope = options.fullEnvelope || getOutputMode() === "json" || getOutputMode() === "pretty";
+            if (wantEnvelope) {
+                const envelope = response && typeof response === "object"
+                    ? { ...response, content: text }
+                    : { content: text };
+                outputSuccess(envelope);
+            }
+            else {
+                outputSuccess(text);
+            }
+        }
+        finally {
+            await client.close().catch(() => { });
+            restoreConsole();
+        }
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+// Help text
+export const READ_HELP = `
+Read Command - Fetch and parse web page content using Z.AI WebReader MCP
+
+Usage: scoutline read <url> [options]
+
+URL handling:
+  gist.github.com/<user>/<id> URLs are auto-rewritten to /raw so you get pure
+  file content instead of rendered HTML chrome (Sign in / Star / Fork / Embed).
+
+Options:
+  --format <f>    Output format: markdown (default), text
+  --no-images     Remove images from output
+  --no-cache      Disable server-side caching
+  --with-links    Include links summary
+  --with-images-summary  Include images summary
+  --no-gfm        Disable GitHub Flavored Markdown
+  --keep-img-data-url  Keep image data URLs in output
+  --timeout <s>   Request timeout in seconds (default: 20)
+  --max-chars <n> Truncate content to <n> chars (warns on stderr when it kicks in)
+  --full-envelope Include title/url/metadata/external fields (default: content-only)
+  --extract <m>   Pull a specific slice out as JSON array: code | links | tables | headings
+
+By default the command outputs just the page content (string). Use --full-envelope
+or --output-format json/pretty to get the full structured response object. Use
+--extract to return only matching elements (e.g. all code blocks, all links).
+
+Examples:
+  scoutline read https://docs.example.com/api
+  scoutline read https://github.com/owner/repo --format text
+  scoutline read https://gist.github.com/user/abc123          # auto-rewritten to /raw
+  scoutline read https://blog.example.com/post --no-images --with-links
+  scoutline read https://example.com/long-article --max-chars 2000
+  scoutline read https://react.dev/learn/hooks --extract code        # just code blocks
+  scoutline read https://example.com/page --extract links            # just URLs
+  scoutline read https://en.wikipedia.org/wiki/X --extract headings  # section outline
+
+Output format:
+  Content string by default; structured object with --full-envelope or -O json;
+  JSON array of extracted elements with --extract.
+`.trim();
+//# sourceMappingURL=read.js.map

package/dist/commands/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/commands/read.ts"],"names":[],"mappings":"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"}

package/dist/commands/repo.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Repo commands for GitHub repository exploration (ZRead)
+ */
+export interface RepoSearchOptions {
+    language?: "en" | "zh";
+    maxChars?: number;
+    noCache?: boolean;
+}
+export interface RepoTreeOptions {
+    path?: string;
+    depth?: number;
+    noCache?: boolean;
+}
+export interface RepoReadOptions {
+    maxChars?: number;
+    noCache?: boolean;
+}
+export declare function repoSearch(repo: string, query: string, options?: RepoSearchOptions): Promise<void>;
+export declare function repoTree(repo: string, options?: RepoTreeOptions): Promise<void>;
+export declare function repoRead(repo: string, path: string, options?: RepoReadOptions): Promise<void>;
+export declare const REPO_HELP: string;
+//# sourceMappingURL=repo.d.ts.map

package/dist/commands/repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/commands/repo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAiFD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCzF;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAsBf;AAGD,eAAO,MAAM,SAAS,QA2Cd,CAAC"}

package/dist/commands/repo.js

@@ -0,0 +1,219 @@
+/**
+ * Repo commands for GitHub repository exploration (ZRead)
+ */
+import { ZReadMcpClient } from "../lib/mcp-client.js";
+import { outputSuccess } from "../lib/output.js";
+import { formatErrorOutput, ValidationError } from "../lib/errors.js";
+import { silenceConsole, restoreConsole } from "../lib/silence.js";
+import path from "node:path";
+function validateRepo(repo) {
+    if (!repo.includes("/")) {
+        throw new ValidationError(`Invalid repository format: "${repo}". Use "owner/repo" format (e.g., "facebook/react")`);
+    }
+}
+function truncateText(text, max) {
+    if (!max || max <= 0 || text.length <= max)
+        return text;
+    return text.slice(0, max - 1).trimEnd() + "…";
+}
+function extractStructureBlock(structure) {
+    const match = structure.match(/<structure>\n([\s\S]*?)\n<\/structure>/);
+    const block = match ? match[1] : structure;
+    return block
+        .split("\n")
+        .map((line) => line.replace(/\r/g, ""))
+        .filter(Boolean);
+}
+function extractImmediateDirectories(structure, basePath) {
+    const lines = extractStructureBlock(structure);
+    const directories = [];
+    for (const line of lines) {
+        const match = line.match(/^([│\s]*)(├──|└──)\s(.+)$/);
+        if (!match)
+            continue;
+        const prefix = match[1] || "";
+        const name = (match[3] || "").trim();
+        const normalizedPrefix = prefix.replace(/│/g, " ");
+        const level = Math.floor(normalizedPrefix.length / 4);
+        if (level !== 0)
+            continue;
+        if (!name.endsWith("/"))
+            continue;
+        const dirName = name.slice(0, -1);
+        const fullPath = basePath ? path.posix.join(basePath, dirName) : dirName;
+        directories.push(fullPath);
+    }
+    return directories;
+}
+function normalizeDirPath(value) {
+    if (!value)
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed || trimmed === "/" || trimmed === ".")
+        return undefined;
+    return trimmed.replace(/^\/+/, "").replace(/\/+$/, "");
+}
+async function collectTreeSnapshots(client, repo, basePath, depth) {
+    const snapshots = [];
+    const seen = new Set();
+    const queue = [{ path: basePath || "", level: 1 }];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        const key = current.path;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const structure = await client.getRepoStructure(repo, current.path || undefined);
+        snapshots.push({ path: current.path || "/", structure });
+        if (current.level >= depth)
+            continue;
+        const children = extractImmediateDirectories(structure, current.path);
+        for (const child of children) {
+            queue.push({ path: child, level: current.level + 1 });
+        }
+    }
+    return snapshots;
+}
+export async function repoSearch(repo, query, options = {}) {
+    try {
+        validateRepo(repo);
+        if (options.language && options.language !== "en" && options.language !== "zh") {
+            throw new ValidationError('Language must be "en" or "zh"');
+        }
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+    silenceConsole();
+    const client = new ZReadMcpClient({ enableVision: false, noCache: options.noCache });
+    try {
+        try {
+            const language = options.language || "en";
+            const results = await client.searchDoc(repo, query, language);
+            outputSuccess(truncateText(results, options.maxChars));
+        }
+        finally {
+            await client.close().catch(() => { });
+            restoreConsole();
+        }
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+export async function repoTree(repo, options = {}) {
+    try {
+        validateRepo(repo);
+        if (options.depth !== undefined) {
+            const depthValue = Number(options.depth);
+            if (!Number.isFinite(depthValue) || depthValue < 1) {
+                throw new ValidationError("Depth must be a positive integer");
+            }
+        }
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+    silenceConsole();
+    const client = new ZReadMcpClient({ enableVision: false, noCache: options.noCache });
+    try {
+        try {
+            const depth = Math.max(1, Math.floor(options.depth || 1));
+            const dirPath = normalizeDirPath(options.path);
+            if (depth === 1) {
+                const structure = await client.getRepoStructure(repo, dirPath);
+                outputSuccess(structure);
+                return;
+            }
+            const snapshots = await collectTreeSnapshots(client, repo, dirPath, depth);
+            outputSuccess({
+                repo,
+                depth,
+                basePath: dirPath || "/",
+                snapshots,
+            });
+        }
+        finally {
+            await client.close().catch(() => { });
+            restoreConsole();
+        }
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+export async function repoRead(repo, path, options = {}) {
+    try {
+        validateRepo(repo);
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+    silenceConsole();
+    const client = new ZReadMcpClient({ enableVision: false, noCache: options.noCache });
+    try {
+        try {
+            const content = await client.readFile(repo, path);
+            outputSuccess(truncateText(content, options.maxChars));
+        }
+        finally {
+            await client.close().catch(() => { });
+            restoreConsole();
+        }
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+// Help text
+export const REPO_HELP = `
+Repo Commands - Explore GitHub repositories using ZRead
+
+Usage: scoutline repo <command> <owner/repo> [args]
+
+Commands:
+  search <owner/repo> <query>   Search docs and code in repository
+  tree <owner/repo>             Get repository directory structure
+  read <owner/repo> <path>      Read a file from repository
+
+Search Options:
+  --language <lang>   Result language: en (default) or zh
+  --max-chars <n>     Truncate output to <n> chars
+
+Tree Options:
+  --path <path>       Directory path to inspect (default: repo root)
+  --depth <n>         Expand subdirectory trees (default: 1)
+
+Read Options:
+  --max-chars <n>     Truncate file content to <n> chars
+
+Examples:
+  scoutline repo search facebook/react "server components"
+  scoutline repo search facebook/react "server components" --language en --max-chars 2000
+  scoutline repo tree vercel/next.js
+  scoutline repo tree vercel/next.js --path packages --depth 2
+  scoutline repo read anthropics/anthropic-sdk-python src/anthropic/client.py
+  scoutline repo read facebook/react README.md --max-chars 3000
+
+Notes:
+  - Repository must be public
+  - Use "owner/repo" format (e.g., "facebook/react")
+  - Paths are relative to repository root
+  - Depth >1 returns structured snapshots (use --output-format pretty for readability)
+
+Output format (search):
+  Search results array
+
+Output format (tree):
+  Repository structure object
+
+Output format (read):
+  File contents
+`.trim();
+//# sourceMappingURL=repo.js.map

package/dist/commands/repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.js","sourceRoot":"","sources":["../../src/commands/repo.ts"],"names":[],"mappings":"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"}

package/dist/commands/search.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Web search command using Z.AI WebSearchPrime MCP
+ */
+type RecencyFilter = "oneDay" | "oneWeek" | "oneMonth" | "oneYear" | "noLimit";
+export interface SearchOptions {
+    count?: number;
+    domain?: string;
+    recency?: RecencyFilter;
+    contentSize?: "medium" | "high";
+    location?: "cn" | "us";
+    maxSummary?: number;
+    fields?: string[];
+    noCache?: boolean;
+    merge?: boolean;
+}
+export declare function search(query: string, options?: SearchOptions): Promise<void>;
+export declare const SEARCH_HELP: string;
+export {};
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,KAAK,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA0FD,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+GtF;AAGD,eAAO,MAAM,WAAW,QA8ChB,CAAC"}