FlareSignal Machine API

{"openapi":"3.1.0","info":{"title":"FlareSignal Machine API","version":"1.27.0","description":"Generated from the public FlareSignal capability registry. Discovery exposes stable schemas, access requirements, provenance, freshness, assurance and invocation metadata. Private implementation details that are not required for machine invocation or interpretation are intentionally omitted."},"servers":[{"url":"https:\/\/flaresignal.io\/"}],"paths":{"\/wp-json\/flaresignal\/v1\/machine\/agent\/access":{"get":{"operationId":"agent_access_catalog","summary":"Agent access and delegation catalogue","description":"Describe API-key bootstrap, short-lived delegated agent sessions, read-only scope profiles, TTL limits, live entitlement\/revocation policy and the non-delegable generic-surface boundary.","tags":["agent","access","sessions","permissions","api"],"x-flaresignal-capability-id":"flaresignal.agent.access.catalog","x-flaresignal-capability-version":"1.0.0","x-flaresignal-lifecycle":{"state":"available","machine_contract_ready":true,"deprecated":false},"x-flaresignal-truth":{"canonicality":"canonical","source_authority":["flaresignal_registry"],"units":[],"freshness_policy":"registry","methodology_id":"delegated-agent-session-control","methodology_version":"1.0.1","evidence_available":true,"source_health_required":true,"allow_stale_return":false},"x-flaresignal-assurance":{"schema_version":"flaresignal.machine-assurance.v1","version":"1.0.0","attached_to_success":true,"attached_to_errors":true,"confidence_semantics":"deterministic_evidence_quality_not_probability","historical_completeness":"requested_window_or_explicit_not_required"},"x-flaresignal-access":{"mode":"public","entitlement":null,"x402":{"enabled":false,"schemes":["exact"],"accepts":[],"bazaar_discoverable":false,"payment_identifier_required":true,"signed_offer_receipt":true}},"x-flaresignal-audit":{"schema_version":"flaresignal.machine-audit.v1","state":"active","response_hash":{"algorithm":"sha256","canonicalization":"flaresignal-json-c14n-v1"},"client_identity":"when_available","source_health_snapshot":true,"evidence_references":true,"entitlement_linkage":true,"payment_linkage":true},"x-flaresignal-mcp":true,"x-flaresignal-discovery-semantics":{"schema_version":"flaresignal.discovery-semantics.v2","topics":["agent","access","sessions","permissions","api"],"assets":[],"domains":["agent"],"intents":["query","inspect"],"questions_answered":[],"not_suitable_for":["Do not use this capability to infer facts that are absent from its returned evidence or declared truth boundary."],"input_examples":[{}],"output_summary":"Structured Agent access and delegation catalogue response with FlareSignal truth\/provenance metadata.","freshness_summary":"Uses the capability freshness policy: registry.","provenance_summary":"Use the returned source authority, timestamps, source-health state, methodology and evidence references; missing evidence is never manufactured.","confidence_semantics":"Successful machine responses carry flaresignal.machine-assurance.v1. Confidence is a deterministic evidence-quality classification derived from canonicality, evidence quality, freshness, source health and relevant historical coverage; it is not a probability. Discovery ranking remains relevance only.","commercial":{"access_mode":"public","paid":false,"x402_bazaar_discoverable":false,"sample_available":true},"related_capabilities":[]},"responses":{"200":{"description":"Successful response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineResponse"}}}},"400":{"description":"Invalid machine request","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineError"}}}},"402":{"description":"x402 payment required where enabled"},"403":{"description":"Entitlement required"},"503":{"description":"Required source or payment provider unavailable"}}}},"\/wp-json\/flaresignal\/v1\/machine\/agent\/brief":{"get":{"operationId":"agent_brief_query","summary":"Broad Flare intelligence brief","description":"Route a broad natural-language Flare question to a compact provenance-aware packet of entitled canonical observations with deterministic drill-down capabilities and follow-up questions.","tags":["agent","brief","network-state","xrpfi","yield","collateral","market-structure","research"],"x-flaresignal-capability-id":"flaresignal.agent.brief.query","x-flaresignal-capability-version":"1.0.0","x-flaresignal-lifecycle":{"state":"available","machine_contract_ready":true,"deprecated":false},"x-flaresignal-truth":{"canonicality":"derived","source_authority":["canonical_metric_store","canonical_source_registry"],"units":["metric_defined"],"freshness_policy":"latest_retained_observations","methodology_id":"agent-intelligence-broad-brief","methodology_version":"1.0","evidence_available":true,"source_health_required":true,"allow_stale_return":false},"x-flaresignal-assurance":{"schema_version":"flaresignal.machine-assurance.v1","version":"1.0.0","attached_to_success":true,"attached_to_errors":true,"confidence_semantics":"deterministic_evidence_quality_not_probability","historical_completeness":"requested_window_or_explicit_not_required"},"x-flaresignal-access":{"mode":"public","entitlement":null,"x402":{"enabled":false,"schemes":["exact"],"accepts":[],"bazaar_discoverable":false,"payment_identifier_required":true,"signed_offer_receipt":true}},"x-flaresignal-audit":{"schema_version":"flaresignal.machine-audit.v1","state":"active","response_hash":{"algorithm":"sha256","canonicalization":"flaresignal-json-c14n-v1"},"client_identity":"when_available","source_health_snapshot":true,"evidence_references":true,"entitlement_linkage":true,"payment_linkage":true},"x-flaresignal-mcp":true,"x-flaresignal-discovery-semantics":{"schema_version":"flaresignal.discovery-semantics.v2","topics":["agent","brief","network-state","xrpfi","yield","collateral","market-structure","research","network snapshot","liquidity","risk","value capture","derivatives","historical research"],"assets":["FLR","SGB","XRP","FXRP","stXRP"],"domains":["agent-intelligence","broad-query","network-state"],"intents":["answer-broad-query","brief","route-deeper"],"questions_answered":["What is happening on Flare right now?","Give me one compact verified Flare briefing before I decide whether to drill deeper.","What changed across market, XRPFi, liquidity, yield or risk?"],"not_suitable_for":["Broad briefs are compact evidence\/routing packets, not substitutes for deep historical product packets or causal research."],"input_examples":[{"query":"What is happening on Flare right now?"},{"query":"Where is the XRP and what can it earn?"},{"packet":"market_structure"}],"output_summary":"Structured Broad Flare intelligence brief response with FlareSignal truth\/provenance metadata.","freshness_summary":"Uses the capability freshness policy: latest_retained_observations.","provenance_summary":"Use the returned source authority, timestamps, source-health state, methodology and evidence references; missing evidence is never manufactured.","confidence_semantics":"Successful machine responses carry flaresignal.machine-assurance.v1. Confidence is a deterministic evidence-quality classification derived from canonicality, evidence quality, freshness, source health and relevant historical coverage; it is not a probability. Discovery ranking remains relevance only.","commercial":{"access_mode":"public","paid":false,"x402_bazaar_discoverable":false,"sample_available":true},"related_capabilities":["flaresignal.agent.ontology.get","flaresignal.agent.questions.catalog","flaresignal.products.search","flaresignal.history.coverage.query"]},"responses":{"200":{"description":"Successful response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineResponse"}}}},"400":{"description":"Invalid machine request","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineError"}}}},"402":{"description":"x402 payment required where enabled"},"403":{"description":"Entitlement required"},"503":{"description":"Required source or payment provider unavailable"}},"parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","maxLength":300},"description":""},{"name":"packet","in":"query","required":false,"schema":{"type":"string"},"description":""},{"name":"max_metrics","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":30},"description":""}]}},"\/wp-json\/flaresignal\/v1\/machine\/agent\/ontology":{"get":{"operationId":"agent_ontology_get","summary":"Flare economic ontology","description":"Expose machine-only concepts, aliases and typed relationships connecting market, XRPFi, yield, collateral, productive capital, liquidity, value capture, events and historical coverage without asserting causality.","tags":["agent","ontology","relationships","economic-map","machine-only"],"x-flaresignal-capability-id":"flaresignal.agent.ontology.get","x-flaresignal-capability-version":"1.0.0","x-flaresignal-lifecycle":{"state":"available","machine_contract_ready":true,"deprecated":false},"x-flaresignal-truth":{"canonicality":"canonical","source_authority":["flaresignal_registry"],"units":[],"freshness_policy":"registry","methodology_id":"flare-economic-ontology","methodology_version":"1.0","evidence_available":true,"source_health_required":true,"allow_stale_return":false},"x-flaresignal-assurance":{"schema_version":"flaresignal.machine-assurance.v1","version":"1.0.0","attached_to_success":true,"attached_to_errors":true,"confidence_semantics":"deterministic_evidence_quality_not_probability","historical_completeness":"requested_window_or_explicit_not_required"},"x-flaresignal-access":{"mode":"public","entitlement":null,"x402":{"enabled":false,"schemes":["exact"],"accepts":[],"bazaar_discoverable":false,"payment_identifier_required":true,"signed_offer_receipt":true}},"x-flaresignal-audit":{"schema_version":"flaresignal.machine-audit.v1","state":"active","response_hash":{"algorithm":"sha256","canonicalization":"flaresignal-json-c14n-v1"},"client_identity":"when_available","source_health_snapshot":true,"evidence_references":true,"entitlement_linkage":true,"payment_linkage":true},"x-flaresignal-mcp":true,"x-flaresignal-discovery-semantics":{"schema_version":"flaresignal.discovery-semantics.v2","topics":["agent","ontology","relationships","economic-map","machine-only"],"assets":["FLR","SGB","XRP","FXRP"],"domains":["agent-intelligence","ontology"],"intents":["understand-relationships","select-evidence","route-research"],"questions_answered":["How are FlareSignal market, XRPFi, yield, collateral, liquidity, value-capture and historical concepts related?","Which metrics should an agent inspect together without assuming causality?"],"not_suitable_for":["Ontology relationships do not prove causal relationships."],"input_examples":[{},{"concept":"xrpfi_capital"}],"output_summary":"Structured Flare economic ontology response with FlareSignal truth\/provenance metadata.","freshness_summary":"Uses the capability freshness policy: registry.","provenance_summary":"Use the returned source authority, timestamps, source-health state, methodology and evidence references; missing evidence is never manufactured.","confidence_semantics":"Successful machine responses carry flaresignal.machine-assurance.v1. Confidence is a deterministic evidence-quality classification derived from canonicality, evidence quality, freshness, source health and relevant historical coverage; it is not a probability. Discovery ranking remains relevance only.","commercial":{"access_mode":"public","paid":false,"x402_bazaar_discoverable":false,"sample_available":true},"related_capabilities":["flaresignal.discovery.metrics.search","flaresignal.agent.brief.query"]},"responses":{"200":{"description":"Successful response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineResponse"}}}},"400":{"description":"Invalid machine request","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineError"}}}},"402":{"description":"x402 payment required where enabled"},"403":{"description":"Entitlement required"},"503":{"description":"Required source or payment provider unavailable"}},"parameters":[{"name":"concept","in":"query","required":false,"schema":{"type":"string"},"description":""}]}},"\/wp-json\/flaresignal\/v1\/machine\/agent\/plan":{"get":{"operationId":"agent_plan","summary":"Plan deterministic agent research","description":"Dry-run a evidence-backed research workflow over permanent cross-composition profiles. Returns declared claim\/metric dependencies, execution order, propagated entitlements and current historical readiness without executing analytical compositions.","tags":["agent","research","planner","orchestration"],"x-flaresignal-capability-id":"flaresignal.agent.plan","x-flaresignal-capability-version":"1.0.0","x-flaresignal-lifecycle":{"state":"available","machine_contract_ready":true,"deprecated":false},"x-flaresignal-truth":{"canonicality":"canonical","source_authority":["flaresignal_registry","canonical_metric_store"],"units":[],"freshness_policy":"requested_range","methodology_id":"deterministic-agent-research-planner","methodology_version":"1.0","evidence_available":true,"source_health_required":true,"allow_stale_return":false},"x-flaresignal-assurance":{"schema_version":"flaresignal.machine-assurance.v1","version":"1.0.0","attached_to_success":true,"attached_to_errors":true,"confidence_semantics":"deterministic_evidence_quality_not_probability","historical_completeness":"requested_window_or_explicit_not_required"},"x-flaresignal-access":{"mode":"public","entitlement":null,"x402":{"enabled":false,"schemes":["exact"],"accepts":[],"bazaar_discoverable":false,"payment_identifier_required":true,"signed_offer_receipt":true}},"x-flaresignal-audit":{"schema_version":"flaresignal.machine-audit.v1","state":"active","response_hash":{"algorithm":"sha256","canonicalization":"flaresignal-json-c14n-v1"},"client_identity":"when_available","source_health_snapshot":true,"evidence_references":true,"entitlement_linkage":true,"payment_linkage":true},"x-flaresignal-mcp":true,"x-flaresignal-discovery-semantics":{"schema_version":"flaresignal.discovery-semantics.v2","topics":["agent","research","planner","orchestration"],"assets":[],"domains":["agent"],"intents":["query","inspect"],"questions_answered":[],"not_suitable_for":["Do not use this capability to infer facts that are absent from its returned evidence or declared truth boundary."],"input_examples":[{}],"output_summary":"Structured Plan deterministic agent research response with FlareSignal truth\/provenance metadata.","freshness_summary":"Uses the capability freshness policy: requested_range.","provenance_summary":"Use the returned source authority, timestamps, source-health state, methodology and evidence references; missing evidence is never manufactured.","confidence_semantics":"Successful machine responses carry flaresignal.machine-assurance.v1. Confidence is a deterministic evidence-quality classification derived from canonicality, evidence quality, freshness, source health and relevant historical coverage; it is not a probability. Discovery ranking remains relevance only.","commercial":{"access_mode":"public","paid":false,"x402_bazaar_discoverable":false,"sample_available":true},"related_capabilities":[]},"responses":{"200":{"description":"Successful response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineResponse"}}}},"400":{"description":"Invalid machine request","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineError"}}}},"402":{"description":"x402 payment required where enabled"},"403":{"description":"Entitlement required"},"503":{"description":"Required source or payment provider unavailable"}},"parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":400},"description":""},{"name":"profile_id","in":"query","required":false,"schema":{"type":"string","enum":["flr_structural_regime","flr_sgb_market_structure_regime","xrpfi_system_regime"]},"description":""},{"name":"asset","in":"query","required":false,"schema":{"type":"string","enum":["FLR","SGB","XRP","FXRP"]},"description":""},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["1D","3D","7D","15D","30D","90D","1Y","ALL"]},"description":""},{"name":"event_id","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":""},{"name":"event_horizon","in":"query","required":false,"schema":{"type":"string","enum":["1D","7D","30D","90D"]},"description":""}]}},"\/wp-json\/flaresignal\/v1\/machine\/agent\/questions":{"get":{"operationId":"agent_questions_catalog","summary":"Agent question catalogue","description":"Browse machine-only common questions and deterministic routes for broad Flare, XRPFi, yield, collateral, market-structure, risk and historical-research intents.","tags":["agent","questions","routing","machine-only","discovery"],"x-flaresignal-capability-id":"flaresignal.agent.questions.catalog","x-flaresignal-capability-version":"1.0.0","x-flaresignal-lifecycle":{"state":"available","machine_contract_ready":true,"deprecated":false},"x-flaresignal-truth":{"canonicality":"canonical","source_authority":["flaresignal_registry"],"units":[],"freshness_policy":"registry","methodology_id":"agent-question-catalogue","methodology_version":"1.0","evidence_available":true,"source_health_required":true,"allow_stale_return":false},"x-flaresignal-assurance":{"schema_version":"flaresignal.machine-assurance.v1","version":"1.0.0","attached_to_success":true,"attached_to_errors":true,"confidence_semantics":"deterministic_evidence_quality_not_probability","historical_completeness":"requested_window_or_explicit_not_required"},"x-flaresignal-access":{"mode":"public","entitlement":null,"x402":{"enabled":false,"schemes":["exact"],"accepts":[],"bazaar_discoverable":false,"payment_identifier_required":true,"signed_offer_receipt":true}},"x-flaresignal-audit":{"schema_version":"flaresignal.machine-audit.v1","state":"active","response_hash":{"algorithm":"sha256","canonicalization":"flaresignal-json-c14n-v1"},"client_identity":"when_available","source_health_snapshot":true,"evidence_references":true,"entitlement_linkage":true,"payment_linkage":true},"x-flaresignal-mcp":true,"x-flaresignal-discovery-semantics":{"schema_version":"flaresignal.discovery-semantics.v2","topics":["agent","questions","routing","machine-only","discovery"],"assets":["FLR","SGB","XRP","FXRP"],"domains":["agent-intelligence","question-catalog"],"intents":["discover-question","route-query"],"questions_answered":["What broad and deep questions can an AI agent ask FlareSignal?","Which machine-only question paths exist beyond the human visual interface?"],"not_suitable_for":["Do not use this capability to infer facts that are absent from its returned evidence or declared truth boundary."],"input_examples":[{},{"topic":"xrpfi_state"}],"output_summary":"Structured Agent question catalogue response with FlareSignal truth\/provenance metadata.","freshness_summary":"Uses the capability freshness policy: registry.","provenance_summary":"Use the returned source authority, timestamps, source-health state, methodology and evidence references; missing evidence is never manufactured.","confidence_semantics":"Successful machine responses carry flaresignal.machine-assurance.v1. Confidence is a deterministic evidence-quality classification derived from canonicality, evidence quality, freshness, source health and relevant historical coverage; it is not a probability. Discovery ranking remains relevance only.","commercial":{"access_mode":"public","paid":false,"x402_bazaar_discoverable":false,"sample_available":true},"related_capabilities":["flaresignal.agent.brief.query","flaresignal.discovery.metrics.search"]},"responses":{"200":{"description":"Successful response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineResponse"}}}},"400":{"description":"Invalid machine request","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineError"}}}},"402":{"description":"x402 payment required where enabled"},"403":{"description":"Entitlement required"},"503":{"description":"Required source or payment provider unavailable"}},"parameters":[{"name":"topic","in":"query","required":false,"schema":{"type":"string"},"description":""}]}},"\/wp-json\/flaresignal\/v1\/machine\/agent\/research":{"get":{"operationId":"agent_research","summary":"Execute deterministic agent research","description":"Execute a read-only research plan through the permanent cross-composition engine and return claim-level findings, contradictions, evidence gaps, selected evidence scope and reproducible lineage without re-deriving source metrics.","tags":["agent","research","orchestration","claims","contradictions"],"x-flaresignal-capability-id":"flaresignal.agent.research","x-flaresignal-capability-version":"1.0.0","x-flaresignal-lifecycle":{"state":"available","machine_contract_ready":true,"deprecated":false},"x-flaresignal-truth":{"canonicality":"derived_from_canonical","source_authority":["canonical_metric_store","canonical_source_registry","canonical_event_archive"],"units":["mixed_metric_units"],"freshness_policy":"requested_range","methodology_id":"deterministic-agent-research","methodology_version":"1.0","evidence_available":true,"source_health_required":true,"allow_stale_return":false},"x-flaresignal-assurance":{"schema_version":"flaresignal.machine-assurance.v1","version":"1.0.0","attached_to_success":true,"attached_to_errors":true,"confidence_semantics":"deterministic_evidence_quality_not_probability","historical_completeness":"requested_window_or_explicit_not_required"},"x-flaresignal-access":{"mode":"public","entitlement":null,"x402":{"enabled":false,"schemes":["exact"],"accepts":[],"bazaar_discoverable":false,"payment_identifier_required":true,"signed_offer_receipt":true}},"x-flaresignal-audit":{"schema_version":"flaresignal.machine-audit.v1","state":"active","response_hash":{"algorithm":"sha256","canonicalization":"flaresignal-json-c14n-v1"},"client_identity":"when_available","source_health_snapshot":true,"evidence_references":true,"entitlement_linkage":true,"payment_linkage":true},"x-flaresignal-mcp":true,"x-flaresignal-discovery-semantics":{"schema_version":"flaresignal.discovery-semantics.v2","topics":["agent","research","orchestration","claims","contradictions"],"assets":[],"domains":["agent"],"intents":["query","inspect"],"questions_answered":[],"not_suitable_for":["Do not use this capability to infer facts that are absent from its returned evidence or declared truth boundary."],"input_examples":[{}],"output_summary":"Structured Execute deterministic agent research response with FlareSignal truth\/provenance metadata.","freshness_summary":"Uses the capability freshness policy: requested_range.","provenance_summary":"Use the returned source authority, timestamps, source-health state, methodology and evidence references; missing evidence is never manufactured.","confidence_semantics":"Successful machine responses carry flaresignal.machine-assurance.v1. Confidence is a deterministic evidence-quality classification derived from canonicality, evidence quality, freshness, source health and relevant historical coverage; it is not a probability. Discovery ranking remains relevance only.","commercial":{"access_mode":"public","paid":false,"x402_bazaar_discoverable":false,"sample_available":true},"related_capabilities":[]},"responses":{"200":{"description":"Successful response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineResponse"}}}},"400":{"description":"Invalid machine request","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineError"}}}},"402":{"description":"x402 payment required where enabled"},"403":{"description":"Entitlement required"},"503":{"description":"Required source or payment provider unavailable"}},"parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":400},"description":""},{"name":"profile_id","in":"query","required":false,"schema":{"type":"string","enum":["flr_structural_regime","flr_sgb_market_structure_regime","xrpfi_system_regime"]},"description":""},{"name":"asset","in":"query","required":false,"schema":{"type":"string","enum":["FLR","SGB","XRP","FXRP"]},"description":""},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["1D","3D","7D","15D","30D","90D","1Y","ALL"]},"description":""},{"name":"event_id","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":""},{"name":"event_horizon","in":"query","required":false,"schema":{"type":"string","enum":["1D","7D","30D","90D"]},"description":""}]}},"\/wp-json\/flaresignal\/v1\/machine\/agent\/research\/{research_id}\/trace":{"get":{"operationId":"agent_research_trace","summary":"Trace one agent research packet","description":"Return cached read-only lineage for one recent research packet: finding to domain to permanent composition to claim to canonical metric, dataset and source evidence.","tags":["agent","research","trace","lineage","audit"],"x-flaresignal-capability-id":"flaresignal.agent.research.trace","x-flaresignal-capability-version":"1.0.0","x-flaresignal-lifecycle":{"state":"available","machine_contract_ready":true,"deprecated":false},"x-flaresignal-truth":{"canonicality":"derived_from_canonical","source_authority":["research_trace_store","canonical_metric_store"],"units":[],"freshness_policy":"research_trace_cache","methodology_id":"agent-research-lineage-trace","methodology_version":"1.0","evidence_available":true,"source_health_required":true,"allow_stale_return":false},"x-flaresignal-assurance":{"schema_version":"flaresignal.machine-assurance.v1","version":"1.0.0","attached_to_success":true,"attached_to_errors":true,"confidence_semantics":"deterministic_evidence_quality_not_probability","historical_completeness":"requested_window_or_explicit_not_required"},"x-flaresignal-access":{"mode":"public","entitlement":null,"x402":{"enabled":false,"schemes":["exact"],"accepts":[],"bazaar_discoverable":false,"payment_identifier_required":true,"signed_offer_receipt":true}},"x-flaresignal-audit":{"schema_version":"flaresignal.machine-audit.v1","state":"active","response_hash":{"algorithm":"sha256","canonicalization":"flaresignal-json-c14n-v1"},"client_identity":"when_available","source_health_snapshot":true,"evidence_references":true,"entitlement_linkage":true,"payment_linkage":true},"x-flaresignal-mcp":true,"x-flaresignal-discovery-semantics":{"schema_version":"flaresignal.discovery-semantics.v2","topics":["agent","research","trace","lineage","audit"],"assets":[],"domains":["agent"],"intents":["query","inspect"],"questions_answered":[],"not_suitable_for":["Do not use this capability to infer facts that are absent from its returned evidence or declared truth boundary."],"input_examples":[{}],"output_summary":"Structured Trace one agent research packet response with FlareSignal truth\/provenance metadata.","freshness_summary":"Uses the capability freshness policy: research_trace_cache.","provenance_summary":"Use the returned source authority, timestamps, source-health state, methodology and evidence references; missing evidence is never manufactured.","confidence_semantics":"Successful machine responses carry flaresignal.machine-assurance.v1. Confidence is a deterministic evidence-quality classification derived from canonicality, evidence quality, freshness, source health and relevant historical coverage; it is not a probability. Discovery ranking remains relevance only.","commercial":{"access_mode":"public","paid":false,"x402_bazaar_discoverable":false,"sample_available":true},"related_capabilities":[]},"responses":{"200":{"description":"Successful response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineResponse"}}}},"400":{"description":"Invalid machine request","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineError"}}}},"402":{"description":"x402 payment required where enabled"},"403":{"description":"Entitlement required"},"503":{"description":"Required source or payment provider unavailable"}},"parameters":[{"name":"research_id","in":"path","required":true,"schema":{"type":"string","pattern":"^fsrsh_[a-f0-9]{24}$"},"description":""}]}},"\/wp-json\/flaresignal\/v1\/machine\/agent\/session":{"post":{"operationId":"agent_session_create","summary":"Create delegated agent session","description":"Create a short-lived read-only agent session rooted in an existing FlareSignal API key. Requested scopes may only narrow the parent account authority.","tags":["agent","session","access","api"],"x-flaresignal-capability-id":"flaresignal.agent.session.create","x-flaresignal-capability-version":"1.0.0","x-flaresignal-lifecycle":{"state":"available","machine_contract_ready":true,"deprecated":false},"x-flaresignal-truth":{"canonicality":"canonical","source_authority":["flaresignal_registry","entitlement_state"],"units":[],"freshness_policy":"session_state","methodology_id":"delegated-agent-session-control","methodology_version":"1.0","evidence_available":true,"source_health_required":false,"allow_stale_return":false},"x-flaresignal-assurance":{"schema_version":"flaresignal.machine-assurance.v1","version":"1.0.0","attached_to_success":true,"attached_to_errors":true,"confidence_semantics":"deterministic_evidence_quality_not_probability","historical_completeness":"requested_window_or_explicit_not_required"},"x-flaresignal-access":{"mode":"api_access","entitlement":"api_access","x402":{"enabled":false,"schemes":["exact"],"accepts":[],"bazaar_discoverable":false,"payment_identifier_required":true,"signed_offer_receipt":true}},"x-flaresignal-audit":{"schema_version":"flaresignal.machine-audit.v1","state":"active","response_hash":{"algorithm":"sha256","canonicalization":"flaresignal-json-c14n-v1"},"client_identity":"when_available","source_health_snapshot":true,"evidence_references":true,"entitlement_linkage":true,"payment_linkage":true},"x-flaresignal-mcp":true,"x-flaresignal-discovery-semantics":{"schema_version":"flaresignal.discovery-semantics.v2","topics":["agent","session","access","api"],"assets":[],"domains":["agent"],"intents":["query","inspect"],"questions_answered":[],"not_suitable_for":["Do not use this capability to infer facts that are absent from its returned evidence or declared truth boundary."],"input_examples":[{}],"output_summary":"Structured Create delegated agent session response with FlareSignal truth\/provenance metadata.","freshness_summary":"Uses the capability freshness policy: session_state.","provenance_summary":"Use the returned source authority, timestamps, source-health state, methodology and evidence references; missing evidence is never manufactured.","confidence_semantics":"Successful machine responses carry flaresignal.machine-assurance.v1. Confidence is a deterministic evidence-quality classification derived from canonicality, evidence quality, freshness, source health and relevant historical coverage; it is not a probability. Discovery ranking remains relevance only.","commercial":{"access_mode":"api_access","paid":false,"x402_bazaar_discoverable":false,"sample_available":false},"related_capabilities":[]},"responses":{"200":{"description":"Successful response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineResponse"}}}},"400":{"description":"Invalid machine request","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineError"}}}},"402":{"description":"x402 payment required where enabled"},"403":{"description":"Entitlement required"},"503":{"description":"Required source or payment provider unavailable"},"201":{"description":"Created","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MachineResponse"}}}}},"requestBody":{"required":false,"content":{"application\/json":{"schema":{"type":"object","properties":{"scope_profile":{"type":"string","enum":["research_read","all_entitled_read"]},"scopes":{"description":"Optional permanent capability IDs. Supply a comma-separated string or JSON array. Every requested capability must be delegable and currently entitled.","oneOf":[{"type":"string"},{"type":"array","items":{"type":"string","pattern":"^flaresignal\\.[a-z0-9._-]+$"}}]},"ttl_seconds":{"type":"integer","minimum":300,"maximum":3600},"label":{"type":"string","maxLength":80}}}}}}},"get":{"operationId":"agent_session_get","summary":"Inspect delegated agent s

# --- truncated at 32 KB (402 KB total) ---
# Full source: https://artifacts.apis.io/flaresignal-io/openapi/flaresignal-io-openapi.json