@talesofai/neta-skills 0.6.0

package/bin/commands/community/create_comment.cmd.js

@@ -0,0 +1,40 @@
+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(),
+}), import.meta);
+export const createCommentCmd = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: Type.Object({
+        content: Type.String({ minLength: 1, maxLength: 500 }),
+        parent_uuid: Type.String(),
+        parent_type: Type.Union([Type.Literal("collection")]),
+        at_users: Type.String({ default: "" }),
+    }),
+}, async ({ content, parent_uuid, parent_type, at_users }, { apis }) => {
+    const atUsersArray = at_users
+        ? at_users
+            .split(",")
+            .map((uuid) => uuid.trim())
+            .filter(Boolean)
+        : [];
+    const result = await apis.collection.createComment({
+        content,
+        parent_uuid,
+        parent_type,
+        at_users: atUsersArray,
+    });
+    if (!result.success) {
+        throw new Error("create_comment fail");
+    }
+    return {
+        success: true,
+        comment_uuid: result.comment?.uuid,
+        message: "create_comment success",
+    };
+});

package/bin/commands/community/create_comment.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: create_comment
+title: 评论作品、角色、元素
+description: 对作品 (collection)、角色 (character)、元素 (elementum) 进行评论评论

package/bin/commands/community/favor_collection.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: favor_collection
+title: Favorite/Unfavorite Collection
+description: Mark a collection as favorite or remove it from favorites.
+

package/bin/commands/community/favor_collection.cmd.js

@@ -0,0 +1,29 @@
+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(),
+}), import.meta);
+export const favorCollectionCmd = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: Type.Object({
+        uuid: Type.String(),
+        is_cancel: Type.Boolean({
+            default: false,
+        }),
+    }),
+}, async ({ uuid, is_cancel }, { apis }) => {
+    const action = is_cancel ? "cancel_favor" : "favor";
+    const result = await apis.collection.favorCollection(uuid, { is_cancel });
+    if (!result.success) {
+        throw new Error(`${action} fail`);
+    }
+    return {
+        success: true,
+        message: `${action} success`,
+    };
+});

package/bin/commands/community/favor_collection.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: favor_collection
+title: 收藏作品&取消收藏
+description: 对作品进行收藏或取消收藏操作

package/bin/commands/community/get_fan_list.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: get_fan_list
+title: Get Fans List
+description: Retrieve the list of followers (fans) of the current user, with pagination support.
+

package/bin/commands/community/get_fan_list.cmd.js

@@ -0,0 +1,36 @@
+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(),
+}), import.meta);
+export const getFanListCmd = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: Type.Object({
+        page_index: Type.Integer({ minimum: 0, default: 0 }),
+        page_size: Type.Integer({ minimum: 1, maximum: 50, default: 20 }),
+    }),
+}, async ({ page_index, page_size }, { apis }) => {
+    const result = await apis.user.getFanList({
+        page_index,
+        page_size,
+    });
+    return {
+        total: result.total,
+        page_index: result.page_index,
+        page_size: result.page_size,
+        list: result.list.map((user) => ({
+            uuid: user.uuid,
+            name: user.name,
+            avatar_url: user.avatar_url,
+            total_fans: user.total_fans,
+            total_collections: user.total_collections,
+            subscribe_status: user.subscribe_status,
+        })),
+        has_next: result.has_next,
+    };
+});

package/bin/commands/community/get_fan_list.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: get_fan_list
+title: 获取粉丝列表
+description: 获取当前用户的粉丝列表，支持分页

package/bin/commands/community/get_hashtag_characters.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: get_hashtag_characters
+title: Get Characters Under Hashtag
+description: Retrieve the list of characters associated with a given hashtag.
+

package/bin/commands/community/get_hashtag_characters.cmd.js

@@ -0,0 +1,46 @@
+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(),
+}), import.meta);
+const fetchCharactersByHashtagV1Parameters = Type.Object({
+    hashtag: Type.String(),
+    page_index: Type.Integer({ minimum: 0, default: 0 }),
+    page_size: Type.Integer({ minimum: 1, maximum: 100, default: 20 }),
+    sort_by: Type.Union([Type.Literal("hot"), Type.Literal("newest")], {
+        default: "hot",
+    }),
+    parent_type: Type.Optional(Type.Union([Type.Literal("oc"), Type.Literal("elementum")])),
+});
+export const getHashtagCharacters = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: fetchCharactersByHashtagV1Parameters,
+}, async ({ hashtag, page_index, page_size, sort_by, parent_type }, { apis }) => {
+    const result = await apis.hashtag.fetchCharactersByHashtag(hashtag, {
+        page_index,
+        page_size,
+        sort_by,
+        parent_type,
+    });
+    const simplifiedList = result.list.map((char) => ({
+        uuid: char.uuid,
+        name: char.name,
+        short_name: char.short_name,
+        avatar_img: char.config?.avatar_img || null,
+        ctime: char.ctime,
+        creator_uuid: char.creator?.uuid,
+        creator_name: char.creator?.nick_name,
+    }));
+    return {
+        total: result.total,
+        page_index: result.page_index,
+        page_size: result.page_size,
+        list: simplifiedList,
+        has_next: result.has_next,
+    };
+});

package/bin/commands/community/get_hashtag_characters.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: get_hashtag_characters
+title: 获取hashtag下的角色列表
+description: 获取hashtag下的角色列表

package/bin/commands/community/get_hashtag_collections.cmd.en_us.yml

@@ -0,0 +1,6 @@
+name: get_hashtag_collections
+title: Get Featured Collections Under Hashtag
+description: Retrieve featured collections associated with a given hashtag.
+errors:
+  no_activity_space: Hashtag "{hashtag}" is not linked to any activity space.
+

package/bin/commands/community/get_hashtag_collections.cmd.js

@@ -0,0 +1,54 @@
+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(),
+    errors: Type.Object({
+        no_activity_space: Type.String(),
+    }),
+}), import.meta);
+const fetchSelectedCollectionsByHashtagV1Parameters = Type.Object({
+    hashtag: Type.String(),
+    page_index: Type.Integer({ minimum: 0, default: 0 }),
+    page_size: Type.Integer({ minimum: 1, maximum: 100, default: 20 }),
+    sort_by: Type.Union([Type.Literal("highlight_mark_time")], {
+        default: "highlight_mark_time",
+    }),
+});
+export const getHashtagCollections = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: fetchSelectedCollectionsByHashtagV1Parameters,
+}, async ({ hashtag, page_index = 0, page_size = 20, sort_by = "highlight_mark_time", }, { apis }) => {
+    // 通过hashtag获取对应的activity_uuid
+    const hashtagResult = await apis.hashtag.fetchHashtag(hashtag);
+    const activityDetail = hashtagResult?.activity_detail;
+    const activity_uuid = activityDetail?.uuid;
+    if (!activity_uuid) {
+        throw new Error(meta.errors.no_activity_space.replace("{hashtag}", String(hashtag ?? "").trim()));
+    }
+    const result = await apis.activity.fetchSelectedCollections(activity_uuid, {
+        page_index,
+        page_size,
+        sort_by,
+    });
+    // 转换API返回结果为工具输出格式
+    const simplifiedList = (result.list || []).map((collection) => ({
+        uuid: collection.storyId,
+        name: collection.name,
+        coverUrl: collection.coverUrl,
+        creator_name: collection.user_nick_name,
+        likeCount: collection.likeCount,
+        sameStyleCount: collection.sameStyleCount,
+        ctime: collection.ctime,
+    }));
+    return {
+        total: result.total,
+        page_index: result.page_index,
+        page_size: result.page_size,
+        list: simplifiedList,
+    };
+});

package/bin/commands/community/get_hashtag_collections.cmd.zh_cn.yml

@@ -0,0 +1,5 @@
+name: get_hashtag_collections
+title: 获取hashtag下的精选玩法
+description: 获取hashtag下的精选玩法
+errors:
+  no_activity_space: Hashtag "{hashtag}" 未关联任何活动空间

package/bin/commands/community/get_hashtag_info.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: get_hashtag_info
+title: Get Hashtag/Space Info
+description: Retrieve detailed information for a hashtag or space.
+

package/bin/commands/community/get_hashtag_info.cmd.js

@@ -0,0 +1,42 @@
+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(),
+}), import.meta);
+const fetchHashtagV1Parameters = Type.Object({
+    hashtag: Type.String(),
+});
+export const getHashtagInfo = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: fetchHashtagV1Parameters,
+}, async ({ hashtag }, { apis }) => {
+    const result = await apis.hashtag.fetchHashtag(hashtag);
+    // 转换API返回结果为工具输出格式
+    const activityDetail = result["activity_detail"];
+    const simplifiedActivityDetail = activityDetail
+        ? {
+            uuid: activityDetail.uuid,
+            title: activityDetail.title,
+            banner_pic: activityDetail.banner_pic,
+            creator_name: activityDetail.creator_name,
+            review_users: activityDetail.review_users?.map((user) => ({
+                uuid: user.uuid,
+                name: user.name,
+            })) ?? null,
+        }
+        : null;
+    return {
+        hashtag: {
+            name: result.name,
+            lore: result.lore || [],
+            activity_detail: simplifiedActivityDetail,
+            hashtag_heat: result.hashtag_heat,
+            subscribe_count: result.subscribe_count,
+        },
+    };
+});

package/bin/commands/community/get_hashtag_info.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: get_hashtag_info
+title: 获取hashtag/空间详情
+description: 获取hashtag/空间详情

package/bin/commands/community/get_subscribe_list.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: get_subscribe_list
+title: Get Following List
+description: Retrieve the list of users that the current user is following, with pagination support.
+

package/bin/commands/community/get_subscribe_list.cmd.js

@@ -0,0 +1,36 @@
+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(),
+}), import.meta);
+export const getSubscribeListCmd = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: Type.Object({
+        page_index: Type.Integer({ minimum: 0, default: 0 }),
+        page_size: Type.Integer({ minimum: 1, maximum: 50, default: 20 }),
+    }),
+}, async ({ page_index, page_size }, { apis }) => {
+    const result = await apis.user.getSubscribeList({
+        page_index,
+        page_size,
+    });
+    return {
+        total: result.total,
+        page_index: result.page_index,
+        page_size: result.page_size,
+        list: result.list.map((user) => ({
+            uuid: user.uuid,
+            name: user.name,
+            avatar_url: user.avatar_url,
+            total_fans: user.total_fans,
+            total_collections: user.total_collections,
+            subscribe_status: user.subscribe_status,
+        })),
+        has_next: result.has_next,
+    };
+});

package/bin/commands/community/get_subscribe_list.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: get_subscribe_list
+title: 获取关注列表
+description: 获取当前用户关注的用户列表，支持分页

package/bin/commands/community/like_collection.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: like_collection
+title: Like/Unlike Collection
+description: Like a collection or remove a like from it.
+

package/bin/commands/community/like_collection.cmd.js

@@ -0,0 +1,29 @@
+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(),
+}), import.meta);
+export const likeCollectionCmd = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: Type.Object({
+        uuid: Type.String(),
+        is_cancel: Type.Boolean({
+            default: false,
+        }),
+    }),
+}, async ({ uuid, is_cancel }, { apis }) => {
+    const action = is_cancel ? "unliked" : "liked";
+    const success = await apis.collection.likeCollection(uuid, { is_cancel });
+    if (!success) {
+        throw new Error(`${action} fail`);
+    }
+    return {
+        success: true,
+        message: `${action} success`,
+    };
+});

package/bin/commands/community/like_collection.cmd.zh_cn.yml

@@ -0,0 +1,4 @@
+name: like_collection
+title: 作品点赞&取消点赞
+description: 对作品进行点赞或取消点赞操作
+

package/bin/commands/community/list_space_topics.cmd.en_us.yml

@@ -0,0 +1,7 @@
+name: list_space_topics
+title: List Topics in Space
+description: List topics (sub‑spaces) within a space.
+
+parameters:
+  space_uuid: UUID of the space.
+

package/bin/commands/community/list_space_topics.cmd.js

@@ -0,0 +1,39 @@
+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({
+        space_uuid: Type.String(),
+    }),
+}), import.meta);
+export const listSpaceTopics = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: Type.Object({
+        space_uuid: Type.String(),
+    }),
+}, async ({ space_uuid }, { apis }) => {
+    const spaceConfigs = await apis.space.spaceConfigs();
+    const topics = await apis.space
+        .topics(space_uuid)
+        .then(({ primary_topic, topics }) => {
+        return {
+            primary_topic,
+            topics: topics.map((topic) => {
+                const { curated_works, ...config } = spaceConfigs[topic.hashtag_name] ?? {};
+                return {
+                    ...topic,
+                    ...config,
+                    official_collections: curated_works,
+                };
+            }),
+        };
+    });
+    return {
+        topics,
+    };
+});

package/bin/commands/community/list_space_topics.cmd.zh_cn.yml

@@ -0,0 +1,6 @@
+name: list_space_topics
+title: 获取空间内话题（子空间）
+description: 获取空间内话题（子空间）
+
+parameters:
+  space_uuid: 空间UUID

package/bin/commands/community/list_spaces.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: list_spaces
+title: List Spaces
+description: Retrieve all available spaces.
+

package/bin/commands/community/list_spaces.cmd.js

@@ -0,0 +1,19 @@
+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(),
+}), import.meta);
+export const listSpaces = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+}, async (_, { apis }) => {
+    const spaceHashtags = await apis.space.spaceHashtags();
+    const spaces = await Promise.all(spaceHashtags.map((hashtag) => apis.space.basic(hashtag))).then((spaces) => spaces.filter((space) => space?.space_uuid));
+    return {
+        spaces,
+    };
+});

package/bin/commands/community/list_spaces.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: list_spaces
+title: 获取全部空间
+description: 获取全部空间

package/bin/commands/community/read_collection.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: read_collection
+title: Read Collection
+description: Read detailed information about a collection or interactive experience.
+

package/bin/commands/community/read_collection.cmd.js

@@ -0,0 +1,83 @@
+import { Type } from "@sinclair/typebox";
+import { isVerseCTA } from "../../apis/collection.js";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const mete = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+}), import.meta);
+export const readCollectionCmd = createCommand({
+    name: mete.name,
+    title: mete.title,
+    description: mete.description,
+    inputSchema: Type.Object({
+        uuid: Type.String(),
+    }),
+}, async ({ uuid }, { apis }) => {
+    const res = await apis.feeds.interactiveItem({ collection_uuid: uuid });
+    if (!res || res.template_id !== "NORMAL") {
+        throw new Error(`Collection "${uuid}" not found`);
+    }
+    const name = res.json_data.name;
+    const description = res.json_data.description ?? "";
+    const creator = {
+        uuid: res.json_data.creator.uuid,
+        name: res.json_data.creator.nick_name,
+    };
+    const artifacts = res.json_data.displayData?.pages.flatMap((page) => page.images.map((image) => ({
+        uuid: image.uuid,
+        url: image.url,
+        modality: image.modality,
+        status: image.status,
+        image_detail: image.image_detail,
+        video_detail: image.video_detail,
+    })));
+    const tags = await apis.feeds
+        .tags(uuid)
+        .then((res) => res.map((tag) => ({
+        name: tag.name,
+        type: tag.type,
+        participants_count: tag.participants_count,
+        header_pic_url: tag.header_pic_url,
+    })))
+        .catch(() => []);
+    const remix = await (async () => {
+        const cta = res.json_data.cta_info;
+        const verse_uuid = isVerseCTA(cta)
+            ? (cta.interactive_config?.verse_uuid ?? null)
+            : null;
+        const verse = verse_uuid
+            ? await apis.verse.versePreset(verse_uuid).catch(() => null)
+            : null;
+        const preset_description = verse?.preset_description ?? null;
+        const reference_planning = verse?.reference_planning ?? null;
+        if (isVerseCTA(cta)) {
+            const { interactive_config, interactive_status: _, type: __, ...rest } = cta;
+            if (!interactive_config?.verse_uuid)
+                return null;
+            const verse = await apis.verse
+                .versePreset(interactive_config.verse_uuid)
+                .catch(() => null);
+            if (!verse)
+                return null;
+            return {
+                ...rest,
+                preset_description,
+                reference_planning,
+            };
+        }
+        return null;
+    })();
+    return {
+        collection: {
+            uuid,
+            name,
+            description,
+            creator,
+            artifacts,
+            tags,
+            remix,
+        },
+    };
+});

package/bin/commands/community/read_collection.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: read_collection
+title: 读取玩法信息
+description: 读取玩法信息

package/bin/commands/community/request_interactive_feed.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: request_interactive_feed
+title: Get Interactive Feed
+description: Retrieve interactive content feeds with pagination and multiple filter options, automatically inferring the scenario (home, profile, related feed, etc.) from parameters.
+

package/bin/commands/community/request_interactive_feed.cmd.js

@@ -0,0 +1,54 @@
+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(),
+}), import.meta);
+export const requestInteractiveFeedInputSchema = Type.Object({
+    page_index: Type.Integer({ minimum: 0, default: 0 }),
+    page_size: Type.Integer({ minimum: 1, maximum: 40, default: 20 }),
+    biz_trace_id: Type.Optional(Type.String()),
+    scene: Type.String({ default: "agent_intent" }),
+    collection_uuid: Type.Optional(Type.String()),
+    target_collection_uuid: Type.Optional(Type.String()),
+    target_user_uuid: Type.Optional(Type.String()),
+});
+// 复用 collection.ts 中的类型定义
+export const requestInteractiveFeedOutputSchema = Type.Object({
+    module_list_header: Type.Null(),
+    module_list: Type.Array(Type.Object({
+        data_id: Type.String(),
+        module_id: Type.String(),
+        template_id: Type.String(),
+        json_data: Type.Record(Type.String(), Type.Unknown()),
+    })),
+    page_data: Type.Object({
+        page_index: Type.Optional(Type.Number()),
+        page_size: Type.Optional(Type.Number()),
+        has_next_page: Type.Optional(Type.Boolean()),
+        biz_trace_id: Type.Optional(Type.String()),
+    }),
+});
+export const requestInteractiveFeed = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: requestInteractiveFeedInputSchema,
+}, async (params, { apis }) => {
+    const result = await apis.feeds.interactiveList({
+        page_index: params.page_index,
+        page_size: params.page_size,
+        biz_trace_id: params.biz_trace_id,
+        scene: params.scene,
+        collection_uuid: params.collection_uuid,
+        target_collection_uuid: params.target_collection_uuid,
+        target_user_uuid: params.target_user_uuid,
+    });
+    return {
+        module_list_header: result.module_list_header,
+        module_list: result.module_list,
+        page_data: result.page_data,
+    };
+});

package/bin/commands/community/request_interactive_feed.cmd.zh_cn.yml

@@ -0,0 +1,5 @@
+name: request_interactive_feed
+title: 获取互动推荐列表
+description: 获取互动内容推荐列表，支持分页和多种筛选参数。根据传入参数自动判断场景（首页/个人主页/相关性 Feed 等）。
+
+

package/bin/commands/community/subscribe_user.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: subscribe_user
+title: Follow/Unfollow User
+description: Follow or unfollow a user.
+