@edwardlee5423/magi 0.1.0-alpha.0

package/dist/tools/web-search.js

@@ -0,0 +1,198 @@
+export const WebSearchInputSchema = {
+    type: "object",
+    properties: {
+        query: { type: "string" },
+        allowed_domains: { type: "array", items: { type: "string" } },
+        blocked_domains: { type: "array", items: { type: "string" } },
+        max_results: { type: "number" }
+    },
+    required: ["query"],
+    additionalProperties: false
+};
+export function parseWebSearchInput(input) {
+    assertAllowedKeys(input, ["query", "allowed_domains", "blocked_domains", "max_results"], "WebSearch input");
+    const query = readNonEmptyString(input.query, "query");
+    if (query.length < 2) {
+        throw new Error("Tool input query must be at least 2 characters");
+    }
+    return {
+        query,
+        allowedDomains: readOptionalDomainList(input.allowed_domains, "allowed_domains"),
+        blockedDomains: readOptionalDomainList(input.blocked_domains, "blocked_domains"),
+        maxResults: readOptionalMaxResults(input.max_results)
+    };
+}
+export async function webSearch(input) {
+    if (input.config.provider !== "http-json" || !input.config.endpoint) {
+        throw new Error("WebSearch requires webSearch.provider=http-json and webSearch.endpoint in Magi config or MAGI_WEBSEARCH_ENDPOINT");
+    }
+    const endpoint = new URL(input.config.endpoint);
+    endpoint.searchParams.set(input.config.queryParam, input.request.query);
+    const maxResults = Math.min(input.request.maxResults ?? input.config.maxResults, input.config.maxResults);
+    endpoint.searchParams.set("count", String(maxResults));
+    endpoint.searchParams.set("locale", input.config.locale);
+    endpoint.searchParams.set("market", input.config.market);
+    const headers = { accept: "application/json" };
+    if (input.config.apiKeyEnv) {
+        const token = input.env?.[input.config.apiKeyEnv];
+        if (!token) {
+            throw new Error(`WebSearch API key env ${input.config.apiKeyEnv} is not set`);
+        }
+        headers[input.config.apiKeyHeader ?? "authorization"] = input.config.apiKeyHeader
+            ? token
+            : `Bearer ${token}`;
+    }
+    const response = await (input.fetch ?? fetch)(endpoint.toString(), { method: "GET", headers });
+    if (!response.ok) {
+        throw new Error(`WebSearch failed with HTTP ${response.status}`);
+    }
+    const parsed = await response.json();
+    const rawResults = readPath(parsed, input.config.resultsPath);
+    if (!Array.isArray(rawResults)) {
+        throw new Error(`WebSearch response path ${input.config.resultsPath} must be an array`);
+    }
+    const allowed = input.request.allowedDomains?.map((domain) => domain.toLowerCase());
+    const blocked = input.request.blockedDomains?.map((domain) => domain.toLowerCase()) ?? [];
+    const results = rawResults
+        .map((item, index) => readResultItem(item, index, input.config))
+        .filter((item) => domainAllowed(item.url, allowed, blocked))
+        .sort((left, right) => mainlandScore(right, input.config) - mainlandScore(left, input.config))
+        .slice(0, maxResults);
+    return {
+        query: input.request.query,
+        provider: "http-json",
+        endpoint: input.config.endpoint,
+        results
+    };
+}
+export function formatWebSearchResult(result) {
+    if (result.results.length === 0) {
+        return `WebSearch results for ${JSON.stringify(result.query)}\nNo results`;
+    }
+    return [
+        `WebSearch results for ${JSON.stringify(result.query)} (${result.results.length})`,
+        `provider: ${result.provider}`,
+        ...result.results.map((item, index) => [
+            `${index + 1}. ${item.title}`,
+            `   URL: ${item.url}`,
+            item.snippet ? `   Snippet: ${item.snippet}` : undefined
+        ].filter((line) => Boolean(line)).join("\n"))
+    ].join("\n");
+}
+function mainlandScore(item, config) {
+    if (!config.mainlandBoost) {
+        return 0;
+    }
+    const host = normalizeHttpUrl(item.url, "WebSearch result url").hostname.toLowerCase();
+    let score = 0;
+    if (host.endsWith(".cn") || host.endsWith(".com.cn") || host.endsWith(".net.cn") || host.endsWith(".org.cn")) {
+        score += 4;
+    }
+    if (containsCjk(item.title)) {
+        score += 2;
+    }
+    if (containsCjk(item.snippet)) {
+        score += 1;
+    }
+    return score;
+}
+function containsCjk(value) {
+    return /[\u3400-\u9fff]/u.test(value);
+}
+function readResultItem(value, index, config) {
+    const title = readPath(value, config.titlePath);
+    const url = readPath(value, config.urlPath);
+    const snippet = readPath(value, config.snippetPath);
+    if (typeof title !== "string" || !title.trim()) {
+        throw new Error(`WebSearch result ${index}.title must be a non-empty string`);
+    }
+    if (typeof url !== "string" || !url.trim()) {
+        throw new Error(`WebSearch result ${index}.url must be a non-empty string`);
+    }
+    const normalizedUrl = normalizeHttpUrl(url, `WebSearch result ${index}.url`);
+    return {
+        title: title.trim(),
+        url: normalizedUrl.toString(),
+        snippet: typeof snippet === "string" ? snippet.trim() : ""
+    };
+}
+function domainAllowed(urlValue, allowed, blocked) {
+    const host = normalizeHttpUrl(urlValue, "WebSearch result url").hostname.toLowerCase();
+    if (blocked.some((domain) => hostMatches(domain, host))) {
+        return false;
+    }
+    if (allowed && allowed.length > 0) {
+        return allowed.some((domain) => hostMatches(domain, host));
+    }
+    return true;
+}
+function normalizeHttpUrl(value, label) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error(`${label} must be a valid URL`);
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error(`${label} must use http or https`);
+    }
+    return url;
+}
+function readPath(value, dottedPath) {
+    return dottedPath.split(".").reduce((current, part) => {
+        if (typeof current !== "object" || current === null || Array.isArray(current)) {
+            return undefined;
+        }
+        return current[part];
+    }, value);
+}
+function readOptionalDomainList(value, label) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value)) {
+        throw new Error(`Tool input ${label} must be an array of domain strings`);
+    }
+    return value.map((item, index) => {
+        if (typeof item !== "string" || !item.trim()) {
+            throw new Error(`Tool input ${label}.${index} must be a non-empty string`);
+        }
+        return normalizeDomainPattern(item.trim().toLowerCase(), `${label}.${index}`);
+    });
+}
+function normalizeDomainPattern(value, label) {
+    const domain = value.startsWith("*.") ? value.slice(2) : value;
+    if (!/^[a-z0-9.-]+$/.test(domain) || domain.includes("..") || domain.startsWith(".") || domain.endsWith(".")) {
+        throw new Error(`Tool input ${label} must be a domain or wildcard domain`);
+    }
+    return value;
+}
+function readOptionalMaxResults(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 1 || value > 20) {
+        throw new Error("Tool input max_results must be an integer from 1 to 20");
+    }
+    return value;
+}
+function readNonEmptyString(value, label) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(`Tool input ${label} must be a non-empty string`);
+    }
+    return value.trim();
+}
+function assertAllowedKeys(value, allowed, label) {
+    const allowedSet = new Set(allowed);
+    const unknown = Object.keys(value).filter((key) => !allowedSet.has(key));
+    if (unknown.length > 0) {
+        throw new Error(`${label} has unknown field: ${unknown[0]}`);
+    }
+}
+function hostMatches(pattern, host) {
+    if (pattern.startsWith("*.")) {
+        const suffix = pattern.slice(1);
+        return host.endsWith(suffix) || host === pattern.slice(2);
+    }
+    return host === pattern;
+}
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

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

package/dist/tools/which.d.ts

@@ -0,0 +1,22 @@
+export interface WhichResult {
+    name: string;
+    path: string | null;
+    exists: boolean;
+}
+export declare const WhichInputSchema: {
+    type: string;
+    properties: {
+        name: {
+            type: string;
+        };
+    };
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare function parseWhichInput(input: Record<string, unknown>): {
+    name: string;
+};
+export declare function executeWhich(input: {
+    name: string;
+}): WhichResult;
+export declare function formatWhichResult(result: WhichResult): string;

package/dist/tools/which.js

@@ -0,0 +1,21 @@
+import { execSync } from "node:child_process";
+export const WhichInputSchema = { type: "object", properties: { name: { type: "string" } }, required: ["name"], additionalProperties: false };
+export function parseWhichInput(input) {
+    const name = typeof input.name === "string" ? input.name : "";
+    if (!name)
+        throw new Error("name is required");
+    return { name };
+}
+export function executeWhich(input) {
+    try {
+        const path = execSync(`which "${input.name.replace(/"/g, '\\"')}"`, { encoding: "utf8", timeout: 5000 }).trim();
+        return { name: input.name, path: path || null, exists: path.length > 0 };
+    }
+    catch {
+        return { name: input.name, path: null, exists: false };
+    }
+}
+export function formatWhichResult(result) {
+    return result.exists ? `${result.name}: ${result.path}` : `${result.name}: not found`;
+}
+//# sourceMappingURL=which.js.map

package/dist/tools/which.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"which.js","sourceRoot":"","sources":["../../src/tools/which.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAoC,CAAC;AAEhL,MAAM,UAAU,eAAe,CAAC,KAA8B;IAC5D,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAuB;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChH,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACzD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,aAAa,CAAC;AACxF,CAAC"}

package/dist/tools/whoami.d.ts

@@ -0,0 +1,17 @@
+export interface WhoAmIResult {
+    user: string;
+    home: string;
+    shell: string;
+    groups: string[];
+    uid: number;
+    gid: number;
+}
+export declare const WhoAmIInputSchema: {
+    type: string;
+    properties: {};
+    required: never[];
+    additionalProperties: boolean;
+};
+export declare function parseWhoAmIInput(): Record<string, never>;
+export declare function executeWhoAmI(): WhoAmIResult;
+export declare function formatWhoAmIResult(result: WhoAmIResult): string;

package/dist/tools/whoami.js

@@ -0,0 +1,24 @@
+import { execSync } from "node:child_process";
+import os from "node:os";
+export const WhoAmIInputSchema = { type: "object", properties: {}, required: [], additionalProperties: false };
+export function parseWhoAmIInput() { return {}; }
+export function executeWhoAmI() {
+    let groups = [];
+    try {
+        const raw = execSync("groups", { encoding: "utf8", timeout: 3000 });
+        groups = raw.trim().split(/\s+/);
+    }
+    catch { /* best effort */ }
+    return {
+        user: os.userInfo().username,
+        home: os.userInfo().homedir,
+        shell: os.userInfo().shell ?? "",
+        groups,
+        uid: os.userInfo().uid,
+        gid: os.userInfo().gid
+    };
+}
+export function formatWhoAmIResult(result) {
+    return [`User:  ${result.user} (uid ${result.uid}, gid ${result.gid})`, `Home:  ${result.home}`, `Shell: ${result.shell}`, `Groups: ${result.groups.join(", ")}`].join("\n");
+}
+//# sourceMappingURL=whoami.js.map

package/dist/tools/whoami.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../src/tools/whoami.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,SAAS,CAAC;AAGzB,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAoC,CAAC;AACjJ,MAAM,UAAU,gBAAgB,KAA4B,OAAO,EAAE,CAAC,CAAC,CAAC;AAExE,MAAM,UAAU,aAAa;IAC3B,IAAI,MAAM,GAAa,EAAE,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC7B,OAAO;QACL,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ;QAC5B,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO;QAC3B,KAAK,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,EAAE;QAChC,MAAM;QACN,GAAG,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG;QACtB,GAAG,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,OAAO,CAAE,UAAU,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,GAAG,SAAS,MAAM,CAAC,GAAG,GAAG,EAAE,UAAU,MAAM,CAAC,IAAI,EAAE,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,WAAW,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjL,CAAC"}

package/dist/tools/workspace-diagnostics.d.ts

@@ -0,0 +1,62 @@
+export interface WorkspaceDiagnosticsRequest {
+    path?: string;
+    format: "text" | "json";
+    maxFiles: number;
+}
+export interface WorkspaceDiagnostics {
+    root: string;
+    scan: {
+        fileCount: number;
+        directoryCount: number;
+        sampledFiles: string[];
+        truncated: boolean;
+        ignoredDirectories: string[];
+    };
+    manifests: string[];
+    packageJson?: {
+        name?: string;
+        packageManager?: string;
+        scripts: Record<string, string>;
+        dependencies: string[];
+        devDependencies: string[];
+    };
+    packageManager?: string;
+    languages: Array<{
+        name: string;
+        files: number;
+    }>;
+    frameworks: string[];
+    suggestedCommands: string[];
+    git: {
+        available: boolean;
+        repository: boolean;
+        branch?: string;
+        status?: string;
+        diffStat?: string;
+        reason?: string;
+    };
+    warnings: string[];
+}
+export declare const WorkspaceDiagnosticsInputSchema: {
+    type: string;
+    properties: {
+        path: {
+            type: string;
+        };
+        format: {
+            type: string;
+            enum: string[];
+        };
+        max_files: {
+            type: string;
+        };
+    };
+    required: never[];
+    additionalProperties: boolean;
+};
+export declare function parseWorkspaceDiagnosticsInput(input: Record<string, unknown>): WorkspaceDiagnosticsRequest;
+export declare function runWorkspaceDiagnostics(input: {
+    cwd: string;
+    request?: Partial<WorkspaceDiagnosticsRequest>;
+}): WorkspaceDiagnostics;
+export declare function formatWorkspaceDiagnostics(diagnostics: WorkspaceDiagnostics, format?: "text" | "json"): string;