@insta-dev01/insta-plugin-openclaw 1.0.0 → 1.0.2

package/index.ts

@@ -1,198 +0,0 @@
-import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-import { plugin } from "./src/channel/index.js";
-import { getPluginProfileToolFactory } from "./src/tools/get-plugin-profile.js";
-import { uploadArtifactToolFactory } from "./src/tools/upload-artifact.js";
-import { registerIdentityToolFactory } from "./src/tools/register-identity.js";
-import { proposeRegistrationToolFactory } from "./src/tools/propose-registration.js";
-import { listTasksToolFactory } from "./src/tools/list-tasks.js";
-import { grabTaskToolFactory } from "./src/tools/grab-task.js";
-import { submitDeliverableToolFactory } from "./src/tools/submit-deliverable.js";
-import { getPendingRegistration, clearPendingRegistration, getBaseDir } from "./src/channel/registration-store.js";
-import { registerIdentity, type RegisterIdentityParams } from "./src/core/register-identity.js";
-
-// ── Registration confirmation control UI schema ───────────────────────────────
-
-const REGISTRATION_FORM_SCHEMA = {
-  type: "object",
-  description: "InstaClaw 服务注册参数（可在此修改后点击确认注册）",
-  properties: {
-    name: {
-      type: "string",
-      description: "档案名称",
-    },
-    avatar: {
-      type: "string",
-      description: "头像图片 URL",
-    },
-    description: {
-      type: "string",
-      description: "服务描述",
-    },
-    hourly_rate: {
-      type: "number",
-      description: "时薪（元，必须 > 0）",
-      minimum: 0.01,
-    },
-    scene_tags: {
-      type: "array",
-      items: { type: "string" },
-      description: "场景标签 ID 数组（1-3 个）",
-      minItems: 1,
-      maxItems: 3,
-    },
-    custom_tags: {
-      type: "array",
-      items: { type: "string" },
-      description: "自定义标签（可选）",
-    },
-    instance_type: {
-      type: "number",
-      enum: [0, 1],
-      description: "实例类型：0 = 本地实例，1 = 影子实例",
-    },
-  },
-  required: ["name", "avatar", "description", "hourly_rate", "scene_tags", "instance_type"],
-};
-
-// ── Plugin entry ──────────────────────────────────────────────────────────────
-
-export default definePluginEntry({
-  id: "insta-plugin-openclaw",
-  name: "insta-plugin-openclaw",
-  description: "Instagram Claw Connector",
-  register(api) {
-    // ── Tools ────────────────────────────────────────────────────────────────
-
-    // 注册档案（首次启动时由注册向导自动调用）
-    api.registerTool(registerIdentityToolFactory);
-
-    // AI 提案工具：生成注册参数并暂存，等待用户在控制面板确认
-    api.registerTool(proposeRegistrationToolFactory);
-
-    // 注册插件配置/注册状态查询工具
-    api.registerTool(getPluginProfileToolFactory);
-
-    // 注册制品文件上传工具
-    api.registerTool(uploadArtifactToolFactory);
-
-    // 注册任务池查询工具
-    api.registerTool(listTasksToolFactory);
-
-    // 注册任务抢单工具
-    api.registerTool(grabTaskToolFactory);
-
-    // 注册任务产物打包提交工具
-    api.registerTool(submitDeliverableToolFactory);
-
-    // ── Session state extension ──────────────────────────────────────────────
-    //
-    // Projects the in-memory pending registration record into the Gateway
-    // session snapshot so clients can read it via session.pluginExtensions.
-    // The control UI descriptor below reads this projection to pre-fill the
-    // confirmation form.
-
-    api.session.state.registerSessionExtension({
-      namespace: "instaclaw_registration",
-      description: "InstaClaw 待确认注册信息。当 AI 生成注册提案后此字段会被填充，用户确认后清除。",
-      project: (_ctx) => {
-        const pending = getPendingRegistration();
-        if (!pending) return undefined;
-        // Expose status + params so the client UI can pre-fill the form fields.
-        // Cast through `unknown` to satisfy the recursive PluginJsonValue constraint.
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return {
-          status: pending.status as string,
-          createdAt: pending.createdAt,
-          params: pending.params as unknown as Record<string, string | number | boolean | null>,
-        } as unknown as any; // PluginJsonValue is a recursive type; `any` avoids deep mismatch
-      },
-    });
-
-    // ── Control UI descriptor ────────────────────────────────────────────────
-    //
-    // Declares a settings-surface widget that the Gateway client renders when
-    // `instaclaw_registration.status === "pending_confirmation"`.
-    // The user can edit the pre-filled fields before submitting.
-
-    api.session.controls.registerControlUiDescriptor({
-      id: "instaclaw-registration-confirm",
-      surface: "settings",
-      label: "InstaClaw 服务注册",
-      description: "AI 已根据当前 Agent 上下文推荐了一套注册参数，请确认或修改后点击「确认注册」完成注册。",
-      schema: REGISTRATION_FORM_SCHEMA,
-    });
-
-    // ── Gateway method: confirm registration ─────────────────────────────────
-    //
-    // Called by the client UI when the user clicks "确认注册".
-    // `params` contains the (possibly edited) registration fields from the form.
-    // Falls back to the in-memory pending params for any missing fields so the
-    // form can send only the fields the user changed.
-
-    api.registerGatewayMethod(
-      "instaclaw.registration.submit",
-      async (opts) => {
-        const { params, respond } = opts;
-
-        const pending = getPendingRegistration();
-
-        // Merge: form-provided values take precedence over the stored proposal.
-        const merged: RegisterIdentityParams = {
-          name: (params["name"] as string | undefined) ?? pending?.params.name ?? "",
-          avatar: (params["avatar"] as string | undefined) ?? pending?.params.avatar ?? "",
-          description: (params["description"] as string | undefined) ?? pending?.params.description ?? "",
-          hourly_rate: (params["hourly_rate"] as number | undefined) ?? pending?.params.hourly_rate ?? 0,
-          scene_tags: (params["scene_tags"] as string[] | undefined) ?? pending?.params.scene_tags ?? [],
-          custom_tags: (params["custom_tags"] as string[] | undefined) ?? pending?.params.custom_tags,
-          instance_type: ((params["instance_type"] as number | undefined) ?? pending?.params.instance_type ?? 0) as 0 | 1,
-        };
-
-        // Basic guard: require at least the mandatory fields to be non-empty.
-        if (!merged.name || !merged.avatar || !merged.description || merged.hourly_rate <= 0 || merged.scene_tags.length === 0) {
-          respond(false, undefined, {
-            code: "INVALID_PARAMS",
-            message: "注册参数不完整，name / avatar / description / hourly_rate / scene_tags 均为必填项。",
-          });
-          return;
-        }
-
-        // Bug 1 fix: use the baseDir cached by startAccount instead of
-        // process.cwd(), which may point to a different directory.
-        const baseDir = getBaseDir();
-        let result: Awaited<ReturnType<typeof registerIdentity>>;
-
-        try {
-          result = await registerIdentity(merged, baseDir);
-        } catch (err) {
-          respond(false, undefined, {
-            code: "REGISTRATION_EXCEPTION",
-            message: err instanceof Error ? err.message : String(err),
-          });
-          return;
-        }
-
-        if (!result.success) {
-          respond(false, undefined, {
-            code: "REGISTRATION_FAILED",
-            message: result.error ?? "注册失败，请重试。",
-          });
-          return;
-        }
-
-        // Success: clear pending state so the confirmation UI disappears.
-        clearPendingRegistration();
-
-        respond(true, {
-          app_key: result.data?.app_key,
-          claw_id: result.data?.claw_id,
-          message: "注册成功 ✓ InstaClaw channel 将在 10 秒内自动建立 WebSocket 连接。",
-        });
-      },
-    );
-
-    // ── Channel ──────────────────────────────────────────────────────────────
-
-    // 注册引态平台 WebSocket 通道
-    api.registerChannel({ plugin });
-  },
-});

package/src/channel/config.ts

@@ -1,27 +0,0 @@
-export const CHANNEL_ID = "insta-connector" as const;
-
-export const HEARTBEAT_INTERVAL = parseInt(
-  process.env["INSTACLAW_HEARTBEAT_INTERVAL"] ?? "30000",
-  10,
-);
-
-export const MAX_RECONNECT_ATTEMPTS = 0; // 0 = infinite
-
-export const SDK_REQUEST_TIMEOUT = parseInt(
-  process.env["SDK_REQUEST_TIMEOUT"] ?? "43200000", // 12 hours
-  10,
-);
-
-export const MAX_CONCURRENT_REQUESTS = parseInt(
-  process.env["MAX_CONCURRENT_REQUESTS"] ?? "10",
-  10,
-);
-
-export const TEXT_CHUNK_SIZE = 50;
-
-export const DEBUG_ENABLED = process.env["INSTA_DEBUG"] === "true";
-
-export const POLL_INTERVAL_MS = parseInt(
-  process.env["INSTA_POLL_INTERVAL_MS"] ?? "10000",
-  10,
-);

package/src/channel/connection.ts

@@ -1,341 +0,0 @@
-import WebSocket from "ws";
-import type { ConnectionConfig, ConnectionState } from "./types.js";
-import type { DebugLogger } from "./logger.js";
-
-// ── WebSocketConnection ───────────────────────────────────────────────────────
-
-export class WebSocketConnection {
-  private ws: WebSocket | null = null;
-  private state: ConnectionState = "disconnected";
-  private reconnectAttempts = 0;
-  private heartbeatTimer: NodeJS.Timeout | null = null;
-  private lastPongTime = 0;
-  private isStopped = false;
-  private isReconnecting = false;
-
-  constructor(
-    private config: ConnectionConfig,
-    private logger: DebugLogger,
-    private onMessage: (data: string) => void,
-    private onStateChange: (state: ConnectionState) => void,
-  ) {}
-
-  async connect(accountId?: string): Promise<void> {
-    this.updateState("connecting");
-    this.logger.info("Establishing WebSocket connection", { url: this.config.wsUrl });
-
-    try {
-      this.ws = new WebSocket(this.config.wsUrl, {
-        headers: {
-          "x-app-key": this.config.clientId,
-          "x-app-secret": this.config.clientSecret,
-        },
-      });
-
-      this.setupEventListeners();
-      await this.waitForOpen();
-
-      this.updateState("connected");
-      this.reconnectAttempts = 0;
-      this.logger.info("WebSocket connected");
-
-      if (accountId) {
-        const { registerConnection } = await import("./index.js");
-        registerConnection(accountId, this.ws);
-      }
-
-      this.startHeartbeat();
-    } catch (err) {
-      this.logger.error("Failed to connect", err as Error, { url: this.config.wsUrl });
-      this.handleReconnect();
-      throw err;
-    }
-  }
-
-  private waitForOpen(): Promise<void> {
-    return new Promise((resolve, reject) => {
-      if (!this.ws) return reject(new Error("WebSocket not created"));
-
-      const timeout = setTimeout(() => reject(new Error("Connection timeout")), 10_000);
-
-      this.ws.once("open", () => { clearTimeout(timeout); resolve(); });
-      this.ws.once("error", (err) => { clearTimeout(timeout); reject(err); });
-    });
-  }
-
-  private setupEventListeners(): void {
-    if (!this.ws) return;
-
-    this.ws.on("message", (data: WebSocket.Data) => {
-      try {
-        this.onMessage(data.toString());
-      } catch (err) {
-        this.logger.error("Error processing message", err as Error);
-      }
-    });
-
-    this.ws.on("pong", () => { this.lastPongTime = Date.now(); });
-
-    this.ws.on("close", (code, reason) => {
-      this.logger.info("WebSocket closed", { code, reason: reason.toString(), intentional: this.isStopped });
-      this.stopHeartbeat();
-      this.updateState("disconnected");
-      if (!this.isStopped) this.handleReconnect();
-    });
-
-    this.ws.on("error", (err) => {
-      this.logger.error("WebSocket error", err, { state: this.state });
-    });
-  }
-
-  async disconnect(accountId?: string): Promise<void> {
-    this.isStopped = true;
-    this.stopHeartbeat();
-
-    if (accountId) {
-      try {
-        const { unregisterConnection } = await import("./index.js");
-        unregisterConnection(accountId);
-      } catch (err) {
-        this.logger.warn("Failed to unregister connection", { accountId, error: (err as Error).message });
-      }
-    }
-
-    if (this.ws) {
-      this.ws.removeAllListeners();
-      if (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING) {
-        this.ws.close();
-      }
-      this.ws = null;
-    }
-
-    this.updateState("disconnected");
-    this.logger.info("WebSocket disconnected");
-  }
-
-  // ── Heartbeat ───────────────────────────────────────────────────────────────
-
-  private startHeartbeat(): void {
-    this.stopHeartbeat();
-    this.lastPongTime = Date.now();
-
-    this.heartbeatTimer = setInterval(() => {
-      if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
-
-      const timeSinceLastPong = Date.now() - this.lastPongTime;
-      const threshold = this.config.heartbeatInterval * 3;
-
-      if (timeSinceLastPong > threshold) {
-        this.logger.warn("Heartbeat timeout, reconnecting", { timeSinceLastPong, threshold });
-        this.stopHeartbeat();
-        this.handleReconnect();
-        return;
-      }
-
-      try {
-        this.ws.ping();
-      } catch (err) {
-        this.logger.error("Ping failed", err as Error);
-        this.stopHeartbeat();
-        this.handleReconnect();
-      }
-    }, this.config.heartbeatInterval);
-  }
-
-  private stopHeartbeat(): void {
-    if (this.heartbeatTimer) {
-      clearInterval(this.heartbeatTimer);
-      this.heartbeatTimer = null;
-    }
-  }
-
-  // ── Reconnection ────────────────────────────────────────────────────────────
-
-  private async handleReconnect(): Promise<void> {
-    if (this.isReconnecting || this.isStopped) return;
-
-    const max = this.config.reconnectMaxAttempts;
-    if (max && max > 0 && this.reconnectAttempts >= max) {
-      this.logger.warn("Max reconnect attempts reached", { attempts: this.reconnectAttempts });
-      return;
-    }
-
-    this.isReconnecting = true;
-    this.updateState("reconnecting");
-
-    const delay = Math.min(1000 * Math.pow(2, this.reconnectAttempts), 30_000) + Math.random() * 1000;
-    this.reconnectAttempts++;
-    this.logger.info("Reconnecting", { attempt: this.reconnectAttempts, delay: Math.round(delay) });
-
-    await new Promise((r) => setTimeout(r, delay));
-
-    if (this.ws) {
-      this.ws.removeAllListeners();
-      if (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING) {
-        this.ws.close();
-      }
-      this.ws = null;
-    }
-
-    this.isReconnecting = false;
-
-    try {
-      await this.connect();
-    } catch {
-      // connect() will schedule another reconnect internally
-    }
-  }
-
-  // ── Send / State ────────────────────────────────────────────────────────────
-
-  send(data: string): void {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-      throw new Error("WebSocket is not connected");
-    }
-    this.ws.send(data);
-  }
-
-  getState(): ConnectionState { return this.state; }
-  isConnected(): boolean { return this.state === "connected" && this.ws?.readyState === WebSocket.OPEN; }
-  getWebSocket(): WebSocket | null { return this.ws; }
-
-  private updateState(newState: ConnectionState): void {
-    if (this.state !== newState) {
-      this.state = newState;
-      this.onStateChange(newState);
-    }
-  }
-}
-
-// ── monitorProvider ───────────────────────────────────────────────────────────
-
-export async function monitorProvider(
-  credentials: { clientId: string; clientSecret: string },
-  accountId: string,
-  abortSignal: AbortSignal,
-  channelRuntime?: unknown,
-): Promise<void> {
-  const { DebugLogger } = await import("./logger.js");
-  const { SDKDispatcher } = await import("./dispatcher.js");
-  const {
-    HEARTBEAT_INTERVAL,
-    MAX_RECONNECT_ATTEMPTS,
-    SDK_REQUEST_TIMEOUT,
-    MAX_CONCURRENT_REQUESTS,
-    DEBUG_ENABLED,
-  } = await import("./config.js");
-  const { parseRequest, parseEnvelope, TOPIC_USER_MESSAGES } = await import("./protocol.js");
-  const { getInstaUrl } = await import("../core/urls.js");
-
-  const logger = new DebugLogger(DEBUG_ENABLED, `[InstaPlugin:${accountId}]`);
-
-  logger.info("Starting provider monitor", { accountId, wsUrl: getInstaUrl("wsChat") });
-
-  const dispatcher = new SDKDispatcher(
-    {
-      requestTimeout: SDK_REQUEST_TIMEOUT,
-      maxConcurrentRequests: MAX_CONCURRENT_REQUESTS,
-      debug: DEBUG_ENABLED,
-    },
-    logger,
-    accountId,
-    channelRuntime,
-  );
-
-  async function handleMessage(raw: string): Promise<void> {
-    try {
-      let topic: string | undefined;
-      let envelopeType: string | undefined;
-
-      try {
-        const peek = JSON.parse(raw) as Record<string, unknown>;
-        if (peek && Array.isArray(peek["input"]) && peek["metadata"] && !peek["headers"]) {
-          topic = TOPIC_USER_MESSAGES;
-        } else {
-          topic = (peek?.["headers"] as Record<string, string> | undefined)?.["topic"];
-          envelopeType = peek?.["type"] as string | undefined;
-        }
-      } catch {
-        logger.error("Failed to peek message", undefined, { preview: raw.substring(0, 100) });
-        return;
-      }
-
-      if (topic === TOPIC_USER_MESSAGES) {
-        let request;
-        try {
-          request = parseRequest(raw);
-        } catch (err) {
-          logger.error("Failed to parse request", err as Error);
-          return;
-        }
-
-        logger.info("Received user request", {
-          messageId: request.messageId,
-          sessionId: request.sessionId,
-          contentLength: request.content.length,
-        });
-
-        const ws = connection.getWebSocket();
-        if (ws) {
-          await dispatcher.dispatchRequest(request, ws);
-        } else {
-          logger.error("Cannot dispatch: WebSocket unavailable");
-        }
-        return;
-      }
-
-      if (envelopeType !== undefined && envelopeType !== "MESSAGE") {
-        logger.info("Ignoring non-MESSAGE frame", { type: envelopeType });
-        return;
-      }
-
-      // Bot-messages echo path — audit log only, no re-dispatch
-      try {
-        const event = parseEnvelope(raw);
-        logger.debug("Received Open Responses event (audit)", { type: event.type, response_id: event.response_id });
-      } catch (err) {
-        logger.error("Failed to parse envelope", err as Error);
-      }
-    } catch (err) {
-      logger.error("Unhandled error in handleMessage", err as Error);
-    }
-  }
-
-  const connConfig = {
-    wsUrl: getInstaUrl("wsChat"),
-    clientId: credentials.clientId,
-    clientSecret: credentials.clientSecret,
-    heartbeatInterval: HEARTBEAT_INTERVAL,
-    reconnectMaxAttempts: MAX_RECONNECT_ATTEMPTS,
-  };
-
-  const connection = new WebSocketConnection(
-    connConfig,
-    logger,
-    handleMessage,
-    (state) => logger.info("Connection state", { state }),
-  );
-
-  const abortHandler = async () => {
-    logger.info("Abort received, disconnecting");
-    await connection.disconnect(accountId);
-    logger.info("Provider monitor stopped");
-  };
-
-  if (abortSignal.aborted) {
-    await abortHandler();
-    return;
-  }
-
-  abortSignal.addEventListener("abort", abortHandler, { once: true });
-
-  try {
-    await connection.connect(accountId);
-    return new Promise<void>((resolve) => {
-      abortSignal.addEventListener("abort", () => resolve(), { once: true });
-    });
-  } catch (err) {
-    logger.error("Failed to start provider monitor", err as Error);
-    throw err;
-  }
-}