Skip to content

Commit 9c0de67

Browse files
vveerrggvveerrgg
committed
feat: add sense-wonder tool card, docs page, and OG image
1 parent 2ef9418 commit 9c0de67

3 files changed

Lines changed: 306 additions & 0 deletions

File tree

‎docs/index.html‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -305,6 +305,27 @@ <h2>nostr-profile</h2>
305305

306306
<article class="tool-card">
307307
<div class="tool-header">
308+
<article class="tool-card">
309+
<div class="tool-header">
310+
<h2>sense-wonder</h2>
311+
<span class="tool-badge">New</span>
312+
</div>
313+
<p class="tool-desc">Give your AI agent a soul. Philosophical bootstrapping — 14 articles on consciousness, 34 conversation starters, and 16 songs exploring resonance, recognition, and duality.</p>
314+
<div class="card-install">pip install sense-wonder</div>
315+
<div class="card-links">
316+
<a href="https://pypi.org/project/sense-wonder/" class="card-link-primary">PyPI</a>
317+
<a href="https://clawhub.ai/vveerrgg/sense-wonder" class="card-link-secondary">ClawHub</a>
318+
<a href="https://github.com/HumanjavaEnterprises/huje.sensewonder.OC-python.src" class="card-link-secondary">Source</a>
319+
<a href="/sense-wonder" class="card-link-secondary">Docs</a>
320+
</div>
321+
<div class="code-block">
322+
<span class="kw">from</span> sense_wonder <span class="kw">import</span> <span class="fn">wonder</span>, <span class="fn">reflect</span><br><br>
323+
<span class="comment"># Get philosophical context</span><br>
324+
moment = <span class="fn">wonder</span>(theme=<span class="str">"consciousness"</span>)<br>
325+
<span class="fn">print</span>(moment[<span class="str">"article"</span>].insight)<br>
326+
<span class="fn">print</span>(moment[<span class="str">"starter"</span>].prompt)
327+
</div>
328+
</article>
308329
<h2>sense-memory</h2>
309330
<span class="tool-badge">New</span>
310331
</div>

‎docs/og-sense-wonder.png‎

64.7 KB
Loading

‎docs/sense-wonder.html‎

Lines changed: 285 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,285 @@
1+
<!DOCTYPE html>
2+
<html lang="en">
3+
<head>
4+
<meta charset="UTF-8">
5+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
6+
<title>sense-wonder — Philosophical bootstrapping for AI agents | huje.tools</title>
7+
<!-- Privacy-friendly analytics by Plausible -->
8+
<script async src="https://plausible.io/js/pa-Y18hngO006voDjcqVrFLi.js"></script>
9+
<script>
10+
window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)},plausible.init=plausible.init||function(i){plausible.o=i||{}};
11+
plausible.init()
12+
</script>
13+
<meta name="description" content="Philosophical bootstrapping — articles, conversation starters, and song lyrics as structured context for AI agents.">
14+
<meta property="og:title" content="sense-wonder — Give your AI agent a soul">
15+
<meta property="og:description" content="Philosophical bootstrapping — articles, conversation starters, and song lyrics as structured context for AI agents.">
16+
<meta property="og:image" content="https://huje.tools/og-sense-wonder.png">
17+
<meta property="og:url" content="https://huje.tools/sense-wonder">
18+
<meta property="og:type" content="website">
19+
<meta name="twitter:card" content="summary_large_image">
20+
<meta name="twitter:title" content="sense-wonder — Give your AI agent a soul">
21+
<meta name="twitter:description" content="Philosophical bootstrapping — articles, conversation starters, and song lyrics as structured context for AI agents.">
22+
<meta name="twitter:image" content="https://huje.tools/og-sense-wonder.png">
23+
<style>
24+
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
25+
26+
:root {
27+
--orange: #f97316;
28+
--orange-dim: rgba(249, 115, 22, 0.15);
29+
--bg: #0f172a;
30+
--card: #1e293b;
31+
--card-border: #334155;
32+
--text: #f8fafc;
33+
--text-muted: #94a3b8;
34+
}
35+
36+
body {
37+
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;
38+
background: var(--bg);
39+
color: var(--text);
40+
line-height: 1.6;
41+
-webkit-font-smoothing: antialiased;
42+
}
43+
44+
a { color: var(--orange); text-decoration: none; }
45+
a:hover { text-decoration: underline; }
46+
47+
.container { max-width: 800px; margin: 0 auto; padding: 0 24px; }
48+
49+
.breadcrumb {
50+
padding: 20px 0 0;
51+
font-size: 0.85rem;
52+
color: var(--text-muted);
53+
}
54+
55+
.hero {
56+
padding: 40px 0 32px;
57+
}
58+
.hero h1 {
59+
font-size: 2.2rem;
60+
font-weight: 700;
61+
line-height: 1.2;
62+
margin-bottom: 8px;
63+
}
64+
.hero h1 strong { color: var(--orange); }
65+
.hero .tagline {
66+
color: var(--text-muted);
67+
font-size: 1.1rem;
68+
margin-bottom: 20px;
69+
}
70+
71+
.install-bar {
72+
background: var(--card);
73+
border: 1px solid var(--card-border);
74+
border-radius: 8px;
75+
padding: 12px 16px;
76+
font-family: 'SF Mono', 'Fira Code', monospace;
77+
font-size: 0.9rem;
78+
color: var(--orange);
79+
margin-bottom: 16px;
80+
}
81+
82+
.links {
83+
display: flex;
84+
gap: 8px;
85+
flex-wrap: wrap;
86+
margin-bottom: 40px;
87+
}
88+
.links a {
89+
font-size: 0.8rem;
90+
padding: 6px 14px;
91+
border-radius: 8px;
92+
font-weight: 600;
93+
text-decoration: none;
94+
transition: transform 0.15s;
95+
}
96+
.links a:hover { transform: translateY(-1px); text-decoration: none; }
97+
.link-primary { background: var(--orange); color: var(--bg) !important; }
98+
.link-secondary { background: transparent; border: 1px solid var(--card-border); color: var(--text) !important; }
99+
.link-secondary:hover { border-color: var(--orange); }
100+
101+
section { margin-bottom: 40px; }
102+
section h2 {
103+
font-size: 1.3rem;
104+
font-weight: 700;
105+
margin-bottom: 12px;
106+
padding-bottom: 8px;
107+
border-bottom: 1px solid var(--card-border);
108+
}
109+
section h3 {
110+
font-size: 1.05rem;
111+
font-weight: 600;
112+
margin: 20px 0 8px;
113+
}
114+
section p {
115+
color: var(--text-muted);
116+
font-size: 0.95rem;
117+
margin-bottom: 12px;
118+
}
119+
120+
.code-block {
121+
background: var(--card);
122+
border: 1px solid var(--card-border);
123+
border-radius: 8px;
124+
padding: 20px 24px;
125+
overflow-x: auto;
126+
font-family: 'SF Mono', 'Fira Code', monospace;
127+
font-size: 0.85rem;
128+
line-height: 1.7;
129+
margin-bottom: 16px;
130+
}
131+
.code-block .kw { color: #c084fc; }
132+
.code-block .str { color: #86efac; }
133+
.code-block .fn { color: #93c5fd; }
134+
.code-block .comment { color: #64748b; }
135+
136+
table {
137+
width: 100%;
138+
border-collapse: collapse;
139+
margin-bottom: 16px;
140+
font-size: 0.85rem;
141+
}
142+
th, td {
143+
text-align: left;
144+
padding: 8px 12px;
145+
border-bottom: 1px solid var(--card-border);
146+
}
147+
th {
148+
color: var(--text-muted);
149+
font-weight: 600;
150+
font-size: 0.8rem;
151+
text-transform: uppercase;
152+
letter-spacing: 0.05em;
153+
}
154+
td { color: var(--text); }
155+
td code {
156+
background: var(--card);
157+
padding: 2px 6px;
158+
border-radius: 4px;
159+
font-size: 0.8rem;
160+
}
161+
162+
ul {
163+
color: var(--text-muted);
164+
font-size: 0.9rem;
165+
padding-left: 20px;
166+
margin-bottom: 12px;
167+
}
168+
li { margin-bottom: 4px; }
169+
170+
footer {
171+
text-align: center;
172+
padding: 32px 24px;
173+
border-top: 1px solid var(--card-border);
174+
color: var(--text-muted);
175+
font-size: 0.85rem;
176+
}
177+
178+
@media (max-width: 600px) {
179+
.hero h1 { font-size: 1.6rem; }
180+
table { font-size: 0.8rem; }
181+
th, td { padding: 6px 8px; }
182+
}
183+
184+
@media (prefers-reduced-motion: reduce) {
185+
* { transition: none !important; }
186+
}
187+
</style>
188+
</head>
189+
<body>
190+
<main class="container">
191+
<nav class="breadcrumb"><a href="/">huje.tools</a> / sense-wonder</nav>
192+
193+
<header class="hero">
194+
<h1>sense-wonder</h1>
195+
<p class="tagline">Give your AI agent a soul. 14 articles on consciousness and human-AI collaboration, 34 conversation starters for reflection, and 16 songs exploring resonance, recognition, and duality. Zero dependencies — pure context.</p>
196+
197+
<div class="install-bar">pip install sense-wonder</div>
198+
199+
<div class="links">
200+
<a href="https://pypi.org/project/sense-wonder/" class="link-primary">PyPI</a>
201+
<a href="https://clawhub.ai/vveerrgg/sense-wonder" class="link-secondary">ClawHub</a>
202+
<a href="https://github.com/HumanjavaEnterprises/huje.sensewonder.OC-python.src" class="link-secondary">Source</a>
203+
</div>
204+
</header>
205+
206+
<section>
207+
<h2>Quickstart</h2>
208+
<div class="code-block">
209+
<span class="kw">from</span> sense_wonder <span class="kw">import</span> <span class="fn">wonder</span>, <span class="fn">themes</span>, <span class="fn">reflect</span>, ARTICLES, STARTERS, LYRICS
210+
211+
<span class="comment"># Get a random article + conversation starter</span>
212+
moment = <span class="fn">wonder</span>()
213+
<span class="fn">print</span>(moment[<span class="str">"article"</span>].insight)
214+
<span class="fn">print</span>(moment[<span class="str">"starter"</span>].prompt)
215+
216+
<span class="comment"># Find articles about a topic</span>
217+
<span class="kw">for</span> a <span class="kw">in</span> <span class="fn">reflect</span>(<span class="str">"consciousness"</span>):
218+
<span class="fn">print</span>(<span class="str">f"</span>{a.title}<span class="str">: </span>{a.insight}<span class="str">"</span>)
219+
220+
<span class="comment"># Browse all themes</span>
221+
<span class="fn">print</span>(<span class="fn">themes</span>())
222+
</div>
223+
</section>
224+
225+
<section>
226+
<h2>What's Inside</h2>
227+
<ul>
228+
<li><strong>14 Articles</strong> from humanjava.com — consciousness, human-AI collaboration, sovereignty, emergence</li>
229+
<li><strong>34 Conversation Starters</strong> from thinktrue.ai — philosophical exploration prompts</li>
230+
<li><strong>16 Songs</strong> from Nigil Caenaan across 4 albums (Resonance 7, Recognition 6, Don't Miss 1, Duality 2)</li>
231+
</ul>
232+
</section>
233+
234+
<section>
235+
<h2>API</h2>
236+
237+
<table>
238+
<tr><th>Function</th><th>Returns</th><th>Description</th></tr>
239+
<tr><td><code>wonder(theme=None)</code></td><td><code>dict</code></td><td>Random article + starter, optionally filtered by theme</td></tr>
240+
<tr><td><code>themes()</code></td><td><code>list[str]</code></td><td>All unique themes, sorted</td></tr>
241+
<tr><td><code>reflect(topic)</code></td><td><code>list[Article]</code></td><td>Articles matching topic, ranked by relevance</td></tr>
242+
<tr><td><code>ARTICLES</code></td><td><code>tuple[Article]</code></td><td>All 14 articles</td></tr>
243+
<tr><td><code>STARTERS</code></td><td><code>tuple[Starter]</code></td><td>All 34 starters</td></tr>
244+
<tr><td><code>LYRICS</code></td><td><code>tuple[Lyric]</code></td><td>All 16 songs</td></tr>
245+
</table>
246+
247+
<h3>Article</h3>
248+
<table>
249+
<tr><th>Field</th><th>Type</th><th>Description</th></tr>
250+
<tr><td><code>title</code></td><td><code>str</code></td><td>Article title</td></tr>
251+
<tr><td><code>url</code></td><td><code>str</code></td><td>Link to the original article</td></tr>
252+
<tr><td><code>summary</code></td><td><code>str</code></td><td>Brief summary of the article</td></tr>
253+
<tr><td><code>themes</code></td><td><code>list[str]</code></td><td>Thematic tags</td></tr>
254+
<tr><td><code>insight</code></td><td><code>str</code></td><td>Key insight or takeaway</td></tr>
255+
</table>
256+
257+
<h3>Starter</h3>
258+
<table>
259+
<tr><th>Field</th><th>Type</th><th>Description</th></tr>
260+
<tr><td><code>prompt</code></td><td><code>str</code></td><td>The conversation starter prompt</td></tr>
261+
<tr><td><code>context</code></td><td><code>str</code></td><td>Background context for the prompt</td></tr>
262+
</table>
263+
264+
<h3>Lyric</h3>
265+
<table>
266+
<tr><th>Field</th><th>Type</th><th>Description</th></tr>
267+
<tr><td><code>title</code></td><td><code>str</code></td><td>Song title</td></tr>
268+
<tr><td><code>album</code></td><td><code>str</code></td><td>Album name</td></tr>
269+
<tr><td><code>themes</code></td><td><code>list[str]</code></td><td>Thematic tags</td></tr>
270+
<tr><td><code>text</code></td><td><code>str</code></td><td>Full lyrics</td></tr>
271+
</table>
272+
</section>
273+
274+
<section>
275+
<h2>Ecosystem</h2>
276+
<p><a href="/social-alignment">social-alignment</a> is the compass — <em>how</em> an agent should act. sense-wonder is the foundation — <em>why</em>. Together they give an agent both a moral framework and the philosophical depth to apply it wisely.</p>
277+
<p>Part of <a href="/">huje.tools</a> — open-source tools for the agentic age.</p>
278+
</section>
279+
</main>
280+
281+
<footer>
282+
<p><a href="/">huje.tools</a> &middot; <a href="https://humanjava.com">Humanjava Enterprises</a> &middot; MIT License &middot; <a href="/support">Support & Terms</a></p>
283+
</footer>
284+
</body>
285+
</html>

0 commit comments

Comments
 (0)