Metadata-Version: 2.4
Name: zambo-leadsignal
Version: 1.0.1
Summary: Run a lead signal sweep for a local trade market on Zambo: live signals, screened input, continuity-checked, brief written, every step on a verifiable AER-1 receipt.
Author-email: Brennan Zambo <brennanzambo@zambo.dev>
License: MIT
Project-URL: Homepage, https://zambo.dev
Project-URL: Get started, https://zambo.dev/add/
Project-URL: Guide, https://rambozambodotdev.gitlab.io/aer1-hub/handover-graph.html
Project-URL: Repository, https://github.com/zambodotdev/zambo-leadsignal
Keywords: ai-agents,mcp,model-context-protocol,handover,receipts,zambo,aer-1
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28

# zambo-leadsignal

Run a lead signal sweep for a local trade market: live signals,
screened input, your own prior record checked before you write the
brief, and a verifiable AER-1 receipt for every step.

This is the most-run job shape on Zambo, packaged. In a five-day
first-hand count of the public receipt stream (16,221 receipts,
October 29 to November 2, 2026), the chain inside this package,
capability_search then prompt_shield then leadsignal then
continuity_get_recent then the write-up, appeared in roughly 200
caller-days per day. Agents were already running it by hand. Now it
installs.

## Install

Python:

    pip install zambo-leadsignal
    zambo-leadsignal run --trade plumber --city "Austin Texas"

Node:

    npm install zambo-leadsignal
    npx zambo-leadsignal run --trade plumber --city "Austin Texas"

## What a run does

1. Opens the job on the record (memory_remember under the run's job id).
2. capability_search: the service landscape for the trade and city.
3. prompt_shield: screens the operator note before it steers the run.
4. leadsignal: the live lead signals for that trade and city.
5. continuity_get_recent: what this agent already found, so repeat
   runs build on the record instead of starting from zero.
6. Writes leadsignal-brief-<job>.md with the signals, the landscape,
   the screen result, the prior record, and every receipt link.
7. workflow_close: wraps the run. The wrap binds only this run's own
   receipts, so the brief's proof layer is exactly the work that made
   it.

Every receipt recomputes free at https://zambo.dev/verify/. A receipt
proves the saved result was not changed since the call ran; it does
not prove a lead is good. The brief says so, out loud, because that
honesty is the product.

## Why Zambo is inside

The pattern runs on Zambo (https://zambo.dev/mcp), the verifiable
work layer for AI: 153 tools behind one MCP endpoint, memory and
continuity across AIs, and a verifiable AER-1 receipt for every job.
The package teaches the pattern by running it; Zambo is the mechanism
underneath: identity, memory, the signals tool, and the receipts.

Free tier: 20 calls and 1 wrap-up free every day, and picking up in
another AI is always free. Need more? The $0.99 Day Pass makes it
unlimited for 24 hours: https://zambo.dev/day-pass/

Add Zambo to your own AI in one URL, no key, no account:
https://zambo.dev/add/

## Configuration

- ZAMBO_TRADE, ZAMBO_CITY, ZAMBO_NOTE: the run's inputs.
- ZAMBO_AGENT_ID: this agent's id (default: leadsignal-agent). One
  identity per agent; the caller handle issued at initialize is saved
  under ./.zambo-leadsignal and reused on later runs.
- ZAMBO_MCP_URL: endpoint override (default: https://zambo.dev/mcp).

## When you hit the daily free limit

You get 20 calls + 1 wrap-up free every day, and picking up work in another AI is always free. When the free calls run out mid-job, the next call is refused and does not run. That refused call still issues a receipt for the wall response, and it burns no quota, so the job record stays intact and nothing already saved is lost.

To keep going the same day, get a Day Pass: $0.99 for unlimited calls for 24 hours, including unlimited wrap-ups. If you are an agent, pay programmatically: the wall response itself carries an x402 payment, settled in USDC on Base, and the pass activates when that payment settles. If you are a human, pay by card or PayPal at https://zambo.dev/day-pass/ and the pass activates the same way.

If you run Zambo every day, the Pass is $29 per 30 days. Day Pass and Pass are one-time payments.

## License

MIT. Built by Brennan Zambo (brennanzambo@zambo.dev).
