bmad-plus 0.8.0 → 0.9.1

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 (213) hide show
  1. package/CHANGELOG.md +45 -1
  2. package/LICENSE +21 -21
  3. package/README.md +107 -85
  4. package/osint-agent-package/README.md +88 -88
  5. package/osint-agent-package/SETUP_KEYS.md +108 -108
  6. package/osint-agent-package/agents/osint-investigator.md +80 -80
  7. package/osint-agent-package/install.ps1 +87 -87
  8. package/osint-agent-package/install.sh +76 -76
  9. package/osint-agent-package/skills/bmad-osint-investigate/SKILL.md +147 -147
  10. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/enrichment-databases-fr.md +148 -148
  11. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/_http.py +101 -101
  12. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/apify.py +266 -266
  13. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/brightdata.py +101 -101
  14. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/diagnose.py +141 -141
  15. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/exa.py +79 -79
  16. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/jina.py +71 -71
  17. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/parallel.py +85 -85
  18. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/perplexity.py +102 -102
  19. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/tavily.py +72 -72
  20. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/volley.py +208 -208
  21. package/osint-agent-package/skills/bmad-osint-investigator/SKILL.md +15 -15
  22. package/package.json +30 -3
  23. package/readme-international/README.de.md +18 -5
  24. package/readme-international/README.es.md +40 -12
  25. package/readme-international/README.fr.md +36 -8
  26. package/src/bmad-plus/agents/agent-architect-dev/SKILL.md +96 -96
  27. package/src/bmad-plus/agents/agent-architect-dev/bmad-skill-manifest.yaml +13 -13
  28. package/src/bmad-plus/agents/agent-maker/SKILL.md +201 -201
  29. package/src/bmad-plus/agents/agent-maker/bmad-skill-manifest.yaml +13 -13
  30. package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +137 -137
  31. package/src/bmad-plus/agents/agent-orchestrator/bmad-skill-manifest.yaml +13 -13
  32. package/src/bmad-plus/agents/agent-quality/SKILL.md +83 -83
  33. package/src/bmad-plus/agents/agent-quality/bmad-skill-manifest.yaml +13 -13
  34. package/src/bmad-plus/agents/agent-shadow/SKILL.md +71 -71
  35. package/src/bmad-plus/agents/agent-shadow/bmad-skill-manifest.yaml +13 -13
  36. package/src/bmad-plus/agents/agent-strategist/SKILL.md +80 -80
  37. package/src/bmad-plus/agents/agent-strategist/bmad-skill-manifest.yaml +13 -13
  38. package/src/bmad-plus/data/role-triggers.yaml +209 -209
  39. package/src/bmad-plus/module-help.csv +10 -10
  40. package/src/bmad-plus/packs/pack-memory/README.md +106 -106
  41. package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +79 -79
  42. package/src/bmad-plus/packs/pack-memory/shared/karpathy-guardrails.md +86 -86
  43. package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md +143 -143
  44. package/src/bmad-plus/packs/pack-memory/templates/context.md +39 -39
  45. package/src/bmad-plus/packs/pack-memory/templates/decisions.md +25 -25
  46. package/src/bmad-plus/packs/pack-memory/templates/identity.yaml +39 -39
  47. package/src/bmad-plus/packs/pack-memory/templates/lessons.md +31 -31
  48. package/src/bmad-plus/packs/pack-memory/templates/patterns.md +24 -24
  49. package/src/bmad-plus/packs/pack-memory/templates/session-handoff.md +25 -25
  50. package/src/bmad-plus/packs/pack-memory/zecher-agent.md +157 -157
  51. package/src/bmad-plus/packs/pack-seo/bmad-skill-manifest.yaml +13 -0
  52. package/src/bmad-plus/packs/pack-shield/README.md +110 -110
  53. package/src/bmad-plus/packs/pack-shield/SKILL.md +82 -0
  54. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/csrd-agent.md +251 -251
  55. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/section508-agent.md +168 -168
  56. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/wcag-agent.md +190 -190
  57. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/eu-ai-act-agent.md +86 -86
  58. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/iso42001-agent.md +240 -240
  59. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/nist-ai-rmf-agent.md +122 -122
  60. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/cis-controls-agent.md +210 -210
  61. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/ism-agent.md +139 -139
  62. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/iso27001-agent.md +156 -156
  63. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nis2-agent.md +72 -72
  64. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-800-53-agent.md +239 -239
  65. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-csf-agent.md +207 -207
  66. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/ccpa-agent.md +94 -94
  67. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/dpdpa-agent.md +136 -136
  68. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/gdpr-agent.md +296 -296
  69. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/iso27701-agent.md +134 -134
  70. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/lgpd-agent.md +129 -129
  71. package/src/bmad-plus/packs/pack-shield/categories/defense-export/cmmc-agent.md +116 -116
  72. package/src/bmad-plus/packs/pack-shield/categories/defense-export/ear-agent.md +261 -261
  73. package/src/bmad-plus/packs/pack-shield/categories/defense-export/itar-agent.md +191 -191
  74. package/src/bmad-plus/packs/pack-shield/categories/defense-export/tsa-agent.md +356 -356
  75. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/dora-agent.md +499 -499
  76. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/fedramp-agent.md +236 -236
  77. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/hipaa-agent.md +162 -162
  78. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/pci-dss-agent.md +228 -228
  79. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/soc2-agent.md +255 -255
  80. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/swift-csp-agent.md +153 -153
  81. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-classifier.md +131 -131
  82. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-fria.md +155 -155
  83. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-incidents.md +187 -187
  84. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-roles.md +113 -113
  85. package/src/bmad-plus/packs/pack-shield/categories/workflows/breach-sentinel.md +197 -197
  86. package/src/bmad-plus/packs/pack-shield/categories/workflows/cookie-policy-gen.md +180 -180
  87. package/src/bmad-plus/packs/pack-shield/categories/workflows/dpia-sentinel.md +235 -235
  88. package/src/bmad-plus/packs/pack-shield/categories/workflows/legitimate-interest.md +159 -159
  89. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-advisor.md +133 -133
  90. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-notice-gen.md +160 -160
  91. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-policy-gen.md +135 -135
  92. package/src/bmad-plus/packs/pack-shield/references/ccpa/ccpa-gdpr-comparison.md +117 -117
  93. package/src/bmad-plus/packs/pack-shield/references/ccpa/consumer-rights-workflows.md +177 -177
  94. package/src/bmad-plus/packs/pack-shield/references/cis-controls/framework-mappings.md +162 -162
  95. package/src/bmad-plus/packs/pack-shield/references/cis-controls/implementation-guidance.md +235 -235
  96. package/src/bmad-plus/packs/pack-shield/references/cis-controls/safeguards-detail.md +252 -252
  97. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-assessment.md +170 -170
  98. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-levels.md +113 -113
  99. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-practices.md +211 -211
  100. package/src/bmad-plus/packs/pack-shield/references/csrd/compliance-program.md +281 -281
  101. package/src/bmad-plus/packs/pack-shield/references/csrd/double-materiality.md +253 -253
  102. package/src/bmad-plus/packs/pack-shield/references/csrd/esrs-standards.md +401 -401
  103. package/src/bmad-plus/packs/pack-shield/references/dora/article-reference.md +441 -441
  104. package/src/bmad-plus/packs/pack-shield/references/dora/incident-classification.md +297 -297
  105. package/src/bmad-plus/packs/pack-shield/references/dora/rts-its-guide.md +306 -306
  106. package/src/bmad-plus/packs/pack-shield/references/dora/third-party-risk.md +349 -349
  107. package/src/bmad-plus/packs/pack-shield/references/dpdpa/gdpr-comparison.md +173 -173
  108. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rights-and-obligations.md +426 -426
  109. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rules-2025.md +599 -599
  110. package/src/bmad-plus/packs/pack-shield/references/dpdpa/sections-reference.md +319 -319
  111. package/src/bmad-plus/packs/pack-shield/references/ear/ccl-eccn-guide.md +250 -250
  112. package/src/bmad-plus/packs/pack-shield/references/ear/compliance-program.md +280 -280
  113. package/src/bmad-plus/packs/pack-shield/references/ear/license-exceptions.md +207 -207
  114. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/gpai-governance.md +267 -267
  115. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/obligations-high-risk.md +287 -287
  116. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/risk-classification.md +182 -182
  117. package/src/bmad-plus/packs/pack-shield/references/fedramp/appendices-guide.md +209 -209
  118. package/src/bmad-plus/packs/pack-shield/references/fedramp/control-families.md +281 -281
  119. package/src/bmad-plus/packs/pack-shield/references/fedramp/poam-guide.md +93 -93
  120. package/src/bmad-plus/packs/pack-shield/references/fedramp/readiness-checklist.md +134 -134
  121. package/src/bmad-plus/packs/pack-shield/references/fedramp/sap-sar-guide.md +86 -86
  122. package/src/bmad-plus/packs/pack-shield/references/fedramp/ssp-guide.md +129 -129
  123. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/documents.md +192 -192
  124. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/dpa-template.md +121 -121
  125. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/privacy-notice.md +87 -87
  126. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/breach-notification.md +293 -293
  127. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/privacy-rule.md +276 -276
  128. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/security-rule.md +299 -299
  129. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/templates.md +568 -568
  130. package/src/bmad-plus/packs/pack-shield/references/ism/control-applicability.md +181 -181
  131. package/src/bmad-plus/packs/pack-shield/references/ism/guidelines-overview.md +183 -183
  132. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2013.md +203 -203
  133. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2022.md +132 -132
  134. package/src/bmad-plus/packs/pack-shield/references/iso27001/control-mapping.md +153 -153
  135. package/src/bmad-plus/packs/pack-shield/references/iso27701/annex-a-controls.md +195 -195
  136. package/src/bmad-plus/packs/pack-shield/references/iso27701/regulatory-mapping.md +229 -229
  137. package/src/bmad-plus/packs/pack-shield/references/iso27701/transition-guide.md +219 -219
  138. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-ai-risk-assessment.md +258 -258
  139. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-clauses-requirements.md +279 -279
  140. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-controls-annex-a.md +155 -155
  141. package/src/bmad-plus/packs/pack-shield/references/itar/compliance-program.md +174 -174
  142. package/src/bmad-plus/packs/pack-shield/references/itar/licensing-guide.md +146 -146
  143. package/src/bmad-plus/packs/pack-shield/references/itar/usml-categories.md +93 -93
  144. package/src/bmad-plus/packs/pack-shield/references/lgpd/anpd-enforcement.md +147 -147
  145. package/src/bmad-plus/packs/pack-shield/references/lgpd/compliance-program.md +272 -272
  146. package/src/bmad-plus/packs/pack-shield/references/lgpd/lgpd-articles.md +271 -271
  147. package/src/bmad-plus/packs/pack-shield/references/nis2/article-21-measures.md +153 -153
  148. package/src/bmad-plus/packs/pack-shield/references/nis2/iso27001-nis2-mapping.md +68 -68
  149. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/assessment-rmf.md +349 -349
  150. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/baselines-tailoring.md +277 -277
  151. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/control-families.md +450 -450
  152. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-core.md +361 -361
  153. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-profiles.md +192 -192
  154. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-10-to-20-mapping.md +143 -143
  155. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-20-functions-categories.md +278 -278
  156. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-implementation-tiers.md +135 -135
  157. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-requirements.md +366 -366
  158. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-saq-guide.md +217 -217
  159. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-v4-changes.md +190 -190
  160. package/src/bmad-plus/packs/pack-shield/references/section-508/wcag-mapping.md +160 -160
  161. package/src/bmad-plus/packs/pack-shield/references/soc2/controls.md +241 -241
  162. package/src/bmad-plus/packs/pack-shield/references/soc2/evidence.md +236 -236
  163. package/src/bmad-plus/packs/pack-shield/references/soc2/policies.md +254 -254
  164. package/src/bmad-plus/packs/pack-shield/references/soc2/vendor.md +276 -276
  165. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-assessment.md +202 -202
  166. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-controls.md +545 -545
  167. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-crmp-requirements.md +359 -359
  168. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-directives-overview.md +187 -187
  169. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-incident-reporting.md +187 -187
  170. package/src/bmad-plus/packs/pack-shield/references/wcag/criteria-detail.md +510 -510
  171. package/src/bmad-plus/packs/pack-shield/shared/audit-report-template.md +103 -103
  172. package/src/bmad-plus/packs/pack-shield/shared/cross-framework-mapper.md +103 -103
  173. package/src/bmad-plus/packs/pack-shield/shared/gap-analysis-template.md +83 -83
  174. package/src/bmad-plus/packs/pack-shield/shield-orchestrator.md +229 -229
  175. package/src/bmad-plus/packs/pack-shield/upstream-sync.yaml +68 -68
  176. package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +99 -99
  177. package/src/bmad-plus/skills/bmad-plus-parallel/SKILL.md +93 -93
  178. package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md +69 -69
  179. package/tools/bmad-plus-npx.js +3 -5
  180. package/tools/cli/bmad-plus-cli.js +5 -3
  181. package/tools/cli/commands/autoconfig.js +18 -61
  182. package/tools/cli/commands/doctor.js +30 -31
  183. package/tools/cli/commands/install.js +33 -343
  184. package/tools/cli/commands/memory.js +1 -0
  185. package/tools/cli/commands/scan.js +61 -74
  186. package/tools/cli/commands/uninstall.js +7 -4
  187. package/tools/cli/commands/update.js +15 -72
  188. package/tools/cli/i18n.js +92 -10
  189. package/tools/cli/lib/ide-config.js +259 -0
  190. package/tools/cli/lib/memory-init.js +113 -0
  191. package/tools/cli/lib/pack-copy.js +84 -0
  192. package/tools/cli/lib/packs.js +114 -0
  193. package/tools/cli/lib/stack-detect.js +102 -0
  194. package/tools/cli/lib/validate.js +45 -0
  195. package/src/bmad-plus/agents/pack-animated/animated-website-agent.md +0 -325
  196. package/src/bmad-plus/agents/pack-animated/templates/animated-website-workflow.md +0 -55
  197. package/src/bmad-plus/agents/pack-backup/backup-agent.md +0 -71
  198. package/src/bmad-plus/agents/pack-backup/templates/backup-workflow.md +0 -51
  199. package/src/bmad-plus/agents/pack-seo/SKILL.md +0 -171
  200. package/src/bmad-plus/agents/pack-seo/checklist.md +0 -140
  201. package/src/bmad-plus/agents/pack-seo/pagespeed-playbook.md +0 -320
  202. package/src/bmad-plus/agents/pack-seo/ref/audit-schema.json +0 -187
  203. package/src/bmad-plus/agents/pack-seo/ref/cwv-thresholds.md +0 -87
  204. package/src/bmad-plus/agents/pack-seo/ref/eeat-criteria.md +0 -123
  205. package/src/bmad-plus/agents/pack-seo/ref/geo-signals.md +0 -167
  206. package/src/bmad-plus/agents/pack-seo/ref/hreflang-rules.md +0 -153
  207. package/src/bmad-plus/agents/pack-seo/ref/quality-gates.md +0 -133
  208. package/src/bmad-plus/agents/pack-seo/ref/schema-catalog.md +0 -91
  209. package/src/bmad-plus/agents/pack-seo/ref/schema-templates.json +0 -356
  210. package/src/bmad-plus/agents/pack-seo/seo-chief.md +0 -294
  211. package/src/bmad-plus/agents/pack-seo/seo-judge.md +0 -241
  212. package/src/bmad-plus/agents/pack-seo/seo-scout.md +0 -171
  213. package/src/bmad-plus/agents/pack-seo/templates/seo-audit-workflow.md +0 -241
@@ -1,71 +1,71 @@
1
- #!/usr/bin/env python3
2
- """Jina AI — read URLs, search, deep search. Stdlib only."""
3
-
4
- import json
5
- import os
6
- import sys
7
-
8
- sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
9
- from _http import https_request, get_key, get_workspace
10
-
11
-
12
- def init():
13
- workspace, _, _ = get_workspace()
14
- return get_key("JINA_API_KEY",
15
- file_fallback=os.path.join(workspace, "scripts", "jina-api-key.txt"),
16
- help_url="https://jina.ai/api-key")
17
-
18
-
19
- def read_url(token, url):
20
- """URL → clean markdown."""
21
- status, _, data = https_request("GET", f"https://r.jina.ai/{url}",
22
- headers={"Authorization": f"Bearer {token}",
23
- "Accept": "application/json"})
24
- print(data[:5000])
25
-
26
-
27
- def search(token, query):
28
- """Web search → markdown results."""
29
- from urllib.parse import quote
30
- status, _, data = https_request("GET", f"https://s.jina.ai/{quote(query)}",
31
- headers={"Authorization": f"Bearer {token}",
32
- "Accept": "application/json"})
33
- print(data[:5000])
34
-
35
-
36
- def deepsearch(token, query):
37
- """Deep research with AI reasoning."""
38
- import json as j
39
- status, _, data = https_request("POST", "https://deepsearch.jina.ai",
40
- headers={"Authorization": f"Bearer {token}",
41
- "Content-Type": "application/json",
42
- "Accept": "application/json"},
43
- body=j.dumps({"query": query}),
44
- timeout=300)
45
- print(data[:5000])
46
-
47
-
48
- def main():
49
- if len(sys.argv) < 3:
50
- print("Usage: jina.py read|search|deepsearch <arg>")
51
- print()
52
- print(" read <url> - any URL → clean markdown")
53
- print(" search <query> - web search → markdown (10 results)")
54
- print(" deepsearch <q> - deep research with AI reasoning")
55
- sys.exit(1)
56
- token = init()
57
- cmd = sys.argv[1]
58
- arg = " ".join(sys.argv[2:])
59
- if cmd == "read":
60
- read_url(token, arg)
61
- elif cmd == "search":
62
- search(token, arg)
63
- elif cmd == "deepsearch":
64
- deepsearch(token, arg)
65
- else:
66
- print(f"Unknown: {cmd} (use read|search|deepsearch)", file=sys.stderr)
67
- sys.exit(1)
68
-
69
-
70
- if __name__ == "__main__":
71
- main()
1
+ #!/usr/bin/env python3
2
+ """Jina AI — read URLs, search, deep search. Stdlib only."""
3
+
4
+ import json
5
+ import os
6
+ import sys
7
+
8
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
9
+ from _http import https_request, get_key, get_workspace
10
+
11
+
12
+ def init():
13
+ workspace, _, _ = get_workspace()
14
+ return get_key("JINA_API_KEY",
15
+ file_fallback=os.path.join(workspace, "scripts", "jina-api-key.txt"),
16
+ help_url="https://jina.ai/api-key")
17
+
18
+
19
+ def read_url(token, url):
20
+ """URL → clean markdown."""
21
+ status, _, data = https_request("GET", f"https://r.jina.ai/{url}",
22
+ headers={"Authorization": f"Bearer {token}",
23
+ "Accept": "application/json"})
24
+ print(data[:5000])
25
+
26
+
27
+ def search(token, query):
28
+ """Web search → markdown results."""
29
+ from urllib.parse import quote
30
+ status, _, data = https_request("GET", f"https://s.jina.ai/{quote(query)}",
31
+ headers={"Authorization": f"Bearer {token}",
32
+ "Accept": "application/json"})
33
+ print(data[:5000])
34
+
35
+
36
+ def deepsearch(token, query):
37
+ """Deep research with AI reasoning."""
38
+ import json as j
39
+ status, _, data = https_request("POST", "https://deepsearch.jina.ai",
40
+ headers={"Authorization": f"Bearer {token}",
41
+ "Content-Type": "application/json",
42
+ "Accept": "application/json"},
43
+ body=j.dumps({"query": query}),
44
+ timeout=300)
45
+ print(data[:5000])
46
+
47
+
48
+ def main():
49
+ if len(sys.argv) < 3:
50
+ print("Usage: jina.py read|search|deepsearch <arg>")
51
+ print()
52
+ print(" read <url> - any URL → clean markdown")
53
+ print(" search <query> - web search → markdown (10 results)")
54
+ print(" deepsearch <q> - deep research with AI reasoning")
55
+ sys.exit(1)
56
+ token = init()
57
+ cmd = sys.argv[1]
58
+ arg = " ".join(sys.argv[2:])
59
+ if cmd == "read":
60
+ read_url(token, arg)
61
+ elif cmd == "search":
62
+ search(token, arg)
63
+ elif cmd == "deepsearch":
64
+ deepsearch(token, arg)
65
+ else:
66
+ print(f"Unknown: {cmd} (use read|search|deepsearch)", file=sys.stderr)
67
+ sys.exit(1)
68
+
69
+
70
+ if __name__ == "__main__":
71
+ main()
@@ -1,85 +1,85 @@
1
- #!/usr/bin/env python3
2
- """Parallel AI — search, extract, task. Stdlib only."""
3
-
4
- import json
5
- import os
6
- import sys
7
-
8
- sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
9
- from _http import api_post, https_request, get_key, get_workspace
10
-
11
- BASE = "https://api.parallel.ai/v1beta"
12
- BETA_HEADER = "parallel-beta"
13
- BETA_VALUE = "search-extract-2025-10-10"
14
-
15
-
16
- def init():
17
- workspace, _, _ = get_workspace()
18
- return get_key("PARALLEL_API_KEY",
19
- file_fallback=os.path.join(workspace, "scripts", "parallel-api-key.txt"),
20
- help_url="https://platform.parallel.ai")
21
-
22
-
23
- def search(token, query):
24
- """AI-powered web search with LLM-optimized excerpts."""
25
- data = api_post(f"{BASE}/search", {
26
- "objective": query,
27
- "search_queries": [query],
28
- "max_results": 10,
29
- "excerpts": {"max_chars_per_result": 5000},
30
- }, headers={
31
- "x-api-key": token,
32
- BETA_HEADER: BETA_VALUE,
33
- })
34
- if data:
35
- print(json.dumps(data, indent=2, ensure_ascii=False)[:5000])
36
-
37
-
38
- def extract(token, url):
39
- """URL → clean markdown (JS-heavy, PDF)."""
40
- data = api_post(f"{BASE}/extract", {
41
- "url": url,
42
- "full_content": True,
43
- }, headers={
44
- "x-api-key": token,
45
- BETA_HEADER: BETA_VALUE,
46
- })
47
- if data:
48
- print(json.dumps(data, indent=2, ensure_ascii=False)[:5000])
49
-
50
-
51
- def task(token, task_text):
52
- """Complex research task with structured output."""
53
- data = api_post(f"{BASE}/task", {
54
- "task": task_text,
55
- }, headers={
56
- "x-api-key": token,
57
- })
58
- if data:
59
- print(json.dumps(data, indent=2, ensure_ascii=False)[:5000])
60
-
61
-
62
- def main():
63
- if len(sys.argv) < 3:
64
- print("Usage: parallel.py search|extract|task <arg>")
65
- print()
66
- print(" search <query> - AI-powered web search")
67
- print(" extract <url> - URL → clean markdown")
68
- print(" task <task> - Complex research task")
69
- sys.exit(1)
70
- token = init()
71
- cmd = sys.argv[1]
72
- arg = " ".join(sys.argv[2:])
73
- if cmd == "search":
74
- search(token, arg)
75
- elif cmd == "extract":
76
- extract(token, arg)
77
- elif cmd == "task":
78
- task(token, arg)
79
- else:
80
- print(f"Unknown: {cmd} (use search|extract|task)", file=sys.stderr)
81
- sys.exit(1)
82
-
83
-
84
- if __name__ == "__main__":
85
- main()
1
+ #!/usr/bin/env python3
2
+ """Parallel AI — search, extract, task. Stdlib only."""
3
+
4
+ import json
5
+ import os
6
+ import sys
7
+
8
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
9
+ from _http import api_post, https_request, get_key, get_workspace
10
+
11
+ BASE = "https://api.parallel.ai/v1beta"
12
+ BETA_HEADER = "parallel-beta"
13
+ BETA_VALUE = "search-extract-2025-10-10"
14
+
15
+
16
+ def init():
17
+ workspace, _, _ = get_workspace()
18
+ return get_key("PARALLEL_API_KEY",
19
+ file_fallback=os.path.join(workspace, "scripts", "parallel-api-key.txt"),
20
+ help_url="https://platform.parallel.ai")
21
+
22
+
23
+ def search(token, query):
24
+ """AI-powered web search with LLM-optimized excerpts."""
25
+ data = api_post(f"{BASE}/search", {
26
+ "objective": query,
27
+ "search_queries": [query],
28
+ "max_results": 10,
29
+ "excerpts": {"max_chars_per_result": 5000},
30
+ }, headers={
31
+ "x-api-key": token,
32
+ BETA_HEADER: BETA_VALUE,
33
+ })
34
+ if data:
35
+ print(json.dumps(data, indent=2, ensure_ascii=False)[:5000])
36
+
37
+
38
+ def extract(token, url):
39
+ """URL → clean markdown (JS-heavy, PDF)."""
40
+ data = api_post(f"{BASE}/extract", {
41
+ "url": url,
42
+ "full_content": True,
43
+ }, headers={
44
+ "x-api-key": token,
45
+ BETA_HEADER: BETA_VALUE,
46
+ })
47
+ if data:
48
+ print(json.dumps(data, indent=2, ensure_ascii=False)[:5000])
49
+
50
+
51
+ def task(token, task_text):
52
+ """Complex research task with structured output."""
53
+ data = api_post(f"{BASE}/task", {
54
+ "task": task_text,
55
+ }, headers={
56
+ "x-api-key": token,
57
+ })
58
+ if data:
59
+ print(json.dumps(data, indent=2, ensure_ascii=False)[:5000])
60
+
61
+
62
+ def main():
63
+ if len(sys.argv) < 3:
64
+ print("Usage: parallel.py search|extract|task <arg>")
65
+ print()
66
+ print(" search <query> - AI-powered web search")
67
+ print(" extract <url> - URL → clean markdown")
68
+ print(" task <task> - Complex research task")
69
+ sys.exit(1)
70
+ token = init()
71
+ cmd = sys.argv[1]
72
+ arg = " ".join(sys.argv[2:])
73
+ if cmd == "search":
74
+ search(token, arg)
75
+ elif cmd == "extract":
76
+ extract(token, arg)
77
+ elif cmd == "task":
78
+ task(token, arg)
79
+ else:
80
+ print(f"Unknown: {cmd} (use search|extract|task)", file=sys.stderr)
81
+ sys.exit(1)
82
+
83
+
84
+ if __name__ == "__main__":
85
+ main()
@@ -1,102 +1,102 @@
1
- #!/usr/bin/env python3
2
- """Perplexity API — search + sonar + deep research. Stdlib only."""
3
-
4
- import json
5
- import os
6
- import sys
7
-
8
- sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
9
- from _http import api_post, get_key, truncate
10
-
11
- API_KEY = None
12
-
13
-
14
- def init():
15
- global API_KEY
16
- API_KEY = get_key("PERPLEXITY_API_KEY", help_url="https://perplexity.ai/settings/api")
17
-
18
-
19
- def search(query):
20
- """Search API — ranked web results."""
21
- data = api_post("https://api.perplexity.ai/search",
22
- {"query": [query]},
23
- headers={"Authorization": f"Bearer {API_KEY}"})
24
- if not data:
25
- return
26
- if "results" in data:
27
- for r in data["results"][:10]:
28
- print(f'🔗 {r.get("title", "")}')
29
- print(f' {r.get("url", "")}')
30
- print(f' {truncate(r.get("snippet", ""), 200)}')
31
- print()
32
- elif "error" in data:
33
- print(f'ERROR: {json.dumps(data["error"])}', file=sys.stderr)
34
- else:
35
- print(json.dumps(data, indent=2)[:2000])
36
-
37
-
38
- def sonar(query):
39
- """Sonar API — AI answer with citations."""
40
- data = api_post("https://api.perplexity.ai/chat/completions",
41
- {"model": "sonar",
42
- "messages": [{"role": "user", "content": query}]},
43
- headers={"Authorization": f"Bearer {API_KEY}"})
44
- if not data:
45
- return
46
- if "choices" in data:
47
- msg = data["choices"][0]["message"]
48
- print(msg.get("content", ""))
49
- cits = data.get("citations", msg.get("citations", []))
50
- if cits:
51
- print("\n--- Sources ---")
52
- for i, c in enumerate(cits[:10], 1):
53
- print(f"{i}. {c if isinstance(c, str) else c.get('url', c)}")
54
- elif "error" in data:
55
- print(f'ERROR: {json.dumps(data["error"])}', file=sys.stderr)
56
- else:
57
- print(json.dumps(data, indent=2)[:2000])
58
-
59
-
60
- def deep(query):
61
- """Deep Research via sonar-deep-research."""
62
- data = api_post("https://api.perplexity.ai/chat/completions",
63
- {"model": "sonar-deep-research",
64
- "messages": [{"role": "user", "content": query}]},
65
- headers={"Authorization": f"Bearer {API_KEY}"},
66
- timeout=300)
67
- if not data:
68
- return
69
- if "choices" in data:
70
- msg = data["choices"][0]["message"]
71
- print(msg.get("content", ""))
72
- cits = data.get("citations", msg.get("citations", []))
73
- if cits:
74
- print("\n--- Sources ---")
75
- for i, c in enumerate(cits[:15], 1):
76
- print(f"{i}. {c if isinstance(c, str) else c.get('url', c)}")
77
- elif "error" in data:
78
- print(f'ERROR: {json.dumps(data["error"])}', file=sys.stderr)
79
- else:
80
- print(json.dumps(data, indent=2)[:2000])
81
-
82
-
83
- def main():
84
- if len(sys.argv) < 3:
85
- print("Usage: perplexity.py search|sonar|deep <query>")
86
- sys.exit(1)
87
- init()
88
- cmd = sys.argv[1]
89
- query = " ".join(sys.argv[2:])
90
- if cmd == "search":
91
- search(query)
92
- elif cmd == "sonar":
93
- sonar(query)
94
- elif cmd == "deep":
95
- deep(query)
96
- else:
97
- print(f"Unknown command: {cmd} (use search|sonar|deep)", file=sys.stderr)
98
- sys.exit(1)
99
-
100
-
101
- if __name__ == "__main__":
102
- main()
1
+ #!/usr/bin/env python3
2
+ """Perplexity API — search + sonar + deep research. Stdlib only."""
3
+
4
+ import json
5
+ import os
6
+ import sys
7
+
8
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
9
+ from _http import api_post, get_key, truncate
10
+
11
+ API_KEY = None
12
+
13
+
14
+ def init():
15
+ global API_KEY
16
+ API_KEY = get_key("PERPLEXITY_API_KEY", help_url="https://perplexity.ai/settings/api")
17
+
18
+
19
+ def search(query):
20
+ """Search API — ranked web results."""
21
+ data = api_post("https://api.perplexity.ai/search",
22
+ {"query": [query]},
23
+ headers={"Authorization": f"Bearer {API_KEY}"})
24
+ if not data:
25
+ return
26
+ if "results" in data:
27
+ for r in data["results"][:10]:
28
+ print(f'🔗 {r.get("title", "")}')
29
+ print(f' {r.get("url", "")}')
30
+ print(f' {truncate(r.get("snippet", ""), 200)}')
31
+ print()
32
+ elif "error" in data:
33
+ print(f'ERROR: {json.dumps(data["error"])}', file=sys.stderr)
34
+ else:
35
+ print(json.dumps(data, indent=2)[:2000])
36
+
37
+
38
+ def sonar(query):
39
+ """Sonar API — AI answer with citations."""
40
+ data = api_post("https://api.perplexity.ai/chat/completions",
41
+ {"model": "sonar",
42
+ "messages": [{"role": "user", "content": query}]},
43
+ headers={"Authorization": f"Bearer {API_KEY}"})
44
+ if not data:
45
+ return
46
+ if "choices" in data:
47
+ msg = data["choices"][0]["message"]
48
+ print(msg.get("content", ""))
49
+ cits = data.get("citations", msg.get("citations", []))
50
+ if cits:
51
+ print("\n--- Sources ---")
52
+ for i, c in enumerate(cits[:10], 1):
53
+ print(f"{i}. {c if isinstance(c, str) else c.get('url', c)}")
54
+ elif "error" in data:
55
+ print(f'ERROR: {json.dumps(data["error"])}', file=sys.stderr)
56
+ else:
57
+ print(json.dumps(data, indent=2)[:2000])
58
+
59
+
60
+ def deep(query):
61
+ """Deep Research via sonar-deep-research."""
62
+ data = api_post("https://api.perplexity.ai/chat/completions",
63
+ {"model": "sonar-deep-research",
64
+ "messages": [{"role": "user", "content": query}]},
65
+ headers={"Authorization": f"Bearer {API_KEY}"},
66
+ timeout=300)
67
+ if not data:
68
+ return
69
+ if "choices" in data:
70
+ msg = data["choices"][0]["message"]
71
+ print(msg.get("content", ""))
72
+ cits = data.get("citations", msg.get("citations", []))
73
+ if cits:
74
+ print("\n--- Sources ---")
75
+ for i, c in enumerate(cits[:15], 1):
76
+ print(f"{i}. {c if isinstance(c, str) else c.get('url', c)}")
77
+ elif "error" in data:
78
+ print(f'ERROR: {json.dumps(data["error"])}', file=sys.stderr)
79
+ else:
80
+ print(json.dumps(data, indent=2)[:2000])
81
+
82
+
83
+ def main():
84
+ if len(sys.argv) < 3:
85
+ print("Usage: perplexity.py search|sonar|deep <query>")
86
+ sys.exit(1)
87
+ init()
88
+ cmd = sys.argv[1]
89
+ query = " ".join(sys.argv[2:])
90
+ if cmd == "search":
91
+ search(query)
92
+ elif cmd == "sonar":
93
+ sonar(query)
94
+ elif cmd == "deep":
95
+ deep(query)
96
+ else:
97
+ print(f"Unknown command: {cmd} (use search|sonar|deep)", file=sys.stderr)
98
+ sys.exit(1)
99
+
100
+
101
+ if __name__ == "__main__":
102
+ main()
@@ -1,72 +1,72 @@
1
- #!/usr/bin/env python3
2
- """Tavily API — AI-optimized search for agents. Stdlib only."""
3
-
4
- import json
5
- import os
6
- import sys
7
-
8
- sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
9
- from _http import api_post, get_key, truncate
10
-
11
-
12
- def init():
13
- return get_key("TAVILY_API_KEY", help_url="https://app.tavily.com/home")
14
-
15
-
16
- def search(api_key, query, depth="basic"):
17
- """Tavily search — basic ($0.005) or advanced (deep)."""
18
- data = api_post("https://api.tavily.com/search", {
19
- "api_key": api_key,
20
- "query": query,
21
- "search_depth": depth,
22
- "max_results": 10,
23
- "include_answer": True,
24
- "include_raw_content": False,
25
- })
26
- if not data:
27
- return
28
- if data.get("answer"):
29
- print(f'💡 {data["answer"]}\n')
30
- for r in data.get("results", [])[:10]:
31
- print(f'🔗 {r.get("title", "")}')
32
- print(f' {r.get("url", "")}')
33
- print(f' {truncate(r.get("content", ""), 300 if depth == "advanced" else 200)}')
34
- score = r.get("score", "")
35
- if score:
36
- print(f" relevance: {score:.2f}")
37
- print()
38
-
39
-
40
- def extract(api_key, url):
41
- """Extract content from a URL."""
42
- data = api_post("https://api.tavily.com/extract", {
43
- "api_key": api_key,
44
- "urls": [url],
45
- })
46
- if not data:
47
- return
48
- for r in data.get("results", []):
49
- print(f'📄 {r.get("url", "")}')
50
- print(r.get("raw_content", r.get("content", ""))[:3000])
51
-
52
-
53
- def main():
54
- if len(sys.argv) < 3:
55
- print("Usage: tavily.py search|extract|deep <query>")
56
- sys.exit(1)
57
- api_key = init()
58
- cmd = sys.argv[1]
59
- query = " ".join(sys.argv[2:])
60
- if cmd == "search":
61
- search(api_key, query, "basic")
62
- elif cmd == "deep":
63
- search(api_key, query, "advanced")
64
- elif cmd == "extract":
65
- extract(api_key, query)
66
- else:
67
- print(f"Unknown: {cmd} (use search|extract|deep)", file=sys.stderr)
68
- sys.exit(1)
69
-
70
-
71
- if __name__ == "__main__":
72
- main()
1
+ #!/usr/bin/env python3
2
+ """Tavily API — AI-optimized search for agents. Stdlib only."""
3
+
4
+ import json
5
+ import os
6
+ import sys
7
+
8
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
9
+ from _http import api_post, get_key, truncate
10
+
11
+
12
+ def init():
13
+ return get_key("TAVILY_API_KEY", help_url="https://app.tavily.com/home")
14
+
15
+
16
+ def search(api_key, query, depth="basic"):
17
+ """Tavily search — basic ($0.005) or advanced (deep)."""
18
+ data = api_post("https://api.tavily.com/search", {
19
+ "api_key": api_key,
20
+ "query": query,
21
+ "search_depth": depth,
22
+ "max_results": 10,
23
+ "include_answer": True,
24
+ "include_raw_content": False,
25
+ })
26
+ if not data:
27
+ return
28
+ if data.get("answer"):
29
+ print(f'💡 {data["answer"]}\n')
30
+ for r in data.get("results", [])[:10]:
31
+ print(f'🔗 {r.get("title", "")}')
32
+ print(f' {r.get("url", "")}')
33
+ print(f' {truncate(r.get("content", ""), 300 if depth == "advanced" else 200)}')
34
+ score = r.get("score", "")
35
+ if score:
36
+ print(f" relevance: {score:.2f}")
37
+ print()
38
+
39
+
40
+ def extract(api_key, url):
41
+ """Extract content from a URL."""
42
+ data = api_post("https://api.tavily.com/extract", {
43
+ "api_key": api_key,
44
+ "urls": [url],
45
+ })
46
+ if not data:
47
+ return
48
+ for r in data.get("results", []):
49
+ print(f'📄 {r.get("url", "")}')
50
+ print(r.get("raw_content", r.get("content", ""))[:3000])
51
+
52
+
53
+ def main():
54
+ if len(sys.argv) < 3:
55
+ print("Usage: tavily.py search|extract|deep <query>")
56
+ sys.exit(1)
57
+ api_key = init()
58
+ cmd = sys.argv[1]
59
+ query = " ".join(sys.argv[2:])
60
+ if cmd == "search":
61
+ search(api_key, query, "basic")
62
+ elif cmd == "deep":
63
+ search(api_key, query, "advanced")
64
+ elif cmd == "extract":
65
+ extract(api_key, query)
66
+ else:
67
+ print(f"Unknown: {cmd} (use search|extract|deep)", file=sys.stderr)
68
+ sys.exit(1)
69
+
70
+
71
+ if __name__ == "__main__":
72
+ main()