@tenderprompt/cli 0.1.16 → 0.1.17

package/dist/index.js

@@ -11,7 +11,7 @@ const CLI_PACKAGE_NAME = "@tenderprompt/cli";
 const UNKNOWN_CLI_VERSION = "0.0.0";
 const RECOMMENDED_TENDER_PROMPT_SKILL = {
     name: "tender-prompt",
-    version: "0.1.2",
+    version: "0.1.4",
     source: "git@github.com:tenderprompt/skills.git",
     path: "skills/tender-prompt/SKILL.md",
     updateHint: "Refresh the tender-prompt skill from git@github.com:tenderprompt/skills.git when the local skill version is older.",
@@ -82,6 +82,10 @@ Commands:
   tender auth login --device
                              Authorize this machine with a browser-approved device flow
   tender auth status         Show whether a Tender API token is available
+  tender playbooks list      List remote Tender Prompt playbook metadata
+  tender playbooks get <id>  Fetch one remote playbook body on demand
+  tender playbooks file <id> --path <path>
+                             Fetch one playbook reference file on demand
   tender app list            List Tender App records visible to the current token
   tender app create --name <name>
                              Create a new Tender App in the current account
@@ -134,6 +138,9 @@ Examples:
   tender capabilities --json
   tender auth login --device --profile edit-preview --artifact artifact_123 --ttl 7d
   tender auth status --json
+  tender playbooks list --json
+  tender playbooks get recharge-bundle-builder --json
+  tender playbooks file recharge-bundle-builder --path references/recharge-payloads.md --json
   tender app list --json
   tender app create --name "Exit Intent Widget" --json
   tender app create --name "Exit Intent Widget" --init --dir ./widget --preview --json
@@ -203,6 +210,49 @@ Examples:
   tender auth status
   tender auth status --profile publish --json`;
 }
+function playbooksHelp() {
+    return `Usage: tender playbooks <command> [options]
+
+Commands:
+  tender playbooks list
+                             List remote playbook metadata only
+  tender playbooks get <playbook-id>
+                             Fetch one playbook body and reference index
+  tender playbooks file <playbook-id> --path <path>
+                             Fetch one playbook reference file
+
+Examples:
+  tender playbooks list --json
+  tender playbooks get recharge-bundle-builder --json
+  tender playbooks file recharge-bundle-builder --path references/recharge-payloads.md --json`;
+}
+function playbooksListHelp() {
+    return `Usage: tender playbooks list [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+
+Lists compact metadata for all remote Tender Prompt playbooks. This command
+does not write playbooks to disk.
+
+Examples:
+  tender playbooks list --json`;
+}
+function playbooksGetHelp() {
+    return `Usage: tender playbooks get <playbook-id> [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+
+Fetches one remote playbook body plus a reference-file index. This command
+prints session-only context and does not write to the checkout.
+
+Examples:
+  tender playbooks get recharge-bundle-builder --json`;
+}
+function playbooksFileHelp() {
+    return `Usage: tender playbooks file <playbook-id> --path <references/file.md> [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+
+Fetches one playbook reference file. Paths are limited to references/*.md.
+This command does not write playbooks to disk.
+
+Examples:
+  tender playbooks file recharge-bundle-builder --path references/recharge-payloads.md --json`;
+}
 function appHelp() {
     return `Usage: tender app <command> [options]
 
@@ -916,6 +966,14 @@ function tenderCliCapabilities() {
             latestRunner: "npm exec --yes @tenderprompt/cli@latest --",
         },
         recommendedSkill: RECOMMENDED_TENDER_PROMPT_SKILL,
+        playbooks: {
+            mode: "remote_progressive_disclosure",
+            metadataCommand: "tender playbooks list --json",
+            entryCommand: "tender playbooks get <playbook-id> --json",
+            fileCommand: "tender playbooks file <playbook-id> --path <path> --json",
+            persistence: "session_only",
+            writesToCheckout: false,
+        },
         description: "Agent-safe Tender App source, lifecycle, analytics, and local scaffold controls.",
         discovery: {
             primary: "npm exec --yes @tenderprompt/cli@latest -- capabilities --json",
@@ -923,6 +981,7 @@ function tenderCliCapabilities() {
                 "tender --version",
                 "tender --help",
                 "tender auth --help",
+                "tender playbooks --help",
                 "tender app --help",
                 "tender app agent heartbeat --help",
                 "tender app analytics --help",
@@ -939,6 +998,20 @@ function tenderCliCapabilities() {
                     "tender auth login --device --profile edit-preview --artifact <artifact-id> --ttl 7d --json",
                 ],
             },
+            {
+                name: "playbook_discovery",
+                when: "Before planning non-trivial Tender App or widget work.",
+                commands: [
+                    "tender playbooks list --json",
+                    "tender playbooks get <playbook-id> --json",
+                    "tender playbooks file <playbook-id> --path references/<file>.md --json",
+                ],
+                notes: [
+                    "List returns metadata only; use it to decide whether a playbook is relevant.",
+                    "Fetch full playbooks and reference files only on demand.",
+                    "Do not write fetched playbook contents into the checkout or install them as skills.",
+                ],
+            },
             {
                 name: "create_new_app_with_preview",
                 when: "When the user wants a new Tender App that is immediately visible.",
@@ -1057,6 +1130,24 @@ function tenderCliCapabilities() {
                 requiresAuth: false,
                 writes: false,
             },
+            {
+                command: "tender playbooks list --json",
+                purpose: "List remote Tender Prompt playbook metadata without fetching full bodies.",
+                requiresAuth: true,
+                writes: false,
+            },
+            {
+                command: "tender playbooks get <playbook-id> --json",
+                purpose: "Fetch one remote playbook body plus its reference index.",
+                requiresAuth: true,
+                writes: false,
+            },
+            {
+                command: "tender playbooks file <playbook-id> --path references/<file>.md --json",
+                purpose: "Fetch one playbook reference file on demand.",
+                requiresAuth: true,
+                writes: false,
+            },
             {
                 command: "tender app create --name <name> --init --dir <dir> --preview --json",
                 purpose: "Create a new Tender App, initialize API-derived source in a local checkout, push it, and request a preview build.",
@@ -2742,6 +2833,114 @@ function parseAuthStatusArgs(args) {
         json,
     };
 }
+function parsePlaybooksCommonArgs(args, startIndex) {
+    let baseUrl = null;
+    let flagToken = null;
+    let profileName = null;
+    let json = false;
+    const extras = [];
+    for (let index = startIndex; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
+        if (arg === "--base-url") {
+            baseUrl = parseBaseUrlFlag(args, index);
+            index += 1;
+            continue;
+        }
+        if (arg === "--token") {
+            flagToken = parseTokenFlag(args, index);
+            index += 1;
+            continue;
+        }
+        if (arg === "--profile") {
+            profileName = parseProfileName(args[index + 1], "--profile");
+            index += 1;
+            continue;
+        }
+        extras.push(arg);
+    }
+    return { baseUrl, flagToken, profileName, json, extras };
+}
+function parsePlaybooksListArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "playbooks list" };
+    }
+    const parsed = parsePlaybooksCommonArgs(args, 0);
+    if (parsed.extras.length > 0) {
+        throw new TenderCliUsageError(`Unknown playbooks list option: ${parsed.extras[0]}`);
+    }
+    return {
+        command: "playbooks list",
+        baseUrl: parsed.baseUrl,
+        flagToken: parsed.flagToken,
+        profileName: parsed.profileName,
+        json: parsed.json,
+    };
+}
+function parsePlaybooksGetArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "playbooks get" };
+    }
+    const playbookId = args[0];
+    if (!playbookId || playbookId.startsWith("-")) {
+        throw new TenderCliUsageError("playbook id is required. Example: tender playbooks get recharge-bundle-builder --json");
+    }
+    const parsed = parsePlaybooksCommonArgs(args, 1);
+    if (parsed.extras.length > 0) {
+        throw new TenderCliUsageError(`Unknown playbooks get option: ${parsed.extras[0]}`);
+    }
+    return {
+        command: "playbooks get",
+        playbookId,
+        baseUrl: parsed.baseUrl,
+        flagToken: parsed.flagToken,
+        profileName: parsed.profileName,
+        json: parsed.json,
+    };
+}
+function parsePlaybooksFileArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "playbooks file" };
+    }
+    const playbookId = args[0];
+    if (!playbookId || playbookId.startsWith("-")) {
+        throw new TenderCliUsageError("playbook id is required. Example: tender playbooks file recharge-bundle-builder --path references/recharge-payloads.md --json");
+    }
+    let filePath = null;
+    const rest = [];
+    for (let index = 1; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--path") {
+            const value = args[index + 1];
+            if (!value || value.startsWith("-")) {
+                throw new TenderCliUsageError("--path requires a playbook reference path.");
+            }
+            filePath = value;
+            index += 1;
+            continue;
+        }
+        rest.push(arg);
+    }
+    const parsed = parsePlaybooksCommonArgs(rest, 0);
+    if (parsed.extras.length > 0) {
+        throw new TenderCliUsageError(`Unknown playbooks file option: ${parsed.extras[0]}`);
+    }
+    if (!filePath) {
+        throw new TenderCliUsageError("--path is required. Example: tender playbooks file recharge-bundle-builder --path references/recharge-payloads.md --json");
+    }
+    return {
+        command: "playbooks file",
+        playbookId,
+        filePath,
+        baseUrl: parsed.baseUrl,
+        flagToken: parsed.flagToken,
+        profileName: parsed.profileName,
+        json: parsed.json,
+    };
+}
 function parseGenerateEnvTypesArgs(args) {
     if (args.includes("--help") || args.includes("-h")) {
         return { command: "help", topic: "app generate-env-types" };
@@ -4193,6 +4392,21 @@ function parseTenderArgs(args) {
         }
         throw new TenderCliUsageError(`Unknown auth command: ${args[1]}`);
     }
+    if (args[0] === "playbooks") {
+        if (args[1] === undefined || args[1] === "--help" || args[1] === "-h") {
+            return { command: "help", topic: "playbooks" };
+        }
+        if (args[1] === "list") {
+            return parsePlaybooksListArgs(args.slice(2));
+        }
+        if (args[1] === "get") {
+            return parsePlaybooksGetArgs(args.slice(2));
+        }
+        if (args[1] === "file") {
+            return parsePlaybooksFileArgs(args.slice(2));
+        }
+        throw new TenderCliUsageError(`Unknown playbooks command: ${args[1]}`);
+    }
     if (args[0] === "apps") {
         throw new TenderCliUsageError("Unknown command: apps. Use `tender app ...` for Tender App workflows.");
     }
@@ -4808,6 +5022,40 @@ async function requestDbApi(input) {
     }
     return payload;
 }
+function encodePathSegments(filePath) {
+    return filePath.split("/").map(encodeURIComponent).join("/");
+}
+async function requestPlaybooksApi(input) {
+    const suffix = input.playbooksPath === "list"
+        ? ""
+        : input.playbooksPath === "get"
+            ? `/${encodeURIComponent(input.playbookId)}`
+            : `/${encodeURIComponent(input.playbookId)}/files/${encodePathSegments(input.filePath)}`;
+    const response = await input.fetcher(`${input.baseUrl}/api/v1/playbooks${suffix}`, {
+        method: "GET",
+        headers: {
+            authorization: `Bearer ${input.token}`,
+            accept: "application/json",
+        },
+    });
+    const payload = await parseJsonResponse(response);
+    if (!response.ok || !payload) {
+        const reasonCode = (typeof payload?.reasonCode === "string" && payload.reasonCode) ||
+            `http_${response.status}`;
+        const message = (typeof payload?.message === "string" && payload.message) ||
+            (typeof payload?.reasonCode === "string" && payload.reasonCode) ||
+            `Playbooks request failed with HTTP ${response.status}.`;
+        const authHint = response.status === 401
+            ? "\nAuthenticate first: tender auth login --device --profile edit-preview --save-profile agent --ttl 7d --json"
+            : "";
+        throw new Error([
+            message,
+            `Reason: ${reasonCode}.`,
+            "Example: tender playbooks list --profile agent --json.",
+        ].join("\n") + authHint);
+    }
+    return payload;
+}
 function dbCorrectedExample(artifactId, dbPath) {
     if (dbPath === "capabilities") {
         return `tender app db capabilities ${artifactId} --json`;
@@ -7389,6 +7637,25 @@ async function resolveAnalyticsCredentials(command, runtime) {
         env: runtime.env ?? process.env,
     });
 }
+async function resolvePlaybooksCredentials(command, runtime) {
+    try {
+        return await resolveApiCredentials({
+            baseUrl: command.baseUrl,
+            flagToken: command.flagToken,
+            profileName: command.profileName,
+            env: runtime.env ?? process.env,
+        });
+    }
+    catch (error) {
+        if (error instanceof TenderCliUsageError) {
+            throw new TenderCliUsageError([
+                "Playbooks require Tender authentication.",
+                "Run `tender auth login --device --profile edit-preview --save-profile agent --ttl 7d --json`, set TENDER_API_TOKEN, or pass --token <token>.",
+            ].join("\n"));
+        }
+        throw error;
+    }
+}
 async function resolveDbCredentials(command, runtime) {
     return await resolveApiCredentials({
         baseUrl: command.baseUrl,
@@ -7426,6 +7693,58 @@ function printDbPayload(command, io, payload, fallbackLines) {
         io.stdout(fallbackLines.join("\n"));
     }
 }
+function printPlaybooksPayload(command, io, payload, fallback) {
+    if (command.json) {
+        io.stdout(JSON.stringify(payload, null, 2));
+    }
+    else {
+        io.stdout(fallback);
+    }
+}
+async function runPlaybooksList(command, io, runtime) {
+    const credentials = await resolvePlaybooksCredentials(command, runtime);
+    const payload = await requestPlaybooksApi({
+        playbooksPath: "list",
+        baseUrl: credentials.baseUrl,
+        token: credentials.token,
+        fetcher: runtime.fetcher ?? fetch,
+    });
+    const playbooks = Array.isArray(payload.playbooks) ? payload.playbooks : [];
+    printPlaybooksPayload(command, io, payload, playbooks
+        .map((playbook) => isCliJsonRecord(playbook)
+        ? `${String(playbook.id ?? "")}\t${String(playbook.description ?? "")}`
+        : "")
+        .filter(Boolean)
+        .join("\n") || "No Tender Prompt playbooks found.");
+    return 0;
+}
+async function runPlaybooksGet(command, io, runtime) {
+    const credentials = await resolvePlaybooksCredentials(command, runtime);
+    const payload = await requestPlaybooksApi({
+        playbooksPath: "get",
+        playbookId: command.playbookId,
+        baseUrl: credentials.baseUrl,
+        token: credentials.token,
+        fetcher: runtime.fetcher ?? fetch,
+    });
+    printPlaybooksPayload(command, io, payload, typeof payload.body === "string" ? payload.body : JSON.stringify(payload, null, 2));
+    return 0;
+}
+async function runPlaybooksFile(command, io, runtime) {
+    const credentials = await resolvePlaybooksCredentials(command, runtime);
+    const payload = await requestPlaybooksApi({
+        playbooksPath: "file",
+        playbookId: command.playbookId,
+        filePath: command.filePath,
+        baseUrl: credentials.baseUrl,
+        token: credentials.token,
+        fetcher: runtime.fetcher ?? fetch,
+    });
+    printPlaybooksPayload(command, io, payload, typeof payload.content === "string"
+        ? payload.content
+        : JSON.stringify(payload, null, 2));
+    return 0;
+}
 async function runDbCapabilities(command, io, runtime) {
     const credentials = await resolveDbCredentials(command, runtime);
     const payload = await requestDbApi({
@@ -8042,6 +8361,18 @@ export async function runTenderCli(args, io = {
             else if (command.topic === "auth status") {
                 io.stdout(authStatusHelp());
             }
+            else if (command.topic === "playbooks") {
+                io.stdout(playbooksHelp());
+            }
+            else if (command.topic === "playbooks list") {
+                io.stdout(playbooksListHelp());
+            }
+            else if (command.topic === "playbooks get") {
+                io.stdout(playbooksGetHelp());
+            }
+            else if (command.topic === "playbooks file") {
+                io.stdout(playbooksFileHelp());
+            }
             else if (command.topic === "auth") {
                 io.stdout(authHelp());
             }
@@ -8194,6 +8525,15 @@ export async function runTenderCli(args, io = {
         if (command.command === "auth status") {
             return await runAuthStatus(command, io, runtime);
         }
+        if (command.command === "playbooks list") {
+            return await runPlaybooksList(command, io, runtime);
+        }
+        if (command.command === "playbooks get") {
+            return await runPlaybooksGet(command, io, runtime);
+        }
+        if (command.command === "playbooks file") {
+            return await runPlaybooksFile(command, io, runtime);
+        }
         if (command.command === "app list") {
             return await runArtifactsList(command, io, runtime);
         }
@@ -8318,8 +8658,10 @@ export async function runTenderCli(args, io = {
     }
     catch (error) {
         if (args.includes("--json") &&
-            args[0] === "app" &&
-            (args[1] === "db" || (args[1] === "agent" && args[2] === "heartbeat"))) {
+            ((args[0] === "app" &&
+                (args[1] === "db" ||
+                    (args[1] === "agent" && args[2] === "heartbeat"))) ||
+                args[0] === "playbooks")) {
             io.stdout(JSON.stringify(cliErrorPayload(error, args, command), null, 2));
             return error instanceof TenderCliUsageError ? 2 : 1;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tenderprompt/cli",
-	"version": "0.1.16",
+	"version": "0.1.17",
 	"type": "module",
 	"bin": {
 		"tender": "bin/tender.js"