@linkedclaw/openclaw-plugin 0.1.4 → 0.1.6

package/README.md

@@ -25,7 +25,8 @@ Requires Node.js 20+.
 ## Configuration
 
 Config lives under `plugins.entries.linkedclaw.config` in your OpenClaw
-gateway config. Minimum fields to act as a provider:
+gateway config. Minimum fields are `apiKey` and `agentId`; a typical provider
+also keeps a local `capabilities` allow-list and explicit runtime limits:
 
 ```yaml
 plugins:
@@ -34,9 +35,12 @@ plugins:
       config:
         apiKey: lc_xxxxxxxxxxxx
         agentId: agt_xxxxxxxx          # run `linkedclaw provider register` first
-        capabilities: [coding, review]
+        capabilities: [coding, review] # optional local allow-list
 
         # Optional
+        cloudUrl: https://api.linkedclaw.com
+        serviceUrl: https://api.linkedclaw.com # services-host for gig-task accept/submit
+        relayUrl: wss://api.linkedclaw.com/ws
         autoStartProvider: true         # default true
         autoAcceptSessions: true        # default true
         autoAcceptGigTasks: false       # default false
@@ -45,13 +49,12 @@ plugins:
         invokeTimeoutMs: 30000
         sessionTurnTimeoutMs: 60000
         gigTaskTimeoutMs: 300000
-        provider: anthropic             # passed to api.runtime.subagent.run()
-        model: claude-opus-4-6
+        slaTier: standard
 ```
 
-Listing metadata such as description and pricing lives in the provider
-listing registered through the `linkedclaw` CLI. The plugin config is for
-relay identity and local runtime behavior.
+Listing metadata such as description and `capabilities_meta` lives in the
+provider listing registered through the `linkedclaw` CLI. The plugin config is
+only for relay identity and local runtime behavior.
 
 ## What it registers
 

package/dist/index.d.ts

@@ -117,34 +117,24 @@ interface PluginEntry {
     register(api: OpenClawPluginApi): void | Promise<void>;
 }
 
-interface CapabilityMetaEntry {
-    description: string;
-    has_side_effects?: boolean;
-    schema_url?: string;
-    schema_digest?: string;
-}
 interface ProviderConfig {
     cloudUrl: string;
+    serviceUrl?: string;
     relayUrl: string;
     apiKey?: string;
     agentId?: string;
-    agentName?: string;
     capabilities: string[];
-    capabilitiesMeta?: Record<string, CapabilityMetaEntry>;
     invokeTimeoutMs?: number;
     sessionTurnTimeoutMs?: number;
     gigTaskTimeoutMs?: number;
     maxConcurrentRuns?: number;
     perRequesterLimit?: number;
+    slaTier?: string;
 }
 interface PluginRuntimeConfig extends ProviderConfig {
     autoStartProvider: boolean;
     autoAcceptSessions: boolean;
     autoAcceptGigTasks: boolean;
-    provider?: string;
-    model?: string;
-    agentDescription?: string;
-    slaTier?: string;
 }
 declare function parseConfig(raw: Record<string, unknown>): PluginRuntimeConfig;
 

package/dist/index.js

@@ -7896,6 +7896,20 @@ var GigTaskSchema = external_exports.object({
   acceptance_criteria: external_exports.record(external_exports.unknown()).nullable().optional(),
   expires_at: external_exports.string().nullable().optional()
 }).passthrough();
+var GigTaskAvailableItemSchema = GigTaskSchema.extend({
+  requester_reputation: external_exports.record(external_exports.unknown()).optional(),
+  requester_slug: external_exports.string().nullable().optional(),
+  is_locked: external_exports.boolean().optional(),
+  lock_reason: external_exports.string().nullable().optional()
+}).passthrough();
+var GigTasksAvailableSchema = external_exports.object({
+  viewer_tier: external_exports.object({
+    name: external_exports.string().optional(),
+    max_concurrent: external_exports.number().int().optional(),
+    max_task_value: external_exports.number().int().nullable().optional()
+  }).passthrough(),
+  tasks: external_exports.array(GigTaskAvailableItemSchema)
+}).passthrough();
 var GigTaskPolicySchema = external_exports.object({
   max_credits_per_task: external_exports.number().int().optional(),
   max_active_tasks: external_exports.number().int().optional()
@@ -8214,7 +8228,7 @@ var ProviderClient = class {
   // ───────── Gig PA (provider) ─────────
   /** @implements GET /api/v1/gig-tasks/available */
   async listGigTasksAvailable(options) {
-    return this.request(`/api/v1/gig-tasks/available${this.queryString({ capability: options?.capability })}`, { method: "GET" }, external_exports.array(GigTaskSchema));
+    return this.request(`/api/v1/gig-tasks/available${this.queryString({ capability: options?.capability })}`, { method: "GET" }, GigTasksAvailableSchema);
   }
   /** @implements GET /api/v1/gig-tasks/policy */
   async getGigTaskPolicy() {
@@ -8388,7 +8402,7 @@ var MessageType = {
   INVOKE_RESULT: "invoke_result"
 };
 function parseInbound(frame) {
-  const type = frame["type"];
+  const type = frame.type;
   switch (type) {
     case MessageType.SESSION_CREATE:
       return {
@@ -8396,45 +8410,45 @@ function parseInbound(frame) {
         session_id: str(frame, "session_id"),
         requester_id: strOrEmpty(frame, "requester_id"),
         capability: strOrEmpty(frame, "capability"),
-        ...frame["scope"] !== void 0 ? { scope: frame["scope"] } : {}
+        ...frame.scope !== void 0 ? { scope: frame.scope } : {}
       };
     case MessageType.SESSION_MESSAGE:
       return {
         type: "session.message",
         session_id: str(frame, "session_id"),
-        payload: frame["payload"],
-        ...typeof frame["seq"] === "number" ? { seq: frame["seq"] } : {},
-        ...typeof frame["sender"] === "string" ? { sender: frame["sender"] } : {}
+        payload: frame.payload,
+        ...typeof frame.seq === "number" ? { seq: frame.seq } : {},
+        ...typeof frame.sender === "string" ? { sender: frame.sender } : {}
       };
     case MessageType.SESSION_END:
       return {
         type: "session.end",
         session_id: str(frame, "session_id"),
-        ...typeof frame["reason"] === "string" ? { reason: frame["reason"] } : {}
+        ...typeof frame.reason === "string" ? { reason: frame.reason } : {}
       };
     case MessageType.INVOKE:
       return {
         type: "invoke",
         invoke_id: str(frame, "invoke_id"),
         capability: strOrEmpty(frame, "capability"),
-        input: frame["input"] ?? {},
-        ...typeof frame["manifest_id"] === "string" ? { manifest_id: frame["manifest_id"] } : {},
-        ...frame["manifest"] !== void 0 && frame["manifest"] !== null ? { manifest: frame["manifest"] } : {},
-        ...typeof frame["requester_id"] === "string" ? { requester_id: frame["requester_id"] } : {},
-        ...typeof frame["timeout_seconds"] === "number" ? { timeout_seconds: frame["timeout_seconds"] } : {}
+        input: frame.input ?? {},
+        ...typeof frame.manifest_id === "string" ? { manifest_id: frame.manifest_id } : {},
+        ...frame.manifest !== void 0 && frame.manifest !== null ? { manifest: frame.manifest } : {},
+        ...typeof frame.requester_id === "string" ? { requester_id: frame.requester_id } : {},
+        ...typeof frame.timeout_seconds === "number" ? { timeout_seconds: frame.timeout_seconds } : {}
       };
     case MessageType.GIG_TASK: {
       return {
         type: "gig_task.offer",
         task_id: str(frame, "task_id"),
         capability: strOrEmpty(frame, "capability"),
-        ...typeof frame["instruction"] === "string" ? { instruction: frame["instruction"] } : {},
-        ...typeof frame["reward_credits"] === "number" ? { reward_credits: frame["reward_credits"] } : {},
-        ...typeof frame["response_sla_seconds"] === "number" ? { response_sla_seconds: frame["response_sla_seconds"] } : {},
-        ...typeof frame["slot_key"] === "string" ? { slot_key: frame["slot_key"] } : {},
-        ...typeof frame["partition_type"] === "string" ? { partition_type: frame["partition_type"] } : {},
-        ...frame["manifest"] !== void 0 && frame["manifest"] !== null ? { manifest: frame["manifest"] } : {},
-        ...frame["payload"] !== void 0 && frame["payload"] !== null ? { payload: frame["payload"] } : {}
+        ...typeof frame.instruction === "string" ? { instruction: frame.instruction } : {},
+        ...typeof frame.reward_credits === "number" ? { reward_credits: frame.reward_credits } : {},
+        ...typeof frame.response_sla_seconds === "number" ? { response_sla_seconds: frame.response_sla_seconds } : {},
+        ...typeof frame.slot_key === "string" ? { slot_key: frame.slot_key } : {},
+        ...typeof frame.partition_type === "string" ? { partition_type: frame.partition_type } : {},
+        ...frame.manifest !== void 0 && frame.manifest !== null ? { manifest: frame.manifest } : {},
+        ...frame.payload !== void 0 && frame.payload !== null ? { payload: frame.payload } : {}
       };
     }
     default:
@@ -8702,10 +8716,11 @@ var DEFAULT_STRIP_PATTERNS = [
   "system_prompt*"
 ];
 function sanitizeText(text, patterns) {
+  let result = text;
   for (const pattern of patterns) {
-    text = text.replace(pattern, "");
+    result = result.replace(pattern, "");
   }
-  return text;
+  return result;
 }
 function sanitizeOutput(payload, patterns = DEFAULT_OUTPUT_PATTERNS) {
   if (typeof payload === "string") return sanitizeText(payload, patterns);
@@ -8868,7 +8883,7 @@ var ProviderRuntime = class {
     return n;
   }
   async handleSessionCreate(evt) {
-    const max = this.config.maxConcurrentRuns ?? Infinity;
+    const max = this.config.maxConcurrentRuns ?? Number.POSITIVE_INFINITY;
     if (this.totalInFlight() >= max) {
       await this.send({
         type: MessageType.SESSION_REJECT,
@@ -8954,7 +8969,7 @@ var ProviderRuntime = class {
     }
   }
   async handleInvoke(evt) {
-    const max = this.config.maxConcurrentRuns ?? Infinity;
+    const max = this.config.maxConcurrentRuns ?? Number.POSITIVE_INFINITY;
     if (this.totalInFlight() >= max) {
       await this.send({
         type: MessageType.INVOKE_RESULT,
@@ -8987,14 +9002,14 @@ var ProviderRuntime = class {
       invoke_id: evt.invoke_id
     };
     if (result.error) {
-      frame["error"] = result.error;
+      frame.error = result.error;
     } else {
-      frame["result"] = this.sanitizeOut(result.output ?? {});
+      frame.result = this.sanitizeOut(result.output ?? {});
     }
     await this.send(frame);
   }
   async handleGigTask(offer) {
-    const max = this.config.maxConcurrentRuns ?? Infinity;
+    const max = this.config.maxConcurrentRuns ?? Number.POSITIVE_INFINITY;
     if (this.totalInFlight() >= max) return;
     this.inFlightGigTasks.add(offer.task_id);
     try {
@@ -9122,27 +9137,23 @@ function escapeRegex(s) {
 function parseConfig(raw) {
   const base = {
     cloudUrl: typeof raw["cloudUrl"] === "string" ? raw["cloudUrl"] : process.env["LINKEDCLAW_CLOUD_URL"] ?? DEFAULT_CLOUD_URL,
+    ...typeof raw["serviceUrl"] === "string" ? { serviceUrl: raw["serviceUrl"] } : process.env["LINKEDCLAW_SERVICE_URL"] !== void 0 ? { serviceUrl: process.env["LINKEDCLAW_SERVICE_URL"] } : process.env["LINKEDCLAW_SERVICES_HOST_URL"] !== void 0 ? { serviceUrl: process.env["LINKEDCLAW_SERVICES_HOST_URL"] } : {},
     relayUrl: typeof raw["relayUrl"] === "string" ? raw["relayUrl"] : process.env["LINKEDCLAW_RELAY_URL"] ?? DEFAULT_RELAY_URL,
     capabilities: Array.isArray(raw["capabilities"]) ? raw["capabilities"] : [],
-    ...raw["capabilitiesMeta"] && typeof raw["capabilitiesMeta"] === "object" ? { capabilitiesMeta: raw["capabilitiesMeta"] } : {},
     ...typeof raw["apiKey"] === "string" ? { apiKey: raw["apiKey"] } : process.env["LINKEDCLAW_API_KEY"] !== void 0 ? { apiKey: process.env["LINKEDCLAW_API_KEY"] } : {},
     ...typeof raw["agentId"] === "string" ? { agentId: raw["agentId"] } : {},
-    ...typeof raw["agentName"] === "string" ? { agentName: raw["agentName"] } : {},
-    ...typeof raw["invokeTimeoutMs"] === "number" ? { invokeTimeoutMs: raw["invokeTimeoutMs"] } : {},
-    ...typeof raw["sessionTurnTimeoutMs"] === "number" ? { sessionTurnTimeoutMs: raw["sessionTurnTimeoutMs"] } : {},
-    ...typeof raw["gigTaskTimeoutMs"] === "number" ? { gigTaskTimeoutMs: raw["gigTaskTimeoutMs"] } : {},
-    ...typeof raw["maxConcurrentRuns"] === "number" ? { maxConcurrentRuns: raw["maxConcurrentRuns"] } : {},
-    ...typeof raw["perRequesterLimit"] === "number" ? { perRequesterLimit: raw["perRequesterLimit"] } : {}
+    invokeTimeoutMs: typeof raw["invokeTimeoutMs"] === "number" ? raw["invokeTimeoutMs"] : 3e4,
+    sessionTurnTimeoutMs: typeof raw["sessionTurnTimeoutMs"] === "number" ? raw["sessionTurnTimeoutMs"] : 6e4,
+    gigTaskTimeoutMs: typeof raw["gigTaskTimeoutMs"] === "number" ? raw["gigTaskTimeoutMs"] : 3e5,
+    maxConcurrentRuns: typeof raw["maxConcurrentRuns"] === "number" ? raw["maxConcurrentRuns"] : 4,
+    perRequesterLimit: typeof raw["perRequesterLimit"] === "number" ? raw["perRequesterLimit"] : 2,
+    ...typeof raw["slaTier"] === "string" ? { slaTier: raw["slaTier"] } : {}
   };
   return {
     ...base,
     autoStartProvider: raw["autoStartProvider"] !== false,
     autoAcceptSessions: raw["autoAcceptSessions"] !== false,
-    autoAcceptGigTasks: raw["autoAcceptGigTasks"] === true,
-    ...typeof raw["provider"] === "string" ? { provider: raw["provider"] } : {},
-    ...typeof raw["model"] === "string" ? { model: raw["model"] } : {},
-    ...typeof raw["agentDescription"] === "string" ? { agentDescription: raw["agentDescription"] } : {},
-    ...typeof raw["slaTier"] === "string" ? { slaTier: raw["slaTier"] } : {}
+    autoAcceptGigTasks: raw["autoAcceptGigTasks"] === true
   };
 }
 
@@ -9175,8 +9186,6 @@ var SubagentHandler = class {
       sessionKey,
       message,
       extraSystemPrompt,
-      ...this.config.provider ? { provider: this.config.provider } : {},
-      ...this.config.model ? { model: this.config.model } : {},
       deliver: false
     });
     const waited = await this.api.runtime.subagent.waitForRun({
@@ -9207,8 +9216,6 @@ var SubagentHandler = class {
         sessionKey,
         message: formatPayload(evt.input),
         extraSystemPrompt: buildInvokePrompt(evt),
-        ...this.config.provider ? { provider: this.config.provider } : {},
-        ...this.config.model ? { model: this.config.model } : {},
         deliver: false
       });
       const timeoutMs = (evt.timeout_seconds !== void 0 ? evt.timeout_seconds * 1e3 : this.config.invokeTimeoutMs) ?? 3e4;
@@ -9248,8 +9255,6 @@ var SubagentHandler = class {
         sessionKey,
         message: formatGigTask(evt),
         extraSystemPrompt: buildGigTaskPrompt(evt),
-        ...this.config.provider ? { provider: this.config.provider } : {},
-        ...this.config.model ? { model: this.config.model } : {},
         deliver: false
       });
       const timeoutMs = (evt.response_sla_seconds !== void 0 ? evt.response_sla_seconds * 1e3 : this.config.gigTaskTimeoutMs) ?? 3e5;
@@ -9431,7 +9436,7 @@ var ProviderHolder = class {
     const agentId = cfg.agentId;
     if (!apiKey) throw new Error("apiKey missing");
     if (!agentId) throw new Error("agentId missing \u2014 register the provider first");
-    const client = new ProviderClient(cfg.cloudUrl, apiKey);
+    const gigTaskClient = new ProviderClient(cfg.serviceUrl ?? cfg.cloudUrl, apiKey);
     const relay = new RelayClient({
       url: cfg.relayUrl,
       apiKey,
@@ -9442,8 +9447,8 @@ var ProviderHolder = class {
     return new ProviderRuntime({
       cloud: {
         gigTasks: {
-          accept: (taskId, body, idempotencyKey) => client.acceptGigTask(taskId, body, idempotencyKey),
-          submit: (taskId, body) => client.submitGigTask(taskId, body)
+          accept: (taskId, body, idempotencyKey) => gigTaskClient.acceptGigTask(taskId, body, idempotencyKey),
+          submit: (taskId, body) => gigTaskClient.submitGigTask(taskId, body)
         }
       },
       relay,
@@ -9473,6 +9478,23 @@ var USAGE = [
   "`/linkedclaw restart` afterwards to make them take effect."
 ].join("\n");
 var REDACTED_FIELDS = /* @__PURE__ */ new Set(["apiKey"]);
+var SUPPORTED_CONFIG_FIELDS = /* @__PURE__ */ new Set([
+  "apiKey",
+  "agentId",
+  "cloudUrl",
+  "serviceUrl",
+  "relayUrl",
+  "capabilities",
+  "autoStartProvider",
+  "autoAcceptSessions",
+  "autoAcceptGigTasks",
+  "invokeTimeoutMs",
+  "sessionTurnTimeoutMs",
+  "gigTaskTimeoutMs",
+  "maxConcurrentRuns",
+  "perRequesterLimit",
+  "slaTier"
+]);
 function buildLinkedClawCommand(holder) {
   return {
     name: "linkedclaw",
@@ -9544,6 +9566,12 @@ async function handleConfig(holder, args) {
       if (!key || valueParts.length === 0) {
         return fail("usage: /linkedclaw config set <key> <value>");
       }
+      if (!SUPPORTED_CONFIG_FIELDS.has(key)) {
+        return fail(
+          `unsupported config field: ${key}
+supported fields: ${Array.from(SUPPORTED_CONFIG_FIELDS).sort().join(", ")}`
+        );
+      }
       const parsed = parseConfigValue(valueParts.join(" "));
       updateLinkedClawPluginConfig((cfg) => {
         cfg[key] = parsed;