@salestouch/cli 0.1.0

package/dist/setup.js

@@ -0,0 +1,473 @@
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+import { CLI_VERSION } from "./core.js";
+const CURSOR_FRONTMATTER = "---\nalwaysApply: true\n---\n\n";
+const SECTION_MARKER = "<!-- salestouch -->";
+const skillDescriptions = {
+    mcp: "Use the SalesTouch MCP server for leads, missions, offers, imports, LinkedIn prospecting, and scoring workflows that live in SalesTouch.",
+    cli: "Use the SalesTouch CLI for leads, missions, offers, imports, LinkedIn prospecting, and scoring workflows that live in SalesTouch.",
+};
+const ruleBodies = {
+    mcp: `Use SalesTouch MCP whenever the user asks about SalesTouch data or workflows: leads, missions, offers, imports, LinkedIn outreach, prospecting inbox, or scoring.
+
+Prefer this workflow:
+1. Inspect the available SalesTouch tools and resources relevant to the task.
+2. Read the input schema before making a write call.
+3. Use read-only resources and tools first when context is missing.
+4. Keep payloads deterministic and JSON-first.
+5. Summarize the outcome briefly after the action completes.
+
+Do not invent SalesTouch IDs, resource URIs, or mutation payload fields when the schema can be queried first.`,
+    cli: `Use the SalesTouch CLI whenever the user asks about SalesTouch data or workflows: leads, missions, offers, imports, LinkedIn outreach, prospecting inbox, or scoring.
+
+Prefer this workflow:
+1. Run \`salestouch commands list\` to discover commands.
+2. Run \`salestouch commands schema <command_id>\` before preparing a payload.
+3. Execute with \`salestouch commands run <command_id> --input-json ...\`.
+4. Use \`salestouch resources list\` and \`salestouch resources read <uri>\` for read-only reference data.
+5. Keep payloads deterministic and JSON-first.
+
+Do not invent SalesTouch IDs, resource URIs, or mutation payload fields when the schema can be queried first.`,
+};
+function getSkillContent(mode) {
+    const body = mode === "mcp"
+        ? `# SalesTouch
+
+Use the SalesTouch MCP server for SalesTouch-native workflows.
+
+## When To Use It
+
+- Leads, missions, offers, imports, LinkedIn prospecting, scoring
+- Workspace status and SalesTouch reference resources
+- Multi-step prospecting tasks that still map to existing SalesTouch tools
+
+## Workflow
+
+1. Inspect the available SalesTouch tools and resources relevant to the task.
+2. Read the tool schema before constructing inputs.
+3. Prefer read operations when context is missing.
+4. Execute the smallest deterministic action that satisfies the request.
+5. Summarize the result briefly and accurately.
+
+## Rules
+
+- Use SalesTouch MCP tools as the default interface to SalesTouch.
+- Prefer schema-first execution for write actions.
+- Keep payloads JSON-first and deterministic.
+- Do not invent SalesTouch IDs, handles, or hidden fields.
+- If a required field is unclear, fetch more context before writing.`
+        : `# SalesTouch
+
+Use the SalesTouch CLI for SalesTouch-native workflows.
+
+## Commands
+
+- \`salestouch commands list\`
+- \`salestouch commands schema <command_id>\`
+- \`salestouch commands run <command_id> --input-json '<json>'\`
+- \`salestouch resources list\`
+- \`salestouch resources read <uri>\`
+
+## Workflow
+
+1. Discover the command with \`salestouch commands list\`.
+2. Inspect its payload with \`salestouch commands schema\`.
+3. Execute with \`salestouch commands run\`.
+4. Use \`salestouch resources\` for read-only context.
+
+## Rules
+
+- Prefer schema-first execution for write actions.
+- Keep payloads JSON-first and deterministic.
+- Do not invent SalesTouch IDs, handles, or hidden fields.
+- If a required field is unclear, fetch more context before writing.`;
+    return `---
+name: salestouch
+description: ${skillDescriptions[mode]}
+---
+
+${body}
+`;
+}
+function getRuleContent(agent, mode) {
+    const body = ruleBodies[mode];
+    return agent === "cursor" ? `${CURSOR_FRONTMATTER}${body}\n` : `${body}\n`;
+}
+function pathExists(targetPath) {
+    return access(targetPath).then(() => true, () => false);
+}
+function stripJsonComments(text) {
+    let result = "";
+    let index = 0;
+    while (index < text.length) {
+        if (text[index] === '"') {
+            const start = index++;
+            while (index < text.length && text[index] !== '"') {
+                if (text[index] === "\\") {
+                    index += 1;
+                }
+                index += 1;
+            }
+            result += text.slice(start, ++index);
+        }
+        else if (text[index] === "/" && text[index + 1] === "/") {
+            index += 2;
+            while (index < text.length && text[index] !== "\n") {
+                index += 1;
+            }
+        }
+        else if (text[index] === "/" && text[index + 1] === "*") {
+            index += 2;
+            while (index < text.length && !(text[index] === "*" && text[index + 1] === "/")) {
+                index += 1;
+            }
+            index += 2;
+        }
+        else {
+            result += text[index];
+            index += 1;
+        }
+    }
+    return result;
+}
+async function readJsonConfig(filePath) {
+    try {
+        const raw = await readFile(filePath, "utf8");
+        const trimmed = raw.trim();
+        return trimmed ? JSON.parse(stripJsonComments(trimmed)) : {};
+    }
+    catch {
+        return {};
+    }
+}
+async function writeJsonConfig(filePath, config) {
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+async function writeJsonMcpConfig(filePath, configKey, entry) {
+    const existing = await readJsonConfig(filePath);
+    const section = existing[configKey] ?? {};
+    await writeJsonConfig(filePath, {
+        ...existing,
+        [configKey]: {
+            ...section,
+            salestouch: entry,
+        },
+    });
+    return filePath;
+}
+function buildCodexTomlBlock(options) {
+    if (options.mcpTarget === "remote") {
+        return [
+            "[mcp_servers.salestouch]",
+            `url = "${options.mcpUrl}"`,
+            "startup_timeout_sec = 20.0",
+            "",
+        ].join("\n");
+    }
+    return [
+        "[mcp_servers.salestouch]",
+        'command = "salestouch"',
+        'args = ["mcp", "serve"]',
+        "startup_timeout_sec = 20.0",
+        "",
+    ].join("\n");
+}
+async function writeCodexTomlConfig(filePath, options) {
+    const block = buildCodexTomlBlock(options);
+    let existing = "";
+    try {
+        existing = await readFile(filePath, "utf8");
+    }
+    catch {
+        // file created below
+    }
+    const sectionHeader = "[mcp_servers.salestouch]";
+    const alreadyExists = existing.includes(sectionHeader);
+    let next = existing;
+    if (alreadyExists) {
+        const sectionStart = existing.indexOf(sectionHeader);
+        const rest = existing.slice(sectionStart + sectionHeader.length);
+        const nextSectionMatch = /\n\[[^\n]+\]/.exec(rest);
+        const sectionEnd = nextSectionMatch
+            ? sectionStart + sectionHeader.length + nextSectionMatch.index + 1
+            : existing.length;
+        const before = existing.slice(0, sectionStart).replace(/\n+$/, "");
+        const after = existing.slice(sectionEnd).replace(/^\n+/, "");
+        next = `${before}${before ? "\n\n" : ""}${block}${after ? `\n${after}` : ""}`;
+    }
+    else {
+        const separator = existing.length > 0 && !existing.endsWith("\n") ? "\n\n" : existing.length > 0 ? "\n" : "";
+        next = `${existing}${separator}${block}`;
+    }
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, next, "utf8");
+    return filePath;
+}
+async function writeRule(rule, scope, content) {
+    const filePath = rule.path(scope);
+    if (rule.kind === "file") {
+        await mkdir(dirname(filePath), { recursive: true });
+        await writeFile(filePath, content, "utf8");
+        return filePath;
+    }
+    const section = `${rule.sectionMarker}\n${content}${rule.sectionMarker}`;
+    let existing = "";
+    try {
+        existing = await readFile(filePath, "utf8");
+    }
+    catch {
+        // file created below
+    }
+    if (existing.includes(rule.sectionMarker)) {
+        const escapedMarker = rule.sectionMarker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const regex = new RegExp(`${escapedMarker}\\n[\\s\\S]*?${escapedMarker}`);
+        const updated = existing.replace(regex, section);
+        await mkdir(dirname(filePath), { recursive: true });
+        await writeFile(filePath, updated, "utf8");
+        return filePath;
+    }
+    const separator = existing.length > 0 && !existing.endsWith("\n") ? "\n\n" : existing.length > 0 ? "\n" : "";
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${existing}${separator}${section}\n`, "utf8");
+    return filePath;
+}
+async function writeSkill(skillDir, mode) {
+    const targetDir = join(skillDir, "salestouch");
+    await mkdir(targetDir, { recursive: true });
+    const skillPath = join(targetDir, "SKILL.md");
+    await writeFile(skillPath, getSkillContent(mode), "utf8");
+    return skillPath;
+}
+function getManifestPath(scope) {
+    return scope === "global"
+        ? join(homedir(), ".salestouch", "setup.json")
+        : join(process.cwd(), ".salestouch", "setup.json");
+}
+async function writeSetupManifest(manifest) {
+    const manifestPath = getManifestPath(manifest.scope);
+    await mkdir(dirname(manifestPath), { recursive: true });
+    await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+    return manifestPath;
+}
+function buildClaudeEntry(options) {
+    if (options.mcpTarget === "remote") {
+        return {
+            type: "http",
+            url: options.mcpUrl,
+            ...(options.authMode === "api_key" && options.apiKey
+                ? { headers: { "X-API-Key": options.apiKey } }
+                : {}),
+        };
+    }
+    return {
+        command: "salestouch",
+        args: ["mcp", "serve"],
+    };
+}
+function buildCursorEntry(options) {
+    if (options.mcpTarget === "remote") {
+        return {
+            url: options.mcpUrl,
+            ...(options.authMode === "api_key" && options.apiKey
+                ? { headers: { "X-API-Key": options.apiKey } }
+                : {}),
+        };
+    }
+    return {
+        command: "salestouch",
+        args: ["mcp", "serve"],
+    };
+}
+function buildOpenCodeEntry(options) {
+    if (options.mcpTarget === "remote") {
+        return {
+            type: "remote",
+            url: options.mcpUrl,
+            enabled: true,
+            ...(options.authMode === "api_key" && options.apiKey
+                ? {
+                    oauth: false,
+                    headers: {
+                        "X-API-Key": options.apiKey,
+                    },
+                }
+                : {}),
+        };
+    }
+    return {
+        type: "local",
+        command: ["salestouch", "mcp", "serve"],
+        enabled: true,
+    };
+}
+function assertCodexRemoteSupport(options) {
+    if (options.mcpTarget === "remote" && options.authMode === "api_key") {
+        throw new Error("Codex remote MCP setup supports OAuth only. Use `salestouch setup --codex --login` or `--local-mcp`.");
+    }
+}
+const agents = {
+    claude: {
+        name: "claude",
+        detect: {
+            projectPaths: [".mcp.json", ".claude"],
+            globalPaths: [join(homedir(), ".claude.json"), join(homedir(), ".claude")],
+        },
+        skillDir: (scope) => scope === "global" ? join(homedir(), ".claude", "skills") : join(process.cwd(), ".claude", "skills"),
+        rule: {
+            kind: "file",
+            path: (scope) => scope === "global"
+                ? join(homedir(), ".claude", "rules", "salestouch.md")
+                : join(process.cwd(), ".claude", "rules", "salestouch.md"),
+        },
+        installMcp: (options) => writeJsonMcpConfig(options.scope === "global" ? join(homedir(), ".claude.json") : join(process.cwd(), ".mcp.json"), "mcpServers", buildClaudeEntry(options)),
+    },
+    cursor: {
+        name: "cursor",
+        detect: {
+            projectPaths: [".cursor"],
+            globalPaths: [join(homedir(), ".cursor")],
+        },
+        skillDir: (scope) => scope === "global" ? join(homedir(), ".cursor", "skills") : join(process.cwd(), ".cursor", "skills"),
+        rule: {
+            kind: "file",
+            path: (scope) => scope === "global"
+                ? join(homedir(), ".cursor", "rules", "salestouch.mdc")
+                : join(process.cwd(), ".cursor", "rules", "salestouch.mdc"),
+        },
+        installMcp: (options) => writeJsonMcpConfig(options.scope === "global"
+            ? join(homedir(), ".cursor", "mcp.json")
+            : join(process.cwd(), ".cursor", "mcp.json"), "mcpServers", buildCursorEntry(options)),
+    },
+    codex: {
+        name: "codex",
+        detect: {
+            projectPaths: [".codex", "AGENTS.md"],
+            globalPaths: [join(homedir(), ".codex")],
+        },
+        skillDir: (scope) => scope === "global" ? join(homedir(), ".agents", "skills") : join(process.cwd(), ".agents", "skills"),
+        rule: {
+            kind: "append",
+            path: (scope) => scope === "global" ? join(homedir(), ".codex", "AGENTS.md") : join(process.cwd(), "AGENTS.md"),
+            sectionMarker: SECTION_MARKER,
+        },
+        installMcp: async (options) => {
+            assertCodexRemoteSupport(options);
+            return writeCodexTomlConfig(options.scope === "global"
+                ? join(homedir(), ".codex", "config.toml")
+                : join(process.cwd(), ".codex", "config.toml"), options);
+        },
+    },
+    opencode: {
+        name: "opencode",
+        detect: {
+            projectPaths: ["opencode.json", ".opencode.json", "AGENTS.md"],
+            globalPaths: [join(homedir(), ".config", "opencode")],
+        },
+        skillDir: (scope) => scope === "global" ? join(homedir(), ".agents", "skills") : join(process.cwd(), ".agents", "skills"),
+        rule: {
+            kind: "append",
+            path: (scope) => scope === "global"
+                ? join(homedir(), ".config", "opencode", "AGENTS.md")
+                : join(process.cwd(), "AGENTS.md"),
+            sectionMarker: SECTION_MARKER,
+        },
+        installMcp: (options) => writeJsonMcpConfig(options.scope === "global"
+            ? join(homedir(), ".config", "opencode", "opencode.json")
+            : join(process.cwd(), "opencode.json"), "mcp", buildOpenCodeEntry(options)),
+    },
+};
+async function detectAgents(scope) {
+    const detected = [];
+    for (const agent of Object.values(agents)) {
+        const candidates = scope === "global" ? agent.detect.globalPaths : agent.detect.projectPaths;
+        for (const candidate of candidates) {
+            if (await pathExists(candidate)) {
+                detected.push(agent.name);
+                break;
+            }
+        }
+    }
+    return detected;
+}
+export async function resolveSetupAgents(requestedAgents, scope) {
+    if (requestedAgents.length > 0) {
+        return requestedAgents;
+    }
+    const detected = await detectAgents(scope);
+    if (detected.length > 0) {
+        return detected;
+    }
+    return ["codex"];
+}
+export async function readSetupManifest(scope) {
+    try {
+        const raw = await readFile(getManifestPath(scope), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function runSetup(options) {
+    const selectedAgents = await resolveSetupAgents(options.agents, options.scope);
+    const installSkills = options.installSkills ?? true;
+    const manifest = {
+        version: 1,
+        cli_version: CLI_VERSION,
+        generated_at: new Date().toISOString(),
+        scope: options.scope,
+        mode: options.mode,
+        mcp_target: options.mode === "mcp" ? options.mcpTarget : null,
+        auth_mode: options.mode === "mcp" ? options.authMode : null,
+        install_skills: installSkills,
+        base_url: options.baseUrl,
+        mcp_url: options.mode === "mcp" ? options.mcpUrl : null,
+        agents: selectedAgents,
+    };
+    const manifestPath = await writeSetupManifest(manifest);
+    const results = [];
+    for (const agentName of selectedAgents) {
+        const agent = agents[agentName];
+        let mcpConfigPath;
+        if (options.mode === "mcp" && agent.installMcp) {
+            mcpConfigPath = await agent.installMcp({
+                scope: options.scope,
+                authMode: options.authMode,
+                mcpTarget: options.mcpTarget,
+                mcpUrl: options.mcpUrl,
+                apiKey: options.apiKey,
+            });
+        }
+        const rulePath = await writeRule(agent.rule, options.scope, getRuleContent(agent.name, options.mode));
+        const skillPath = installSkills
+            ? await writeSkill(agent.skillDir(options.scope), options.mode)
+            : undefined;
+        results.push({
+            agent: agent.name,
+            mode: options.mode,
+            scope: options.scope,
+            mcpConfigPath,
+            rulePath,
+            skillPath,
+            manifestPath,
+        });
+    }
+    return results;
+}
+export async function runSkillsInstall(options) {
+    const selectedAgents = await resolveSetupAgents(options.agents, options.scope);
+    const results = [];
+    for (const agentName of selectedAgents) {
+        const agent = agents[agentName];
+        const skillPath = await writeSkill(agent.skillDir(options.scope), options.mode);
+        results.push({
+            agent: agent.name,
+            mode: options.mode,
+            scope: options.scope,
+            skillPath,
+        });
+    }
+    return results;
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@salestouch/cli",
+  "version": "0.1.0",
+  "description": "Public SalesTouch CLI for commands, resources, and developer workflows.",
+  "type": "module",
+  "bin": {
+    "salestouch": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.2.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "dotenv": "^17.3.1",
+    "picocolors": "^1.1.1",
+    "zod": "^4.3.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}