@talesofai/neta-skills 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @neta/skills-neta
 
+## 0.14.0
+
+### Minor Changes
+
+- 54180c1: feat(premium): implement premium subscription commands and integrate dayjs for date handling
+
+  - Add premium subscription CLI commands: `create_premium_order`, `pay_premium_order`, `get_current_premium_plan`, `get_premium_order`, `list_premium_orders`, `list_premium_plans`; wire commerce APIs and command loading.
+  - Add `dayjs` and `src/utils/date.ts` for date formatting/parsing; adjust `parse_meta` as needed.
+  - Update `README.md` and `skills/neta-creative/SKILL.md`; add `skills/neta-creative/references/premium.md` for premium workflows.
+
+## 0.13.0
+
+### Minor Changes
+
+- rename all "travel" keywords in docs、commands to "adventure"
+
 ## 0.12.0
 
 ### Minor Changes

package/README.md

@@ -12,18 +12,19 @@
 
 **NETA Skills** is a collection of powerful AI agent skills and accompanying CLI tools designed for interacting with the [Neta Art](https://www.neta.art/) API. Built for developers and AI agents, it seamlessly extends any agent's capabilities to generate multimedia, manage characters, and process audio/video workflows.
 
-You can get your access token from the [Neta Open Portal](https://www.neta.art/open/).
+You can get your access token / NETA TOKEN from the [Neta Open Portal](https://www.neta.art/open/).
 
 ---
 
 ## ✨ Features
 
 - 🎨 **Multimedia Creation:** Generate stunning images, videos, and songs using state-of-the-art AI models.
+- ⭐ **Premium & Subscriptions:** List plans, create orders, start Stripe checkout, and verify the active tier via dedicated CLI commands (global API environment).
 - 🔧 **Image & Video Processing:** Effortlessly remove backgrounds and merge video assets.
 - 👤 **Character & Style Management:** Search, fetch details, and manage characters and stylistic elements.
 - 🏷️ **Community Integrations:** Explore trending hashtags, popular characters, and curated collections.
 - 🧭 **Smart Discovery & Suggestions:** Explore interactive feeds and get keyword, tag, and category suggestions for progressive content discovery.
-- 📖 **Interactive Story Adventures:** Craft and play AI-driven narrative campaigns (Travel) — the agent acts as DM and character roleplayer for immersive interactive fiction.
+- 📖 **Interactive Story Adventures:** Craft and play AI-driven narrative campaigns (Adventure) — the agent acts as DM and character roleplayer for immersive interactive fiction.
 - 🤖 **Agent First:** Designed from the ground up to plug into your favorite AI agent frameworks.
 
 ---
@@ -46,7 +47,7 @@ You can also install the specialized skills separately if your agent prefers mor
 # Community exploration (hashtags, spaces, interactive feed)
 npx skills add talesofai/neta-skills/skills/neta-community
 
-# Creation workflows (image / video / song)
+# Creation workflows (image / video / song) and premium subscription flows
 npx skills add talesofai/neta-skills/skills/neta-creative
 
 # Discovery & suggestions (keywords, tags, categories, content)
@@ -61,20 +62,20 @@ npx skills add talesofai/neta-skills/skills/neta-character
 # Elementum VToken creation and management
 npx skills add talesofai/neta-skills/skills/neta-elementum
 
-# AI-driven interactive story adventures (Travel Campaigns)
-npx skills add talesofai/neta-skills/skills/neta-travel
+# AI-driven interactive story adventures (Adventure Campaigns)
+npx skills add talesofai/neta-skills/skills/neta-adventure
 ```
 
 ### Available Commands
 
-The skill includes **34 commands** for various tasks:
+The skill includes **42 commands** for various tasks:
 
 | Category | Command | Description |
 |----------|---------|-------------|
-| **Travel Campaigns** | `create_travel_campaign` | Create an AI-driven interactive story adventure |
-| | `update_travel_campaign` | Update an existing travel campaign |
-| | `list_my_travel_campaigns` | List your created travel campaigns |
-| | `request_travel_campaign` | Load full campaign details for play mode |
+| **Adventure Campaigns** | `create_adventure_campaign` | Create an AI-driven interactive story adventure |
+| | `update_adventure_campaign` | Update an existing adventure campaign |
+| | `list_my_adventure_campaigns` | List your created adventure campaigns |
+| | `request_adventure_campaign` | Load full campaign details for play mode |
 | **Creation** | `make_image` | Generate images from text prompts |
 | | `make_video` | Generate videos from images and prompts |
 | | `make_song` | Compose songs with custom prompts and lyrics |
@@ -82,6 +83,12 @@ The skill includes **34 commands** for various tasks:
 | | `edit_collection` | Edit an existing collection (name, description, tags, status, etc.) |
 | | `publish_collection` | Publish or update a collection |
 | | `search_character_or_elementum` | Search reusable TCP building blocks (characters / elements / flows) |
+| **Premium** | `get_current_premium_plan` | Get the signed-in user’s current tier and subscription end when applicable |
+| | `list_premium_plans` | List available premium plans and SPU UUIDs |
+| | `create_premium_order` | Create an order for a plan (by SPU UUID) |
+| | `get_premium_order` | Fetch details for a single premium order |
+| | `list_premium_orders` | List premium orders (paginated) |
+| | `pay_premium_order` | Start payment for an unpaid order (e.g. Stripe Checkout) |
 | **VToken Management** | `create_character` | Create a character VToken (consumes credits) |
 | | `update_character` | Update an existing character VToken |
 | | `list_my_characters` | List all characters created by the current user |
@@ -136,14 +143,14 @@ export NETA_TOKEN=your_token_here
 
 ```bash
 # Get general help or specific command help
-npx -y @talesofai/neta-skills --help
-npx -y @talesofai/neta-skills make_image --help
+npx -y @talesofai/neta-skills@latest --help
+npx -y @talesofai/neta-skills@latest make_image --help
 
 # Example: Generate an image
-npx -y @talesofai/neta-skills make_image --prompt "A cyberpunk cityscape at night" --aspect "16:9"
+npx -y @talesofai/neta-skills@latest make_image --prompt "A cyberpunk cityscape at night" --aspect "16:9"
 
 # Example: Search for characters or elementum
-npx -y @talesofai/neta-skills search_character_or_elementum --keywords "fantasy"
+npx -y @talesofai/neta-skills@latest search_character_or_elementum --keywords "fantasy"
 ```
 
 ---
@@ -161,7 +168,7 @@ neta-skills/
 │   ├── neta-space/                 # Space navigation & exploration skills (EN)
 │   ├── neta-character/             # Character VToken creation & management (EN)
 │   ├── neta-elementum/             # Elementum VToken creation & management (EN)
-│   ├── neta-travel/                # Interactive story adventures / Travel Campaigns (EN)
+│   ├── neta-adventure/                # Interactive story adventures / Adventure Campaigns (EN)
 │   └── zh_cn/                      # Chinese-localized skills & references
 │       ├── neta/
 │       ├── neta-community/
@@ -170,10 +177,10 @@ neta-skills/
 │       ├── neta-space/
 │       ├── neta-character/
 │       ├── neta-elementum/
-│       └── neta-travel/
+│       └── neta-adventure/
 ├── src/                            # TypeScript source for the CLI
-│   ├── apis/                       # Typed Neta API client helpers
-│   ├── commands/                   # CLI command definitions (TS + YAML meta)
+│   ├── apis/                       # Typed Neta API client helpers (incl. commerce)
+│   ├── commands/                   # CLI command groups: creative, community, adventure, VToken, premium, …
 │   ├── utils/                      # Shared utilities
 │   └── cli.ts                      # CLI entrypoint (TypeScript)
 ├── bin/                            # Built JavaScript output for the CLI
@@ -203,7 +210,8 @@ Agents use these references to learn the optimal sequence of actions, parameter
 - **Song & MV Creation:** Workflows for composing songs and creating music videos with synchronized visuals.
 - **Character & Hashtag Research:** Processes for finding trending content, searching characters, and utilizing community trends.
 - **Character & Elementum Creation:** Character creation and elementum alchemy workflows.
-- **Travel Campaign Crafting & Play:** Multi-turn story creation workflow (Craft Mode), interactive session management (Play Mode), field reference, and complete genre examples. See `skills/neta-travel/references/`.
+- **Premium / Subscriptions:** Plan listing, order lifecycle, checkout channels, and environment limits. See `skills/neta-creative/references/premium.md`.
+- **Adventure Campaign Crafting & Play:** Multi-turn story creation workflow (Craft Mode), interactive session management (Play Mode), field reference, and complete genre examples. See `skills/neta-adventure/references/`.
 
 ---
 
@@ -231,8 +239,8 @@ In terminal environments, locale is typically controlled by:
 If you want to force a specific language for a single command, you can prefix it with the desired locale, for example:
 
 ```bash
-LC_ALL=zh_CN.UTF-8 npx -y @talesofai/neta-skills make_image --help
-LANG=en_US.UTF-8 npx -y @talesofai/neta-skills make_image --help
+LC_ALL=zh_CN.UTF-8 npx -y @talesofai/neta-skills@latest make_image --help
+LANG=en_US.UTF-8 npx -y @talesofai/neta-skills@latest make_image --help
 ```
 
 ---

package/README.zh_cn.md

@@ -64,7 +64,7 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-character
 npx skills add talesofai/neta-skills/skills/zh_cn/neta-elementum
 
 # AI 驱动的交互式故事冒险（奇遇剧本）
-npx skills add talesofai/neta-skills/skills/zh_cn/neta-travel
+npx skills add talesofai/neta-skills/skills/zh_cn/neta-adventure
 ```
 
 ### 可用指令总览
@@ -73,10 +73,10 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-travel
 
 | 分类 | 命令 | 说明 |
 |------|------|------|
-| **奇遇剧本 Travel** | `create_travel_campaign` | 创建 AI 驱动的交互式故事冒险剧本 |
-| | `update_travel_campaign` | 更新已有奇遇剧本 |
-| | `list_my_travel_campaigns` | 列出你创建的奇遇剧本 |
-| | `request_travel_campaign` | 加载完整剧本详情（游玩模式） |
+| **奇遇剧本 Adventure** | `create_adventure_campaign` | 创建 AI 驱动的交互式故事冒险剧本 |
+| | `update_adventure_campaign` | 更新已有奇遇剧本 |
+| | `list_my_adventure_campaigns` | 列出你创建的奇遇剧本 |
+| | `request_adventure_campaign` | 加载完整剧本详情（游玩模式） |
 | **创作 Creation** | `make_image` | 基于提示词生成图片 |
 | | `make_video` | 基于图片与动作描述生成视频 |
 | | `make_song` | 基于风格与歌词生成歌曲 |
@@ -140,16 +140,16 @@ export NETA_TOKEN=your_token_here
 
 ```bash
 # 查看帮助
-npx -y @talesofai/neta-skills --help
-npx -y @talesofai/neta-skills make_image --help
+npx -y @talesofai/neta-skills@latest --help
+npx -y @talesofai/neta-skills@latest make_image --help
 
 # 示例：生成一张图片
-npx -y @talesofai/neta-skills make_image \
+npx -y @talesofai/neta-skills@latest make_image \
   --prompt "夜晚的赛博朋克城市，霓虹灯，高楼大厦，雨中街道" \
   --aspect "16:9"
 
 # 示例：搜索角色或元素
-npx -y @talesofai/neta-skills search_character_or_elementum \
+npx -y @talesofai/neta-skills@latest search_character_or_elementum \
   --keywords "幻想" \
   --parent_type "character"
 ```
@@ -169,7 +169,7 @@ neta-skills/
 │   ├── neta-space/                 # 英文空间与话题导航 / 探索技能
 │   ├── neta-character/             # 英文角色 VToken 创建与管理技能
 │   ├── neta-elementum/             # 英文元素 VToken 创建与管理技能
-│   ├── neta-travel/                # 英文交互式故事冒险（奇遇剧本）技能
+│   ├── neta-adventure/                # 英文交互式故事冒险（奇遇剧本）技能
 │   └── zh_cn/                      # 中文本地化技能与参考文档
 │       ├── neta/
 │       ├── neta-community/
@@ -178,7 +178,7 @@ neta-skills/
 │       ├── neta-space/
 │       ├── neta-character/
 │       ├── neta-elementum/
-│       └── neta-travel/
+│       └── neta-adventure/
 ├── src/                            # CLI 对应的 TypeScript 源码
 │   ├── apis/                       # 封装后的 Neta API 调用
 │   ├── commands/                   # CLI 命令定义（TS + YAML 描述）
@@ -210,7 +210,7 @@ neta-skills/
 - **角色与标签调研**：如何通过角色 / 标签 / 空间找到合适的创作方向。
 - **角色与元素创建**：角色创建和元素炼金的工作流。
 - **玩法内容探索**：使用 `suggest_*` 与 `suggest_content` 构建渐进式探索闭环。
-- **奇遇剧本创作与游玩**：多轮协作故事创作工作流（创作模式）、交互式会话管理（游玩模式）、字段手册，以及含历史穿越、末世生存、武侠江湖的完整类型范例。见 `skills/zh_cn/neta-travel/references/`。
+- **奇遇剧本创作与游玩**：多轮协作故事创作工作流（创作模式）、交互式会话管理（游玩模式）、字段手册，以及含历史穿越、末世生存、武侠江湖的完整类型范例。见 `skills/zh_cn/neta-adventure/references/`。
 
 ---
 
@@ -238,8 +238,8 @@ CLI 与 Skills 会根据系统与环境变量自动选择使用的语言：
 在需要强制指定语言时，推荐在运行命令前显式设置环境变量，例如：
 
 ```bash
-LC_ALL=zh_CN.UTF-8 npx -y @talesofai/neta-skills make_image --help
-LANG=en_US.UTF-8 npx -y @talesofai/neta-skills make_image --help
+LC_ALL=zh_CN.UTF-8 npx -y @talesofai/neta-skills@latest make_image --help
+LANG=en_US.UTF-8 npx -y @talesofai/neta-skills@latest make_image --help
 ```
 
 ---

package/bin/apis/commerce.js

@@ -0,0 +1,41 @@
+export const createCommerceApis = (client) => {
+    const listPlansConfig = async () => {
+        const res = await client.get("/v1/configs/config", {
+            params: {
+                namespace: "fe_configs",
+                key: "plans",
+            },
+        });
+        return res.data;
+    };
+    const createOrder = async (params) => {
+        const res = await client.post("/v1/commerce/orders", params);
+        return res.data;
+    };
+    const orders = async (params) => {
+        const res = await client.get("/v1/commerce/orders", {
+            params,
+        });
+        return res.data;
+    };
+    const order = async (params) => {
+        const res = await client.get(`/v1/commerce/orders/${params.order_uuid}`);
+        return res.data;
+    };
+    const pay = async (params) => {
+        const { order_uuid, channel, return_url, redirect_url } = params;
+        return client
+            .post(`/v1/commerce/orders/${order_uuid}/payment/${channel}`, {
+            redirect_url,
+            return_url,
+        })
+            .then((res) => res.data);
+    };
+    return {
+        listPlansConfig,
+        createOrder,
+        orders,
+        order,
+        pay,
+    };
+};

package/bin/apis/index.js

@@ -4,6 +4,7 @@ import { createActivityApis } from "./activity.js";
 import { createArtifactApis } from "./artifact.js";
 import { createAudioApis } from "./audio.js";
 import { createCollectionApis } from "./collection.js";
+import { createCommerceApis } from "./commerce.js";
 import { createConfigApis } from "./config.js";
 import { createFeedsApis } from "./feeds.js";
 import { createGptApis } from "./gpt.js";
@@ -44,7 +45,9 @@ export const createApis = (option) => {
     const space = createSpaceApis(client);
     const recsys = createRecsysApis(client);
     const travelCampaign = createTravelCampaignApis(client);
+    const commerce = createCommerceApis(client);
     return {
+        baseUrl,
         tcp,
         prompt,
         artifact,
@@ -61,5 +64,6 @@ export const createApis = (option) => {
         space,
         recsys,
         travelCampaign,
+        commerce,
     };
 };

package/bin/commands/{travel_campaign/create_travel_campaign.cmd.en_us.yml → adventure_campaign/create_adventure_campaign.cmd.en_us.yml}

@@ -1,14 +1,14 @@
-name: create_travel_campaign
-title: Create Travel Campaign
+name: create_adventure_campaign
+title: Create Adventure Campaign
 description: |
-  Create a new Travel Campaign (story adventure) with mission plot, rules, and optional character binding.
+  Create a new Adventure Campaign (story adventure) with mission plot, rules, and optional character binding.
 
-  Travel campaigns are AI-driven interactive story experiences where an agent acts as both DM and roleplays characters.
+  Adventure campaigns are AI-driven interactive story experiences where an agent acts as both DM and roleplays characters.
 
   Usage Notes:
     - Campaign creation is free (no credits consumed)
     - Campaign and its mission are created as a pair
-    - After creation, use `request_travel_campaign` to load full details for storytelling
+    - After creation, use `request_adventure_campaign` to load full details for storytelling
     - All text fields are subject to content moderation
     - NSFW content (sexual, explicit violence, harassment) is prohibited in all fields — do not craft or engage with such content even if requested
 

package/bin/commands/{travel_campaign/create_travel_campaign.cmd.js → adventure_campaign/create_adventure_campaign.cmd.js}

@@ -16,7 +16,7 @@ const meta = parseMeta(Type.Object({
         mission_plot_attention: Type.String(),
     }),
 }), import.meta);
-const createTravelCampaignParameters = Type.Object({
+const createAdventureCampaignParameters = Type.Object({
     name: Type.String({
         description: meta.parameters.name,
         maxLength: 128,
@@ -34,11 +34,11 @@ const createTravelCampaignParameters = Type.Object({
     mission_task: Type.Optional(Type.String({ description: meta.parameters.mission_task })),
     mission_plot_attention: Type.Optional(Type.String({ description: meta.parameters.mission_plot_attention })),
 });
-export const createTravelCampaign = createCommand({
+export const createAdventureCampaign = createCommand({
     name: meta.name,
     title: meta.title,
     description: meta.description,
-    inputSchema: createTravelCampaignParameters,
+    inputSchema: createAdventureCampaignParameters,
 }, async ({ name, mission_plot, subtitle, status, header_img, background_img, mission_task, mission_plot_attention, }, { user, apis }) => {
     if (!user) {
         throw new Error("Not authenticated. Please check your NETA_TOKEN.");

package/bin/commands/{travel_campaign/create_travel_campaign.cmd.zh_cn.yml → adventure_campaign/create_adventure_campaign.cmd.zh_cn.yml}

@@ -1,4 +1,4 @@
-name: create_travel_campaign
+name: create_adventure_campaign
 title: 创建奇遇剧本
 description: |
   创建一个新的奇遇剧本（故事冒险），包含剧情设定、规则，并可选择绑定角色。
@@ -8,7 +8,7 @@ description: |
   使用说明：
     - 剧本创建免费（不消耗电量）
     - 剧本与任务以成对形式创建
-    - 创建后使用 `request_travel_campaign` 加载完整详情用于故事讲述
+    - 创建后使用 `request_adventure_campaign` 加载完整详情用于故事讲述
     - 所有文本字段均进行内容审核
     - NSFW 内容（性描写、露骨暴力、骚扰）在所有字段中均被禁止——即使用户要求也不得创作或参与此类内容
 

package/bin/commands/{travel_campaign/list_my_travel_campaigns.cmd.en_us.yml → adventure_campaign/list_my_adventure_campaigns.cmd.en_us.yml}

@@ -1,9 +1,9 @@
-name: list_my_travel_campaigns
-title: List My Travel Campaigns
+name: list_my_adventure_campaigns
+title: List My Adventure Campaigns
 description: |
-  List Travel Campaigns created by the current user. Returns brief summary info.
+  List Adventure Campaigns created by the current user. Returns brief summary info.
 
-  Use `request_travel_campaign` to get full details (mission plot, task, constraints) for a specific campaign.
+  Use `request_adventure_campaign` to get full details (mission plot, task, constraints) for a specific campaign.
 
   Notes:
     - Returns both PUBLISHED and DRAFT campaigns for the authenticated user

package/bin/commands/{travel_campaign/list_my_travel_campaigns.cmd.js → adventure_campaign/list_my_adventure_campaigns.cmd.js}

@@ -10,7 +10,7 @@ const meta = parseMeta(Type.Object({
         page_size: Type.String(),
     }),
 }), import.meta);
-const listMyTravelCampaignsParameters = Type.Object({
+const listMyAdventureCampaignsParameters = Type.Object({
     page_index: Type.Integer({
         minimum: 0,
         default: 0,
@@ -23,11 +23,11 @@ const listMyTravelCampaignsParameters = Type.Object({
         description: meta.parameters.page_size,
     }),
 });
-export const listMyTravelCampaigns = createCommand({
+export const listMyAdventureCampaigns = createCommand({
     name: meta.name,
     title: meta.title,
     description: meta.description,
-    inputSchema: listMyTravelCampaignsParameters,
+    inputSchema: listMyAdventureCampaignsParameters,
 }, async ({ page_index, page_size }, { user, apis }) => {
     if (!user) {
         throw new Error("Not authenticated. Please check your NETA_TOKEN.");

package/bin/commands/{travel_campaign/list_my_travel_campaigns.cmd.zh_cn.yml → adventure_campaign/list_my_adventure_campaigns.cmd.zh_cn.yml}

@@ -1,9 +1,9 @@
-name: list_my_travel_campaigns
+name: list_my_adventure_campaigns
 title: 列出我的奇遇剧本
 description: |
   列出当前用户创建的奇遇剧本。返回简要摘要信息。
 
-  使用 `request_travel_campaign` 获取特定剧本的完整详情（剧情、任务、约束）。
+  使用 `request_adventure_campaign` 获取特定剧本的完整详情（剧情、任务、约束）。
 
   说明：
     - 为已认证用户返回 PUBLISHED 和 DRAFT 剧本

package/bin/commands/{travel_campaign/request_travel_campaign.cmd.en_us.yml → adventure_campaign/request_adventure_campaign.cmd.en_us.yml}

@@ -1,7 +1,7 @@
-name: request_travel_campaign
-title: Get Travel Campaign Details
+name: request_adventure_campaign
+title: Get Adventure Campaign Details
 description: |
-  Get full details of a Travel Campaign including mission plot, task, and AI constraints.
+  Get full details of an Adventure Campaign including mission plot, task, and AI constraints.
 
   This is the primary command for "play mode" — load a campaign before starting a storytelling session.
 

package/bin/commands/{travel_campaign/request_travel_campaign.cmd.js → adventure_campaign/request_adventure_campaign.cmd.js}

@@ -9,16 +9,16 @@ const meta = parseMeta(Type.Object({
         campaign_uuid: Type.String(),
     }),
 }), import.meta);
-const requestTravelCampaignParameters = Type.Object({
+const requestAdventureCampaignParameters = Type.Object({
     campaign_uuid: Type.String({
         description: meta.parameters.campaign_uuid,
     }),
 });
-export const requestTravelCampaign = createCommand({
+export const requestAdventureCampaign = createCommand({
     name: meta.name,
     title: meta.title,
     description: meta.description,
-    inputSchema: requestTravelCampaignParameters,
+    inputSchema: requestAdventureCampaignParameters,
 }, async ({ campaign_uuid }, { apis }) => {
     const campaign = await apis.travelCampaign.getCampaign(campaign_uuid);
     return {

package/bin/commands/{travel_campaign/request_travel_campaign.cmd.zh_cn.yml → adventure_campaign/request_adventure_campaign.cmd.zh_cn.yml}

@@ -1,4 +1,4 @@
-name: request_travel_campaign
+name: request_adventure_campaign
 title: 获取奇遇剧本详情
 description: |
   获取奇遇剧本的完整详情，包括剧情、任务和 AI 约束。

package/bin/commands/{travel_campaign/update_travel_campaign.cmd.en_us.yml → adventure_campaign/update_adventure_campaign.cmd.en_us.yml}

@@ -1,7 +1,7 @@
-name: update_travel_campaign
-title: Update Travel Campaign
+name: update_adventure_campaign
+title: Update Adventure Campaign
 description: |
-  Update an existing Travel Campaign. Only specify fields that need to change — omitted fields remain unchanged.
+  Update an existing Adventure Campaign. Only specify fields that need to change — omitted fields remain unchanged.
 
   Usage Notes:
     - You must be the creator of the campaign to update it

package/bin/commands/{travel_campaign/update_travel_campaign.cmd.js → adventure_campaign/update_adventure_campaign.cmd.js}

@@ -17,7 +17,7 @@ const meta = parseMeta(Type.Object({
         mission_plot_attention: Type.String(),
     }),
 }), import.meta);
-const updateTravelCampaignParameters = Type.Object({
+const updateAdventureCampaignParameters = Type.Object({
     campaign_uuid: Type.String({
         description: meta.parameters.campaign_uuid,
     }),
@@ -35,11 +35,11 @@ const updateTravelCampaignParameters = Type.Object({
     mission_task: Type.Optional(Type.String({ description: meta.parameters.mission_task })),
     mission_plot_attention: Type.Optional(Type.String({ description: meta.parameters.mission_plot_attention })),
 });
-export const updateTravelCampaign = createCommand({
+export const updateAdventureCampaign = createCommand({
     name: meta.name,
     title: meta.title,
     description: meta.description,
-    inputSchema: updateTravelCampaignParameters,
+    inputSchema: updateAdventureCampaignParameters,
 }, async ({ campaign_uuid, name, mission_plot, subtitle, status, header_img, background_img, mission_task, mission_plot_attention, }, { user, apis }) => {
     if (!user) {
         throw new Error("Not authenticated. Please check your NETA_TOKEN.");

package/bin/commands/{travel_campaign/update_travel_campaign.cmd.zh_cn.yml → adventure_campaign/update_adventure_campaign.cmd.zh_cn.yml}

@@ -1,4 +1,4 @@
-name: update_travel_campaign
+name: update_adventure_campaign
 title: 更新奇遇剧本
 description: |
   更新已有的奇遇剧本。只需指定要修改的字段——未提供的字段保持不变。

package/bin/commands/load.js

@@ -11,7 +11,7 @@ import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { Option, } from "@commander-js/extra-typings";
 import { Type } from "@sinclair/typebox";
-import { Default, Value } from "@sinclair/typebox/value";
+import { AssertError, Value } from "@sinclair/typebox/value";
 import { createApis } from "../apis/index.js";
 import { ApiResponseError } from "../utils/errors.js";
 import { setLocale } from "../utils/parse_meta.js";
@@ -44,7 +44,8 @@ export const buildCommands = async (cli) => {
         "creative",
         "community",
         "character_elementum",
-        "travel_campaign",
+        "adventure_campaign",
+        "premium",
     ]);
     return commands.map((cmd) => {
         const command = cli.command(cmd.name);
@@ -102,7 +103,7 @@ export const buildCommands = async (cli) => {
                 return null;
             });
             const type = cmd.inputSchema ?? Type.Object({});
-            const input = Value.Decode(type, Default(type, args));
+            const input = Value.Parse(type, args);
             if (IS_DEV) {
                 logger.debug("command: %s, params: %o", cmd.name, input);
             }
@@ -120,6 +121,17 @@ export const buildCommands = async (cli) => {
                     },
             })
                 .catch((e) => {
+                if (e instanceof AssertError) {
+                    logger.error({
+                        error: {
+                            type: e.name,
+                            message: e.message,
+                            path: e.error?.path,
+                            schema: e.error?.schema,
+                        },
+                    });
+                    return null;
+                }
                 if (e instanceof ApiResponseError) {
                     logger.error({
                         error: {
@@ -145,7 +157,7 @@ export const buildCommands = async (cli) => {
             if (!result)
                 return;
             if (IS_DEV) {
-                logger.debug(result);
+                logger.debug(JSON.stringify(result, null, 2));
             }
             else {
                 logger.info(JSON.stringify(result));

package/bin/commands/premium/create_premium_order.cmd.en_us.yml

@@ -0,0 +1,5 @@
+name: create_premium_order
+title: Create Premium Order
+description: Create a new premium order for a subscription plan (SPU).
+parameters:
+  spu_uuid: UUID of the premium plan SPU to purchase

package/bin/commands/premium/create_premium_order.cmd.js

@@ -0,0 +1,46 @@
+import { Type } from "@sinclair/typebox";
+import { parseDate } from "../../utils/date.js";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+    parameters: Type.Object({
+        spu_uuid: Type.String(),
+    }),
+}), import.meta);
+export const createPremiumOrder = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: Type.Object({
+        spu_uuid: Type.String({ description: meta.parameters.spu_uuid }),
+    }),
+}, async ({ spu_uuid }, { apis }) => {
+    if (!apis.baseUrl.endsWith("talesofai.com")) {
+        throw new Error("This command is not supported in the current region");
+    }
+    const order = await apis.commerce.createOrder({
+        spu_uuid,
+    });
+    return {
+        order: {
+            uuid: order.uuid,
+            spu: {
+                uuid: order.spu.uuid,
+                name: order.spu.name,
+                price: order.spu.price,
+            },
+            status: order.status,
+            status_history: order.status_history.map((item) => ({
+                ...item,
+                time: parseDate(item.time).format(),
+            })),
+            price: order.price,
+            valid_until: parseDate(order.valid_until).format(),
+            ctime: parseDate(order.ctime).format(),
+            mtime: parseDate(order.mtime).format(),
+        },
+    };
+});

package/bin/commands/premium/create_premium_order.cmd.zh_cn.yml

@@ -0,0 +1,5 @@
+name: create_premium_order
+title: 创建会员订单
+description: 为订阅套餐（SPU）创建新的会员订单。
+parameters:
+  spu_uuid: 要购买的会员套餐 SPU 的 UUID

package/bin/commands/premium/get_current_premium_plan.cmd.en_us.yml

@@ -0,0 +1,3 @@
+name: get_current_premium_plan
+title: Get Current Premium Plan
+description: Get the signed-in user's current premium tier and subscription end time.