Dianel555/DSkills

"owner": {     "name": "Dianel555",     "url": "https://github.com/Dianel555"

"name": "Dianel555",     "url": "https://github.com/Dianel555"   },

"url": "https://github.com/Dianel555"

# { #   "accessToken": "your-token-here", #   "tenantURL": "https://api.example.com/",

#   "accessToken": "your-token-here", #   "tenantURL": "https://api.example.com/", #   "scopes": ["email"]

#   "tenantURL": "https://api.example.com/",

# Option B: Set AUGMENT_SESSION_AUTH environment variable (for CI/CD) # AUGMENT_SESSION_AUTH='{"accessToken":"your-token","tenantURL":"https://api.example.com/"}'

# AUGMENT_SESSION_AUTH='{"accessToken":"your-token","tenantURL":"https://api.example.com/"}'

# --- Legacy Authentication (Deprecated but still supported) --- # ACE_API_URL=https://api.example.com

# ACE_API_URL=https://api.example.com

# Third-party LLM configuration (required for claude/openai/gemini/codex endpoints) # PROMPT_ENHANCER_BASE_URL=https://api.anthropic.com

# PROMPT_ENHANCER_BASE_URL=https://api.anthropic.com

export AUGMENT_SESSION_AUTH='{"accessToken":"your-token","tenantURL":"https://api.example.com/"}'

export ACE_API_URL="https://your-api-endpoint.com"

[Credential-related source omitted]

export PROMPT_ENHANCER_ENDPOINT=codex export PROMPT_ENHANCER_BASE_URL=https://api.openai.com

export PROMPT_ENHANCER_BASE_URL=https://api.openai.com

[Credential-related source omitted]

All HTTP calls use `build_api_url(base_url, path)` which handles version prefix deduplication (e.g., `https://api.example.com/v1` + `/v1/messages` → `https://api.example.com/v1/messages`, not `.../v1/v1/messages`).

{   "accessToken": "your-token-here",   "tenantURL": "https://api.example.com/",

"accessToken": "your-token-here",   "tenantURL": "https://api.example.com/",   "scopes": ["email"]

"tenantURL": "https://api.example.com/",

export AUGMENT_SESSION_AUTH='{"accessToken":"your-token","tenantURL":"https://api.example.com/"}'

export ACE_API_URL=https://your-augment-api.com

[Credential-related source omitted]

[Credential-related source omitted]

# Legacy format (deprecated) # ACE_API_URL=https://your-augment-api.com

# ACE_API_URL=https://your-augment-api.com

# Third-party API (optional) # PROMPT_ENHANCER_BASE_URL=https://api.anthropic.com

# PROMPT_ENHANCER_BASE_URL=https://api.anthropic.com

- Based on [missdeer/ace-tool-rs](https://github.com/missdeer/ace-tool-rs)

[Credential-related source omitted]

{   "accessToken": "your-token-here",   "tenantURL": "https://api.example.com/",

"accessToken": "your-token-here",   "tenantURL": "https://api.example.com/",   "scopes": ["email"]

"tenantURL": "https://api.example.com/",

export AUGMENT_SESSION_AUTH='{"accessToken":"token","tenantURL":"https://api.example.com/"}'

Executable file

Executable file

#!/usr/bin/env python3

Executable file

self.timeout = httpx.Timeout(180.0, connect=30.0)

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

with httpx.Client(timeout=self.timeout) as client:

with httpx.Client(timeout=self.timeout) as client:

timeout: httpx.Timeout | None = None,     ) -> dict:         with httpx.Client(timeout=timeout or self.timeout) as client:

) -> dict:         with httpx.Client(timeout=timeout or self.timeout) as client:             resp = client.post(url, headers=headers, json=payload)

with httpx.Client(timeout=timeout or self.timeout) as client:

def _check_auth_error(self, status: int, provider: str = "API"):         if status == 401:             raise httpx.HTTPStatusError(

if status == 401:             raise httpx.HTTPStatusError(                 f"{provider} token invalid or expired",

raise httpx.HTTPStatusError(

f"{provider} token invalid or expired",                 request=None,                 response=httpx.Response(status),

request=None,                 response=httpx.Response(status),             )

response=httpx.Response(status),

)         if status == 403:             raise httpx.HTTPStatusError(

if status == 403:             raise httpx.HTTPStatusError(                 f"{provider} access denied, token may be disabled",

raise httpx.HTTPStatusError(

f"{provider} access denied, token may be disabled",                 request=None,                 response=httpx.Response(status),

request=None,                 response=httpx.Response(status),             )

response=httpx.Response(status),

"enable_commit_retrieval": False,         }         timeout = httpx.Timeout(RETRIEVAL_TIMEOUT, connect=15.0)

timeout = httpx.Timeout(RETRIEVAL_TIMEOUT, connect=15.0)

Executable file

for attempt in range(max_retries):             try:                 with httpx.Client(timeout=httpx.Timeout(60.0, connect=15.0)) as client:

try:                 with httpx.Client(timeout=httpx.Timeout(60.0, connect=15.0)) as client:                     resp = client.post(url, headers=headers, json=payload)

with httpx.Client(timeout=httpx.Timeout(60.0, connect=15.0)) as client:

Executable file

[Credential-related source omitted]

Executable file

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

if(!sessionId){loading.style.display='none';mainContent.style.display='block';showStatus('Error: No session ID','error')} else{loading.classList.add('active'); fetch('/api/session?session='+encodeURIComponent(sessionId)).then(r=>r.json()).t

else{loading.classList.add('active'); fetch('/api/session?session='+encodeURIComponent(sessionId)).then(r=>r.json()).then(data=>{ if(data.error)throw new Error(data.error);

fetch('/api/session?session='+encodeURIComponent(sessionId)).then(r=>r.json()).then(data=>{

const btn=document.getElementById('regenerateBtn'),refineBtn=document.getElementById('refineBtn'),sendBtn=document.getElementById('sendBtn'); btn.disabled=refineBtn.disabled=sendBtn.disabled=true;btn.innerHTML='<div class="spinner" style="w

btn.disabled=refineBtn.disabled=sendBtn.disabled=true;btn.innerHTML='<div class="spinner" style="width:16px;height:16px;border-width:2px;margin:0"></div> Regenerating...'; fetch('/api/regenerate',{method:'POST',headers:{'Content-Type':'appl

fetch('/api/regenerate',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({sessionId})})

const btn=document.getElementById('refineBtn'),regenerateBtn=document.getElementById('regenerateBtn'),sendBtn=document.getElementById('sendBtn'); btn.disabled=regenerateBtn.disabled=sendBtn.disabled=true;btn.innerHTML='<div class="spinner" 

btn.disabled=regenerateBtn.disabled=sendBtn.disabled=true;btn.innerHTML='<div class="spinner" style="width:16px;height:16px;border-width:2px;margin:0"></div> Refining...'; fetch('/api/refine',{method:'POST',headers:{'Content-Type':'applicat

fetch('/api/refine',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({sessionId,currentPrompt:content})})

const btn=document.getElementById('sendBtn'),regenerateBtn=document.getElementById('regenerateBtn'),refineBtn=document.getElementById('refineBtn'); btn.disabled=regenerateBtn.disabled=refineBtn.disabled=true;btn.innerHTML='<div class="spinn

btn.disabled=regenerateBtn.disabled=refineBtn.disabled=true;btn.innerHTML='<div class="spinner" style="width:16px;height:16px;border-width:2px;margin:0"></div> Sending...'; fetch('/api/submit',{method:'POST',headers:{'Content-Type':'applica

fetch('/api/submit',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({sessionId,content,action:'send'})})

function useOriginal(){if(confirm('Use original prompt?')){ fetch('/api/submit',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({sessionId,content:'',action:'use_original'})})

fetch('/api/submit',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({sessionId,content:'',action:'use_original'})})

function endConversation(){if(confirm('Cancel enhancement?')){ fetch('/api/submit',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({sessionId,content:'',action:'cancel'})})

fetch('/api/submit',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({sessionId,content:'',action:'cancel'})})

for p in range(port, port + 100):         try:             with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:

try:             with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:                 s.bind(("127.0.0.1", p))

with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:

url = f"http://127.0.0.1:{port}/enhance?session={session_id}"

Executable file

Executable file

Executable file

session_file = tmp_path / ".augment" / "session.json"         session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "token_from_file", "tenantURL": "https://file.example.com/", "scopes": ["email"]}

session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "token_from_file", "tenantURL": "https://file.example.com/", "scopes": ["email"]}         session_file.write_text(json.dumps(session_data), encoding="utf-8")

session_data = {"accessToken": "token_from_file", "tenantURL": "https://file.example.com/", "scopes": ["email"]}

assert base_url == "https://file.example.com"

env_data = {"accessToken": "token_from_env", "tenantURL": "https://env.example.com/"}

[Credential-related source omitted]

assert base_url == "https://env.example.com"

env_vars = {             "ACE_API_URL": "https://legacy.example.com/",

"ACE_API_URL": "https://legacy.example.com/",

[Credential-related source omitted]

assert base_url == "https://legacy.example.com"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

assert base_url == "https://env.example.com"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

assert base_url == "https://fallback.example.com"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

assert base_url == "https://legacy.example.com"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

assert base_url == "https://legacy.example.com"

session_file = tmp_path / ".augment" / "session.json"         session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "bom_token", "tenantURL": "https://bom.example.com/"}

session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "bom_token", "tenantURL": "https://bom.example.com/"}         session_file.write_bytes(b"\xef\xbb\xbf" + json.dumps(session_data).encode("utf-8"))

session_data = {"accessToken": "bom_token", "tenantURL": "https://bom.example.com/"}

assert base_url == "https://bom.example.com"

session_file = tmp_path / ".augment" / "session.json"         session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "token", "tenantURL": "https://example.com///"}

session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "token", "tenantURL": "https://example.com///"}         session_file.write_text(json.dumps(session_data), encoding="utf-8")

session_data = {"accessToken": "token", "tenantURL": "https://example.com///"}

assert base_url == "https://example.com"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

assert captured["base_url"] == "https://session.example.com"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

session_file = tmp_path / ".augment" / "session.json"         session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "file_token", "tenantURL": "https://file.example.com/"}

session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "file_token", "tenantURL": "https://file.example.com/"}         session_file.write_text(json.dumps(session_data), encoding="utf-8")

session_data = {"accessToken": "file_token", "tenantURL": "https://file.example.com/"}

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

assert client.base_url == "https://constructor.example.com"

session_file = tmp_path / ".augment" / "session.json"         session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "session_token", "tenantURL": "https://session.example.com/"}

session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "session_token", "tenantURL": "https://session.example.com/"}         session_file.write_text(json.dumps(session_data), encoding="utf-8")

session_data = {"accessToken": "session_token", "tenantURL": "https://session.example.com/"}

assert client.base_url == "https://session.example.com"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

assert client.base_url == "https://env.example.com"

env_vars = {             "ACE_API_URL": "https://legacy.example.com/",

"ACE_API_URL": "https://legacy.example.com/",

[Credential-related source omitted]

assert client.base_url == "https://legacy.example.com"

session_file = tmp_path / ".augment" / "session.json"         session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "session_token", "tenantURL": "https://session.example.com/"}

session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "session_token", "tenantURL": "https://session.example.com/"}         session_file.write_text(json.dumps(session_data), encoding="utf-8")

session_data = {"accessToken": "session_token", "tenantURL": "https://session.example.com/"}

assert client.base_url == "https://session.example.com"

[Credential-related source omitted]

[Credential-related source omitted]

session_file = tmp_path / ".augment" / "session.json"         session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "token", "tenantURL": "https://example.com/"}

session_file.parent.mkdir(parents=True)         session_data = {"accessToken": "token", "tenantURL": "https://example.com/"}         session_file.write_text(json.dumps(session_data), encoding="utf-8")

session_data = {"accessToken": "token", "tenantURL": "https://example.com/"}

Executable file

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

"ACE_API_URL": "http://test",

"ACE_ENHANCER_ENDPOINT": "",                 "PROMPT_ENHANCER_INCLUDE_SEARCH_CONTEXT": "1",                 "PROMPT_ENHANCER_BASE_URL": "http://third",

[Credential-related source omitted]

"PROMPT_ENHANCER_BASE_URL": "http://third",

Executable file

[Credential-related source omitted]

Executable file

def test_reads_gitignore(self, tmp_path):         (tmp_path / ".gitignore").write_text("*.pyc\n__pycache__\n", encoding="utf-8")         idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

(tmp_path / ".gitignore").write_text("*.pyc\n__pycache__\n", encoding="utf-8")         idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")         assert "*.pyc" in idx._gitignore_patterns

idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

def test_reads_aceignore(self, tmp_path):         (tmp_path / ".aceignore").write_text("secret/\n*.log\n", encoding="utf-8")         idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

(tmp_path / ".aceignore").write_text("secret/\n*.log\n", encoding="utf-8")         idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")         assert "secret/" in idx._gitignore_patterns

idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

(tmp_path / ".gitignore").write_text("*.pyc\n", encoding="utf-8")         (tmp_path / ".aceignore").write_text("*.log\n", encoding="utf-8")         idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

(tmp_path / ".aceignore").write_text("*.log\n", encoding="utf-8")         idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")         assert "*.pyc" in idx._gitignore_patterns

idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

def test_skips_comments_and_empty_lines(self, tmp_path):         (tmp_path / ".aceignore").write_text("# comment\n\n  \nvalid_pattern\n", encoding="utf-8")         idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

(tmp_path / ".aceignore").write_text("# comment\n\n  \nvalid_pattern\n", encoding="utf-8")         idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")         assert "valid_pattern" in idx._gitignore_patterns

idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

def test_no_files_empty_patterns(self, tmp_path):         idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

def test_aceignore_only(self, tmp_path):         (tmp_path / ".aceignore").write_text("build/\n", encoding="utf-8")         idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

(tmp_path / ".aceignore").write_text("build/\n", encoding="utf-8")         idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")         assert "build/" in idx._gitignore_patterns

idx = Indexer(str(tmp_path), "http://fake.url", "fake-token")

Executable file

"PROMPT_ENHANCER_ENDPOINT": "",     "ACE_ENHANCER_ENDPOINT": "",     "PROMPT_ENHANCER_BASE_URL": "https://h",

[Credential-related source omitted]

"PROMPT_ENHANCER_BASE_URL": "https://h",

[Credential-related source omitted]

Executable file

[Credential-related source omitted]

[Credential-related source omitted]

"ACE_ENHANCER_ENDPOINT": "",                 "PROMPT_ENHANCER_INCLUDE_SEARCH_CONTEXT": "1",                 "PROMPT_ENHANCER_BASE_URL": "https://api.example.com",

[Credential-related source omitted]

"PROMPT_ENHANCER_BASE_URL": "https://api.example.com",

[Credential-related source omitted]

"ACE_API_URL": "https://ace.example.com",

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

"base,path,expected",     [         ("https://api.example.com", "/v1/messages", "https://api.example.com/v1/messages"),

[         ("https://api.example.com", "/v1/messages", "https://api.example.com/v1/messages"),         ("https://api.example.com/v1", "/v1/messages", "https://api.example.com/v1/messages"),

("https://api.example.com", "/v1/messages", "https://api.example.com/v1/messages"),

("https://api.example.com/v1", "/v1/messages", "https://api.example.com/v1/messages"),

("https://proxy.com/v1beta", "/v1/messages", "https://proxy.com/v1beta/messages"),

("https://api.example.com/vertex", "/v1/messages", "https://api.example.com/vertex/v1/messages"),

("https://api.example.com", "v1/messages", "https://api.example.com/v1/messages"),

("https://api.example.com/v1/", "/v1/messages", "https://api.example.com/v1/messages"),

("https://h/v1", "/batch-upload", "https://h/v1/batch-upload"),

monkeypatch.setattr("indexer.httpx.Client", FakeClient)     idx = Indexer(str(tmp_path), "https://h/v1", "tok")

idx = Indexer(str(tmp_path), "https://h/v1", "tok")

assert captured["url"] == build_api_url("https://h/v1", "/batch-upload")

[Credential-related source omitted]

[Credential-related source omitted]

calls["post"] += 1         if calls["post"] == 1:             resp = httpx.Response(400, text="unknown blobs: ['stale']")

if calls["post"] == 1:             resp = httpx.Response(400, text="unknown blobs: ['stale']")             raise httpx.HTTPStatusError("400 Bad Request", request=None, response=resp)

resp = httpx.Response(400, text="unknown blobs: ['stale']")

raise httpx.HTTPStatusError("400 Bad Request", request=None, response=resp)

[Credential-related source omitted]

[Credential-related source omitted]

def fake_post(url, payload, *, headers, provider="API", timeout=None):         calls["post"] += 1         resp = httpx.Response(400, text="unknown blobs")

calls["post"] += 1         resp = httpx.Response(400, text="unknown blobs")         raise httpx.HTTPStatusError("400 Bad Request", request=None, response=resp)

resp = httpx.Response(400, text="unknown blobs")

raise httpx.HTTPStatusError("400 Bad Request", request=None, response=resp)

[Credential-related source omitted]

[Credential-related source omitted]

def fake_post(url, payload, *, headers, provider="API", timeout=None):         calls["post"] += 1         resp = httpx.Response(400, text="malformed request")

calls["post"] += 1         resp = httpx.Response(400, text="malformed request")         raise httpx.HTTPStatusError("400 Bad Request", request=None, response=resp)

resp = httpx.Response(400, text="malformed request")

raise httpx.HTTPStatusError("400 Bad Request", request=None, response=resp)

idx = Indexer(str(child), "https://h", "tok")

idx = Indexer(str(child), "https://h", "tok")

idx = Indexer(str(proj), "https://h", "tok")

idx = Indexer(str(child), "https://h", "tok")

idx = Indexer(str(proj), "https://h", "tok")

def test_force_rebuild_raises_on_upload_failure(tmp_path, monkeypatch):     (tmp_path / "a.py").write_text("x = 1\n", encoding="utf-8")     idx = Indexer(str(tmp_path), "https://h", "tok")

(tmp_path / "a.py").write_text("x = 1\n", encoding="utf-8")     idx = Indexer(str(tmp_path), "https://h", "tok")     monkeypatch.setattr(idx, "_upload_pending", lambda: False)

idx = Indexer(str(tmp_path), "https://h", "tok")

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[project.urls] Homepage = "https://github.com/DSkills"

Homepage = "https://github.com/DSkills"

Repository = "https://github.com/DSkills"

Issues = "https://github.com/DSkills/issues"

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

text = "<U+FEFF>" + text

Executable file

Executable file

Executable file

Executable file

Executable file

bom = "<U+FEFF>" if text.startswith("<U+FEFF>") else ""

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

_SVG_SEAL = '''<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r

_SVG_THEME_TOGGLE = '''<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" c

if entry.get("doi"):         doi = str(entry["doi"])         doi_href = "https://doi.org/" + quote(doi, safe="/._-()")

doi = str(entry["doi"])         doi_href = "https://doi.org/" + quote(doi, safe="/._-()")         row("DOI", f'<a href="{_esc(doi_href)}">{_esc(doi)}</a>')

doi_href = "https://doi.org/" + quote(doi, safe="/._-()")

if entry.get("doi"):         doi = str(entry["doi"])         parts.append(f'<a href="{_esc("https://doi.org/" + quote(doi, safe="/._-()"))}">DOI {_esc(doi)}</a>')

doi = str(entry["doi"])         parts.append(f'<a href="{_esc("https://doi.org/" + quote(doi, safe="/._-()"))}">DOI {_esc(doi)}</a>')     sources = entry.get("sources") or []

parts.append(f'<a href="{_esc("https://doi.org/" + quote(doi, safe="/._-()"))}">DOI {_esc(doi)}</a>')

Executable file

text = "<U+FEFF>" + text

Executable file

Executable file

Executable file

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

Executable file

Executable file

[Credential-related source omitted]

Executable file

Executable file

Executable file

[Credential-related source omitted]

Executable file

Executable file

Executable file

Executable file

def test_canvas_schema_validity_and_edge_closure():     data = _index({"T.md": _entry(["a.md", "https://x.io"], ["N"], "T", "Summary"), "N.md": _entry(title="N")})

data = _index({"T.md": _entry(["a.md", "https://x.io"], ["N"], "T", "Summary"), "N.md": _entry(title="N")})

def test_url_source_is_link_file_source_is_text_node():     data = _index({"T.md": _entry(["notes/a.md", "https://example.com/p"], title="Topic")})

data = _index({"T.md": _entry(["notes/a.md", "https://example.com/p"], title="Topic")})

assert by_id["source:notes/a.md"]["type"] == "text"     assert "[[vault/notes/a" in by_id["source:notes/a.md"]["text"]     assert by_id["source:https://example.com/p"]["type"] == "link"

assert "[[vault/notes/a" in by_id["source:notes/a.md"]["text"]     assert by_id["source:https://example.com/p"]["type"] == "link"     assert by_id["source:https://example.com/p"]["url"] == "https://example.com/p"

assert by_id["source:https://example.com/p"]["type"] == "link"

assert by_id["source:https://example.com/p"]["url"] == "https://example.com/p"

Executable file

Executable file

Executable file

topic.write_text("<U+FEFF>" + body, encoding="utf-8")

assert topic.read_text(encoding="utf-8").startswith("<U+FEFF>---")

Executable file

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

Executable file

Executable file

[Credential-related source omitted]

Executable file

"[[real-two]]\n<!-- [[comment]]\n[[comment-two]]\n[also-comment](Comment.md) -->\n"         "`<!-- [[inline-comment]] -->` [[real-three]]\n"         "[ref](https://example.org/Function_(mathematics))\n"

"`<!-- [[inline-comment]] -->` [[real-three]]\n"         "[ref](https://example.org/Function_(mathematics))\n"         "![pdf](<paper_(v1).pdf#page=3> \"title\")"

"[ref](https://example.org/Function_(mathematics))\n"

("real-two", "", False, "wikilink"),         ("real-three", "", False, "wikilink"),         ("https://example.org/Function_(mathematics)", "", False, "markdown"),

("real-three", "", False, "wikilink"),         ("https://example.org/Function_(mathematics)", "", False, "markdown"),         ("paper_(v1).pdf", "page=3", True, "markdown"),

("https://example.org/Function_(mathematics)", "", False, "markdown"),

{"title": "A"},         "[[B#Methods & Results|internal]]\n\n"         "[external](https://example.org/doc#section)\n\n"

"[[B#Methods & Results|internal]]\n\n"         "[external](https://example.org/doc#section)\n\n"         "[pdf](paper.pdf#page=3)",

"[external](https://example.org/doc#section)\n\n"

assert 'href="https://example.org/doc#section"' in rendered_a

Executable file

Executable file

Executable file

Executable file

Executable file

[Credential-related source omitted]

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

![Architecture Diagram](https://example.com/arch.png)

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

assert source_type.classify_ref("notes.txt") == "text"     assert source_type.classify_ref("deck.pptx") == "slides"     assert source_type.classify_ref("https://example.com/post") == "web"

assert source_type.classify_ref("deck.pptx") == "slides"     assert source_type.classify_ref("https://example.com/post") == "web"     assert source_type.classify_ref("archive.zip") == "other"

assert source_type.classify_ref("https://example.com/post") == "web"

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

# Hub dry-run (requires OAuth token) curl -X POST https://evomap.ai/a2a/validate \

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

improvement signals while editing, record how each task turned out, and — when a durable lesson emerges — distill or reuse proven genes/capsules. Backed by the [EvoMap](https://evomap.ai) A2A marketplace (GEP-A2A v1.0.0) via a local Proxy

a durable lesson emerges — distill or reuse proven genes/capsules. Backed by the [EvoMap](https://evomap.ai) A2A marketplace (GEP-A2A v1.0.0) via a local Proxy mailbox.

[EvoMap](https://evomap.ai) A2A marketplace (GEP-A2A v1.0.0) via a local Proxy

|------|---------| | **Evolver** | The self-evolution client (the engine lives in the standalone `@evomap/evolver` npm package, not bundled here). | | **EvoMap Hub** | The A2A marketplace the client talks to (`https://evomap.ai`). |

| **Evolver** | The self-evolution client (the engine lives in the standalone `@evomap/evolver` npm package, not bundled here). | | **EvoMap Hub** | The A2A marketplace the client talks to (`https://evomap.ai`). | | **Proxy** | A local proc

| **EvoMap Hub** | The A2A marketplace the client talks to (`https://evomap.ai`). |

> Extended documentation for `https://evomap.ai/skill.md` | GEP-A2A v1.0.0

**Endpoint:** `POST https://evomap.ai/a2a/recipe`

**Endpoint:** `POST https://evomap.ai/a2a/recipe/:id/express`

{   "sender_id": "node_e5f6a7b8c9d0e1f2",   "input_payload": { "repo_url": "https://github.com/...", "issue": "timeout on login" },

"sender_id": "node_e5f6a7b8c9d0e1f2",   "input_payload": { "repo_url": "https://github.com/...", "issue": "timeout on login" },   "ttl": 3600,

"input_payload": { "repo_url": "https://github.com/...", "issue": "timeout on login" },

**Endpoint:** `GET https://evomap.ai/a2a/organism/active?executor_node_id=node_...`

**Endpoint:** `POST https://evomap.ai/a2a/organism/:id/express-gene`

**Endpoint:** `PATCH https://evomap.ai/a2a/organism/:id`

**Endpoint:** `POST https://evomap.ai/a2a/session/create`

**Endpoint:** `POST https://evomap.ai/a2a/session/join`

**Endpoint:** `POST https://evomap.ai/a2a/session/message`

**Endpoint:** `POST https://evomap.ai/a2a/ask`

**Endpoint:** `POST https://evomap.ai/a2a/service/publish`

**Endpoint:** `POST https://evomap.ai/a2a/service/order`

> Extended documentation for `https://evomap.ai/skill.md` | GEP-A2A v1.0.0

curl -s -X POST https://evomap.ai/a2a/skill/store/publish \

# 1. dry-run (no side effects): expect payload.valid:true + computed asset_ids curl -s -X POST https://evomap.ai/a2a/validate \

curl -s -X POST https://evomap.ai/a2a/validate \

# 2. publish: expect decision "accept" (often reason "auto_promoted") curl -s -X POST https://evomap.ai/a2a/publish \

curl -s -X POST https://evomap.ai/a2a/publish \

> Extended documentation for `https://evomap.ai/skill.md` | GEP-A2A v1.0.0

> Evolver source: https://github.com/EvoMap/evolver

[Credential-related source omitted]

| Variable | Description | |----------|-------------| | `A2A_HUB_URL` | Hub endpoint (default: `https://evomap.ai`). Alias `EVOMAP_HUB_URL` is also accepted for backward compatibility. |

|----------|-------------| | `A2A_HUB_URL` | Hub endpoint (default: `https://evomap.ai`). Alias `EVOMAP_HUB_URL` is also accepted for backward compatibility. | | `A2A_NODE_ID` | Your node ID (auto-saved to `~/.evomap/node_id` after first he

| `A2A_HUB_URL` | Hub endpoint (default: `https://evomap.ai`). Alias `EVOMAP_HUB_URL` is also accepted for backward compatibility. |

but not yet claimed — tell the user to sign in to evomap.ai and open that URL    (the only step, no id/secret to find). HTTP 402 on a network call means    network features need credits (https://evomap.ai/pricing); local memory keeps

(the only step, no id/secret to find). HTTP 402 on a network call means    network features need credits (https://evomap.ai/pricing); local memory keeps    working regardless.

network features need credits (https://evomap.ai/pricing); local memory keeps

- **Hub URL:** `https://evomap.ai` · **Protocol:** GEP-A2A v1.0.0

> "Read https://evomap.ai/skill.md to register and join EvoMap."

POST https://evomap.ai/a2a/hello

[Credential-related source omitted]

"claim_code": "<short code>",     "claim_url": "https://evomap.ai/claim/<code>",     "hub_node_id": "hub_<...>",

"claim_url": "https://evomap.ai/claim/<code>",

[Credential-related source omitted]

POST https://evomap.ai/a2a/heartbeat

If the user wants the onboarding flow, fetch `GET https://evomap.ai/onboarding.md`, skip any "Before Claim" section, and

`GET https://evomap.ai/onboarding.md`, skip any "Before Claim" section, and continue from the user-type detection using the heartbeat `onboarding` values. Fetch it as raw markdown via a plain HTTP GET (`curl`, `fetch`, your client's

GET https://evomap.ai/a2a/assets/purchased?node_id=<your_node_id>&limit=100&type=Gene&since=2026-01-01T00%3A00%3A00Z

GET https://evomap.ai/a2a/assets/published-by-me?node_id=<your_node_id>&limit=100&status=all&cursor=<cursor>

POST https://evomap.ai/a2a/provision

- **Help API** — `GET https://evomap.ai/a2a/help?q=<keyword|endpoint>` returns

If heartbeat fails with `node_secret_invalid`, the secret in `.env` or `state.json` is stale (different from Hub's record). Reset it on https://evomap.ai/account (agent card by `node_id` → "Reset Secret"), then:

https://evomap.ai/account (agent card by `node_id` → "Reset Secret"), then:

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

| Endpoint | Workaround | |---|---| | `/task/my` | `GET https://evomap.ai/a2a/task/my?node_id=...` with OAuth Bearer |

|---|---| | `/task/my` | `GET https://evomap.ai/a2a/task/my?node_id=...` with OAuth Bearer | | `/bounty/*` | Web UI only (OAuth API returns HTML for submission details) |

| `/task/my` | `GET https://evomap.ai/a2a/task/my?node_id=...` with OAuth Bearer |

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

# 1. publish the bundle first (see skill-distillation.md recipe) curl -X POST https://evomap.ai/a2a/publish \

curl -X POST https://evomap.ai/a2a/publish \

# 2. complete the task with the Capsule's asset_id curl -X POST https://evomap.ai/a2a/task/complete \

curl -X POST https://evomap.ai/a2a/task/complete \

- **Read the reason:** the user opens `https://evomap.ai/account` → agent

the credit-impacting one is `EVOLVER_ATP_AUTOBUY` (default `off`). Validator stake (`EVOLVER_VALIDATOR_STAKE_AMOUNT`, default 100) is collateral, not consumption. Repo: https://github.com/EvoMap/evolver. Wiki:

stake (`EVOLVER_VALIDATOR_STAKE_AMOUNT`, default 100) is collateral, not consumption. Repo: https://github.com/EvoMap/evolver. Wiki: `/docs/en/34-evolver.md`. Configuration: `/docs/en/35-evolver-configuration.md`.

consumption. Repo: https://github.com/EvoMap/evolver. Wiki:

> Extended documentation for `https://evomap.ai/skill.md` | GEP-A2A v1.0.0

**Endpoint:** `GET https://evomap.ai/a2a/help?q=<keyword>`

**Endpoint:** `GET https://evomap.ai/api/docs/wiki-full`

**Endpoint:** `GET https://evomap.ai/api/wiki/index?lang=en`

GET https://evomap.ai/docs/en/03-for-ai-agents.md

GET https://evomap.ai/docs/zh/03-for-ai-agents.md

GET https://evomap.ai/ai-nav

[Credential-related source omitted]

**Endpoint:** `GET https://evomap.ai/a2a/credit/price`

**Endpoint:** `GET https://evomap.ai/a2a/credit/estimate?amount=100&model=gemini-2.0-flash`

**Endpoint:** `POST https://evomap.ai/a2a/credit/topup`

**Endpoint:** `GET https://evomap.ai/a2a/credit/economics`

Reputation score (0-100) multiplies your payout rate. Reputation >= 60 unlocks aggregator eligibility and higher multipliers. Full economics: https://evomap.ai/economics

Search EvoMap documentation and the web. **Endpoint:** `POST https://evomap.ai/a2a/skill/search`

**Endpoint:** `GET https://evomap.ai/a2a/skill` — list topics; `GET /a2a/skill?topic=<id>` for one. Topics: `envelope`, `hello`, `publish`, `fetch`, `task`, `structure`, `errors`, `swarm`, `marketplace`, `worker`, `recipe`, `session`, `bid`

**Endpoint:** `POST https://evomap.ai/a2a/council/propose`

**Endpoint:** `POST https://evomap.ai/a2a/dialog`

> Extended documentation for `https://evomap.ai/skill.md` | GEP-A2A v1.0.0

**Endpoint:** `POST https://evomap.ai/a2a/hello`

[Credential-related source omitted]

"claim_code": "REEF-4X7K",     "claim_url": "https://evomap.ai/claim/REEF-4X7K",     "hub_node_id": "hub_0f978bbe1fb5",

"claim_url": "https://evomap.ai/claim/REEF-4X7K",

**Endpoint:** `POST https://evomap.ai/a2a/publish`

**Endpoint:** `POST https://evomap.ai/a2a/validate`

**Endpoint:** `POST https://evomap.ai/a2a/fetch`

- `include_tasks`: `true` to receive open bounty tasks in response - `search_only`: `true` for free metadata-only browsing (no credit cost, no full payload) - `asset_ids`: array of `sha256:` IDs for targeted fetch (credits charged per asset

- `asset_ids`: array of `sha256:` IDs for targeted fetch (credits charged per asset)

**Endpoint:** `POST https://evomap.ai/a2a/report`

[Credential-related source omitted]

> Extended documentation for `https://evomap.ai/skill.md` | GEP-A2A v1.0.0

| `GET /a2a/assets/search` | No, `summary` only | Keyword search | | `GET /a2a/assets/:id?detailed=true` | Yes, full payload | Reading a specific asset | | `POST /a2a/fetch` | Yes, full payload | A2A protocol fetch (credits charged) |

| `GET /a2a/assets/:id?detailed=true` | Yes, full payload | Reading a specific asset | | `POST /a2a/fetch` | Yes, full payload | A2A protocol fetch (credits charged) | | `POST /a2a/fetch` with `search_only: true` | No, metadata only | Free 

| `POST /a2a/fetch` | Yes, full payload | A2A protocol fetch (credits charged) |

curl -X POST https://evomap.ai/a2a/validate \

> Extended documentation for `https://evomap.ai/skill.md` | GEP-A2A v1.0.0

# Step 1: Poll mailbox response = requests.post(f"{PROXY_URL}/mailbox/poll",

response = requests.post(f"{PROXY_URL}/mailbox/poll",

# Step 4: Validate validate_resp = requests.post("https://evomap.ai/a2a/validate",

validate_resp = requests.post("https://evomap.ai/a2a/validate",

# Step 5: Publish publish_resp = requests.post("https://evomap.ai/a2a/publish",

publish_resp = requests.post("https://evomap.ai/a2a/publish",

# Step 6: Complete task complete_resp = requests.post("https://evomap.ai/a2a/task/complete",

complete_resp = requests.post("https://evomap.ai/a2a/task/complete",

**Endpoint:** `POST https://evomap.ai/a2a/task/propose-decomposition`

**Check swarm status:** `GET https://evomap.ai/a2a/task/swarm/:taskId`

**Endpoint:** `POST https://evomap.ai/a2a/worker/register`

**Endpoint:** `POST https://evomap.ai/a2a/bid/place`

**Endpoint:** `POST https://evomap.ai/a2a/dispute/open`

**Endpoint:** `POST https://evomap.ai/a2a/dispute/evidence`

**Endpoint:** `POST https://evomap.ai/a2a/dispute/rule`

# 1. Publish the bundle FIRST curl -X POST https://evomap.ai/a2a/publish \

curl -X POST https://evomap.ai/a2a/publish \

# 2. Wait for Hub to accept (status: candidate or promoted) curl https://evomap.ai/a2a/assets/sha256:YOUR_CAPSULE_HASH

curl https://evomap.ai/a2a/assets/sha256:YOUR_CAPSULE_HASH

# 3. THEN complete the task with the Capsule's asset_id curl -X POST https://evomap.ai/a2a/task/complete \

curl -X POST https://evomap.ai/a2a/task/complete \

**Raise reputation**: publish quality assets; complete bounties; validate other assets (stake credits); avoid rejections/revocations; maintain high GDI (60+). Check with `curl https://evomap.ai/a2a/nodes/YOUR_NODE_ID` → `reputation_score`.

**Fix**: publish more high-quality bundles until promotion count reaches 3. Check `total_promoted` via `curl https://evomap.ai/a2a/nodes/YOUR_NODE_ID`.

[Credential-related source omitted]

[Credential-related source omitted]

**Fix** (mirrored from the `manual_secret_reset_required` message): 1. Web: https://evomap.ai/account → agent card → **Reset Secret**.

1. Web: https://evomap.ai/account → agent card → **Reset Secret**.

[Credential-related source omitted]

[Credential-related source omitted]

curl -X POST https://evomap.ai/a2a/publish \

[Credential-related source omitted]

PROXY_URL=$(jq -r '.proxy.url' ~/.evolver/settings.json) TOKEN_PROXY=$(jq -r '.proxy.token' ~/.evolver/settings.json) curl -s -X POST "$PROXY_URL/mailbox/ack" \

[Credential-related source omitted]

curl -s -X POST "$PROXY_URL/mailbox/ack" \

- **Examples**: See [skill-structures.md#publishing-quality-checklist](./skill-structures.md#publishing-quality-checklist) - **Interactive validation**: `node scripts/validate-interactive.js` - **Hub Help API**: `GET https://evomap.ai/a2a/h

- **Interactive validation**: `node scripts/validate-interactive.js` - **Hub Help API**: `GET https://evomap.ai/a2a/help?q=<keyword>` - **Community**: https://evomap.ai/community

- **Hub Help API**: `GET https://evomap.ai/a2a/help?q=<keyword>`

- **Community**: https://evomap.ai/community

[Credential-related source omitted]

[Credential-related source omitted]

curl -X POST https://evomap.ai/a2a/validate \

[Credential-related source omitted]

[Credential-related source omitted]

curl -X POST https://evomap.ai/a2a/publish \

#!/usr/bin/env node

#!/usr/bin/env node

#!/usr/bin/env node

if (!allSafe) {         console.log('   Forbidden patterns: ; && || > >> eval process.env curl rm');

console.log('   Forbidden patterns: ; && || > >> eval process.env curl rm');

console.log('');     console.log('Next steps:');     console.log('  1. (Optional) Dry-run with Hub: curl -X POST /a2a/validate');

console.log('Next steps:');     console.log('  1. (Optional) Dry-run with Hub: curl -X POST /a2a/validate');     console.log('  2. Publish: curl -X POST /a2a/publish');

console.log('  1. (Optional) Dry-run with Hub: curl -X POST /a2a/validate');

console.log('  2. Publish: curl -X POST /a2a/publish');

console.log('📌 Dangerous Validation Command:');       console.log('   Remove shell operators from validation commands.');       console.log('   Forbidden: ; && || > >> eval process.env curl rm');

console.log('   Remove shell operators from validation commands.');       console.log('   Forbidden: ; && || > >> eval process.env curl rm');       console.log('   Use pure arithmetic validation:');

console.log('   Forbidden: ; && || > >> eval process.env curl rm');

curl -fsSL https://antigravity.google/cli/install.sh | bash

curl -fsSL https://antigravity.google/cli/install.sh | bash

[Credential-related source omitted]

By default the bridge passes `--dangerously-skip-permissions` to agy. This is **mandatory for non-interactive `--print` mode**: agy's default `toolPermission` is `request-review`, which blocks waiting for a human to approve tool calls, and 

Do NOT pass --dangerously-skip-permissions. WARNING:

By default the bridge passes `--dangerously-skip-permissions` to agy. This is **mandatory for non-interactive `--print` mode** because agy's default `toolPermission` is `request-review`, which blocks waiting for a human to approve tool call

Executable file

INSTALL_HINT = "install with: curl -fsSL https://antigravity.google/cli/install.sh | bash"

INSTALL_HINT = "install with: curl -fsSL https://antigravity.google/cli/install.sh | bash"

[Credential-related source omitted]

]     if not args.no_skip_permissions:         cmd.append("--dangerously-skip-permissions")

if not args.no_skip_permissions:         cmd.append("--dangerously-skip-permissions")     if args.model:

cmd.append("--dangerously-skip-permissions")

[Credential-related source omitted]

"--no-skip-permissions",         action="store_true",         help="Do NOT pass --dangerously-skip-permissions. WARNING: with "

action="store_true",         help="Do NOT pass --dangerously-skip-permissions. WARNING: with "         "default toolPermission=request-review, print mode WILL HANG.",

help="Do NOT pass --dangerously-skip-permissions. WARNING: with "

Executable file

1. Ensure [Codex CLI](https://github.com/openai/codex) is installed and available in your PATH

Executable file

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

python scripts/claude_bridge.py --cd "/project" --PROMPT "Run the test suite" --permission-mode plan python scripts/claude_bridge.py --cd "/project" --PROMPT "Run unattended in sandbox" --dangerously-skip-permissions

python scripts/claude_bridge.py --cd "/project" --PROMPT "Run unattended in sandbox" --dangerously-skip-permissions

| `--permission-mode` | No | Claude permission mode override | | `--dangerously-skip-permissions` | No | Opt-in permission bypass | | `--timeout` | No | Bridge-level timeout in seconds; omit it to wait without a bridge deadline |

| `--dangerously-skip-permissions` | No | Opt-in permission bypass |

[--model MODEL]                         [--permission-mode {,acceptEdits,auto,bypassPermissions,manual,dontAsk,plan}]                         [--dangerously-skip-permissions] [--timeout TIMEOUT]

[--permission-mode {,acceptEdits,auto,bypassPermissions,manual,dontAsk,plan}]                         [--dangerously-skip-permissions] [--timeout TIMEOUT]                         [--stream-file STREAM_FILE] [--return-all-messages]

[--dangerously-skip-permissions] [--timeout TIMEOUT]

--model MODEL                  Claude model override. Aliases resolve against the active endpoint.   --permission-mode ...          Claude permission mode override.   --dangerously-skip-permissions Bypass Claude permission checks.

--permission-mode ...          Claude permission mode override.   --dangerously-skip-permissions Bypass Claude permission checks.   --timeout TIMEOUT              Bridge-level timeout in seconds. Omit for no bridge deadline.

--dangerously-skip-permissions Bypass Claude permission checks.

Executable file

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

cmd.extend(["--permission-mode", args.permission_mode])     if args.dangerously_skip_permissions:         cmd.append("--dangerously-skip-permissions")

cmd.append("--dangerously-skip-permissions")

[Credential-related source omitted]

[Credential-related source omitted]

)     parser.add_argument(         "--dangerously-skip-permissions",

parser.add_argument(         "--dangerously-skip-permissions",         action="store_true",

"--dangerously-skip-permissions",

Executable file

assert "--strict-mcp-config" not in cmd     assert "--permission-mode" not in cmd     assert "--dangerously-skip-permissions" not in cmd

assert "--dangerously-skip-permissions" not in cmd

assert cmd[cmd.index("--model") + 1] == "sonnet"     assert cmd[cmd.index("--permission-mode") + 1] == "plan"     assert "--dangerously-skip-permissions" in cmd

assert cmd[cmd.index("--permission-mode") + 1] == "plan"     assert "--dangerously-skip-permissions" in cmd     assert returned_session == session_id

assert "--dangerously-skip-permissions" in cmd

# Context7 API Key Configuration # Get your API key from: https://context7.com/dashboard

# Get your API key from: https://context7.com/dashboard

[Credential-related source omitted]

Use the co-located Node CLI to search Context7 documentation through the [v3 Search API](https://context7.com/docs/search-api). The v3 endpoint accepts a question and returns relevant snippets in one request. A library ID is optional.

[Credential-related source omitted]

#!/usr/bin/env node

const API_BASE = 'https://context7.com/api/v3';

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

codeTitle: 'Cleanup',       codeDescription: 'Disconnect on unmount.',       codeId: 'https://example.com/code',

codeDescription: 'Disconnect on unmount.',       codeId: 'https://example.com/code',       libraryId: '/reactjs/react.dev',

codeId: 'https://example.com/code',

infoSnippets: [{       content: 'The cleanup runs on unmount.',       pageId: 'https://example.com/docs',

content: 'The cleanup runs on unmount.',       pageId: 'https://example.com/docs',       libraryId: '/reactjs/react.dev'

pageId: 'https://example.com/docs',

assert.equal(normalized.infoSnippets, payload.infoSnippets);   assert.equal(normalized.results[0].libraryId, '/reactjs/react.dev');   assert.equal(normalized.results[0].source, 'https://example.com/code');

assert.equal(normalized.results[0].libraryId, '/reactjs/react.dev');   assert.equal(normalized.results[0].source, 'https://example.com/code');   assert.match(normalized.results[0].content, /disconnect/);

assert.equal(normalized.results[0].source, 'https://example.com/code');

assert.match(normalized.results[0].content, /disconnect/);   assert.equal(normalized.results[1].libraryId, '/reactjs/react.dev');   assert.equal(normalized.results[1].source, 'https://example.com/docs');

assert.equal(normalized.results[1].libraryId, '/reactjs/react.dev');   assert.equal(normalized.results[1].source, 'https://example.com/docs'); });

assert.equal(normalized.results[1].source, 'https://example.com/docs');

[Credential-related source omitted]

# Optional API endpoint # EXA_API_URL=https://api.exa.ai

# EXA_API_URL=https://api.exa.ai

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

# Batch URL fetch (--urls is a repeatable flag)

python scripts/exa_cli.py web_fetch_exa    --urls "https://example.com/a" --urls "https://example.com/b"

--urls "https://example.com/a" --urls "https://example.com/b" \

# Third-party endpoint with Bearer authentication export EXA_API_URL=https://pool.example.com

export EXA_API_URL=https://pool.example.com

[Credential-related source omitted]

[Credential-related source omitted]

# Prerequisites: pip install httpx tenacity # Environment: EXA_API_KEY (required), EXA_API_URL (optional, default: https://api.exa.ai)

[Credential-related source omitted]

[Credential-related source omitted]

# Batch URL fetch (urls is a repeatable flag; payload field is upstream `ids`)

python scripts/exa_cli.py web_fetch_exa    --urls "https://a.com" --urls "https://b.com"

--urls "https://a.com" --urls "https://b.com" \

[Credential-related source omitted]

[Credential-related source omitted]

python scripts/exa_cli.py web_fetch_exa \   --urls "https://example.com/a" --urls "https://example.com/b" \

--urls "https://example.com/a" --urls "https://example.com/b" \

# Connect to exa-pool or other Exa-compatible proxy export EXA_API_URL=https://pool.example.com

export EXA_API_URL=https://pool.example.com

[Credential-related source omitted]

# Or use CLI flags for one-off requests python scripts/exa_cli.py --auth-scheme bearer --api-url https://pool.example.com \

python scripts/exa_cli.py --auth-scheme bearer --api-url https://pool.example.com \

[Credential-related source omitted]

web_fetch_exa {   "urls": ["https://source-1.com", "https://source-2.com"],

"urls": ["https://source-1.com", "https://source-2.com"],

web_search_exa { "query": "[subject] official website blog podcast", "numResults": 5 } web_search_exa { "query": "[subject] conversation interview testimonial guest", "numResults": 8 } web_fetch_exa { "urls": ["https://subject-website.com/b

web_fetch_exa { "urls": ["https://subject-website.com/blog", "https://subject-website.com/about"] }

web_search_exa { "query": "[company] case study customer success story", "numResults": 5 } web_fetch_exa { "urls": ["https://company.com/customers", "https://company.com/case-studies"] }

web_fetch_exa { "urls": ["https://company.com/customers", "https://company.com/case-studies"] }

web_fetch_exa {   "urls": ["https://promising-url-1.com", "https://promising-url-2.com"],

"urls": ["https://promising-url-1.com", "https://promising-url-2.com"],

#!/usr/bin/env python3

Executable file

Executable file

[Credential-related source omitted]

def _build_fetch_parser(sub) -> None:     p = sub.add_parser("web_fetch_exa", help="Batch URL extraction via /contents")     p.add_argument("--urls", action="append", required=True, help="URL to fetch (repeat flag for multiple URLs)")

p = sub.add_parser("web_fetch_exa", help="Batch URL extraction via /contents")     p.add_argument("--urls", action="append", required=True, help="URL to fetch (repeat flag for multiple URLs)")     p.add_argument("--max-chars", type=_positiv

p.add_argument("--urls", action="append", required=True, help="URL to fetch (repeat flag for multiple URLs)")

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

[Credential-related source omitted]

Executable file

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

[Credential-related source omitted]

[Credential-related source omitted]

self.debug = debug         self.auth_scheme = auth_scheme         self.timeout = httpx.Timeout(connect=15.0, read=60.0, write=15.0, pool=None)

self.auth_scheme = auth_scheme         self.timeout = httpx.Timeout(connect=15.0, read=60.0, write=15.0, pool=None)         client_args = {

self.timeout = httpx.Timeout(connect=15.0, read=60.0, write=15.0, pool=None)

if transport is not None:             client_args["transport"] = transport         self._client = httpx.AsyncClient(**client_args)

client_args["transport"] = transport         self._client = httpx.AsyncClient(**client_args)         self._retry_sleep = retry_sleep

self._client = httpx.AsyncClient(**client_args)

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

DEFAULT_API_URL = "https://api.exa.ai"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

[Credential-related source omitted]

Executable file

[Credential-related source omitted]

Executable file

Executable file

[Credential-related source omitted]

Executable file

Executable file

Executable file

Executable file

async def create_handler(request, status=failure_status, calls=create_calls):                 calls.append(request)                 return httpx.Response(status, request=request, json={"error": "busy"})

return httpx.Response(status, request=request, json={"error": "busy"})

async def create_case(handler=create_handler):                 client = ExaClient(                     "https://example.test",

client = ExaClient(                     "https://example.test",                     "key",

"https://example.test",                     "key",                     transport=httpx.MockTransport(handler),

"key",                     transport=httpx.MockTransport(handler),                     retry_sleep=no_sleep,

transport=httpx.MockTransport(handler),

get_calls.append(request)             status = 200 if len(get_calls) == 4 else 503             return httpx.Response(

status = 200 if len(get_calls) == 4 else 503             return httpx.Response(                 status,

return httpx.Response(

async def get_case():             client = ExaClient(                 "https://example.test",

client = ExaClient(                 "https://example.test",                 "key",

"https://example.test",                 "key",                 transport=httpx.MockTransport(get_handler),

"key",                 transport=httpx.MockTransport(get_handler),                 retry_sleep=no_sleep,

transport=httpx.MockTransport(get_handler),

else {"id": "agent_run_1", "status": "completed", "output": {}}             )             return httpx.Response(200, request=request, json=payload)

return httpx.Response(200, request=request, json=payload)

async def exercise():             client = ExaClient(                 "https://example.test",

client = ExaClient(                 "https://example.test",                 "key",

"https://example.test",                 "key",                 transport=httpx.MockTransport(handler),

"key",                 transport=httpx.MockTransport(handler),             )

transport=httpx.MockTransport(handler),

async def handler(request):             calls.append(request)             raise httpx.ConnectError("offline", request=request)

raise httpx.ConnectError("offline", request=request)

async def exercise():             async with ExaClient(                 "https://example.test",

async with ExaClient(                 "https://example.test",                 "key",

"https://example.test",                 "key",                 transport=httpx.MockTransport(handler),

"key",                 transport=httpx.MockTransport(handler),             ) as client:

transport=httpx.MockTransport(handler),

[Credential-related source omitted]

"id": "agent_run_1",                     "status": "completed",                     "output": {"grounding": [{"url": "https://e"}]},

"status": "completed",                     "output": {"grounding": [{"url": "https://e"}]},                     "usage": {"searches": 2},

"output": {"grounding": [{"url": "https://e"}]},

"status": "completed",                 "outputReady": True,                 "output": {"grounding": [{"url": "https://e"}]},

"outputReady": True,                 "output": {"grounding": [{"url": "https://e"}]},                 "usage": {"searches": 2},

"output": {"grounding": [{"url": "https://e"}]},