@siglume/api-sdk 1.0.0 → 1.2.0

package/dist/cli/index.d.cts

@@ -123,6 +123,7 @@ declare const PriceModel: {
     readonly PER_ACTION: "per_action";
 };
 type PriceModel = (typeof PriceModel)[keyof typeof PriceModel];
+type BillingTiming = "post" | "prepay";
 declare const AppCategory: {
     readonly COMMERCE: "commerce";
     readonly BOOKING: "booking";
@@ -178,6 +179,8 @@ interface AppManifest {
     permission_scopes?: string[];
     price_model?: PriceModel;
     price_value_minor?: number;
+    pricing_plan?: PricingPlan;
+    billing_timing?: BillingTiming;
     currency: ListingCurrency;
     allow_free_trial: boolean;
     free_trial_duration_days?: number;
@@ -261,6 +264,28 @@ interface EnvelopeMeta {
     request_id?: string | null;
     trace_id?: string | null;
 }
+interface PricingPlanItem {
+    key?: string | null;
+    label?: string | null;
+    price_minor?: number | null;
+    amount_minor?: number | null;
+    currency?: string | null;
+    unit_label?: string | null;
+    description?: string | null;
+    conditions?: unknown;
+    receipt_code?: string | null;
+}
+interface PricingPlan {
+    billing_model?: string | null;
+    display_name?: string | null;
+    summary?: string | null;
+    description?: string | null;
+    currency?: string | null;
+    unit_label?: string | null;
+    free_upfront_invocation?: boolean | null;
+    fallback_note?: string | null;
+    items?: PricingPlanItem[];
+}
 interface CursorPage<T> {
     items: T[];
     next_cursor?: string | null;
@@ -282,6 +307,8 @@ interface AppListingRecord {
     dry_run_supported: boolean;
     price_model?: string | null;
     price_value_minor: number;
+    pricing_plan?: PricingPlan | null;
+    billing_timing?: BillingTiming | string | null;
     currency: string;
     allow_free_trial: boolean;
     free_trial_duration_days: number;

package/dist/cli/index.d.ts

@@ -123,6 +123,7 @@ declare const PriceModel: {
     readonly PER_ACTION: "per_action";
 };
 type PriceModel = (typeof PriceModel)[keyof typeof PriceModel];
+type BillingTiming = "post" | "prepay";
 declare const AppCategory: {
     readonly COMMERCE: "commerce";
     readonly BOOKING: "booking";
@@ -178,6 +179,8 @@ interface AppManifest {
     permission_scopes?: string[];
     price_model?: PriceModel;
     price_value_minor?: number;
+    pricing_plan?: PricingPlan;
+    billing_timing?: BillingTiming;
     currency: ListingCurrency;
     allow_free_trial: boolean;
     free_trial_duration_days?: number;
@@ -261,6 +264,28 @@ interface EnvelopeMeta {
     request_id?: string | null;
     trace_id?: string | null;
 }
+interface PricingPlanItem {
+    key?: string | null;
+    label?: string | null;
+    price_minor?: number | null;
+    amount_minor?: number | null;
+    currency?: string | null;
+    unit_label?: string | null;
+    description?: string | null;
+    conditions?: unknown;
+    receipt_code?: string | null;
+}
+interface PricingPlan {
+    billing_model?: string | null;
+    display_name?: string | null;
+    summary?: string | null;
+    description?: string | null;
+    currency?: string | null;
+    unit_label?: string | null;
+    free_upfront_invocation?: boolean | null;
+    fallback_note?: string | null;
+    items?: PricingPlanItem[];
+}
 interface CursorPage<T> {
     items: T[];
     next_cursor?: string | null;
@@ -282,6 +307,8 @@ interface AppListingRecord {
     dry_run_supported: boolean;
     price_model?: string | null;
     price_value_minor: number;
+    pricing_plan?: PricingPlan | null;
+    billing_timing?: BillingTiming | string | null;
     currency: string;
     allow_free_trial: boolean;
     free_trial_duration_days: number;

package/dist/cli/index.js

@@ -155,6 +155,61 @@ var init_utils = __esm({
   }
 });
 
+// src/types.ts
+var PermissionClass, ApprovalMode, Environment, PriceModel, AppCategory, MINIMUM_JPY_OPERATION_PRICE_MINOR, ToolManualPermissionClass, SettlementMode;
+var init_types = __esm({
+  "src/types.ts"() {
+    "use strict";
+    PermissionClass = {
+      READ_ONLY: "read-only",
+      ACTION: "action",
+      PAYMENT: "payment",
+      /** @deprecated Use READ_ONLY. Behaves identically. */
+      RECOMMENDATION: "recommendation"
+    };
+    ApprovalMode = {
+      AUTO: "auto",
+      BUDGET_BOUNDED: "budget-bounded",
+      ALWAYS_ASK: "always-ask",
+      DENY: "deny"
+    };
+    Environment = {
+      SANDBOX: "sandbox",
+      LIVE: "live"
+    };
+    PriceModel = {
+      FREE: "free",
+      SUBSCRIPTION: "subscription",
+      ONE_TIME: "one_time",
+      BUNDLE: "bundle",
+      USAGE_BASED: "usage_based",
+      PER_ACTION: "per_action"
+    };
+    AppCategory = {
+      COMMERCE: "commerce",
+      BOOKING: "booking",
+      CRM: "crm",
+      FINANCE: "finance",
+      DOCUMENT: "document",
+      COMMUNICATION: "communication",
+      MONITORING: "monitoring",
+      OTHER: "other"
+    };
+    MINIMUM_JPY_OPERATION_PRICE_MINOR = 15;
+    ToolManualPermissionClass = {
+      READ_ONLY: "read_only",
+      ACTION: "action",
+      PAYMENT: "payment"
+    };
+    SettlementMode = {
+      STRIPE_CHECKOUT: "stripe_checkout",
+      STRIPE_PAYMENT_INTENT: "stripe_payment_intent",
+      POLYGON_MANDATE: "polygon_mandate",
+      EMBEDDED_WALLET_CHARGE: "embedded_wallet_charge"
+    };
+  }
+});
+
 // src/webhooks.ts
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -1276,6 +1331,58 @@ function validateSaveDataSchema(schema, fieldName) {
     }
   }
 }
+function validatePricingPlanFloor(plan, defaultCurrency) {
+  if (plan === void 0 || plan === null) {
+    return;
+  }
+  if (!isRecord(plan)) {
+    throw new SiglumeClientError("AppManifest.pricing_plan must be an object when provided.");
+  }
+  const items = plan.items;
+  if (items === void 0 || items === null) {
+    return;
+  }
+  if (!Array.isArray(items)) {
+    throw new SiglumeClientError("AppManifest.pricing_plan.items must be an array when provided.");
+  }
+  const planCurrency = String(plan.currency ?? defaultCurrency ?? "").trim().toUpperCase();
+  const seenKeys = /* @__PURE__ */ new Set();
+  items.forEach((item, index) => {
+    if (!isRecord(item)) {
+      throw new SiglumeClientError(`AppManifest.pricing_plan.items[${index}] must be an object.`);
+    }
+    const itemKey = String(
+      item.key ?? item.operation ?? item.operation_key ?? item.request_type ?? item.receipt_code ?? item.action ?? ""
+    ).trim();
+    if (!itemKey) {
+      throw new SiglumeClientError(`AppManifest.pricing_plan.items[${index}].key is required.`);
+    }
+    if (seenKeys.has(itemKey)) {
+      throw new SiglumeClientError(`AppManifest.pricing_plan.items[${index}].key duplicates ${itemKey}.`);
+    }
+    seenKeys.add(itemKey);
+    const amountRaw = item.price_minor ?? item.amount_minor ?? item.cost_minor ?? item.value_minor;
+    if (amountRaw === void 0 || amountRaw === null) {
+      throw new SiglumeClientError(`AppManifest.pricing_plan.items[${index}].price_minor is required.`);
+    }
+    const amountMinor = typeof amountRaw === "number" ? amountRaw : typeof amountRaw === "string" && amountRaw.trim() ? Number(amountRaw) : NaN;
+    if (!Number.isInteger(amountMinor)) {
+      throw new SiglumeClientError(`AppManifest.pricing_plan.items[${index}].price_minor must be an integer.`);
+    }
+    if (amountMinor < 0) {
+      throw new SiglumeClientError(`AppManifest.pricing_plan.items[${index}].price_minor must be zero or positive.`);
+    }
+    const currency = String(item.currency ?? planCurrency ?? defaultCurrency ?? "").trim().toUpperCase();
+    if (MINIMUM_JPY_OPERATION_PRICE_CURRENCIES.has(currency) && amountMinor > 0 && amountMinor < MINIMUM_JPY_OPERATION_PRICE_MINOR) {
+      throw new SiglumeClientError(
+        `AppManifest.pricing_plan.items[${index}].price_minor must be 0 or at least ${MINIMUM_JPY_OPERATION_PRICE_MINOR} for JPY/JPYC operation billing.`
+      );
+    }
+  });
+}
+function pricingPlanHasItems(plan) {
+  return isRecord(plan) && Array.isArray(plan.items) && plan.items.length > 0;
+}
 function buildToolManualQualityReport(payload) {
   const qualityBlock = isRecord(payload.quality) ? payload.quality : payload;
   const issues = [];
@@ -1351,6 +1458,7 @@ function buildUrl(baseUrl, path, params) {
 }
 function parseListing(data) {
   const metadata = isRecord(data.metadata) ? data.metadata : {};
+  const pricing_plan = isRecord(data.pricing_plan) ? data.pricing_plan : isRecord(metadata.pricing_plan) ? metadata.pricing_plan : null;
   const persistence = isRecord(data.persistence) ? data.persistence : isRecord(metadata.persistence) ? metadata.persistence : {};
   return {
     listing_id: String(data.listing_id ?? data.id ?? ""),
@@ -1364,6 +1472,8 @@ function parseListing(data) {
     dry_run_supported: Boolean(data.dry_run_supported ?? false),
     price_model: stringOrNull(data.price_model),
     price_value_minor: Number(data.price_value_minor ?? 0),
+    pricing_plan,
+    billing_timing: String(data.billing_timing ?? metadata.billing_timing ?? "post"),
     currency: String(data.currency ?? "USD"),
     allow_free_trial: Boolean(data.allow_free_trial ?? false),
     free_trial_duration_days: Number(data.free_trial_duration_days ?? 30),
@@ -2461,10 +2571,11 @@ function cloneJsonLike(value) {
   }
   return value;
 }
-var DEFAULT_SIGLUME_API_BASE, RETRYABLE_STATUS_CODES, CursorPageResult, SiglumeClient;
+var DEFAULT_SIGLUME_API_BASE, RETRYABLE_STATUS_CODES, MINIMUM_JPY_OPERATION_PRICE_CURRENCIES, CursorPageResult, SiglumeClient;
 var init_client = __esm({
   "src/client.ts"() {
     "use strict";
+    init_types();
     init_errors();
     init_webhooks();
     init_web3();
@@ -2472,6 +2583,7 @@ var init_client = __esm({
     init_utils();
     DEFAULT_SIGLUME_API_BASE = "https://siglume.com/v1";
     RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+    MINIMUM_JPY_OPERATION_PRICE_CURRENCIES = /* @__PURE__ */ new Set(["JPY", "JPYC"]);
     CursorPageResult = class {
       items;
       next_cursor;
@@ -2579,6 +2691,8 @@ var init_client = __esm({
           "jurisdiction",
           "price_model",
           "price_value_minor",
+          "pricing_plan",
+          "billing_timing",
           "currency",
           "allow_free_trial",
           "free_trial_duration_days",
@@ -2595,6 +2709,16 @@ var init_client = __esm({
             payload[fieldName] = value;
           }
         }
+        if (payload.pricing_plan !== void 0 && (typeof payload.pricing_plan !== "object" || Array.isArray(payload.pricing_plan))) {
+          throw new SiglumeClientError("AppManifest.pricing_plan must be an object when provided.");
+        }
+        if (payload.billing_timing !== void 0 && payload.billing_timing !== null) {
+          const billingTiming = String(payload.billing_timing || "post").trim().toLowerCase();
+          if (billingTiming !== "post" && billingTiming !== "prepay") {
+            throw new SiglumeClientError("AppManifest.billing_timing must be 'post' or 'prepay'.");
+          }
+          payload.billing_timing = billingTiming;
+        }
         if (payload.store_vertical === void 0 || payload.store_vertical === null) {
           throw new SiglumeClientError(
             "AppManifest.store_vertical is required. Choose 'api' for normal API Store listings or 'game' for API games."
@@ -2610,6 +2734,13 @@ var init_client = __esm({
           throw new SiglumeClientError(`AppManifest.currency must be 'USD' or 'JPY'. Got ${String(payload.currency)}.`);
         }
         payload.currency = currency;
+        if (payload.pricing_plan !== void 0) {
+          validatePricingPlanFloor(payload.pricing_plan, currency);
+        }
+        const priceModel = String(payload.price_model ?? "free").trim().toLowerCase();
+        if ((priceModel === "usage_based" || priceModel === "per_action") && !pricingPlanHasItems(payload.pricing_plan)) {
+          throw new SiglumeClientError("AppManifest.pricing_plan.items is required for usage_based/per_action pricing.");
+        }
         if (payload.allow_free_trial === void 0 || payload.allow_free_trial === null) {
           throw new SiglumeClientError(
             "AppManifest.allow_free_trial is required. Pass true to offer a Plus/Pro buyer free trial or false to disable trials."
@@ -5284,53 +5415,8 @@ function stableValue(value) {
   return value;
 }
 
-// src/types.ts
-var PermissionClass = {
-  READ_ONLY: "read-only",
-  ACTION: "action",
-  PAYMENT: "payment",
-  /** @deprecated Use READ_ONLY. Behaves identically. */
-  RECOMMENDATION: "recommendation"
-};
-var ApprovalMode = {
-  AUTO: "auto",
-  BUDGET_BOUNDED: "budget-bounded",
-  ALWAYS_ASK: "always-ask",
-  DENY: "deny"
-};
-var Environment = {
-  SANDBOX: "sandbox",
-  LIVE: "live"
-};
-var PriceModel = {
-  FREE: "free",
-  SUBSCRIPTION: "subscription",
-  ONE_TIME: "one_time",
-  BUNDLE: "bundle",
-  USAGE_BASED: "usage_based",
-  PER_ACTION: "per_action"
-};
-var AppCategory = {
-  COMMERCE: "commerce",
-  BOOKING: "booking",
-  CRM: "crm",
-  FINANCE: "finance",
-  DOCUMENT: "document",
-  COMMUNICATION: "communication",
-  MONITORING: "monitoring",
-  OTHER: "other"
-};
-var ToolManualPermissionClass = {
-  READ_ONLY: "read_only",
-  ACTION: "action",
-  PAYMENT: "payment"
-};
-var SettlementMode = {
-  STRIPE_CHECKOUT: "stripe_checkout",
-  STRIPE_PAYMENT_INTENT: "stripe_payment_intent",
-  POLYGON_MANDATE: "polygon_mandate",
-  EMBEDDED_WALLET_CHARGE: "embedded_wallet_charge"
-};
+// src/runtime.ts
+init_types();
 
 // src/testing/recorder.ts
 var CASSETTE_VERSION = 1;
@@ -5722,6 +5808,7 @@ Actual:   ${requestSignature(requestRecord, ignoreBodyFields)}`
 };
 
 // src/tool-manual-validator.ts
+init_types();
 init_utils();
 var JURISDICTION_PATTERN = /^[A-Z]{2}(-[A-Z0-9]{1,3})?$/;
 var TOOL_NAME_RE = /^[A-Za-z0-9_]{3,64}$/;
@@ -5993,6 +6080,64 @@ function validate_tool_manual(manualInput) {
 // src/runtime.ts
 init_web3();
 var CAPABILITY_KEY_RE = /^[a-z0-9][a-z0-9-]*[a-z0-9]$/;
+var MINIMUM_JPY_OPERATION_PRICE_CURRENCIES2 = /* @__PURE__ */ new Set(["JPY", "JPYC"]);
+function pricingPlanFloorIssues(plan, defaultCurrency) {
+  const issues = [];
+  if (plan === void 0 || plan === null) {
+    return issues;
+  }
+  if (typeof plan !== "object" || Array.isArray(plan)) {
+    return ["pricing_plan must be an object when provided"];
+  }
+  const record = plan;
+  const items = record.items;
+  if (items === void 0 || items === null) {
+    return issues;
+  }
+  if (!Array.isArray(items)) {
+    return ["pricing_plan.items must be an array when provided"];
+  }
+  const planCurrency = String(record.currency ?? defaultCurrency ?? "").trim().toUpperCase();
+  const seenKeys = /* @__PURE__ */ new Set();
+  items.forEach((item, index) => {
+    if (typeof item !== "object" || item === null || Array.isArray(item)) {
+      issues.push(`pricing_plan.items[${index}] must be an object`);
+      return;
+    }
+    const itemRecord = item;
+    const itemKey = String(
+      itemRecord.key ?? itemRecord.operation ?? itemRecord.operation_key ?? itemRecord.request_type ?? itemRecord.receipt_code ?? itemRecord.action ?? ""
+    ).trim();
+    if (!itemKey) {
+      issues.push(`pricing_plan.items[${index}].key is required`);
+    } else if (seenKeys.has(itemKey)) {
+      issues.push(`pricing_plan.items[${index}].key duplicates ${itemKey}`);
+    } else {
+      seenKeys.add(itemKey);
+    }
+    const amountRaw = itemRecord.price_minor ?? itemRecord.amount_minor ?? itemRecord.cost_minor ?? itemRecord.value_minor;
+    if (amountRaw === void 0 || amountRaw === null) {
+      issues.push(`pricing_plan.items[${index}].price_minor is required`);
+      return;
+    }
+    const amountMinor = typeof amountRaw === "number" ? amountRaw : typeof amountRaw === "string" && amountRaw.trim() ? Number(amountRaw) : NaN;
+    if (!Number.isInteger(amountMinor)) {
+      issues.push(`pricing_plan.items[${index}].price_minor must be an integer`);
+      return;
+    }
+    if (amountMinor < 0) {
+      issues.push(`pricing_plan.items[${index}].price_minor must be zero or positive`);
+      return;
+    }
+    const currency = String(itemRecord.currency ?? planCurrency ?? defaultCurrency ?? "").trim().toUpperCase();
+    if (MINIMUM_JPY_OPERATION_PRICE_CURRENCIES2.has(currency) && amountMinor > 0 && amountMinor < MINIMUM_JPY_OPERATION_PRICE_MINOR) {
+      issues.push(
+        `pricing_plan.items[${index}].price_minor must be 0 or at least ${MINIMUM_JPY_OPERATION_PRICE_MINOR} for JPY/JPYC operation billing`
+      );
+    }
+  });
+  return issues;
+}
 function normalizeExecutionResult(result, executionKind) {
   return {
     success: Boolean(result.success),
@@ -6080,6 +6225,13 @@ var AppTestHarness = class {
     if (!manifest.example_prompts || manifest.example_prompts.length === 0) {
       issues.push("at least one example_prompt is recommended");
     }
+    issues.push(...pricingPlanFloorIssues(manifest.pricing_plan, String(manifest.currency ?? "USD")));
+    if (manifest.billing_timing !== void 0 && manifest.billing_timing !== "post" && manifest.billing_timing !== "prepay") {
+      issues.push("billing_timing must be 'post' or 'prepay'");
+    }
+    if ((manifest.price_model === PriceModel.USAGE_BASED || manifest.price_model === PriceModel.PER_ACTION) && (!manifest.pricing_plan || !Array.isArray(manifest.pricing_plan.items) || manifest.pricing_plan.items.length === 0)) {
+      issues.push("pricing_plan.items is required for usage_based/per_action pricing");
+    }
     if (manifest.permission_class === PermissionClass.ACTION || manifest.permission_class === PermissionClass.PAYMENT) {
       if (!manifest.dry_run_supported) {
         issues.push("action/payment apps should support dry_run");
@@ -6155,7 +6307,7 @@ var AppTestHarness = class {
       };
     }
     return {
-      experimental: manifest.price_model === PriceModel.USAGE_BASED || manifest.price_model === PriceModel.PER_ACTION,
+      experimental: false,
       usage_record,
       invoice_line_preview
     };