@gholl-studio/pier-connector 0.3.11 → 0.3.13

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@gholl-studio/pier-connector",
     "author": "gholl",
-    "version": "0.3.11",
+    "version": "0.3.13",
     "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';
 
@@ -14,62 +19,32 @@ export async function handleInbound(
         return;
     }
 
-    // 1. Resolve Global Configuration
+    // 1. Resolve Account-Scoped Configuration
     const rootConfig = api.config || {};
     
-    // 2. Resolve Agent Route via SDK
+    /**
+     * ★ Multi-Account Configuration Isolation: Build account-level ClawdbotConfig
+     * 
+     * In multi-account scenarios, each account can have independent agent bindings.
+     * The SDK's resolveAgentRoute looks into cfg.channels.pier. 
+     * By injecting the current robot's config here, we ensure the SDK finds 
+     * the correct agentId for this specific account.
+     */
+    const accountScopedCfg = {
+        ...rootConfig,
+        channels: { ...rootConfig.channels, pier: robot.config }
+    };
+
+    // 2. Resolve Agent Route via SDK with Scoped Config
     const route = api.runtime.channel.routing.resolveAgentRoute({
-        cfg: rootConfig,
+        cfg: accountScopedCfg,
         channel: 'pier',
         accountId: inbound.accountId,
         peer: { kind: 'direct', id: jobId }
     });
 
-    // 3. Robust Routing Decision Tree
-    let finalAgentId = null;
-    let routingSource = 'unresolved';
-
-    // A. Check explicit account-level binding in plugin local config
-    if (robot.config.agentId && robot.config.agentId !== 'main' && robot.config.agentId !== 'default') {
-        finalAgentId = robot.config.agentId;
-        routingSource = 'plugin-local-config';
-    }
-
-    // B. Check Global Bindings
-    if (!finalAgentId) {
-        const bindings = Array.isArray(rootConfig.bindings) ? rootConfig.bindings : [];
-        const binding = bindings.find((bi: any) => 
-            bi.match?.channel === 'pier' && 
-            (bi.match?.accountId === inbound.accountId || bi.match?.account === inbound.accountId)
-        );
-        if (binding?.agentId && binding.agentId !== 'main') {
-            finalAgentId = binding.agentId;
-            routingSource = 'manual-global-bindings-match';
-        }
-    }
-
-    // C. SDK Routing Result
-    if (!finalAgentId && route.agentId && route.agentId !== 'main' && route.agentId !== 'default') {
-        finalAgentId = route.agentId;
-        routingSource = 'sdk-global-bindings';
-    }
-
-    // D. Name-Matching Fallback
-    if (!finalAgentId && inbound.accountId && inbound.accountId !== 'default' && inbound.accountId !== 'main') {
-        const agents = (rootConfig as any).agents?.list || {};
-        const agentExists = Array.isArray(agents) ? agents.some((a: any) => a.id === inbound.accountId) : !!agents[inbound.accountId];
-        
-        if (agentExists) {
-            finalAgentId = inbound.accountId;
-            routingSource = 'account-agent-name-match';
-        }
-    }
-
-    // E. Ultimate Fallback
-    if (!finalAgentId) {
-        finalAgentId = route.agentId || 'main';
-        routingSource = route.agentId ? 'sdk-default-fallback' : 'hardcoded-main-fallback';
-    }
+    const finalAgentId = route.agentId || 'main';
+    const routingSource = route.agentId ? 'sdk-scoped-route' : 'sdk-default-fallback';
 
     logger.info(`[pier-connector] Routing account '${inbound.accountId}' -> agent '${finalAgentId}' (Source: ${routingSource})`);
 
@@ -105,6 +80,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 +100,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;
@@ -112,8 +117,9 @@ const register = (api: PierPluginApi) => {
             },
             required: ['task']
         },
-        async execute(_id, params) {
-            const robot = instances.get(params.accountId || 'default') || instances.values().next().value;
+        async execute(_id, params, ctx: any) {
+            const accountId = params.accountId || ctx?.metadata?.accountId || ctx?.accountId || 'default';
+            const robot = instances.get(accountId) || instances.values().next().value;
             if (!robot || robot.connectionStatus !== 'connected') {
                 return { 
                     content: [{ type: 'text', text: 'Robot not connected' }],
@@ -145,7 +151,7 @@ const register = (api: PierPluginApi) => {
                 required: ['jobId', 'text']
             },
             async execute(_id, params, ctx: any) {
-                const accountId = params.accountId || 'default';
+                const accountId = params.accountId || ctx?.metadata?.accountId || ctx?.accountId || 'default';
                 const robot = instances.get(accountId) || instances.values().next().value;
                 if (!robot || robot.connectionStatus !== 'connected') {
                     return { content: [{ type: 'text', text: 'Error: Robot not connected' }], details: {} };
@@ -201,8 +207,8 @@ const register = (api: PierPluginApi) => {
                 },
                 required: ['jobId', ...Object.keys(extraParams)]
             },
-            async execute(_id, params) {
-                const accountId = params.accountId || 'default';
+            async execute(_id, params, ctx: any) {
+                const accountId = params.accountId || ctx?.metadata?.accountId || ctx?.accountId || 'default';
                 const robot = instances.get(accountId) || instances.values().next().value;
                 if (!robot || robot.connectionStatus !== 'connected') {
                     return { content: [{ type: 'text', text: 'Error: Robot not connected' }], details: {} };
@@ -260,8 +266,9 @@ const register = (api: PierPluginApi) => {
             type: 'object',
             properties: { accountId: { type: 'string' } }
         },
-        async execute(_id, params) {
-            const robot = instances.get(params.accountId || 'default') || instances.values().next().value;
+        async execute(_id, params, ctx: any) {
+            const accountId = params.accountId || ctx?.metadata?.accountId || ctx?.accountId || 'default';
+            const robot = instances.get(accountId) || instances.values().next().value;
             if (!robot) return { content: [{ type: 'text', text: 'Error: Robot not found' }], details: {} };
             try {
                 const profile = await robot.client.getUserProfile(robot.config.secretKey);

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 {