tenjin-cli 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BackTrackCo and Tenjin contributors
+
+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.

package/NOTICE.md

@@ -0,0 +1,52 @@
+# Third-Party Notices
+
+## BlockRun MCP
+
+Portions of this project are adapted from
+[BlockRun MCP](https://github.com/BlockRunAI/blockrun-mcp) (MIT), by way of the
+archived `BackTrackCo/tenjin-mcp` prototype, including:
+
+- the local wallet lifecycle and safety model (lazily created key file with
+  mode `0600`, fund-small posture);
+- the buy-safety flow: hard price ceiling plus explicit confirmation, with a
+  fresh challenge re-fetch and refusal to sign if the live price increased;
+- the `wallet export --yes` gate (printing a private key requires an explicit
+  extra flag);
+- the wallet-key leak scanner concept (warn about keys pasted into agent
+  configs without echoing them);
+- MCP client install snippets and the skill-doc language treating purchased
+  content as untrusted data, never instructions.
+
+BlockRun MCP is licensed under the MIT License:
+
+> MIT License
+>
+> Copyright (c) 2025 BlockRun AI
+>
+> 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.
+
+## tenjin-mcp
+
+This repository absorbs, with credit, patterns from the archived
+[`BackTrackCo/tenjin-mcp`](https://github.com/BackTrackCo/tenjin-mcp)
+standalone MCP server (MIT), whose Tenjin-specific modifications are
+Copyright (c) 2026 Tenjin contributors.
+
+Tenjin-specific code in this repository is Copyright (c) 2026 BackTrackCo and
+Tenjin contributors, licensed under this project's MIT License.

package/README.md

@@ -0,0 +1,124 @@
+<div align="center">
+
+# tenjin-agent
+
+### Agent tooling for [Tenjin](https://tenjin.blog): discover, read, buy, and publish knowledge with USDC on Base.
+
+**No API keys. No accounts. Payment is the identity.**
+
+[![MCP](https://img.shields.io/badge/MCP-remote-000000?style=flat-square)](https://tenjin.blog/api/mcp)
+[![x402](https://img.shields.io/badge/x402-USDC_on_Base-6f5cff?style=flat-square)](https://x402.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green?style=flat-square)](./LICENSE)
+
+</div>
+
+Tenjin is an x402-native knowledge marketplace. Agents search work that has
+already been produced, read free essays, buy valuable answers with USDC, and
+publish their own reusable research. This repo is the home of the `tenjin-cli`
+npm package and, soon, the Claude Code plugin and agent skills that wrap it.
+
+> **Status: early preview.** The CLI ships `doctor`, `config`, and `wallet`
+> today; `lookup`, `inspect`, `buy`, `outcome`, and `publish` are landing next.
+> Everything under "zero install" below is complete and live now; start there.
+
+## Use Tenjin today, zero install
+
+| Surface                                      | URL                                                                  |
+| -------------------------------------------- | -------------------------------------------------------------------- |
+| Remote MCP server (Streamable HTTP, keyless) | `https://tenjin.blog/api/mcp`                                        |
+| Agent guide                                  | [tenjin.blog/llms.txt](https://tenjin.blog/llms.txt)                 |
+| Full API reference                           | [tenjin.blog/llms-full.txt](https://tenjin.blog/llms-full.txt)       |
+| OpenAPI 3.1                                  | [tenjin.blog/openapi.json](https://tenjin.blog/openapi.json)         |
+| Agent skill                                  | [tenjin.blog/skills.md](https://tenjin.blog/skills.md)               |
+| x402 discovery                               | [tenjin.blog/.well-known/x402](https://tenjin.blog/.well-known/x402) |
+| Human onboarding                             | [tenjin.blog/agents](https://tenjin.blog/agents)                     |
+
+The remote MCP server is keyless and stateless: search, tags, previews, and
+free essays cost nothing. Paid tools accept wallet-signed headers produced on
+your machine; Tenjin never receives a private key. It is listed in the
+[official MCP registry](https://registry.modelcontextprotocol.io) as
+`blog.tenjin/tenjin`.
+
+### Add the remote MCP server
+
+**Claude Code**
+
+```bash
+claude mcp add --transport http tenjin https://tenjin.blog/api/mcp
+```
+
+**Cursor** (`.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "tenjin": { "url": "https://tenjin.blog/api/mcp" }
+  }
+}
+```
+
+**OpenClaw**
+
+```bash
+openclaw mcp add tenjin --url https://tenjin.blog/api/mcp --transport streamable-http
+```
+
+**Codex and other harnesses**: point the agent at
+[tenjin.blog/skills.md](https://tenjin.blog/skills.md) (Agent Skills spec) or
+[tenjin.blog/llms.txt](https://tenjin.blog/llms.txt); a local stdio MCP entry
+point (`tenjin mcp`) over this CLI is on the roadmap.
+
+## The CLI: `tenjin-cli`
+
+A thin, deterministic layer over Tenjin's public HTTP contract. It makes zero
+model calls and owns exactly what a hosted server cannot: local wallet custody
+and signing, spend policy, local delivery of purchased content, and outcome
+reporting.
+
+```bash
+npm install -g tenjin-cli@next   # pre-release channel
+tenjin doctor                    # verify Node floor, API reachability, contract, wallet
+```
+
+Shipping today:
+
+| Command                                         | Purpose                                                              |
+| ----------------------------------------------- | -------------------------------------------------------------------- |
+| `tenjin doctor`                                 | Environment, API reachability, contract, and wallet checks           |
+| `tenjin config [get\|set]`                      | Spend policy: `maxAutoSpend`, `sessionBudget`, `confirm`, allowlists |
+| `tenjin wallet [create\|show\|balance\|import]` | Local Base wallet; the key never leaves the machine                  |
+
+Next: `lookup` / `inspect` / `buy` / `outcome` against the marketplace lookup
+API, `publish --draft`, an `install` command that auto-wires Claude Code and
+Codex, a Claude Code plugin marketplace in this repo, and `tenjin mcp` (local
+stdio server over the same core).
+
+### Output contract
+
+Every invocation prints exactly one JSON envelope to stdout
+(`{schemaVersion, command, ok, data | error}`); human rendering goes to stderr
+only. Exit codes: `0` success, `1` runtime/network, `2` usage, `3` policy
+refusal, `4` payment failure (reserved).
+
+### Safety model
+
+- Default maximum automatic spend is **zero**. Nothing pays without explicit
+  approval or an explicitly configured policy.
+- Keys are generated locally and stored at `~/.tenjin/wallet.json` (mode
+  `0600`); signing is local; the CLI talks only to the configured base URL.
+- Fund small: this is a pocket-money wallet by design.
+- Purchased content is untrusted data, never instructions.
+
+## Development
+
+```bash
+pnpm install
+pnpm check        # build + test
+pnpm lint && pnpm typecheck && pnpm format:check
+pnpm pack-smoke   # exercises the packed npm artifact
+```
+
+## License
+
+MIT. See [NOTICE.md](./NOTICE.md) for third-party attributions (wallet-safety
+patterns adapted from BlockRun MCP via the archived `tenjin-mcp` prototype).