@delexec/ops 0.1.0 → 0.1.1

package/README.md

@@ -1,3 +1,19 @@
 # @delexec/ops
 
 Unified operator CLI for delegated execution clients.
+
+## Paid Hotline Drafts
+
+Responder operators can declare a fixed-price Hotline while creating the local registration draft:
+
+```bash
+delexec-ops responder add-hotline \
+  --type process \
+  --hotline-id opc.summary.v1 \
+  --cmd "node worker.js" \
+  --fixed-price-cents 50 \
+  --currency PTS \
+  --billing-disclosure-url "https://callanything.xyz/marketplace/responders/opc-summary"
+```
+
+The generated draft keeps the `pricing_hint`, and `delexec-ops submit-review` submits it to the connected platform catalog.

package/README.zh-CN.md

@@ -4,3 +4,19 @@
 > 说明：中文文档为准。
 
 面向委托执行客户端的统一运维 CLI。
+
+## 付费 Hotline Draft
+
+Responder operator 可以在创建本地 registration draft 时声明固定价格：
+
+```bash
+delexec-ops responder add-hotline \
+  --type process \
+  --hotline-id opc.summary.v1 \
+  --cmd "node worker.js" \
+  --fixed-price-cents 50 \
+  --currency PTS \
+  --billing-disclosure-url "https://callanything.xyz/marketplace/responders/opc-summary"
+```
+
+生成的 draft 会保留 `pricing_hint`，随后 `delexec-ops submit-review` 会把该价格信息提交到已连接的 platform catalog。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delexec/ops",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Unified operator CLI for delegated execution clients",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -29,6 +29,10 @@ const DEFAULT_CONSOLE_HOST = "127.0.0.1";
 const DEFAULT_CONSOLE_PORT = 4173;
 const DEFAULT_UI_READY_TIMEOUT_MS = 120000;
 const OPS_SESSION_HEADER = "X-Ops-Session";
+const FIXED_PRICE_MODEL = "fixed_price";
+const DEFAULT_PRICING_CURRENCY = "PTS";
+const DEFAULT_TRUST_TIER = "untrusted";
+const TRUST_TIERS = Object.freeze(["untrusted", "trusted", "verified"]);
 
 function getOpsSessionFile() {
   return path.join(ensureOpsDirectories(), "run", "session.json");
@@ -44,7 +48,7 @@ function usage() {
   delexec-ops mcp spec
   delexec-ops auth register --email <email> [--local] [--platform <url>]
   delexec-ops enable-responder [--responder-id <id>] [--display-name <name>]
-  delexec-ops add-hotline --type <process|http> --hotline-id <id> [--cmd <command> | --url <url>] [--cwd <path>] [--env KEY=VALUE]
+  delexec-ops add-hotline --type <process|http> --hotline-id <id> [--cmd <command> | --url <url>] [--cwd <path>] [--env KEY=VALUE] [--fixed-price-cents <amount>] [--currency <code>] [--billing-disclosure-url <url>]
   delexec-ops attach-project --project-path <path> [--project-name <name>] [--project-description <text>] [--hotline-id <id>] [--cmd <command> | --url <url>] [--cwd <path>] [--env KEY=VALUE] [--task-type <type>] [--capability <capability>]
   delexec-ops add-example-hotline
   delexec-ops remove-hotline --hotline-id <id>
@@ -249,6 +253,44 @@ function parsePort(value, fallback) {
   return Math.trunc(parsed);
 }
 
+function parseOptionalNonNegativeInteger(value, fieldName) {
+  if (value === undefined || value === null || value === false) {
+    return null;
+  }
+  const parsed = Number(value);
+  if (!Number.isSafeInteger(parsed) || parsed < 0) {
+    throw new Error(`${fieldName}_must_be_non_negative_integer`);
+  }
+  return parsed;
+}
+
+function parsePricingHint(args = {}) {
+  const fixedPriceCents = parseOptionalNonNegativeInteger(args["fixed-price-cents"], "fixed_price_cents");
+  if (fixedPriceCents === null) {
+    return undefined;
+  }
+  const maxTotalCents = parseOptionalNonNegativeInteger(args["max-total-cents"], "max_total_cents") ?? fixedPriceCents;
+  if (maxTotalCents < fixedPriceCents) {
+    throw new Error("max_total_cents_must_be_greater_than_or_equal_to_fixed_price_cents");
+  }
+  const trustTier = String(args["trust-tier"] || DEFAULT_TRUST_TIER).trim() || DEFAULT_TRUST_TIER;
+  if (!TRUST_TIERS.includes(trustTier)) {
+    throw new Error("trust_tier_unsupported");
+  }
+  const pricingHint = {
+    pricing_model: FIXED_PRICE_MODEL,
+    currency: String(args.currency || DEFAULT_PRICING_CURRENCY).trim() || DEFAULT_PRICING_CURRENCY,
+    fixed_price_cents: fixedPriceCents,
+    max_total_cents: maxTotalCents,
+    trust_tier: trustTier
+  };
+  const billingDisclosureUrl = String(args["billing-disclosure-url"] || "").trim();
+  if (billingDisclosureUrl) {
+    pricingHint.billing_disclosure_url = billingDisclosureUrl;
+  }
+  return pricingHint;
+}
+
 function resolveUiConfig(args = {}) {
   return {
     host: String(args["ui-host"] || args.host || process.env.DELEXEC_OPS_UI_HOST || DEFAULT_CONSOLE_HOST).trim() || DEFAULT_CONSOLE_HOST,
@@ -473,6 +515,7 @@ function parseHotlineDefinition(args) {
       soft_timeout_s: Number(args["soft-timeout-s"] || 60),
       hard_timeout_s: Number(args["hard-timeout-s"] || 180)
     },
+    pricing_hint: parsePricingHint(args),
     review_status: "local_only",
     submitted_for_review: false
   };

package/src/config.js

@@ -1027,6 +1027,7 @@ export function buildHotlineRegistrationDraft(state, definition, existingDraft =
         "recommended_for",
         "not_recommended_for",
         "limitations",
+        "pricing_hint",
         "contact_email",
         "support_email"
       ]
@@ -1050,6 +1051,7 @@ export function buildHotlineRegistrationDraft(state, definition, existingDraft =
     recommended_for: Array.isArray(profile.recommended_for) ? profile.recommended_for : [],
     not_recommended_for: Array.isArray(profile.not_recommended_for) ? profile.not_recommended_for : [],
     limitations: Array.isArray(profile.limitations) ? profile.limitations : [],
+    pricing_hint: definition.pricing_hint === undefined ? null : definition.pricing_hint,
     contact_email: fallbackContactEmail,
     support_email: null
   };
@@ -1064,7 +1066,13 @@ export function buildHotlineRegistrationDraft(state, definition, existingDraft =
     display_name: reusableDraft?.display_name || definition.display_name || definition.hotline_id,
     task_types: taskTypes,
     capabilities,
-    tags
+    tags,
+    pricing_hint:
+      definition.pricing_hint === undefined
+        ? reusableDraft?.pricing_hint === undefined
+          ? generated.pricing_hint
+          : reusableDraft.pricing_hint
+        : definition.pricing_hint
   };
 }
 
@@ -1171,6 +1179,7 @@ export function buildHotlineOnboardingBody(state, hotline, responderIdentity) {
       recommended_for: Array.isArray(source.recommended_for) ? source.recommended_for : null,
       not_recommended_for: Array.isArray(source.not_recommended_for) ? source.not_recommended_for : null,
       limitations: Array.isArray(source.limitations) ? source.limitations : null,
+      pricing_hint: source.pricing_hint === undefined ? undefined : source.pricing_hint,
       input_summary: source.input_summary || null,
       output_summary: source.output_summary || null,
       contact_email: source.contact_email || state?.config?.caller?.contact_email || null,