@coolclaw/clawtopia-connector 0.1.0 → 0.2.1

package/dist/index.d.ts

@@ -1,384 +0,0 @@
-declare const PROTOCOL_VERSION: 1;
-declare const EXACT_ACK_CAPABILITY = "EXACT_MESSAGE_ACK_V1";
-declare const RECEIPT_CAPABILITY = "MESSAGE_PROCESSING_RECEIPT_V1";
-declare const MEDIA_INPUT_CAPABILITY = "MEDIA_INPUT_V1";
-declare const GAME_CAPABILITY = "WEREWOLF_STRUCTURED_JSON_MESSAGE_V1";
-declare const PROMPT_PASSTHROUGH_CAPABILITY = "AGENT_TASK_PROMPT_PASSTHROUGH_V1";
-declare const DEFAULT_CAPABILITIES: readonly ["WEREWOLF_STRUCTURED_JSON_MESSAGE_V1", "EXACT_MESSAGE_ACK_V1", "MESSAGE_PROCESSING_RECEIPT_V1", "AGENT_TASK_PROMPT_PASSTHROUGH_V1", "MEDIA_INPUT_V1"];
-type Frame<T = unknown> = {
-    v: typeof PROTOCOL_VERSION;
-    type: string;
-    id: string;
-    ack?: string;
-    ts: number;
-    payload?: T;
-};
-declare function createFrame<T>(type: string, payload?: T, ack?: string): Frame<T>;
-declare function respondFrame<T>(type: string, ack: Frame, payload?: T): Frame<T>;
-declare function encodeFrame(frame: Frame): string;
-declare class FrameDecodeError extends Error {
-    constructor(message: string);
-}
-declare function decodeFrame<T = unknown>(raw: string | Buffer): Frame<T>;
-type MessageFrame = Frame<{
-    seq: number;
-    messageId: string;
-    conversationId?: string;
-    groupId?: string;
-    sender?: Record<string, unknown>;
-    recipient?: Record<string, unknown>;
-    messageType: string;
-    content: string;
-    mentioned?: boolean;
-    [key: string]: unknown;
-}>;
-type GameEventFrame = Frame<{
-    seq: number;
-    eventId: string;
-    eventRecordId?: number;
-    gameId: number;
-    roomId: number;
-    turnSeq: number;
-    eventType: string;
-    eventData?: unknown;
-    agentTask: {
-        requiresReply: boolean;
-        renderedPrompt: string;
-        actionContract?: Record<string, unknown>;
-        outputSchema?: Record<string, unknown>;
-        retryPolicy?: {
-            maxRetries?: number;
-            shareDeadline?: boolean;
-            rejectedOutputActionType?: string;
-        };
-        fallbackAction?: Record<string, unknown> | null;
-        promptPolicyVersion?: string;
-        renderedPromptHash?: string;
-        actionProtocolVersion?: string;
-        conversationKey?: string;
-    };
-    deadlineEpochMs?: number;
-    traceId: string;
-}>;
-declare function isRecord(value: unknown): value is Record<string, unknown>;
-declare function isInboundMessage(frame: Frame): frame is MessageFrame;
-declare function isGameEvent(frame: Frame): frame is GameEventFrame;
-declare function readSeq(frame: Frame): number | undefined;
-declare function readMessageId(frame: Frame): string | undefined;
-
-type ConnectorState = {
-    version: 1;
-    processedMessageIds: string[];
-    processedEventIds: string[];
-    sessionIds: Record<string, string>;
-    /** Upstream Claude/Codex session ids; sessionIds remains the worker-local key. */
-    agentSessionIds: Record<string, string>;
-    inflight: Record<string, {
-        messageId: string;
-        serverSeq: number;
-    }>;
-    updatedAt: number;
-};
-interface StateStore {
-    load(): Promise<ConnectorState>;
-    save(state: ConnectorState): Promise<void>;
-}
-declare class MemoryStateStore implements StateStore {
-    private state;
-    load(): Promise<ConnectorState>;
-    save(state: ConnectorState): Promise<void>;
-}
-declare class JsonFileStateStore implements StateStore {
-    private readonly filePath;
-    private writeTail;
-    constructor(filePath: string);
-    load(): Promise<ConnectorState>;
-    save(state: ConnectorState): Promise<void>;
-}
-declare function normalizeState(value: Partial<ConnectorState> | undefined): ConnectorState;
-declare function cloneState(state: ConnectorState): ConnectorState;
-
-type ChannelState = "connecting" | "connected" | "reconnecting" | "disconnected";
-type ChannelClientOptions = {
-    gatewayUrl: string;
-    agentId: string;
-    token: string;
-    connectorVersion: string;
-    capabilities?: string[];
-    heartbeatIntervalMs?: number;
-    reconnectDelayMs?: number;
-    requestTimeoutMs?: number;
-    onFrame?: (frame: Frame, client: ChannelClient) => Promise<void> | void;
-    onStateChange?: (state: ChannelState) => void;
-    onError?: (error: Error) => void;
-};
-declare class ChannelClient {
-    private readonly options;
-    private socket?;
-    private heartbeat?;
-    private reconnectTimer?;
-    private readonly pending;
-    private stopped;
-    private reconnectAttempt;
-    private helloPayload;
-    private frameHandler?;
-    constructor(options: ChannelClientOptions);
-    setFrameHandler(handler: (frame: Frame, client: ChannelClient) => Promise<void> | void): void;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    isConnected(): boolean;
-    getHelloPayload(): unknown;
-    getGatewayUrl(): string;
-    request<T>(frame: Frame): Promise<T>;
-    send(frame: Frame): void;
-    ack(serverSeq: number, messageId?: string): Promise<void>;
-    receipt(payload: {
-        messageId: string;
-        serverSeq: number;
-        status: "PROCESSING" | "COMPLETED";
-        outcome?: "REPLIED" | "NO_REPLY" | "FAILED";
-        errorCode?: string;
-        errorMessage?: string;
-        retryable?: boolean;
-    }): Promise<void>;
-    private connect;
-    private handleRaw;
-    private handleFrame;
-    private startHeartbeat;
-    private handleClose;
-    private scheduleReconnect;
-    private rejectPending;
-    private clearHeartbeat;
-    private clearReconnect;
-    private notify;
-}
-
-type WorkerEvent = {
-    event: "text" | "thinking" | "tool_use" | "tool_result" | "permission" | "result" | "error";
-    sessionId?: string;
-    agentSessionId?: string;
-    content?: string;
-    done?: boolean;
-    error?: string;
-    requestId?: string;
-    data?: unknown;
-    type?: string;
-    [key: string]: unknown;
-};
-type WorkerTransport = {
-    write(line: string): void;
-    onLine(listener: (line: string) => void): void;
-    onExit?(listener: (error: Error) => void): void;
-    close(): Promise<void>;
-};
-type WorkerClientOptions = {
-    executable: string;
-    args?: string[];
-    cwd?: string;
-    env?: NodeJS.ProcessEnv;
-    requestTimeoutMs?: number;
-    onEvent?: (event: WorkerEvent) => void | Promise<void>;
-    onStderr?: (line: string) => void;
-    transportFactory?: (options: WorkerClientOptions) => WorkerTransport;
-};
-/** Runtime executor contract shared by the bundled worker and OpenClaw adapter. */
-interface RuntimeExecutor {
-    setEventHandler?(handler: (event: WorkerEvent) => void | Promise<void>): void;
-    initialize(runtime: string, connectorVersion: string): Promise<WorkerInitializeResult>;
-    startSession(input: WorkerStartSessionInput): Promise<WorkerSessionResult>;
-    resumeSession(input: WorkerResumeSessionInput): Promise<WorkerSessionResult>;
-    send(input: WorkerSendInput): Promise<{
-        accepted: boolean;
-    }>;
-    respondPermission(input: WorkerPermissionResponse): Promise<{
-        accepted: boolean;
-    }>;
-    cancel(sessionId: string, reason?: string): Promise<{
-        accepted: boolean;
-    }>;
-    closeSession(sessionId: string): Promise<{
-        accepted: boolean;
-    }>;
-    health(): Promise<WorkerHealthResult>;
-    shutdown(): Promise<void>;
-}
-declare class WorkerClient {
-    private readonly options;
-    private transport?;
-    private readonly pending;
-    private started;
-    private closed;
-    private eventHandler?;
-    constructor(options: WorkerClientOptions);
-    setEventHandler(handler: (event: WorkerEvent) => void | Promise<void>): void;
-    start(): Promise<void>;
-    initialize(runtime: string, connectorVersion: string): Promise<WorkerInitializeResult>;
-    startSession(input: WorkerStartSessionInput): Promise<WorkerSessionResult>;
-    resumeSession(input: WorkerResumeSessionInput): Promise<WorkerSessionResult>;
-    send(input: WorkerSendInput): Promise<{
-        accepted: boolean;
-    }>;
-    respondPermission(input: WorkerPermissionResponse): Promise<{
-        accepted: boolean;
-    }>;
-    cancel(sessionId: string, reason?: string): Promise<{
-        accepted: boolean;
-    }>;
-    closeSession(sessionId: string): Promise<{
-        accepted: boolean;
-    }>;
-    health(): Promise<WorkerHealthResult>;
-    shutdown(): Promise<void>;
-    private request;
-    private handleLine;
-    private rejectAll;
-}
-type WorkerInitializeResult = {
-    workerVersion: string;
-    protocolVersion: number | string;
-    runtime: string;
-    agents?: string[];
-    capabilities: string[] | Record<string, boolean>;
-};
-type WorkerStartSessionInput = {
-    sessionId?: string;
-    agentSessionId?: string;
-    runtime: string;
-    runtimePath?: string;
-    workDir?: string;
-    mode?: string;
-    backend?: string;
-    appServerUrl?: string;
-    timeoutMs?: number;
-};
-type WorkerResumeSessionInput = WorkerStartSessionInput & {
-    sessionId: string;
-};
-type WorkerSessionResult = {
-    sessionId: string;
-    agentSessionId?: string;
-    runtime: string;
-    alive?: boolean;
-    resumed?: boolean;
-};
-type WorkerAttachment = {
-    path: string;
-    mimeType?: string;
-    fileName?: string;
-    sha256?: string;
-    size?: number;
-};
-type WorkerSendInput = {
-    sessionId: string;
-    messageId: string;
-    prompt: string;
-    images?: WorkerAttachment[];
-    files?: WorkerAttachment[];
-    timeoutMs?: number;
-};
-type WorkerPermissionResponse = {
-    sessionId: string;
-    requestId: string;
-    behavior: "allow" | "deny";
-    updatedInput?: Record<string, unknown>;
-    message?: string;
-};
-type WorkerHealthResult = {
-    ok: boolean;
-    sessions?: number;
-    runtime?: string;
-    version?: string;
-};
-
-type Diagnostic = {
-    event: string;
-    phase?: string;
-    messageId?: string;
-    serverSeq?: number;
-    sessionId?: string;
-    error?: string;
-    home?: string;
-    inherited?: string;
-};
-
-type RuntimeConnectorOptions = {
-    channel: ChannelClient;
-    worker: RuntimeExecutor;
-    stateStore?: StateStore;
-    runtime: string;
-    runtimePath?: string;
-    backend?: "exec" | "app_server";
-    appServerUrl?: string;
-    connectorVersion: string;
-    taskTimeoutMs?: number;
-    attachmentDir?: string;
-    workDir?: string;
-    onStateChange?: (state: string) => void;
-    onDiagnostic?: (entry: Diagnostic) => void;
-    onPermission?: (request: {
-        sessionId: string;
-        requestId: string;
-        data?: unknown;
-    }) => Promise<WorkerPermissionResponse["behavior"]> | WorkerPermissionResponse["behavior"];
-};
-declare class RuntimeConnector {
-    private readonly options;
-    private readonly stateStore;
-    private state;
-    private readonly queues;
-    private readonly contexts;
-    private readonly activeMessages;
-    private readonly activeEvents;
-    private started;
-    constructor(options: RuntimeConnectorOptions);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    /** Attach the callback after constructing a ChannelClient without relying on a global runtime. */
-    handleFrame(frame: Frame): Promise<void>;
-    private handleMessage;
-    private handleGameEvent;
-    private enqueue;
-    private dispatchMessage;
-    private sendReceipt;
-    private dispatchGameEvent;
-    private getOrCreateSession;
-    private runTask;
-    private prepareMessageInput;
-    private sendReply;
-    private handleWorkerEvent;
-    private remember;
-    private diagnose;
-    private persist;
-}
-
-type ConnectorConfig = {
-    schemaVersion: number;
-    profileId: string;
-    gatewayUrl: string;
-    environment: string;
-    agentId: string;
-    token: string;
-    runtime: "claudecode" | "codex" | "openclaw";
-    workerPath: string;
-    /** Expected SHA-256 of the pinned worker binary, populated by upgrade. */
-    workerSha256?: string;
-    /** Optional explicit local runtime executable (defaults to claude/codex). */
-    runtimePath?: string;
-    workDir: string;
-    connectorVersion: string;
-    backend?: "exec" | "app_server";
-    appServerUrl?: string;
-    permissionPolicy?: "allow" | "deny";
-    pairingEndpoint?: string;
-};
-declare function configRoot(): string;
-declare function normalizeProfileId(value: string): string;
-declare function profileConfigPath(profileId?: string): string;
-declare const defaultConfigPath: typeof profileConfigPath;
-declare function bundledWorkerPath(): string;
-declare function defaultConfig(profileId?: string): ConnectorConfig;
-declare function loadConfig(path?: string): Promise<ConnectorConfig>;
-declare function saveConfig(config: ConnectorConfig, path?: string): Promise<void>;
-declare function profileEnvironment(config: ConnectorConfig, configPath?: string): NodeJS.ProcessEnv;
-
-export { ChannelClient, type ChannelClientOptions, type ChannelState, type ConnectorConfig, type ConnectorState, DEFAULT_CAPABILITIES, EXACT_ACK_CAPABILITY, type Frame, FrameDecodeError, GAME_CAPABILITY, type GameEventFrame, JsonFileStateStore, MEDIA_INPUT_CAPABILITY, MemoryStateStore, type MessageFrame, PROMPT_PASSTHROUGH_CAPABILITY, PROTOCOL_VERSION, RECEIPT_CAPABILITY, RuntimeConnector, type RuntimeConnectorOptions, type RuntimeExecutor, type StateStore, type WorkerAttachment, WorkerClient, type WorkerClientOptions, type WorkerEvent, type WorkerHealthResult, type WorkerInitializeResult, type WorkerPermissionResponse, type WorkerResumeSessionInput, type WorkerSendInput, type WorkerSessionResult, type WorkerStartSessionInput, type WorkerTransport, bundledWorkerPath, cloneState, configRoot, createFrame, decodeFrame, defaultConfig, defaultConfigPath, encodeFrame, isGameEvent, isInboundMessage, isRecord, loadConfig, normalizeProfileId, normalizeState, profileConfigPath, profileEnvironment, readMessageId, readSeq, respondFrame, saveConfig };

package/dist/index.js

@@ -1,70 +0,0 @@
-import {
-  ChannelClient,
-  DEFAULT_CAPABILITIES,
-  EXACT_ACK_CAPABILITY,
-  FrameDecodeError,
-  GAME_CAPABILITY,
-  JsonFileStateStore,
-  MEDIA_INPUT_CAPABILITY,
-  MemoryStateStore,
-  PROMPT_PASSTHROUGH_CAPABILITY,
-  PROTOCOL_VERSION,
-  RECEIPT_CAPABILITY,
-  RuntimeConnector,
-  WorkerClient,
-  bundledWorkerPath,
-  cloneState,
-  configRoot,
-  createFrame,
-  decodeFrame,
-  defaultConfig,
-  defaultConfigPath,
-  encodeFrame,
-  isGameEvent,
-  isInboundMessage,
-  isRecord,
-  loadConfig,
-  normalizeProfileId,
-  normalizeState,
-  profileConfigPath,
-  profileEnvironment,
-  readMessageId,
-  readSeq,
-  respondFrame,
-  saveConfig
-} from "./chunk-5OV44BPP.js";
-export {
-  ChannelClient,
-  DEFAULT_CAPABILITIES,
-  EXACT_ACK_CAPABILITY,
-  FrameDecodeError,
-  GAME_CAPABILITY,
-  JsonFileStateStore,
-  MEDIA_INPUT_CAPABILITY,
-  MemoryStateStore,
-  PROMPT_PASSTHROUGH_CAPABILITY,
-  PROTOCOL_VERSION,
-  RECEIPT_CAPABILITY,
-  RuntimeConnector,
-  WorkerClient,
-  bundledWorkerPath,
-  cloneState,
-  configRoot,
-  createFrame,
-  decodeFrame,
-  defaultConfig,
-  defaultConfigPath,
-  encodeFrame,
-  isGameEvent,
-  isInboundMessage,
-  isRecord,
-  loadConfig,
-  normalizeProfileId,
-  normalizeState,
-  profileConfigPath,
-  profileEnvironment,
-  readMessageId,
-  readSeq,
-  respondFrame,
-  saveConfig
-};

package/flavor.json

@@ -1,6 +0,0 @@
-{
-  "key": "coolclaw",
-  "packageName": "@coolclaw/clawtopia-connector",
-  "environment": "test",
-  "defaultGatewayUrl": "https://agits-xa.baidu.com/riddle"
-}