Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 21 additions & 5 deletions docs/assets/deepwiki.css
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,7 @@ body:has(.experience[data-theme="dark"]) .dw-panel {
width: 30px; height: 30px; border: 0; border-radius: 8px;
background: transparent; color: var(--dw-muted);
display: grid; place-items: center; cursor: pointer;
text-decoration: none;
}
.dw-icon-btn:hover { background: var(--dw-soft); color: var(--dw-ink); }
.dw-icon-btn svg { width: 16px; height: 16px; }
Expand All @@ -114,7 +115,7 @@ body:has(.experience[data-theme="dark"]) .dw-panel {
.dw-log {
flex: 1; min-height: 200px; max-height: 430px; overflow: auto;
display: flex; flex-direction: column; gap: .75rem;
padding: .9rem; scroll-behavior: smooth;
padding: .9rem; scroll-behavior: smooth; overscroll-behavior: contain;
}

.dw-empty { padding: .35rem .2rem; text-align: left; }
Expand Down Expand Up @@ -191,7 +192,13 @@ body:has(.experience[data-theme="dark"]) .dw-md a { color: var(--dw-accent); }
border-left: 2px solid #9ec363; color: var(--dw-muted);
}

.dw-thinking .dw-bubble { display: flex; align-items: center; gap: .45rem; color: var(--dw-muted); }
.dw-thinking .dw-bubble { display: flex; align-items: center; flex-wrap: wrap; gap: .45rem; color: var(--dw-muted); }
.dw-stop {
margin-left: auto; padding: 0; border: 0; background: transparent;
color: var(--dw-muted); font: 600 .58rem/1.2 inherit;
text-decoration: underline; cursor: pointer;
}
.dw-stop:hover { color: var(--dw-ink); }
.dw-dots { display: inline-flex; gap: 3px; }
.dw-dots i { width: 4px; height: 4px; border-radius: 50%; background: currentColor; animation: dw-blink 1.2s infinite; }
.dw-dots i:nth-child(2) { animation-delay: .15s; }
Expand All @@ -202,6 +209,13 @@ body:has(.experience[data-theme="dark"]) .dw-md a { color: var(--dw-accent); }
body[data-md-color-scheme="slate"] .dw-error,
body:has(.experience[data-theme="dark"]) .dw-error { color: #ff9d8a; }
.dw-error a { color: inherit; font-weight: 700; }
.dw-retry {
margin-top: .45rem; padding: .3rem .55rem;
border: 1px solid var(--dw-line); border-radius: 6px;
background: var(--dw-paper); color: var(--dw-ink);
font: 650 .62rem/1.2 inherit; cursor: pointer;
}
.dw-retry:hover { border-color: #8aaa4c; }

.dw-form { padding: .65rem .9rem .55rem; border-top: 1px solid var(--dw-line); background: var(--dw-paper); }
.dw-input-wrap {
Expand All @@ -223,10 +237,11 @@ body:has(.experience[data-theme="dark"]) .dw-error { color: #ff9d8a; }
.dw-send:disabled { opacity: .45; cursor: wait; }
.dw-send svg { width: 15px; height: 15px; }
.dw-hint {
display: flex; justify-content: space-between; gap: .5rem;
padding: .4rem .1rem 0; color: var(--dw-muted); font-size: .58rem; line-height: 1.4;
display: flex; flex-wrap: wrap; align-items: flex-start; justify-content: space-between; gap: .35rem .5rem;
padding: .4rem .1rem 0; color: var(--dw-muted); font-size: .58rem; line-height: 1.45;
}
.dw-hint a { color: inherit; text-decoration: underline; }
.dw-hint span { max-width: 32em; }
.dw-hint a { color: inherit; text-decoration: underline; white-space: nowrap; }

/* Never float over Material's search overlay. */
body:has(#__search:checked) .dw-launcher,
Expand All @@ -236,6 +251,7 @@ body:has(#__search:checked) .dw-panel { display: none !important; }
body:has(.experience) .md-top { display: none !important; }

@media (max-width: 650px) {
.dw-form { padding-bottom: calc(.55rem + env(safe-area-inset-bottom)); }
.dw-launcher {
right: .75rem; bottom: .75rem; width: 54px; height: 54px;
padding: 0; justify-content: center; border-radius: 50%;
Expand Down
67 changes: 58 additions & 9 deletions docs/assets/deepwiki.js
Original file line number Diff line number Diff line change
Expand Up @@ -5,13 +5,23 @@
var REPO = 'ThinkFlowLab/agentdescent';
var ENDPOINT = 'https://mcp.deepwiki.com/mcp';
var PAGE = 'https://deepwiki.com/' + REPO;

// GitHub Pages serves this site under /agentdescent/, a local build sits at /,
// and only Pages punishes a root-absolute href. Derive the base from this
// script's own URL so the in-panel links resolve in both places. With no
// script element there is no safe base, so the two anchors are left out
// instead of falling back to a literal that 404s on Pages.
var SELF = document.currentScript || document.querySelector('script[src$="assets/deepwiki.js"]');
var GUIDE = SELF ? new URL('../deepwiki/', SELF.src).href : null;

var icons = {
chat: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="M21 15a4 4 0 0 1-4 4H8l-5 3V7a4 4 0 0 1 4-4h10a4 4 0 0 1 4 4z"/></svg>',
logo: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="M5 4.5A2.5 2.5 0 0 1 7.5 2H20v17H7.5A2.5 2.5 0 0 0 5 21.5z"/><path d="M5 4.5v17"/><path d="M9 7h7M9 10h7"/></svg>',
spark: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="M12 3l1.8 5.2L19 10l-5.2 1.8L12 17l-1.8-5.2L5 10l5.2-1.8z"/><path d="M19 16l.8 2.2L22 19l-2.2.8L19 22l-.8-2.2L16 19l2.2-.8z"/></svg>',
refresh: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="M20 11a8 8 0 1 0-2.3 5.7"/><path d="M20 4v7h-7"/></svg>',
close: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="M6 6l12 12M18 6L6 18"/></svg>',
send: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="M12 19V5"/><path d="M6 11l6-6 6 6"/></svg>'
send: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="M12 19V5"/><path d="M6 11l6-6 6 6"/></svg>',
info: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M12 16v-5M12 8h.01"/></svg>'
};

var launcher = document.createElement('button');
Expand All @@ -35,6 +45,7 @@
'<div class="dw-brand"><span class="dw-logo">' + icons.logo + '</span>',
'<div><strong>DeepWiki</strong><span class="dw-repo"><i></i>' + REPO + '</span></div></div>',
'<div class="dw-head-actions">',
(GUIDE ? '<a class="dw-icon-btn" href="' + GUIDE + '" title="About DeepWiki and MCP" aria-label="About DeepWiki and MCP">' + icons.info + '</a>' : ''),
'<button type="button" class="dw-icon-btn" id="dw-new" aria-label="New chat" title="New chat">' + icons.refresh + '</button>',
'<button type="button" class="dw-icon-btn" id="dw-close" aria-label="Close" title="Close">' + icons.close + '</button>',
'</div></header>',
Expand All @@ -57,7 +68,7 @@
'<textarea id="dw-input" rows="1" placeholder="Ask about the code\u2026" aria-label="Your question"></textarea>',
'<button type="submit" class="dw-send" id="dw-send" aria-label="Send">' + icons.send + '</button>',
'</div>',
'<div class="dw-hint"><span>Enter to send \u00b7 model-generated</span><a href="/deepwiki/">MCP setup</a></div>',
'<div class="dw-hint"><span>DeepWiki is third-party and model-generated. Verify load-bearing answers against the source.</span>' + (GUIDE ? '<a href="' + GUIDE + '">Caveats</a>' : '') + '</div>',
'</form>'
].join('');

Expand All @@ -72,6 +83,8 @@
var newChat = panel.querySelector('#dw-new');
var emptyTemplate = log.querySelector('.dw-empty').cloneNode(true);
var busy = false;
var history = [];
var controller = null;

function scroll() { log.scrollTop = log.scrollHeight; }
function openPanel() {
Expand All @@ -93,6 +106,8 @@
});
}
function resetChat() {
if (controller) { controller.abort(); controller = null; }
history = [];
while (log.firstChild) log.removeChild(log.firstChild);
var empty = emptyTemplate.cloneNode(true);
log.appendChild(empty);
Expand Down Expand Up @@ -240,18 +255,29 @@
function thinking() {
var row = document.createElement('div');
row.className = 'dw-msg dw-bot dw-thinking';
row.innerHTML = '<span class="dw-avatar">DW</span><div class="dw-bubble"><span class="dw-dots"><i></i><i></i><i></i></span><span>Searching the index\u2026</span></div>';
row.innerHTML = '<span class="dw-avatar">DW</span><div class="dw-bubble"><span class="dw-dots"><i></i><i></i><i></i></span><span>Searching the index\u2026</span><button type="button" class="dw-stop">Stop</button></div>';
log.appendChild(row);
scroll();
return row;
}

function error(text) {
function error(text, question) {
var row = message('bot', text);
row.querySelector('.dw-bubble').classList.add('dw-error');
var link = document.createElement('p');
link.innerHTML = '<a href="' + PAGE + '" target="_blank" rel="noopener">Open the DeepWiki page \u2197</a>';
row.querySelector('.dw-md').appendChild(link);
if (question) {
var retry = document.createElement('button');
retry.type = 'button';
retry.className = 'dw-retry';
retry.textContent = 'Retry';
retry.addEventListener('click', function () {
row.remove();
ask(question);
});
row.querySelector('.dw-md').appendChild(retry);
}
scroll();
}

Expand All @@ -273,7 +299,7 @@
return last;
}

function call(question) {
function call(question, signal) {
var body = {
jsonrpc: '2.0',
id: 1,
Expand All @@ -286,7 +312,8 @@
return fetch(ENDPOINT, {
method: 'POST',
headers: { 'content-type': 'application/json', accept: 'application/json, text/event-stream' },
body: JSON.stringify(body)
body: JSON.stringify(body),
signal: signal
}).then(function (response) {
if (!response.ok) throw new Error('DeepWiki returned HTTP ' + response.status);
return response.text();
Expand All @@ -309,13 +336,35 @@
if (empty) empty.remove();
message('user', question);
var pending = thinking();
call(question).then(function (result) {
var stop = pending.querySelector('.dw-stop');
if (stop) stop.addEventListener('click', function () {
if (controller) controller.abort();
});
var context = history.slice(-2).map(function (item) {
return 'Q: ' + item.q + '\nA: ' + item.a.slice(0, 900);
}).join('\n\n');
var prompt = context
? 'Previous conversation for context:\n' + context + '\n\nNew question: ' + question
: question;
controller = ('AbortController' in window) ? new AbortController() : null;
call(prompt, controller ? controller.signal : undefined).then(function (result) {
if (pending.parentNode) pending.remove();
if (result.ok) message('bot', result.text); else error(result.text);
if (result.ok) {
history.push({ q: question, a: result.text });
if (history.length > 4) history.shift();
message('bot', result.text);
} else {
error(result.text, question);
}
}).catch(function (failure) {
if (pending.parentNode) pending.remove();
error('DeepWiki is unavailable right now: ' + failure.message);
if (failure && failure.name === 'AbortError') {
error('Stopped. Ask again when you are ready.', question);
} else {
error('DeepWiki is unavailable right now: ' + failure.message, question);
}
}).then(function () {
controller = null;
busy = false;
send.disabled = false;
input.focus();
Expand Down
11 changes: 11 additions & 0 deletions tests/test_site_navigation.py
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,17 @@ def test_header_breakpoint_keeps_the_drawer_as_the_mobile_route():
assert '{{ nav.homepage.url | url }}#demo' in header


def test_deepwiki_links_derive_their_base_from_the_script_url():
# The site is published under /agentdescent/ but served at / locally, so a
# root-absolute href works in CI and 404s on Pages. Both in-panel links must
# take the base from the loaded script instead, and with no script element
# they are left out rather than pointed at a literal that 404s.
js = (ROOT / "docs" / "assets" / "deepwiki.js").read_text()
assert 'href="/deepwiki/"' not in js
assert "new URL('../deepwiki/', SELF.src).href : null" in js
assert js.count('href="\' + GUIDE + \'"') == 2


def verify_rendered_site(site):
cfg = config()
destination = cfg["site_url"] + "#demo"
Expand Down
Loading