agent-chief 0.3.1__py3-none-any.whl

agent_chief-0.3.1.dist-info/METADATA

@@ -0,0 +1,324 @@
+Metadata-Version: 2.4
+Name: agent-chief
+Version: 0.3.1
+Summary: Chief — the chief of staff for your agents and information sources
+Project-URL: Homepage, https://github.com/SmileLikeYe/agent-chief
+Project-URL: Repository, https://github.com/SmileLikeYe/agent-chief
+Project-URL: Issues, https://github.com/SmileLikeYe/agent-chief/issues
+Project-URL: Changelog, https://github.com/SmileLikeYe/agent-chief/releases
+Author: SmileLikeYe
+License: MIT
+License-File: LICENSE
+Keywords: agents,attention,chief-of-staff,interruption-management,llm,local-first,mcp,notifications,triage
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: aiosqlite>=0.22.1
+Requires-Dist: fastapi>=0.139.0
+Requires-Dist: fastmcp>=3.4.2
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: jinja2>=3.1
+Requires-Dist: plyer>=2.1.0
+Requires-Dist: pydantic>=2.7
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Requires-Dist: uvicorn>=0.50.0
+Provides-Extra: embeddings
+Requires-Dist: sentence-transformers>=3.0; extra == 'embeddings'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+<img src="docs/assets/logo.svg" alt="Chief" width="640"/>
+
+**Your agents don't need more power. They need a chief of staff.**
+
+[![CI](https://github.com/SmileLikeYe/agent-chief/actions/workflows/ci.yml/badge.svg)](https://github.com/SmileLikeYe/agent-chief/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/SmileLikeYe/agent-chief?color=6366f1)](https://github.com/SmileLikeYe/agent-chief/releases)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue)](pyproject.toml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Local First](https://img.shields.io/badge/local--first-no%20cloud%2C%20no%20telemetry-8b5cf6)](#privacy)
+
+[Quickstart](#-60-second-quickstart) · [How it works](#-how-it-decides) ·
+[Connect your agent](#-connect-your-agent-3-lines) · [Docs](docs/) ·
+[简体中文](README.zh-CN.md)
+
+</div>
+
+---
+
+<!-- metrics:start -->
+**24 events in → 1 interruption** (96% intercepted: 14 blocked outright, the rest batched, dispatched, or remembered)
+· only **75% of events ever reach the LLM** — the noisiest 25% dies on hard rules in microseconds, for free
+· stable-prefix prompts: **70% of judge input tokens cache-hit** (system + context blocks)
+· projected judgment cost **$0.104 per 1,000 events** (DeepSeek list prices, cache-aware)
+
+*(every number regenerates from the deterministic demo replay: `make readme-metrics`)*
+<!-- metrics:end -->
+
+Chief sits between you and everything that wants your attention — agents,
+heartbeats, CI, RSS, watchers. Everything flows into it; it thinks for itself;
+then it does exactly one of three things:
+
+1. 🔔 **Interrupt** you — only when worth it, at the right moment, *arriving with a plan*.
+2. 🤖 **Dispatch** work to your agents — and verify the result before reporting ("done" is a claim, not a proof).
+3. 📚 **Curate** into memory — facts and intents not worth mentioning now, waiting to be connected later.
+
+<div align="center">
+
+![demo](docs/assets/demo.gif)
+
+*A day of an engineer's life: 24 events in → 14 blocked · 6 batched · 3 handled · **interrupted exactly once**.*
+
+</div>
+
+## ✨ Highlights
+
+| | |
+|---|---|
+| 🧠 **Three-stage worthiness engine** | Hard rules (µs) → similarity classifier (ms) → LLM judge (only when needed). Cheap first, smart last. |
+| 🎭 **Scene-aware timing** | Sleeping / deep work / meeting / commute — per-scene interrupt thresholds. The *same* event rings at your desk and waits in a digest at 2 AM. |
+| 🕶️ **Shadow mode** | For its first 7 days Chief never actually interrupts — it shows you what it *would* have done, and earns the right to ring. |
+| 📝 **Explainable, editable policy** | Everything it learns distills nightly into a human-readable `POLICY.md`. Your edits win, effective immediately. |
+| ✅ **Verified dispatch** | Agents report "done"; Chief checks. Acceptance command or LLM second opinion — fails closed. |
+| 🔌 **Protocol, not pipes** | One `POST /v1/events` (or MCP `propose`) connects anything in minutes. |
+| 🔒 **Local-first** | One SQLite file + markdown under `~/.chief`. No cloud, no telemetry, no web UI. |
+
+## ⚡ 60-second quickstart
+
+```bash
+uvx agent-chief demo        # zero keys, zero config, fully offline
+```
+
+You'll watch a day of an engineer's life replay: 24 events in → 14 blocked ·
+6 batched · 3 handled (all verified) · **interrupted exactly once**.
+
+Ready for real sources?
+
+```bash
+uvx agent-chief init        # 60s wizard, every question skippable
+chief run                   # the resident brain
+```
+
+## 🔕 Kill the "all clear" reports
+
+If you run heartbeat agents, you know the ritual: *"All clear, nothing to
+report."* Every few hours. Forever. Each one costs a glance, and the glances
+add up until you stop reading — including the one that mattered.
+
+Chief drops zero-information reports on the floor (regex **and** embedding
+similarity against a canned empty-report set, both required — a security scan
+that *mentions* "all clear" still gets through). The demo opens and closes with
+this, because it's the single most requested feature among heartbeat users.
+
+## 🔍 Explainable judgment, every single time
+
+No decision is a black box. Every Decision carries its **reason, five scored
+components, the rules it matched, and what it cost** — and `chief trace`
+replays the whole chain after the fact:
+
+```console
+$ chief trace evt_20260706_1040_ab12
+CI failed on main: test_auth_flow broken by PR #482  dev.ci · github-actions
+route dispatch at stage 3 in scene deep_work (confidence 0.85)
+score 0.87  urgency=0.90 relevance=0.90 actionability=0.85 novelty=0.80 confidence=0.90
+┌────────────┬───────┬──────────────────────┐
+│ stage      │    ms │ note                 │
+│ stage1     │   0.1 │ no hard rule fired   │
+│ associate  │   1.2 │ 0 memory hits        │
+│ judge      │ 812.4 │ backend deepseek     │
+│ route      │   0.3 │ routed dispatch      │
+└────────────┴───────┴──────────────────────┘
+tokens: 1104 in (704 cached) / 96 out · prompt v1 · cost $0.000301
+```
+
+Prompts are versioned templates (`judge/templates/v1/`), the version is
+stamped into every decision, and **no prompt change merges without an eval
+diff** on the 200-case golden set (`chief eval --compare v1 v2`). If the LLM
+backend dies, Chief degrades to rules-only conservative routing — never
+interrupts while blind — and heals itself when the backend returns.
+
+## 📈 It learns your preferences — and proves it
+
+The 👍/👎 you give ("worth my attention" / "don't bother me") is a reward
+signal; the per-topic EMA weights are the policy; feedback trains them. Chief
+ships an eval that measures the loop closing — a simulated user with hidden
+preferences, corrected only by the ±1 signal:
+
+```console
+$ chief eval --learning
+Routing agreement: 0% → 100% (+100%) · converged in 2 rounds
+r 0 |                    | 0%
+r 1 |█████████████████   | 86%
+r 2 |████████████████████| 100%
+```
+
+No labels, no gradient, no black box (SPEC §13: explainable by construction).
+It corrects the *borderline* calls — the ones that actually need judgment,
+since stage-1 rules already handle the obvious. Watch the learned per-topic
+lean in the console's **Learning** tab, or reproduce the curve with
+`chief eval --learning`.
+
+> 📝 The engineering story behind Chief — the funnel, per-model cost accounting,
+> and the falsifiable learning loop — is written up in
+> **[docs/blog](docs/blog/heartbeat-agents-are-training-you-to-ignore-them.md)**.
+
+## 🕶️ Shadow mode: trust is earned
+
+For its first 7 days (or 50 graded samples), Chief **never actually interrupts
+you**. Would-be interrupts land in the digest annotated
+`⚡ would have: interrupted you (score 0.87, scene deep_work)` with ✓/✗ grading
+buttons. You watch it think, grade its calls, and only when it graduates does it
+earn the right to ring. Graduation comes with a **Tact Report** (`chief report`).
+
+## 🧠 How it decides
+
+Two axes, never one: **content worthiness × scene tolerance**.
+
+```mermaid
+flowchart LR
+    subgraph sources [Anything]
+        A1[Agents] & A2[CI / GitHub] & A3[RSS / watchers] & A4[Heartbeats]
+    end
+    sources -->|"POST /v1/events · MCP propose"| N[Normalize<br/>+ topic inference]
+    N --> S1{"Stage 1<br/>hard rules (µs)"}
+    S1 -->|survives| S2{"Stage 2<br/>similarity (ms)"}
+    S2 -->|unfamiliar| M[Associate<br/>memory] --> S3{"Stage 3<br/>LLM judge"}
+    S3 --> R["score × scene<br/>threshold"]
+    S2 -->|familiar| R
+    R --> I[🔔 interrupt]
+    R --> D[📰 digest]
+    R --> P[🤖 dispatch → verify] --> I
+    R --> C[📚 curate]
+    R --> X[🗑 drop]
+    SC["Scene engine<br/>clock · calendar · focus"] -.-> R
+    L["Learner<br/>EMA · nightly distill"] -.-> S1 & S2 & R
+```
+
+- A three-stage worthiness engine: hard rules (µs) → similarity classifier (ms)
+  → LLM judge (pluggable: **Ollama local**, DeepSeek, Anthropic, OpenAI).
+- A scene engine (clock, calendar, focus, lock state — pluggable providers)
+  with per-scene interrupt thresholds; low-confidence scenes degrade toward silence.
+- Every learned preference distills nightly into a **human-readable
+  [`POLICY.md`](policy/POLICY.template.md)** you can read and edit; your edits
+  win, effective immediately.
+
+Deep dive: **[docs/architecture.md](docs/architecture.md)**.
+
+## 🔌 Connect your agent (3 lines)
+
+```bash
+curl -X POST http://localhost:8787/v1/events \
+  -H "Authorization: Bearer $CHIEF_TOKEN" -H "Content-Type: application/json" \
+  -d '{"source":"my-agent","topic":"dev.ci","summary":"CI failed on main"}'
+```
+
+Chief answers with a Decision — route, score, and a one-line reason. MCP agents
+use the `propose` tool instead, and `chief lite` gives zero-daemon judgment for
+one-shot callers. Full contract: **[docs/protocol.md](docs/protocol.md)**
+· runnable samples: **[examples/](examples/)**.
+
+## 🖥️ The console — see it think, correct it in one click
+
+`chief ui` (or the resident `chief run`) serves a local console at
+`http://127.0.0.1:8787/ui` — single user, token-gated, no cloud:
+
+- **Today** — digest queue, interrupts, LLM share and spend at a glance
+- **History** — every decision with its reason, score, cost; searchable
+- **Rules** — edit `POLICY.md` in place; your edits win, live immediately
+- **Tasks** — approve/reject dispatched work (verification still applies)
+- **👍/👎 on every decision** — "worth my attention" / "don't bother me";
+  Chief's learner weighs these above every inferred signal
+
+<!-- console screenshot: docs/assets/console.png (make console-shot) -->
+
+## 🔌 Out-of-the-box sources
+
+```bash
+chief connect composio --secret whsec_…   # GitHub, Gmail, Slack, 500+ apps
+chief connect github                      # gh notifications poller
+chief connect rss --url https://hnrss.org/frontpage
+chief sources                             # see what's wired up
+```
+
+**[Composio](https://composio.dev)** is the flagship connector: point its
+trigger webhooks at `/v1/connectors/composio` (HMAC-verified) and every
+connected app flows through Chief's judgment. The connector registry leaves
+documented slots for zapier/n8n-style automations and MCP-push agents — one
+adapter module each.
+
+## 🧩 Skills: make your agents good citizens
+
+Drop-in skills teach agent hosts to route through Chief instead of pinging you:
+
+- **[skills/claude-code/](skills/claude-code/SKILL.md)** — Claude Code agents
+  propose via `chief lite` (no daemon needed) and obey the route.
+- **[skills/openclaw/](skills/openclaw/SKILL.md)** — OpenClaw agents propose
+  via MCP; interrupts ride OpenClaw's own channels back to you.
+
+Both encode the same iron rule: *the agent MUST NOT message the user directly.*
+
+## 🔗 Integrations: Chief as the judgment layer
+
+Noisy upstream bots in, one accountable judgment layer in the middle:
+**[examples/integrations/](examples/integrations/)** ships a runnable
+stock-analysis-bot feed (watch five "all good" reports die and three real
+findings survive) and a generic webhook template any agent can copy — both
+fully offline.
+
+## 📁 Project layout
+
+```
+core/       brain loop, 3-stage scorer, learner, digest, SQLite state
+context/    scene engine + providers (clock, calendar)
+judge/      pluggable LLM judges: ollama · deepseek · anthropic · openai · fixtures
+ingest/     webhook (FastAPI), MCP server, GitHub/RSS pollers, normalizer
+dispatch/   executors (claude-code, whitelisted shell) + verification
+delivery/   terminal · desktop · telegram (feedback buttons)
+memory/     curate, associate, expire → archive
+demo/       the offline day-of-engineer replay fixture + runner
+skills/     OpenClaw integration (propose-and-obey)
+```
+
+## 🧪 Quality
+
+218 tests run fully offline — no keys, no network. The demo's routing table is
+a full-table regression: all 24 events' routes are pinned in CI forever.
+
+```bash
+make test lint      # pytest + ruff
+make demo           # the offline replay
+make release-check  # build the wheel, run the demo from it via uvx
+```
+
+## 🗺 Roadmap & contributing
+
+See [ROADMAP.md](ROADMAP.md) for what's deliberately out of v1 (web UI, cloud
+sync, Slack/Discord delivery, …) and [CONTRIBUTING.md](CONTRIBUTING.md) to get
+hacking — the dev loop is `uv sync --dev && make test`. Design decisions live
+as one-line ADRs in [docs/decisions.md](docs/decisions.md);
+[SPEC.md](SPEC.md) is the full implementation spec the project was built from,
+step by step ([PROGRESS.md](PROGRESS.md)).
+
+## 🔒 Privacy
+
+Local-first by construction: one SQLite file + markdown under `~/.chief`.
+No cloud, no telemetry, no web UI, no arbitrary shell execution. The only
+network calls are the ones you configure (your LLM backend, your Telegram bot).
+
+## ⭐ Star history
+
+[![Star History Chart](https://api.star-history.com/svg?repos=SmileLikeYe/agent-chief&type=Date)](https://star-history.com/#SmileLikeYe/agent-chief&Date)
+
+## 📄 License
+
+[MIT](LICENSE)

agent_chief-0.3.1.dist-info/RECORD

@@ -0,0 +1,83 @@
+cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cli/connect.py,sha256=hkAdy9TJWzFr53cWu8rvAnhnTxOjEP_lrZYi9sWBQBk,5278
+cli/init.py,sha256=2rDr4001gY3VQfQY-XUHMFM_TWj4LobY9sbnaQsD7_U,6176
+cli/main.py,sha256=pNIrhXaqRyRcS7IkzD_FSdEdg2EyJklo7wcD0uumCII,14557
+cli/runtime.py,sha256=M3kcvhRb78bWyPbf1771J-1EaZCWcJ75omq_ISXxf_Q,9606
+context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+context/infer.py,sha256=nN5eGffD7TVg0cfmgsR-1cMAY9BJC2YmMAIw34Ov5Fs,3915
+context/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+context/providers/calendar.py,sha256=RncSzwbJjfmm1yWcnvhKQPNDmHE3gVe4l2ystISdnb4,3098
+context/providers/clock.py,sha256=stB0LdmXgVGB44cVQ97Zn275bqSzGxDxZc6B0suREeQ,748
+core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+core/brain.py,sha256=addobzmXF24OUxor8wtg7VPHM7v4aKh_OYTgbKq0f34,16081
+core/config.py,sha256=-vw3XBJf4aK-NsF3aitTErGsbe-K3gMviCgL45HK908,740
+core/digest.py,sha256=3i61wOyMoxjMngUmXe6ytXRgG3Re0v9gzA9a4T4Hr5Y,3814
+core/embedding.py,sha256=D-697p2NQy4pqobKq-EZqRvtU8-3fr3nnsgD6TXIY2Y,2419
+core/learner.py,sha256=rCF_fxNoLNg3mkXgpEtbQVR2Bfu7Vl9XcuIDl5WYaFE,9673
+core/policy.py,sha256=4P9jC46L-sWkP2GJDB0NLTL5mSrt0KJv8RRtTHXufho,3907
+core/schema.py,sha256=1nnztlsSWMUjckvtl0SaSHvl49ddy0C1mAoH7Qebfk8,2614
+core/scorer.py,sha256=4e7h91SB6YXYtIK8fl_M_uE4oAOTh3Y5z6ihnEtb1CE,9080
+core/state.py,sha256=O9HhLbncSN26647S9tMMmu-L1skL_cfzAOvPjZAuapk,12061
+delivery/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+delivery/base.py,sha256=IRgjY4c4wgGdiYysYnqHBoVCSTXG_Sj62LNg3ZdcFCE,2239
+delivery/desktop.py,sha256=8dWHg4TtvAy64Zbae2-LjoOExv48i2cITUYAqVo7Cio,1004
+delivery/telegram.py,sha256=-uLrHBxssXsLKdifEaxY1liEF1PKz1Z_olZ14sMSB5E,3543
+delivery/terminal.py,sha256=2gdEWCvfRicr-dTCJGaMU6AJQaB64UiDuxhMCw1W_yg,552
+demo/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+demo/day_of_engineer.json,sha256=VA10oRVPZsjYC5ctlTXCrF72RB1lBSjp5z4HOuqWsxM,17597
+demo/runner.py,sha256=ofUyjoYhfMpOluKswIvE0HyBPWwAaYaOB36XK7YtmVk,9277
+dispatch/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dispatch/acceptance.py,sha256=lqNprHWMlP5_RxGVQctQYz00HvU8KuyjEKBAqoQYPrY,2945
+dispatch/executor.py,sha256=0k2YhiiuJRwB-iXfLeDYXIcKC456QFvOm1rf8UL-Fw0,4655
+eval/__init__.py,sha256=H7YCzkOuxGtWgN6XfSre21GOqiiAfbHcNQK_LUY5Q_c,266
+eval/generate_golden.py,sha256=dZoJpDGmfg7CWqcHdJK9EdDJGfNEegx0SNieg2Dwt9g,10979
+eval/golden.jsonl,sha256=wnoZj7vSmDZ96N8D3BzyG6oQJOg3oiTy-zdsciKh59E,105755
+eval/learning.py,sha256=OJOHvZiuC2B5-9vURS8WSaA-J5-zxP3EjypzMP6yiS0,8074
+eval/runner.py,sha256=YRaExD1u8OJ8DWo6NMhGuso7XUuiPRJFtCOptF9jaAA,7819
+eval/reports/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eval/reports/learning.md,sha256=gktqJcdcO_ex_HetQDEB3rxR1OT2Hq3m4dnkt81j3Fk,1525
+ingest/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ingest/http.py,sha256=CvFunMnzfduxgKklV06DWeUkF-nsfmMKlzi1nXVJDLo,9096
+ingest/mcp_server.py,sha256=umvHjyNdgJ0e5Nz2Xaai6jZD8y3KMgnvgwee2WpClzA,2537
+ingest/normalize.py,sha256=HJ2LztmxOE8t5qTR_bPenShvs2FxZQsvS0KX36e_bHc,2023
+ingest/connectors/__init__.py,sha256=n-BXMadM-R8Zeg_5TqwMXsMTCYdmzuJypkbJPjR6Pvo,2033
+ingest/connectors/composio.py,sha256=yvM1hrOAubJYMFvFFvt4tWrPjl1bBXCskzcS18Mgduw,3884
+ingest/sources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ingest/sources/base.py,sha256=IOTFStzoNzJ12oEr0FMKX7zOUXh4RH-eNo4deiFNaRM,1737
+ingest/sources/github.py,sha256=iFWpEHQtIf4RB7kqTBqZISHmaTb8L2qshKyemeZoy2M,1556
+ingest/sources/rss.py,sha256=54a5FGBmZvY3ESFO46ZmeB16C3pgkFP9NvqN9hBg_lM,1790
+judge/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+judge/anthropic.py,sha256=dKw4jJPBGugrEQxCovr1qK5KtVW9IYn1gvA1yZzpqNE,1364
+judge/base.py,sha256=w2HPBXpwf_KQGXgnwSxUWdVHlmbiR9R9aBEHqQEi_yU,5352
+judge/deepseek.py,sha256=CUOvwpsndhBHTNscDu94UL0v5WhJspVcoCXlnid0lNQ,223
+judge/factory.py,sha256=Py7zeRGxLblrfyH1Wj7wVl20y94Ml5OO9hwY5tonLOU,1696
+judge/fixtures.py,sha256=3VmwX42vBXnsvSzTzATI-cprmw4_0hGVeNxTKpNlwes,851
+judge/ollama.py,sha256=cqITQsShPKYOSXuqz4_Y67I-wNyxJuul_0U8CN13YbA,874
+judge/openai.py,sha256=I6yrr_UAJ_5-N_eGgMjdmzgfaqDzzrwErSKwxy02Z6w,1250
+judge/pricing.py,sha256=8h1PBMtDdHRxYqOYT0EtNT-ejBiNPF8QVG2zkik17Mk,2568
+judge/prompts.py,sha256=wZr3temoIgU862DVXs4FGvCBu6LPZVu1-4PhwbhcavQ,3401
+judge/templates/v1/context.j2,sha256=RzT49TXfHyL9hniMOSZuAGFOh5L1fYSqkhF3tcRaVfQ,131
+judge/templates/v1/distill.j2,sha256=m6HXezlORQ8uFBZC6AOYt8JDlZQtjmqLl8Y4uOzzPG0,232
+judge/templates/v1/retry.j2,sha256=YfoQjk1J0Nw_6kRrPf6dbIQAI2RuiPH-UJet0IJ2Cek,125
+judge/templates/v1/system.j2,sha256=O2OQ6r8a5-LyF3SP3XG0qpZKz3iaju5F83pkzVqzZAY,777
+judge/templates/v1/topic_infer.j2,sha256=NMgkT3lIyWTdvIeHqh8eWcXlhjs9BbmIGBHC9UyMCZs,164
+judge/templates/v1/user.j2,sha256=LtwCQQkerPYRW3JlhJdlGZHSc-CqE33dBEDtPYLXDJo,97
+judge/templates/v1/verify.j2,sha256=0SizlJItqfJ3YCyfpiAr8N-B7-qNvcCt2vqRxhVABC8,204
+memory/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+memory/associate.py,sha256=GfRiDt0lWps88Fx5qfmeDm4hA2QqS30q2DRzQIthX_g,956
+memory/store.py,sha256=9DDFUgeoRpx2bL5YpyjjlZwk4sjTqG4SQeewYVeWjVY,2185
+policy/POLICY.template.md,sha256=4LfYQr5hLuArNyXnjD-j8XlUEh8mg6wtU8St-f5YHkM,130
+policy/USER.template.md,sha256=BPhdZJ2STQZT-GFdxI555UqgsxrriqCgtqJ_ceXUO4E,74
+policy/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+skills/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+skills/claude-code/SKILL.md,sha256=S691-I-FG3zovRyK8KyHcEGPeXzhhJovWpPPrTW5O5w,2296
+skills/openclaw/SKILL.md,sha256=tvXm2mlXiXKFq3VIzbg89rCL0NkWElw1HvaJabhP6w4,2269
+skills/openclaw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+skills/openclaw/hook.py,sha256=6rZW_eP6Jl6Ai61148iW8WM7k0lgyZ49XriVOFFnRiU,2449
+ui/__init__.py,sha256=FOAADGRiLgpvtK8nWAA9oQNj1pqXUppDVefd_oiA9Mk,238
+ui/console.html,sha256=KV7q4zihsIfYv_C3lYQiusEZ9f784iDctOfSov9Z4ck,10454
+agent_chief-0.3.1.dist-info/METADATA,sha256=NdDmscurj5D25RFZsrzJ8pRicyu4aDTraMwPrwVBY00,14867
+agent_chief-0.3.1.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+agent_chief-0.3.1.dist-info/entry_points.txt,sha256=RF6w2blJQtBS8tYrU9tn6ozRWigW8xMW6Ml4SU0Rpws,39
+agent_chief-0.3.1.dist-info/licenses/LICENSE,sha256=gAWc9EgnR4F1P5UoitqjY98lQyexagPVTKo3dViksvQ,1068
+agent_chief-0.3.1.dist-info/RECORD,,

agent_chief-0.3.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

agent_chief-0.3.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+chief = cli.main:app

agent_chief-0.3.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SmileLikeYe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cli/connect.py

@@ -0,0 +1,142 @@
+"""SPEC v3.2 Step 35: one-click source connection.
+
+`chief connect <source>` edits ~/.chief/config.toml surgically (everything
+else preserved) and prints the exact next actions. Config writing stays
+dependency-free: our schema is flat sections (plus one nested `connectors.*`
+level) of strings/bools/ints/string-lists, so a tiny serializer suffices.
+"""
+
+import base64
+import hashlib
+import hmac
+import json
+import tomllib
+
+from rich.console import Console
+
+from core.config import chief_home, config_path, load_config
+
+console = Console(soft_wrap=True, highlight=False)  # keep URLs copy-pastable
+
+
+class UnsupportedConfig(Exception):
+    """The existing config uses TOML our tiny serializer can't round-trip."""
+
+
+def _scalar(v) -> str:
+    if isinstance(v, bool):
+        return "true" if v else "false"
+    if isinstance(v, int | float):
+        return str(v)
+    if isinstance(v, str):
+        return json.dumps(v)
+    if isinstance(v, list) and all(isinstance(i, str | int | float | bool) for i in v):
+        return "[" + ", ".join(json.dumps(i) for i in v) + "]"
+    raise UnsupportedConfig(f"cannot serialize value {v!r}")
+
+
+def _serialize(cfg: dict) -> str:
+    # our schema is flat sections plus one connectors.* level; anything deeper
+    # (or a root-level scalar, or a list of tables) we refuse rather than corrupt
+    lines: list[str] = []
+    for section, body in cfg.items():
+        if not isinstance(body, dict):
+            raise UnsupportedConfig(f"root-level key {section!r} is not a section")
+        scalars = {k: v for k, v in body.items() if not isinstance(v, dict)}
+        tables = {k: v for k, v in body.items() if isinstance(v, dict)}
+        if scalars or not tables:
+            lines.append(f"[{section}]")
+            lines += [f"{k} = {_scalar(v)}" for k, v in scalars.items()]
+            lines.append("")
+        for sub, subbody in tables.items():
+            if any(isinstance(v, dict) for v in subbody.values()):
+                raise UnsupportedConfig(f"[{section}.{sub}] nests too deep")
+            lines.append(f"[{section}.{sub}]")
+            lines += [f"{k} = {_scalar(v)}" for k, v in subbody.items()]
+            lines.append("")
+    return "\n".join(lines)
+
+
+def _update_config(mutate) -> dict:
+    path = config_path()
+    raw = path.read_text(encoding="utf-8") if path.exists() else ""
+    cfg = tomllib.loads(raw) if raw else {}
+    mutate(cfg)
+    try:
+        rendered = _serialize(cfg)
+    except UnsupportedConfig as exc:
+        raise SystemExit(
+            f"chief connect can't safely rewrite {path} ({exc}).\n"
+            f"Edit the config by hand — add the section shown in the docs — and re-run."
+        ) from exc
+    chief_home().mkdir(parents=True, exist_ok=True)
+    if raw:
+        path.with_suffix(".toml.bak").write_text(raw, encoding="utf-8")  # keep a backup
+    path.write_text(rendered, encoding="utf-8")
+    return cfg
+
+
+def connect_composio(secret: str) -> None:
+    _update_config(
+        lambda cfg: cfg.setdefault("connectors", {}).setdefault("composio", {}).update(
+            {"webhook_secret": secret}
+        )
+    )
+    port = load_config().get("ingest", {}).get("webhook_port", 8787)
+
+    # prove the secret + verifier agree before the user leaves the terminal
+    from ingest.connectors.composio import verify_signature
+
+    body = json.dumps({"probe": True}).encode()
+    mac = base64.b64encode(
+        hmac.new(secret.encode(), b"wh_probe.0." + body, hashlib.sha256).digest()
+    ).decode()
+    assert verify_signature(secret, "wh_probe", "0", body, f"v1,{mac}")
+    console.print("✅ secret stored · signed sample verified locally")
+    console.print(
+        f"\nNext, in the Composio dashboard (composio.dev):\n"
+        f"  1. connect the apps you want (GitHub, Gmail, Slack, …)\n"
+        f"  2. enable their triggers\n"
+        f"  3. set the webhook subscription URL to\n"
+        f"     [bold]https://<your-tunnel>/v1/connectors/composio[/bold]\n"
+        f"     (local port {port}; use cloudflared/ngrok/tailscale funnel)\n"
+        f"  4. fire a test trigger and watch it in chief ui → History"
+    )
+
+
+def connect_github() -> None:
+    import shutil
+
+    _update_config(lambda cfg: cfg.setdefault("ingest", {}).update({"github": True}))
+    if shutil.which("gh"):
+        console.print("✅ github notifications poller enabled (5 min via `gh api`)")
+    else:
+        console.print(
+            "✅ enabled — but [yellow]`gh` CLI not found[/yellow]: "
+            "install it and run `gh auth login` before `chief run`"
+        )
+
+
+def connect_rss(url: str) -> None:
+    def mutate(cfg):
+        urls = cfg.setdefault("ingest", {}).setdefault("rss_urls", [])
+        if url not in urls:
+            urls.append(url)
+
+    _update_config(mutate)
+    console.print(f"✅ feed added — polled every 30 min: {url}")
+
+
+def show_sources() -> None:
+    from rich.table import Table
+
+    from ingest.connectors import connector_status
+
+    table = Table(title="sources")
+    table.add_column("connector")
+    table.add_column("status")
+    table.add_column("")
+    for s in connector_status():
+        status = "[green]connected[/green]" if s["connected"] else "[dim]not configured[/dim]"
+        table.add_row(s["name"], status, s["detail"])
+    console.print(table)