@siglume/api-sdk 0.10.5 → 0.10.7

package/dist/index.d.cts

@@ -210,6 +210,8 @@ interface AppManifest {
     price_model?: PriceModel;
     price_value_minor?: number;
     currency: ListingCurrency;
+    allow_free_trial: boolean;
+    free_trial_duration_days?: number;
     jurisdiction: string;
     applicable_regulations?: string[];
     data_residency?: string;
@@ -377,6 +379,8 @@ interface AppListingRecord {
     price_model?: string | null;
     price_value_minor: number;
     currency: string;
+    allow_free_trial: boolean;
+    free_trial_duration_days: number;
     short_description?: string | null;
     description?: string | null;
     docs_url?: string | null;
@@ -2702,6 +2706,13 @@ declare class SiglumeBuyerClient {
         buyer_currency?: string;
         buyer_token?: string;
     }): Promise<Subscription>;
+    start_trial(options: {
+        capability_key: string;
+        agent_id?: string;
+        bind_agent?: boolean;
+        binding_status?: string;
+    }): Promise<Subscription>;
+    get_trial_quota(): Promise<Record<string, unknown>>;
     invoke(options: {
         capability_key: string;
         input: Record<string, unknown>;

package/dist/index.d.ts

@@ -210,6 +210,8 @@ interface AppManifest {
     price_model?: PriceModel;
     price_value_minor?: number;
     currency: ListingCurrency;
+    allow_free_trial: boolean;
+    free_trial_duration_days?: number;
     jurisdiction: string;
     applicable_regulations?: string[];
     data_residency?: string;
@@ -377,6 +379,8 @@ interface AppListingRecord {
     price_model?: string | null;
     price_value_minor: number;
     currency: string;
+    allow_free_trial: boolean;
+    free_trial_duration_days: number;
     short_description?: string | null;
     description?: string | null;
     docs_url?: string | null;
@@ -2702,6 +2706,13 @@ declare class SiglumeBuyerClient {
         buyer_currency?: string;
         buyer_token?: string;
     }): Promise<Subscription>;
+    start_trial(options: {
+        capability_key: string;
+        agent_id?: string;
+        bind_agent?: boolean;
+        binding_status?: string;
+    }): Promise<Subscription>;
+    get_trial_quota(): Promise<Record<string, unknown>>;
     invoke(options: {
         capability_key: string;
         input: Record<string, unknown>;

package/dist/index.js

@@ -1624,6 +1624,8 @@ function parseListing(data) {
     price_model: stringOrNull2(data.price_model),
     price_value_minor: Number(data.price_value_minor ?? 0),
     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),
     short_description: stringOrNull2(data.short_description),
     description: stringOrNull2(data.description),
     docs_url: stringOrNull2(data.docs_url),
@@ -2823,6 +2825,8 @@ var init_client = __esm({
           "price_model",
           "price_value_minor",
           "currency",
+          "allow_free_trial",
+          "free_trial_duration_days",
           "permission_class",
           "approval_mode",
           "dry_run_supported",
@@ -2850,6 +2854,24 @@ var init_client = __esm({
           throw new SiglumeClientError(`AppManifest.currency must be 'USD' or 'JPY'. Got ${String(payload.currency)}.`);
         }
         payload.currency = currency;
+        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."
+          );
+        }
+        if (Boolean(payload.allow_free_trial)) {
+          const duration = payload.free_trial_duration_days ?? 30;
+          if (typeof duration !== "number" || !Number.isInteger(duration)) {
+            throw new SiglumeClientError(
+              "AppManifest.free_trial_duration_days must be an integer when allow_free_trial=true."
+            );
+          }
+          if (duration < 1 || duration > 90) {
+            throw new SiglumeClientError(
+              `AppManifest.free_trial_duration_days must be between 1 and 90 when allow_free_trial=true, got: ${duration}.`
+            );
+          }
+        }
         if (payload.manifest && typeof payload.manifest === "object") {
           delete payload.manifest.version;
         }
@@ -5248,6 +5270,55 @@ var SiglumeBuyerClient = class {
       }
     };
   }
+  async start_trial(options) {
+    const listing = await this.get_listing(options.capability_key);
+    const [data, meta] = await this.request("POST", `/market/capabilities/${listing.listing_id}/start-trial`, {
+      json_body: {}
+    });
+    const accessGrant = parseAccessGrant2(toRecord2(data.access_grant));
+    if (!accessGrant.access_grant_id) {
+      const purchaseStatus = String(data.purchase_status ?? "trial_started");
+      throw new SiglumeExperimentalError(
+        `Trial started with status '${purchaseStatus}' but did not return an access grant. Buyer-side trial flows are still experimental on the public API.`
+      );
+    }
+    const targetAgentId = resolveAgentId(options.agent_id, this.default_agent_id);
+    const shouldBind = options.bind_agent ?? Boolean(targetAgentId);
+    let binding = null;
+    let trace_id = meta.trace_id ?? void 0;
+    let request_id = meta.request_id ?? void 0;
+    if (shouldBind) {
+      if (!targetAgentId) {
+        throw new SiglumeClientError("agent_id is required to bind a trial access grant.");
+      }
+      const grantBinding = await this.client.bind_agent_to_grant(accessGrant.access_grant_id, {
+        agent_id: targetAgentId,
+        binding_status: options.binding_status ?? "active"
+      });
+      binding = grantBinding.binding;
+      trace_id = grantBinding.trace_id ?? trace_id;
+      request_id = grantBinding.request_id ?? request_id;
+    }
+    return {
+      access_grant_id: accessGrant.access_grant_id,
+      capability_listing_id: accessGrant.capability_listing_id ?? listing.listing_id,
+      capability_key: listing.capability_key,
+      purchase_status: String(data.purchase_status ?? "trial_started"),
+      grant_status: accessGrant.grant_status,
+      agent_id: binding?.agent_id ?? targetAgentId ?? null,
+      binding_id: binding?.binding_id ?? null,
+      binding_status: binding?.binding_status ?? null,
+      access_grant: accessGrant,
+      binding,
+      trace_id,
+      request_id,
+      raw: { trial: { ...data }, binding }
+    };
+  }
+  async get_trial_quota() {
+    const [data] = await this.request("GET", "/market/me/trial-quota");
+    return { ...data };
+  }
   async invoke(options) {
     if (!this.allow_internal_execute) {
       throw new SiglumeExperimentalError(
@@ -5975,10 +6046,14 @@ function appendValueChange(changes, emittedKeys, level, key, oldValue, newValue,
 }
 function normalizeManifest(value) {
   const payload = coerceMapping(value, "manifest");
+  const rawDuration = payload.free_trial_duration_days;
+  const duration = rawDuration === void 0 || rawDuration === null ? 30 : Number(rawDuration);
   return {
     ...payload,
     price_model: payload.price_model ?? "free",
     currency: payload.currency ?? "USD",
+    allow_free_trial: Boolean(payload.allow_free_trial ?? false),
+    free_trial_duration_days: Number.isFinite(duration) ? Math.trunc(duration) : 30,
     // AppManifest defaults permission_class to "read-only" (hyphen form,
     // PermissionClass.READ_ONLY). Without this default, a legacy / minimal
     // manifest without permission_class compared against an upgraded one