patchr 0.1.0__py3-none-any.whl

apps/sandbox/__init__.py

@@ -0,0 +1 @@
+"""Picux sandbox applications."""

apps/sandbox/main.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+import argparse
+import json
+
+from picux.sandbox import MidnightArbitrageSandbox
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Run the Picux Midnight Arbitrage sandbox.")
+    parser.add_argument("--chaos", choices=["", "latency", "modelError", "unauthorizedSpend", "freeze"], default="")
+    parser.add_argument("--pretty", action="store_true", help="Pretty-print the sandbox trace.")
+    args = parser.parse_args()
+
+    result = MidnightArbitrageSandbox().run(chaos=args.chaos)
+    print(json.dumps(result, ensure_ascii=True, sort_keys=True, indent=2 if args.pretty else None))
+
+
+if __name__ == "__main__":
+    main()

apps/worker/__init__.py

@@ -0,0 +1,2 @@
+"""Picux worker application."""
+

apps/worker/main.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+import json
+
+from picux.core import PicuxRuntime
+
+
+def main() -> None:
+    runtime = PicuxRuntime(service="picux-worker")
+    runtime.assertBootable()
+    print(json.dumps(runtime.summary(), ensure_ascii=True, sort_keys=True))
+
+
+if __name__ == "__main__":
+    main()

apps/worker/verify.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+import json
+
+from picux.verification import RolloutVerifier
+
+
+def main() -> None:
+    report = RolloutVerifier().verify().toMap()
+    print(json.dumps(report, ensure_ascii=True, sort_keys=True))
+
+
+if __name__ == "__main__":
+    main()

patchr/__init__.py

@@ -0,0 +1,12 @@
+"""Patchr Python SDK."""
+
+from .sdk import ExternalAppClient, ExternalPricing, HttpTransport, InProcessTransport, PatchrApiError, PatchrClient
+
+__all__ = [
+    "ExternalAppClient",
+    "ExternalPricing",
+    "HttpTransport",
+    "InProcessTransport",
+    "PatchrApiError",
+    "PatchrClient",
+]

patchr/sdk/__init__.py

@@ -0,0 +1,20 @@
+"""Public Patchr SDK import surface."""
+
+from picux.sdk import ExternalAppClient, ExternalPricing, HttpTransport, InProcessTransport
+from picux.sdk.client import PicuxApiError, PicuxClient
+
+
+class PatchrClient(PicuxClient):
+    """Patchr-branded client for the hosted API, MCP, A2A, and workflow surfaces."""
+
+
+PatchrApiError = PicuxApiError
+
+__all__ = [
+    "ExternalAppClient",
+    "ExternalPricing",
+    "HttpTransport",
+    "InProcessTransport",
+    "PatchrApiError",
+    "PatchrClient",
+]

patchr/sdk/client.py

@@ -0,0 +1,12 @@
+"""Patchr SDK client aliases."""
+
+from . import ExternalAppClient, ExternalPricing, HttpTransport, InProcessTransport, PatchrApiError, PatchrClient
+
+__all__ = [
+    "ExternalAppClient",
+    "ExternalPricing",
+    "HttpTransport",
+    "InProcessTransport",
+    "PatchrApiError",
+    "PatchrClient",
+]

patchr-0.1.0.dist-info/METADATA

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: patchr
+Version: 0.1.0
+Summary: Patchr Protocol infrastructure for agentic orchestration and settlement.
+Author: Patchr Core Team
+License-Expression: Apache-2.0
+Keywords: patchr,sdk,mcp,a2a,workflow,agents
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: api
+Requires-Dist: fastapi>=0.111; extra == "api"
+Requires-Dist: uvicorn>=0.30; extra == "api"
+Provides-Extra: worker
+Requires-Dist: redis>=5.0; extra == "worker"
+Requires-Dist: rq>=1.16; extra == "worker"
+Provides-Extra: db
+Requires-Dist: psycopg[binary]>=3.2; extra == "db"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Dynamic: license-file
+
+# Patchr
+
+Patchr is the protocol infrastructure layer for agentic orchestration and settlement.
+External apps, services, and agents communicate with Patchr through the SDK, API contract, MCP, and A2A protocol surfaces.
+
+Current status: Phase 78 primitives. Patchr now has three flagship workflow templates, citeable proof cards, first-class HUNT, RESOLVE, BRIDGE, PAY, and PROXY domain primitives, portable proof packs, an Auto-Audit Vault contract, Resolve scam and mobility triage, regulated PROXY human routes, misinformation escalation to PROXY review, durable task lifecycle state, durable mandate records, payment mandate preparation, settlement adapter contracts, BRIDGE connector registry, connector preflight, PROXY human-in-the-loop suspend/resume contracts, durable proxy mission records, durable proxy callback reference lookup, proxy mission/outcome/proof schemas, scoped credential references, redacted secret-reference checks, mandate-session and capability-grant policy evaluation and runtime enforcement across BRIDGE, PAY, and PROXY, durable escrow records, durable A2A envelope records, durable community signal provenance, durable integration event outbox, subscriptions, delivery attempts, ready, chain, single and batch claim, complete, cancel, retry, fail, lease, sweep, retry-scheduling, and queue-stat controls, durable agent capability discovery, A2A envelopes, community signal disambiguation, audit proof-of-value verification, listable receipt and evidence export, bearer-token API/MCP/A2A transport auth, public API status, a security whitepaper, a neutral SDK/API/MCP boundary, a public schema catalog, integration manifest with domain capability and policy discovery, domain-aware compatibility handshake with contract references, developer docs, and a versioned agent-readable protocol map with deterministic digest, method-aware API route metadata, SDK, MCP, schema, manifest parity, and policy metadata, external RESOLVE and PROXY SDK helpers, file-to-base64 RESOLVE intake, claim drafting, contact-channel planning, a damaged-TV RESOLVE journey test, a local developer sandbox with API/SDK/MCP trace access, local benchmark evidence with claim labels, source-hygiene guardrails, source brief contract parity, boundary gap wording cleanup, migration inventory closure, brief surface completeness, FastAPI contract parity for PROXY, rollout verification gates, and machine-readable contracts.
+
+## Local Commands
+
+```bash
+npm install
+npm run dev
+npm run api:dev
+npm run web:dev
+npm run web:build
+npm run verify
+PYTHONPATH=src:. python -m apps.api.main
+PYTHONPATH=src:. python -m apps.worker.main
+PYTHONPATH=src:. python -m apps.worker.verify
+PYTHONPATH=src:. python -m apps.sandbox.main --pretty
+PYTHONPATH=src:. python -m apps.benchmarks.main --iterations 100 --pretty
+PYTHONPATH=src:. python -m unittest discover -s tests -p 'test_*.py'
+```
+
+## Docs
+
+- [GCP Terraform deployment](infra/gcp/terraform/README.md)
+- [Migration plan](docs/picux-migration-plan.md)
+- [Phase 0 inventory](docs/picux-migration-inventory.md)
+- [Phase 5 community signals](docs/phase5-community-signals.md)
+- [Phase 6 external client](docs/phase6-external-client.md)
+- [Phase 7 developer sandbox](docs/phase7-developer-sandbox.md)
+- [Phase 8 verification](docs/phase8-verification-rollout.md)
+- [Phase 9 protocol contracts](docs/phase9-protocol-contracts.md)
+- [Phase 10 HUNT domain](docs/phase10-hunt-domain.md)
+- [Phase 11 agent registry](docs/phase11-agent-registry.md)
+- [Phase 12 audit verification](docs/phase12-audit-verification.md)
+- [Phase 13 receipt export](docs/phase13-receipt-export.md)
+- [Phase 14 A2A envelope](docs/phase14-a2a-envelope.md)
+- [Phase 15 agent registry durability](docs/phase15-agent-registry-durability.md)
+- [Phase 16 task lifecycle](docs/phase16-task-lifecycle.md)
+- [Phase 17 mandate durability](docs/phase17-mandate-durability.md)
+- [Phase 18 escrow durability](docs/phase18-escrow-durability.md)
+- [Phase 19 MCP endpoint](docs/phase19-mcp-endpoint.md)
+- [Phase 20 transport auth](docs/phase20-transport-auth.md)
+- [Phase 21 schema catalog](docs/phase21-schema-catalog.md)
+- [Phase 22 A2A envelope durability](docs/phase22-a2a-envelope-durability.md)
+- [Phase 23 A2A transport auth](docs/phase23-a2a-transport-auth.md)
+- [Phase 24 receipt reconciliation](docs/phase24-receipt-reconciliation.md)
+- [Phase 25 evidence catalog](docs/phase25-evidence-catalog.md)
+- [Phase 26 community signal durability](docs/phase26-community-signal-durability.md)
+- [Phase 27 integration manifest](docs/phase27-integration-manifest.md)
+- [Phase 28 integration handshake](docs/phase28-integration-handshake.md)
+- [Phase 29 integration events](docs/phase29-integration-events.md)
+- [Phase 30 event subscriptions](docs/phase30-event-subscriptions.md)
+- [Phase 31 event deliveries](docs/phase31-event-deliveries.md)
+- [Phase 32 delivery claim and retry](docs/phase32-delivery-claim-retry.md)
+- [Phase 33 delivery leases](docs/phase33-delivery-leases.md)
+- [Phase 34 delivery lease sweep](docs/phase34-delivery-lease-sweep.md)
+- [Phase 35 delivery retry scheduling](docs/phase35-delivery-retry-scheduling.md)
+- [Phase 36 delivery stats](docs/phase36-delivery-stats.md)
+- [Phase 37 delivery fail scheduling](docs/phase37-delivery-fail-scheduling.md)
+- [Phase 38 delivery completion](docs/phase38-delivery-completion.md)
+- [Phase 39 delivery chain](docs/phase39-delivery-chain.md)
+- [Phase 40 delivery cancellation](docs/phase40-delivery-cancellation.md)
+- [Phase 41 delivery ready preview](docs/phase41-delivery-ready.md)
+- [Phase 42 delivery batch claim](docs/phase42-delivery-batch-claim.md)
+- [Phase 43 payment adapters](docs/phase43-payment-adapters.md)
+- [Phase 44 bridge connectors](docs/phase44-bridge-connectors.md)
+- [Phase 45 security policy](docs/phase45-security-policy.md)
+- [Phase 46 developer docs](docs/phase46-developer-docs.md)
+- [Phase 47 sandbox API](docs/phase47-sandbox-api.md)
+- [Phase 48 benchmark evidence](docs/phase48-benchmark-evidence.md)
+- [Phase 49 status and security](docs/phase49-status-security.md)
+- [Phase 50 source hygiene](docs/phase50-source-hygiene.md)
+- [Phase 51 FastAPI contract parity](docs/phase51-fastapi-contract-parity.md)
+- [Phase 52 runtime policy enforcement](docs/phase52-runtime-policy-enforcement.md)
+- [Phase 53 secret reference checks](docs/phase53-secret-reference-checks.md)
+- [Phase 54 BRIDGE preflight](docs/phase54-bridge-preflight.md)
+- [Phase 55 PROXY suspend/resume](docs/phase55-proxy-suspend-resume.md)
+- [Phase 56 PROXY durability](docs/phase56-proxy-durability.md)
+- [Phase 57 PROXY callback refs](docs/phase57-proxy-callback-refs.md)
+- [Phase 58 PROXY policy enforcement](docs/phase58-proxy-policy-enforcement.md)
+- [Phase 59 PROXY FastAPI parity](docs/phase59-proxy-fastapi-parity.md)
+- [Phase 60 PROXY external SDK](docs/phase60-proxy-external-sdk.md)
+- [Phase 61 domain manifest](docs/phase61-domain-manifest.md)
+- [Phase 62 domain handshake](docs/phase62-domain-handshake.md)
+- [Phase 63 domain policy discovery](docs/phase63-domain-policy-discovery.md)
+- [Phase 64 agent-readable policy map](docs/phase64-agent-readable-policy-map.md)
+- [Phase 65 agent map manifest parity](docs/phase65-agent-map-manifest-parity.md)
+- [Phase 66 protocol map surface](docs/phase66-protocol-map-surface.md)
+- [Phase 67 handshake contract references](docs/phase67-handshake-contract-refs.md)
+- [Phase 68 protocol map route metadata](docs/phase68-protocol-map-route-metadata.md)
+- [Phase 69 protocol map version source](docs/phase69-protocol-map-version-source.md)
+- [Phase 70 protocol map digest](docs/phase70-protocol-map-digest.md)
+- [Phase 71 brief contract parity](docs/phase71-brief-contract-parity.md)
+- [Phase 72 boundary gap wording](docs/phase72-boundary-gap-wording.md)
+- [Phase 73 migration inventory closure](docs/phase73-migration-inventory-closure.md)
+- [Phase 74 brief surface completeness](docs/phase74-brief-surface-completeness.md)
+- [Phase 75 resolve TV journey](docs/phase75-resolve-tv-journey.md)
+- [Phase 76 resolve attachment contact](docs/phase76-resolve-attachment-contact.md)
+- [Phase 77 domain proof packs](docs/phase77-domain-proof-packs.md)
+- [Phase 78 workflow templates and proof cards](docs/phase78-workflow-templates-proof-cards.md)
+- [Phase 79 developer activation loop](docs/phase79-developer-activation-loop.md)
+- [Distribution homepage](docs/distribution-homepage.md)
+- [Security whitepaper](docs/security-whitepaper.md)
+- [Developer docs](docs/developers/index.md)
+- [Docs index](docs/index.md)

patchr-0.1.0.dist-info/RECORD

@@ -0,0 +1,116 @@
+apps/__init__.py,sha256=kCC0kvP5Web_YR8Muyc9cRTCEj8QIJzSBUx_JdKpnn4,38
+apps/api/__init__.py,sha256=ta89ZwlALFiZcJy4C__IRZlPkbm60ObUk3FqRqOcMts,30
+apps/api/main.py,sha256=OhfDeP3eK3tHgEdVbD7-8XoE4gdoSP6_hBxK2wU3XLs,26479
+apps/benchmarks/__init__.py,sha256=nFUCHmIucxo5Qg9-QnFgJmmrjauUeFi7V5la0oCgZYQ,37
+apps/benchmarks/main.py,sha256=OU4lwoDUVNJxoeMB9tmZSQGT3uCt60VTmOFJu3tfzZo,574
+apps/sandbox/__init__.py,sha256=6XdFcg420YfXeGzSid8S8dE6dIf9YpujlCZkR85PwbM,34
+apps/sandbox/main.py,sha256=nV9D1fvrAg3VhrwBbzyFAM--tchZd3uYJzOMwd69BcI,680
+apps/worker/__init__.py,sha256=GRIN6YXqWJOMxypHPNPMdCO38KqUL-keC_ZS9NduFdg,33
+apps/worker/main.py,sha256=d7O0TxCx1NJyVJnM1-IzMIaEJ_SPsvppLeO3tl3E1aU,303
+apps/worker/verify.py,sha256=Qx1-9sahoxfE8FoSsrO_QEH2tq30MGkdTGJf1bF_oH8,271
+patchr/__init__.py,sha256=d5FfcklbOWg__wvVaiTBHfnku0diwJZZeiqmBP-VliE,295
+patchr/sdk/__init__.py,sha256=igbwz6sERDC0oB4A1zWLKDMlJ0VSeP-IzEzMtCIH7FY,494
+patchr/sdk/client.py,sha256=1_guLahvPV5SwAyPbtedu0waQ8O22wNHaOAl7SwXaNs,300
+patchr-0.1.0.dist-info/licenses/LICENSE,sha256=z0eHPvhRIQEfgj8XeVsC3IBC_nQJAb6EmzzdVlGWTjQ,631
+picux/__init__.py,sha256=TediMUYjpI1MGpK3DtPjoms6cjxlBkP6n1ZK_DNywyQ,82
+picux/config.py,sha256=SWVpRb6csa4N3wBXa7DEUE42bVSvsw_8NyJo8-NZSg0,5219
+picux/agents/__init__.py,sha256=T691Rrdap9ATkVWCXY0Ynsfub_G3XGIX1zQFYDrZ17s,175
+picux/agents/registry.py,sha256=Nc0nTRuA0LWbyDwQ8RlgMU31JiiBgX6-Oz3ksKGAizo,8072
+picux/api/__init__.py,sha256=HKSAbNNxYD18jzYyS_V7lbnwbCvlxTTPxfYXV00v1MQ,106
+picux/api/service.py,sha256=ZvMFxbQOX9_QuL7EiL8APctF85NKLSPZi-wxhxNBhgw,260283
+picux/audit/__init__.py,sha256=CxTiflKkcgilx4cnRxWgUdGQi2rYSB_FaLroODIm8BE,653
+picux/audit/activity.py,sha256=yqbJcjDFkhV_Zr5uAEp5eaRgiKKAKUSt03zeid958ok,3231
+picux/audit/observability.py,sha256=sB9dCA9IIQu9kIidf3L4BNVkZPCZbHYJE_UPOrYPlME,1467
+picux/audit/verification/__init__.py,sha256=wSGbrYMqsO1CPt7s798n0otPaZIYxcfsz3bLXNKlzUg,385
+picux/audit/verification/ledger.py,sha256=m3f6hDZbUh8J3gBWrJVohIyXdmI25oNVKl3nNCXeSPg,25916
+picux/benchmarks/__init__.py,sha256=beBHLt_Keh7VDZDxB2_0NENWtqS-rGTtmZU4qeRy9Ic,108
+picux/benchmarks/local.py,sha256=1ox6HpRNG-81RtX0AOhIjg0M6203TQhuUcZ65PzRU5U,10807
+picux/contracts/__init__.py,sha256=UKuCPB2ERBkJRpRvaSvtP3fvLEdSzxBN-12ngpE4S4Q,626
+picux/contracts/handshake.py,sha256=Ju_8CYhvLwx1FFrnvFqWkXNCbD8NROe1QbfZ5IsKBwM,4910
+picux/contracts/integration.py,sha256=37d7DOVoEPeie6ynzxq4ln_HAVif45AYtf1gIFB08u0,18045
+picux/contracts/openapi.py,sha256=8pcJkunjVeLpKLVwA4ihUjN1m2hQPjpAgFi0zRRywOA,6315
+picux/contracts/protocol_map.py,sha256=PuOB04zUuFvK8oiTBWQKdZAtV2dy4Rjr8XEfh8M59NQ,6990
+picux/contracts/routes.py,sha256=JSqhgr4vT4jO5Kw3GcyYJ1G8sQB9HBc_TGKmmSM7GNc,35061
+picux/contracts/schema_catalog.py,sha256=-MgX4-W6PTg-HDymXH1XWNNUD7MTTPsIL_SygKbgsww,8259
+picux/core/__init__.py,sha256=sekMydfnx07DPwJaSMaVoUavCsxozZ98uiAWDxbWhdA,431
+picux/core/models.py,sha256=JngC4jG-ByXLucDJH-muqxB3R202Wr1q2S7U5c1Npj0,5159
+picux/core/router.py,sha256=dpJncIvOXzuTtm1ZBE3p3gCOln9MLK61_ZvZg7WjFlQ,3190
+picux/core/runtime.py,sha256=CWafAF8wenaWqxOTuymYA-fd0pFTO8dTBwBeHoHyJjg,1252
+picux/core/state_machine.py,sha256=ZU-h6HHJxWL650oOi2s9hvCyfPoCAVM8w3j5grjdqJY,1164
+picux/domains/__init__.py,sha256=BdA_yMK5Ddu2v1aneBh-XPARil2vt6OcVNSuHY1BYzY,31
+picux/domains/bridge/HostRun.py,sha256=vLp8Ih9EUxDAo-R9yNp4brBgV-OGbsdXWOlAFIpFiiY,57307
+picux/domains/bridge/__init__.py,sha256=wUy31w0WxrJvto89-mdeKiRYIDxIW6fiQe7vPuI1lpU,160
+picux/domains/bridge/engine.py,sha256=ORk6pC1zX-iSx4SlE1bXwEuE8JKJusen5dttL269bCY,16177
+picux/domains/hunt/__init__.py,sha256=qKR8bJCD4L__8IMsb6sA8rVqFZ87YNyQOFAfM69b-Uk,161
+picux/domains/hunt/engine.py,sha256=5JshW8WoZJZX5AxDylr8ldCp6vQks-btVyI531COysY,15920
+picux/domains/hunt/models.py,sha256=30KDzMX0MNYj2WkjXi6pr8qkCc4h6W4KvyoYkkQttsE,3021
+picux/domains/pay/__init__.py,sha256=nABSbOCH3mLPQloX3wQ-VttkZHECHN1XDn69KVfpTn0,416
+picux/domains/pay/adapters.py,sha256=JBegwMO4DfDz3bd756XfpskzbdvFGqR2Fn3UhtyChJc,31823
+picux/domains/pay/engine.py,sha256=UzqYdfbKBZQ4vRcNsCMYgfnzigLJXYS8_ApVus34c1Y,45438
+picux/domains/pay/models.py,sha256=rtiJ98WnU9FRqP-O2eThY7vrvXXlgvxOuENo0m-ZMZo,3151
+picux/domains/proxy/__init__.py,sha256=Y-b3Sb5CEnP01deIuY33pdGyTuSqdJCYeCwYHfuo2xU,91
+picux/domains/proxy/engine.py,sha256=jxesdCOHnX-MxxcCN1afdUYl65-mBakU_a7nuVH1L0A,20623
+picux/domains/resolve/__init__.py,sha256=KklbjwHNx82xni_rBaB03fRXEGKbIqsL2lZsU0QKpTw,97
+picux/domains/resolve/engine.py,sha256=8hNcjZS9E5Ha-FPSuP_zgiEYapdP62mW67JXfOOjLug,29466
+picux/orchestrator/__init__.py,sha256=HjxMjs0-PSrS_f9bjL_T_4bvUMIdPDXFSZM9juQiYh0,91
+picux/orchestrator/engine.py,sha256=DuQoqpchEyJx2MG_IinuwpymzdYMR_-qbE3rUz82PkE,157820
+picux/portals/__init__.py,sha256=A3eJgVAeO0mU8CiVuOcYd2tjxkZYZAOwSdXWYuwK_Ts,439
+picux/portals/templates.py,sha256=foAPCyuC_hOuIxlNkG8A3DNPnc5jPHhhGVgIQb8IFUg,15189
+picux/protocols/__init__.py,sha256=3OdqVdKbvQA7qqLzpR5CFkrzoH6kInTK7cih6T66KBA,64
+picux/protocols/a2a/__init__.py,sha256=7q8BB0wJRS_4GEnFdHlK9eHYLC3Pg-lHG_w4jTk4lA0,247
+picux/protocols/a2a/client.py,sha256=YkY6R8uLR5fAbTF3H8jglSEuTwiZFP4RPd24g4Lm14o,1812
+picux/protocols/a2a/envelope.py,sha256=OXf2JFGy0HnGpF6ct_emF8885-q-rvI9Sj6R7DbkEBw,4439
+picux/protocols/mcp/__init__.py,sha256=FNT0drKUVoZw8xFy1lOarP2DkwQfTYsks5uXNJA45WI,198
+picux/protocols/mcp/client.py,sha256=os7_scL4eDShdmgTyoHlbAJRgP_igDXnzqzoRKYmGtM,2308
+picux/protocols/mcp/contract.py,sha256=P1BjfAZIwyh2VqqA-gBOAGjHFcHxPB-rk_iAISgbUHY,2134
+picux/protocols/mcp/server.py,sha256=-hjcDQcecYrasnC_XgphMipOXxamotXla7Zodr7JZjc,3081
+picux/sandbox/__init__.py,sha256=YVpTiYH-yaFCJIYCAiqmEM6ek6ybovbRCSa8nZFIvfw,243
+picux/sandbox/midnight_arbitrage.py,sha256=OCrOLSR8x6Kg4kcpdNkxXDykZJFyLbSonEneDsXkQZ8,9820
+picux/sandbox/models.py,sha256=x5G8sDHyYk4t_OzoG2goj7iFo066GKBQ07lKTj_vA0A,2401
+picux/sdk/__init__.py,sha256=QiKYh1XVs6QQR-VDJWO1KGgzeMEGxQLfcpHPtCbl6gE,307
+picux/sdk/client.py,sha256=Qx3-cVqMDSbRek6b5bc-_A081HoFsPi3q4GDwHZaTSg,37602
+picux/sdk/external.py,sha256=W1K0LeL_Zy2m0qWzRW2LUtCGMotw4H1b_m-N7Rrj8PI,8145
+picux/security/__init__.py,sha256=0XpuNqqhVsPHn5SRDpr9MaOzsWXtwSYflWtbf6RXpOo,527
+picux/security/auth.py,sha256=tixHJg8IkR_0UQT25TN-eQ1qfM1oSP5UKWsm8iLAeEM,2847
+picux/security/config_validator.py,sha256=1ukXY0cJY9Xwk4R6k77_km7Xwdc-5sBcgfAbFPWi7vQ,1906
+picux/security/policy.py,sha256=A_L5A9ZaR6hphHeNcEN26LZPeKtQTej5UnqWkTJG7yw,5934
+picux/security/secrets.py,sha256=1OtYQJYbEzfiVqE7q4ySGcq5SEiaF2ZY8XJsfjcWz5k,5661
+picux/signals/__init__.py,sha256=ygkC5UWs-kfoxwolG6Mx2qNhszf6sY62pr40Wb2Rpjw,72
+picux/signals/community/__init__.py,sha256=TBMolPEPIBIdg0y-e_2bMLC8TCLga0_Ef0GSVgf_cNE,772
+picux/signals/community/disambiguation.py,sha256=l9CaROjKl-DrPhrWvNAiKnze6IF0JC_9wgZhHp1Hyx8,1452
+picux/signals/community/intake.py,sha256=rXRgiCJHp6njwXkNrP_v2M89oJxwZDh3c9ecY4wfKVE,9460
+picux/signals/community/models.py,sha256=y0SwBcrbMH88BLCNkxvpcpD6PZd55-IIYpVpmDyWSjE,3369
+picux/signals/community/rules.py,sha256=G5aLbGpl6hCAQ9XE4bzDZVfqzJPPZ-ODgQRymoZsoGA,2418
+picux/signals/community/scoring.py,sha256=CA4-DuJmLOwwtQzrtDZsnWy1V_w_T2evRPWHfrlO15A,2457
+picux/signals/community/adapters/__init__.py,sha256=okbKhOslOwHuK35X0RsIKfRdGtFsnhZEp6c3IUP6EPg,216
+picux/signals/community/adapters/reddit.py,sha256=1AYII8PfHHenhtp71VwcxqUsiU9FLGyofmPU-Nh1R1A,1427
+picux/signals/community/adapters/shopify.py,sha256=zotPyFc44jdhzChgRbqiCJaLKeOuY-KB3zpvLzga-Xs,899
+picux/signals/community/adapters/web.py,sha256=uVrKGGIZwXqU_7hevMXEv4pF6oLctG8qRoEpL7wBPJI,889
+picux/storage/__init__.py,sha256=vN7VD2Cm7yHcQ4HyRwd6rToeF8A6MAzdsiJzJVSob9k,1028
+picux/storage/agents.py,sha256=90CIYnQWaoo7AtzvupSqnqAi3xo0HgG9vXSBac_9LlQ,1985
+picux/storage/cases.py,sha256=wrYlKHSF6FlJB73TX_yxDFlqpSvDHHD-tfZfkdT6AMo,24588
+picux/storage/channels.py,sha256=T3a5mdjhndE7OLL0Z9ZuSXM0_Vt1JiriSKsTVfS6hYc,25061
+picux/storage/connectors.py,sha256=U5TBehxTPLGJ_hDXVuqRhHXqe1L0w6GJpGWfWg6Homk,18654
+picux/storage/envelopes.py,sha256=nO_TpYM53qFS_-L25PjKmw-ZmJOQzEynJ4cw2P0ILWc,5689
+picux/storage/escrows.py,sha256=ZsCrJVXzBXeJtBqlGM8p_sT4yn12NDvz-FwunTkFqAk,7038
+picux/storage/events.py,sha256=Kbi-Vc63NR4uWAva2iWnNXapFcVWn-bnQPAu2TwuBX0,45616
+picux/storage/keyspace.py,sha256=mEvPEVLn2TjmvBAz-hs9vCa8uvbB7h23voY1xw1j91k,1888
+picux/storage/mandates.py,sha256=4emnEy-la4mJDzHjDoCsSWivHnz1GIqoKmUOFeTKRX0,4326
+picux/storage/portals.py,sha256=OhJiZZdm-bnp9mW2XVl9jLbEaTcOHcJqZozFfl7ZdzQ,11445
+picux/storage/postgres.py,sha256=VZgf4ywmympSPgQYZtogy1MW2xjctc6GFijyZ49uOeU,97935
+picux/storage/providers.py,sha256=MqHwyL1_0RiALqRBUIDdKtAFSUKUPMrXaMIW0P7WDkw,7899
+picux/storage/proxy.py,sha256=qeCcB3700hCVCGo0179hxH0jPG3enFLtqWAYkSbucEM,9842
+picux/storage/receipts.py,sha256=n4FzkZsrI24u-hktW4ZtOs9UmSK9yvjah8n_4vCIN08,5564
+picux/storage/signals.py,sha256=Z3uQoTU2jIza-8H-vb7qUzeZuT3COXIp0P5d1KHtRlA,5825
+picux/storage/tasks.py,sha256=oHxrnCfMQtX_YfYmhEx_QxXBSHXJcrnNSYdOhhM6VWc,7777
+picux/tools/__init__.py,sha256=3HRIZC7dWMeO6m4uyFilt5tGBTmEpA4JF_pCeIwQd2E,262
+picux/tools/shared.py,sha256=hfnuQAvNXXT2VwBY62kKYCiPnUA7lGJ-YU3qboCTza4,93091
+picux/verification/__init__.py,sha256=LS8USyFxXCKV6GkeHryKUXCEQ5n-LHZOydspFBr2HY0,167
+picux/verification/rollout.py,sha256=tYzEh9PDT7PKoWaJD0qe6MEuOKcWpy6FRBoiwQS-9oQ,7455
+picux/workflows/__init__.py,sha256=8KNG9zy0Y9dLc7riA8Z86zqh1XNwj-lRrgkjInyzziM,169
+picux/workflows/templates.py,sha256=GDm8XyDmTpBuYXzDi94qklYMzZWQyaqDh6VloJl9MVo,2675
+patchr-0.1.0.dist-info/METADATA,sha256=q4pNOLlcq-ByawK3jDp5vaSn0d9xqA2z8B6CKktypYc,9568
+patchr-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+patchr-0.1.0.dist-info/entry_points.txt,sha256=KUBoiMW6w11pNYyS4P_iD1j4KPCJA1ClmBeUz8-M4dw,156
+patchr-0.1.0.dist-info/top_level.txt,sha256=bcUKRf4ja-0KW3ecgsexEeVBXJQT6I2A0TBlG40w5d4,18
+patchr-0.1.0.dist-info/RECORD,,

patchr-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

patchr-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+patchr-api = apps.api.main:main
+patchr-worker = apps.worker.main:main
+picux-api = apps.api.main:main
+picux-worker = apps.worker.main:main

patchr-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 Patchr Core Team
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

patchr-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+apps
+patchr
+picux

picux/__init__.py

@@ -0,0 +1,6 @@
+"""Picux Protocol scaffold."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"
+

picux/agents/__init__.py

@@ -0,0 +1,5 @@
+"""Agent lifecycle and capability discovery primitives."""
+
+from .registry import AgentCard, AgentMatch, AgentRegistry
+
+__all__ = ["AgentCard", "AgentMatch", "AgentRegistry"]

picux/agents/registry.py

@@ -0,0 +1,204 @@
+from __future__ import annotations
+
+import hashlib
+import json
+from dataclasses import dataclass, field
+from typing import Any
+
+from picux.core import Domain
+from picux.protocols.a2a.envelope import createEnvelope
+
+
+@dataclass(frozen=True)
+class AgentCard:
+    agentId: str
+    name: str
+    domains: tuple[str, ...] = ()
+    caps: tuple[str, ...] = ()
+    endpoint: str = ""
+    trust: int = 1
+    status: str = "active"
+    meta: dict[str, Any] = field(default_factory=dict)
+
+    @classmethod
+    def fromObj(cls, value: dict[str, Any]) -> "AgentCard":
+        rawDomains = value.get("domains", value.get("domain", []))
+        if isinstance(rawDomains, str):
+            rawDomains = [rawDomains]
+        rawCaps = value.get("caps", value.get("capabilities", []))
+        if isinstance(rawCaps, str):
+            rawCaps = [rawCaps]
+        name = str(value.get("name", value.get("agentId", "")) or "")
+        agentId = str(value.get("agentId", "") or cls.stableId(name, rawDomains, rawCaps))
+        return cls(
+            agentId=agentId,
+            name=name or agentId,
+            domains=tuple(_cleanList(rawDomains)),
+            caps=tuple(_cleanList(rawCaps)),
+            endpoint=str(value.get("endpoint", "") or ""),
+            trust=int(value.get("trust", 1) or 1),
+            status=str(value.get("status", "active") or "active"),
+            meta=value.get("meta", {}) if isinstance(value.get("meta", {}), dict) else {},
+        )
+
+    def toMap(self) -> dict[str, Any]:
+        return {
+            "agentId": self.agentId,
+            "name": self.name,
+            "domains": list(self.domains),
+            "caps": list(self.caps),
+            "endpoint": self.endpoint,
+            "trust": self.trust,
+            "status": self.status,
+            "meta": self.meta,
+        }
+
+    @staticmethod
+    def stableId(name: str, domains: Any, caps: Any) -> str:
+        payload = {"name": name, "domains": list(domains or []), "caps": list(caps or [])}
+        digest = hashlib.sha256(json.dumps(payload, ensure_ascii=True, sort_keys=True).encode("utf-8")).hexdigest()
+        return f"agent_{digest[:16]}"
+
+
+@dataclass(frozen=True)
+class AgentMatch:
+    agent: AgentCard
+    score: float
+    reasons: tuple[str, ...]
+
+    def toMap(self) -> dict[str, Any]:
+        return {**self.agent.toMap(), "score": round(self.score, 3), "reasons": list(self.reasons)}
+
+
+class AgentRegistry:
+    """Registry for external agent capability discovery."""
+
+    def __init__(self, agents: list[AgentCard] | None = None, *, backing: Any | None = None) -> None:
+        self.backing = backing
+        self._agents: dict[str, AgentCard] = {}
+        self._loadBacking()
+        for agent in agents or []:
+            self._agents[agent.agentId] = agent
+            self._save(agent)
+
+    def register(self, raw: AgentCard | dict[str, Any]) -> dict[str, Any]:
+        agent = raw if isinstance(raw, AgentCard) else AgentCard.fromObj(raw)
+        errors = self.validate(agent)
+        if errors:
+            return {"ok": False, "errors": errors, "agent": agent.toMap()}
+        self._agents[agent.agentId] = agent
+        self._save(agent)
+        return {"ok": True, "agent": agent.toMap()}
+
+    def listAgents(self) -> dict[str, Any]:
+        self._loadBacking()
+        return {"ok": True, "agents": [agent.toMap() for agent in sorted(self._agents.values(), key=lambda item: item.agentId)]}
+
+    def getAgent(self, agentId: str) -> dict[str, Any]:
+        self._loadBacking()
+        agent = self._agents.get(str(agentId or ""))
+        if agent is None:
+            return {"ok": False, "error": "agentNotFound", "agentId": str(agentId or "")}
+        return {"ok": True, "agent": agent.toMap()}
+
+    def match(self, payload: dict[str, Any]) -> dict[str, Any]:
+        domain = str(payload.get("domain", "") or "").lower()
+        caps = tuple(_cleanList(payload.get("caps", payload.get("capabilities", []))))
+        matches = [self.score(agent, domain=domain, caps=caps) for agent in self._agents.values()]
+        matches = [match for match in matches if match.score > 0 and match.agent.status == "active"]
+        matches.sort(key=lambda item: (item.score, item.agent.trust, item.agent.agentId), reverse=True)
+        return {
+            "ok": bool(matches),
+            "domain": domain,
+            "caps": list(caps),
+            "matches": [match.toMap() for match in matches],
+        }
+
+    def delegate(self, payload: dict[str, Any]) -> dict[str, Any]:
+        agentId = str(payload.get("agentId", "") or "")
+        if not agentId:
+            matched = self.match(payload)
+            if not matched["matches"]:
+                return {"ok": False, "error": "agentNotFound", "matches": []}
+            agentId = matched["matches"][0]["agentId"]
+        agent = self._agents.get(agentId)
+        if agent is None or agent.status != "active":
+            return {"ok": False, "error": "agentNotFound", "agentId": agentId}
+        task = payload.get("task") if isinstance(payload.get("task"), dict) else {}
+        envelope = createEnvelope(
+            {
+                "fromAgent": str(payload.get("fromAgent", "picux") or "picux"),
+                "toAgent": agent.agentId,
+                "task": task,
+                "caps": payload.get("caps", payload.get("capabilities", [])),
+                "payload": payload.get("payload", {}),
+                "traceId": payload.get("traceId", task.get("taskId", "")),
+            }
+        )
+        plan = {
+            "agentId": agent.agentId,
+            "endpoint": agent.endpoint,
+            "status": "pendingExternalTransport",
+            "reason": "a2aTransportNotInvoked",
+            "task": task,
+            "envelope": envelope["envelope"],
+        }
+        return {"ok": True, "delegation": plan}
+
+    @staticmethod
+    def validate(agent: AgentCard) -> list[str]:
+        errors: list[str] = []
+        if not agent.agentId:
+            errors.append("missing:agentId")
+        if not agent.name:
+            errors.append("missing:name")
+        if not agent.domains:
+            errors.append("missing:domains")
+        invalidDomains = [domain for domain in agent.domains if domain not in Domain._value2member_map_]
+        if invalidDomains:
+            errors.append("invalid:domains")
+        if agent.trust < 0:
+            errors.append("invalid:trust")
+        if agent.status not in {"active", "paused", "disabled"}:
+            errors.append("invalid:status")
+        return errors
+
+    @staticmethod
+    def score(agent: AgentCard, *, domain: str, caps: tuple[str, ...]) -> AgentMatch:
+        reasons: list[str] = []
+        score = 0.0
+        if domain and domain in agent.domains:
+            score += 0.6
+            reasons.append("domainMatch")
+        capMatches = sorted(set(caps).intersection(agent.caps))
+        if capMatches:
+            score += min(0.3, 0.1 * len(capMatches))
+            reasons.extend([f"cap:{cap}" for cap in capMatches])
+        if agent.endpoint:
+            score += 0.05
+            reasons.append("endpoint")
+        if agent.trust > 1:
+            score += min(0.05, agent.trust / 100.0)
+            reasons.append("trust")
+        return AgentMatch(agent=agent, score=round(score, 3), reasons=tuple(reasons))
+
+    def _save(self, agent: AgentCard) -> None:
+        if self.backing is not None and hasattr(self.backing, "saveAgent"):
+            self.backing.saveAgent(agent.toMap())
+
+    def _loadBacking(self) -> None:
+        if self.backing is None or not hasattr(self.backing, "listAgents"):
+            return
+        result = self.backing.listAgents()
+        for raw in result.get("agents", []) if isinstance(result, dict) else []:
+            if not isinstance(raw, dict):
+                continue
+            agent = AgentCard.fromObj(raw)
+            if not self.validate(agent):
+                self._agents[agent.agentId] = agent
+
+
+def _cleanList(value: Any) -> list[str]:
+    if not isinstance(value, (list, tuple, set)):
+        return []
+    return [str(item).strip().lower() for item in value if str(item).strip()]

picux/api/__init__.py

@@ -0,0 +1,5 @@
+"""Picux API contract primitives."""
+
+from .service import PicuxApiService
+
+__all__ = ["PicuxApiService"]