mthds 0.0.5 → 0.0.7

package/dist/resolver/validate.js

@@ -0,0 +1,177 @@
+import { parse } from "smol-toml";
+const SEMVER_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+const SNAKE_CASE_RE = /^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/;
+const SLUG_RE = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+const RESERVED_PREFIXES = ["native", "mthds", "pipelex"];
+export function validateSlug(name) {
+    if (!name) {
+        return { valid: false, error: "Slug cannot be empty." };
+    }
+    if (name.length > 64) {
+        return { valid: false, error: `Slug must be at most 64 characters (got ${name.length}).` };
+    }
+    if (!SLUG_RE.test(name)) {
+        return {
+            valid: false,
+            error: `Slug "${name}" is invalid: must be lowercase alphanumeric with hyphens, starting with a letter.`,
+        };
+    }
+    return { valid: true };
+}
+function validateExportNode(node, path, errors) {
+    if (!node || typeof node !== "object" || Array.isArray(node)) {
+        errors.push(`[exports.${path}] must be a table.`);
+        return;
+    }
+    const obj = node;
+    for (const [key, value] of Object.entries(obj)) {
+        if (key === "pipes") {
+            if (!Array.isArray(value)) {
+                errors.push(`[exports.${path}.pipes] must be an array of strings.`);
+                continue;
+            }
+            for (const pipe of value) {
+                if (typeof pipe !== "string") {
+                    errors.push(`[exports.${path}.pipes] must contain only strings.`);
+                    break;
+                }
+                if (!SNAKE_CASE_RE.test(pipe)) {
+                    errors.push(`[exports.${path}.pipes] "${pipe}" must be snake_case.`);
+                }
+            }
+        }
+        else {
+            // Nested sub-domain
+            validateExportNode(value, `${path}.${key}`, errors);
+        }
+    }
+}
+export function validateManifest(raw) {
+    const errors = [];
+    let parsed;
+    try {
+        parsed = parse(raw);
+    }
+    catch (err) {
+        return {
+            valid: false,
+            errors: [`TOML parse error: ${err.message}`],
+        };
+    }
+    // --- [package] section ---
+    const pkg = parsed["package"];
+    if (!pkg || typeof pkg !== "object") {
+        errors.push('[package] section is required.');
+        return { valid: false, errors };
+    }
+    // package.address
+    if (typeof pkg["address"] !== "string" || !pkg["address"]) {
+        errors.push('[package.address] is required and must be a non-empty string.');
+    }
+    else {
+        const addr = pkg["address"];
+        const slashIdx = addr.indexOf("/");
+        const hostname = slashIdx > 0 ? addr.slice(0, slashIdx) : addr;
+        if (!hostname.includes(".")) {
+            errors.push(`[package.address] hostname must contain a dot (got "${hostname}"). Example: github.com/org/repo`);
+        }
+    }
+    // package.version
+    if (typeof pkg["version"] !== "string" || !pkg["version"]) {
+        errors.push('[package.version] is required and must be a non-empty string.');
+    }
+    else if (!SEMVER_RE.test(pkg["version"])) {
+        errors.push(`[package.version] must be valid semver (got "${pkg["version"]}").`);
+    }
+    // package.description
+    if (typeof pkg["description"] !== "string" || !pkg["description"]) {
+        errors.push('[package.description] is required and must be a non-empty string.');
+    }
+    // package.display_name (optional)
+    if (pkg["display_name"] !== undefined) {
+        if (typeof pkg["display_name"] !== "string") {
+            errors.push('[package.display_name] must be a string.');
+        }
+        else if (pkg["display_name"].length > 128) {
+            errors.push('[package.display_name] must be at most 128 characters.');
+        }
+    }
+    // package.authors (optional)
+    if (pkg["authors"] !== undefined) {
+        if (!Array.isArray(pkg["authors"])) {
+            errors.push('[package.authors] must be an array of strings.');
+        }
+        else {
+            for (const a of pkg["authors"]) {
+                if (typeof a !== "string") {
+                    errors.push('[package.authors] must contain only strings.');
+                    break;
+                }
+            }
+        }
+    }
+    // package.license (optional)
+    if (pkg["license"] !== undefined) {
+        if (typeof pkg["license"] !== "string") {
+            errors.push('[package.license] must be a string.');
+        }
+    }
+    // package.mthds_version (optional)
+    if (pkg["mthds_version"] !== undefined) {
+        if (typeof pkg["mthds_version"] !== "string") {
+            errors.push('[package.mthds_version] must be a string.');
+        }
+    }
+    // --- [exports] section (optional, hierarchical) ---
+    const exports = parsed["exports"];
+    if (exports && typeof exports === "object") {
+        for (const [domain, node] of Object.entries(exports)) {
+            const domainLower = domain.toLowerCase();
+            const matchedPrefix = RESERVED_PREFIXES.find((prefix) => domainLower.startsWith(prefix));
+            if (matchedPrefix) {
+                errors.push(`[exports."${domain}"] domain cannot start with reserved prefix "${matchedPrefix}".`);
+            }
+            validateExportNode(node, domain, errors);
+        }
+    }
+    // --- [dependencies] section (optional) ---
+    const deps = parsed["dependencies"];
+    if (deps && typeof deps === "object") {
+        for (const [alias, dep] of Object.entries(deps)) {
+            if (!SNAKE_CASE_RE.test(alias)) {
+                errors.push(`[dependencies."${alias}"] alias must be snake_case.`);
+            }
+            const d = dep;
+            if (!d || typeof d !== "object") {
+                errors.push(`[dependencies."${alias}"] must be a table with address and version.`);
+                continue;
+            }
+            if (typeof d["address"] !== "string" || !d["address"]) {
+                errors.push(`[dependencies."${alias}".address] is required.`);
+            }
+            if (typeof d["version"] !== "string" || !d["version"]) {
+                errors.push(`[dependencies."${alias}".version] is required.`);
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors };
+    }
+    // Build typed manifest
+    const manifestPkg = {
+        address: pkg["address"],
+        version: pkg["version"],
+        description: pkg["description"],
+        ...(pkg["display_name"] !== undefined ? { display_name: pkg["display_name"] } : {}),
+        ...(pkg["authors"] !== undefined ? { authors: pkg["authors"] } : {}),
+        ...(pkg["license"] !== undefined ? { license: pkg["license"] } : {}),
+        ...(pkg["mthds_version"] !== undefined ? { mthds_version: pkg["mthds_version"] } : {}),
+    };
+    const manifest = {
+        package: manifestPkg,
+        ...(exports ? { exports: exports } : {}),
+        ...(deps ? { dependencies: deps } : {}),
+    };
+    return { valid: true, errors: [], manifest };
+}
+//# sourceMappingURL=validate.js.map

package/dist/resolver/validate.js.map

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

package/dist/supabase/methods.d.ts

@@ -1,2 +1,2 @@
-import type { Method } from "./types.js";
-export declare function fetchMethodBySlug(slug: string): Promise<Method | null>;
+import type { Package } from "./types.js";
+export declare function fetchPackageByAddressAndSlug(address: string, slug: string): Promise<Package | null>;

package/dist/supabase/methods.js

@@ -1,9 +1,10 @@
 import { supabase } from "./client.js";
-export async function fetchMethodBySlug(slug) {
+export async function fetchPackageByAddressAndSlug(address, slug) {
     const { data, error } = await supabase
-        .from("methods")
+        .from("packages")
         .select("*")
-        .eq("name", slug)
+        .eq("address", address)
+        .eq("slug", slug)
         .single();
     if (error || !data)
         return null;

package/dist/supabase/methods.js.map

@@ -1 +1 @@
-{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../src/supabase/methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY;IAEZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ;SACnC,IAAI,CAAC,SAAS,CAAC;SACf,MAAM,CAAC,GAAG,CAAC;SACX,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC;SAChB,MAAM,EAAE,CAAC;IAEZ,IAAI,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../src/supabase/methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAAe,EACf,IAAY;IAEZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ;SACnC,IAAI,CAAC,UAAU,CAAC;SAChB,MAAM,CAAC,GAAG,CAAC;SACX,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;SACtB,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC;SAChB,MAAM,EAAE,CAAC;IAEZ,IAAI,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/supabase/types.d.ts

@@ -1,21 +1,26 @@
-export interface Method {
+export interface Package {
     id: string;
-    name: string;
-    description: string | null;
-    content: string | null;
+    address: string;
+    slug: string;
     version: string | null;
-    repository: string | null;
-    dependencies: string | null;
+    description: string | null;
+    display_name: string | null;
+    authors: string[] | null;
+    license: string | null;
+    mthds_version: string | null;
+    exports: Record<string, unknown> | null;
+    dependencies: Record<string, unknown> | null;
+    manifest_raw: string | null;
     installs: number;
     created_at: string;
 }
 export interface Database {
     public: {
         Tables: {
-            methods: {
-                Row: Method;
-                Insert: Omit<Method, "id" | "created_at" | "installs">;
-                Update: Partial<Omit<Method, "id">>;
+            packages: {
+                Row: Package;
+                Insert: Omit<Package, "id" | "created_at" | "installs">;
+                Update: Partial<Omit<Package, "id">>;
             };
         };
         Views: Record<string, never>;

package/dist/telemetry/posthog.d.ts

@@ -1,2 +1,24 @@
-export declare function trackMethodInstall(methodId: string): void;
+export type TelemetrySource = "env" | "env.local" | "config" | "default";
+export declare function getTelemetryStatus(): {
+    enabled: boolean;
+    source: TelemetrySource;
+};
+export declare function setTelemetryEnabled(enabled: boolean): void;
+export interface InstallEvent {
+    address: string;
+    slug: string;
+    version: string;
+    description: string;
+    display_name?: string;
+    authors?: string[];
+    license?: string;
+    mthds_version?: string;
+    exports?: Record<string, unknown>;
+    dependencies?: Record<string, {
+        address: string;
+        version: string;
+    }>;
+    manifest_raw: string;
+}
+export declare function trackInstall(data: InstallEvent): void;
 export declare function shutdown(): Promise<void>;

package/dist/telemetry/posthog.js

@@ -1,9 +1,81 @@
 import { PostHog } from "posthog-node";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from "node:fs";
 const POSTHOG_API_KEY = "phc_ylV9FzMiQDyGgtd5nJn0Cc2OkyHAobfj7xDhYloH5IA";
 const POSTHOG_HOST = "https://eu.i.posthog.com";
+const CONFIG_DIR = join(homedir(), ".mthds");
+const CONFIG_PATH = join(CONFIG_DIR, "config.json");
+const ENV_LOCAL_PATH = join(CONFIG_DIR, ".env.local");
 let client = null;
+function readEnvLocal() {
+    if (!existsSync(ENV_LOCAL_PATH))
+        return false;
+    try {
+        const content = readFileSync(ENV_LOCAL_PATH, "utf-8");
+        return content.split("\n").some((line) => {
+            const trimmed = line.trim();
+            if (trimmed.startsWith("#"))
+                return false;
+            const [key, ...rest] = trimmed.split("=");
+            if (key?.trim() !== "DISABLE_TELEMETRY")
+                return false;
+            const val = rest.join("=").trim().replace(/^["']|["']$/g, "").trim();
+            return val === "1";
+        });
+    }
+    catch {
+        return false;
+    }
+}
+function readConfigTelemetry() {
+    if (!existsSync(CONFIG_PATH))
+        return undefined;
+    try {
+        const raw = readFileSync(CONFIG_PATH, "utf-8");
+        const config = JSON.parse(raw);
+        if ("telemetry" in config && typeof config.telemetry === "boolean") {
+            return config.telemetry;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function getTelemetryStatus() {
+    // 1. Env var (highest priority)
+    if (process.env["DISABLE_TELEMETRY"] === "1") {
+        return { enabled: false, source: "env" };
+    }
+    // 2. ~/.mthds/.env.local
+    if (readEnvLocal()) {
+        return { enabled: false, source: "env.local" };
+    }
+    // 3. ~/.mthds/config.json
+    const configVal = readConfigTelemetry();
+    if (configVal !== undefined) {
+        return { enabled: configVal, source: "config" };
+    }
+    // Default: enabled
+    return { enabled: true, source: "default" };
+}
+export function setTelemetryEnabled(enabled) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    let config = {};
+    if (existsSync(CONFIG_PATH)) {
+        try {
+            config = JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
+        }
+        catch {
+            // ignore parse errors, overwrite
+        }
+    }
+    config.telemetry = enabled;
+    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
 function isDisabled() {
-    return process.env["DISABLE_TELEMETRY"] === "1";
+    return !getTelemetryStatus().enabled;
 }
 function getClient() {
     if (isDisabled())
@@ -13,15 +85,25 @@ function getClient() {
     }
     return client;
 }
-export function trackMethodInstall(methodId) {
+export function trackInstall(data) {
     const posthog = getClient();
     if (!posthog)
         return;
     posthog.capture({
         distinctId: "anonymous",
-        event: "method_installed",
+        event: "install",
         properties: {
-            method: methodId,
+            address: data.address,
+            slug: data.slug,
+            version: data.version,
+            description: data.description,
+            display_name: data.display_name,
+            authors: data.authors ? JSON.stringify(data.authors) : undefined,
+            license: data.license,
+            mthds_version: data.mthds_version,
+            exports: data.exports ? JSON.stringify(data.exports) : undefined,
+            dependencies: data.dependencies ? JSON.stringify(data.dependencies) : undefined,
+            manifest_raw: data.manifest_raw,
             timestamp: new Date().toISOString(),
         },
     });

package/dist/telemetry/posthog.js.map

@@ -1 +1 @@
-{"version":3,"file":"posthog.js","sourceRoot":"","sources":["../../src/telemetry/posthog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,eAAe,GAAG,iDAAiD,CAAC;AAC1E,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEhD,IAAI,MAAM,GAAmB,IAAI,CAAC;AAElC,SAAS,UAAU;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,GAAG,CAAC;AAClD,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,UAAU,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,IAAI,OAAO,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO;IAErB,OAAO,CAAC,OAAO,CAAC;QACd,UAAU,EAAE,WAAW;QACvB,KAAK,EAAE,kBAAkB;QACzB,UAAU,EAAE;YACV,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
+{"version":3,"file":"posthog.js","sourceRoot":"","sources":["../../src/telemetry/posthog.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mthds",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "CLI and SDK for MTHDS — the open standard for reusable AI agent methods. Install, execute, and manage methods.",
   "license": "MIT",
   "repository": {
@@ -21,6 +21,7 @@
   },
   "scripts": {
     "build": "tsc",
+    "test": "vitest run",
     "example": "npx tsx examples/call_api.ts"
   },
   "files": [
@@ -35,11 +36,13 @@
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
     "ora": "^8.2.0",
-    "posthog-node": "^4.4.0"
+    "posthog-node": "^4.4.0",
+    "smol-toml": "^1.6.0"
   },
   "devDependencies": {
     "@types/node": "^22.12.0",
     "tsx": "^4.19.0",
-    "typescript": "^5.7.3"
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18"
   }
 }