@talesofai/neta-skills 0.14.0 → 0.14.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @neta/skills-neta
 
+## 0.14.1
+
+### Patch Changes
+
+- - Add api logs for debug.
+  - Add api timeout with 10000ms.
+
+  - Fixed error info about remove_background input_image param in docs.
+
 ## 0.14.0
 
 ### Minor Changes

package/bin/apis/index.js

@@ -1,5 +1,5 @@
-import axios from "axios";
-import { handleAxiosError } from "../utils/errors.js";
+import axios, { AxiosError } from "axios";
+import { catchErrorResponse, handleAxiosError } from "../utils/errors.js";
 import { createActivityApis } from "./activity.js";
 import { createArtifactApis } from "./artifact.js";
 import { createAudioApis } from "./audio.js";
@@ -19,14 +19,31 @@ import { createUserApis } from "./user.js";
 import { createVerseApis } from "./verse.js";
 export const createApis = (option) => {
     const baseUrl = option.baseUrl;
+    const logger = option.logger;
     const client = axios.create({
         adapter: "fetch",
         baseURL: baseUrl,
         headers: {
             ...option.headers,
         },
+        timeout: 10 * 1000,
     });
-    client.interceptors.response.use((response) => response, (error) => {
+    client.interceptors.request.use((config) => {
+        const now = Date.now();
+        config.start_time = now;
+        logger.debug("[api] request: %s %s", config.method, config.url);
+        return config;
+    });
+    client.interceptors.response.use((response) => {
+        const now = Date.now();
+        const startTime = response.config.start_time ?? now;
+        const duration = now - startTime;
+        logger.debug("[api] response: %s %s %s %dms", response.config.method, response.status, response.config.url, duration);
+        return response;
+    }, (error) => {
+        if (error instanceof AxiosError) {
+            logger.debug("[api] response error: %s %s %s %s", error.request?.method, error.request?.url, error.response?.status, catchErrorResponse(error.response?.data));
+        }
         handleAxiosError(error);
     });
     const tcp = createTcpApis(client);

package/bin/commands/character_elementum/list_my_characters.cmd.js

@@ -16,9 +16,8 @@ export const listMyCharacters = createCommand({
     title: meta.title,
     description: meta.description,
     inputSchema: listMyCharactersParameters,
-}, async ({ keyword, page_index, page_size }, { apis }) => {
+}, async ({ keyword, page_index, page_size }, { apis, user }) => {
     // Get current user info to obtain UUID
-    const user = await apis.user.me();
     if (!user) {
         throw new Error("Failed to get user info. Please check your NETA_TOKEN.");
     }

package/bin/commands/character_elementum/list_my_elementum.cmd.js

@@ -16,9 +16,8 @@ export const listMyElementum = createCommand({
     title: meta.title,
     description: meta.description,
     inputSchema: listMyElementumParameters,
-}, async ({ keyword, page_index, page_size }, { apis }) => {
+}, async ({ keyword, page_index, page_size }, { apis, user }) => {
     // Get current user info to obtain UUID
-    const user = await apis.user.me();
     if (!user) {
         throw new Error("Failed to get user info. Please check your NETA_TOKEN.");
     }

package/bin/commands/creative/remove_background.cmd.en_us.yml

@@ -2,6 +2,8 @@ remove_background:
   name: remove_background
   title: Remove Image Background
   description: Remove the background of an input image while preserving the main subject, and return an image with a transparent background.
+  parameters:
+    input_image: The UUID of the input image artifact.
 
 remove_background_nocrop:
   name: remove_background_nocrop

package/bin/commands/creative/remove_background.cmd.js

@@ -7,6 +7,9 @@ const meta = parseMeta(Type.Object({
         name: Type.String(),
         title: Type.String(),
         description: Type.String(),
+        parameters: Type.Object({
+            input_image: Type.String(),
+        }),
     }),
     remove_background_nocrop: Type.Object({
         name: Type.String(),
@@ -15,7 +18,9 @@ const meta = parseMeta(Type.Object({
     }),
 }), import.meta);
 const removeBackgroundV1Parameters = Type.Object({
-    input_image: Type.String(),
+    input_image: Type.String({
+        description: meta.remove_background.parameters.input_image,
+    }),
 });
 export const removeBackground = createCommand({
     name: meta.remove_background.name,
@@ -24,6 +29,13 @@ export const removeBackground = createCommand({
     inputSchema: removeBackgroundV1Parameters,
 }, async ({ input_image }, { apis, log }) => {
     const createTask = async () => {
+        const artifacts = await apis.artifact.artifactDetail([input_image]);
+        if (!artifacts ||
+            !artifacts[0] ||
+            artifacts[0].modality !== "PICTURE" ||
+            artifacts[0].status !== "SUCCESS") {
+            throw new Error("Input is not a valid picture artifact UUID");
+        }
         return apis.artifact.postProcess(input_image, "0_null/抠图SEG", {
             entrance: "PICTURE,CLI",
         });
@@ -52,6 +64,13 @@ export const removeBackgroundNoCrop = createCommand({
     inputSchema: removeBackgroundV1Parameters,
 }, async ({ input_image }, { apis, log }) => {
     const createTask = async () => {
+        const artifacts = await apis.artifact.artifactDetail([input_image]);
+        if (!artifacts ||
+            !artifacts[0] ||
+            artifacts[0].modality !== "PICTURE" ||
+            artifacts[0].status !== "SUCCESS") {
+            throw new Error("Input is not a valid picture artifact UUID");
+        }
         return apis.artifact.postProcess(input_image, "0_null/抠图SEG", {
             entrance: "PICTURE,CLI",
         });

package/bin/commands/creative/remove_background.cmd.zh_cn.yml

@@ -2,6 +2,8 @@ remove_background:
   name: remove_background
   title: 去除图片背景
   description: 输入图片保留主体去除背景，返回透明通道图片
+  parameters:
+    input_image: 输入图片的 artifact UUID。
 
 remove_background_nocrop:
   name: remove_background_nocrop

package/bin/commands/load.js

@@ -90,6 +90,7 @@ export const buildCommands = async (cli) => {
                 ? api_base_url
                 : (process.env["NETA_API_BASE_URL"] ?? "https://api.talesofai.com");
             const apis = createApis({
+                logger,
                 baseUrl,
                 headers: {
                     "x-token": process.env["NETA_TOKEN"] ?? "",
@@ -105,7 +106,7 @@ export const buildCommands = async (cli) => {
             const type = cmd.inputSchema ?? Type.Object({});
             const input = Value.Parse(type, args);
             if (IS_DEV) {
-                logger.debug("command: %s, params: %o", cmd.name, input);
+                logger.debug("[command] %s, params: %o", cmd.name, input);
             }
             const result = await cmd
                 .execute(input, {

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

@@ -17,11 +17,13 @@ export const getCurrentPremiumPlan = createCommand({
     name: meta.name,
     title: meta.title,
     description: meta.description,
-}, async (_, { apis }) => {
+}, async (_, { apis, user }) => {
     if (!apis.baseUrl.endsWith("talesofai.com")) {
         throw new Error("This command is not supported in the current region");
     }
-    const user = await apis.user.me();
+    if (!user) {
+        throw new Error("Not authenticated. Please check your NETA_TOKEN.");
+    }
     const level = user.properties?.vip_level ?? 0;
     return {
         plan: PlanningMap[level],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talesofai/neta-skills",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "Neta API pi coding agent skills for interacting with Neta API to generate images, videos, songs, and manage characters/elements.",
   "type": "module",
   "repository": {

package/skills/neta-creative/SKILL.md

@@ -52,7 +52,7 @@ Combine an audio track and video to create a full MV.
 **Remove background**
 
 ```bash
-npx -y @talesofai/neta-skills@latest remove_background --input_image "image_url"
+npx -y @talesofai/neta-skills@latest remove_background --input_image "image_artifact_uuid"
 ```
 
 ### Character queries

package/skills/neta-creative/references/image-generation.md

@@ -124,7 +124,7 @@ npx -y @talesofai/neta-skills@latest make_image --prompt "@character_name, shy e
 ### Background Removal
 
 ```bash
-npx -y @talesofai/neta-skills@latest remove_background --input_image "image_uuid"
+npx -y @talesofai/neta-skills@latest remove_background --input_image "image_artifact_uuid"
 ```
 ---
 

package/skills/zh_cn/neta-creative/SKILL.md

@@ -44,7 +44,7 @@ npx -y @talesofai/neta-skills@latest make_song --prompt "风格描述" --lyrics
 
 **移除背景**
 ```bash
-npx -y @talesofai/neta-skills@latest remove_background --input_image "image_url"
+npx -y @talesofai/neta-skills@latest remove_background --input_image "image_artifact_uuid"
 ```
 
 ### 角色查询

package/skills/zh_cn/neta-creative/references/image-generation.md

@@ -124,7 +124,7 @@ npx -y @talesofai/neta-skills@latest make_image --prompt "@角色名，害羞表
 ### 去背景（抠图）
 
 ```bash
-npx -y @talesofai/neta-skills@latest remove_background --input_image "image_uuid"
+npx -y @talesofai/neta-skills@latest remove_background --input_image "image_artifact_uuid"
 ```
 ---