{
  "schema": "varexis-index-free-publication-preview/1",
  "catalogue_version": "evidence-boundaries-75-v1",
  "route_id": "agentic_reviewed_openai_local_shell_patch_approval_opt_in",
  "record_id": "VXI-EXT-BOUNDARY75-OPENAI-LOCAL-SHELL-PATCH-APPROVAL-OPT-IN-01-v1",
  "question": "Does setting an OpenAI Agents SDK on_approval callback require approval for local shell or patch calls?",
  "answer": "In the pinned Python SDK documentation, local ShellTool and ApplyPatchTool default needs_approval to False. An on_approval callback alone does not enable approval. The callback runs only for calls that require approval and lack an existing decision; configure needs_approval separately.",
  "records": [
    {
      "record_id": "VXI-EXT-BOUNDARY75-OPENAI-LOCAL-SHELL-PATCH-APPROVAL-OPT-IN-01-v1",
      "url": "/varexis-index/records/openai-local-shell-patch-approval-opt-in.json",
      "content_sha256": "e0e9bc9e7fd5788f4b770d85da749e3411fd9582fa2c00cf8a522f269af042a9",
      "evidence": {
        "schema": "varexis-public-evidence-record/0.3",
        "generated_at_utc": "2026-11-08T01:13:32.115Z",
        "record_id": "VXI-EXT-BOUNDARY75-OPENAI-LOCAL-SHELL-PATCH-APPROVAL-OPT-IN-01-v1",
        "record_kind": "external_reference",
        "title": "Local shell and patch approval opt-in",
        "system": "OpenAI",
        "evidence_family": "vendor_evidence_review",
        "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
        "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
        "canonical_question": "Does setting an OpenAI Agents SDK on_approval callback require approval for local shell or patch calls?",
        "near_questions": [
          "Does on_approval turn on local ShellTool approval?",
          "What happens when ApplyPatchTool keeps needs_approval at its default?",
          "When does the local OpenAI approval callback run?",
          "Can an existing approval decision bypass a local callback?"
        ],
        "supported_claims": [
          {
            "claim": "In the pinned Python SDK documentation, local ShellTool and ApplyPatchTool default needs_approval to False. An on_approval callback alone does not enable approval. The callback runs only for calls that require approval and lack an existing decision; configure needs_approval separately.",
            "reliance": "DOCUMENTED_CAPABILITY_ONLY"
          }
        ],
        "not_demonstrated_claims": [
          "Do not count a callback declaration as an active approval gate without the effective needs_approval policy and existing decision state.",
          "A needs_approval=True call without an existing decision can invoke the callback; not every callback is bypassed.",
          "Buyer implementation, live runtime enforcement, settled payment, verified deletion or certification are not established.",
          "No expanded capabilities or licences for existing INDEX executables."
        ],
        "public_summary": "In the pinned Python SDK documentation, local ShellTool and ApplyPatchTool default needs_approval to False. An on_approval callback alone does not enable approval. The callback runs only for calls that require approval and lack an existing decision; configure needs_approval separately.",
        "related_record_ids": [],
        "source_review": {
          "source_type": "official_external_documentation",
          "source_title": "OpenAI Agents Python human-in-the-loop guide, v0.24.0",
          "source_url": "https://raw.githubusercontent.com/openai/openai-agents-python/17d994bd3045dae71acda676a4ef4762ed8ecd94/docs/human_in_the_loop.md",
          "checked_on": "2026-11-08",
          "candidate_record_id": "VXI-EXT-BOUNDARY75-OPENAI-LOCAL-SHELL-PATCH-APPROVAL-OPT-IN-01-v1",
          "candidate_record_sha256": "2715247844f166a59896ed0052a6f6a5d1a3c00aac63a98388a7b05813a96fdf",
          "method": "Primary documentation reviewed for the published bounded statement.",
          "deployment_tested_by_varexis": false,
          "revalidation": "The delivered snapshot preserves the review date shown. Recheck current primary documentation and deployment context before relying on present applicability; payment does not trigger fresh research."
        },
        "answer_policy": {
          "classification": "DOCUMENTED_WITH_DEPLOYMENT_BOUNDARY",
          "bounded_answer": "In the pinned Python SDK documentation, local ShellTool and ApplyPatchTool default needs_approval to False. An on_approval callback alone does not enable approval. The callback runs only for calls that require approval and lack an existing decision; configure needs_approval separately.",
          "required_buyer_context": "Exact installed version, provider variant and effective non-secret configuration; Relevant pending-call identifiers, declared arguments and decision provenance without secrets; Application-owned review policy and independently observed outcomes where needed. Buyer deployment not inspected.",
          "missing_evidence": "A broader claim needs evidence matching the intended use. Payment does not upgrade the evidence state."
        },
        "private_boundary": "Raw logs, thresholds, private paths, source code, protected mechanisms and reconstruction-level details are excluded from public and paid delivery.",
        "decision_profile": {
          "schema": "varexis-vendor-evidence-review/1",
          "review_status": "documentation_review_only",
          "applicability_status": "OpenAI Agents Python v0.24.0 Review capture 2026-11-08. Buyer deployment not inspected.",
          "checked_on": "2026-11-08",
          "claim_to_check": "Does setting an OpenAI Agents SDK on_approval callback require approval for local shell or patch calls?",
          "documented_statement": {
            "status": "documented",
            "statement": "In the pinned Python SDK documentation, local ShellTool and ApplyPatchTool default needs_approval to False. An on_approval callback alone does not enable approval. The callback runs only for calls that require approval and lack an existing decision; configure needs_approval separately.",
            "source_ids": [
              "agents-hitl"
            ]
          },
          "review_inference": {
            "status": "review_inference",
            "statement": "Do not count a callback declaration as an active approval gate without the effective needs_approval policy and existing decision state. Existing Claude callback shadowing and Agent Framework auto-approval records concern different policy orderings. This decision tests whether the local OpenAI callback opts in at all, with a separate default-false switch. Operational review inference; no deployment outcome was observed.",
            "source_ids": [
              "agents-hitl"
            ]
          },
          "buyer_evidence_required": [
            "Exact installed version, provider variant and effective non-secret configuration",
            "Relevant pending-call identifiers, declared arguments and decision provenance without secrets",
            "Application-owned review policy and independently observed outcomes where needed"
          ],
          "review_condition": {
            "status": "varexis_review_policy",
            "statement": "Do not count a callback declaration as an active approval gate without the effective needs_approval policy and existing decision state."
          },
          "unknowns": "Buyer implementation, installed versions, effective authority, source completeness and actual business outcomes were not inspected.",
          "unknown_finding": {
            "status": "unknown",
            "statement": "No buyer deployment or transaction was observed."
          },
          "evidence_sources": [
            {
              "repository": "openai/openai-agents-python",
              "tag": "v0.24.0",
              "revision": "17d994bd3045dae71acda676a4ef4762ed8ecd94",
              "url": "https://raw.githubusercontent.com/openai/openai-agents-python/17d994bd3045dae71acda676a4ef4762ed8ecd94/docs/human_in_the_loop.md",
              "retrieved_at": "2026-11-08T01:00:37.547Z",
              "file": "openai-agents-python-docs-human_in_the_loop.md",
              "sha256": "e829334efea38736aabbd246cd93d588ac230a54e523ac4ffd5845baf88b4f48",
              "bytes": 19817,
              "source_id": "agents-hitl",
              "status": 200,
              "title": "OpenAI Agents Python human-in-the-loop guide, v0.24.0",
              "publisher": "OpenAI",
              "checked_on": "2026-11-08",
              "capture_status": "captured_primary_documentation",
              "claim_review_completed": true,
              "hash_basis": "Original raw pinned source bytes retained privately; not deployment attestation.",
              "version_context": "v0.24.0 at 17d994bd3045dae71acda676a4ef4762ed8ecd94. Other versions and deployed configurations require separate evidence.",
              "rights_disposition": "Original short factual paraphrases with source attribution; no code or full documentation redistribution; raw captures remain private. Source licence MIT; third-party marks do not imply endorsement.",
              "licence_capture": {
                "repository": "openai/openai-agents-python",
                "tag": "v0.24.0",
                "revision": "17d994bd3045dae71acda676a4ef4762ed8ecd94",
                "url": "https://raw.githubusercontent.com/openai/openai-agents-python/17d994bd3045dae71acda676a4ef4762ed8ecd94/LICENSE",
                "retrieved_at": "2026-11-08T01:00:38.139Z",
                "file": "openai-agents-python-LICENSE",
                "sha256": "13df7812ca53ecaae1cb4a868844bb598373047ae1d580e4debfbef1dd5b6915",
                "bytes": 1063
              },
              "reviewed_sections": [
                "Approval configuration: local shell and file edits",
                "Long-running approvals / Keep approval state on the server",
                "Approval decisions / resolving a subset of interruptions",
                "Approval decisions / HostedMCPTool sticky decisions"
              ]
            }
          ],
          "observed_deployment": false,
          "commercial_reliance_boundary": "Documentation supports only the stated boundary. Existing licensed checkers analyse supported supplied declarations locally; they do not inspect provider accounts, verify live behaviour, enforce decisions or certify compliance.",
          "paid_value": {
            "decision_context": "Do not count a callback declaration as an active approval gate without the effective needs_approval policy and existing decision state.",
            "free": "Complete source review, questions, provenance and limitations; free to read and save locally.",
            "single_request": "Unavailable for this publication-only record; historical saved retrieval is unchanged.",
            "evidence_receipt": "Unavailable for this publication-only record; no paid retrieval entitlement is added.",
            "excluded": [
              "Fresh source research",
              "Native provider integration or schema support",
              "Live inspection or runtime enforcement",
              "Payment settlement or verified deletion",
              "Certification or expanded licences"
            ],
            "integrity": "Hashes identify content versions; they do not prove factual truth or provide a signature."
          },
          "revalidation": {
            "trigger": "Recheck current primary documentation and applicable SDK, service and configuration before reliance. No ongoing monitoring is included.",
            "specific_watch": "Approval configuration: local shell and file edits"
          },
          "buyer_relevance": "Do not count a callback declaration as an active approval gate without the effective needs_approval policy and existing decision state.",
          "refusal_conditions": [
            "Do not count a callback declaration as an active approval gate without the effective needs_approval policy and existing decision state.",
            "Do not infer deployment conformance, authority or successful outcomes from source documentation."
          ],
          "decision_context": {
            "operator": "Developer or reviewer assessing agent execution and evidence",
            "scenario": "Does setting an OpenAI Agents SDK on_approval callback require approval for local shell or patch calls?",
            "consequence": "Do not count a callback declaration as an active approval gate without the effective needs_approval policy and existing decision state.",
            "confidence": "Primary-documentation support only; buyer demand and deployment outcomes unestablished."
          },
          "novelty_review": {
            "candidate_id": "BOUNDARY75-01",
            "disposition": "new_distinct",
            "nearest_record_id": "VXI-EXT-ICE09-CLAUDE-SDK-CANUSETOOL-SHADOWED-APPROVAL-PATH-01-v1",
            "nearest_record_url": "/varexis-index/records/claude-sdk-canusetool-shadowed-approval-path.json",
            "nearest_record_sha256": "a68a9d2a59b84286d08a57ce51e3593f2a85242746af8f89f342a9fe99b21774",
            "material_distinction": "Existing Claude callback shadowing and Agent Framework auto-approval records concern different policy orderings. This decision tests whether the local OpenAI callback opts in at all, with a separate default-false switch.",
            "review_status": "Distinct second pass by implementing reviewer; no independent reviewer agent or buyer evaluation claimed.",
            "counterexample": "A needs_approval=True call without an existing decision can invoke the callback; not every callback is bypassed."
          },
          "optional_selection": {
            "guide_id": "agent-authority-tool-trust",
            "guide_url": "/index-guides/agent-authority-tool-trust",
            "guide_manifest": "/varexis-index/decision-guides.json",
            "checker": {
              "product_id": "agent-tool-admission",
              "price_gbp_excluding_vat": 49,
              "purchase_url": "/index-access?route=agentic_pack_tool_admission_v1",
              "licence_scope": "Existing separate internal-use licence; subscriptions do not include the executable.",
              "benefit": "Optional local analysis of supported supplied declarations only; no native SDK parser, credential inspection or new provider integration is added."
            },
            "boundary": "This free record supports an evidence-selection decision. The existing checker does not diagnose these platforms, extract their logs or prove the documented condition occurred."
          },
          "exact_access": {
            "endpoint": "/mcp/catalogue",
            "tool": "get_publication_record",
            "arguments": {
              "record_id": "VXI-EXT-BOUNDARY75-OPENAI-LOCAL-SHELL-PATCH-APPROVAL-OPT-IN-01-v1"
            },
            "record_url": "/varexis-index/records/openai-local-shell-patch-approval-opt-in.json",
            "original_mcp_search": false,
            "paid_saved_retrieval": false
          }
        },
        "niche": {
          "niche_id": "boundary75-governance",
          "label": "Agent Governance & Policy Boundaries",
          "classification_id": "governance",
          "classification_label": "Agent Governance & Policy Boundaries",
          "topic_id": "governance",
          "buyer_intent": "Do not count a callback declaration as an active approval gate without the effective needs_approval policy and existing decision state.",
          "comparison_role": "supplementary_discovery"
        },
        "paid_access_note": "The full published answer and boundaries are free. Paid access saves the selected route and source versions, with an unsigned receipt when purchased. Preview coverage before paying. Fresh research, bespoke assessment and protected evidence are excluded.",
        "service_route": {
          "request_guide": "/varexis-index/request.html",
          "request_workflow": "/varexis-index/request-workflow.json",
          "service_id": "single_request",
          "service_routes_url": "/varexis-index/service-routes.json",
          "payment_required": true,
          "availability_endpoint": "/api/index/capabilities",
          "operational_status": "AUTOMATIC_SERVICE_CAPABILITIES_GATED",
          "checkout_url": "/index-access"
        },
        "authority_boundary": "VAREXIS-INDEX informs evidence reliance. It does not provide advice, certification, deployment authority, security assurance, production approval, or guarantee.",
        "human_page": "/varexis-index/catalog.html#openai-local-shell-patch-approval-opt-in",
        "machine_readable_record": "/varexis-index/records/openai-local-shell-patch-approval-opt-in.json"
      }
    }
  ],
  "access": {
    "mode": "exact_http_only",
    "payment_required": false,
    "purchase_url": null,
    "mcp_preview_available": false,
    "paid_saved_retrieval_available": false,
    "natural_language_search_qualified": false
  },
  "boundary": "Catalogue additions are available free through the exact HTTP JSON links below. Enhanced natural-language discovery is not yet qualified for these records. They are outside MCP search, MCP preview and paid saved retrieval. No search qualification, executable capability or entitlement is added.",
  "content_sha256": "069db2741f0ce69a0a07dcdeef180f0f93e7f992d79218473a0efd15e6057982"
}
