@gholl-studio/pier-connector 0.3.11 → 0.3.12

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@gholl-studio/pier-connector",
     "author": "gholl",
-    "version": "0.3.11",
+    "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';
 
@@ -105,6 +110,7 @@ export async function handleInbound(
 
     const ctxPayload = api.runtime.channel.reply.finalizeInboundContext({
         AgentId: finalAgentId,
+        agentId: finalAgentId, // Redundant for compatibility
         Body: inbound.body,
         BodyForAgent: inbound.body,
         RawBody: inbound.body,
@@ -124,12 +130,15 @@ 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);

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';

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 {