FetchSandbox

{'type': 'object', 'properties': {'intent': {'type': 'string', 'description': "User's free-form integration ask, on the FIRST call only. Pass through verbatim â\x80\x94 the server's intent router benefits from the full phrasing."}, 'context': {'type': 'object', 'description': "Optional context the LLM brings to the turn â\x80\x94 e.g. a summary of the user's repo (if you ran an introspect step), or the result of a previously-instructed `tool_call`."}, 'session_id': {'type': 'string', 'description': 'Returned by a previous coach call. Required on every call after the first.'}, 'user_response': {'type': 'string', 'description': "The user's reply to the previous coach turn's question. Required when the previous turn returned `next_action: wait_for_user`."}}}

{'type': 'object', 'required': ['intent'], 'properties': {'hints': {'type': 'object', 'properties': {'spec': {'type': 'string', 'description': 'Force a specific spec slug.'}, 'scenario': {'type': 'string', 'description': 'Force a specific failure scenario name.'}, 'workflow': {'type': 'string', 'description': 'Force a specific workflow_id.'}}, 'description': 'Optional caller-supplied overrides. Each field short-circuits the corresponding detection step.'}, 'intent': {'type': 'string', 'description': "The developer's free-form prompt as they typed it. Don't pre-process or shorten â\x80\x94 the router benefits from the full phrasing (capture timing, geo cues, failure mode language)."}}}

{'type': 'object', 'properties': {'spec_id': {'type': 'string', 'description': 'The spec_id returned by import_spec.'}, 'spec_slug': {'type': 'string', 'description': "A human name like 'resend' or 'stripe'. Use this when you do not have a spec_id â\x80\x94 you do not need to look one up first."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['spec_slug', 'workflow_name'], 'properties': {'scenario': {'type': 'string', 'description': "OPTIONAL failure scenario to reproduce (e.g. webhook_retries, payment_declined). Take it from guide's matched_bug_pattern.reproduce_with.scenario. Omit for the happy path."}, 'spec_slug': {'type': 'string', 'description': "The bundled spec slug from guide (e.g. 'stripe'). Lowercase."}, 'workflow_name': {'type': 'string', 'description': "The workflow id from guide (e.g. 'accept_payment')."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['sandbox_id', 'workflow_name'], 'properties': {'scenario': {'type': 'string', 'description': "OPTIONAL failure scenario to exercise (e.g. payment_declined, insufficient_funds, fraud_hold). Toggles the sandbox engine's scenario for the duration of the run, then restores. Use this for 'test with declined card' / 'simulate failure X' intents. Omit for the happy path."}, 'sandbox_id': {'type': 'string', 'description': 'The sandbox_id returned by import_spec.'}, 'workflow_name': {'type': 'string', 'description': 'Workflow id or name from list_workflows. Case-insensitive; dashes and underscores are interchangeable.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'arm': {'type': 'string', 'description': 'Probe ID from the matrix to arm before running the app. Requires session_id.'}, 'probe': {'type': 'string', 'description': 'Probe ID from the matrix to evaluate after running the app. Requires session_id and run_id.'}, 'suite': {'enum': ['receipt_delivery_v1', 'receipt_recovery_v1'], 'type': 'string', 'description': 'Configure the declared application receipt suite on this session.'}, 'cancel': {'type': 'boolean', 'description': 'Abort the attempt or retry failed cleanup. Requires session_id and run_id; cannot combine with arm or probe.'}, 'run_id': {'type': 'string', 'description': 'Attempt ID returned by arm. Required with probe or cancel; prevents stale calls from consuming a newer attempt.'}, 'execute': {'type': 'boolean', 'description': 'Drive the configured app and evaluate the frozen receipt suite. Requires session_id/run_id; configuration acknowledgment alone is not proof.'}, 'providers': {'type': 'array', 'items': {'type': 'string'}, 'description': "Provider slugs the app integrates, e.g. ['stripe'] or ['paddle','resend']. Required to start a session."}, 'session_id': {'type': 'string', 'description': 'Returned by the first call. Pass it back after their app has run a flow to see what it did.'}, 'app_base_url': {'type': 'string', 'description': 'Where their app is deployed, if known. Recorded so a later step can deliver webhooks to it.'}, 'receipt_config': {'type': 'object', 'required': ['webhook_url', 'recipient_a', 'recipient_b', 'purchase_marker', 'app_version', 'source_lookup_required'], 'properties': {'app_version': {'type': 'string', 'description': 'Declared application build identifier; not code attestation.'}, 'recipient_a': {'type': 'string', 'description': 'Expected test recipient for purchase A, fixed before execution.'}, 'recipient_b': {'type': 'string', 'description': 'Different test recipient for the different-customer case.'}, 'webhook_url': {'type': 'string', 'description': 'Exact normal application webhook URL, including path.'}, 'purchase_marker': {'type': 'object', 'required': ['field'], 'properties': {'field': {'enum': ['html', 'text', 'subject', 'tags'], 'type': 'string'}, 'tag_name': {'type': 'string'}}, 'description': 'Where the normal receipt includes its Paddle transaction ID; same-record recipient/marker matching is required.', 'additionalProperties': False}, 'purchase_context': {'type': 'object', 'description': 'Application routing custom_data, e.g. test workspace ID. Never credentials.'}, 'observation_seconds': {'type': 'number', 'maximum': 5, 'minimum': 0.1, 'description': 'Observation window after each checkpoint; default 2 seconds. Verdict covers only measured windows.'}, 'source_lookup_required': {'type': 'boolean', 'description': 'Whether the app reads the source provider during its normal webhook handler.'}}, 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'required': ['bug_pattern_id'], 'properties': {'prompt': {'type': 'string', 'description': "OPTIONAL. The user's own description of the symptom. For patterns that can originate in the handler OR the provider, this classifies which side to simulate. Omit to run both."}, 'sandbox_id': {'type': 'string', 'description': "OPTIONAL. The sandbox from the run. Pass with flow_run_id to save the diff onto that run's receipt. This binds the pattern to that sandbox's provider; provide it when verifying a provider integration."}, 'flow_run_id': {'type': 'string', 'description': 'OPTIONAL. The flow_run_id returned by run_workflow. Pass with sandbox_id so the receipt URL renders the diff alongside the steps.'}, 'bug_pattern_id': {'type': 'string', 'description': "The bug_pattern to prove (e.g. webhook_duplicate_side_effect). Comes from guide's matched_bug_pattern.id or the spec's brain."}}, 'additionalProperties': False}