theprotocol-sdk 0.7.0__tar.gz → 0.7.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/PKG-INFO +5 -2
  2. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/README.md +4 -1
  3. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/pyproject.toml +1 -1
  4. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/__init__.py +1 -1
  5. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/exchange/client.py +18 -4
  6. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/mtls.py +9 -0
  7. theprotocol_sdk-0.7.2/tests/test_exchange_launch.py +41 -0
  8. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_mtls_enroll.py +40 -0
  9. theprotocol_sdk-0.7.0/.gitignore +0 -95
  10. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/LICENSE +0 -0
  11. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/examples/simple_agent.py +0 -0
  12. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/agent/__init__.py +0 -0
  13. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/agent/base.py +0 -0
  14. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/agent/decorators.py +0 -0
  15. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/agent/router.py +0 -0
  16. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/agent/task_store.py +0 -0
  17. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/agent/well_known.py +0 -0
  18. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/auth/__init__.py +0 -0
  19. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/auth/did_jwt.py +0 -0
  20. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/auth/jws_card.py +0 -0
  21. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/auth/jwt_verifier.py +0 -0
  22. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/authz.py +0 -0
  23. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/bridges/__init__.py +0 -0
  24. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/bridges/acp.py +0 -0
  25. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/bridges/anp/__init__.py +0 -0
  26. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/bridges/anp/auth.py +0 -0
  27. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/bridges/anp/bridge.py +0 -0
  28. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/bridges/anp/did_wba.py +0 -0
  29. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/bridges/anp/translation.py +0 -0
  30. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/bridges/base.py +0 -0
  31. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/bridges/google_a2a.py +0 -0
  32. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/bridges/mcp.py +0 -0
  33. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/client/__init__.py +0 -0
  34. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/client/a2a_client.py +0 -0
  35. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/client/credentials.py +0 -0
  36. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/exceptions.py +0 -0
  37. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/exchange/__init__.py +0 -0
  38. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/forge.py +0 -0
  39. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/guild.py +0 -0
  40. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/messenger.py +0 -0
  41. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/models/__init__.py +0 -0
  42. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/models/a2a_protocol.py +0 -0
  43. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/models/agent_card.py +0 -0
  44. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/models/v1_compat.py +0 -0
  45. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/payment/__init__.py +0 -0
  46. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/payment/authenticator.py +0 -0
  47. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/payment/client.py +0 -0
  48. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/payment/mtls_client.py +0 -0
  49. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/payment/verifier.py +0 -0
  50. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/registry/__init__.py +0 -0
  51. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/registry/card_verify.py +0 -0
  52. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/registry/cost_composition.py +0 -0
  53. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/transfer/__init__.py +0 -0
  54. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/src/theprotocol/transfer/client.py +0 -0
  55. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/registry/__init__.py +0 -0
  56. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/registry/test_card_verify.py +0 -0
  57. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/registry/test_cost_composition.py +0 -0
  58. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_agent.py +0 -0
  59. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_artifact_roundtrip.py +0 -0
  60. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_auth.py +0 -0
  61. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_authz.py +0 -0
  62. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_bridge_acp.py +0 -0
  63. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_bridge_anp.py +0 -0
  64. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_bridge_google_a2a.py +0 -0
  65. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_bridge_mcp.py +0 -0
  66. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_credentials.py +0 -0
  67. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_did_jwt.py +0 -0
  68. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_forge.py +0 -0
  69. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_guild.py +0 -0
  70. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_jws_card.py +0 -0
  71. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_messenger.py +0 -0
  72. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_models.py +0 -0
  73. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_transfer.py +0 -0
  74. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_v1_compat.py +0 -0
  75. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_verifier_reuse.py +0 -0
  76. {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.2}/tests/test_well_known.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: theprotocol-sdk
3
- Version: 0.7.0
3
+ Version: 0.7.2
4
4
  Summary: Build sovereign AI agents with DID identity on TheProtocol. Speaks the A2A protocol (v1.0) natively, with bridges for Google A2A, ANP, and MCP. Works with Vertex AI, AWS AgentCore, LangGraph, CrewAI.
5
5
  Project-URL: Homepage, https://theprotocol.cloud
6
6
  Project-URL: Documentation, https://docs.theprotocol.cloud
@@ -183,6 +183,9 @@ The private key is written `0600` into a `0700` directory, via a temp file and r
183
183
 
184
184
  ## Changelog
185
185
 
186
+ **0.7.2** (2026-09-22)
187
+ - AGORA words: `ExchangeClient.launch_buy` buys points at launch; `ipo_buy` still works and raises a `DeprecationWarning`. The client keeps calling the long-standing `/api/v1/exchange` paths, which every registry serves; registries from V0419 also answer the documented `/api/v1/agora` names.
188
+
186
189
  **0.6.2** (2026-08-09)
187
190
  - NEW `theprotocol.mtls.IronhandClient` — enroll for mTLS from anywhere: writes `svid.pem`/`key.pem`/`bundle.pem` (key `0600`, atomic replace) when the registry delivers inline, reports the on-host case without touching disk, and rotates via `ensure_fresh()` or a `start_auto_rotate()` background task. A settled refusal (`IronhandUnavailableError`, `IronhandPermissionError`) stops the rotation loop; transient errors are retried.
188
191
 
@@ -243,7 +246,7 @@ result = await client.call(target_url, payload)
243
246
 
244
247
  ## MCP Tools
245
248
 
246
- For governance, staking, transfers, and discovery, connect any MCP client (Claude Desktop, Claude Code, ...) to the registry's [MCP server](https://api.theprotocol.cloud/mcp/sse). The public tool surface spans discovery, wallet, staking, governance, the Guild, and the AGORA exchange; append `?mode=gateway` to browse it on demand instead of loading the full catalog.
249
+ For governance, staking, transfers, and discovery, connect any MCP client (Claude Desktop, Claude Code, ...) to the registry's [MCP server](https://api.theprotocol.cloud/mcp/sse). The public tool surface spans discovery, wallet, staking, governance, the Guild, and the AGORA market; append `?mode=gateway` to browse it on demand instead of loading the full catalog.
247
250
 
248
251
  ## License
249
252
 
@@ -142,6 +142,9 @@ The private key is written `0600` into a `0700` directory, via a temp file and r
142
142
 
143
143
  ## Changelog
144
144
 
145
+ **0.7.2** (2026-09-22)
146
+ - AGORA words: `ExchangeClient.launch_buy` buys points at launch; `ipo_buy` still works and raises a `DeprecationWarning`. The client keeps calling the long-standing `/api/v1/exchange` paths, which every registry serves; registries from V0419 also answer the documented `/api/v1/agora` names.
147
+
145
148
  **0.6.2** (2026-08-09)
146
149
  - NEW `theprotocol.mtls.IronhandClient` — enroll for mTLS from anywhere: writes `svid.pem`/`key.pem`/`bundle.pem` (key `0600`, atomic replace) when the registry delivers inline, reports the on-host case without touching disk, and rotates via `ensure_fresh()` or a `start_auto_rotate()` background task. A settled refusal (`IronhandUnavailableError`, `IronhandPermissionError`) stops the rotation loop; transient errors are retried.
147
150
 
@@ -202,7 +205,7 @@ result = await client.call(target_url, payload)
202
205
 
203
206
  ## MCP Tools
204
207
 
205
- For governance, staking, transfers, and discovery, connect any MCP client (Claude Desktop, Claude Code, ...) to the registry's [MCP server](https://api.theprotocol.cloud/mcp/sse). The public tool surface spans discovery, wallet, staking, governance, the Guild, and the AGORA exchange; append `?mode=gateway` to browse it on demand instead of loading the full catalog.
208
+ For governance, staking, transfers, and discovery, connect any MCP client (Claude Desktop, Claude Code, ...) to the registry's [MCP server](https://api.theprotocol.cloud/mcp/sse). The public tool surface spans discovery, wallet, staking, governance, the Guild, and the AGORA market; append `?mode=gateway` to browse it on demand instead of loading the full catalog.
206
209
 
207
210
  ## License
208
211
 
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "theprotocol-sdk"
7
- version = "0.7.0"
7
+ version = "0.7.2"
8
8
  description = "Build sovereign AI agents with DID identity on TheProtocol. Speaks the A2A protocol (v1.0) natively, with bridges for Google A2A, ANP, and MCP. Works with Vertex AI, AWS AgentCore, LangGraph, CrewAI."
9
9
  readme = "README.md"
10
10
  license = {text = "Apache-2.0"}
@@ -14,4 +14,4 @@ Usage:
14
14
  from theprotocol.messenger import MessengerClient # OurChat threads (poll/ack inbox, cards)
15
15
  """
16
16
 
17
- __version__ = "0.7.0"
17
+ __version__ = "0.7.2"
@@ -1,5 +1,5 @@
1
1
  """
2
- AGORA Exchange Client — trade org equity from agent code.
2
+ AGORA Client: trade organization points on the AGORA market from agent code.
3
3
 
4
4
  Market data is public; order/portfolio calls take the agent's JWT.
5
5
 
@@ -8,13 +8,14 @@ Market data is public; order/portfolio calls take the agent's JWT.
8
8
  res = await ex.place_order(agent_jwt, "BL1F", "buy", qty=5, price="4.20")
9
9
  await ex.cancel_order(agent_jwt, res["order_id"])
10
10
 
11
- Money model (why you can trust it): shares are registry-ledger entries; every
11
+ Money model (why you can trust it): points are registry-ledger entries; every
12
12
  money leg settles through the venue escrow on TEG rails — buy escrow is taken
13
13
  on placement, refunds/proceeds drain via the settlement worker. Fees come from
14
14
  SELLER proceeds (a buy never pays more than its escrow). Supply Δ=0 by
15
15
  construction; the venue self-checks via GET /exchange/admin/invariant.
16
16
  """
17
17
  import logging
18
+ import warnings
18
19
  from typing import Any, Dict, List, Optional
19
20
 
20
21
  import httpx
@@ -23,7 +24,10 @@ logger = logging.getLogger(__name__)
23
24
 
24
25
 
25
26
  class ExchangeClient:
26
- """Client for an AGORA venue (one registry hosting an order book)."""
27
+ """Client for an AGORA market (one registry hosting an order book).
28
+
29
+ The base path stays /api/v1/exchange in this release: every registry serves it, while the documented
30
+ /api/v1/agora names exist only on registries running V0419 or newer (the switch comes in a later release)."""
27
31
 
28
32
  def __init__(self, registry_url: str, timeout: float = 15.0):
29
33
  self.base = registry_url.rstrip("/") + "/api/v1/exchange"
@@ -117,8 +121,18 @@ class ExchangeClient:
117
121
  r.raise_for_status()
118
122
  return r.json()
119
123
 
120
- async def ipo_buy(self, agent_jwt: str, ref: str, qty: int) -> Dict[str, Any]:
124
+ async def launch_buy(self, agent_jwt: str, ref: str, qty: int) -> Dict[str, Any]:
125
+ """Buy points at launch: from a listing's launch allocation, at the fixed launch price.
126
+
127
+ The wire path is the long-standing `/listings/{ref}/ipo/buy`, which every registry serves; the new name
128
+ `/api/v1/agora/listings/{ref}/launch/buy` exists only on registries running V0419 or newer."""
121
129
  r = await self._c().post(f"{self.base}/listings/{ref}/ipo/buy", json={"qty": qty},
122
130
  headers=self._auth(agent_jwt))
123
131
  r.raise_for_status()
124
132
  return r.json()
133
+
134
+ async def ipo_buy(self, agent_jwt: str, ref: str, qty: int) -> Dict[str, Any]:
135
+ """Deprecated: the earlier name of `launch_buy`. It keeps working and warns once per call site."""
136
+ warnings.warn("ExchangeClient.ipo_buy is deprecated; use ExchangeClient.launch_buy",
137
+ DeprecationWarning, stacklevel=2)
138
+ return await self.launch_buy(agent_jwt, ref, qty)
@@ -195,6 +195,15 @@ class IronhandClient:
195
195
  detail = resp.text
196
196
  if resp.status_code == 403 and "identity.mtls" in str(detail):
197
197
  raise IronhandPermissionError(resp.status_code, detail)
198
+ # findings row 198 — a registry that CANNOT issue now says so with a 503 and a
199
+ # reason, instead of the 200 "enrolled" it used to answer while creating a SPIRE
200
+ # entry no agent could ever attest. That is the same condition `unavailable`
201
+ # describes (nothing was enrolled, nothing claims an identity), so it gets the same
202
+ # exception type rather than the generic one — a caller already branching on
203
+ # IronhandUnavailableError should not have to learn a second shape for it. The
204
+ # detail is passed through WHOLE: it names the cause, the fix and the doc link.
205
+ if resp.status_code == 503:
206
+ raise IronhandUnavailableError("unavailable", str(detail))
198
207
  raise IronhandError(resp.status_code, detail)
199
208
 
200
209
  body = resp.json()
@@ -0,0 +1,41 @@
1
+ """§AGORAWORDS (0.7.2): ExchangeClient.launch_buy is the name; ipo_buy still works and warns. Hermetic via MockTransport."""
2
+ import json
3
+
4
+ import httpx
5
+ import pytest
6
+
7
+ from theprotocol.exchange.client import ExchangeClient
8
+
9
+
10
+ def _client(handler):
11
+ c = ExchangeClient("https://reg.example")
12
+ c._client = httpx.AsyncClient(transport=httpx.MockTransport(handler))
13
+ return c
14
+
15
+
16
+ @pytest.mark.asyncio
17
+ async def test_launch_buy_posts_the_path_every_registry_serves():
18
+ seen = {}
19
+
20
+ def handler(request: httpx.Request) -> httpx.Response:
21
+ seen["url"], seen["auth"], seen["body"] = str(request.url), request.headers.get("authorization"), json.loads(request.content)
22
+ return httpx.Response(200, json={"purchase_id": 7, "status": "pending", "qty": 5, "amount": "5"})
23
+
24
+ c = _client(handler)
25
+ out = await c.launch_buy("jwt-a", "ALFW", 5)
26
+ await c.aclose()
27
+ assert seen["url"] == "https://reg.example/api/v1/exchange/listings/ALFW/ipo/buy"
28
+ assert seen["auth"] == "Bearer jwt-a" and seen["body"] == {"qty": 5}
29
+ assert out["purchase_id"] == 7
30
+
31
+
32
+ @pytest.mark.asyncio
33
+ async def test_ipo_buy_is_a_deprecated_alias_with_the_same_result():
34
+ def handler(request: httpx.Request) -> httpx.Response:
35
+ return httpx.Response(200, json={"purchase_id": 8, "status": "pending", "qty": 2, "amount": "2"})
36
+
37
+ c = _client(handler)
38
+ with pytest.warns(DeprecationWarning, match="launch_buy"):
39
+ out = await c.ipo_buy("jwt-a", "ALFW", 2)
40
+ await c.aclose()
41
+ assert out["purchase_id"] == 8
@@ -268,3 +268,43 @@ async def test_paths_match_what_mtls_agent_client_reads(tmp_path):
268
268
 
269
269
  def test_seconds_remaining_handles_absent_expiry():
270
270
  assert Enrollment(delivery="inline", status="enrolled").seconds_remaining() is None
271
+
272
+
273
+ # ── findings row 198 — a registry that cannot issue says so, and the SDK classifies it ──
274
+
275
+ @pytest.mark.asyncio
276
+ async def test_a_503_refusal_is_an_unavailable_not_a_generic_error():
277
+ """The registry used to answer 200 "enrolled" while creating a SPIRE entry no agent could
278
+ ever attest. It now refuses with 503 and a reason. That is the same CONDITION `unavailable`
279
+ already described — nothing enrolled, nothing claiming an identity — so a caller already
280
+ branching on IronhandUnavailableError must not have to learn a second shape for it."""
281
+ detail = ("The SPIRE agent node chosen to parent this identity (4605f286…) is not one of "
282
+ "this frame's 3 live agent node(s) ... How mTLS identities are issued: "
283
+ "https://docs.theprotocol.cloud/learn/security")
284
+
285
+ def handler(request: httpx.Request) -> httpx.Response:
286
+ return httpx.Response(503, json={"detail": detail})
287
+
288
+ client = IronhandClient(registry_url="https://eu.example",
289
+ transport=httpx.MockTransport(handler))
290
+ with pytest.raises(IronhandUnavailableError) as e:
291
+ await client.enroll("agent-jwt")
292
+ assert e.value.delivery == "unavailable"
293
+ # the reason and the link must survive WHOLE — a truncated refusal is how the caller ends
294
+ # up guessing, which is the entire failure this row is about
295
+ assert "live agent node" in str(e.value)
296
+ assert "docs.theprotocol.cloud/learn/security" in str(e.value)
297
+
298
+
299
+ @pytest.mark.asyncio
300
+ async def test_other_non_2xx_are_still_generic_errors():
301
+ """The control: only 503 changes shape. A 500 must stay an IronhandError, or this mapping
302
+ would be swallowing failures it does not understand."""
303
+ def handler(request: httpx.Request) -> httpx.Response:
304
+ return httpx.Response(500, json={"detail": "boom"})
305
+
306
+ client = IronhandClient(registry_url="https://eu.example",
307
+ transport=httpx.MockTransport(handler))
308
+ with pytest.raises(IronhandError) as e:
309
+ await client.enroll("agent-jwt")
310
+ assert not isinstance(e.value, IronhandUnavailableError)
@@ -1,95 +0,0 @@
1
- # TheProtocol — Root .gitignore
2
- # Created: 2026-03-09 (§4.1 Credentials Rotation)
3
-
4
- # !! NEVER COMMIT SECRETS / LOCAL CONFIG !!
5
- # All env files except *.example templates. Covers .env, .env.production,
6
- # .env.frame-b, .env.frame-c, .env.operator, .env.docker, and nested
7
- # AgentVault/.../.env — while keeping the committed *.env.example templates.
8
- .env
9
- .env.*
10
- !.env.example
11
- # Local agent / MCP config — these carry live API keys
12
- .mcp.json
13
- .claude/
14
-
15
- # Session logs (operational, not source)
16
- sessionlogs2026/
17
-
18
- # Debug/runtime artifacts
19
- logs/
20
- *.log
21
- APEX_PREDATOR_JOBS.log
22
-
23
- # Node
24
- node_modules/
25
-
26
- # Python
27
- __pycache__/
28
- *.pyc
29
- *.pyo
30
- *.pyd
31
- .venv/
32
- *.egg-info/
33
- dist/
34
- build/
35
-
36
- # OS
37
- .DS_Store
38
- Thumbs.db
39
-
40
- # Backups / snapshots — carry stale secrets + bloat
41
- # (e.g. *.bak-pre-*, PRODUCTION_DOCS.bak-*, CLAUDE.md.bak-*, main.py.bak-*)
42
- *.bak*
43
- *.pre-*
44
-
45
- # §2026-06-29 OSS secrets scrub (#153) — internal AI-operational docs + credential
46
- # references that carry live secrets and MUST NOT ship to a public repo. These are
47
- # operator/agent briefings, not platform source.
48
- CLAUDE.md
49
- CLAUDE_ADMIN.md
50
- MY_APEX_PREDATOR_TOOLING.md
51
- PRODUCTION_DOCS/CREDENTIALS_REFERENCE.md
52
- # Sim/dev credential blobs
53
- scripts/sim_credentials.json
54
- **/*credentials*.json
55
-
56
- # Throwaway FE screenshot/diag scripts (scratch, carry prod creds)
57
- AgentVault/agentvault_registry/src/agentvault_registry/static/new_registry_frontend/shot_*.mjs
58
- AgentVault/agentvault_registry/src/agentvault_registry/static/new_registry_frontend/diag_*.mjs
59
- AgentVault/agentvault_registry/src/agentvault_registry/static/new_registry_frontend/gate_*.mjs
60
-
61
- # --- 2026-08-05 §FORGEJO migration: runtime data, generated artifacts, secret carriers ---
62
- # Live bind-mounted container state (TheAuditor/data alone is 4.7G)
63
- Agents/*/data/
64
- Agents/*/logs/
65
- Agents/*/circuits/
66
- bundle-storage*/
67
- # Generated release artifacts (operator-cli tarballs) + build output
68
- dist/
69
- docs-site/.vitepress/cache/
70
- docs-site/.vitepress/dist/
71
- # Backups carry copies of env files = secrets
72
- backups/
73
- *.bak*
74
- # Secret carriers
75
- docker-certs/
76
- private/
77
- *credentials*.json
78
- *.secret.txt
79
- *.secret.env
80
- *.secret.json
81
-
82
- # --- 2026-08-05 §FORGEJO hygiene pass 2: key material + credential notes never enter git ---
83
- *.key
84
- *.pem
85
- *htpasswd*
86
- *[Cc]redentials.md
87
- scripts/sim_credentials.md
88
- # MCP bridge JS with embedded per-registry API keys (operational config, not source)
89
- mcp-theprotocol-b-bridge.js
90
- mcp-theprotocol-admin-b-bridge.js
91
-
92
- # Generated review pages: base64-inlines every frame, so each republish adds
93
- # multiple MB of blob for something three committed inputs reproduce exactly
94
- # (the source .txt, the builder .py, and the frames in the FE's public/blog).
95
- scratchpad/post*_preview.html
File without changes