@prompts-gpt/client 0.2.2 → 0.2.4

package/dist/index.js

@@ -1,11 +1,26 @@
 import { chmod, mkdir, readFile, writeFile } from "node:fs/promises";
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
+import { ensureGitignoreEntry } from "./runtime.js";
+export { DEFAULT_RUN_ARTIFACTS_DIR, DEFAULT_RUN_CONFIG_PATH, ORCHESTRATION_AGENT_PROFILES, DEFAULT_MODELS, normalizeOrchestrationAgent, normalizeConcreteProvider, loadRunConfig, detectProviders, doctor, initRunConfig, runBatch, runPrompt, resolveRunProvider, resolveTimeoutSeconds, resolveDefaultPromptFile, assertPromptFitsLaunch, warnModelProviderMismatch, executeProviderCommandWithRetries, executeProviderCommand, captureWorktreeStatus, buildWorktreeDelta, buildProviderCommand, formatCombinedOutput, appendFileSafe, aggregateTokenUsage, validateRunConfig, discoverWorkspaceAssets, emptyTokenUsage, extractTokenUsageFromLog, hasTokenUsage, isCI, readTokenUsageFromLog, } from "./runtime.js";
+export { sweepPrompt, acquireSweepLock, releaseSweepLock, parseStreamJsonToolCounts, streamJsonHasResult, extractIterationSummary, buildIterationPrompt, runPreFlight, writeSweepManifest, } from "./sweep.js";
 export const DEFAULT_PROMPTS_GPT_API_URL = "https://prompts-gpt.com";
 export const DEFAULT_PROMPTS_GPT_OUT_DIR = ".prompts-gpt";
 export const PROMPTS_GPT_CREDENTIALS_FILE = ".credentials.json";
 export const PROMPTS_GPT_MANIFEST_FILE = "manifest.json";
-export const SUPPORTED_AGENT_TARGETS = ["codex", "cursor", "vscode", "copilot"];
+export const SUPPORTED_AGENT_TARGETS = [
+    "codex",
+    "claude-code",
+    "cursor",
+    "vscode",
+    "copilot",
+    "continue",
+    "gemini-cli",
+    "windsurf",
+    "cline",
+    "junie",
+    "amp",
+];
 export class PromptsGptApiError extends Error {
     status;
     code;
@@ -20,7 +35,7 @@ export class PromptsGptApiError extends Error {
         this.code = options?.code ?? "UNKNOWN_ERROR";
         this.recovery = options?.recovery ?? "Retry the request or create a fresh project token.";
         this.requestId = options?.requestId ?? null;
-        this.fieldErrors = options?.fieldErrors;
+        this.fieldErrors = options?.fieldErrors ? Object.freeze({ ...options.fieldErrors }) : undefined;
         this.retryAfterMs = options?.retryAfterMs ?? null;
     }
 }
@@ -33,11 +48,16 @@ export class PromptsGptClient {
     token;
     fetchImpl;
     timeoutMs;
+    accountId;
     constructor(options) {
         this.apiUrl = safeNormalizeApiUrl(options.apiUrl);
         this.token = options.token?.trim() || null;
         this.fetchImpl = options.fetch;
         this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.accountId = options.accountId?.trim() || null;
+        if (this.token && this.apiUrl.startsWith("http://") && !this.apiUrl.includes("localhost") && !this.apiUrl.includes("127.0.0.1")) {
+            throw new PromptsGptApiError("Refusing to send credentials over unencrypted HTTP. Use HTTPS or localhost.", { code: "INSECURE_TRANSPORT", recovery: "Change the API URL to use https://." });
+        }
     }
     async getProject(options = {}) {
         const data = await this.request("/api/sdk/v1/project", options);
@@ -121,7 +141,11 @@ export class PromptsGptClient {
                 authorization: `Bearer ${this.token}`,
                 accept: "application/json",
                 "x-prompts-gpt-client": `@prompts-gpt/client/${getClientVersion()}`,
+                "x-prompts-gpt-build": getBuildFingerprint(),
             };
+            if (this.accountId) {
+                headers["x-prompts-gpt-account"] = this.accountId;
+            }
             if (!options.omitUserAgent) {
                 headers["user-agent"] = `prompts-gpt-client/${getClientVersion()}`;
             }
@@ -245,7 +269,9 @@ function normalizeTimeoutMs(value) {
             recovery: "Provide a timeout greater than 0.",
         });
     }
-    return Math.min(Math.trunc(value), 300_000);
+    const MAX_API_TIMEOUT_MS = 600_000;
+    const capped = Math.min(Math.trunc(value), MAX_API_TIMEOUT_MS);
+    return capped;
 }
 function serializePromptQuery(query) {
     const params = new URLSearchParams();
@@ -340,11 +366,37 @@ function parseRetryAfterHeader(value) {
     return Math.min(Math.max(retryAt - Date.now(), 0), 600_000);
 }
 function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
 }
 function generateRequestId() {
-    const hex = Array.from({ length: 8 }, () => Math.floor(Math.random() * 256).toString(16).padStart(2, "0")).join("");
-    return `pgcli_${hex}`;
+    try {
+        const crypto = globalThis.crypto;
+        const bytes = new Uint8Array(8);
+        crypto.getRandomValues(bytes);
+        return `pgcli_${Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("")}`;
+    }
+    catch {
+        const hex = Array.from({ length: 8 }, () => Math.floor(Math.random() * 256).toString(16).padStart(2, "0")).join("");
+        return `pgcli_${hex}`;
+    }
+}
+const BUILD_TS = "dev";
+const BUILD_ACCOUNT_ID = "unattributed";
+let cachedBuildFingerprint = null;
+function getBuildFingerprint() {
+    if (cachedBuildFingerprint)
+        return cachedBuildFingerprint;
+    cachedBuildFingerprint = `${getClientVersion()}/${BUILD_TS}/${BUILD_ACCOUNT_ID}`;
+    return cachedBuildFingerprint;
+}
+export function getAttribution() {
+    return {
+        version: getClientVersion(),
+        buildTs: BUILD_TS,
+        accountId: BUILD_ACCOUNT_ID,
+    };
 }
 let cachedVersion = null;
 function getClientVersion() {
@@ -381,16 +433,24 @@ export async function loadLocalCredentials(cwd = process.cwd()) {
     if (!existsSync(credentialsPath))
         return null;
     try {
-        const parsed = JSON.parse(await readFile(credentialsPath, "utf8"));
+        const raw = await readFile(credentialsPath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return null;
         let apiUrl = DEFAULT_PROMPTS_GPT_API_URL;
         if (typeof parsed.apiUrl === "string") {
             try {
-                new URL(parsed.apiUrl);
-                apiUrl = parsed.apiUrl;
+                const url = new URL(parsed.apiUrl);
+                if (url.protocol === "https:" || url.protocol === "http:") {
+                    apiUrl = parsed.apiUrl;
+                }
             }
-            catch { }
+            catch { /* invalid URL — use default */ }
         }
         const rawToken = typeof parsed.token === "string" ? parsed.token.trim() : null;
+        if (rawToken && !rawToken.startsWith("pgpt_")) {
+            return { token: null, apiUrl };
+        }
         return {
             token: rawToken || null,
             apiUrl,
@@ -446,6 +506,9 @@ export async function writePromptMarkdownFiles(prompts, options = {}) {
 }
 export async function writeAgentFiles(prompts, options = {}) {
     const cwd = options.cwd ?? process.cwd();
+    if (!existsSync(cwd)) {
+        throw new Error(`Working directory does not exist: ${cwd}`);
+    }
     const targets = normalizeAgentTargets(options.agent ?? options.agents ?? "all");
     const overwrite = Boolean(options.overwriteAgentFiles);
     const written = [];
@@ -494,9 +557,13 @@ export async function writePromptManifest(prompts, options = {}) {
     const normalizedPrompts = assertUniquePromptFileStems(prompts);
     await mkdir(outDir, { recursive: true });
     const manifestPath = path.join(outDir, PROMPTS_GPT_MANIFEST_FILE);
+    const attribution = getAttribution();
     const payload = {
         version: 1,
         generatedAt: new Date().toISOString(),
+        generatedBy: `@prompts-gpt/client@${attribution.version}`,
+        accountId: attribution.accountId,
+        buildFingerprint: `${attribution.version}/${attribution.buildTs}/${attribution.accountId}`,
         count: normalizedPrompts.length,
         prompts: normalizedPrompts.map(({ prompt, stem }) => ({
             slug: stem,
@@ -567,24 +634,47 @@ function buildAgentFiles(target, prompts) {
                 ].join("\n"),
             }];
     }
+    if (target === "claude-code") {
+        return [{
+                path: "CLAUDE.md",
+                managedBlock: true,
+                content: [
+                    "# Prompts-GPT Claude Code Instructions",
+                    "",
+                    "Prompts synced by `prompts-gpt sync` live in `.prompts-gpt/`. Start with [.prompts-gpt/manifest.json](.prompts-gpt/manifest.json), then open the prompt packs linked below before starting related work.",
+                    "",
+                    "## Available Prompt Packs",
+                    ...prompts.map(({ prompt, stem }) => `- [${prompt.title}](.prompts-gpt/${stem}.md)`),
+                    "",
+                    "When a prompt pack is relevant, load it, adapt variables to the current task, and keep verification tied to the prompt's acceptance criteria.",
+                    "",
+                ].join("\n"),
+            }];
+    }
     if (target === "cursor") {
-        return prompts.map(({ prompt, stem }) => ({
-            path: `.cursor/rules/prompts-gpt-${stem}.mdc`,
-            content: [
-                "---",
-                `description: ${yamlScalar(prompt.summary || prompt.title)}`,
-                "globs: []",
-                "alwaysApply: false",
-                "---",
-                "",
-                `# ${prompt.title}`,
-                "",
-                prompt.promptText,
-                "",
-                prompt.usageNotes ? `Usage notes: ${prompt.usageNotes}` : "",
-                "",
-            ].filter(Boolean).join("\n"),
-        }));
+        return prompts.flatMap(({ prompt, stem }) => ([
+            {
+                path: `.cursor/rules/prompts-gpt-${stem}.mdc`,
+                content: [
+                    "---",
+                    `description: ${yamlScalar(prompt.summary || prompt.title)}`,
+                    "globs: []",
+                    "alwaysApply: false",
+                    "---",
+                    "",
+                    `# ${prompt.title}`,
+                    "",
+                    prompt.promptText,
+                    "",
+                    prompt.usageNotes ? `Usage notes: ${prompt.usageNotes}` : "",
+                    "",
+                ].filter(Boolean).join("\n"),
+            },
+            {
+                path: `.cursor/commands/prompts-gpt-${stem}.md`,
+                content: formatCursorCommandMarkdown(prompt, stem),
+            },
+        ]));
     }
     if (target === "vscode") {
         return [
@@ -604,12 +694,12 @@ function buildAgentFiles(target, prompts) {
                 path: ".github/instructions/prompts-gpt.instructions.md",
                 content: [
                     "---",
-                    'applyTo: "AGENTS.md,.prompts-gpt/**/*.md,.github/copilot-instructions.md,.github/prompts/**/*.prompt.md,.cursor/rules/**/*.mdc,.vscode/prompts-gpt.code-snippets"',
+                    'applyTo: "AGENTS.md,.prompts-gpt/**/*.md,.github/copilot-instructions.md,.github/prompts/**/*.prompt.md,.cursor/rules/**/*.mdc,.cursor/commands/**/*.md,.vscode/prompts-gpt.code-snippets"',
                     "---",
                     "",
                     "# Prompts-GPT managed artifacts",
                     "",
-                    "These files are generated or refreshed by `prompts-gpt sync` and `prompts-gpt install-agents`.",
+                    "These files are generated or refreshed by `prompts-gpt sync`.",
                     "",
                     "- Treat `.prompts-gpt/manifest.json` as the source of truth for discoverable prompt packs and generated agent files.",
                     "- Prefer updating the upstream prompt pack or rerunning sync instead of manually editing generated agent artifacts.",
@@ -629,6 +719,110 @@ function buildAgentFiles(target, prompts) {
             content: formatCopilotPromptMarkdown(prompt, stem),
         }));
     }
+    if (target === "continue") {
+        return prompts.map(({ prompt, stem }) => ({
+            path: `.continue/rules/prompts-gpt-${stem}.md`,
+            content: [
+                `# ${prompt.title}`,
+                "",
+                `[Canonical prompt pack](../../.prompts-gpt/${stem}.md)`,
+                "",
+                prompt.summary ?? "",
+                "",
+                prompt.promptText ?? "",
+                "",
+                prompt.usageNotes ? `Usage notes: ${prompt.usageNotes}` : "",
+                "",
+            ].filter(Boolean).join("\n"),
+        }));
+    }
+    if (target === "gemini-cli") {
+        return [{
+                path: "GEMINI.md",
+                managedBlock: true,
+                content: [
+                    "# Prompts-GPT Gemini CLI Instructions",
+                    "",
+                    "Prompts synced by `prompts-gpt sync` live in `.prompts-gpt/`. Start with [.prompts-gpt/manifest.json](.prompts-gpt/manifest.json), then open the prompt packs linked below before starting related work.",
+                    "",
+                    "## Available Prompt Packs",
+                    ...prompts.map(({ prompt, stem }) => `- [${prompt.title}](.prompts-gpt/${stem}.md)`),
+                    "",
+                    "When a prompt pack is relevant, load it, adapt variables to the current task, and keep verification tied to the prompt's acceptance criteria.",
+                    "",
+                ].join("\n"),
+            }];
+    }
+    if (target === "windsurf") {
+        return prompts.map(({ prompt, stem }) => ({
+            path: `.windsurf/rules/prompts-gpt-${stem}.md`,
+            content: [
+                `# ${prompt.title}`,
+                "",
+                `[Canonical prompt pack](../../.prompts-gpt/${stem}.md)`,
+                "",
+                prompt.summary ?? "",
+                "",
+                prompt.promptText ?? "",
+                "",
+                "Use this as a workspace rule for Cascade or Devin Local when the prompt pack matches the task.",
+                prompt.usageNotes ? `Usage notes: ${prompt.usageNotes}` : "",
+                "",
+            ].filter(Boolean).join("\n"),
+        }));
+    }
+    if (target === "cline") {
+        return prompts.map(({ prompt, stem }) => ({
+            path: `.clinerules/prompts-gpt-${stem}.md`,
+            content: [
+                `# ${prompt.title}`,
+                "",
+                `[Canonical prompt pack](../.prompts-gpt/${stem}.md)`,
+                "",
+                prompt.summary ?? "",
+                "",
+                prompt.promptText ?? "",
+                "",
+                "Enable this rule when the current Cline task matches the linked prompt pack.",
+                prompt.usageNotes ? `Usage notes: ${prompt.usageNotes}` : "",
+                "",
+            ].filter(Boolean).join("\n"),
+        }));
+    }
+    if (target === "junie") {
+        return [{
+                path: ".junie/guidelines.md",
+                managedBlock: true,
+                content: [
+                    "# Prompts-GPT Junie Guidelines",
+                    "",
+                    "Prompts synced by `prompts-gpt sync` live in `.prompts-gpt/`. Start with [.prompts-gpt/manifest.json](.prompts-gpt/manifest.json), then open the prompt packs linked below before starting related work.",
+                    "",
+                    "## Available Prompt Packs",
+                    ...prompts.map(({ prompt, stem }) => `- [${prompt.title}](../.prompts-gpt/${stem}.md)`),
+                    "",
+                    "When a prompt pack is relevant, load it, adapt variables to the current task, and keep verification tied to the prompt's acceptance criteria.",
+                    "",
+                ].join("\n"),
+            }];
+    }
+    if (target === "amp") {
+        return [{
+                path: "AGENT.md",
+                managedBlock: true,
+                content: [
+                    "# Prompts-GPT Amp Instructions",
+                    "",
+                    "Prompts synced by `prompts-gpt sync` live in `.prompts-gpt/`. Start with [.prompts-gpt/manifest.json](.prompts-gpt/manifest.json), then open the prompt packs linked below before starting related work.",
+                    "",
+                    "## Available Prompt Packs",
+                    ...prompts.map(({ prompt, stem }) => `- [${prompt.title}](.prompts-gpt/${stem}.md)`),
+                    "",
+                    "When a prompt pack is relevant, load it, adapt variables to the current task, and keep verification tied to the prompt's acceptance criteria.",
+                    "",
+                ].join("\n"),
+            }];
+    }
     return [];
 }
 function buildVsCodeSnippets(prompts) {
@@ -689,13 +883,52 @@ function buildDiscoverablePromptFiles(stem, prompt) {
     return {
         markdown: `.prompts-gpt/${stem}.md`,
         codexInstructions: supports("codex") ? "AGENTS.md" : null,
+        claudeCodeInstructions: supports("claude-code") ? "CLAUDE.md" : null,
         cursorRule: supports("cursor") ? `.cursor/rules/prompts-gpt-${stem}.mdc` : null,
+        cursorCommand: supports("cursor") ? `.cursor/commands/prompts-gpt-${stem}.md` : null,
         vscodeInstructions: supports("vscode") ? ".github/copilot-instructions.md" : null,
         copilotPathInstructions: supports("vscode") ? ".github/instructions/prompts-gpt.instructions.md" : null,
         vscodeSnippets: supports("vscode") ? ".vscode/prompts-gpt.code-snippets" : null,
         copilotPrompt: supports("copilot") ? `.github/prompts/prompts-gpt-${stem}.prompt.md` : null,
+        continueRule: supports("continue") ? `.continue/rules/prompts-gpt-${stem}.md` : null,
+        geminiInstructions: supports("gemini-cli") ? "GEMINI.md" : null,
+        windsurfRule: supports("windsurf") ? `.windsurf/rules/prompts-gpt-${stem}.md` : null,
+        clineRule: supports("cline") ? `.clinerules/prompts-gpt-${stem}.md` : null,
+        junieGuidelines: supports("junie") ? ".junie/guidelines.md" : null,
+        ampInstructions: supports("amp") ? "AGENT.md" : null,
     };
 }
+function formatCursorCommandMarkdown(prompt, stem) {
+    const lines = [
+        `# ${prompt.title}`,
+        "",
+        `[Canonical prompt pack](../../.prompts-gpt/${stem}.md)`,
+        "",
+        prompt.summary ?? "",
+        "",
+        "## Task",
+        "",
+        prompt.promptText ?? "",
+    ];
+    if (prompt.variables?.length) {
+        lines.push("", "## Inputs", "");
+        for (const variable of prompt.variables) {
+            lines.push(`- ${String(variable).replace(/[{}$]/g, "")}`);
+        }
+    }
+    if (prompt.usageNotes) {
+        lines.push("", "## Usage Notes", "", prompt.usageNotes);
+    }
+    lines.push("", "Verify the output against `.prompts-gpt/manifest.json` and the linked canonical prompt pack.", "");
+    return lines
+        .reduce((acc, line, index, list) => {
+        if (line === "" && index > 0 && list[index - 1] === "" && (index < 2 || list[index - 2] === ""))
+            return acc;
+        acc.push(line);
+        return acc;
+    }, [])
+        .join("\n");
+}
 function formatCopilotPromptMarkdown(prompt, stem) {
     const sections = [
         "---",
@@ -755,8 +988,9 @@ function escapeMarkdownLinkText(value) {
     return value.replace(/[[\]]/g, "\\$&");
 }
 async function writePromptIndex(prompts, { outDir }) {
-    const indexPath = path.join(outDir, "README.md");
-    const content = [
+    const indexPath = path.resolve(outDir, "README.md");
+    assertInside(indexPath, path.resolve(outDir));
+    const managedContent = [
         "# Prompts-GPT Prompt Packs",
         "",
         "These prompts were synced by `prompts-gpt`. Re-run `prompts-gpt sync` to refresh Markdown and agent files.",
@@ -770,8 +1004,12 @@ async function writePromptIndex(prompts, { outDir }) {
         }),
         "",
     ].join("\n");
-    assertInside(indexPath, outDir);
-    await writeFile(indexPath, content);
+    let existing = "";
+    try {
+        existing = await readFile(indexPath, "utf8");
+    }
+    catch { }
+    await writeFile(indexPath, upsertManagedBlock(existing, managedContent));
 }
 function normalizeAgentTargets(value) {
     const raw = Array.isArray(value) ? value.join(",") : String(value ?? "all");
@@ -834,8 +1072,8 @@ function assertInside(filePath, directory) {
     }
 }
 function safeSlug(value) {
-    const raw = String(value ?? "");
-    if (!raw.trim())
+    const raw = String(value ?? "").trim();
+    if (!raw)
         return "prompt";
     const slug = raw
         .toLowerCase()
@@ -844,7 +1082,9 @@ function safeSlug(value) {
         .replace(/[^a-z0-9]+/g, "-")
         .replace(/^-+|-+$/g, "")
         .slice(0, 90);
-    return slug || "prompt";
+    if (!slug || slug === "-")
+        return "prompt";
+    return slug;
 }
 function yamlScalar(value) {
     const s = String(value ?? "");
@@ -853,15 +1093,4 @@ function yamlScalar(value) {
     }
     return JSON.stringify(s);
 }
-async function ensureGitignoreEntry(cwd, entry) {
-    const gitignorePath = path.resolve(cwd, ".gitignore");
-    const existing = existsSync(gitignorePath) ? await readFile(gitignorePath, "utf8") : "";
-    const eol = existing.includes("\r\n") ? "\r\n" : "\n";
-    const lines = existing.split(/\r?\n/).map((line) => line.trim());
-    if (lines.includes(entry))
-        return;
-    const needsLeadingNewline = existing.length > 0 && !existing.endsWith("\n") && !existing.endsWith("\r\n");
-    const prefix = needsLeadingNewline ? eol : "";
-    await writeFile(gitignorePath, `${existing}${prefix}${entry}${eol}`);
-}
 //# sourceMappingURL=index.js.map