fix: clarify Stripe guidance and log snapshot defaults

Author: waleedlatif1

apps/docs/content/docs/cli/logs.mdx

@@ -31,7 +31,7 @@ sim logs get <runId> [options]
 
 | Option | Required | Description |
 | --- | --- | --- |
-| `--include-workflow-state` | No | Include the saved workflow snapshot. Set false to omit block configuration from a log read. Other run fields are unchanged. |
+| `--include-workflow-state` | No | Include the saved workflow snapshot (default: true). Set false to omit block configuration from a log read. Other run fields are unchanged. |
 | `--no-include-workflow-state` | No | Send --include-workflow-state as false. |
 | `--trace` | No | Show expanded trace spans with inputs, outputs, errors, timing, and cost. |
 

apps/docs/content/docs/cli/reference.mdx

@@ -2731,7 +2731,7 @@ sim logs get <runId> [options]
 
 | Option | Required | Description |
 | --- | --- | --- |
-| `--include-workflow-state` | No | Include the saved workflow snapshot. Set false to omit block configuration from a log read. Other run fields are unchanged. |
+| `--include-workflow-state` | No | Include the saved workflow snapshot (default: true). Set false to omit block configuration from a log read. Other run fields are unchanged. |
 | `--no-include-workflow-state` | No | Send --include-workflow-state as false. |
 | `--trace` | No | Show expanded trace spans with inputs, outputs, errors, timing, and cost. |
 

apps/docs/content/docs/integrations/stripe.mdx

@@ -1222,7 +1222,7 @@ Cancel a subscription
 
 ### Stripe Resume Subscription
 
-Resume a subscription that was scheduled for cancellation
+Resume a paused subscription
 
 #### Input
 
@@ -1387,7 +1387,7 @@ Search one page of subscriptions using query syntax. Pass metadata.next_page as
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `apiKey` | string | Yes | Stripe API key \(secret key\) |
-| `query` | string | Yes | Search query \(e.g., "status:'active' AND customer:'cus_xxx'"\) |
+| `query` | string | Yes | Search query \(e.g., "status:'active' AND metadata\['order_id'\]:'6735'"\) |
 | `page` | string | No | Pagination token from metadata.next_page. Omit for the first page and keep the same query. |
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
 

apps/docs/openapi-v2-logs.json

@@ -388,9 +388,9 @@
             "name": "includeWorkflowState",
             "in": "query",
             "required": false,
-            "description": "Include the saved workflow snapshot. Set false to omit block configuration from a log read. Other run fields are unchanged.",
+            "description": "Include the saved workflow snapshot (default: true). Set false to omit block configuration from a log read. Other run fields are unchanged.",
             "schema": {
-              "description": "Include the saved workflow snapshot. Set false to omit block configuration from a log read. Other run fields are unchanged.",
+              "description": "Include the saved workflow snapshot (default: true). Set false to omit block configuration from a log read. Other run fields are unchanged.",
               "type": "boolean"
             }
           }

apps/sim/blocks/blocks/stripe.ts

@@ -1123,19 +1123,20 @@ export const StripeBlockMeta = {
       description:
         'Create and confirm a Stripe payment intent to collect a charge from a customer.',
       content:
-        '# Collect Payment\n\nCharge a customer by creating and confirming a payment intent.\n\n## Steps\n1. Run Create Payment Intent with the amount, currency, and customer.\n2. Confirm the intent with Confirm Payment Intent, or Capture Payment Intent if it was created for manual capture.\n3. If a charge needs to be aborted, run Cancel Payment Intent instead.\n\n## Output\nReturn the payment intent ID, its status (succeeded, requires action, or canceled), and the captured amount.',
+        '# Collect Payment\n\nCharge a customer by creating and confirming a payment intent.\n\n## Steps\n1. Run Create Payment Intent with the amount, currency, and customer.\n2. Confirm the intent with Confirm Payment Intent and a payment method. If the confirmed intent has status requires_capture, run Capture Payment Intent to collect the authorized funds.\n3. If a charge needs to be aborted, run Cancel Payment Intent instead.\n\n## Output\nReturn the payment intent ID, its status (succeeded, requires action, or canceled), and the captured amount.',
     },
     {
       name: 'manage-subscription',
-      description: 'Create, update, pause, or cancel a Stripe subscription for a customer.',
+      description:
+        'Create a Stripe subscription, manage its cancellation, or resume a paused subscription.',
       content:
-        '# Manage Subscription\n\nHandle the lifecycle of a recurring subscription.\n\n## Steps\n1. To start a subscription, run Create Subscription with the customer and price items.\n2. To change a plan, run Update Subscription with the new items. To pause and later restart, use Cancel Subscription or Resume Subscription as appropriate.\n3. Confirm the current state with Retrieve Subscription.\n\n## Output\nReturn the subscription ID, its status, current period end, and the plan items, and note exactly what changed.',
+        '# Manage Subscription\n\nHandle the lifecycle of a recurring subscription.\n\n## Steps\n1. To start a subscription, run Create Subscription with the customer and price items.\n2. Use Update Subscription with cancel_at_period_end to schedule or reverse a cancellation before it takes effect. Use Cancel Subscription only for immediate cancellation. Resume Subscription applies only to a paused subscription; it does not restart a canceled subscription.\n3. Confirm the current state with Retrieve Subscription.\n\n## Output\nReturn the subscription ID, its status, and the returned subscription items, and note exactly what changed.',
     },
     {
       name: 'issue-invoice',
       description: 'Create, finalize, and send a Stripe invoice to a customer, then track payment.',
       content:
-        '# Issue Invoice\n\nBill a customer with a Stripe invoice.\n\n## Steps\n1. Run Create Invoice for the customer with the line items.\n2. Run Finalize Invoice to lock it, then Send Invoice to deliver it to the customer.\n3. Track payment with Retrieve Invoice, or run Pay Invoice to charge a saved payment method. Use Void Invoice to cancel an unpaid invoice.\n\n## Output\nReturn the invoice ID, its status (draft, open, paid, or void), the amount due, and the hosted invoice URL when available.',
+        '# Issue Invoice\n\nBill a customer with a Stripe invoice.\n\n## Steps\n1. Run Create Invoice for the customer. This tool does not add line items; add them in Stripe and verify the draft with Retrieve Invoice before finalizing.\n2. Run Finalize Invoice to lock it, then Send Invoice to deliver it to the customer.\n3. Track payment with Retrieve Invoice, or run Pay Invoice to charge a saved payment method. Use Void Invoice to cancel an unpaid invoice.\n\n## Output\nReturn the invoice ID, its status (draft, open, paid, or void), the amount due, and the hosted invoice URL when available.',
     },
     {
       name: 'find-customer-activity',

apps/sim/lib/api/contracts/v2/logs.ts

@@ -720,7 +720,7 @@ export const v2GetLogContract = defineRouteContract({
       includeWorkflowState: booleanQueryFlagSchema
         .default(true)
         .describe(
-          'Include the saved workflow snapshot. Set false to omit block configuration from a log read. Other run fields are unchanged.'
+          'Include the saved workflow snapshot (default: true). Set false to omit block configuration from a log read. Other run fields are unchanged.'
         ),
     })
     .strict()

apps/sim/tools/generated/tool-metadata.ts

@@ -18,7 +18,7 @@ export const stripeResumeSubscriptionTool: ToolConfig<
 > = {
   id: 'stripe_resume_subscription',
   name: 'Stripe Resume Subscription',
-  description: 'Resume a subscription that was scheduled for cancellation',
+  description: 'Resume a paused subscription',
   version: '1.0.0',
 
   params: {

apps/sim/tools/stripe/resume_subscription.ts

@@ -23,7 +23,7 @@ export const stripeSearchSubscriptionsTool: ToolConfig<
       type: 'string',
       required: true,
       visibility: 'user-or-llm',
-      description: "Search query (e.g., \"status:'active' AND customer:'cus_xxx'\")",
+      description: "Search query (e.g., \"status:'active' AND metadata['order_id']:'6735'\")",
     },
     page: {
       type: 'string',

apps/sim/tools/stripe/search_subscriptions.ts

@@ -24693,7 +24693,7 @@
         },
         {
           "name": "Resume Subscription",
-          "description": "Resume a subscription that was scheduled for cancellation"
+          "description": "Resume a paused subscription"
         },
         {
           "name": "List Subscriptions",