ai: blocktank lsp api plugin + agent control interface

[ovitrif]

This PR:

1. Adds a Blocktank LSP API Claude Code plugin with full endpoint reference, workflows, and state machines
2. Adds a ./lsp CLI wrapper for calling the Blocktank API from the repo root
3. Adds a DevToolsProvider ContentProvider (debug builds only) for programmatic invoice creation via adb shell content call
4. Adds a pay-invoices.sh automation script for bulk invoice creation, payment, and block mining
5. Ships .claude/install-plugins.sh as the single setup entry point for bundled Claude Code plugins

Description

Blocktank LSP API Plugin for Claude Code - 142abce

Introduces a Claude Code plugin at .claude/plugins/blocktank-api/ that gives Claude knowledge of the Blocktank LSP REST API (18 endpoints) and provides shell scripts for calling it. The plugin includes a skill with endpoint tables, common workflows (channel purchase, CJIT, force close), and state machine documentation.

Agent Control Interface (ACI) - 142abce

A debug-only DevToolsProvider ContentProvider allows creating bolt11 invoices on the app's LDK node via adb shell content call, returning the result synchronously as JSON in a Bundle. Commands accept typed JSON args via --arg, with each command defining its own @Serializable data class for type-safe deserialization with defaults.

This MVP provides the basis for demonstrating 2-way communication between AI dev agents and the Bitkit Android App. Future implementations could expand the set of supported methods through this command interface, as the internals of the implementation were designed with extensibility in mind.

A potential 2nd layer could provide agent-to-app control by deep-linking directly to different routes within the app, optionally passing args to fill-in screen details such as route params or values for form inputs.

Plugin install script - 8da9f5a

.claude/install-plugins.sh iterates every subdirectory under .claude/plugins/ with a valid plugin.json and either installs the plugin into user scope or runs claude plugin update if already installed. The committed .claude/plugins/.claude-plugin/marketplace.json is the source of truth for what Claude Code resolves. No project-scope enabledPlugins / extraKnownMarketplaces are committed because Claude Code 2.1.112 doesn't auto-register directory-source marketplaces — which produced a red-icon error in the /plugins UI in earlier iterations.

Adding a new plugin later is a drop-in: new dir + one marketplace entry + one bullet in the root README — script and prose need no edits.

Preview

lsp_1.5x.mp4

QA Notes

0. Setup the plugin

# Run once from the repo root (re-run anytime to update):
./.claude/install-plugins.sh

# Restart Claude Code once, then confirm:
claude plugin list | grep blocktank-api       # expect: Status: ✔ enabled

Also confirm the /plugins UI in Claude Code shows blocktank-api enabled with no red-error icon, and that invoking /lsp in a Claude Code session loads the skill.

To verify update-capability: edit any file under .claude/plugins/blocktank-api/skills/lsp/ and re-run ./.claude/install-plugins.sh — plugin should remain enabled with the updated source reflected.

1. Verify ./lsp wrapper

# 1. run:
./lsp GET /info | jq

# 2. Should return JSON with LSP node info and channel limits.

2. Verify invoice creation via claude code

prerequisite: debug build with wallet + open channel actively running on emulator

# 1. run:
adb shell "content call --uri content://to.bitkit.dev.devtools \
  --method createInvoice --arg '{\"amount\":1000,\"description\":\"test\"}'"

# 2. Should print `Result: Bundle[{result={"type":"...Invoice","bolt11":"lnbcrt..."}}]`.

# 3. Pay the returned invoice:
./lsp POST /regtest/channel/pay '{"invoice":"__paste_bolt11_here__"}'

# 4. Should trigger receive sheet in app

3. Verify full automation

prerequisite: open channel with inbound capacity

# 1. run:
INVOICE_COUNT=3 MINE_TOTAL=10 MINE_BATCH=10 \
  .claude/plugins/blocktank-api/skills/lsp/scripts/pay-invoices.sh
  
# 2. Should create 3 invoices (1, 2, 3 sats), pay each, mine 10 blocks.
# 3. App should show all 3 payments in activity list.

[jvsena42]

Can I test it already?

[ovitrif]

Can I test it already?

Yes, should be ready 👍🏻

[jvsena42]

probably should publish the plugin?

Getting this error from /doctor

blocktank-api@blocktank-api: Plugin blocktank-api not found in marketplace blocktank-api

settings.json:

  "enabledPlugins": {
    "plannotator@plannotator": true,
    "blocktank-api@blocktank-api": true
  }

[jvsena42]

it is not finding the plugin, checking...

[jvsena42]

A good way to check the setup is cloning the project and see if Claude recognizes the plugin

[ovitrif]

@jvsena42 — updated in 8da9f5a. Setup is one command:

./.claude/install-plugins.sh

[jvsena42]

Tested:

• Install plugin with ./.claude/install-plugins.sh
• Mine blocks
• Open channel
• Pay 10 invoices
• Close all channels