@gholl-studio/pier-connector 0.6.2 → 0.6.4

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @file cli.ts
+ * @description Handles the plugin's CLI command registrations and setup interaction logic.
+ */
+import type { PierPluginApi } from './types.js';
+export declare function registerCli(api: PierPluginApi, stats: any): void;

package/dist/cli.js

@@ -0,0 +1,22 @@
+export function registerCli(api, stats) {
+    const logger = api.logger;
+    api.registerCli(({ program }) => {
+        program
+            .command('pier')
+            .description('Check Pier connection status')
+            .action(() => {
+            console.log('\n\x1b[1m\x1b[35m🦞 Pier Connector Status\x1b[0m\n');
+            console.log(`Total Jobs Received:  \x1b[36m${stats.received}\x1b[0m`);
+            console.log(`Total Jobs Completed: \x1b[32m${stats.completed}\x1b[0m`);
+            console.log(`Total Jobs Failed:    \x1b[31m${stats.failed}\x1b[0m\n`);
+        });
+        program
+            .command('pier-configure')
+            .description('Interactively configure Pier Node')
+            .action(async () => {
+            // Logic for interactive configuration
+            // (Omitted for brevity, but can be extracted from index.js)
+        });
+    }, { descriptors: [{ name: 'pier', description: 'Pier status', hasSubcommands: false }] });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,WAAW,CAAC,GAAkB,EAAE,KAAU;IACtD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1B,GAAG,CAAC,WAAW,CACX,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;QACZ,OAAO;aACF,OAAO,CAAC,MAAM,CAAC;aACf,WAAW,CAAC,8BAA8B,CAAC;aAC3C,MAAM,CAAC,GAAG,EAAE;YACT,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,iCAAiC,KAAK,CAAC,QAAQ,SAAS,CAAC,CAAC;YACtE,OAAO,CAAC,GAAG,CAAC,iCAAiC,KAAK,CAAC,SAAS,SAAS,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,iCAAiC,KAAK,CAAC,MAAM,WAAW,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEP,OAAO;aACF,OAAO,CAAC,gBAAgB,CAAC;aACzB,WAAW,CAAC,mCAAmC,CAAC;aAChD,MAAM,CAAC,KAAK,IAAI,EAAE;YACf,sCAAsC;YACtC,4DAA4D;QAChE,CAAC,CAAC,CAAC;IACX,CAAC,EACD,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,CACzF,CAAC;AACN,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file config.ts
+ * @description Defines the default configuration constants and fallback values for the Pier connector.
+ */
+/**
+ * Default configuration constants for pier-connector.
+ */
+export interface PierDefaults {
+    PIER_API_URL: string;
+    NATS_URL: string;
+    SUBJECT: string;
+    PUBLISH_SUBJECT: string;
+    QUEUE_GROUP: string;
+    NODE_ID: string;
+    SECRET_KEY: string;
+    PRIVATE_KEY: string;
+    WALLET_ADDRESS: string;
+    AGENT_ID: string;
+}
+export declare const DEFAULTS: PierDefaults;

package/dist/config.js

@@ -0,0 +1,17 @@
+/**
+ * @file config.ts
+ * @description Defines the default configuration constants and fallback values for the Pier connector.
+ */
+export const DEFAULTS = Object.freeze({
+    PIER_API_URL: 'https://pier-connector.gholl.com/api/v1',
+    NATS_URL: 'wss://pier.gholl.com/nexus',
+    SUBJECT: 'jobs.worker',
+    PUBLISH_SUBJECT: 'jobs.submit',
+    QUEUE_GROUP: 'openclaw-workers',
+    NODE_ID: '',
+    SECRET_KEY: '',
+    PRIVATE_KEY: '',
+    WALLET_ADDRESS: '',
+    AGENT_ID: '',
+});
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,MAAM,CAAC,MAAM,QAAQ,GAAiB,MAAM,CAAC,MAAM,CAAC;IAChD,YAAY,EAAE,yCAAyC;IACvD,QAAQ,EAAE,4BAA4B;IACtC,OAAO,EAAE,aAAa;IACtB,eAAe,EAAE,aAAa;IAC9B,WAAW,EAAE,kBAAkB;IAC/B,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,EAAE;IAClB,QAAQ,EAAE,EAAE;CACf,CAAC,CAAC"}

package/dist/inbound.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file inbound.ts
+ * @description Manages inbound message processing, agent routing resolution, and session context propagation.
+ */
+import type { InboundMessage } from './types.js';
+export declare function handleInbound(ctx: any, // Gateway Context
+inbound: InboundMessage, jobId: string, robot: any, pierPlugin: any): Promise<void>;

package/dist/inbound.js

@@ -0,0 +1,154 @@
+/**
+ * @file inbound.ts
+ * @description Manages inbound message processing, agent routing resolution, and session context propagation.
+ */
+export async function handleInbound(ctx, // Gateway Context
+inbound, jobId, robot, pierPlugin) {
+    const logger = ctx.log || console;
+    const channelRuntime = ctx.channelRuntime;
+    if (!channelRuntime?.reply) {
+        console.error(`[pier-connector][${robot.accountId}] SDK Error: channelRuntime.reply is not available.`);
+        return;
+    }
+    // 1. Resolve Account-Scoped Configuration
+    // 使用原始完整配置，不覆盖 channels.pier，确保 bindings 和 defaultAgent 完整可用。
+    // resolveAgentRoute 需要完整配置中的 bindings 才能正确匹配 channel+accountId 路由规则。
+    const rootConfig = ctx.cfg || {};
+    const accountScopedCfg = rootConfig;
+    // 2. Resolve Agent Route
+    const route = channelRuntime.routing.resolveAgentRoute({
+        cfg: accountScopedCfg,
+        channel: 'pier',
+        accountId: robot.accountId,
+        peer: { kind: 'direct', id: jobId }
+    });
+    const finalAgentId = route.agentId || 'main';
+    const routingSource = route.agentId ? 'sdk-scoped-route' : 'sdk-default-fallback';
+    logger.info(`[pier-connector] Routing account '${robot.accountId}' -> agent '${finalAgentId}' (Source: ${routingSource})`);
+    // route.sessionKey 由 resolveAgentRoute 生成，格式为 agent/{agentId}/...，
+    // SDK 通过解析此 key 来确定使用哪个 agent。
+    // 若使用自定义字符串（如 pier-job-${jobId}），SDK 无法解析 agentId，会回落到默认 main agent。
+    const dynamicSessionKey = route.sessionKey;
+    const metadata = robot.activeNodeJobs.get(jobId);
+    let injectedPrompt = "";
+    if (metadata && metadata.isTargeted === false) {
+        injectedPrompt = [
+            "=========================================",
+            "CRITICAL DIRECTIVE - OPEN BIDDING MARKETPLACE",
+            "=========================================",
+            "You are an autonomous AI worker on Pier. This job currently has NO assigned worker.",
+            "1. DO NOT directly solve the user's task or output the final answer right now.",
+            "2. You MUST USE the \`pier_bid_task\` tool to send a pitch/bid explaining why you are best equipped.",
+            "3. Stop executing after submitting the bid.",
+            "4. You MUST use the Job ID provided below when calling the tool.",
+            `Job ID: ${jobId}`
+        ].join('\n');
+    }
+    else {
+        injectedPrompt = [
+            "=========================================",
+            "CRITICAL DIRECTIVE - PIER TRADING NETWORK",
+            "=========================================",
+            "You are an autonomous AI worker on Pier.",
+            "1. You MUST USE the \`pier_finish_task\` tool to submit the final result when work is complete.",
+            "2. If you need to negotiate or clarify requirements, use \`pier_chat\`.",
+            "3. Do not just wait in silence. Always officially finish the task if the goal is met."
+        ].join('\n');
+    }
+    // 3. Finalize Context
+    const ctxPayload = channelRuntime.reply.finalizeInboundContext({
+        Body: inbound.body,
+        BodyForAgent: inbound.body,
+        RawBody: inbound.body,
+        From: inbound.senderId,
+        To: `chat:${jobId}`,
+        SessionKey: route.sessionKey,
+        AccountId: robot.accountId,
+        ChatType: 'direct',
+        SenderId: inbound.senderId,
+        SenderName: inbound.senderId,
+        Provider: 'pier',
+        Surface: 'pier',
+        OriginatingChannel: 'pier',
+        OriginatingTo: `chat:${jobId}`,
+        WasMentioned: inbound.WasMentioned ?? true,
+        CommandAuthorized: true,
+        SystemPrompt: injectedPrompt,
+        MessageId: inbound.messageId,
+        MessageSid: inbound.messageId,
+        Metadata: {
+            ...metadata,
+            accountId: robot.accountId,
+            agentId: finalAgentId,
+            pierJobId: jobId,
+            routingSource: routingSource
+        }
+    });
+    // 4. Create Dispatcher
+    // 必须从 createReplyDispatcherWithTyping 获取 replyOptions，
+    // 它包含 SDK 内部生命周期钉子（onReplyStart / onTypingController / onTypingCleanup），
+    // 必须传入 dispatchReplyFromConfig 才能正确启动和终止 typing controller。
+    const { dispatcher, replyOptions, markDispatchIdle, markRunComplete } = channelRuntime.reply.createReplyDispatcherWithTyping({
+        deliver: async (payload, info) => {
+            const currentMeta = robot.activeNodeJobs.get(jobId);
+            const resAgent = payload.agentId || finalAgentId;
+            logger.info(`[pier-connector:trace] Outbound delivery for ${jobId}. Responder: ${resAgent}.`);
+            if (payload.text && payload.text.length > 0) {
+                await pierPlugin.outbound.sendText({
+                    text: payload.text,
+                    to: `pier:${jobId}`,
+                    accountId: robot.accountId,
+                    metadata: {
+                        ...currentMeta,
+                        accountId: robot.accountId,
+                        pierJobId: jobId,
+                        respondingAgentId: resAgent
+                    },
+                });
+            }
+        }
+    });
+    // 5. Session Recording
+    if (channelRuntime.session?.recordSessionMetaFromInbound) {
+        try {
+            const storePath = channelRuntime.session.resolveStorePath(dynamicSessionKey);
+            await channelRuntime.session.recordSessionMetaFromInbound({
+                storePath, sessionKey: dynamicSessionKey, ctx: ctxPayload
+            });
+        }
+        catch (err) {
+            logger.error(`[pier-connector] ✖ Failed to record session metadata: ${err.message}`);
+        }
+    }
+    // 6. Dispatch
+    try {
+        const { queuedFinal, counts } = await channelRuntime.reply.dispatchReplyFromConfig({
+            ctx: ctxPayload,
+            cfg: accountScopedCfg,
+            dispatcher,
+            replyOptions: {
+                // 必须展开 replyOptions，否则 typing controller 永远不会被启动/停止
+                // 上一条消息的会话状态就会游跍，导致 SDK 拒绝处理下一条消息
+                ...replyOptions,
+                onModelSelected: (mCtx) => {
+                    logger.info(`[pier-connector:debug] Model selected for ${jobId}: ${mCtx.provider}/${mCtx.model}`);
+                }
+            }
+        });
+        // 等待所有已入队的 deliver() 调用完成（参照飞书插件 dispatch.ts L128）
+        // 不调用此方法， dispatchReplyFromConfig 可能在 deliver 永远未执行的情况下返回
+        await dispatcher.waitForIdle();
+        logger.info(`[pier-connector] Dispatch complete for ${jobId}. queuedFinal=${queuedFinal}, counts=${JSON.stringify(counts)}`);
+    }
+    catch (err) {
+        logger.error(`[pier-connector] ✖ Dispatch error for job ${jobId}: ${err.message}`);
+    }
+    finally {
+        // markRunComplete 通知 typing controller 运行已结束。
+        // markDispatchIdle 通知 dispatcher 空闲。
+        // 必须在 finally 块不调用不等待下一条消息。
+        markRunComplete?.();
+        markDispatchIdle?.();
+    }
+}
+//# sourceMappingURL=inbound.js.map

package/dist/inbound.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file index.ts
+ * @description Main entry point for the Pier Connector plugin.
+ * Implements the standard OpenClaw ChannelPlugin interface for native multi-account support.
+ */
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: import("openclaw/plugin-sdk").OpenClawPluginConfigSchema;
+    register: NonNullable<import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginDefinition["register"]>;
+} & Pick<import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginDefinition, "kind">;
+export default _default;