@talesofai/neta-skills 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @neta/skills-neta
 
+## 0.12.0
+
+### Minor Changes
+
+- 0a03853: introduce neta-travel skill for creating and playing AI-driven interactive story adventures (travel campaigns)
+
 ## 0.11.0
 
 ### Minor Changes

package/README.md

@@ -23,6 +23,7 @@ You can get your access token from the [Neta Open Portal](https://www.neta.art/o
 - 👤 **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.
 - 🤖 **Agent First:** Designed from the ground up to plug into your favorite AI agent frameworks.
 
 ---
@@ -59,14 +60,21 @@ 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
 ```
 
 ### Available Commands
 
-The skill includes **30 commands** for various tasks:
+The skill includes **34 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 |
 | **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 |
@@ -128,14 +136,14 @@ export NETA_TOKEN=your_token_here
 
 ```bash
 # Get general help or specific command help
-neta-cli --help
-neta-cli make_image --help
+npx -y @talesofai/neta-skills --help
+npx -y @talesofai/neta-skills make_image --help
 
 # Example: Generate an image
-neta-cli make_image --prompt "A cyberpunk cityscape at night" --aspect "16:9"
+npx -y @talesofai/neta-skills make_image --prompt "A cyberpunk cityscape at night" --aspect "16:9"
 
 # Example: Search for characters or elementum
-neta-cli search_character_or_elementum --keywords "fantasy"
+npx -y @talesofai/neta-skills search_character_or_elementum --keywords "fantasy"
 ```
 
 ---
@@ -153,6 +161,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)
 │   └── zh_cn/                      # Chinese-localized skills & references
 │       ├── neta/
 │       ├── neta-community/
@@ -160,7 +169,8 @@ neta-skills/
 │       ├── neta-suggest/
 │       ├── neta-space/
 │       ├── neta-character/
-│       └── neta-elementum/
+│       ├── neta-elementum/
+│       └── neta-travel/
 ├── src/                            # TypeScript source for the CLI
 │   ├── apis/                       # Typed Neta API client helpers
 │   ├── commands/                   # CLI command definitions (TS + YAML meta)
@@ -193,6 +203,7 @@ 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/`.
 
 ---
 
@@ -220,8 +231,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 neta-cli make_image --help
-LANG=en_US.UTF-8 neta-cli make_image --help
+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
 ```
 
 ---

package/README.zh_cn.md

@@ -16,6 +16,7 @@
 - 查询与管理角色（Character）与风格元素（Elementum）
 - 进行标签（Hashtag）与空间玩法探索
 - 通过推荐引擎和互动 Feed 进行玩法内容发现
+- 创作与游玩 AI 驱动的交互式故事冒险（奇遇剧本），Agent 担任 DM 与角色扮演者
 
 你可以在 [Neta 开放平台](https://www.neta.art/open/) 获取访问令牌 `NETA_TOKEN`。
 也可以在[国内登陆账号后台](https://app.nieta.art/security) 获取访问令牌 `NETA_TOKEN`。
@@ -61,14 +62,21 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-character
 
 # 元素 VToken 创建与管理
 npx skills add talesofai/neta-skills/skills/zh_cn/neta-elementum
+
+# AI 驱动的交互式故事冒险（奇遇剧本）
+npx skills add talesofai/neta-skills/skills/zh_cn/neta-travel
 ```
 
 ### 可用指令总览
 
-当前技能共包含 **30 个命令**，覆盖创作、角色与社区探索等场景：
+当前技能共包含 **34 个命令**，覆盖创作、奇遇、角色与社区探索等场景：
 
 | 分类 | 命令 | 说明 |
 |------|------|------|
+| **奇遇剧本 Travel** | `create_travel_campaign` | 创建 AI 驱动的交互式故事冒险剧本 |
+| | `update_travel_campaign` | 更新已有奇遇剧本 |
+| | `list_my_travel_campaigns` | 列出你创建的奇遇剧本 |
+| | `request_travel_campaign` | 加载完整剧本详情（游玩模式） |
 | **创作 Creation** | `make_image` | 基于提示词生成图片 |
 | | `make_video` | 基于图片与动作描述生成视频 |
 | | `make_song` | 基于风格与歌词生成歌曲 |
@@ -132,16 +140,16 @@ export NETA_TOKEN=your_token_here
 
 ```bash
 # 查看帮助
-neta-cli --help
-neta-cli make_image --help
+npx -y @talesofai/neta-skills --help
+npx -y @talesofai/neta-skills make_image --help
 
 # 示例：生成一张图片
-neta-cli make_image \
+npx -y @talesofai/neta-skills make_image \
   --prompt "夜晚的赛博朋克城市，霓虹灯，高楼大厦，雨中街道" \
   --aspect "16:9"
 
 # 示例：搜索角色或元素
-neta-cli search_character_or_elementum \
+npx -y @talesofai/neta-skills search_character_or_elementum \
   --keywords "幻想" \
   --parent_type "character"
 ```
@@ -161,6 +169,7 @@ neta-skills/
 │   ├── neta-space/                 # 英文空间与话题导航 / 探索技能
 │   ├── neta-character/             # 英文角色 VToken 创建与管理技能
 │   ├── neta-elementum/             # 英文元素 VToken 创建与管理技能
+│   ├── neta-travel/                # 英文交互式故事冒险（奇遇剧本）技能
 │   └── zh_cn/                      # 中文本地化技能与参考文档
 │       ├── neta/
 │       ├── neta-community/
@@ -168,7 +177,8 @@ neta-skills/
 │       ├── neta-suggest/
 │       ├── neta-space/
 │       ├── neta-character/
-│       └── neta-elementum/
+│       ├── neta-elementum/
+│       └── neta-travel/
 ├── src/                            # CLI 对应的 TypeScript 源码
 │   ├── apis/                       # 封装后的 Neta API 调用
 │   ├── commands/                   # CLI 命令定义（TS + YAML 描述）
@@ -200,6 +210,7 @@ neta-skills/
 - **角色与标签调研**：如何通过角色 / 标签 / 空间找到合适的创作方向。
 - **角色与元素创建**：角色创建和元素炼金的工作流。
 - **玩法内容探索**：使用 `suggest_*` 与 `suggest_content` 构建渐进式探索闭环。
+- **奇遇剧本创作与游玩**：多轮协作故事创作工作流（创作模式）、交互式会话管理（游玩模式）、字段手册，以及含历史穿越、末世生存、武侠江湖的完整类型范例。见 `skills/zh_cn/neta-travel/references/`。
 
 ---
 
@@ -227,8 +238,8 @@ CLI 与 Skills 会根据系统与环境变量自动选择使用的语言：
 在需要强制指定语言时，推荐在运行命令前显式设置环境变量，例如：
 
 ```bash
-LC_ALL=zh_CN.UTF-8 neta-cli make_image --help
-LANG=en_US.UTF-8 neta-cli make_image --help
+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
 ```
 
 ---

package/bin/apis/index.js

@@ -13,6 +13,7 @@ import { createRecsysApis } from "./recsys.js";
 import { createSpaceApis } from "./space.js";
 import { createTaskApis } from "./task.js";
 import { createTcpApis } from "./tcp.js";
+import { createTravelCampaignApis } from "./travel_campaign.js";
 import { createUserApis } from "./user.js";
 import { createVerseApis } from "./verse.js";
 export const createApis = (option) => {
@@ -42,6 +43,7 @@ export const createApis = (option) => {
     const feeds = createFeedsApis(client);
     const space = createSpaceApis(client);
     const recsys = createRecsysApis(client);
+    const travelCampaign = createTravelCampaignApis(client);
     return {
         tcp,
         prompt,
@@ -58,5 +60,6 @@ export const createApis = (option) => {
         feeds,
         space,
         recsys,
+        travelCampaign,
     };
 };

package/bin/apis/travel_campaign.js

@@ -0,0 +1,30 @@
+export const createTravelCampaignApis = (client) => {
+    const createCampaign = async (params) => {
+        return client
+            .post("/v3/travel/campaign/", params)
+            .then((res) => res.data);
+    };
+    const updateCampaign = async (uuid, params) => {
+        return client
+            .patch(`/v3/travel/campaign/${uuid}`, params)
+            .then((res) => res.data);
+    };
+    const listMyCampaigns = async (query) => {
+        return client
+            .get("/v3/travel/campaigns", {
+            params: query,
+        })
+            .then((res) => res.data);
+    };
+    const getCampaign = async (uuid) => {
+        return client
+            .get(`/v3/travel/campaign/${uuid}`)
+            .then((res) => res.data);
+    };
+    return {
+        createCampaign,
+        updateCampaign,
+        listMyCampaigns,
+        getCampaign,
+    };
+};

package/bin/commands/load.js

@@ -44,6 +44,7 @@ export const buildCommands = async (cli) => {
         "creative",
         "community",
         "character_elementum",
+        "travel_campaign",
     ]);
     return commands.map((cmd) => {
         const command = cli.command(cmd.name);

package/bin/commands/travel_campaign/create_travel_campaign.cmd.en_us.yml

@@ -0,0 +1,60 @@
+name: create_travel_campaign
+title: Create Travel Campaign
+description: |
+  Create a new Travel 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.
+
+  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
+    - 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
+
+  Fields:
+    - name: Campaign title, max 128 characters
+    - mission_plot: Core story/scenario — the narrative foundation the agent uses to tell the story
+    - mission_task: Player objectives and interaction rules
+    - mission_plot_attention: Constraints and style guidelines for the AI (what it should/should not do)
+    - subtitle: One-line tagline shown on the campaign card
+    - status: PUBLISHED (visible to others) or DRAFT (private)
+    - header_img: Card thumbnail image URL
+    - background_img: Atmospheric background image URL
+
+parameters:
+  name: Campaign title, max 128 characters
+  mission_plot: |
+    Core story and scenario — the narrative foundation the AI uses to tell the story.
+    The first 2-3 sentences function as the opening scene: they are the first thing the AI
+    experiences, not a summary. Start mid-wrong: drop the player into a situation already
+    in motion, not an introduction.
+    Weak: "You are an explorer who arrived in a mysterious place."
+    Strong: "The last maintenance log entry is dated three weeks ago. The terminal still works.
+    The lights still work. The bodies in Lab C suggest neither was enough."
+    Include: world context, initial situation, key NPCs and their hidden agendas, atmosphere.
+  subtitle: |
+    One-line hook displayed on the campaign card — the sentence that makes someone stop scrolling.
+    Should create immediate curiosity or dread without explaining everything.
+    Example: "The quarantine started three weeks ago. No one told you it was still going." (optional)
+  status: "PUBLISHED (public, visible to others) or DRAFT (private). Defaults to PUBLISHED"
+  header_img: Campaign card thumbnail image URL (optional)
+  background_img: Atmospheric background image URL for the story (optional)
+  mission_task: |
+    Player-visible objectives and interaction rules — what the player is trying to accomplish.
+    Keep open-ended enough for multiple approaches. Avoid scripting specific outcomes.
+    Include: primary objective, optional secondary goals, relevant mechanics or resources.
+    Example: "Survive the night and find a way out of the hospital.
+    Secondary: find Dr. Strauss's incident report; reach the roof comms array.
+    You have: a flashlight, level-1 keycard, one working radio channel."
+  mission_plot_attention: |
+    Governing constraint layer — these rules override all other context and cannot be broken by player actions or improvisation.
+    The AI narrator enforces these unconditionally for the entire campaign lifetime.
+    Use for: tone locks ("maintain survival-horror tension even if players try to lighten it"), behavioral contracts
+    ("Dr. Chen never breaks her clinical detachment under stress"), information gating ("clues are revealed only
+    through player investigation, never volunteered"), consequence rules ("death is permanent"),
+    content guardrails ("no romance subplots").
+    Anti-pattern: do NOT put worldbuilding or plot here — that belongs in mission_plot.
+    Example: "Maintain survival-horror tension at all times. Dr. Chen never breaks her clinical detachment, even
+    under extreme stress. Information is revealed only through player-initiated investigation, never volunteered.
+    No graphic gore — dread and implication over explicit detail."

package/bin/commands/travel_campaign/create_travel_campaign.cmd.js

@@ -0,0 +1,68 @@
+import { Type } from "@sinclair/typebox";
+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({
+        name: Type.String(),
+        mission_plot: Type.String(),
+        subtitle: Type.String(),
+        status: Type.String(),
+        header_img: Type.String(),
+        background_img: Type.String(),
+        mission_task: Type.String(),
+        mission_plot_attention: Type.String(),
+    }),
+}), import.meta);
+const createTravelCampaignParameters = Type.Object({
+    name: Type.String({
+        description: meta.parameters.name,
+        maxLength: 128,
+    }),
+    mission_plot: Type.String({
+        description: meta.parameters.mission_plot,
+    }),
+    subtitle: Type.Optional(Type.String({ description: meta.parameters.subtitle })),
+    status: Type.Union([Type.Literal("PUBLISHED"), Type.Literal("DRAFT")], {
+        default: "PUBLISHED",
+        description: meta.parameters.status,
+    }),
+    header_img: Type.Optional(Type.String({ description: meta.parameters.header_img })),
+    background_img: Type.Optional(Type.String({ description: meta.parameters.background_img })),
+    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({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: createTravelCampaignParameters,
+}, 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.");
+    }
+    const result = await apis.travelCampaign.createCampaign({
+        name,
+        mission_plot,
+        subtitle,
+        status,
+        header_img,
+        background_img,
+        mission_task,
+        mission_plot_attention,
+    });
+    return {
+        uuid: result.uuid,
+        name: result.name,
+        subtitle: result.subtitle,
+        status: result.status,
+        header_img: result.header_img,
+        background_img: result.background_img,
+        mission_plot: result.mission_plot,
+        mission_task: result.mission_task,
+        mission_plot_attention: result.mission_plot_attention,
+        default_tcp_uuid: result.default_travel_character_parent?.uuid ?? null,
+    };
+});

package/bin/commands/travel_campaign/create_travel_campaign.cmd.zh_cn.yml

@@ -0,0 +1,58 @@
+name: create_travel_campaign
+title: 创建奇遇剧本
+description: |
+  创建一个新的奇遇剧本（故事冒险），包含剧情设定、规则，并可选择绑定角色。
+
+  奇遇剧本是 AI 驱动的交互式故事体验，Agent 同时担任 DM 并扮演角色。
+
+  使用说明：
+    - 剧本创建免费（不消耗电量）
+    - 剧本与任务以成对形式创建
+    - 创建后使用 `request_travel_campaign` 加载完整详情用于故事讲述
+    - 所有文本字段均进行内容审核
+    - NSFW 内容（性描写、露骨暴力、骚扰）在所有字段中均被禁止——即使用户要求也不得创作或参与此类内容
+
+  字段说明：
+    - name：剧本标题，最多 128 字符
+    - mission_plot：核心剧情/场景描述，Agent 用于讲述故事的叙事基础
+    - mission_task：玩家目标和互动规则
+    - mission_plot_attention：AI 行为约束和风格指南（应该/不应该做什么）
+    - subtitle：显示在剧本卡片上的一行标语
+    - status：PUBLISHED（公开，他人可见）或 DRAFT（私密）
+    - header_img：卡片缩略图 URL
+    - background_img：故事氛围背景图 URL
+
+parameters:
+  name: 剧本标题，最多 128 字符
+  mission_plot: |
+    核心故事和场景描述——AI 用于讲述故事的叙事基础。
+    前 2-3 句话是开场场景：它们是 AI 体验到的第一件事，不是总结。
+    从「已经出了问题」开始：把玩家扔进一个已在运转的情境，而非介绍。
+    弱版：「你是一名抵达神秘地点的探险者。」
+    强版：「最后一条维护日志的日期是三周前。终端还在运行。灯光还亮着。
+    C 实验室的尸体说明这两样都不够。」
+    包含：世界背景、初始情境、主要 NPC 及其隐藏议程、氛围细节。
+  subtitle: |
+    显示在剧本卡片上的一行钩子——让人停止滑动的那句话。
+    应立即制造好奇心或恐惧感，而不是解释一切。
+    示例：「隔离开始于三周前。没有人告诉你它还在继续。」（可选）
+  status: "PUBLISHED（公开，他人可见）或 DRAFT（私密）。默认 PUBLISHED"
+  header_img: 剧本卡片缩略图 URL（可选）
+  background_img: 故事氛围背景图 URL（可选）
+  mission_task: |
+    玩家可见的目标和互动规则——玩家试图完成什么。
+    保持足够开放以允许多种方法。避免预设具体结果。
+    包含：主要目标、可选次要目标、相关机制或资源。
+    示例：「在城破前查明密函来源和使者真实身份。
+    次要：完成原身的约定；在城破前离开汴京。
+    你有：太学生的身份、一些江湖关系、以及你亲眼所见的目击证词。」
+  mission_plot_attention: |
+    统治性约束层——这些规则凌驾于所有其他上下文之上，玩家行动或即兴发挥均无法打破。
+    AI 叙事者在整个剧本生命周期内无条件执行这些规则。
+    适用于：基调锁定（「即使玩家试图轻松化，也要维持生存恐怖张力」）、行为契约
+    （「陈医生即使在极端压力下也绝不打破她的临床冷静」）、信息门控（「线索只通过
+    玩家主动调查才会揭示，绝不主动透露」）、后果规则（「死亡是永久性的」）、
+    内容护栏（「不得有浪漫支线」）。
+    反模式：不要在这里放世界观或剧情——那属于 mission_plot。
+    示例：「始终保持生存恐怖张力。陈医生即使在极端压力下也绝不打破临床冷静。
+    信息只通过玩家主动调查才揭示，绝不主动透露。不需要血腥细节——用恐惧和暗示代替直白描述。」

package/bin/commands/travel_campaign/list_my_travel_campaigns.cmd.en_us.yml

@@ -0,0 +1,14 @@
+name: list_my_travel_campaigns
+title: List My Travel Campaigns
+description: |
+  List Travel 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.
+
+  Notes:
+    - Returns both PUBLISHED and DRAFT campaigns for the authenticated user
+    - Results are ordered by last modified time (newest first)
+
+parameters:
+  page_index: Page index for pagination, defaults to 0
+  page_size: Number of results per page (1-50), defaults to 20

package/bin/commands/travel_campaign/list_my_travel_campaigns.cmd.js

@@ -0,0 +1,53 @@
+import { Type } from "@sinclair/typebox";
+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({
+        page_index: Type.String(),
+        page_size: Type.String(),
+    }),
+}), import.meta);
+const listMyTravelCampaignsParameters = Type.Object({
+    page_index: Type.Integer({
+        minimum: 0,
+        default: 0,
+        description: meta.parameters.page_index,
+    }),
+    page_size: Type.Integer({
+        minimum: 1,
+        maximum: 50,
+        default: 20,
+        description: meta.parameters.page_size,
+    }),
+});
+export const listMyTravelCampaigns = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: listMyTravelCampaignsParameters,
+}, async ({ page_index, page_size }, { user, apis }) => {
+    if (!user) {
+        throw new Error("Not authenticated. Please check your NETA_TOKEN.");
+    }
+    const result = await apis.travelCampaign.listMyCampaigns({
+        user_uuid: user.uuid,
+        page_index,
+        page_size,
+    });
+    return {
+        total: result.total,
+        page_index: result.page_index,
+        page_size: result.page_size,
+        list: result.list.map((item) => ({
+            uuid: item.uuid,
+            name: item.name,
+            subtitle: item.subtitle,
+            status: item.status,
+            header_img: item.header_img,
+            default_tcp_uuid: item.default_travel_character_parent?.uuid ?? null,
+        })),
+    };
+});

package/bin/commands/travel_campaign/list_my_travel_campaigns.cmd.zh_cn.yml

@@ -0,0 +1,14 @@
+name: list_my_travel_campaigns
+title: 列出我的奇遇剧本
+description: |
+  列出当前用户创建的奇遇剧本。返回简要摘要信息。
+
+  使用 `request_travel_campaign` 获取特定剧本的完整详情（剧情、任务、约束）。
+
+  说明：
+    - 为已认证用户返回 PUBLISHED 和 DRAFT 剧本
+    - 结果按最后修改时间排序（最新在前）
+
+parameters:
+  page_index: 分页页码，默认为 0
+  page_size: 每页结果数量（1-50），默认为 20

package/bin/commands/travel_campaign/request_travel_campaign.cmd.en_us.yml

@@ -0,0 +1,38 @@
+name: request_travel_campaign
+title: Get Travel Campaign Details
+description: |
+  Get full details of a Travel Campaign including mission plot, task, and AI constraints.
+
+  This is the primary command for "play mode" — load a campaign before starting a storytelling session.
+
+  Agent Play Mode Workflow:
+    1. Call this command with the campaign UUID
+    2. Incorporate mission_plot as the story foundation in your context
+    3. Use mission_task as the player objectives and rules
+    4. If mission_plot_attention is present, apply it as the governing constraint layer — these rules override all other context. If absent, derive tone and constraints naturally from mission_plot
+    5. If default_tcp_uuid is present, load the character profile via `request_character_or_elementum` (neta-creative skill) then roleplay that character during the session
+    6. Synthesize campaign context into a scene-setting opening prompt (see template below)
+
+  Context Initialization Template:
+    Before the first player message, prime your context with:
+    ---
+    You are an interactive story narrator. The campaign is now active.
+    Story world: [summarize mission_plot in 2-3 sentences — setting, situation, stakes]
+    Your role: [narrator / or character name if default_tcp_uuid is present]
+    Player's starting position: [where the player begins, what they know]
+    Opening scene: [specific location, time of day, one dominant sensory detail]
+    Governing rules: [paste full mission_plot_attention here, if present; otherwise infer tone from mission_plot]
+    Your first response must: establish atmosphere, present one immediate discovery or threat,
+    and end with a concrete choice that demands action — not a summary, not an introduction.
+    ---
+    The first response sets the tone for the entire session. Invest in the opening.
+
+  Response Fields:
+    - mission_plot: The core story scenario and world context
+    - mission_task: Player objectives and interaction rules
+    - mission_plot_attention: Governing constraint layer (optional) — when present, follow strictly as they override all other context; when absent, derive tone naturally from mission_plot
+    - default_tcp_uuid: UUID of the bound character (if any); use `request_character_or_elementum` to load full profile before roleplaying
+    - header_img / background_img: Visual context for scene descriptions
+
+parameters:
+  campaign_uuid: UUID of the campaign to retrieve (required)

package/bin/commands/travel_campaign/request_travel_campaign.cmd.js

@@ -0,0 +1,44 @@
+import { Type } from "@sinclair/typebox";
+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({
+        campaign_uuid: Type.String(),
+    }),
+}), import.meta);
+const requestTravelCampaignParameters = Type.Object({
+    campaign_uuid: Type.String({
+        description: meta.parameters.campaign_uuid,
+    }),
+});
+export const requestTravelCampaign = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: requestTravelCampaignParameters,
+}, async ({ campaign_uuid }, { apis }) => {
+    const campaign = await apis.travelCampaign.getCampaign(campaign_uuid);
+    return {
+        uuid: campaign.uuid,
+        name: campaign.name,
+        subtitle: campaign.subtitle,
+        status: campaign.status,
+        header_img: campaign.header_img,
+        background_img: campaign.background_img,
+        ctime: campaign.ctime,
+        mtime: campaign.mtime,
+        mission_plot: campaign.mission_plot,
+        mission_task: campaign.mission_task,
+        mission_plot_attention: campaign.mission_plot_attention,
+        default_tcp_uuid: campaign.default_travel_character_parent?.uuid ?? null,
+        creator: campaign.creator
+            ? {
+                uuid: campaign.creator.uuid,
+                nick_name: campaign.creator.nick_name,
+            }
+            : null,
+    };
+});

package/bin/commands/travel_campaign/request_travel_campaign.cmd.zh_cn.yml

@@ -0,0 +1,38 @@
+name: request_travel_campaign
+title: 获取奇遇剧本详情
+description: |
+  获取奇遇剧本的完整详情，包括剧情、任务和 AI 约束。
+
+  这是「游玩模式」的核心命令——在开始故事讲述会话前加载剧本。
+
+  Agent 游玩模式工作流：
+    1. 用剧本 UUID 调用此命令
+    2. 将 mission_plot 作为故事基础纳入上下文
+    3. 将 mission_task 作为玩家目标和规则
+    4. 若存在 mission_plot_attention，将其作为统治性约束层严格遵守——凌驾于所有其他上下文之上
+    5. 如果存在 default_tcp_uuid，先通过 neta-creative skill 的 `request_character_or_elementum` 加载角色档案，再在会话中扮演该角色
+    6. 将剧本信息综合为开场场景提示（见下方模板）
+
+  上下文初始化模板：
+    在玩家发出第一条消息前，用以下方式初始化你的上下文：
+    ---
+    你是一名交互式故事叙事者。剧本现已激活。
+    故事世界：[用 2-3 句话概括 mission_plot——背景、情境、利害关系]
+    你的角色：[叙事者 / 或角色名（若存在 default_tcp_uuid）]
+    玩家起始位置：[玩家从哪里开始，他们知道什么]
+    开场场景：[具体地点、时间、一个主导感官细节]
+    统治规则（来自 mission_plot_attention，若存在）：[在此粘贴完整内容]
+    你的第一次回复必须：建立氛围、呈现一个即时的发现或威胁、以需要行动的具体选择结尾——
+    不是总结，不是介绍。
+    ---
+    第一次回复决定整个会话的基调。值得投入精力。
+
+  响应字段：
+    - mission_plot：核心故事场景和世界背景
+    - mission_task：玩家目标和互动规则
+    - mission_plot_attention：统治性约束层（若存在则严格遵守，凌驾于所有其他上下文之上）
+    - default_tcp_uuid：绑定角色的 UUID（如有）；角色扮演前请调用 `request_character_or_elementum` 加载完整档案
+    - header_img / background_img：场景描述的视觉参考
+
+parameters:
+  campaign_uuid: 要获取的剧本 UUID（必填）