sandstream-kit 1.0.0

package/dist/lock.js

@@ -0,0 +1,264 @@
+/**
+ * Lock file management for kit
+ * Tracks exact versions of skills and CLI tools
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { resolve } from "node:path";
+import { existsSync } from "node:fs";
+import { createHash } from "node:crypto";
+const KIT_DIR = ".kit";
+const KIT_META_FILE = "kit.json";
+const SKILLS_LOCK_FILE = "skills-lock.json";
+const CLI_LOCK_FILE = "cli-lock.json";
+/**
+ * Get the .kit directory path
+ */
+function getkitDir() {
+    return resolve(process.cwd(), KIT_DIR);
+}
+/**
+ * Ensure .kit directory exists
+ */
+async function ensurekitDir() {
+    const dir = getkitDir();
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+    }
+}
+/**
+ * Read skills lock file
+ */
+export async function readSkillsLock() {
+    const lockPath = resolve(getkitDir(), SKILLS_LOCK_FILE);
+    if (!existsSync(lockPath)) {
+        return null;
+    }
+    try {
+        const content = await readFile(lockPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.error(`Failed to read ${SKILLS_LOCK_FILE}:`, error);
+        return null;
+    }
+}
+/**
+ * Write skills lock file
+ */
+export async function writeSkillsLock(lock) {
+    await ensurekitDir();
+    const lockPath = resolve(getkitDir(), SKILLS_LOCK_FILE);
+    try {
+        const content = JSON.stringify(lock, null, 2) + "\n";
+        await writeFile(lockPath, content, "utf-8");
+    }
+    catch (error) {
+        console.error(`Failed to write ${SKILLS_LOCK_FILE}:`, error);
+        throw error;
+    }
+}
+/**
+ * Read CLI lock file
+ */
+export async function readCliLock() {
+    const lockPath = resolve(getkitDir(), CLI_LOCK_FILE);
+    if (!existsSync(lockPath)) {
+        return null;
+    }
+    try {
+        const content = await readFile(lockPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.error(`Failed to read ${CLI_LOCK_FILE}:`, error);
+        return null;
+    }
+}
+/**
+ * Write CLI lock file
+ */
+export async function writeCliLock(lock) {
+    await ensurekitDir();
+    const lockPath = resolve(getkitDir(), CLI_LOCK_FILE);
+    try {
+        const content = JSON.stringify(lock, null, 2) + "\n";
+        await writeFile(lockPath, content, "utf-8");
+    }
+    catch (error) {
+        console.error(`Failed to write ${CLI_LOCK_FILE}:`, error);
+        throw error;
+    }
+}
+/**
+ * Read kit metadata file
+ */
+export async function readkitMeta() {
+    const metaPath = resolve(getkitDir(), KIT_META_FILE);
+    if (!existsSync(metaPath)) {
+        return null;
+    }
+    try {
+        const content = await readFile(metaPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.error(`Failed to read ${KIT_META_FILE}:`, error);
+        return null;
+    }
+}
+/**
+ * Write kit metadata file
+ */
+export async function writekitMeta(meta) {
+    await ensurekitDir();
+    const metaPath = resolve(getkitDir(), KIT_META_FILE);
+    try {
+        const content = JSON.stringify(meta, null, 2) + "\n";
+        await writeFile(metaPath, content, "utf-8");
+    }
+    catch (error) {
+        console.error(`Failed to write ${KIT_META_FILE}:`, error);
+        throw error;
+    }
+}
+/**
+ * Compute a hash for skill content
+ * For now, this creates a hash from the source+version string
+ * In the future, this should fetch and hash the actual skill content
+ */
+function computeSkillHash(source, version) {
+    const content = `${source}@${version}`;
+    return createHash("sha256").update(content).digest("hex").substring(0, 16);
+}
+/**
+ * Parse version string to extract source and determine sourceType
+ * Handles formats like:
+ * - "^2.0" or "1.2.3" → clawhub (default registry)
+ * - "github:owner/repo@tag" → github
+ * - "get-convex/agent-skills" → github
+ * - "./local/path" → local
+ */
+function parseSkillVersion(skillName, version) {
+    // Local path
+    if (version.startsWith("./") || version.startsWith("../") || version.startsWith("/")) {
+        return {
+            source: version,
+            sourceType: "local",
+        };
+    }
+    // GitHub explicit format: github:owner/repo or github:owner/repo@tag
+    if (version.startsWith("github:")) {
+        const source = version.substring(7); // Remove "github:" prefix
+        return {
+            source,
+            sourceType: "github",
+            auth: "github",
+        };
+    }
+    // GitHub org/repo format (e.g., "get-convex/agent-skills")
+    if (version.includes("/") && !version.startsWith("http")) {
+        return {
+            source: version,
+            sourceType: "github",
+            auth: "github",
+        };
+    }
+    // Default to clawhub for semver versions
+    return {
+        source: `${skillName}@${version}`,
+        sourceType: "clawhub",
+    };
+}
+/**
+ * Update skills lock with installed skills
+ * Accepts version strings and converts to hash-based format
+ */
+export async function updateSkillsLock(skills, kit) {
+    const existing = await readSkillsLock();
+    const lock = {
+        version: 1,
+        kit: kit || existing?.kit,
+        skills: {},
+    };
+    // Preserve existing entries and merge with new ones
+    if (existing) {
+        lock.skills = { ...existing.skills };
+    }
+    // Add/update skills
+    for (const [name, version] of Object.entries(skills)) {
+        const parsed = parseSkillVersion(name, version);
+        const existingEntry = lock.skills[name];
+        lock.skills[name] = {
+            source: parsed.source,
+            sourceType: parsed.sourceType,
+            computedHash: existingEntry?.computedHash || computeSkillHash(parsed.source, version),
+            auth: parsed.auth || existingEntry?.auth,
+            installedAt: existingEntry?.installedAt || new Date().toISOString(),
+        };
+    }
+    await writeSkillsLock(lock);
+}
+/**
+ * Update CLI lock with installed tools
+ */
+export async function updateCliLock(tools) {
+    const existing = await readCliLock();
+    const lock = {
+        version: 1,
+        tools: {},
+    };
+    // Preserve existing entries and merge with new ones
+    if (existing) {
+        lock.tools = { ...existing.tools };
+    }
+    // Add/update tools
+    for (const [name, info] of Object.entries(tools)) {
+        lock.tools[name] = {
+            version: info.version,
+            source: info.source,
+            auth: info.auth,
+            installedAt: new Date().toISOString(),
+        };
+    }
+    await writeCliLock(lock);
+}
+export async function checkLockStatus(configSkills, configTools) {
+    const skillsLock = await readSkillsLock();
+    const cliLock = await readCliLock();
+    const status = {
+        skillsLockExists: skillsLock !== null,
+        cliLockExists: cliLock !== null,
+        skillsInSync: true,
+        cliInSync: true,
+        missingSkills: [],
+        missingTools: [],
+    };
+    // Check skills
+    if (!skillsLock) {
+        status.skillsInSync = false;
+        status.missingSkills = Object.keys(configSkills);
+    }
+    else {
+        for (const skillName of Object.keys(configSkills)) {
+            if (!skillsLock.skills[skillName]) {
+                status.skillsInSync = false;
+                status.missingSkills.push(skillName);
+            }
+        }
+    }
+    // Check tools
+    if (!cliLock) {
+        status.cliInSync = false;
+        status.missingTools = Object.keys(configTools);
+    }
+    else {
+        for (const toolName of Object.keys(configTools)) {
+            if (!cliLock.tools[toolName]) {
+                status.cliInSync = false;
+                status.missingTools.push(toolName);
+            }
+        }
+    }
+    return status;
+}
+//# sourceMappingURL=lock.js.map

package/dist/lock.js.map

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

package/dist/login.d.ts

@@ -0,0 +1,23 @@
+import type { ServiceConfig } from "./config.js";
+import { type ServiceStatus } from "./check-services.js";
+export interface LoginResult {
+    name: string;
+    action: "already_authenticated" | "logged_in" | "login_unverified" | "failed";
+    detail: string;
+}
+export interface LoginDeps {
+    checkServices: (services: Record<string, ServiceConfig>) => Promise<ServiceStatus[]>;
+    runLogin: (command: string) => Promise<{
+        ok: boolean;
+        detail: string;
+    }>;
+    runLink: (command: string) => Promise<{
+        ok: boolean;
+        detail: string;
+    }>;
+    runVerify: (command: string) => Promise<{
+        ok: boolean;
+        output: string;
+    }>;
+}
+export declare function loginServices(services: Record<string, ServiceConfig>, deps?: LoginDeps): Promise<LoginResult[]>;

package/dist/login.js

@@ -0,0 +1,132 @@
+import { execFile, spawn } from "node:child_process";
+import { promisify } from "node:util";
+import { checkServices } from "./check-services.js";
+import { isNonInteractive } from "./environment.js";
+import { parseCommand } from "./utils/parseCommand.js";
+const exec = promisify(execFile);
+function runInteractive(command) {
+    const parsed = parseCommand(command);
+    if (parsed.kind === "informational") {
+        if (!isNonInteractive()) {
+            console.log(`\x1b[33m${parsed.message}\x1b[0m`);
+        }
+        return Promise.resolve({
+            ok: false,
+            detail: `manual setup required: ${parsed.message}`,
+        });
+    }
+    if (isNonInteractive()) {
+        return Promise.resolve({
+            ok: false,
+            detail: "skipped in non-interactive mode",
+        });
+    }
+    return new Promise((resolve) => {
+        const child = spawn(parsed.cmd, parsed.args, {
+            stdio: "inherit",
+            env: { ...process.env },
+        });
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve({ ok: true, detail: "Login completed" });
+            }
+            else {
+                resolve({ ok: false, detail: `Login exited with code ${code}` });
+            }
+        });
+        child.on("error", (err) => {
+            resolve({ ok: false, detail: err.message });
+        });
+    });
+}
+async function runQuiet(command) {
+    const parsed = parseCommand(command);
+    if (parsed.kind === "informational") {
+        return { ok: false, output: parsed.message };
+    }
+    try {
+        const { stdout, stderr } = await exec(parsed.cmd, parsed.args, {
+            timeout: 15_000,
+            env: { ...process.env },
+        });
+        return { ok: true, output: (stdout || stderr).trim() };
+    }
+    catch {
+        return { ok: false, output: "Command failed" };
+    }
+}
+const defaultDeps = {
+    checkServices,
+    runLogin: runInteractive,
+    runLink: runInteractive,
+    runVerify: runQuiet,
+};
+export async function loginServices(services, deps = defaultDeps) {
+    const statuses = await deps.checkServices(services);
+    const results = [];
+    for (const status of statuses) {
+        if (status.authenticated) {
+            results.push({
+                name: status.name,
+                action: "already_authenticated",
+                detail: status.output,
+            });
+            continue;
+        }
+        const config = services[status.name];
+        if (!config?.login) {
+            results.push({
+                name: status.name,
+                action: "failed",
+                detail: "No login command configured",
+            });
+            continue;
+        }
+        console.log(`\n\x1b[1mLogging in to ${status.name}...\x1b[0m`);
+        const login = await deps.runLogin(config.login);
+        if (!login.ok) {
+            results.push({ name: status.name, action: "failed", detail: login.detail });
+            continue;
+        }
+        // Run link command if configured (e.g. supabase link, vercel link)
+        if (config.link) {
+            console.log(`\x1b[2mLinking ${status.name}...\x1b[0m`);
+            const link = await deps.runLink(config.link);
+            if (!link.ok) {
+                results.push({
+                    name: status.name,
+                    action: "login_unverified",
+                    detail: `Login OK but link failed: ${link.detail}`,
+                });
+                continue;
+            }
+        }
+        // Verify login by re-running check
+        if (config.check) {
+            const verify = await deps.runVerify(config.check);
+            if (verify.ok) {
+                results.push({
+                    name: status.name,
+                    action: "logged_in",
+                    detail: verify.output,
+                });
+            }
+            else {
+                results.push({
+                    name: status.name,
+                    action: "login_unverified",
+                    detail: "Login command succeeded but verification failed",
+                });
+            }
+        }
+        else {
+            results.push({
+                name: status.name,
+                action: "logged_in",
+                detail: login.detail,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=login.js.map

package/dist/login.js.map

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

package/dist/mcp-kit-tools-model.d.ts

@@ -0,0 +1,195 @@
+/**
+ * kit MCP Tools — data models
+ * Configuration, health checks, installation, and provisioning via MCP
+ */
+export type ConfigScope = "global" | "project" | "user";
+export type ConfigCategory = "adapter" | "tool" | "service" | "path" | "feature";
+export type ValidationResult = "valid" | "invalid" | "warning";
+export interface ConfigValue {
+    key: string;
+    value: unknown;
+    type: "string" | "number" | "boolean" | "array" | "object";
+    scope: ConfigScope;
+    category: ConfigCategory;
+    description?: string;
+    required?: boolean;
+    default?: unknown;
+    validation_rule?: string;
+    last_modified?: string;
+    modified_by?: string;
+}
+export interface ConfigValidation {
+    key: string;
+    result: ValidationResult;
+    message: string;
+    suggestions?: string[];
+    timestamp: string;
+}
+export interface ConfigDiff {
+    key: string;
+    old_value: unknown;
+    new_value: unknown;
+    scope: ConfigScope;
+    changed_at: string;
+    changed_by?: string;
+}
+export interface AdapterConfig {
+    name: string;
+    enabled: boolean;
+    version?: string;
+    settings: Record<string, unknown>;
+    credentials_configured: boolean;
+    health_status?: "healthy" | "warning" | "error";
+    last_check?: string;
+}
+export interface ToolConfig {
+    name: string;
+    installed: boolean;
+    version?: string;
+    path?: string;
+    required: boolean;
+    auto_update: boolean;
+    health_status?: "healthy" | "missing" | "incompatible";
+}
+export interface ServiceConfig {
+    name: string;
+    enabled: boolean;
+    endpoint?: string;
+    port?: number;
+    protocol?: "http" | "https" | "websocket" | "grpc";
+    health_check_url?: string;
+    status?: "running" | "stopped" | "error";
+    last_status_check?: string;
+}
+export interface PathConfig {
+    key: string;
+    value: string;
+    type: "project_root" | "cache_dir" | "config_dir" | "data_dir" | "temp_dir" | "lock_dir";
+    expandable: boolean;
+    must_exist: boolean;
+    writable: boolean;
+}
+export interface FeatureFlag {
+    name: string;
+    enabled: boolean;
+    scope: ConfigScope;
+    rollout_percentage?: number;
+    description?: string;
+    dependencies?: string[];
+}
+export interface MCPTool {
+    id: string;
+    name: string;
+    description: string;
+    category: "configuration" | "health" | "installation" | "provisioning" | "utility";
+    version: string;
+    actions: ToolAction[];
+    requires_auth?: boolean;
+    rate_limit?: number;
+}
+export interface ToolAction {
+    name: string;
+    description: string;
+    parameters: ToolParameter[];
+    returns: ToolReturn;
+    requires_confirmation?: boolean;
+    dry_run_supported?: boolean;
+}
+export interface ToolParameter {
+    name: string;
+    description: string;
+    type: "string" | "number" | "boolean" | "array" | "object";
+    required: boolean;
+    default?: unknown;
+    enum?: unknown[];
+    min?: number;
+    max?: number;
+    pattern?: string;
+}
+export interface ToolReturn {
+    type: "string" | "number" | "boolean" | "object" | "array";
+    description: string;
+    schema?: Record<string, unknown>;
+}
+export interface MCPToolResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    warnings?: string[];
+    execution_time_ms?: number;
+}
+export interface ConfigSnapshot {
+    id: string;
+    timestamp: string;
+    created_by?: string;
+    config_state: Record<string, unknown>;
+    description?: string;
+}
+export interface ConfigRollback {
+    from_snapshot: string;
+    to_snapshot: string;
+    changes_reverted: number;
+    timestamp: string;
+    performed_by?: string;
+}
+export interface AdapterCheckResult {
+    adapter_name: string;
+    overall_status: "healthy" | "degraded" | "unhealthy";
+    installed: boolean;
+    configured: boolean;
+    authenticated: boolean;
+    available: boolean;
+    checks: {
+        name: string;
+        status: "pass" | "fail" | "warning";
+        message: string;
+        details?: Record<string, unknown>;
+    }[];
+    recommendations?: string[];
+    last_checked: string;
+}
+export interface AdapterDependency {
+    name: string;
+    required: boolean;
+    installed: boolean;
+    version?: string;
+    compatible: boolean;
+    min_version?: string;
+}
+export interface AdapterHealth {
+    adapter_name: string;
+    healthy: boolean;
+    uptime_seconds?: number;
+    last_error?: string;
+    error_count: number;
+    success_count: number;
+    average_response_time_ms?: number;
+    last_checked: string;
+}
+export interface AdapterInstallResult {
+    adapter_name: string;
+    success: boolean;
+    installed: boolean;
+    version?: string;
+    configured: boolean;
+    env_vars_set: string[];
+    setup_required: boolean;
+    next_steps?: string[];
+    message: string;
+    timestamp: string;
+}
+export interface AdapterSetupConfig {
+    adapter_name: string;
+    auto_configure: boolean;
+    interactive: boolean;
+    env_vars?: Record<string, string>;
+    settings?: Record<string, unknown>;
+}
+export interface EnvironmentVariable {
+    key: string;
+    value: string;
+    adapter_name: string;
+    required: boolean;
+    description?: string;
+    set_at: string;
+}

package/dist/mcp-kit-tools-model.js

@@ -0,0 +1,6 @@
+/**
+ * kit MCP Tools — data models
+ * Configuration, health checks, installation, and provisioning via MCP
+ */
+export {};
+//# sourceMappingURL=mcp-kit-tools-model.js.map

package/dist/mcp-kit-tools-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-kit-tools-model.js","sourceRoot":"","sources":["../src/mcp-kit-tools-model.ts"],"names":[],"mappings":"AAAA;;;GAGG"}