@artflo-ai/artflo-openclaw-plugin 0.0.3 → 0.0.4

package/dist/src/core/api/api-base.js

@@ -1,12 +1,2 @@
-/** HTTP API base URL (trailing slash stripped). */
-export function getApiBaseUrl(config) {
-    return config.apiBaseUrl.replace(/\/+$/, '');
-}
-/**
- * Derive the WebSocket URL from apiBaseUrl.
- *   https://webapi.artflo.ai → wss://webapi.artflo.ai/canvas/ws
- */
-export function getCanvasWsUrl(config) {
-    const hostname = new URL(config.apiBaseUrl).hostname;
-    return `wss://${hostname}/canvas/ws`;
-}
+// Re-export from api-paths for backward compatibility
+export { buildApiUrl, buildWsUrl, buildVipUrl, buildWebUrl } from './api-paths.js';

package/dist/src/core/api/api-paths.js

@@ -0,0 +1,31 @@
+/**
+ * All Artflo API paths in one place.
+ * Every HTTP/WS request in this plugin MUST use a path from here.
+ * Do NOT construct API URLs manually elsewhere.
+ */
+/** WebSocket */
+export const WS_CANVAS = '/canvas/ws';
+/** apiBaseUrl paths */
+export const API_CREATE_CANVAS = '/canvas';
+export const API_UPLOAD_FILE = '/storage/obs/starii';
+/** vipApiBaseUrl paths */
+export const API_VIP_INFO = '/h5/user/vip_info_by_group.json';
+/** webApiBaseUrl paths */
+export const API_CLIENT_PARAMS = '/api/subscribe-client-params';
+// ── Helper builders ─────────────────────────────────────────────────
+function strip(url) {
+    return url.replace(/\/+$/, '');
+}
+export function buildApiUrl(config, path) {
+    return `${strip(config.apiBaseUrl)}${path}`;
+}
+export function buildVipUrl(config, path) {
+    return `${strip(config.vipApiBaseUrl)}${path}`;
+}
+export function buildWebUrl(config, path) {
+    return `${strip(config.webApiBaseUrl)}${path}`;
+}
+export function buildWsUrl(config) {
+    const hostname = new URL(config.apiBaseUrl).hostname;
+    return `wss://${hostname}${WS_CANVAS}`;
+}

package/dist/src/core/api/upload-file.js

@@ -7,7 +7,7 @@
  */
 import { readFile } from 'node:fs/promises';
 import { basename } from 'node:path';
-import { getApiBaseUrl } from './api-base.js';
+import { buildApiUrl, API_UPLOAD_FILE } from '../api/api-paths.js';
 /**
  * Upload a local file or a remote URL to Artflo OBS.
  *
@@ -37,8 +37,7 @@ export async function uploadFile(config, source, filename) {
     }
     const formData = new FormData();
     formData.append('file', fileBlob, resolvedFilename);
-    const baseUrl = getApiBaseUrl(config);
-    const response = await fetch(`${baseUrl}/storage/obs/starii`, {
+    const response = await fetch(buildApiUrl(config, API_UPLOAD_FILE), {
         method: 'POST',
         headers: {
             'X-API-Key': config.apiKey,

package/dist/src/core/canvas/canvas-websocket-client.js

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'node:events';
 import WebSocket from 'ws';
-import { getCanvasWsUrl } from '../api/api-base.js';
+import { buildWsUrl } from '../api/api-paths.js';
 import { writeWsTrace } from './ws-trace.js';
 import { WS_ERROR, isJoinErrorMessage, isJoinSuccessMessage, isPushErrorMessage, isPushSuccessMessage, isSyncPushMessage, } from './types.js';
 export class CanvasWebSocketClient extends EventEmitter {
@@ -33,7 +33,7 @@ export class CanvasWebSocketClient extends EventEmitter {
         queryParams.set('country_code', params.countryCode || this.config.countryCode);
         queryParams.set('api_key', params.apiKey || this.config.apiKey);
         queryParams.set('canvas_id', params.canvasId);
-        return `${getCanvasWsUrl(this.config)}?${queryParams.toString()}`;
+        return `${buildWsUrl(this.config)}?${queryParams.toString()}`;
     }
     async connect(params) {
         if (this.connected) {

package/dist/src/core/canvas/create-canvas.js

@@ -1,14 +1,9 @@
 /**
  * Create a new Artflo canvas via the REST API.
- *
- * Derives the HTTP API base URL from the configured WebSocket URL:
- *   wss://prewebapi.artflo.ai/canvas/ws → https://prewebapi.artflo.ai
- *   wss://webapi.artflo.ai/canvas/ws    → https://webapi.artflo.ai
  */
-import { getApiBaseUrl } from '../api/api-base.js';
+import { buildApiUrl, buildWebUrl, API_CREATE_CANVAS } from '../api/api-paths.js';
 export async function createCanvas(config, name = 'Untitled') {
-    const baseUrl = getApiBaseUrl(config);
-    const response = await fetch(`${baseUrl}/canvas`, {
+    const response = await fetch(buildApiUrl(config, API_CREATE_CANVAS), {
         method: 'POST',
         headers: {
             'Content-Type': 'application/json',
@@ -24,14 +19,9 @@ export async function createCanvas(config, name = 'Untitled') {
         throw new Error(`Create canvas failed: code=${body.code}`);
     }
     const canvasId = body.data.id;
-    // Derive project URL from API host: prewebapi → pre.artflo.ai, webapi → artflo.ai
-    const hostname = new URL(baseUrl).hostname;
-    const projectHost = hostname.startsWith('prewebapi')
-        ? 'pre.artflo.ai'
-        : 'artflo.ai';
     return {
         id: canvasId,
         name: body.data.name ?? name,
-        url: `https://${projectHost}/project/${canvasId}`,
+        url: `${buildWebUrl(config, '/project/' + canvasId)}`,
     };
 }

package/dist/src/core/config/fetch-client-params.js

@@ -2,8 +2,9 @@
  * Fetch appKey, vipAppId, vipGroup from the subscribe-client-params API.
  * GET {webApiBaseUrl}/api/subscribe-client-params
  */
+import { API_CLIENT_PARAMS } from '../api/api-paths.js';
 export async function fetchClientParams(webApiBaseUrl) {
-    const url = `${webApiBaseUrl.replace(/\/+$/, '')}/api/subscribe-client-params`;
+    const url = `${webApiBaseUrl.replace(/\/+$/, '')}${API_CLIENT_PARAMS}`;
     const response = await fetch(url);
     if (!response.ok) {
         throw new Error(`fetchClientParams failed: HTTP ${response.status}`);

package/dist/src/core/config/fetch-vip-info.js

@@ -1,8 +1,9 @@
 /**
  * Fetch user VIP / subscription status from the Artflo subscription API.
  */
+import { buildVipUrl, API_VIP_INFO } from '../api/api-paths.js';
 export async function fetchVipInfo(config) {
-    const url = new URL(`${config.vipApiBaseUrl}/h5/user/vip_info_by_group.json`);
+    const url = new URL(buildVipUrl(config, API_VIP_INFO));
     url.searchParams.set('app_id', config.vipAppId);
     url.searchParams.set('vip_group', config.vipGroup);
     const response = await fetch(url.toString(), {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artflo-ai/artflo-openclaw-plugin",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "type": "module",
   "description": "OpenClaw plugin that connects directly to Artflo canvas WebSocket runtime.",
   "keywords": [

package/skills/artflo-canvas/SKILL.md

@@ -48,6 +48,7 @@ metadata:
 - 规划时不要臆造底层画布数字节点类型。应使用 plan 中的节点类型，例如 `input`、`refine`、`process`、`selector`、`batch`、`crop`。
 - 在假设画布运行时已就绪之前，先读取连接状态。
 - 将插件配置视为 WebSocket 凭证和连接默认值的唯一真实来源。
+- **禁止编造 API URL**：不要自行拼接或猜测 Artflo API 路径。所有 API 交互必须通过插件提供的 tool 完成（如 `artflo_canvas_create`、`artflo_upload_file` 等）。不要使用 `fetch` 或 `curl` 直接调用 Artflo API。
 - 当插件布局引擎可用时，不要手工编造节点坐标。
 
 ## 默认编辑规则

package/skills/artflo-canvas/references/planning-guide.md

@@ -8,7 +8,7 @@ Read `references/node-schema.json` first for node type constraints, then use thi
 Before executing any workflow, ensure you have a canvas:
 
 1. **No canvas id available**: Call `artflo_canvas_create` to create a new canvas. Use the returned `canvasId` for all subsequent operations. Share the `url` with the user so they can view the canvas.
-2. **Canvas id available**: Use the existing canvas. On the first task of each day, ask the user whether to create a new canvas or reuse the existing one. Show the link: `https://artflo.ai/project/{canvas_id}`.
+2. **Canvas id available**: Use the existing canvas. On the first task of each day, ask the user whether to create a new canvas or reuse the existing one. The canvas URL is returned by `artflo_canvas_create`.
 3. **User requests new canvas**: Call `artflo_canvas_create` immediately.
 
 ## Core Principle