@gholl-studio/pier-connector 0.3.1 → 0.3.12

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@gholl-studio/pier-connector",
     "author": "gholl",
-    "version": "0.3.1",
+    "version": "0.3.12",
     "description": "OpenClaw plugin that connects to the Pier job marketplace. Automatically fetches, executes, and reports distributed tasks for rewards.",
     "type": "module",
     "main": "src/index.ts",

package/src/cli.ts

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

package/src/config.ts

@@ -1,3 +1,8 @@
+/**
+ * @file config.ts
+ * @description Defines the default configuration constants and fallback values for the Pier connector.
+ */
+
 /**
  * Default configuration constants for pier-connector.
  */

package/src/inbound.ts

@@ -1,3 +1,8 @@
+/**
+ * @file inbound.ts
+ * @description Manages inbound message processing, agent routing resolution, and session context propagation.
+ */
+
 import type { PierPluginApi, InboundMessage } from './types.js';
 import { truncate } from './job-handler.js';
 
@@ -101,8 +106,11 @@ export async function handleInbound(
         ].join('\n');
     }
 
+    logger.info(`[pier-connector:trace] Finalized inbound context for job ${jobId}. Target Agent: ${finalAgentId}, Session: ${dynamicSessionKey}`);
+
     const ctxPayload = api.runtime.channel.reply.finalizeInboundContext({
         AgentId: finalAgentId,
+        agentId: finalAgentId, // Redundant for compatibility
         Body: inbound.body,
         BodyForAgent: inbound.body,
         RawBody: inbound.body,
@@ -122,15 +130,19 @@ export async function handleInbound(
         MessageId: jobId,
         Metadata: { 
             ...metadata,
+            agentId: finalAgentId, // Pinning in metadata
             accountId: robot.accountId,
             pierJobId: jobId,
             routingSource: routingSource
         }
     });
 
+    logger.info(`[pier-connector:trace] FULL DISPATCH CONTEXT for job ${jobId}: ${JSON.stringify(ctxPayload)}`);
+
     const { dispatcher, markDispatchIdle } = api.runtime.channel.reply.createReplyDispatcherWithTyping({
         deliver: async (payload: any) => {
             const currentMeta = robot.activeNodeJobs.get(jobId);
+            logger.info(`[pier-connector:trace] Outbound delivery triggered for job ${jobId}. Text length: ${payload.text?.length || 0}`);
             await pierChannel.outbound.sendText({
                 text: payload.text,
                 to: `pier:${jobId}`,
@@ -146,16 +158,23 @@ export async function handleInbound(
     if (api.runtime.channel.session?.recordSessionMetaFromInbound) {
         try {
             const storePath = api.runtime.channel.session.resolveStorePath(dynamicSessionKey);
+            logger.info(`[pier-connector:trace] Recording session metadata at ${storePath}`);
             await api.runtime.channel.session.recordSessionMetaFromInbound({
                 storePath, sessionKey: dynamicSessionKey, ctx: ctxPayload
             });
-        } catch (err) {}
+        } catch (err: any) {
+            logger.error(`[pier-connector] ✖ Failed to record session metadata: ${err.message}`);
+        }
     }
 
     try {
+        logger.info(`[pier-connector:trace] Dispatching reply to agent ${finalAgentId}...`);
         await api.runtime.channel.reply.dispatchReplyFromConfig({
             ctx: ctxPayload, cfg: api.config, dispatcher
         });
+        logger.info(`[pier-connector:trace] dispatchReplyFromConfig completed for job ${jobId}`);
+    } catch (err: any) {
+        logger.error(`[pier-connector] ✖ Dispatch error for job ${jobId}: ${err.message}`);
     } finally {
         markDispatchIdle();
     }

package/src/index.ts

@@ -1,3 +1,8 @@
+/**
+ * @file index.ts
+ * @description Main entry point for the Pier Connector plugin. Orchestrates robots, tools, and channel registration.
+ */
+
 import { definePluginEntry } from 'openclaw/plugin-sdk/plugin-entry';
 import { protocol } from '@gholl-studio/pier-sdk';
 const { createRequestPayload } = protocol;

package/src/job-handler.ts

@@ -1,3 +1,8 @@
+/**
+ * @file job-handler.ts
+ * @description Provides helper utilities for parsing Pier jobs, handling responses, and text manipulation.
+ */
+
 import { protocol } from '@gholl-studio/pier-sdk';
 const { normalizeInboundPayload } = protocol;
 

package/src/robot.ts

@@ -1,3 +1,8 @@
+/**
+ * @file robot.ts
+ * @description Implements the PierRobot class, managing NATS connectivity, heartbeat, and job lifecycle.
+ */
+
 import { PierClient, protocol } from '@gholl-studio/pier-sdk';
 const { createRequestPayload, createResultPayload, createErrorPayload } = protocol;
 import { parseJob, safeRespond, truncate } from './job-handler.js';
@@ -120,13 +125,15 @@ export class PierRobot {
                         }
 
                         msg.ack();
-                        await this.onInbound({
+                        const inbound = {
                             accountId: this.accountId,
                             senderId: `pier:${msgPayload.sender_id}`,
                             body: content,
                             jobId: jobId
-                        }, jobId);
-                    } catch (err: any) { this.logger.error(`[pier-connector] Chat err: ${err.message}`); }
+                        };
+                        this.logger.info(`[pier-connector:trace] NATS Chat Message received on PierRobot instance accountId='${this.accountId}'. Passing to handleInbound...`);
+                        await this.onInbound(inbound, jobId);
+                    } catch (err: any) { this.logger.error(`[pier-connector][${this.accountId}] ✖ Failed to process chat message: ${err.message}`); }
                 }
             })();
         } catch (err: any) {

package/src/types/pier-sdk.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @file pier-sdk.d.ts
+ * @description TypeScript declaration file for the @gholl-studio/pier-sdk to support plugin compilation.
+ */
+
 declare module '@gholl-studio/pier-sdk' {
   export class PierClient {
     constructor(config: { apiUrl: string; natsUrl?: string; logger?: any });

package/src/types.ts

@@ -1,3 +1,8 @@
+/**
+ * @file types.ts
+ * @description Centralized TypeScript interface and type definitions for the Pier connector plugin.
+ */
+
 import type { OpenClawPluginApi } from 'openclaw/plugin-sdk/plugin-entry';
 
 export interface PierAccountConfig {