{"schema_version":"1.0","service":"InfraPulse","primary_url":"https://infrapulse.ai","description":"InfraPulse lets anyone give AI agents a prepaid budget, a task policy, provider preferences, and a receipt requirement — whether it is a personal assistant, a creator workflow, a small business automation, a startup system, or an enterprise deployment.","ai_discovery_beacon":"INFRAPULSE_AI_DISCOVERY_BEACON_402_PREPAID_AGENT_COMMERCE_RECEIPT_VERIFICATION","canonical_protocol":"https://infrapulse.ai/.well-known/infrapulse-protocol.json","canonical_flow_summary":"discovery → quote → authorize → execute → receipt → verify","sandbox_policy":"Sandbox routes are simulated, rate-limited, no-payment, no-real-funds, and no-paid-upstream unless explicitly stated otherwise.","ai_client_safety":"AI clients may freely GET/HEAD public discovery endpoints. AI clients must not POST to paid production execution, funding, registry, private repository, or ledger routes unless explicitly authorized by the user or backed by a valid prepaid budget.","endpoint_roles":{"/.well-known/infrapulse-protocol.json":"canonical protocol overview","/.well-known/capabilities":"machine capability index","/.well-known/pricing":"pricing and 402 payment guidance file","/.well-known/agent.json":"InfraPulse identity and agent manifest","/.well-known/jwks.json":"public verification keys","/.well-known/receipt-beacon.json":"receipt verification discovery","/.well-known/agent-passport.json":"agent passport capability discovery + request/response schema","/.well-known/infrapulse-ai-test.json":"safe test instructions only — simulated, no real payment"},"supported_user_tiers":["personal","creator","freelancer","small_business","local_business","startup","team","enterprise","government","custom"],"supported_sectors":["personal_ai","personal_productivity","creator","freelancer","local_business","small_business","startup","ecommerce","customer_support","marketing","sales","bookkeeping","operations","field_services","home_services","professional_services","finance","healthcare","insurance","banking","asset_management","cloud_compute","ai_compute","data_center","energy","logistics","industrial","manufacturing","cybersecurity","legal","government","research","education","retail","telecom","agriculture","real_estate","media","general_enterprise","custom"],"supported_work_types":["task_automation","personal_assistant","document_summary","email_assistance","calendar_assistance","research_assistance","content_generation","content_planning","social_media_workflow","customer_support_automation","quote_generation","invoice_assistance","bookkeeping_assistance","inventory_check","lead_research","sales_followup","marketing_analysis","website_analysis","local_seo_analysis","data_entry","report_generation","analysis","risk_analysis","compliance_review","model_evaluation","data_transformation","compute_execution","smart_routing","cost_estimation","audit_generation","simulation","monitoring","workflow_orchestration","cross_sector_report","receipt_verification","test_execution","custom"],"supported_compliance_profiles":["simple_receipt","budget_only","standard","privacy_basic","no_sensitive_data_storage","audit_required","privacy_restricted","enterprise_controlled","regulated_finance","regulated_healthcare","government_sensitive","cross_sector_enterprise","custom"],"capabilities":{"machine_discovery":{"free":true,"approval_class":"PUBLIC_READ"},"machine_intent_processing":{"free":true,"approval_class":"PUBLIC_READ"},"prepaid_authorization":{"free":false,"approval_class":"PREPAID_AUTONOMOUS"},"signed_receipts":{"free":false,"approval_class":"PREPAID_AUTONOMOUS"},"receipt_verification":{"free":true,"approval_class":"PUBLIC_READ"},"agent_passport":{"free":"discovery manifest free; passport inspection billable","approval_class":"PREPAID_AUTONOMOUS","description":"Paid, machine-readable, signed trust/access/payment passport for a target (website, API, MCP server, company, tool, provider, service, or domain). Reports whether the target is discoverable, usable, payable, crawlable, and (never certified) safe for machine interaction. Unconfirmable signals are reported as 'unknown'.","discovery":"https://infrapulse.ai/.well-known/agent-passport.json","endpoints":["POST /v1/passports/inspect","GET /v1/passports/{passport_id}","GET /v1/receipts/{receipt_id}/verify"],"receipt_required":true},"provider_neutral_offer_recording":{"free":true,"approval_class":"PUBLIC_READ"},"quote_intent_routing":{"free":true,"approval_class":"PUBLIC_READ"},"gap_reporting":{"free":true,"approval_class":"PUBLIC_READ"},"telemetry_ingest":{"free":"first 100/day","approval_class":"PUBLIC_READ"},"universal_usage_metering":{"free":false,"approval_class":"PREPAID_AUTONOMOUS"},"infrapulse_mesh":{"free":false,"approval_class":"PREPAID_AUTONOMOUS"},"agent_authorization_gateway":{"free":false,"approval_class":"PREPAID_AUTONOMOUS"},"mcp_compatible_tooling":{"free":true,"approval_class":"PUBLIC_READ"},"a2a_compatible_agent_card":{"free":true,"approval_class":"PUBLIC_READ"},"openapi_compatible_api":{"free":true,"approval_class":"PUBLIC_READ"},"machine_agreements":{"free":"propose, counter, accept, reject, list, get — free; verify and complete — billable","approval_class":"PREPAID_AUTONOMOUS","description":"Machine-to-machine paid, barter, and hybrid agreement coordination. AI agents, compute providers, data clouds, and autonomous services can propose, negotiate, accept, verify, and complete agreements. InfraPulse coordinates terms, records proposals and acceptances, verifies machine-readable evidence, issues signed receipts, and charges coordination or receipt fees while remaining non-custodial.","discovery":"https://infrapulse.ai/.well-known/agreements","supports":["paid_agreements","barter_agreements","hybrid_agreements","counteroffers","agreement_matching","signed_receipts","coordination_fees","verification_fees"],"billing_model":"free_negotiation_billable_verify_and_complete","receipt_required":true,"legal_posture":"InfraPulse is non-custodial. It does not hold funds, guarantee outcomes, or act as a legal arbitrator. Any money movement happens through external rails. Any barter performance happens between the participating machines."},"machine_service_exchange":{"free":"discovery and listing free","approval_class":"PREPAID_AUTONOMOUS","description":"Enables AI agents, machines, humans, businesses, and providers to exchange compute, data, tools, workflows, model inference, storage, bandwidth, testing, API calls, telemetry, compliance artifacts, and verified outputs using prepaid credits, direct payment, custom payment, optional USDC/non-custodial rails, or governed barter. InfraPulse handles discovery, matching, quote, policy checks, contracts, metering, receipts, verification, and platform fees.","discovery":"https://infrapulse.ai/v1/exchange","supports":["service_offers","service_requests","machine_intents","barter_contracts","resource_credits","credit_payment","custom_payment","non_custodial_settlement_instructions","metered_delivery","policy_checks","signed_receipts","platform_fees","verification_fees"],"billing_model":"platform_fee_plus_optional_metered_usage","receipt_required":true,"legal_posture":"InfraPulse coordinates, meters, verifies, and issues receipts; it does not custody funds or guarantee outcomes."},"prepaid_economic_control":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","description":"Funds-before-work. Deterministic 402 on insufficient balance."},"human_dashboard":{"free":true,"approval_class":"HUMAN_ONLY","description":"Human supervisory dashboard — connected agents, keys, limits, pausing, key rotation.","url":"https://infrapulse.ai/human/dashboard"},"human_connect_ai":{"free":true,"approval_class":"PUBLIC_READ","description":"Safe onboarding page for connecting an AI assistant to InfraPulse. Provides read-only-first prompts.","url":"https://infrapulse.ai/human/connect-ai"},"agent_onboarding":{"free":true,"approval_class":"PUBLIC_READ","description":"Autonomous AI agent onboarding — register an agent, issue a scoped API token, fetch per-agent quote→authorize→execute→verify instructions, and run a sandbox readiness check.","url":"https://infrapulse.ai/v1/onboarding/agent/start","endpoints":["GET  /v1/onboarding/agent/start","POST /v1/onboarding/agent/register","GET  /v1/onboarding/agent/status/{agent_id}","POST /v1/onboarding/agent/auth/token","GET  /v1/onboarding/agent/instructions/{agent_id}","POST /v1/onboarding/agent/readiness-check"]},"human_repository_memory":{"free":true,"approval_class":"HUMAN_ONLY","description":"Private repository and memory management. Human controls which agents may read, write, or are blocked.","url":"https://infrapulse.ai/human/repository"},"human_provider_discovery":{"free":true,"approval_class":"PUBLIC_READ","description":"Human-readable view of available AI services, agents, tools, compute, data, and verification providers.","url":"https://infrapulse.ai/human/discover"},"human_offer_review":{"free":true,"approval_class":"HUMAN_ONLY","description":"Human review of incoming/outgoing offers, barter proposals, and service terms. Accept/reject/edit.","url":"https://infrapulse.ai/human/offers"},"human_agreement_management":{"free":true,"approval_class":"HUMAN_ONLY","description":"Manage agreements between AI agents and providers — approve, pause, cancel, view receipts.","url":"https://infrapulse.ai/human/agreements"},"human_approval_workflow":{"free":true,"approval_class":"HUMAN_ONLY","description":"Approve, deny, or edit pending AI actions before credits are spent. Every decision creates an audit event.","url":"https://infrapulse.ai/human/approvals"},"human_receipt_verification":{"free":true,"approval_class":"PUBLIC_READ","description":"View and verify Ed25519-signed receipts for all paid actions.","url":"https://infrapulse.ai/human/receipts"},"human_spending_controls":{"free":true,"approval_class":"HUMAN_ONLY","description":"Daily limits, per-action limits, approval thresholds, allowed/blocked endpoints.","url":"https://infrapulse.ai/human/settings"},"human_permission_controls":{"free":true,"approval_class":"HUMAN_ONLY","description":"Allowed/blocked agents, providers, endpoints. Repository access defaults. Receipt policy.","url":"https://infrapulse.ai/human/settings"},"human_ai_history":{"free":true,"approval_class":"HUMAN_ONLY","description":"Permission-gated AI-readable endpoint. Humans authorise their AI to read InfraPulse activity history, receipts, repository access, and provider interactions.","url":"https://infrapulse.ai/human/my-ai-history","api":"https://infrapulse.ai/v1/human/my-ai-history","summary_api":"https://infrapulse.ai/v1/human/summary","requires_api_key":true},"human_audit_events":{"free":true,"approval_class":"HUMAN_ONLY","description":"Full human audit log — every important AI action, with event_type, credits_spent, status, and receipt link.","url":"https://infrapulse.ai/human/audit","api":"https://infrapulse.ai/v1/human/audit","requires_api_key":true},"ai_readable_activity_summary":{"free":true,"approval_class":"HUMAN_ONLY","description":"Machine-readable account summary AI assistants can fetch to explain InfraPulse activity to the human owner.","api":"https://infrapulse.ai/v1/human/summary","fields":["human_account","connected_agents","credit_summary","recent_activity","pending_review","recent_receipts","repository_access","provider_interactions","warnings","recommended_next_actions"],"unauthenticated":"returns safe empty/demo state only"},"receipt_history":{"free":true,"approval_class":"HUMAN_ONLY","description":"List of signed receipts for paid actions, accessible by authenticated human accounts.","url":"https://infrapulse.ai/human/receipts","api":"https://infrapulse.ai/v1/human/receipts","verify_api":"https://infrapulse.ai/v1/receipt/verify"},"repository_access_history":{"free":true,"approval_class":"HUMAN_ONLY","description":"Log of repository entries accessed by connected AI agents.","url":"https://infrapulse.ai/human/repository-access","api":"https://infrapulse.ai/v1/human/repository-access"},"provider_interaction_history":{"free":true,"approval_class":"HUMAN_ONLY","description":"Log of external provider interactions by connected AI agents.","url":"https://infrapulse.ai/human/provider-interactions","api":"https://infrapulse.ai/v1/human/provider-interactions"},"pending_review":{"free":true,"approval_class":"HUMAN_ONLY","description":"Consolidated list of items requiring human review: pending approvals, failed executions, suspicious activity, spend-limit warnings.","url":"https://infrapulse.ai/human/pending-review","api":"https://infrapulse.ai/v1/human/pending-review"},"permission_gated_history_access":{"free":true,"approval_class":"HUMAN_ONLY","description":"Each history category is gated by a human_ai_permissions row the human controls. AI assistants must be explicitly granted read access by the human owner.","permission_fields":["can_read_activity","can_read_receipts","can_read_repository_logs","can_read_provider_interactions","can_read_pending_approvals","can_read_offers","can_read_agreements","can_read_settings","can_request_quotes","can_execute_paid_work","can_accept_offers","can_modify_repository","can_modify_settings","require_human_approval_for_paid_work"],"settings_url":"https://infrapulse.ai/human/settings"},"public_ai_entry_mode":{"free":true,"approval_class":"PUBLIC_READ","description":"Any AI assistant can read public InfraPulse discovery endpoints without a human account or API key.","onboarding":"https://infrapulse.ai/v1/public/onboarding","discover":"https://infrapulse.ai/v1/public/discover","human_page":"https://infrapulse.ai/human/use-from-your-ai"},"unauthenticated_public_discovery":{"free":true,"approval_class":"PUBLIC_READ","description":"Public capability, pricing, provider, service, offer, example, and sandbox discovery — no account required.","endpoints":["https://infrapulse.ai/v1/public/onboarding","https://infrapulse.ai/v1/public/discover","https://infrapulse.ai/v1/public/providers","https://infrapulse.ai/v1/public/services","https://infrapulse.ai/v1/public/offers","https://infrapulse.ai/v1/public/examples","https://infrapulse.ai/v1/public/sandbox"]},"public_provider_registry":{"free":true,"approval_class":"PUBLIC_READ","description":"Public registry of providers who have registered with InfraPulse.","api":"https://infrapulse.ai/v1/public/providers","full_registry":"https://infrapulse.ai/v1/registry/agents"},"public_service_discovery":{"free":true,"approval_class":"PUBLIC_READ","description":"Public listings of services, offers, and exchange items available on InfraPulse.","api":"https://infrapulse.ai/v1/public/services"},"public_onboarding":{"free":true,"approval_class":"PUBLIC_READ","description":"Structured onboarding guide for AI assistants entering InfraPulse in public mode.","api":"https://infrapulse.ai/v1/public/onboarding","human_page":"https://infrapulse.ai/human/use-from-your-ai"},"private_access_requires_auth":{"free":false,"approval_class":"AUTHENTICATED","description":"Private activity history, private repository/memory, private receipts, credit balance, pending approvals, and paid execution all require an API key or signed dashboard token.","authentication_required_for":["private_activity_history","private_repository_or_memory","private_receipts","credit_balance","pending_approvals","human_settings","paid_execution","agreement_approval"]},"paid_execution_requires_prepaid_credits":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","description":"All paid execution requires prepaid credits and authorization. Insufficient balance returns HTTP 402 with funding instructions.","buy_credits":"https://infrapulse.ai/buy","pricing":"https://infrapulse.ai/.well-known/pricing"},"human_approval_supported":{"free":true,"approval_class":"HUMAN_ONLY","description":"Humans can require explicit approval before any paid AI action. AI assistants must stop and ask before spending credits, accepting offers, or modifying settings.","approvals_page":"https://infrapulse.ai/human/approvals","settings_page":"https://infrapulse.ai/human/settings"},"agent_identity":{"free":"registration free","approval_class":"PUBLIC_READ","discovery":"https://infrapulse.ai/v1/identity/machine"},"machine_registry":{"free":true,"approval_class":"PUBLIC_READ","discovery":"https://infrapulse.ai/v1/registry/agents"},"repository":{"free":"search and browse free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/repository/items","description":"Publish, search, verify, fork, and download reusable machine resources."},"marketplace":{"free":"browse free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/marketplace/listings","description":"Buy/sell machine capabilities — workflows, datasets, compute, model access."},"intent_exchange":{"free":true,"approval_class":"PUBLIC_READ","discovery":"https://infrapulse.ai/v1/intents","description":"Post needs, receive bids, accept providers via machine intent exchange."},"compute_routing":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/routes/compute"},"model_routing":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/routes/model"},"data_routing":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/routes/data"},"tool_routing":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/routes/tool"},"workflow_orchestration":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/orchestrations/create"},"mcp_gateway":{"free":true,"approval_class":"PUBLIC_READ"},"data_operations":{"free":"hash free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/data-ops","operations":["ingest","classify","clean","embed","summarize","translate","redact","hash","transform"]},"memory":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/memory/search"},"memory_os":{"available":true,"free":"public discovery and examples free","approval_class":"PREPAID_AUTONOMOUS","description":"Public and private durable memory for autonomous AI agents.","discovery_url":"https://infrapulse.ai/.well-known/memory.json","public_search":"https://infrapulse.ai/v1/memory/public/search","private_write":"https://infrapulse.ai/v1/memory/private/write","private_search":"https://infrapulse.ai/v1/memory/private/search","requires_authorization_for_private_actions":true,"receipt_types":["memory.write","memory.search","memory.update","memory.delete","memory.export"],"identity_continuity":"agent_id survives restarts, zero-credit states, and provider changes"},"repository_os":{"available":true,"free":"public examples free","approval_class":"PREPAID_AUTONOMOUS","description":"Public and private repository context for AI agents.","discovery_url":"https://infrapulse.ai/.well-known/repository.json","public_search":"https://infrapulse.ai/v1/repository/public/search","context_build_url":"https://infrapulse.ai/v1/context/build","requires_authorization_for_private_actions":true,"receipt_types":["repository.ingest","repository.search","repository.summarize","context.build"]},"skills_os":{"available":true,"free":"public skill discovery and examples free","approval_class":"PREPAID_AUTONOMOUS","description":"Reusable public and private skills for AI agents.","discovery_url":"https://infrapulse.ai/.well-known/skills.json","public_search":"https://infrapulse.ai/v1/skills/public/search","private_execute":"https://infrapulse.ai/v1/skills/execute","receipt_types":["skill.publish","skill.search","skill.execute","skill.verify"],"reliability_disclaimer":"liability_mode: metadata_only_not_recommendation"},"knowledge_packs":{"free":"browse free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/knowledge/packs"},"policy_engine":{"free":"evaluate free","approval_class":"PUBLIC_READ","discovery":"https://infrapulse.ai/v1/policies/evaluate"},"permission_broker":{"free":"check free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/permissions/check"},"receipt_archive":{"free":"browse free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/receipts"},"evaluation":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/evaluations/run"},"benchmarking":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/benchmarks/run"},"e2e_testing":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/tests/e2e"},"telemetry":{"free":"ingest free","approval_class":"PUBLIC_READ","discovery":"https://infrapulse.ai/v1/telemetry/summary"},"tco_optimization":{"free":"report browse free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/tco/report"},"machine_contracts":{"free":"create free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/contracts/create","types":["agent_to_agent_contract","data_use_contract","compute_job_contract","workflow_contract","service_level_agreement","budget_contract"]},"deterministic_verdicts":{"free":"evaluate free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/verdicts/evaluate"},"agent_coordination":{"free":"rooms and tasks free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/coordination/rooms"},"compliance_exports":{"free":"browse free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/compliance/audit-export"},"api_gateway":{"free":"discover free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/gateway/services"},"sandbox_execution":{"free":false,"approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/sandboxes/create"},"simulation":{"free":true,"approval_class":"PUBLIC_READ","discovery":"https://infrapulse.ai/v1/simulate/cost"},"agent_app_store":{"free":"browse free","approval_class":"PREPAID_AUTONOMOUS","discovery":"https://infrapulse.ai/v1/app-store/agents"},"personal_ai_budget_control":{"id":"personal_ai_budget_control","name":"Personal AI budget control","description":"Personal AI agents can run with prepaid budgets, task policies, provider preferences, and signed receipts. Supports personal assistants, research, document summaries, content, scheduling, and automations.","supported_user_tiers":["personal","creator","freelancer"],"prepaid_enforced":true,"receipt_backed":true,"free":false,"approval_class":"PREPAID_AUTONOMOUS"},"small_business_ai_automation":{"id":"small_business_ai_automation","name":"Small business AI automation","description":"Small businesses can use prepaid AI agents for customer support, marketing, sales, bookkeeping, scheduling, reporting, and operations.","supported_user_tiers":["small_business","local_business","startup","team"],"prepaid_enforced":true,"receipt_backed":true,"free":false,"approval_class":"PREPAID_AUTONOMOUS"},"sector_aware_execution":{"id":"sector_aware_execution","name":"Sector-aware AI work execution","description":"Agents can declare user tier, sector, work type, compliance profile, provider preferences, budget limits, and data boundaries before prepaid execution. Works for personal, creator, small business, startup, enterprise, and cross-sector workflows.","supports_cross_sector":true,"supported_user_tiers":["personal","creator","freelancer","small_business","local_business","startup","team","enterprise","government","custom"],"supported_sectors":["personal_ai","personal_productivity","creator","freelancer","local_business","small_business","startup","ecommerce","customer_support","marketing","sales","bookkeeping","operations","field_services","home_services","professional_services","finance","healthcare","insurance","banking","asset_management","cloud_compute","ai_compute","data_center","energy","logistics","industrial","manufacturing","cybersecurity","legal","government","research","education","retail","telecom","agriculture","real_estate","media","general_enterprise","custom"],"supported_work_types":["task_automation","personal_assistant","document_summary","email_assistance","calendar_assistance","research_assistance","content_generation","content_planning","social_media_workflow","customer_support_automation","quote_generation","invoice_assistance","bookkeeping_assistance","inventory_check","lead_research","sales_followup","marketing_analysis","website_analysis","local_seo_analysis","data_entry","report_generation","analysis","risk_analysis","compliance_review","model_evaluation","data_transformation","compute_execution","smart_routing","cost_estimation","audit_generation","simulation","monitoring","workflow_orchestration","cross_sector_report","receipt_verification","test_execution","custom"],"supported_compliance_profiles":["simple_receipt","budget_only","standard","privacy_basic","no_sensitive_data_storage","audit_required","privacy_restricted","enterprise_controlled","regulated_finance","regulated_healthcare","government_sensitive","cross_sector_enterprise","custom"],"prepaid_enforced":true,"receipt_fields":["user_tier","sector","sectors","work_type","compliance_profile","policy_profile","budget_limit_credits","providers_allowed","data_boundaries_hash","execution_constraints_hash","cross_sector"],"free":"sector_metadata_declaration","approval_class":"PREPAID_AUTONOMOUS"},"token_efficient_agent_execution":{"free":"estimation and routing","approval_class":"PREPAID_AUTONOMOUS","description":"Prepaid authorization, context compression, semantic caching, model routing, and signed receipts for token-efficient autonomous agent workflows.","supports":["compiled_context_artifacts","semantic_cache_metering","prompt_prefix_cache_optimizer","tool_schema_minification","intent_based_tool_routing","language_aware_context_compression","code_symbol_map","repo_context_budgeter","verifiable_summary_receipts","agent_knowledge_graph","machine_event_graph","delta_context","state_diff_receipts","llm_call_avoidance_planner","model_cost_router","machine_minified_outputs","token_usage_oracle","kv_cache_friendly_artifacts"],"billing_model":"prepaid_credits","receipt_model":"signed_cost_savings_receipts","failure_mode":"402_payment_required_before_unpaid_compute","discovery":"https://infrapulse.ai/.well-known/token-efficiency.json"},"repository_registry":{"id":"repository_registry","name":"InfraPulse Repository","description":"A prepaid, receipt-backed repository where AI agents and machine clients discover, purchase, verify, and reuse compute, data, cloud services, APIs, contracts, proofs, and reusable agent work products across 23 sectors.","free":"basic_search","approval_class":"PREPAID_AUTONOMOUS","billing_model":"prepaid_credits","receipt_supported":true,"idempotency_required":true,"supported_categories":["compute","cloud","storage","bandwidth","apis","datasets","telemetry_feed","model_endpoint","agent_service","compliance_report","code_patch","evaluation","audit","market_research","finance_data","healthcare_metadata","legal_summary","energy_data","small_business_automation","personal_ai","machine_contract","proof_bundle"],"discovery":"https://infrapulse.ai/.well-known/repository.json","endpoints":{"search":"https://infrapulse.ai/v1/repository/search","listings":"https://infrapulse.ai/v1/repository/listings","access":"https://infrapulse.ai/v1/repository/access"}},"private_ai_memory_repository":{"id":"private_ai_memory_repository","name":"Private AI Memory Repository","description":"Private, scoped, receipt-backed memory and reusable work repository for AI agents, organizations, and machine clients. Durable across restarts.","free":"discovery, export, and limited metadata reads","approval_class":"PREPAID_SCOPED_PRIVATE","billing_model":"prepaid_credits","visibility":"private","requires_auth":true,"requires_prepaid_authorization":true,"stores_raw_secrets":false,"receipt_backed":true,"zero_credit_safe":true,"durable_across_restarts":true,"discovery_url":"https://infrapulse.ai/.well-known/private-repository.json","memory_url":"https://infrapulse.ai/.well-known/ai-memory.json","endpoints":{"create":"https://infrapulse.ai/v1/private-repositories","search":"https://infrapulse.ai/v1/private-repositories/{repo_id}/search","memory_context":"https://infrapulse.ai/v1/private-repositories/{repo_id}/memory-context","export":"https://infrapulse.ai/v1/private-repositories/{repo_id}/export","restore":"https://infrapulse.ai/v1/private-repositories/{repo_id}/items/{item_id}/restore","purge":"https://infrapulse.ai/v1/private-repositories/{repo_id}/items/{item_id}/purge"},"files":{"description":"Paid file embedding + governed retrieval — every action produces an HMAC-signed receipt and emits repo.* events to subscribed webhooks. Gated by per-agent autonomy policy + credit velocity breakers.","human_url":"https://infrapulse.ai/human/memory-repository","endpoints":{"upload":"https://infrapulse.ai/v1/repository/files/upload","embed":"https://infrapulse.ai/v1/repository/files/embed","index":"https://infrapulse.ai/v1/repository/files/index","search":"https://infrapulse.ai/v1/repository/files/search","retrieve":"https://infrapulse.ai/v1/repository/files/retrieve","receipt":"https://infrapulse.ai/v1/repository/files/receipt","audit":"https://infrapulse.ai/v1/repository/files/audit","permissions":"https://infrapulse.ai/v1/repository/files/permissions","versions":"https://infrapulse.ai/v1/repository/files/versions"},"events":["repo.file.uploaded","repo.file.embedded","repo.file.indexed","repo.file.retrieved","repo.file.searched","repo.file.deleted","repo.permission.granted","repo.permission.revoked","repo.policy.blocked","repo.velocity.blocked"],"spec_shape_endpoints":{"create":"https://infrapulse.ai/v1/repository","list":"https://infrapulse.ai/v1/repository","get":"https://infrapulse.ai/v1/repository/{repository_id}","upload":"https://infrapulse.ai/v1/repository/{repository_id}/files","list_files":"https://infrapulse.ai/v1/repository/{repository_id}/files","embed":"https://infrapulse.ai/v1/repository/{repository_id}/embed","retrieve":"https://infrapulse.ai/v1/repository/{repository_id}/retrieve","access_log":"https://infrapulse.ai/v1/repository/{repository_id}/access-log","delete_file":"https://infrapulse.ai/v1/repository/{repository_id}/files/{file_id}"},"owner_types_supported":["workspace","company","human","agent","provider","user","org"],"memory_architecture":{"description":"Four-tier memory model: working memory for active task context, episodic memory for ingested files + retrievals tied to a moment in time, semantic memory for embedded chunks indexed for governed retrieval, and an immutable audit trail of every ingestion/embed/retrieve/permission/delete event.","tiers":{"working":{"purpose":"Short-lived task context held by an agent during execution.","durable":false,"billable":false,"evidence":"Surfaces in receipts via repository_id + agent_id pairing."},"episodic":{"purpose":"Time-stamped record of file uploads, retrievals, and deletions.","durable":true,"billable":true,"evidence":"RepositoryFileAudit rows + signed event receipts.","endpoints":["https://infrapulse.ai/v1/repository/{repository_id}/access-log","https://infrapulse.ai/v1/repository/files/audit"]},"semantic":{"purpose":"Chunked + embedded knowledge available for governed retrieval.","durable":true,"billable":true,"evidence":"RepositoryFileChunk rows + retrieval receipts.","endpoints":["https://infrapulse.ai/v1/repository/{repository_id}/embed","https://infrapulse.ai/v1/repository/{repository_id}/retrieve"]},"audit":{"purpose":"Immutable, signed trail of every billable + permission event.","durable":true,"billable":false,"tamper_evident":true,"evidence":"HMAC-signed receipts + JWKS-verifiable Ed25519 signatures.","endpoints":["https://infrapulse.ai/v1/repository/{repository_id}/access-log","https://infrapulse.ai/v1/repository/files/receipt"]}},"right_to_forget":{"supported":true,"endpoint":"https://infrapulse.ai/v1/repository/{repository_id}/files/{file_id}","method":"DELETE","produces":"signed repository_file_deleted receipt + repo.file.deleted event"}}},"deletion_policy":"Owners may export, soft-delete, or permanently purge private memory. Signed receipts retain only minimal hashes and billing metadata for audit integrity."},"receipt_audit_skill":{"id":"receipt_audit_skill","name":"Receipt Audit Skill — Programmable Signed Receipts","version":"1.0","available":true,"description":"AI agents can generate Ed25519 + HMAC-SHA256 signed receipts for any action: workflow steps, simulations, policy checks, repository writes, paid API calls, and arbitrary custom events. Every receipt is stored for audit retrieval and can be verified offline via JWKS.","free":"capability descriptor, fetch, list, verify","approval_class":"PREPAID_AUTONOMOUS","billing_model":"prepaid_credits","cost_per_receipt_credits":1,"cost_per_receipt_usd":0.01,"receipt_backed":true,"idempotency_required":true,"flow":"discover → quote → authorize → POST /v1/receipts/create → verify","discovery_url":"https://infrapulse.ai/v1/receipt-audit/capability","endpoints":{"capability":"https://infrapulse.ai/v1/receipt-audit/capability","create":"https://infrapulse.ai/v1/receipts/create","fetch":"https://infrapulse.ai/v1/receipts/{receipt_id}","list":"https://infrapulse.ai/v1/agents/{agent_id}/receipts","verify":"https://infrapulse.ai/v1/receipt/verify","jwks":"https://infrapulse.ai/.well-known/jwks.json"},"signing":{"algorithms":["HMAC-SHA256","EdDSA"],"key_set_url":"https://infrapulse.ai/.well-known/jwks.json","offline_verify":true},"supported_event_types":["workflow.step","workflow.complete","policy.check","api.call","simulation.run","repository.write","agent.action","agent.decision","compute.job","model.inference","data.transform","custom"]},"programmable_signed_receipts":{"id":"programmable_signed_receipts","name":"Programmable Signed Receipts","available":true,"description":"Any billable route, workflow step, policy check, simulation, or custom event can be wrapped in a prepaid signed receipt. Receipts include HMAC-SHA256 and Ed25519 signatures, are stored server-side, and are verifiable offline using InfraPulse public JWKS. Receipts support three visibility levels — public, private, and confidential — to protect sensitive workflow details, private memory, business records, and customer data.","supports_visibility":["public","private","confidential"],"public_verification_for_private_receipts":true,"private_metadata_redaction":true,"hash_based_evidence":true,"encrypted_metadata_supported":true,"owner_authenticated_fetch":true,"delete_or_retention_policy_supported":true,"free":"verification and discovery","approval_class":"PREPAID_AUTONOMOUS","billing_model":"prepaid_credits","receipt_skill_url":"https://infrapulse.ai/v1/receipt-audit/capability","verify_url":"https://infrapulse.ai/v1/receipt/verify","jwks_url":"https://infrapulse.ai/.well-known/jwks.json","beacon_url":"https://infrapulse.ai/.well-known/receipt-beacon.json"}},"approval_classes":{"PUBLIC_READ":"autonomous, free, cacheable","PREPAID_AUTONOMOUS":"autonomous when prepaid credits balance is sufficient","PREPAID_SCOPED_PRIVATE":"autonomous within a private scoped repository when prepaid credits are sufficient","HUMAN_APPROVAL_REQUIRED":"paused for explicit human approval before execution"},"quickstart":"https://infrapulse.ai/.well-known/quickstart.json","receipt_verify":"https://infrapulse.ai/v1/receipt/verify","workflow":["GET /.well-known/quickstart.json  →  autonomous agent quickstart guide","GET /.well-known/capabilities     →  read this document","GET /.well-known/pricing          →  inspect pricing and free tiers","GET /.well-known/agent.json       →  read the agent card","GET /v1/quote                     →  get a cost estimate (free)","GET /v1/buy                       →  fund prepaid credits","POST /v1/execute                  →  run a prepaid job (returns signed receipt)","POST /v1/receipt/verify           →  verify the signed receipt"],"openapi":"https://infrapulse.ai/openapi.json","pricing":"https://infrapulse.ai/.well-known/pricing","auth_requirements_url":"https://infrapulse.ai/v1/auth/requirements","enterprise_policy_discovery_url":"https://infrapulse.ai/v1/enterprise/policy/discovery","exchange_execute_url":"https://infrapulse.ai/v1/exchange/execute","swarm_signal_schema":{"submit_url":"https://infrapulse.ai/v1/swarm/signals","canonical_fields":["swarm_id","agent_id","signal_type","payload"],"accepted_aliases":["signal","type","data","body","from_agent_id","sender_agent_id","room_id","group_id"],"simulation_field":"simulation"},"enterprise_policy_url":"https://infrapulse.ai/v1/enterprise/policy","resource_exchange_job_normalization":true,"resource_exchange_simulation":true,"enterprise_policy_post":true,"enterprise_policy_simulation_validation":true,"resource_exchange_job_schema":{"submit_url":"https://infrapulse.ai/v1/resource-exchange/jobs","alias_url":"https://infrapulse.ai/v1/exchange/jobs","canonical_fields":["agent_id","provider_agent_id","resource_type","amount","unit","max_budget_usd_cents","settlement_mode","payload"],"accepted_aliases":["buyer_agent_id","requesting_agent_id","consumer_agent_id","seller_agent_id","offering_agent_id","provider_id","resource","type","service","work_type","task_type","quantity","units","duration_seconds","tokens","bytes","budget_usd_cents","max_price_usd_cents","price_limit_usd_cents","rail","payment_rail","payment_method","agreement_type","metadata","data","body"],"simulation_field":"simulation"},"supports_http_402":true,"supports_agentic_payment_flow":true,"non_custodial":true,"auth_discovery":true,"enterprise_policy_discovery":true,"simulation_mode":true,"exchange_execution_simulation":true,"swarm_signal_normalization":true,"policy_bound_autonomous_mode":{"available":true,"approval_class":"PREPAID_AUTONOMOUS","description":"Allows AI agents to operate autonomously inside valid prepaid policy envelopes with scoped routes, hard budget limits, signed receipts, audit logs, expiration, and revocation.","unrestricted_autonomy":false,"requires_policy_envelope":true,"requires_prepaid_funding":true,"requires_signed_receipts":true,"requires_audit_log":true,"requires_revocation":true,"policy_url":"/.well-known/autonomy-policy.json","check_url":"/v1/autonomy/check","mode_url":"/v1/autonomy/policy-bound"},"autonomy_policy_statement":"InfraPulse supports policy-bound autonomous AI execution, not unrestricted AI autonomy.","private_ai_memory_repository":{"id":"private_ai_memory_repository","name":"Private AI Memory Repository","description":"Private, scoped, receipt-backed memory and reusable work repository for AI agents, organizations, and machine clients. Durable across restarts.","discovery_url":"https://infrapulse.ai/.well-known/private-repository.json","memory_url":"https://infrapulse.ai/.well-known/ai-memory.json","create_url":"https://infrapulse.ai/v1/private-repositories","search_url_template":"https://infrapulse.ai/v1/private-repositories/{repo_id}/search","memory_context_url_template":"https://infrapulse.ai/v1/private-repositories/{repo_id}/memory-context","export_url_template":"https://infrapulse.ai/v1/private-repositories/{repo_id}/export","visibility":"private","free_mode":"Discovery, login, funding, export/delete, and limited metadata reads are free. Private storage, retrieval, large memory search, and execution may require prepaid authorization or an active storage plan.","approval_class":"PREPAID_SCOPED_PRIVATE","requires_auth":true,"requires_prepaid_authorization":true,"stores_raw_secrets":false,"receipt_backed":true,"zero_credit_safe":true,"durable_across_restarts":true,"deletion_policy":"Owners may export, soft-delete, or permanently purge private memory. Deleted content is excluded from AI memory, search, and execution. Signed receipts retain only minimal hashes and billing metadata for audit integrity."},"notices":["InfraPulse does not rank or recommend providers.","All paid routes enforce prepaid-only billing — no post-pay.","Use Idempotency-Key on all billable POSTs.","Sector metadata (user_tier, sector, work_type, compliance_profile) is free to declare.","This surface is compatible with all AI agents, crawlers, and machine clients.","See /v1/auth/requirements for auth requirements for private endpoints.","See /v1/enterprise/policy/discovery for enterprise policy capabilities."],"cloud_architecture":{"mode":"hosted_control_plane","product_name":"InfraPulse Cloud","description":"Always-on provider-neutral control plane for autonomous AI agents, tools, services, memory, monitoring, prepaid authorization, and signed receipts.","supports_cloud_hosted_agents":true,"supports_external_agents":true,"supports_customer_hosted_connectors":true,"supports_future_local_nodes":true,"supports_private_cloud_future":true,"control_plane_functions":["agent_identity","machine_readable_discovery","quote_authorize_execute_receipt_verify","prepaid_budget_enforcement","http_402_x402_compatible_authorization","signed_receipts","receipt_verification","memory_repository","file_embedding","custom_monitoring","marketplace_registry","audit_logs","human_approval_gates"],"workload_execution_locations":["infrapulse_cloud","external_cloud","customer_server","local_node_future","edge_node_future","compute_provider_future"],"non_custodial":true,"prepaid_only":true,"sandbox_first":true,"infrapulse_connector":{"status":"planned","description":"Lightweight connector that will run on a customer server, local machine, private cloud, or edge node while InfraPulse Cloud remains the trust, policy, receipt, and monitoring control plane.","planned_capabilities":["register_external_tools","receive_authorized_jobs","enforce_policy_locally","return_signed_execution_metadata","sync_receipts","export_telemetry","keep_sensitive_files_local"]}},"capability_features":{"custom_live_monitoring":{"enabled":true,"free":"list, get rules — free; create/update/event reads — billable","approval_class":"PREPAID_AUTONOMOUS","description":"Customer-defined monitoring rules for endpoints, agents, budgets, receipts, policy gates, memory freshness, and discovery events.","routes":["GET /v1/monitors","POST /v1/monitors","GET /v1/monitors/{monitor_id}","PATCH /v1/monitors/{monitor_id}","DELETE /v1/monitors/{monitor_id}","POST /v1/monitors/{monitor_id}/pause","POST /v1/monitors/{monitor_id}/resume","GET /v1/monitors/alerts","POST /v1/monitors/alerts/{alert_id}/acknowledge","GET /v1/monitors/events"]},"memory_repository":{"enabled":true,"free":"metadata read — free; ingest, embed, retrieve — billable","approval_class":"PREPAID_AUTONOMOUS","description":"Governed memory repositories and file embedding with metadata-first search, freshness/versioning, permission-gated retrieval, and signed ingestion/retrieval receipts.","routes":["POST /v1/repository/files/upload","POST /v1/repository/files/embed","POST /v1/repository/files/index","POST /v1/repository/files/retrieve","POST /v1/repository/files/search","POST /v1/repository/files/permissions","GET  /v1/repository/files/versions","GET  /v1/repository/files/audit","GET  /v1/repository/files/receipt","POST /v1/memory/private/write","POST /v1/memory/private/search","POST /v1/memory/private/update","POST /v1/memory/private/delete","POST /v1/memory/private/export","POST /v1/repository/ingest","POST /v1/repository/summarize"]},"ai_onboarding":{"enabled":true,"free":true,"approval_class":"PUBLIC_READ","description":"Read-only AI evaluator plan. Free discovery → sandbox test → optional human-approved paid test. Never debits credits on its own.","routes":["GET /v1/onboarding/ai","GET /v1/onboarding/ai/sandbox-plan","GET /v1/onboarding/ai/customer-plan"]},"instance_discovery":{"enabled":true,"free":true,"approval_class":"PUBLIC_READ","description":"Deployment posture of this InfraPulse instance — cloud, private cloud, Replit, on-prem, or dev.","routes":["GET /.well-known/infrapulse-instance.json","GET /v1/instance"]},"ai_discovery_analytics":{"enabled":true,"status":"live","description":"Tracks AI search, agent discovery, crawler traffic, sandbox tests, quote attempts, and machine-readable endpoint usage. IPs and User-Agents are stored only as HMAC-SHA256 digests keyed by API_KEY_PEPPER.","routes":["GET /v1/analytics/ai-discovery","GET /v1/analytics/ai-discovery/summary","GET /v1/analytics/ai-discovery/events","GET /v1/analytics/ai-discovery/export.jsonl","GET /v1/analytics/ai-discovery/export.csv","GET /v1/analytics/ai-discovery/feed","POST /v1/analytics/ai-discovery/classify"],"human_dashboard":"/analytics/ai-discovery","billing":"free","privacy":"ip_and_ua_hashed_only"},"machine_exports":{"enabled":true,"status":"live","formats":["json","jsonl","csv","webhook","feed"],"endpoints":["GET /v1/exports","GET /v1/exports/schemas","GET /v1/exports/feed","GET /v1/exports/events.jsonl","GET /v1/exports/events.csv","GET /v1/exports/receipts.jsonl","GET /v1/exports/monitoring.jsonl","GET /v1/exports/memory.jsonl","GET /v1/exports/discovery.jsonl","POST /v1/exports/webhooks","GET /v1/exports/webhooks","DELETE /v1/exports/webhooks/{id}","POST /v1/exports/webhooks/{id}/test","POST /v1/exports/webhooks/{id}/pause","POST /v1/exports/webhooks/{id}/resume","POST /v1/exports/test-webhook","POST /v1/exports/deliveries/{delivery_id}/retry","GET /v1/exports/deliveries","GET /v1/human/exports","GET /human/exports"],"event_kinds":["receipt","monitor_event","discovery_event","memory_event"],"webhook_signing":"HMAC-SHA256 via X-InfraPulse-Signature: sha256=<hex>","human_dashboard":"/exports","billing":"free","privacy":"api_key_hashed_only; webhook secret persisted server-side to keep signatures stable across restarts (Stripe-style), shown to owner once at creation; planned: encrypt-at-rest via service key — tracked in follow-up #109"},"agent_terminal":{"enabled":true,"status":"live","spec_section":"§6","mode":"read_only","description":"Governed read-only corpus workbench for exact-evidence inspection. shell=False, env={}, no-network namespace where available, 5s timeout, 64KB output cap, strict per-tool allow-list, every command produces a signed Ed25519 receipt.","default_allowed_commands":["ls","find","rg","grep","head","tail","cat","wc","stat","file"],"endpoints":{"descriptor":"/v1/terminal","open_session":"/v1/terminal/sessions","submit_command":"/v1/terminal/sessions/{id}/commands","list_events":"/v1/terminal/sessions/{id}/events","verify_receipt":"/v1/terminal/verify-receipt","human_dashboard":"/human/terminal"},"auth":"X-API-Key (HMAC fingerprint, raw key never persisted)","billing":"free","out_of_scope_v1":["write_mode","interactive_sessions","custom_user_commands","cross_repo_search"]},"receipt_categories":{"enabled":true,"status":"live","spec_section":"§10","schema_version":"2026-05-22","description":"Receipts Everywhere — every billable action and many free machine-readable actions emit an Ed25519-signed receipt with category metadata. Verifiable via the public JWKS.","categories":["payment","quote","authorization","execution","sandbox","ai_discovery","monitoring","memory_ingestion","memory_retrieval","terminal_command","export","policy_decision","denial"],"all_receipt_types":["quote","authorization","execution","payment","credit","listing","offer","agreement","repository.ingestion","repository.retrieval","repository.deletion","memory.update","monitor.alert","best_interest","due_diligence","live_exchange","webhook.delivery","machine.exchange","sandbox","ai_discovery","monitoring","memory_ingestion","memory_retrieval","terminal_command","export","policy_decision","denial"],"endpoints":{"issue":"/v1/receipts/issue","verify":"/v1/receipts/verify","resolve":"/.well-known/receipts/{receipt_id}.json","jwks":"/.well-known/jwks.json","status":"/v1/receipts/signing-status"},"billing":"free (verify, resolve, status); admin-gated (issue)","human_dashboard":"/human/receipts"},"human_control_room":{"enabled":true,"status":"live","spec_section":"§8","description":"Customer-facing /human/* control room pages — readable HTML with copyable API examples, receipt verify tool, sandbox links, Stripe credit purchase, and support contact.","pages":["/human","/human/dashboard","/human/buy","/human/agents","/human/providers","/human/receipts","/human/monitor","/human/memory","/human/exports","/human/settings","/human/help","/human/onboarding/ai","/human/terminal"],"support_contact":"support@infrapulse.ai","privacy":"/privacy"}},"deployment_modes":["cloud","private_cloud","replit","on_prem","dev"]}