@cutie-crypto/connector-core 0.1.0

package/README.md

@@ -0,0 +1,81 @@
+# @cutie-crypto/connector-core
+
+Cutie Connector core protocol + connection runtime + PlatformAdapter contract.
+
+**Node.js only.** Uses `node:http` / `node:https` / `node:url` / `Buffer`.
+
+## What this package gives you
+
+- **Protocol envelopes**: `TaskPush` / `HelloOk` / `HeartbeatAck` / `ServerMessage` / `RegisterResult` / `TaskResultMessage`
+- **HTTP client**: `register(serverUrl, RegisterParams)` / `fetchStrategyKnowledge(serverUrl, token)` / `buildFormData` / `post` / `get`
+- **Connection runtime**: `ConnectorConnection` class — WS loop / heartbeat / task dispatch / upgrade trigger
+- **Adapter contract**: `CorePlatformAdapter<C>` — 6 methods you implement to plug a new platform
+
+## How to write a new adapter
+
+```ts
+import type {
+  CorePlatformAdapter,
+  AgentResult,
+  SafetyTemplates,
+} from '@cutie-crypto/connector-core';
+
+interface MyConfig {
+  endpoint: string;
+}
+
+export class EchoAdapter implements CorePlatformAdapter<MyConfig> {
+  readonly id = 'echo';
+  private config: MyConfig | null = null;
+
+  attachConfig(config: MyConfig): void {
+    this.config = config;
+  }
+
+  async callAgent(message: string, _model: string): Promise<AgentResult> {
+    return { answer: `echo: ${message}`, latency_ms: 1 };
+  }
+
+  async selfUpgrade(_targetVersion: string): Promise<void> {
+    // No-op. Real adapter would: download new version, replace binary,
+    // process.exit(0) to let supervisor (systemd / PM2 / Zylos) restart.
+  }
+
+  augmentHeartbeat(envelope: Record<string, unknown>): Record<string, unknown> {
+    return envelope;
+  }
+
+  getCapabilities(): string[] {
+    return [];
+  }
+
+  applySafetyTemplates(_templates: SafetyTemplates): void {
+    // OpenClaw / Hermes write to workspace files.
+    // CLI-style adapters (Claude / Codex) cache here, splice into prompt later.
+  }
+}
+```
+
+## The 8 design constraints (Phase 0.2)
+
+These are the contracts `connector-core` upholds so any adapter (OpenClaw,
+Hermes, future Claude / Codex CLI integration) plugs in without touching core:
+
+1. **AI call abstraction**: `adapter.callAgent(message, model) → {answer, latency_ms}`. Core does not assume HTTP / CLI.
+2. **Config layering**: top-level holds shared fields; platform-specific config is the generic `C` parameter on `CorePlatformAdapter<C>`. Each adapter sees only its own config type.
+3. **Safety template dispatch**: `adapter.applySafetyTemplates({agents_md, soul_md, canary_token?})` — core delivers what server's `register` returns; adapter decides how to land it (file vs cache). Called only after pairing/setup succeeds.
+4. **Self-upgrade**: `adapter.selfUpgrade(targetVersion)` — adapter chooses install method. Core does not hardcode `npm install`.
+5. **Process management**: core does not assume systemd / PM2 / launchd. Adapter's `selfUpgrade` typically `process.exit(0)` to let supervisor restart.
+6. **Unified `agent_status`**: core builds heartbeat with `agent_status`; adapter's `augmentHeartbeat` adds backward-compat fields (e.g. `openclaw_status` mirroring `agent_status`).
+7. **README + dummy adapter**: see the compilable `EchoAdapter` example above in *How to write a new adapter*.
+8. **Capability flags**: `register` form / `heartbeat` envelope carry optional `capabilities: string[]`. Adapter returns `[]` today; future adapters declare e.g. `['sandbox=srt', 'runtime=claude']`.
+
+## When to call `applySafetyTemplates`
+
+Only after `register` HTTP response returns templates. **Never** during install /
+post-install hooks — there's no `pair_token` yet, so the templates haven't been
+generated by Cutie Server.
+
+## Runtime requirements
+
+Node.js >= 18.

package/dist/adapter.d.ts

@@ -0,0 +1,80 @@
+/**
+ * CorePlatformAdapter — core 知道的 6 件 adapter 必须做的事。
+ *
+ * connector / zylos-cutie / 任何未来 adapter 都实现这个接口。core 不假设
+ * 平台命名、不假设进程管理（systemd / PM2）、不假设网络协议（HTTP / CLI）。
+ *
+ * Generic `C` = adapter 自己的 platform-specific config 类型。OpenClaw /
+ * Hermes / 未来 zylos-cutie 各自实例化自己的 C，编译期隔离 adapter 之间的
+ * 字段访问（约束 2）。
+ */
+export interface AgentResult {
+    answer: string;
+    latency_ms: number;
+}
+/**
+ * 安全模板：server `register` response 下发的 agents_md / soul_md，由 adapter
+ * 决定如何落地（OpenClaw/Hermes 写 workspace；zylos-cutie 缓存供 prompt-builder
+ * 拼接）。canary_token 当前 server 不下发，作为 future-proof 占位。
+ */
+export interface SafetyTemplates {
+    agents_md: string;
+    soul_md: string;
+    /** future: server 下发的 KOL 实例级 canary token；当前 undefined */
+    canary_token?: string;
+}
+export interface CorePlatformAdapter<C = unknown> {
+    /** 平台 ID，仅供日志/调试。core 不约束值（'openclaw' / 'hermes' / 未来 'zylos'）。 */
+    readonly id: string;
+    /**
+     * 注入平台特定 config 子集（约束 2）。
+     *
+     * Generic `C` 让每个 adapter 在编译期只看到自己关心的字段：OpenClaw 拿
+     * OpenClawAdapterConfig，Hermes 拿 HermesAdapterConfig，互相不串。core 不知道
+     * adapter 各自的 config schema，仅作为 contract 占位。
+     *
+     * connector 包的 ConnectorConnection wrapper 在创建 core ConnectorConnection
+     * 之前先调本方法，把 ConnectorConfig 中跟当前平台相关的窄字段挑出来注入。
+     */
+    attachConfig(config: C): void;
+    /**
+     * 调用本地 AI agent。OpenClaw/Hermes 走 HTTP gateway；zylos-cutie 未来
+     * spawn `claude -p` / `codex exec`。core 不假设实现方式。
+     */
+    callAgent(message: string, model: string): Promise<AgentResult>;
+    /**
+     * 触发自升级。targetVersion 由 server heartbeat_ack 下发。
+     * core 不假设进程管理：adapter 内部完成 install + 通常 process.exit(0) 让
+     * 外层守护（systemd / PM2 / Zylos hooks）自动重启。core 不要求 selfUpgrade
+     * 一定 return（实际跑成功的话 adapter 已经 exit）。
+     */
+    selfUpgrade(targetVersion: string): Promise<void>;
+    /**
+     * core 构造完 heartbeat envelope（含 agent_status 等通用字段）后调，让
+     * adapter 注入平台特定字段。
+     *
+     * 例：
+     *  - OpenClaw 加 openclaw_status（兼容旧 server 字段，mirror agent_status）
+     *  - Hermes 加 openclaw_status + hermes_isolation_level + auto_start_configured
+     *  - 未来 zylos-cutie 不加任何字段
+     *
+     * 必须返回 envelope（可以是同一对象 mutate，也可以是新对象）。
+     */
+    augmentHeartbeat(envelope: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * 上报 adapter 能力（约束 8）。OpenClaw/Hermes 当前返回 `[]`；
+     * zylos-cutie 未来上报 `['sandbox=srt', 'runtime=claude']` 等。Server 暂不读，
+     * 字段是 future-proof 占位。
+     */
+    getCapabilities(): string[];
+    /**
+     * 把 server register response 下发的安全模板交给 adapter 落地（约束 3）。
+     * - OpenClaw / Hermes: 写到 workspace 文件（agent CLI 启动时读入）
+     * - 未来 zylos-cutie: 缓存到内存供 prompt-builder 拼接（Claude/Codex CLI
+     *   没有 workspace 自动加载机制）
+     *
+     * ⚠️ 必须在 pairing/setup 成功（即 register response 返回模板）后才调用，
+     * 不能在安装期 / 没有 pair_token 时调用。
+     */
+    applySafetyTemplates(templates: SafetyTemplates): void;
+}

package/dist/adapter.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * CorePlatformAdapter — core 知道的 6 件 adapter 必须做的事。
+ *
+ * connector / zylos-cutie / 任何未来 adapter 都实现这个接口。core 不假设
+ * 平台命名、不假设进程管理（systemd / PM2）、不假设网络协议（HTTP / CLI）。
+ *
+ * Generic `C` = adapter 自己的 platform-specific config 类型。OpenClaw /
+ * Hermes / 未来 zylos-cutie 各自实例化自己的 C，编译期隔离 adapter 之间的
+ * 字段访问（约束 2）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/dist/connection.d.ts

@@ -0,0 +1,63 @@
+/**
+ * ConnectorConnection — connector 协议主循环（WS 连接 / 心跳 / 任务派发 /
+ * 自升级触发）。core 不假设：
+ *   - 进程管理（systemd / PM2 / launchd / Zylos hooks）
+ *   - 配置文件路径 / schema（adapter 包提供 CoreConnectionConfig 即可）
+ *   - 平台命名（agent_platform 是任意 string）
+ *   - logger 实现（通过 deps.logger 注入；缺省 no-op）
+ *   - HTTP 调用方式（adapter.callAgent 决定）
+ *   - 升级方式（adapter.selfUpgrade 决定）
+ */
+import type { CorePlatformAdapter } from './adapter';
+export interface CoreConnectionConfig {
+    connector_id: string;
+    connector_token: string;
+    server_url: string;
+    ws_url: string;
+    /** 'openclaw' / 'hermes' / 未来 'zylos' — core 仅作为 envelope 的 agent_platform 字段透传 */
+    agent_platform: string;
+    /** 服务端可在 hello_ok 中下调，保存当前生效值用于 setInterval 周期 */
+    heartbeat_interval_seconds: number;
+}
+export interface ConnectorConnectionLogger {
+    info: (msg: string, ...args: unknown[]) => void;
+    warn: (msg: string, ...args: unknown[]) => void;
+    error: (msg: string, ...args: unknown[]) => void;
+}
+export interface ConnectorConnectionDeps {
+    config: CoreConnectionConfig;
+    adapter: CorePlatformAdapter;
+    /** adapter 自己的版本号（packages/connector 的 package.json version） */
+    connectorVersion: string;
+    /** 日志钩子，core 不假设 logger 实现 */
+    logger?: ConnectorConnectionLogger;
+}
+export declare class ConnectorConnection {
+    private config;
+    private adapter;
+    private connectorVersion;
+    private log;
+    private ws;
+    private heartbeatTimer;
+    private reconnectTimer;
+    private reconnectDelay;
+    private maxReconnectDelay;
+    private running;
+    private authFailCount;
+    private readonly maxAuthFails;
+    private lastError;
+    private upgrading;
+    private upgradeFailedAt;
+    constructor(deps: ConnectorConnectionDeps);
+    start(): void;
+    stop(): void;
+    private cleanup;
+    private connect;
+    private scheduleReconnect;
+    private handleMessage;
+    private handleTask;
+    private startHeartbeat;
+    private doHeartbeat;
+    private triggerSelfUpgrade;
+    private send;
+}

package/dist/connection.js

@@ -0,0 +1,263 @@
+"use strict";
+/**
+ * ConnectorConnection — connector 协议主循环（WS 连接 / 心跳 / 任务派发 /
+ * 自升级触发）。core 不假设：
+ *   - 进程管理（systemd / PM2 / launchd / Zylos hooks）
+ *   - 配置文件路径 / schema（adapter 包提供 CoreConnectionConfig 即可）
+ *   - 平台命名（agent_platform 是任意 string）
+ *   - logger 实现（通过 deps.logger 注入；缺省 no-op）
+ *   - HTTP 调用方式（adapter.callAgent 决定）
+ *   - 升级方式（adapter.selfUpgrade 决定）
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectorConnection = void 0;
+const ws_1 = __importDefault(require("ws"));
+const protocol_1 = require("./protocol");
+const NOOP_LOGGER = {
+    info: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+};
+class ConnectorConnection {
+    config;
+    adapter;
+    connectorVersion;
+    log;
+    ws = null;
+    heartbeatTimer = null;
+    reconnectTimer = null;
+    reconnectDelay = 3000;
+    maxReconnectDelay = 60000;
+    running = false;
+    authFailCount = 0;
+    maxAuthFails = 5;
+    lastError;
+    upgrading = false;
+    upgradeFailedAt = 0;
+    constructor(deps) {
+        this.config = deps.config;
+        this.adapter = deps.adapter;
+        this.connectorVersion = deps.connectorVersion;
+        this.log = deps.logger ?? NOOP_LOGGER;
+    }
+    start() {
+        this.running = true;
+        this.connect();
+    }
+    stop() {
+        this.running = false;
+        this.cleanup();
+        this.log.info('Connector stopped');
+    }
+    cleanup() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.removeAllListeners();
+            if (this.ws.readyState === ws_1.default.OPEN || this.ws.readyState === ws_1.default.CONNECTING) {
+                this.ws.close();
+            }
+            this.ws = null;
+        }
+    }
+    connect() {
+        if (!this.running)
+            return;
+        this.cleanup();
+        let wsEndpoint;
+        const rawWsUrl = this.config.ws_url || '';
+        if (rawWsUrl.startsWith('wss://') || rawWsUrl.startsWith('ws://')) {
+            wsEndpoint = rawWsUrl;
+        }
+        else if (rawWsUrl.startsWith('/')) {
+            wsEndpoint = this.config.server_url.replace(/^http/, 'ws') + rawWsUrl;
+        }
+        else {
+            wsEndpoint = this.config.server_url.replace(/^http/, 'ws') + '/v1/connector/ws';
+        }
+        const wsUrl = `${wsEndpoint}?connector_id=${encodeURIComponent(this.config.connector_id)}`;
+        this.log.info(`Connecting to ${wsEndpoint}...`);
+        this.ws = new ws_1.default(wsUrl, {
+            headers: {
+                'Authorization': `Bearer ${this.config.connector_token}`,
+            },
+            handshakeTimeout: 10000,
+        });
+        this.ws.on('open', () => {
+            this.log.info('WebSocket connected');
+            this.reconnectDelay = 3000;
+            this.authFailCount = 0;
+            // Send hello, heartbeat starts after hello_ok
+            this.send({
+                type: 'hello',
+                connector_id: this.config.connector_id,
+                protocol_version: protocol_1.PROTOCOL_VERSION,
+                connector_version: this.connectorVersion,
+            });
+        });
+        this.ws.on('message', (raw) => {
+            try {
+                const msg = JSON.parse(raw.toString());
+                this.handleMessage(msg);
+            }
+            catch {
+                this.log.error('Failed to parse message:', raw.toString().slice(0, 200));
+            }
+        });
+        this.ws.on('close', (code, reason) => {
+            this.log.warn(`WebSocket closed: ${code} ${reason.toString()}`);
+            this.scheduleReconnect();
+        });
+        this.ws.on('error', (err) => {
+            this.log.error('WebSocket error:', err.message);
+            if (err.message.includes('403') || err.message.includes('401')) {
+                this.authFailCount++;
+                if (this.authFailCount >= this.maxAuthFails) {
+                    this.log.error(`Authentication failed ${this.maxAuthFails} times consecutively. Token is likely invalid.`);
+                    this.log.error('Run "cutie-connector reset" then re-pair with a new token.');
+                    this.stop();
+                }
+            }
+        });
+    }
+    scheduleReconnect() {
+        if (!this.running)
+            return;
+        this.cleanup();
+        this.log.info(`Reconnecting in ${this.reconnectDelay / 1000}s...`);
+        this.reconnectTimer = setTimeout(() => {
+            this.connect();
+        }, this.reconnectDelay);
+        this.reconnectDelay = Math.min(this.reconnectDelay * 1.5, this.maxReconnectDelay);
+    }
+    handleMessage(msg) {
+        switch (msg.type) {
+            case 'hello_ok':
+                this.log.info(`Server hello_ok: max_concurrency=${msg.max_concurrency}, heartbeat=${msg.heartbeat_interval_seconds}s`);
+                if (msg.heartbeat_interval_seconds > 0) {
+                    this.config.heartbeat_interval_seconds = msg.heartbeat_interval_seconds;
+                }
+                this.startHeartbeat();
+                break;
+            case 'task.push':
+                this.handleTask(msg);
+                break;
+            case 'heartbeat_ack':
+                if (msg.upgrade_required) {
+                    this.log.info(`Upgrade available: ${this.connectorVersion} → ${msg.target_version}`);
+                    this.triggerSelfUpgrade(msg.target_version);
+                }
+                break;
+            default:
+                this.log.warn('Unknown message type:', msg.type);
+        }
+    }
+    async handleTask(task) {
+        this.log.info(`Task received: ${task.task_id} (${task.task_type}/${task.payload.scene})`);
+        // Send ack
+        this.send({ type: 'task.ack', task_id: task.task_id });
+        const start = Date.now();
+        try {
+            // adapter.callAgent 内部决定 model 映射 / HTTP / spawn 等实现细节
+            const result = await this.adapter.callAgent(task.payload.message, task.payload.agent_model);
+            this.send({
+                type: 'task.result',
+                task_id: task.task_id,
+                status: 'success',
+                answer: result.answer,
+                latency_ms: result.latency_ms,
+                error_type: null,
+                error_message: null,
+            });
+            this.lastError = undefined;
+            this.log.info(`Task ${task.task_id} completed in ${result.latency_ms}ms`);
+        }
+        catch (err) {
+            const latency_ms = Date.now() - start;
+            const message = err instanceof Error ? err.message : String(err);
+            this.send({
+                type: 'task.result',
+                task_id: task.task_id,
+                status: 'error',
+                answer: '',
+                latency_ms,
+                // error_type 字段名保持 'openclaw_error'：server 端契约名（task 严格禁区，
+                // 不在 PR #3a 里改）。新 platform adapter 后续若要细分错误类型，由 adapter
+                // 在抛出 Error 时把分类写进 message，core 这里仍统一标 'openclaw_error'。
+                error_type: 'openclaw_error',
+                error_message: message,
+            });
+            this.lastError = { type: 'openclaw_error', message };
+            this.log.error(`Task ${task.task_id} failed:`, message);
+        }
+    }
+    startHeartbeat() {
+        if (this.heartbeatTimer)
+            clearInterval(this.heartbeatTimer);
+        const interval = (this.config.heartbeat_interval_seconds || 30) * 1000;
+        // Immediate first heartbeat
+        this.doHeartbeat();
+        this.heartbeatTimer = setInterval(() => {
+            this.doHeartbeat();
+        }, interval);
+    }
+    doHeartbeat() {
+        const agentStatus = this.lastError ? 'error' : 'online';
+        // core 构造通用 envelope（不含平台特定字段）
+        const envelope = {
+            type: 'heartbeat',
+            connector_id: this.config.connector_id,
+            connector_version: this.connectorVersion,
+            protocol_version: protocol_1.PROTOCOL_VERSION,
+            connector_status: 'online',
+            agent_platform: this.config.agent_platform,
+            agent_status: agentStatus,
+            agent_version: '',
+            last_error_type: this.lastError?.type ?? null,
+            last_error_message: this.lastError?.message ?? null,
+            capabilities: this.adapter.getCapabilities(),
+        };
+        // adapter 加平台特定字段（OpenClaw/Hermes: openclaw_status mirror /
+        // hermes_isolation_level / auto_start_configured；zylos-cutie 不加）
+        const finalEnvelope = this.adapter.augmentHeartbeat(envelope);
+        this.send(finalEnvelope);
+    }
+    triggerSelfUpgrade(targetVersion) {
+        if (this.upgrading)
+            return;
+        // 升级失败后冷却 10 分钟再重试
+        if (this.upgradeFailedAt && Date.now() - this.upgradeFailedAt < 600000)
+            return;
+        if (!/^\d+\.\d+\.\d+$/.test(targetVersion)) {
+            this.log.error(`Invalid target version format: ${targetVersion}`);
+            return;
+        }
+        this.upgrading = true;
+        this.log.info(`Auto-upgrading to v${targetVersion}...`);
+        // adapter 决定怎么升级 + 是否 process.exit。core 不假设 systemd / PM2。
+        // 成功路径下 adapter 通常 process.exit(0)，所以这个 promise 不一定 resolve；
+        // 失败路径下 adapter reject，core 重置 upgrading flag + 记录失败时间冷却 10min。
+        this.adapter.selfUpgrade(targetVersion).catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            this.log.error(`Auto-upgrade failed: ${message}`);
+            this.upgrading = false;
+            this.upgradeFailedAt = Date.now();
+        });
+    }
+    send(data) {
+        if (this.ws?.readyState === ws_1.default.OPEN) {
+            this.ws.send(JSON.stringify(data));
+        }
+    }
+}
+exports.ConnectorConnection = ConnectorConnection;
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"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"}

package/dist/http.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Cutie Connector HTTP 客户端
+ *
+ * 通用 HTTP 调用 + 业务级 register / fetchStrategyKnowledge。
+ * core 不假设 platform 命名（OpenClaw / Hermes / Zylos），不依赖 os 模块（device_name
+ * 由 adapter 调用方传入）。
+ */
+import type { RegisterResult } from './protocol';
+export interface ApiResponse<T = unknown> {
+    err_code: number;
+    err_msg: string;
+    data: T;
+}
+export interface StrategyKnowledgeResult {
+    strategy_md: string | null;
+    updated: boolean;
+}
+export declare function buildFormData(params: Record<string, string | number>): string;
+export declare function post<T>(baseUrl: string, path: string, params: Record<string, string | number>): Promise<ApiResponse<T>>;
+export declare function get<T>(baseUrl: string, path: string, token: string): Promise<ApiResponse<T>>;
+export interface RegisterParams {
+    pairToken: string;
+    /** os.platform() 结果 — core 不假设具体值 */
+    platform: string;
+    /** os.hostname() 结果 */
+    deviceName: string;
+    /** adapter 自己的版本号（@cutie-crypto/connector 的 package.json version） */
+    connectorVersion: string;
+    /** 'openclaw' / 'hermes' / future 'zylos' — core 不约束 union */
+    agentPlatform: string;
+    agentVersion: string;
+    /**
+     * 约束 8：adapter 上报的能力。OpenClaw/Hermes 当前 []；zylos-cutie 未来可能上报
+     * `['sandbox=srt', 'runtime=claude']`。Server 暂不读，字段是 future-proof 占位。
+     * 缺省（undefined）时 form 不带 capabilities 字段，保持完全旧 wire 兼容。
+     */
+    capabilities?: string[];
+}
+export declare function register(serverUrl: string, params: RegisterParams): Promise<RegisterResult>;
+export declare function fetchStrategyKnowledge(serverUrl: string, connectorToken: string): Promise<StrategyKnowledgeResult>;

package/dist/http.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Cutie Connector HTTP 客户端
+ *
+ * 通用 HTTP 调用 + 业务级 register / fetchStrategyKnowledge。
+ * core 不假设 platform 命名（OpenClaw / Hermes / Zylos），不依赖 os 模块（device_name
+ * 由 adapter 调用方传入）。
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFormData = buildFormData;
+exports.post = post;
+exports.get = get;
+exports.register = register;
+exports.fetchStrategyKnowledge = fetchStrategyKnowledge;
+const https_1 = __importDefault(require("https"));
+const http_1 = __importDefault(require("http"));
+const url_1 = require("url");
+const protocol_1 = require("./protocol");
+function buildFormData(params) {
+    return Object.entries(params)
+        .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
+        .join('&');
+}
+function post(baseUrl, path, params) {
+    return new Promise((resolve, reject) => {
+        const url = new url_1.URL(path, baseUrl);
+        const body = buildFormData(params);
+        const mod = url.protocol === 'https:' ? https_1.default : http_1.default;
+        const req = mod.request(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                'Content-Length': Buffer.byteLength(body),
+            },
+            timeout: 15000,
+        }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => {
+                try {
+                    resolve(JSON.parse(data));
+                }
+                catch {
+                    reject(new Error(`Invalid JSON response: ${data.slice(0, 200)}`));
+                }
+            });
+        });
+        req.on('error', reject);
+        req.on('timeout', () => { req.destroy(); reject(new Error('Request timeout')); });
+        req.write(body);
+        req.end();
+    });
+}
+function get(baseUrl, path, token) {
+    return new Promise((resolve, reject) => {
+        const url = new url_1.URL(path, baseUrl);
+        const mod = url.protocol === 'https:' ? https_1.default : http_1.default;
+        const req = mod.request(url, {
+            method: 'GET',
+            headers: { 'Authorization': `Bearer ${token}` },
+            timeout: 15000,
+        }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => {
+                try {
+                    resolve(JSON.parse(data));
+                }
+                catch {
+                    reject(new Error(`Invalid JSON response: ${data.slice(0, 200)}`));
+                }
+            });
+        });
+        req.on('error', reject);
+        req.on('timeout', () => { req.destroy(); reject(new Error('Request timeout')); });
+        req.end();
+    });
+}
+async function register(serverUrl, params) {
+    const formParams = {
+        pair_token: params.pairToken,
+        platform: params.platform,
+        device_name: params.deviceName,
+        connector_version: params.connectorVersion,
+        protocol_version: protocol_1.PROTOCOL_VERSION,
+        agent_platform: params.agentPlatform,
+        agent_version: params.agentVersion,
+    };
+    // form-urlencoded 不天然支持数组，用 JSON 字符串单字段编码（server 读到 string 后 JSON.parse）。
+    // 仅在调用方显式传 capabilities 时才加字段；undefined 时不带，跟旧 wire 字节级一致。
+    if (params.capabilities !== undefined) {
+        formParams.capabilities = JSON.stringify(params.capabilities);
+    }
+    const res = await post(serverUrl, '/v1/connector/register', formParams);
+    if (res.err_code !== 100) {
+        throw new Error(`Register failed (${res.err_code}): ${res.err_msg}`);
+    }
+    return res.data;
+}
+async function fetchStrategyKnowledge(serverUrl, connectorToken) {
+    const res = await get(serverUrl, '/v1/connector/strategy-knowledge', connectorToken);
+    if (res.err_code !== 100) {
+        throw new Error(`Fetch strategy knowledge failed (${res.err_code}): ${res.err_msg}`);
+    }
+    return res.data;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @cutie-crypto/connector-core — Node.js only.
+ *
+ * `./protocol` 是纯类型 / 常量，本身可在任何 JS 运行时跑；
+ * `./http` 用了 node:https / node:http / node:url + Buffer，**不能在 browser / RN 跑**。
+ *
+ * 本 barrel 同时导出两者。如果未来出现非 Node 消费者（极少见 — 当前所有 adapter
+ * 都是 Node-side：cutie-connector 走 systemd / zylos-cutie 走 PM2），考虑改用
+ * subpath export（"./protocol" / "./http"）拆开。
+ */
+export * from './protocol';
+export * from './http';
+export * from './adapter';
+export * from './connection';

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @cutie-crypto/connector-core — Node.js only.
+ *
+ * `./protocol` 是纯类型 / 常量，本身可在任何 JS 运行时跑；
+ * `./http` 用了 node:https / node:http / node:url + Buffer，**不能在 browser / RN 跑**。
+ *
+ * 本 barrel 同时导出两者。如果未来出现非 Node 消费者（极少见 — 当前所有 adapter
+ * 都是 Node-side：cutie-connector 走 systemd / zylos-cutie 走 PM2），考虑改用
+ * subpath export（"./protocol" / "./http"）拆开。
+ */
+__exportStar(require("./protocol"), exports);
+__exportStar(require("./http"), exports);
+__exportStar(require("./adapter"), exports);
+__exportStar(require("./connection"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;GASG;AACH,6CAA2B;AAC3B,yCAAuB;AACvB,4CAA0B;AAC1B,+CAA6B"}

package/dist/protocol.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Cutie Connector 协议定义
+ *
+ * 这里只放协议 types 和版本常量，不放任何运行环境相关代码（HTTP/WS/CLI/fs）。
+ * Server <-> Connector envelope 字段必须与现网保持完全一致，新增字段必须可选。
+ */
+/** WebSocket 协议版本，server hello / register / heartbeat envelope 都带这个字段 */
+export declare const PROTOCOL_VERSION = 1;
+/**
+ * connector-core 包自身版本（独立于具体 adapter 的版本号）。
+ *
+ * 注意：发送给 server 的 envelope 字段 `connector_version` 报的是 *adapter* 包版本
+ * （例如 @cutie-crypto/connector 的 2.0.x），不是 core 版本。adapter 自己读自己的
+ * package.json 来填这个字段，core 不参与。
+ *
+ * CORE_VERSION 仅供后续 adapter 在 capability 上报时引用，PR #1 暂不进入任何 envelope。
+ *
+ * ⚠️ 发版纪律：CORE_VERSION 与 packages/connector-core/package.json 的 version 字段
+ * 必须同步更新。
+ *
+ * 实施说明（PR #4 决策）：原计划 `import pkg from '../package.json'`，但需要把
+ * tsconfig rootDir 拉到 package 根（或 include 加 package.json），结果 dist 产物
+ * 变成 `dist/src/index.js`，污染 published tarball 路径。权衡后选择"hardcode +
+ * 注释 + 单测兜底"：connector-core/src/protocol.test.ts 强校验
+ * `CORE_VERSION === pkg.version`，bump 时漏改即被单测拦截。BACKLOG（PR #4 后续）：
+ * 等到 connector-core 真正公开发布时再考虑 dist 路径调整 / 改 build 脚本注入。
+ */
+export declare const CORE_VERSION = "0.1.0";
+export interface TaskPayload {
+    kol_user_id: string;
+    caller_user_id: string;
+    scene: string;
+    agent_model: string;
+    message: string;
+}
+export interface TaskPush {
+    type: 'task.push';
+    task_id: string;
+    task_type: string;
+    timeout_seconds: number;
+    payload: TaskPayload;
+}
+export interface HelloOk {
+    type: 'hello_ok';
+    max_concurrency: number;
+    heartbeat_interval_seconds: number;
+}
+export interface HeartbeatAck {
+    type: 'heartbeat_ack';
+    target_version: string;
+    upgrade_required: boolean;
+}
+export type ServerMessage = TaskPush | HelloOk | HeartbeatAck;
+export interface RegisterResult {
+    connector_id: string;
+    connector_token: string;
+    ws_url: string;
+    heartbeat_interval_seconds: number;
+    min_supported_version: string;
+    target_version: string;
+    agents_md?: string;
+    soul_md?: string;
+}
+export interface TaskResultMessage {
+    type: 'task.result';
+    task_id: string;
+    status: 'success' | 'error';
+    answer: string;
+    latency_ms: number;
+    /** 失败时填错误码，成功时为 null */
+    error_type: string | null;
+    /** 失败时填错误描述，成功时为 null */
+    error_message: string | null;
+}

package/dist/protocol.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Cutie Connector 协议定义
+ *
+ * 这里只放协议 types 和版本常量，不放任何运行环境相关代码（HTTP/WS/CLI/fs）。
+ * Server <-> Connector envelope 字段必须与现网保持完全一致，新增字段必须可选。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CORE_VERSION = exports.PROTOCOL_VERSION = void 0;
+/** WebSocket 协议版本，server hello / register / heartbeat envelope 都带这个字段 */
+exports.PROTOCOL_VERSION = 1;
+/**
+ * connector-core 包自身版本（独立于具体 adapter 的版本号）。
+ *
+ * 注意：发送给 server 的 envelope 字段 `connector_version` 报的是 *adapter* 包版本
+ * （例如 @cutie-crypto/connector 的 2.0.x），不是 core 版本。adapter 自己读自己的
+ * package.json 来填这个字段，core 不参与。
+ *
+ * CORE_VERSION 仅供后续 adapter 在 capability 上报时引用，PR #1 暂不进入任何 envelope。
+ *
+ * ⚠️ 发版纪律：CORE_VERSION 与 packages/connector-core/package.json 的 version 字段
+ * 必须同步更新。
+ *
+ * 实施说明（PR #4 决策）：原计划 `import pkg from '../package.json'`，但需要把
+ * tsconfig rootDir 拉到 package 根（或 include 加 package.json），结果 dist 产物
+ * 变成 `dist/src/index.js`，污染 published tarball 路径。权衡后选择"hardcode +
+ * 注释 + 单测兜底"：connector-core/src/protocol.test.ts 强校验
+ * `CORE_VERSION === pkg.version`，bump 时漏改即被单测拦截。BACKLOG（PR #4 后续）：
+ * 等到 connector-core 真正公开发布时再考虑 dist 路径调整 / 改 build 脚本注入。
+ */
+exports.CORE_VERSION = '0.1.0';
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,yEAAyE;AAC5D,QAAA,gBAAgB,GAAG,CAAC,CAAC;AAElC;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,YAAY,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@cutie-crypto/connector-core",
+  "version": "0.1.0",
+  "description": "Cutie Connector core protocol types and shared abstractions (Node.js only — HTTP transport uses node:https/http)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": ["cutie", "connector", "protocol", "ai", "kol"],
+  "author": "Cutie Team",
+  "license": "MIT",
+  "files": ["dist", "README.md"],
+  "engines": { "node": ">=18" },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0"
+  }
+}