peaky-peek-server 0.1.0__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 (170) hide show
  1. peaky_peek_server-0.1.0/.env.example +18 -0
  2. peaky_peek_server-0.1.0/.github/workflows/publish.yml +84 -0
  3. peaky_peek_server-0.1.0/.gitignore +30 -0
  4. peaky_peek_server-0.1.0/ARCHITECTURE.md +1084 -0
  5. peaky_peek_server-0.1.0/Dockerfile +31 -0
  6. peaky_peek_server-0.1.0/LEARNING.md +11 -0
  7. peaky_peek_server-0.1.0/PKG-INFO +195 -0
  8. peaky_peek_server-0.1.0/README.md +162 -0
  9. peaky_peek_server-0.1.0/SDK_README.md +157 -0
  10. peaky_peek_server-0.1.0/agent_debugger.db.backup +0 -0
  11. peaky_peek_server-0.1.0/agent_debugger_sdk/__init__.py +59 -0
  12. peaky_peek_server-0.1.0/agent_debugger_sdk/adapters/__init__.py +13 -0
  13. peaky_peek_server-0.1.0/agent_debugger_sdk/adapters/langchain.py +598 -0
  14. peaky_peek_server-0.1.0/agent_debugger_sdk/adapters/pydantic_ai.py +470 -0
  15. peaky_peek_server-0.1.0/agent_debugger_sdk/adapters/tests/__init__.py +1 -0
  16. peaky_peek_server-0.1.0/agent_debugger_sdk/adapters/tests/test_bug_fixes.py +317 -0
  17. peaky_peek_server-0.1.0/agent_debugger_sdk/adapters/tests/test_langchain.py +614 -0
  18. peaky_peek_server-0.1.0/agent_debugger_sdk/adapters/tests/test_pydantic_ai.py +291 -0
  19. peaky_peek_server-0.1.0/agent_debugger_sdk/auto_instrument.py +101 -0
  20. peaky_peek_server-0.1.0/agent_debugger_sdk/config.py +69 -0
  21. peaky_peek_server-0.1.0/agent_debugger_sdk/core/__init__.py +47 -0
  22. peaky_peek_server-0.1.0/agent_debugger_sdk/core/context.py +939 -0
  23. peaky_peek_server-0.1.0/agent_debugger_sdk/core/decorators.py +502 -0
  24. peaky_peek_server-0.1.0/agent_debugger_sdk/core/events.py +588 -0
  25. peaky_peek_server-0.1.0/agent_debugger_sdk/core/session.py +155 -0
  26. peaky_peek_server-0.1.0/agent_debugger_sdk/transport.py +96 -0
  27. peaky_peek_server-0.1.0/alembic.ini +38 -0
  28. peaky_peek_server-0.1.0/api/__init__.py +10 -0
  29. peaky_peek_server-0.1.0/api/auth_routes.py +106 -0
  30. peaky_peek_server-0.1.0/api/main.py +870 -0
  31. peaky_peek_server-0.1.0/auth/__init__.py +1 -0
  32. peaky_peek_server-0.1.0/auth/api_keys.py +45 -0
  33. peaky_peek_server-0.1.0/auth/middleware.py +67 -0
  34. peaky_peek_server-0.1.0/auth/models.py +42 -0
  35. peaky_peek_server-0.1.0/benchmarks/__init__.py +27 -0
  36. peaky_peek_server-0.1.0/benchmarks/seed_data.py +370 -0
  37. peaky_peek_server-0.1.0/collector/__init__.py +53 -0
  38. peaky_peek_server-0.1.0/collector/buffer.py +172 -0
  39. peaky_peek_server-0.1.0/collector/buffer_base.py +76 -0
  40. peaky_peek_server-0.1.0/collector/buffer_redis.py +236 -0
  41. peaky_peek_server-0.1.0/collector/intelligence.py +420 -0
  42. peaky_peek_server-0.1.0/collector/persistence.py +170 -0
  43. peaky_peek_server-0.1.0/collector/replay.py +208 -0
  44. peaky_peek_server-0.1.0/collector/scorer.py +128 -0
  45. peaky_peek_server-0.1.0/collector/server.py +424 -0
  46. peaky_peek_server-0.1.0/docs/README.md +49 -0
  47. peaky_peek_server-0.1.0/docs/architecture.md +135 -0
  48. peaky_peek_server-0.1.0/docs/decisions/ADR-001-product-positioning.md +26 -0
  49. peaky_peek_server-0.1.0/docs/decisions/ADR-002-deployment-model.md +52 -0
  50. peaky_peek_server-0.1.0/docs/decisions/ADR-003-pricing-strategy.md +28 -0
  51. peaky_peek_server-0.1.0/docs/decisions/ADR-004-target-users-framework-priority.md +53 -0
  52. peaky_peek_server-0.1.0/docs/decisions/ADR-005-architecture-for-scale.md +88 -0
  53. peaky_peek_server-0.1.0/docs/decisions/ADR-006-sdk-distribution-dx.md +119 -0
  54. peaky_peek_server-0.1.0/docs/decisions/ADR-007-replay-fidelity.md +23 -0
  55. peaky_peek_server-0.1.0/docs/decisions/ADR-008-security-auth-privacy.md +86 -0
  56. peaky_peek_server-0.1.0/docs/decisions/ADR-009-frontend-strategy.md +23 -0
  57. peaky_peek_server-0.1.0/docs/decisions/ADR-010-competitive-differentiation.md +28 -0
  58. peaky_peek_server-0.1.0/docs/decisions/ADR-011-build-sequence.md +120 -0
  59. peaky_peek_server-0.1.0/docs/decisions/ADR-012-assumptions-constraints.md +34 -0
  60. peaky_peek_server-0.1.0/docs/decisions/README.md +42 -0
  61. peaky_peek_server-0.1.0/docs/how-it-works.md +208 -0
  62. peaky_peek_server-0.1.0/docs/integration.md +178 -0
  63. peaky_peek_server-0.1.0/docs/intro.md +57 -0
  64. peaky_peek_server-0.1.0/docs/papers/README.md +29 -0
  65. peaky_peek_server-0.1.0/docs/papers/cxreasonagent-evidence-grounded-diagnostic-reasoning.md +63 -0
  66. peaky_peek_server-0.1.0/docs/papers/learning-when-to-act-or-refuse.md +66 -0
  67. peaky_peek_server-0.1.0/docs/papers/mssr-memory-aware-adaptive-replay.md +70 -0
  68. peaky_peek_server-0.1.0/docs/papers/neuroskill-proactive-real-time-agentic-system.md +62 -0
  69. peaky_peek_server-0.1.0/docs/papers/policy-parameterized-prompts.md +65 -0
  70. peaky_peek_server-0.1.0/docs/papers/towards-a-neural-debugger-for-python.md +72 -0
  71. peaky_peek_server-0.1.0/docs/progress.md +57 -0
  72. peaky_peek_server-0.1.0/docs/repo-overview.md +157 -0
  73. peaky_peek_server-0.1.0/docs/superpowers/plans/2026-03-23-agent-debugger-cloud-evolution.md +2637 -0
  74. peaky_peek_server-0.1.0/examples/mock_research_agent.py +148 -0
  75. peaky_peek_server-0.1.0/fly.toml +36 -0
  76. peaky_peek_server-0.1.0/frontend/.gitignore +17 -0
  77. peaky_peek_server-0.1.0/frontend/index.html +13 -0
  78. peaky_peek_server-0.1.0/frontend/package-lock.json +2635 -0
  79. peaky_peek_server-0.1.0/frontend/package.json +26 -0
  80. peaky_peek_server-0.1.0/frontend/src/App.css +1153 -0
  81. peaky_peek_server-0.1.0/frontend/src/App.tsx +1048 -0
  82. peaky_peek_server-0.1.0/frontend/src/api/client.ts +73 -0
  83. peaky_peek_server-0.1.0/frontend/src/components/ConversationPanel.tsx +132 -0
  84. peaky_peek_server-0.1.0/frontend/src/components/DecisionTree.tsx +332 -0
  85. peaky_peek_server-0.1.0/frontend/src/components/LLMViewer.tsx +58 -0
  86. peaky_peek_server-0.1.0/frontend/src/components/LiveSummaryPanel.tsx +142 -0
  87. peaky_peek_server-0.1.0/frontend/src/components/SessionComparisonPanel.tsx +178 -0
  88. peaky_peek_server-0.1.0/frontend/src/components/SessionReplay.tsx +287 -0
  89. peaky_peek_server-0.1.0/frontend/src/components/ToolInspector.tsx +116 -0
  90. peaky_peek_server-0.1.0/frontend/src/components/TraceTimeline.tsx +57 -0
  91. peaky_peek_server-0.1.0/frontend/src/hooks/useSSE.ts +146 -0
  92. peaky_peek_server-0.1.0/frontend/src/hooks/useTrace.ts +25 -0
  93. peaky_peek_server-0.1.0/frontend/src/main.tsx +9 -0
  94. peaky_peek_server-0.1.0/frontend/src/stores/sessionStore.ts +58 -0
  95. peaky_peek_server-0.1.0/frontend/src/types/index.ts +230 -0
  96. peaky_peek_server-0.1.0/frontend/tsconfig.json +24 -0
  97. peaky_peek_server-0.1.0/frontend/tsconfig.node.json +11 -0
  98. peaky_peek_server-0.1.0/frontend/vite.config.ts +12 -0
  99. peaky_peek_server-0.1.0/old_docs/README.md +49 -0
  100. peaky_peek_server-0.1.0/old_docs/architecture.md +160 -0
  101. peaky_peek_server-0.1.0/old_docs/console-workflows.md +142 -0
  102. peaky_peek_server-0.1.0/old_docs/decisions/ADR-001-product-positioning.md +26 -0
  103. peaky_peek_server-0.1.0/old_docs/decisions/ADR-002-deployment-model.md +52 -0
  104. peaky_peek_server-0.1.0/old_docs/decisions/ADR-003-pricing-strategy.md +28 -0
  105. peaky_peek_server-0.1.0/old_docs/decisions/ADR-004-target-users-framework-priority.md +53 -0
  106. peaky_peek_server-0.1.0/old_docs/decisions/ADR-005-architecture-for-scale.md +88 -0
  107. peaky_peek_server-0.1.0/old_docs/decisions/ADR-006-sdk-distribution-dx.md +119 -0
  108. peaky_peek_server-0.1.0/old_docs/decisions/ADR-007-replay-fidelity.md +23 -0
  109. peaky_peek_server-0.1.0/old_docs/decisions/ADR-008-security-auth-privacy.md +86 -0
  110. peaky_peek_server-0.1.0/old_docs/decisions/ADR-009-frontend-strategy.md +23 -0
  111. peaky_peek_server-0.1.0/old_docs/decisions/ADR-010-competitive-differentiation.md +28 -0
  112. peaky_peek_server-0.1.0/old_docs/decisions/ADR-011-build-sequence.md +120 -0
  113. peaky_peek_server-0.1.0/old_docs/decisions/ADR-012-assumptions-constraints.md +34 -0
  114. peaky_peek_server-0.1.0/old_docs/decisions/README.md +42 -0
  115. peaky_peek_server-0.1.0/old_docs/how-it-works.md +229 -0
  116. peaky_peek_server-0.1.0/old_docs/improvement-roadmap.md +103 -0
  117. peaky_peek_server-0.1.0/old_docs/integration.md +178 -0
  118. peaky_peek_server-0.1.0/old_docs/intro.md +57 -0
  119. peaky_peek_server-0.1.0/old_docs/lessons-learned.md +163 -0
  120. peaky_peek_server-0.1.0/old_docs/papers/README.md +29 -0
  121. peaky_peek_server-0.1.0/old_docs/papers/cxreasonagent-evidence-grounded-diagnostic-reasoning.md +63 -0
  122. peaky_peek_server-0.1.0/old_docs/papers/learning-when-to-act-or-refuse.md +66 -0
  123. peaky_peek_server-0.1.0/old_docs/papers/mssr-memory-aware-adaptive-replay.md +70 -0
  124. peaky_peek_server-0.1.0/old_docs/papers/neuroskill-proactive-real-time-agentic-system.md +62 -0
  125. peaky_peek_server-0.1.0/old_docs/papers/policy-parameterized-prompts.md +65 -0
  126. peaky_peek_server-0.1.0/old_docs/papers/towards-a-neural-debugger-for-python.md +72 -0
  127. peaky_peek_server-0.1.0/old_docs/progress.md +97 -0
  128. peaky_peek_server-0.1.0/old_docs/repo-overview.md +191 -0
  129. peaky_peek_server-0.1.0/old_docs/research-implementation-plan.md +339 -0
  130. peaky_peek_server-0.1.0/old_docs/research-inspiration.md +45 -0
  131. peaky_peek_server-0.1.0/old_docs/superpowers/plans/2026-03-23-agent-debugger-cloud-evolution.md +2637 -0
  132. peaky_peek_server-0.1.0/pyproject-server.toml +55 -0
  133. peaky_peek_server-0.1.0/pyproject.toml +55 -0
  134. peaky_peek_server-0.1.0/redaction/__init__.py +1 -0
  135. peaky_peek_server-0.1.0/redaction/patterns.py +18 -0
  136. peaky_peek_server-0.1.0/redaction/pipeline.py +64 -0
  137. peaky_peek_server-0.1.0/scripts/seed_demo_sessions.py +94 -0
  138. peaky_peek_server-0.1.0/storage/__init__.py +16 -0
  139. peaky_peek_server-0.1.0/storage/engine.py +28 -0
  140. peaky_peek_server-0.1.0/storage/migrations/env.py +47 -0
  141. peaky_peek_server-0.1.0/storage/migrations/script.py.mako +26 -0
  142. peaky_peek_server-0.1.0/storage/migrations/versions/001_initial_schema.py +76 -0
  143. peaky_peek_server-0.1.0/storage/models.py +91 -0
  144. peaky_peek_server-0.1.0/storage/repository.py +754 -0
  145. peaky_peek_server-0.1.0/storage/retention.py +31 -0
  146. peaky_peek_server-0.1.0/test_integration.py +227 -0
  147. peaky_peek_server-0.1.0/test_research_workflows.py +96 -0
  148. peaky_peek_server-0.1.0/tests/conftest.py +12 -0
  149. peaky_peek_server-0.1.0/tests/test_api_auth.py +41 -0
  150. peaky_peek_server-0.1.0/tests/test_api_contract.py +208 -0
  151. peaky_peek_server-0.1.0/tests/test_app_config.py +20 -0
  152. peaky_peek_server-0.1.0/tests/test_auth.py +24 -0
  153. peaky_peek_server-0.1.0/tests/test_auth_routes.py +69 -0
  154. peaky_peek_server-0.1.0/tests/test_auto_instrument.py +116 -0
  155. peaky_peek_server-0.1.0/tests/test_buffer_interface.py +72 -0
  156. peaky_peek_server-0.1.0/tests/test_buffer_redis.py +247 -0
  157. peaky_peek_server-0.1.0/tests/test_e2e_cloud.py +49 -0
  158. peaky_peek_server-0.1.0/tests/test_e2e_local.py +79 -0
  159. peaky_peek_server-0.1.0/tests/test_engine_factory.py +26 -0
  160. peaky_peek_server-0.1.0/tests/test_graceful_degradation.py +28 -0
  161. peaky_peek_server-0.1.0/tests/test_health.py +24 -0
  162. peaky_peek_server-0.1.0/tests/test_model_extraction.py +15 -0
  163. peaky_peek_server-0.1.0/tests/test_package.py +13 -0
  164. peaky_peek_server-0.1.0/tests/test_redaction.py +45 -0
  165. peaky_peek_server-0.1.0/tests/test_redaction_integration.py +20 -0
  166. peaky_peek_server-0.1.0/tests/test_research_features.py +286 -0
  167. peaky_peek_server-0.1.0/tests/test_retention.py +29 -0
  168. peaky_peek_server-0.1.0/tests/test_sdk_config.py +54 -0
  169. peaky_peek_server-0.1.0/tests/test_sdk_transport.py +81 -0
  170. peaky_peek_server-0.1.0/tests/test_tenant_isolation.py +45 -0
@@ -0,0 +1,18 @@
1
+ # .env.example — Copy to .env and fill in values
2
+
3
+ # Database (required for cloud mode)
4
+ AGENT_DEBUGGER_DB_URL=postgresql+asyncpg://user:pass@host:5432/agent_debugger
5
+
6
+ # Redis (optional, for horizontal scaling)
7
+ REDIS_URL=redis://localhost:6379
8
+
9
+ # Mode
10
+ AGENT_DEBUGGER_MODE=cloud
11
+
12
+ # AWS S3 (optional, for large payload storage)
13
+ # AWS_ACCESS_KEY_ID=...
14
+ # AWS_SECRET_ACCESS_KEY=...
15
+ # S3_BUCKET=agent-debugger-payloads
16
+
17
+ # API Keys for external services (optional)
18
+ # OPENAI_API_KEY=sk-...
@@ -0,0 +1,84 @@
1
+ name: Publish to PyPI
2
+
3
+ on:
4
+ push:
5
+ tags:
6
+ - "sdk-v*" # triggers SDK-only publish → peaky-peek
7
+ - "server-v*" # triggers server publish → peaky-peek-server
8
+ - "v*" # triggers both
9
+
10
+ permissions:
11
+ contents: read
12
+ id-token: write # required for PyPI trusted publishing (OIDC)
13
+
14
+ jobs:
15
+ # ─────────────────────────────────────────────
16
+ # peaky-peek (SDK only)
17
+ # ─────────────────────────────────────────────
18
+ publish-sdk:
19
+ name: Publish peaky-peek (SDK)
20
+ runs-on: ubuntu-latest
21
+ if: startsWith(github.ref_name, 'sdk-v') || startsWith(github.ref_name, 'v')
22
+ environment:
23
+ name: pypi-sdk
24
+ url: https://pypi.org/project/peaky-peek/
25
+
26
+ steps:
27
+ - uses: actions/checkout@v4
28
+
29
+ - uses: actions/setup-python@v5
30
+ with:
31
+ python-version: "3.12"
32
+
33
+ - name: Install build tools
34
+ run: pip install build
35
+
36
+ - name: Build peaky-peek wheel + sdist
37
+ run: python -m build
38
+ # pyproject.toml at root already targets peaky-peek / agent_debugger_sdk only
39
+
40
+ - name: Publish to PyPI
41
+ uses: pypa/gh-action-pypi-publish@release/v1
42
+ # No token needed — uses OIDC trusted publishing.
43
+ # Configure on PyPI: https://pypi.org/manage/account/publishing/
44
+ # Publisher: GitHub Actions
45
+ # Owner: acailic
46
+ # Repo: agent_debugger
47
+ # Workflow: publish.yml
48
+ # Env name: pypi-sdk
49
+
50
+ # ─────────────────────────────────────────────
51
+ # peaky-peek-server (full stack)
52
+ # ─────────────────────────────────────────────
53
+ publish-server:
54
+ name: Publish peaky-peek-server
55
+ runs-on: ubuntu-latest
56
+ if: startsWith(github.ref_name, 'server-v') || startsWith(github.ref_name, 'v')
57
+ environment:
58
+ name: pypi-server
59
+ url: https://pypi.org/project/peaky-peek-server/
60
+
61
+ steps:
62
+ - uses: actions/checkout@v4
63
+
64
+ - uses: actions/setup-python@v5
65
+ with:
66
+ python-version: "3.12"
67
+
68
+ - name: Install build tools
69
+ run: pip install build
70
+
71
+ - name: Swap in server pyproject for build
72
+ run: cp pyproject-server.toml pyproject.toml
73
+
74
+ - name: Build peaky-peek-server wheel + sdist
75
+ run: python -m build
76
+
77
+ - name: Publish to PyPI
78
+ uses: pypa/gh-action-pypi-publish@release/v1
79
+ # Configure on PyPI: https://pypi.org/manage/account/publishing/
80
+ # Publisher: GitHub Actions
81
+ # Owner: acailic
82
+ # Repo: agent_debugger
83
+ # Workflow: publish.yml
84
+ # Env name: pypi-server
@@ -0,0 +1,30 @@
1
+ __pycache__/
2
+ *.py[cod]
3
+
4
+ .venv/
5
+ venv/
6
+ .python-version
7
+
8
+ .pytest_cache/
9
+ .mypy_cache/
10
+ .ruff_cache/
11
+
12
+ .DS_Store
13
+
14
+ # Local runtime artifacts
15
+ *.db
16
+ *.db-shm
17
+ *.db-wal
18
+ .tmp-*
19
+
20
+ # Environment variables
21
+ .env
22
+ .env.local
23
+ .env.*.local
24
+
25
+ # Frontend dependencies and build output
26
+ frontend/node_modules/
27
+ frontend/dist/
28
+
29
+ # Worktrees
30
+ .worktrees/