@pippit-dev/cli 0.0.12 → 0.0.13

package/README.md

@@ -1,4 +1,4 @@
-# pippit-cli
+# pippit-tool-cli
 
 Minimal demo CLI for Pippit workflows.
 
@@ -10,11 +10,11 @@ matching prebuilt binary for macOS, Linux, or Windows:
 ```bash
 npx @pippit-dev/cli@latest install
 export XYQ_ACCESS_KEY="<access-key>"
-pippit-cli --version
-pippit-cli short-drama +submit-run --message "写一个赛博朋克短剧开头"
-pippit-cli short-drama +upload-file --path ./reference.doc
-pippit-cli short-drama +get-thread --thread-id thread_123 --run-id run_456 --after-seq 0
-pippit-cli short-drama +download-result --output-path ./thread_123/results/result.mp4 --url URL
+pippit-tool-cli --version
+pippit-tool-cli short-drama +submit-run --message "写一个赛博朋克短剧开头"
+pippit-tool-cli short-drama +upload-file --path ./reference.doc
+pippit-tool-cli short-drama +get-thread --thread-id thread_123 --run-id run_456 --after-seq 0
+pippit-tool-cli short-drama +download-result --output-path ./thread_123/results/result.mp4 --url URL
 ```
 
 NPM package names must be lowercase, so the publishable package name is

package/checksums.txt

@@ -1,6 +1,6 @@
-5062d1d4950aa9e0d8b1770e62476d9bb2076f4492cd24a541ad93b05a254f49  pippit-cli-0.0.12-darwin-amd64.tar.gz
-5a0c8d044ebcb717d18954147433ac5f54f2dc89285e2e50f6be6755431ee99c  pippit-cli-0.0.12-darwin-arm64.tar.gz
-456420a71cd9909e152907faa96f35abb93e62079786021d1bee28cfac61e8ff  pippit-cli-0.0.12-linux-amd64.tar.gz
-1c6681fa8f8edaa19dac835dd9bdf4bc17c06936700316f7d74b68d55d572460  pippit-cli-0.0.12-linux-arm64.tar.gz
-e7c156bb35fb373fa89d05c729252b20951a41c70f3bbd4e8794e4c5abe65e06  pippit-cli-0.0.12-windows-amd64.zip
-2832786f9c13069f3580407e24037e95cc9452534e9996366dc6751f841fcd26  pippit-cli-0.0.12-windows-arm64.zip
+c02c37229ea76195c04881880a9d5a913ab95846958ab4e4ab41bc2b82649e49  pippit-tool-cli-0.0.13-darwin-amd64.tar.gz
+4937231063eeaad1e494be4f2b6218860313abbf529d868568d9d6e48bf62e3e  pippit-tool-cli-0.0.13-darwin-arm64.tar.gz
+da2bb0c5472bdd02a2cc861a17564254abb86fa5c63c44b58c7fbb64211550f1  pippit-tool-cli-0.0.13-linux-amd64.tar.gz
+476e0907a6983f9360324732411edcd9c2c80f9d903a7974949ef2d09b1f35ba  pippit-tool-cli-0.0.13-linux-arm64.tar.gz
+cfe8e5b92b8b6abbf5ed3abc9ce31c1371efcc34698edfa5ee2d8d675d4f7886  pippit-tool-cli-0.0.13-windows-amd64.zip
+edff7af4414b2b080338f96eab5ce9cca2a14d4bd8fc3099a1af7a2dc43109d2  pippit-tool-cli-0.0.13-windows-arm64.zip

package/cmd/root.go

@@ -13,7 +13,7 @@ import (
 	"github.com/spf13/cobra"
 )
 
-// Execute runs the pippit-cli command tree.
+// Execute runs the pippit-tool-cli command tree.
 func Execute() error {
 	return NewRootCommand(os.Stdout, os.Stderr).Execute()
 }
@@ -27,7 +27,7 @@ func NewRootCommand(stdout, stderr io.Writer) *cobra.Command {
 
 func newRootCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command {
 	root := &cobra.Command{
-		Use:           "pippit-cli",
+		Use:           "pippit-tool-cli",
 		Short:         "Pippit CLI",
 		Long:          "Pippit CLI submits short-drama workflows, downloads generated assets, and updates the installed CLI package.",
 		Version:       version.Current(),

package/cmd/update/update.go

@@ -18,7 +18,7 @@ const defaultPackage = "@pippit-dev/cli"
 func NewCommand(stdout, stderr io.Writer) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "update",
-		Short: "Update pippit-cli and bundled skills",
+		Short: "Update pippit-tool-cli and bundled skills",
 		RunE: func(cmd *cobra.Command, _ []string) error {
 			return runUpdate(stdout, stderr)
 		},
@@ -32,14 +32,14 @@ func runUpdate(stdout, stderr io.Writer) error {
 		pkg = defaultPackage + "@latest"
 	}
 
-	fmt.Fprintf(stderr, "Updating pippit-cli via npm: %s\n", pkg)
+	fmt.Fprintf(stderr, "Updating pippit-tool-cli via npm: %s\n", pkg)
 	restore, err := prepareSelfReplace()
 	if err != nil {
 		return fmt.Errorf("prepare self replace: %w", err)
 	}
 	if err := runInheritEnv(stderr, []string{"PIPPIT_CLI_SKIP_SKILLS=1"}, "npm", "install", "-g", pkg); err != nil {
 		restore()
-		return fmt.Errorf("update pippit-cli: %w", err)
+		return fmt.Errorf("update pippit-tool-cli: %w", err)
 	}
 
 	root, err := globalPackageRoot(defaultPackage)
@@ -47,12 +47,12 @@ func runUpdate(stdout, stderr io.Writer) error {
 		return fmt.Errorf("locate global package: %w", err)
 	}
 
-	fmt.Fprintln(stderr, "Updating pippit-cli skills...")
+	fmt.Fprintln(stderr, "Updating pippit-tool-cli skills...")
 	if err := installSkills(root, stderr); err != nil {
-		return fmt.Errorf("update pippit-cli skills: %w", err)
+		return fmt.Errorf("update pippit-tool-cli skills: %w", err)
 	}
 
-	fmt.Fprintln(stdout, "pippit-cli and skills updated")
+	fmt.Fprintln(stdout, "pippit-tool-cli and skills updated")
 	return nil
 }
 
@@ -107,7 +107,7 @@ func prepareSelfReplace() (func(), error) {
 	if err != nil {
 		return nil, err
 	}
-	if filepath.Base(exe) != "pippit-cli.exe" || !strings.Contains(exe, "node_modules") {
+	if filepath.Base(exe) != "pippit-tool-cli.exe" || !strings.Contains(exe, "node_modules") {
 		return func() {}, nil
 	}
 	old := exe + ".old"

package/internal/common/download_results.go

@@ -31,7 +31,7 @@ type DownloadResultError struct {
 	Error string `json:"error"`
 }
 
-// DownloadResultResponse is the JSON envelope printed by `pippit-cli short-drama +download-result`.
+// DownloadResultResponse is the JSON envelope printed by `pippit-tool-cli short-drama +download-result`.
 type DownloadResultResponse struct {
 	OutputPath   string                 `json:"output_path"`
 	Downloaded   []string               `json:"downloaded"`

package/internal/common/list_thread_file.go

@@ -24,7 +24,7 @@ type ThreadFile struct {
 	DownloadURL string `json:"download_url"`
 }
 
-// ListThreadFileResult is the JSON envelope printed by `pippit-cli short-drama +list-thread-file`.
+// ListThreadFileResult is the JSON envelope printed by `pippit-tool-cli short-drama +list-thread-file`.
 type ListThreadFileResult struct {
 	Files   []*ThreadFile `json:"files"`
 	Total   int64         `json:"total"`

package/internal/common/upload_file.go

@@ -17,7 +17,7 @@ type UploadFileOptions struct {
 	FileName string `json:"file_name"`
 }
 
-// UploadFileResult is the JSON envelope printed by `pippit-cli short-drama +upload-file`.
+// UploadFileResult is the JSON envelope printed by `pippit-tool-cli short-drama +upload-file`.
 type UploadFileResult struct {
 	AssetID string `json:"asset_id"`
 }

package/internal/short_drama/get_thread.go

@@ -22,7 +22,7 @@ type ThreadEntry struct {
 	Content []any  `json:"content"`
 }
 
-// GetThreadResult is the JSON envelope printed by `pippit-cli short-drama +get-thread`.
+// GetThreadResult is the JSON envelope printed by `pippit-tool-cli short-drama +get-thread`.
 type GetThreadResult struct {
 	Messages []*ThreadEntry `json:"messages"`
 }

package/internal/short_drama/submit_run.go

@@ -15,7 +15,7 @@ type SubmitRunOptions struct {
 	AssetIDs []string `json:"asset_ids,omitempty"`
 }
 
-// SubmitRunResult is the JSON envelope printed by `pippit-cli short-drama +submit-run`.
+// SubmitRunResult is the JSON envelope printed by `pippit-tool-cli short-drama +submit-run`.
 type SubmitRunResult struct {
 	ThreadID      string `json:"thread_id"`
 	RunID         string `json:"run_id"`

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@pippit-dev/cli",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "Pippit CLI",
   "bin": {
-    "pippit-cli": "scripts/run.js"
+    "pippit-tool-cli": "scripts/run.js"
   },
   "scripts": {
     "postinstall": "node scripts/install.js",

package/scripts/install-wizard.js

@@ -17,12 +17,12 @@ function getGloballyInstalledVersion() {
   }
 }
 
-function whichPippitCli() {
+function whichPippitToolCli() {
   try {
     const prefix = runSilent("npm", ["prefix", "-g"], { timeout: 15000 }).toString().trim();
     const bin = isWindows
-      ? path.join(prefix, "pippit-cli.cmd")
-      : path.join(prefix, "bin", "pippit-cli");
+      ? path.join(prefix, "pippit-tool-cli.cmd")
+      : path.join(prefix, "bin", "pippit-tool-cli");
     if (fs.existsSync(bin)) return bin;
   } catch (_) {
     // Fall back to PATH lookup.
@@ -30,7 +30,7 @@ function whichPippitCli() {
 
   try {
     const cmd = isWindows ? "where" : "which";
-    return runSilent(cmd, ["pippit-cli"]).toString().split("\n")[0].trim();
+    return runSilent(cmd, ["pippit-tool-cli"]).toString().split("\n")[0].trim();
   } catch (_) {
     return null;
   }
@@ -39,7 +39,7 @@ function whichPippitCli() {
 function main() {
   const installed = getGloballyInstalledVersion();
   if (installed) {
-    console.log(`Updating global pippit-cli (${installed}) via ${PKG}...`);
+    console.log(`Updating global pippit-tool-cli (${installed}) via ${PKG}...`);
   } else {
     console.log(`Installing ${PKG} globally...`);
   }
@@ -48,7 +48,7 @@ function main() {
     env: { ...process.env, PIPPIT_CLI_SKIP_SKILLS: "1" },
   });
 
-  console.log("Installing pippit-cli skills...");
+  console.log("Installing pippit-tool-cli skills...");
   try {
     installGlobalPackageSkills(DEFAULT_PKG);
   } catch (err) {
@@ -60,15 +60,15 @@ function main() {
     installGlobalPackageSkills(DEFAULT_PKG);
   }
 
-  const bin = whichPippitCli();
+  const bin = whichPippitToolCli();
   if (!bin) {
-    console.error("pippit-cli was installed, but no global command was found in npm prefix.");
+    console.error("pippit-tool-cli was installed, but no global command was found in npm prefix.");
     console.error("Check that npm's global bin directory is in PATH.");
     process.exit(1);
   }
 
-  console.log(`pippit-cli is ready: ${bin}`);
-  console.log("Try: pippit-cli short-drama +submit-run --message \"写一个短剧开头\"");
+  console.log(`pippit-tool-cli is ready: ${bin}`);
+  console.log("Try: pippit-tool-cli short-drama +submit-run --message \"写一个短剧开头\"");
 }
 
 main();

package/scripts/install.js

@@ -9,7 +9,7 @@ const { installSkillsFromRoot } = require("./skills");
 
 const VERSION = require("../package.json").version.replace(/-.*$/, "");
 const REPO = "Pippit-dev/cli";
-const NAME = "pippit-cli";
+const NAME = "pippit-tool-cli";
 const ROOT = path.join(__dirname, "..");
 const BIN_DIR = path.join(ROOT, "bin");
 
@@ -121,7 +121,7 @@ function install() {
 
   fs.mkdirSync(BIN_DIR, { recursive: true });
 
-  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "pippit-cli-"));
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "pippit-tool-cli-"));
   const archivePath = path.join(tmpDir, archiveName);
   try {
     download(releaseURL, archivePath);

package/scripts/run.js

@@ -6,7 +6,7 @@ const path = require("path");
 const { maybeWarnNewVersion } = require("./version-check");
 
 const ext = process.platform === "win32" ? ".exe" : "";
-const bin = path.join(__dirname, "..", "bin", "pippit-cli" + ext);
+const bin = path.join(__dirname, "..", "bin", "pippit-tool-cli" + ext);
 const args = process.argv.slice(2);
 
 const oldBin = bin + ".old";
@@ -50,7 +50,7 @@ if (args[0] === "install") {
       });
     } catch (_) {
       console.error(
-        "\nFailed to prepare pippit-cli binary.\n" +
+        "\nFailed to prepare pippit-tool-cli binary.\n" +
         "Make sure Go is installed and available in PATH, then retry.\n"
       );
       process.exit(1);

package/scripts/version-check.js

@@ -85,7 +85,7 @@ function maybeWarnNewVersion(args = [], opts = {}) {
   if (compareSemver(latest, current) <= 0) return;
 
   const warn = opts.warn || console.error;
-  warn(`[pippit-cli] New version available: ${current} -> ${latest}. Run: pippit-cli update`);
+  warn(`[pippit-tool-cli] New version available: ${current} -> ${latest}. Run: pippit-tool-cli update`);
 }
 
 module.exports = {

package/skills/short-drama/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pippit-short-drama-skill
-description: 使用 pippit-cli 的短剧场景能力提交和查询短剧创作任务。覆盖短剧生成、续写、改写、剧情扩展、人物设定、分集草稿、世界观设定、会话文件获取、文件资源下载等创作场景。当用户要求创作短剧、写短剧剧本、续写故事、修改剧情、补充角色设定、查询短剧任务进展、获取短剧会话文件或下载短剧文件资源，或提到 pippit-cli short-drama / 小云雀短剧时触发。
+description: 使用 pippit-tool-cli 的短剧场景能力提交和查询短剧创作任务。覆盖短剧生成、续写、改写、剧情扩展、人物设定、分集草稿、世界观设定、会话文件获取、文件资源下载等创作场景。当用户要求创作短剧、写短剧剧本、续写故事、修改剧情、补充角色设定、查询短剧任务进展、获取短剧会话文件或下载短剧文件资源，或提到 pippit-tool-cli short-drama / 小云雀短剧时触发。
 user-invocable: true
 metadata:
   {
@@ -9,7 +9,7 @@ metadata:
         "emoji": "📖",
         "requires":
           {
-            "bins": ["pippit-cli"]
+            "bins": ["pippit-tool-cli"]
           }
       }
   }
@@ -17,7 +17,7 @@ metadata:
 
 # 小云雀短剧创作
 
-通过 `pippit-cli short-drama` 命令提交短剧创作任务、上传参考文件，并行查询任务进展和会话产物文件，及时把重要资产下载到用户本地。
+通过 `pippit-tool-cli short-drama` 命令提交短剧创作任务、上传参考文件，并行查询任务进展和会话产物文件，及时把重要资产下载到用户本地。
 
 短剧场景面向剧情、人物、分集与画面化叙事创作，用户的原始需求通过 `--message` 发送给后端 Agent。后端 Agent 负责理解任务、编排流程和生成内容；用户侧 Agent 负责提交任务、并行查询进展与产物、主动下载重要资产并展示结果。
 
@@ -33,7 +33,7 @@ metadata:
 
 ## 前置要求
 
-需要已安装 `pippit-cli`：
+需要已安装 `pippit-tool-cli`：
 
 ```bash
 npx @pippit-dev/cli@latest install
@@ -45,20 +45,20 @@ npx @pippit-dev/cli@latest install
 
 ```bash
 # 创建新会话并提交短剧创作需求
-pippit-cli short-drama +submit-run --message "创作一个赛博朋克短剧开头"
+pippit-tool-cli short-drama +submit-run --message "创作一个赛博朋克短剧开头"
 
 # 向已有会话追加新的短剧需求
-pippit-cli short-drama +submit-run --message "继续写下一集，重点描写主角的逃亡" --thread-id THREAD_ID
+pippit-tool-cli short-drama +submit-run --message "继续写下一集，重点描写主角的逃亡" --thread-id THREAD_ID
 
 # 携带已上传文件 ID 提交任务
-pippit-cli short-drama +submit-run --message "参考这个大纲写第一集" --asset-ids ASSET_ID
+pippit-tool-cli short-drama +submit-run --message "参考这个大纲写第一集" --asset-ids ASSET_ID
 ```
 
 ### 2. 查询短剧任务进展
 
 ```bash
 # 查询会话消息列表
-pippit-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID --after-seq 0
+pippit-tool-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID --after-seq 0
 ```
 
 > `thread_id` 和 `run_id` 由 `+submit-run` 返回。`after-seq` 用于增量拉取消息，首次查询可使用 `0`。
@@ -68,14 +68,14 @@ pippit-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID --after
 当用户提供短剧大纲、人物设定、世界观设定、已有分集或剧本等本地文件路径时，可先上传文件。
 
 ```bash
-pippit-cli short-drama +upload-file --path /path/to/outline.md
+pippit-tool-cli short-drama +upload-file --path /path/to/outline.md
 ```
 
 ### 4. 获取会话文件
 
 ```bash
 # 获取会话文件列表
-pippit-cli short-drama +list-thread-file --thread-id THREAD_ID --page-num 1 --page-size 200
+pippit-tool-cli short-drama +list-thread-file --thread-id THREAD_ID --page-num 1 --page-size 200
 ```
 
 `+list-thread-file` 返回的每个文件对象包含：
@@ -93,7 +93,7 @@ pippit-cli short-drama +list-thread-file --thread-id THREAD_ID --page-num 1 --pa
 
 ```bash
 # 下载文件资源到指定文件路径
-pippit-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PATH
+pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PATH
 ```
 
 `FILE_PATH` 必须直接使用 `+list-thread-file` 返回的完整 `file_path`，包含文件名，不要取父目录。`+download-result` 负责把会话产生的文件通过 URL 下载到该目标文件路径；如果目标文件已存在，跳过下载。
@@ -103,12 +103,12 @@ pippit-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PA
 ### 场景 1：用户要求生成短剧内容
 
 ```
-1. pippit-cli short-drama +submit-run --message "用户的原始短剧需求"
+1. pippit-tool-cli short-drama +submit-run --message "用户的原始短剧需求"
    → 拿到 thread_id、run_id 和 web_thread_link
 2. 立即将 web_thread_link 展示给用户
 3. 并行发起，二者同等重要：
-   a. pippit-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID --after-seq SEQUENCE
-   b. pippit-cli short-drama +list-thread-file --thread-id THREAD_ID --page-num PAGE_NUM --page-size 200
+   a. pippit-tool-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID --after-seq SEQUENCE
+   b. pippit-tool-cli short-drama +list-thread-file --thread-id THREAD_ID --page-num PAGE_NUM --page-size 200
 4. 检查 `get-thread` 返回的 messages：
    - 如果任务仍在进行中：展示过程消息，继续查询
    - 如果后端 Agent 提出问题：展示问题，等待用户回复
@@ -130,9 +130,9 @@ pippit-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PA
 ### 场景 2：用户提供参考文件要求创作
 
 ```
-1. pippit-cli short-drama +upload-file --path /path/to/file
+1. pippit-tool-cli short-drama +upload-file --path /path/to/file
    → 拿到 file_id
-2. pippit-cli short-drama +submit-run --message "用户的原始短剧需求" --asset-ids file_id
+2. pippit-tool-cli short-drama +submit-run --message "用户的原始短剧需求" --asset-ids file_id
    → 拿到 thread_id、run_id 和 web_thread_link
 3. 后续同场景 1 的并行查询、重要资产发现和文件下载流程
 ```
@@ -140,7 +140,7 @@ pippit-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PA
 ### 场景 3：在已有短剧会话中续写或修改
 
 ```
-1. pippit-cli short-drama +submit-run --message "用户的新需求" --thread-id THREAD_ID
+1. pippit-tool-cli short-drama +submit-run --message "用户的新需求" --thread-id THREAD_ID
    → 拿到新的 run_id 和 web_thread_link
 2. 继续按场景 1 展示进展、处理用户补充问题、获取新增会话文件列表，并及时下载新增重要资产
 ```
@@ -264,7 +264,7 @@ pippit-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PA
 
 对带 `download_url` 的重要资产调用下载工具，可并行。重要资产必须主动下载，不要等用户再次要求，也不要在调用下载工具前先检查本地文件是否存在。
 
-1. 调用 `pippit-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PATH`。
+1. 调用 `pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PATH`。
 2. 下载完成后，向用户展示本地文件路径；如果某个文件下载失败，记录失败项并在后续轮询中重试，不阻塞已成功落盘的文件展示。
 
 ## 向用户展示内容