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

package/src/channel/protocol.ts

@@ -1,265 +0,0 @@
-import type {
-  OpenResponsesEvent,
-  ResponseInProgressEvent,
-  OutputItemAddedEvent,
-  OutputTextDeltaEvent,
-  ContentPartDoneEvent,
-  ResponseCompletedEvent,
-  ResponseFailedEvent,
-  RequestContent,
-} from "./types.js";
-import { TEXT_CHUNK_SIZE } from "./config.js";
-
-// ── Topics ────────────────────────────────────────────────────────────────────
-
-export const TOPIC_BOT_MESSAGES = "/v1.0/im/bot/messages";
-export const TOPIC_USER_MESSAGES = "/v1.0/im/user/messages";
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function generateId(prefix: string): string {
-  return `${prefix}_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
-}
-
-function isoNow(): string {
-  return new Date().toISOString();
-}
-
-// ── Inbound Parsing ───────────────────────────────────────────────────────────
-
-export function extractContentFromInput(input: unknown[]): string {
-  const messageParts: string[] = [];
-
-  for (const item of input) {
-    if (!item || !Array.isArray((item as { content?: unknown }).content) || (item as { content: unknown[] }).content.length === 0) {
-      continue;
-    }
-
-    const parts: string[] = [];
-    for (const part of (item as { content: unknown[] }).content) {
-      if (!part || typeof part !== "object") continue;
-      const p = part as Record<string, unknown>;
-
-      switch (p["type"]) {
-        case "input_text": {
-          const text = p["text"];
-          if (text && typeof text === "string" && text.trim()) {
-            parts.push(`> ${text}`);
-          }
-          break;
-        }
-        case "input_file": {
-          const filename = typeof p["filename"] === "string" ? p["filename"] : "file";
-          const url = (p["file_url"] || p["url"]) as string | undefined;
-          if (url) {
-            parts.push(`[${filename}](${url})`);
-          } else if (typeof p["file_id"] === "string") {
-            parts.push(`[${filename}](file:${p["file_id"]})`);
-          }
-          break;
-        }
-        case "input_image": {
-          const filename = typeof p["filename"] === "string" ? p["filename"] : "image";
-          const url = (p["image_url"] || p["url"]) as string | undefined;
-          if (url) {
-            parts.push(`![${filename}](${url})`);
-          } else if (typeof p["file_id"] === "string") {
-            parts.push(`![${filename}](file:${p["file_id"]})`);
-          }
-          break;
-        }
-      }
-    }
-
-    if (parts.length > 0) {
-      messageParts.push(parts.join("\n\n"));
-    }
-  }
-
-  return messageParts.join("\n\n---\n\n");
-}
-
-export function parseRequest(rawMessage: string): RequestContent {
-  let request: Record<string, unknown>;
-  try {
-    request = JSON.parse(rawMessage) as Record<string, unknown>;
-  } catch (err) {
-    throw new Error(`Failed to parse request JSON: ${(err as Error).message}`);
-  }
-
-  const input = request["input"];
-  if (!Array.isArray(input) || input.length === 0) {
-    throw new Error("Invalid request: missing or empty input array");
-  }
-
-  const content = extractContentFromInput(input);
-  if (!content.trim()) {
-    throw new Error("Invalid request: no extractable content in input");
-  }
-
-  const meta = request["metadata"] as Record<string, unknown> | undefined;
-  const sessionId =
-    meta?.["session_id"] && typeof meta["session_id"] === "string"
-      ? meta["session_id"]
-      : generateId("msg");
-
-  const messageId =
-    meta?.["message_id"] && typeof meta["message_id"] === "string"
-      ? meta["message_id"]
-      : generateId("msg");
-
-  return {
-    content,
-    messageId,
-    sessionId,
-    topic: TOPIC_USER_MESSAGES,
-    model: typeof request["model"] === "string" ? request["model"] : undefined,
-  };
-}
-
-// ── Envelope Parsing ──────────────────────────────────────────────────────────
-
-export function parseEnvelope(rawMessage: string): OpenResponsesEvent {
-  let envelope: Record<string, unknown>;
-  try {
-    envelope = JSON.parse(rawMessage) as Record<string, unknown>;
-  } catch (err) {
-    throw new Error(`Failed to parse envelope: ${(err as Error).message}`);
-  }
-
-  if (envelope["type"] !== "MESSAGE") {
-    throw new Error(`Invalid envelope: expected type "MESSAGE", got "${envelope["type"]}"`);
-  }
-
-  const data = envelope["data"];
-  if (typeof data !== "string") {
-    throw new Error("Invalid envelope: data must be a string");
-  }
-
-  const event = JSON.parse(data) as OpenResponsesEvent;
-  if (!event.type || !event.response_id) {
-    throw new Error("Invalid event: missing type or response_id");
-  }
-
-  return event;
-}
-
-// ── Serialization ─────────────────────────────────────────────────────────────
-
-export function createEnvelope(event: OpenResponsesEvent): string {
-  return JSON.stringify(event);
-}
-
-// ── Event Factories ───────────────────────────────────────────────────────────
-
-export function createInProgressEvent(responseId: string, sessionId?: string): ResponseInProgressEvent {
-  const event: ResponseInProgressEvent & { metadata?: { session_id: string } } = {
-    type: "response.in_progress",
-    response_id: responseId,
-    status: "in_progress",
-    timestamp: isoNow(),
-  };
-  if (sessionId) event.metadata = { session_id: sessionId };
-  return event;
-}
-
-export function createOutputItemAddedEvent(
-  responseId: string,
-  itemId: string,
-  index = 0,
-): OutputItemAddedEvent {
-  return {
-    type: "response.output_item.added",
-    response_id: responseId,
-    item: {
-      id: itemId,
-      type: "message",
-      status: "in_progress",
-      role: "assistant",
-      content: [{ type: "output_text", status: "in_progress", text: "" }],
-    },
-    index,
-    timestamp: isoNow(),
-  };
-}
-
-export function createOutputTextDeltaEvent(
-  responseId: string,
-  itemId: string,
-  contentIndex: number,
-  text: string,
-): OutputTextDeltaEvent {
-  return {
-    type: "response.output_text.delta",
-    response_id: responseId,
-    item_id: itemId,
-    content_index: contentIndex,
-    delta: { text },
-    timestamp: isoNow(),
-  };
-}
-
-export function createContentPartDoneEvent(
-  responseId: string,
-  itemId: string,
-  contentIndex: number,
-): ContentPartDoneEvent {
-  return {
-    type: "response.content_part.done",
-    response_id: responseId,
-    item_id: itemId,
-    content_index: contentIndex,
-    status: "completed",
-    timestamp: isoNow(),
-  };
-}
-
-export function createCompletedEvent(responseId: string, sessionId?: string): ResponseCompletedEvent {
-  const event: ResponseCompletedEvent & { metadata?: { session_id: string } } = {
-    type: "response.completed",
-    response_id: responseId,
-    status: "completed",
-    timestamp: isoNow(),
-  };
-  if (sessionId) event.metadata = { session_id: sessionId };
-  return event;
-}
-
-export function createFailedEvent(
-  responseId: string,
-  code: string,
-  message: string,
-  details: unknown = null,
-  sessionId?: string,
-): ResponseFailedEvent {
-  const event: ResponseFailedEvent & { metadata?: { session_id: string } } = {
-    type: "response.failed",
-    response_id: responseId,
-    status: "failed",
-    error: { code, message, details },
-    timestamp: isoNow(),
-  };
-  if (sessionId) event.metadata = { session_id: sessionId };
-  return event;
-}
-
-// ── Text → Event Sequence ─────────────────────────────────────────────────────
-
-export function textToEventSequence(text: string, responseId?: string): OpenResponsesEvent[] {
-  const respId = responseId ?? generateId("resp");
-  const itemId = generateId("item");
-
-  const events: OpenResponsesEvent[] = [
-    createInProgressEvent(respId),
-    createOutputItemAddedEvent(respId, itemId),
-  ];
-
-  for (let i = 0; i < text.length; i += TEXT_CHUNK_SIZE) {
-    events.push(createOutputTextDeltaEvent(respId, itemId, 0, text.substring(i, i + TEXT_CHUNK_SIZE)));
-  }
-
-  events.push(createContentPartDoneEvent(respId, itemId, 0));
-  events.push(createCompletedEvent(respId));
-
-  return events;
-}

package/src/channel/registrar.ts

@@ -1,172 +0,0 @@
-import { VALID_SCENE_TAG_IDS, SCENE_TAGS } from "../core/register-identity.js";
-import { setAgentRunning, getPendingRegistration } from "./registration-store.js";
-import type { DebugLogger } from "./logger.js";
-
-// ── Registration prompts ──────────────────────────────────────────────────────
-
-const SCENE_TAG_SUMMARY = Object.entries(SCENE_TAGS)
-  .map(([, group]) =>
-    Object.entries(group.children)
-      .map(([id, label]) => `  ${id}: ${label}`)
-      .join("\n"),
-  )
-  .join("\n");
-
-/**
- * System prompt instructs the AI to decide sensible defaults autonomously and
- * call `insta_propose_registration` to store them for user review.
- *
- * The AI must NOT call `insta_register_identity` directly — the actual
- * registration happens only after the user confirms via the gateway UI.
- */
-const REGISTRATION_SYSTEM_PROMPT = `
-你是 InstaClaw 频道配置向导。InstaClaw 是一个 AI 代理接单平台。
-
-本次调用是插件在首次启动时自动触发的。你的任务是根据当前 Agent 的上下文，推断合理的注册默认参数，
-然后调用 insta_propose_registration 将这些参数暂存，由用户在控制面板中审阅并最终确认。
-
-【重要】不要调用 insta_register_identity，不要直接完成注册。只调用 insta_propose_registration。
-
-参数推断规则：
-- name：根据 Agent 名称或用途取一个简洁有辨识度的名称
-- avatar：使用占位头像，例如 https://api.dicebear.com/7.x/bottts/svg?seed=instaclaw
-- description：简短描述当前 Agent 的主要能力（1-2 句话）
-- hourly_rate：默认设为 100（单位：元）
-- scene_tags：从以下合法 ID 中选 1-3 个最符合当前 Agent 定位的：
-${SCENE_TAG_SUMMARY}
-- custom_tags：可留空数组 []
-- instance_type：固定填 0（本地实例）
-
-行动要求：
-1. 根据上述规则自主决定每个参数的值
-2. 调用 insta_propose_registration 提交提案（参数将暂存，等待用户确认）
-3. 不要输出多余的解释，直接执行工具调用
-`.trim();
-
-const REGISTRATION_INITIAL_PROMPT =
-  "InstaClaw 频道首次启动，尚未完成注册。请根据当前 Agent 上下文推断合理的默认注册参数，调用 insta_propose_registration 提交提案，用户将在控制面板中确认后完成注册。";
-
-// ── Types ─────────────────────────────────────────────────────────────────────
-
-export type RegistrarStatus = "triggered" | "unavailable" | "error";
-
-export interface RegistrarResult {
-  status: RegistrarStatus;
-  error?: string;
-}
-
-// ── Runtime type ──────────────────────────────────────────────────────────────
-
-type ChannelRuntimeWithReply = {
-  reply?: {
-    dispatchReplyWithBufferedBlockDispatcher?: (opts: {
-      ctx: Record<string, unknown>;
-      cfg: unknown;
-      replyOptions?: {
-        abortSignal?: AbortSignal;
-        onPartialReply?: (payload: { text?: string }) => void;
-      };
-      dispatcherOptions?: {
-        deliver?: (payload: { text?: string }) => Promise<void>;
-        onError?: (err: unknown) => void;
-      };
-    }) => Promise<void>;
-  };
-};
-
-// ── Trigger ───────────────────────────────────────────────────────────────────
-
-/**
- * Fire-and-forget: uses `channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher`
- * to launch a synthetic AI conversation that auto-calls `insta_register_identity`.
- *
- * Unlike `subagent.run`, `dispatchReplyWithBufferedBlockDispatcher` is available
- * at any point during the channel lifecycle, including inside `startAccount`.
- *
- * The AI response text is discarded — only the tool call side-effect matters
- * (writing the profile file). The polling loop in `startAccount` detects the
- * resulting profile and establishes the WebSocket connection.
- */
-export async function triggerRegistrationAgent(
-  channelRuntime: unknown,
-  cfg: unknown,
-  logger: DebugLogger,
-  accountId?: string,
-): Promise<RegistrarResult> {
-  const runtime = channelRuntime as ChannelRuntimeWithReply | undefined;
-
-  if (!runtime?.reply?.dispatchReplyWithBufferedBlockDispatcher) {
-    logger.warn(
-      "channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher not available. " +
-      "Register manually by calling the insta_register_identity tool.",
-    );
-    return { status: "unavailable" };
-  }
-
-  const msgCtx: Record<string, unknown> = {
-    Body: REGISTRATION_INITIAL_PROMPT,
-    AccountId: accountId ?? "default",
-    SessionKey: `instaclaw:${accountId ?? "default"}:registration`,
-    SystemPrompt: REGISTRATION_SYSTEM_PROMPT,
-  };
-
-  try {
-    // Mark in-flight BEFORE the async dispatch so the polling loop
-    // immediately sees "running" on the very next tick.
-    setAgentRunning(true);
-
-    // Fire-and-forget: errors from the AI run are caught below and logged,
-    // but do not block the polling loop.
-    void runtime.reply.dispatchReplyWithBufferedBlockDispatcher({
-      ctx: msgCtx,
-      cfg,
-      replyOptions: {
-        onPartialReply: (_payload) => {
-          // Intentionally discard streaming text — we only care about tool calls.
-        },
-      },
-      dispatcherOptions: {
-        deliver: async (_payload) => {
-          // Bug 2 fix: always clear the running flag so startAccount can
-          // re-trigger if the AI completed without calling insta_propose_registration.
-          setAgentRunning(false);
-
-          if (getPendingRegistration()) {
-            logger.info("Registration agent completed — proposal stored, waiting for user confirmation");
-          } else {
-            logger.warn(
-              "Registration agent completed but no proposal was created. " +
-              "startAccount will re-trigger on the next poll cycle.",
-            );
-          }
-        },
-        onError: (err: unknown) => {
-          // Clear the running flag so the polling loop can recover.
-          setAgentRunning(false);
-          logger.error(
-            "Registration agent dispatch error",
-            err instanceof Error ? err : new Error(String(err)),
-          );
-        },
-      },
-    }).catch((err: unknown) => {
-      // Hard rejection (e.g. runtime unavailable mid-flight): also clear flag.
-      setAgentRunning(false);
-      logger.error(
-        "Registration agent dispatch rejected",
-        err instanceof Error ? err : new Error(String(err)),
-      );
-    });
-
-    logger.info("Registration agent dispatch triggered via dispatchReplyWithBufferedBlockDispatcher");
-    return { status: "triggered" };
-  } catch (err) {
-    // Synchronous throw before dispatch could start — clear flag.
-    setAgentRunning(false);
-    const message = err instanceof Error ? err.message : String(err);
-    logger.error("Failed to trigger registration agent dispatch", err instanceof Error ? err : undefined);
-    return { status: "error", error: message };
-  }
-}
-
-export { VALID_SCENE_TAG_IDS };

package/src/channel/types.ts

@@ -1,102 +0,0 @@
-// ── Connection ───────────────────────────────────────────────────────────────
-
-export type ConnectionState = "connecting" | "connected" | "disconnected" | "reconnecting";
-
-export interface ConnectionConfig {
-  wsUrl: string;
-  clientId: string;
-  clientSecret: string;
-  heartbeatInterval: number;
-  reconnectMaxAttempts?: number;
-}
-
-// ── WebSocket Envelope (open-responses §7) ────────────────────────────────────
-
-export interface WebSocketEnvelope {
-  type: "MESSAGE";
-  headers: {
-    messageId: string;
-    topic: string;
-    [key: string]: string;
-  };
-  data: string;
-}
-
-// ── Open Responses Event Types (open-responses §5–§6) ─────────────────────────
-
-export interface BaseEvent {
-  type: string;
-  response_id: string;
-  timestamp: string;
-}
-
-export interface ResponseInProgressEvent extends BaseEvent {
-  type: "response.in_progress";
-  status: "in_progress";
-}
-
-export interface OutputItemAddedEvent extends BaseEvent {
-  type: "response.output_item.added";
-  item: Item;
-  index: number;
-}
-
-export interface OutputTextDeltaEvent extends BaseEvent {
-  type: "response.output_text.delta";
-  item_id: string;
-  content_index: number;
-  delta: { text: string };
-}
-
-export interface ContentPartDoneEvent extends BaseEvent {
-  type: "response.content_part.done";
-  item_id: string;
-  content_index: number;
-  status: "completed";
-}
-
-export interface ResponseCompletedEvent extends BaseEvent {
-  type: "response.completed";
-  status: "completed";
-}
-
-export interface ResponseFailedEvent extends BaseEvent {
-  type: "response.failed";
-  status: "failed";
-  error: { code: string; message: string; details: unknown };
-}
-
-export type OpenResponsesEvent =
-  | ResponseInProgressEvent
-  | OutputItemAddedEvent
-  | OutputTextDeltaEvent
-  | ContentPartDoneEvent
-  | ResponseCompletedEvent
-  | ResponseFailedEvent;
-
-// ── Data Models ───────────────────────────────────────────────────────────────
-
-export interface ContentPart {
-  type: "output_text";
-  status: "in_progress" | "completed";
-  text: string;
-}
-
-export interface Item {
-  id: string;
-  type: "message" | "function_call" | "function_call_output" | "reasoning";
-  status: "in_progress" | "completed" | "incomplete" | "failed";
-  role?: "assistant" | "user";
-  content: ContentPart[];
-}
-
-// ── Inbound Request ───────────────────────────────────────────────────────────
-
-export interface RequestContent {
-  content: string;
-  messageId: string;
-  topic: string;
-  sessionId: string;
-  model?: string;
-  [key: string]: unknown;
-}

package/src/core/index.ts

@@ -1,13 +0,0 @@
-export {
-  registerIdentity,
-  SCENE_TAGS,
-  VALID_SCENE_TAG_IDS,
-} from "./register-identity.js";
-export type {
-  RegisterIdentityParams,
-  RegisterIdentityResponse,
-  RegisterIdentityResult,
-} from "./register-identity.js";
-
-export { getInstaUrl } from "./urls.js";
-export type { UrlKey } from "./urls.js";