gridzen-developer-kit 0.6.1__tar.gz → 0.7.1__tar.gz

{gridzen_developer_kit-0.6.1 → gridzen_developer_kit-0.7.1}/MANIFEST.in

@@ -8,3 +8,11 @@ recursive-include skills *.md *.json *.py LICENSE
 recursive-include clients *.json *.toml
 recursive-include docs/harness *.md
 include scripts/check_integration.py
+
+include docs/verification-evaluation.md
+
+include docs/atomic-tools.md
+recursive-include examples/atomic_tools *.json *.py *.md
+
+include llms-install.md docs/activation.md docs/mexico-identity-account.md docs/multilingual-ui.md
+recursive-include examples *.md *.json *.py *.ts

{gridzen_developer_kit-0.6.1/src/gridzen_developer_kit.egg-info → gridzen_developer_kit-0.7.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: gridzen-developer-kit
-Version: 0.6.1
-Summary: Gridzen research catalog, integration planner and explicit verification sandbox
+Version: 0.7.1
+Summary: Single-task MCP profiles and Skills, offline utilities, research and explicit verification sandbox
 Author-email: Gridzen <open@gridzen.ai>
 License-Expression: MIT
 Project-URL: Homepage, https://gridzen.ai/developers/
@@ -13,6 +13,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE.md
 Requires-Dist: mcp==2.3.0
+Requires-Dist: httpx==0.28.1
 Provides-Extra: mcp
 Requires-Dist: mcp==2.3.0; extra == "mcp"
 Provides-Extra: server
@@ -27,18 +28,48 @@ Requires-Dist: fastapi==0.142.4; extra == "test"
 Requires-Dist: uvicorn==0.54.0; extra == "test"
 Dynamic: license-file
 
-# Gridzen Developer Kit 0.6.0
+# Gridzen Developer Kit 0.7.1
+
+The hosted developer interface supports Vietnamese alongside English, Spanish and Simplified Chinese: https://gridzen.ai/developers/?lang=vi . UI language does not enable live checks or country coverage. See [UI language maintenance](docs/multilingual-ui.md).
+
+[Choose direct integration or GridZen for your task](docs/verification-evaluation.md#english) · [Production and cost checklist](https://gridzen.ai/console/learn?lang=en&source=developer_kit#decision-fit)
+
+
+Single-task entry points: [tool catalog](https://gridzen.ai/tools/) · [setup and boundaries](docs/atomic-tools.md).
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install gridzen-developer-kit
+.venv/bin/gridzen tools
+.venv/bin/gridzen setup --client codex --product clabe-format --project .
+# Review the preview, then add --apply. No key is needed for local tools.
+```
 
 ## Start immediately without signup
 
 Open [GridZen instant trial](https://gridzen.ai/console/start?lang=en) to run synthetic signup-phone and identity-onboarding responses without an account, API key or approval. Success, rejection and unavailable scenarios make no upstream calls and verify no real person. Agents can use the separate [key-free trial MCP](https://gridzen.ai/console/downloads/quickstart_mcp.py), installed with `mcp==2.3.0` and `httpx==0.28.1` in a virtual environment.
 
-For persistent test records and supplier sandbox callbacks, connect a verified merchant sandbox account. Production is a separate controlled free pilot; self-service production and payments are not enabled. This documentation update does not change PyPI or the official MCP Registry version.
+For persistent test records and supplier sandbox callbacks, connect a verified merchant sandbox account. Production access is capability-specific: eligible routes may offer bounded real trials, while others remain unavailable. Read the authenticated capability conditions; published prices do not enable paid purchases. Package releases and the hosted MCP Registry entry have independent versions; installing this package grants no merchant permissions.
 
-Research for 198 countries/territories, a verification integration planner, five synthetic outcomes, an HTTP SDK, local MCP server and six Skills. **No live provider is enabled. No real person is verified.** The research snapshot is dated 2026-10-07, with source links and file hashes.
+Fourteen Skills: the original six research/workflow Skills plus eight single-task profiles. Three new tools run offline; five merchant profiles call the existing authenticated GridZen API only with separate authorization, current availability and permitted use. The anonymous remote MCP retains five research/synthetic tools and never performs live verification. Research covers 198 countries/territories as a dated 2026-10-07 snapshot, not live service coverage.
 
 [中文指南](README.zh-CN.md) · [Guía en español](README.es.md)
 
+## Runnable task guides and distribution
+
+| Customer task | Guide | Runnable code |
+| --- | --- | --- |
+| First identity onboarding | [Guide](https://gridzen.ai/console/learn/identity-first-run?lang=en) | [Delivery fixture](examples/verification_delivery/) |
+| Registration phone boundaries | [Guide](https://gridzen.ai/console/learn/phone-check-boundaries?lang=en) | [Four-branch example](https://gridzen.ai/guides/signup-phone-check/) |
+| Missing or delayed callback | [Guide](https://gridzen.ai/console/learn/callback-recovery?lang=en) | [Recovery fixture](examples/verification_delivery/) |
+| Verification to business permission | [Guide](https://gridzen.ai/console/learn/business-permission-boundary?lang=en) | [Self-hosted n8n fixture](examples/n8n/) |
+
+[Chinese and Spanish article files](https://github.com/immurray/gridzen-developer-kit/tree/main/distribution/market-expansion-2026-10-13/articles/) · [Demo video](https://github.com/immurray/gridzen-developer-kit/blob/main/distribution/market-expansion-2026-10-13/media/identity-three-outcomes.mp4).
+
+Public examples are synthetic. Approved prices and per-product availability are published at https://gridzen.ai/pricing/; paid activation remains unavailable. [Request an approved pilot](https://gridzen.ai/console/pilot), without sending identity documents or credentials to public MCP tools.
+
+[Per-check plan and activation requirements](https://gridzen.ai/console/quote?lang=en) · [JSON](https://gridzen.ai/console/api/commercial/options)
+
 ## Try it
 
 Public playground: https://gridzen.ai/developers/
@@ -50,9 +81,9 @@ python3 -m venv .venv
 . .venv/bin/activate
 python -m pip install './gridzen-developer-kit[mcp]'
 gridzen coverage --country ID --capability bank_account_match
-gridzen plan --country ID --event payout
+gridzen plan --country ID --event onboarding
 gridzen simulate --country ID --capability bank_account_match --scenario timeout
-python gridzen-developer-kit/examples/payout.py
+python gridzen-developer-kit/examples/customer_tasks.py
 ```
 
 Python 3.11+. CLI and MCP use the bundled offline catalog and fixtures; the Python HTTP client/example calls the public sandbox. Dependencies are downloaded only during installation. API reference: https://gridzen.ai/developers/api/openapi.json .
@@ -76,7 +107,7 @@ Copy the individual directories from `skills/` into your compatible agent's proj
 ```python
 from gridzen_developer.client import Gridzen
 client = Gridzen()
-plan = client.plan('ID', 'payout')
+plan = client.plan('ID', 'onboarding')
 result = client.simulate('ID', 'bank_account_match', 'not_found')
 assert result['status'] == 'inconclusive'
 assert result['verified'] is False
@@ -84,7 +115,7 @@ assert result['verified'] is False
 
 Only documented country/event/capability/scenario fields are accepted. Never send identity numbers, bank accounts, documents or credentials to the sandbox. Simulation IDs encode fixtures and are not unique transaction identifiers. A synthetic match cannot authorize real users or payments. Research evidence is distinct from Gridzen availability or commercial permission.
 
-## Repository checkout: local service and checks
+## Repository source: local service and checks
 
 ```sh
 python -m pip install '.[test,server]'
@@ -95,7 +126,7 @@ uvicorn gridzen_developer.server:app --host 127.0.0.1 --port 8030
 
 Production uses an independent container at localhost:8030 proxied only under `/developers/`. See deploy/compose.yml and deploy/developers.conf. Removing that proxy file and stopping this container rolls back the preview; the existing API and Agent Company stacks are separate.
 
-## Repository checkout: build distributions
+## Repository source: build distributions
 
 `python scripts/build_downloads.py` creates allowlisted developer-kit and Skills ZIPs; it excludes tests, deployment files, private credentials and itself from recursive download packaging. `python scripts/build_catalog.py <repo>/docs/research/identity-verification/2026-10-07` refreshes the public research projection. Main repository report files remain the provenance source.
 
@@ -112,11 +143,11 @@ npx skills add immurray/gridzen-developer-kit
 Install the tagged Python/MCP release from GitHub (Python 3.11+ and Git):
 
 ```sh
-python -m pip install "gridzen-developer-kit[mcp] @ git+https://github.com/immurray/gridzen-developer-kit.git@v0.6.0"
+python -m pip install "gridzen-developer-kit[mcp] @ git+https://github.com/immurray/gridzen-developer-kit.git@v0.7.1"
 ```
 
-PyPI 0.6.0 is published and verified. Install with `python -m pip install
-gridzen-developer-kit`. See [the release tracker](distribution/STATUS.md) for
+Install the latest PyPI release with `python -m pip install --upgrade
+gridzen-developer-kit`. See [the release tracker](https://github.com/immurray/gridzen-developer-kit/blob/main/distribution/STATUS.md) for
 publication and installation evidence.
 
 Remote client configuration (conventional JSON; client syntax may vary):
@@ -135,16 +166,17 @@ Original code and Skills: MIT. Research provenance and third-party rights:
 
 ## Marketplace availability
 
-Source, release downloads, the official MCP Registry entry and six Skills.sh pages are public. Docker catalog submission is awaiting review. See [the publication ledger](distribution/STATUS.md) for exact status and remaining platform steps.
+Source and previous release downloads are public. Existing Registry and Skills.sh listings cover the research service; new product profiles are not separate approved listings. Docker catalog submission is awaiting review. See [the publication ledger](https://github.com/immurray/gridzen-developer-kit/blob/main/distribution/STATUS.md) for exact status and remaining platform steps.
 
 
-## Six bundled Skills (0.6.0)
+## 14 bundled Skills (0.7.1)
 
 `python -m pip install gridzen-developer-kit` installs the CLI, stdio MCP dependencies
-and all six Skill directories. Version 0.6.0 is published on
-[PyPI](https://pypi.org/project/gridzen-developer-kit/0.6.0/); clean installation,
-CLI, stdio MCP and all six bundled Skill directories were verified. No extra MCP
-dependency installation is required.
+and all 14 Skill directories.
+
+The 14 Skills comprise 6 research/workflow Skills and 8 single-task profiles. Of the 8 profiles, 3 run offline and 5 merchant profiles require separate authorization. Five public MCP tools provide research/synthetic operations. No live identity verification. No extra MCP
+dependency installation is required. Check available versions on
+[PyPI](https://pypi.org/project/gridzen-developer-kit/).
 
 ```sh
 gridzen coverage --country MX
@@ -158,12 +190,12 @@ copy a complete directory into your assistant's configured Skills directory to
 activate it. Installing a wheel does not automatically activate a client's Skills.
 
 The existing select/integrate/explain Skills remain available. Added offline
-workflows, version 1.0.0: `mexico-pilot-scoper`, `payout-policy-designer`, and
-`provider-rights-readiness`. Each includes MIT, README, complete response fixtures
+workflows, version 1.0.0, cover evaluation scope, evidence-review policies and
+provider-rights readiness. Each includes MIT, README, complete response fixtures
 and agent acceptance prompts. They make no third-party calls and grant no real
 verification, legal approval or regulatory conclusion.
 
-## Configure your assistant (v0.6.0)
+## Configure your assistant (v0.7.1)
 
 ```sh
 python3 -m venv .venv
@@ -173,7 +205,7 @@ gridzen setup --client all --project .
 gridzen setup --client all --project . --apply
 ```
 
-Use `--client` for Codex, Claude Code/Desktop, Cursor, VS Code/Copilot, Copilot CLI, Gemini CLI, Cline, Roo Code or OpenCode. Setup previews by default, merges existing unrelated settings, backs up changed configurations and refuses differing Gridzen entries or Skill files. No global client settings are modified. Native clients require workspace trust; Desktop and Cline require manual MCP import. Desktop produces six separately uploadable ZIPs. See [client-specific instructions](docs/harness/README.md) and [actual compatibility evidence](clients/compatibility.json). Configuration preparation is not model acceptance or real verification.
+Use `--client` for Codex, Claude Code/Desktop, Cursor, VS Code/Copilot, Copilot CLI, Gemini CLI, Cline, Roo Code or OpenCode. Setup previews by default, merges existing unrelated settings, backs up changed configurations and refuses differing Gridzen entries or Skill files. No global client settings are modified. Native clients require workspace trust; Desktop and Cline require manual MCP import. Desktop produces separately uploadable Skill ZIPs. See [client-specific instructions](docs/harness/README.md) and [actual compatibility evidence](clients/compatibility.json). Configuration preparation is not model acceptance or real verification.
 
 ## Hosted MCP aggregate attribution
 
@@ -205,7 +237,7 @@ gridzen feedback --task signup_phone --country US --outcome blocked --blocker mi
 gridzen feedback --input task-summary.json --share
 ```
 
-Phone intelligence is not OTP or ownership verification. Identity fixtures are not hosted document/liveness sessions. Payout matching remains a prototype with no real enabled route. Provider intake Skills are for provider operations/BYO, not a universal customer gate.
+Phone intelligence is not OTP or ownership verification. Identity fixtures are not hosted document/liveness sessions. Provider intake Skills are for provider operations/BYO, not a universal customer gate.
 
 Remote APIs count fixed task/capability/country/stage/error categories for 90 days, including technical failures. They store no arguments, identity data, credentials, raw chats or per-user tracking. Local feedback is off by default. After explicit opt-in, CLI and stdio MCP automatically upload category-only events. Reading static Skills remains unobservable. Optional feedback requires explicit consent, contains only fixed categories, and is unverified self-reported evidence. A SHA-256 hash of its random receipt ID is retained 30 days for 30-day retry deduplication; the ID itself is not stored. Counters are capped at 10,000 requests/day and 500 summaries/day per database; missing history or offline usage is unknown. Requests are not unique customers.
 
@@ -228,7 +260,7 @@ Local queued events expire after 30 days and are removed on the next enqueue/flu
 
 ## Separate owner-approved customer pilot
 
-The published 0.6.0 kit and its five public tools remain research/synthetic tools. A separate hosted pilot accepts customer applications for basic signup-phone validity and hosted personal identity onboarding: [apply](https://gridzen.ai/console/pilot?lang=en), [integration guide](https://gridzen.ai/console/pilot-guide?lang=en), [public scope](https://gridzen.ai/guides/customer-pilot/).
+The package and its five public tools retain their research/synthetic boundaries. A separate hosted pilot accepts customer applications for basic signup-phone validity and hosted personal identity onboarding: [apply](https://gridzen.ai/console/pilot?lang=en), [integration guide](https://gridzen.ai/console/pilot-guide?lang=en), [public scope](https://gridzen.ai/guides/customer-pilot/).
 
 Submitting an application never activates production. The owner must approve supplier rights, downstream agreements, capabilities, request limits and expiry; only confirmed free allowances are used. The production pilot has its own downloaded MCP client and merchant API key. Do not send documents, faces or provider keys to the public research MCP. Basic phone validity does not provide OTP or ownership.
 
@@ -236,3 +268,50 @@ Real basic phone checks and retrieval of a historical Approved operator identity
 
 
 Use `gridzen start --task identity_onboarding --lang en` to find the anonymous trial, free sandbox account and integration assistant. `gridzen start` makes no network calls. Account progress measurement is a separate, optional console consent; completing a sandbox does not verify a real person. Real payments remain disabled.
+
+## Complete a customer task
+
+- [Identity onboarding: three outcomes and application decisions](https://gridzen.ai/console/learn/identity-first-run?lang=en)
+- [Phone checks: validity, ownership and unavailable outcomes](https://gridzen.ai/console/learn/phone-check-boundaries?lang=en)
+- [Recover delayed callbacks](https://gridzen.ai/console/learn/callback-recovery?lang=en)
+- [Bind verification to seller permissions](https://gridzen.ai/console/learn/business-permission-boundary?lang=en)
+- [Runnable SQLite delivery example](examples/verification_delivery/README.md)
+- [Importable n8n fixture workflow](examples/n8n/README.md)
+
+These are synthetic integration examples. They do not prove real identity,
+production webhook delivery, customer adoption or payment. No account is needed
+for the anonymous response trial or local examples.
+
+Install all fourteen skills into your project:
+
+```bash
+npx skills add immurray/gridzen-developer-kit --skill '*' --agent codex --copy -y
+```
+
+Choose your supported agent instead of `codex`. Installation compatibility does
+not prove all agents have executed or recommended the skills.
+
+## Existing Mexico SPEI payment evidence
+
+In the installed package or developer source ZIP, use `gridzen tools --product mx-cep` to discover the separate authenticated CEP workflow. Public tools remain research/synthetic only. [Live capability conditions](https://gridzen.ai/console/api/payment-evidence/mx/cep/capabilities) require a merchant key; do not send transaction details or keys to public tools. [Runnable offline example](examples/cep_reconciliation/) makes no network calls. CEP preserves original XML, independent signature and exact expected-transaction binding; historical names do not establish current identity or account control. This workflow verifies existing SPEI evidence; it does not initiate a transfer.
+
+## Mexico identity and beneficiary-name comparison
+
+[Task, pricing boundaries and zero-cost integration examples](docs/mexico-identity-account.md) cover first account binding, account changes and exception review. The 14 MXN quote does not enable production calls; read the authenticated capability response. Public MCP and Skills remain research/synthetic only.
+
+[Run the identity/account result example offline, without signup](examples/mx_identity_account/).
+
+## Documents included with pip installation
+
+The wheel and source distribution include the same 14 canonical Skill directories
+and public integration guides as the website source download. English, Chinese and
+Spanish READMEs, task guides, ten-client instructions, examples and client templates
+are installed under `share/gridzen-developer-kit/` in your Python environment.
+
+```sh
+python -c "import sysconfig; from pathlib import Path; print(Path(sysconfig.get_path('data')) / 'share/gridzen-developer-kit/README.md')"
+```
+
+Open that README or `docs/harness/README.md` locally. Research snapshots and old
+offline identifiers remain compatible; they do not grant live verification or
+business authorization. CEP/SPEI guides describe evidence for existing transactions.

{gridzen_developer_kit-0.6.1 → gridzen_developer_kit-0.7.1}/README.es.md

@@ -1,12 +1,28 @@
-# Kit de desarrollo Gridzen 0.6.0
+# Kit de desarrollo Gridzen 0.7.1
+
+[Integración directa o GridZen: evalúe su tarea](docs/verification-evaluation.md#español) · [Preparación y costes](https://gridzen.ai/console/learn?lang=es&source=developer_kit#decision-fit)
+
+[Plan por verificación y requisitos de activación](https://gridzen.ai/console/quote?lang=es) · [JSON](https://gridzen.ai/console/api/commercial/options)
+
+## Ejecutar ejemplos de tareas
+
+- [Primera integración de identidad](https://gridzen.ai/console/learn/identity-first-run?lang=es)
+- [Límites de teléfonos de registro](https://gridzen.ai/console/learn/phone-check-boundaries?lang=es)
+- [Recuperar callbacks retrasados](https://gridzen.ai/console/learn/callback-recovery?lang=es)
+- [Permisos después de verificar](https://gridzen.ai/console/learn/business-permission-boundary?lang=es)
+
+[SQLite](examples/verification_delivery/) · [n8n](examples/n8n/)
+
+Los ejemplos son sintéticos. Se prepara el precio por verificación; pagos reales deshabilitados.
+
 
 ## Probar inmediatamente sin registro
 
 Abra la [prueba inmediata de GridZen](https://gridzen.ai/console/start?lang=es) para simular comprobaciones telefónicas e incorporación de identidad sin cuenta, clave ni aprobación. Los escenarios de éxito, rechazo e indisponibilidad no llaman a proveedores reales ni verifican personas. Los agentes pueden usar el [MCP de prueba sin clave](https://gridzen.ai/console/downloads/quickstart_mcp.py) con `mcp==2.3.0` y `httpx==0.28.1` en un entorno virtual.
 
-Conecte una cuenta sandbox con correo verificado para guardar registros y recibir callbacks. La producción sigue siendo un piloto gratuito controlado; autoservicio de producción y pagos no están habilitados. Esta actualización documental no cambia PyPI ni la versión del registro oficial MCP.
+Conecte una cuenta sandbox con correo verificado para guardar registros y recibir callbacks. El acceso real depende de cada producto: algunas rutas permiten pruebas limitadas y otras siguen sin estar disponibles. Consulta capacidades y permisos autenticados; un precio publicado no habilita compras. El paquete y el MCP Registry remoto tienen versiones independientes; instalar no concede permisos de comerciante.
 
-Investigación sobre 198 países y territorios, planificación de integraciones, cinco resultados simulados, CLI/SDK HTTP de Python, MCP local y seis Skills. No hay canales de proveedores reales activos. Ningún resultado simulado verifica a una persona real.
+Investigación sobre 198 países y territorios, planificación de integraciones, cinco resultados simulados, CLI/SDK HTTP de Python, MCP local y 14 Skills. El MCP público de investigación y simulación no llama a proveedores reales; los perfiles de comerciante requieren autorización separada. Ningún resultado simulado verifica a una persona real.
 
 Prueba y guía: https://gridzen.ai/developers/ . El selector permite cambiar entre español, inglés y chino, y recuerda la elección. La investigación es del 2026-10-07; las fuentes y sus restricciones se conservan en el idioma original.
 
@@ -18,9 +34,9 @@ Descarga y descomprime gridzen-developer-kit.zip. Ejecuta lo siguiente desde el
 python3 -m venv .venv
 . .venv/bin/activate
 python -m pip install './gridzen-developer-kit[mcp]'
-gridzen plan --country ID --event payout
+gridzen plan --country ID --event onboarding
 gridzen simulate --country ID --capability bank_account_match --scenario timeout
-python gridzen-developer-kit/examples/payout.py
+python gridzen-developer-kit/examples/customer_tasks.py
 ```
 
 En Windows, activa con `.venv\Scripts\activate`. La CLI y MCP local funcionan sin conexión tras instalar las dependencias; el SDK HTTP y el ejemplo de Python llaman al entorno público de pruebas.
@@ -33,9 +49,9 @@ Añade un servidor stdio local a un cliente compatible y sustituye command por l
 {"mcpServers":{"gridzen":{"command":"/absolute/path/to/.venv/bin/gridzen-mcp","args":[]}}}
 ```
 
-Prueba: «Planifica una verificación de pagos para Indonesia y simula una espera agotada del proveedor». Las cinco herramientas consultan cobertura, planifican, generan simulaciones, recuperan pruebas y explican resultados. La configuración depende del cliente; no hay endpoint MCP remoto de producción.
+Prueba: «Planifica una verificación de incorporación para Indonesia y simula una espera agotada del proveedor». Las cinco herramientas consultan cobertura, planifican, generan simulaciones, recuperan pruebas y explican resultados. La configuración depende del cliente; no hay endpoint MCP remoto de producción.
 
-Copia cada carpeta de `skills/` al directorio de habilidades del agente, conservando `SKILL.md` y sus referencias. Los seis Skills cubren selección, integración de pruebas, explicación de resultados, preparación de permisos, políticas de pagos y planificación de pilotos en México. Los identificadores permanecen en inglés; el agente puede explicar los resultados en español.
+Copia cada carpeta de `skills/` al directorio de habilidades del agente, conservando `SKILL.md` y sus referencias. Los 6 Skills de investigación/flujos cubren selección, integración de pruebas, explicación de resultados, preparación de permisos, políticas de revisión de evidencia y planificación de pilotos en México. Los identificadores permanecen en inglés; el agente puede explicar los resultados en español.
 
 ## Interpretación
 
@@ -63,16 +79,17 @@ Código original bajo MIT; consulte NOTICE.md para los derechos de terceros.
 
 ## Publicación en directorios
 
-El código, las descargas, la entrada oficial de MCP Registry y tres páginas de Skills.sh están publicados. La propuesta del catálogo de Docker está pendiente de revisión. Consulta [el registro de publicación](distribution/STATUS.md).
+El código, las descargas, la entrada oficial de MCP Registry y tres páginas de Skills.sh están publicados. La propuesta del catálogo de Docker está pendiente de revisión. Consulta [el registro de publicación](https://github.com/immurray/gridzen-developer-kit/blob/main/distribution/STATUS.md).
 
 
-## Six bundled Skills (0.6.0)
+## 14 bundled Skills (0.7.1)
 
 `python -m pip install gridzen-developer-kit` installs the CLI, stdio MCP dependencies
-and all six Skill directories. Version 0.6.0 is published on
-[PyPI](https://pypi.org/project/gridzen-developer-kit/0.6.0/); clean installation,
-CLI, stdio MCP and all six bundled Skill directories were verified. No extra MCP
-dependency installation is required.
+and all 14 Skill directories.
+
+The 14 Skills comprise 6 research/workflow Skills and 8 single-task profiles. Of the 8 profiles, 3 run offline and 5 merchant profiles require separate authorization. Five public MCP tools provide research/synthetic operations. No live identity verification. No extra MCP
+dependency installation is required. Check available versions on
+[PyPI](https://pypi.org/project/gridzen-developer-kit/).
 
 ```sh
 gridzen coverage --country MX
@@ -86,8 +103,8 @@ copy a complete directory into your assistant's configured Skills directory to
 activate it. Installing a wheel does not automatically activate a client's Skills.
 
 The existing select/integrate/explain Skills remain available. Added offline
-workflows, version 1.0.0: `mexico-pilot-scoper`, `payout-policy-designer`, and
-`provider-rights-readiness`. Each includes MIT, README, complete response fixtures
+workflows, version 1.0.0, cover evaluation scope, evidence-review policies and
+provider-rights readiness. Each includes MIT, README, complete response fixtures
 and agent acceptance prompts. They make no third-party calls and grant no real
 verification, legal approval or regulatory conclusion.
 
@@ -118,7 +135,7 @@ gridzen feedback --task signup_phone --country US --outcome blocked --blocker mi
 gridzen feedback --input task-summary.json --share
 ```
 
-Phone intelligence is not OTP or ownership verification. Identity fixtures are not hosted document/liveness sessions. Payout matching remains a prototype with no real enabled route. Provider intake Skills are for provider operations/BYO, not a universal customer gate.
+Phone intelligence is not OTP or ownership verification. Identity fixtures are not hosted document/liveness sessions. Provider intake Skills are for provider operations/BYO, not a universal customer gate.
 
 Remote APIs count fixed task/capability/country/stage/error categories for 90 days, including technical failures. They store no arguments, identity data, credentials, raw chats or per-user tracking. Local feedback is off by default. After explicit opt-in, CLI and stdio MCP automatically upload category-only events. Reading static Skills remains unobservable. Optional feedback requires explicit consent, contains only fixed categories, and is unverified self-reported evidence. A SHA-256 hash of its random receipt ID is retained 30 days for 30-day retry deduplication; the ID itself is not stored. Counters are capped at 10,000 requests/day and 500 summaries/day per database; missing history or offline usage is unknown. Requests are not unique customers.
 
@@ -143,7 +160,7 @@ Local queued events expire after 30 days and are removed on the next enqueue/flu
 
 ## Piloto independiente con aprobación del responsable
 
-El kit publicado 0.6.0 y sus cinco herramientas públicas siguen siendo de investigación y simulación. Puede solicitar un piloto independiente de validez básica del teléfono e incorporación de identidad: [solicitud](https://gridzen.ai/console/pilot?lang=es), [guía](https://gridzen.ai/console/pilot-guide?lang=es), [alcance](https://gridzen.ai/es/guides/customer-pilot/).
+El paquete y sus cinco herramientas públicas conservan sus límites de investigación y simulación. Puede solicitar un piloto independiente de validez básica del teléfono e incorporación de identidad: [solicitud](https://gridzen.ai/console/pilot?lang=es), [guía](https://gridzen.ai/console/pilot-guide?lang=es), [alcance](https://gridzen.ai/es/guides/customer-pilot/).
 
 Solicitar no activa producción. El responsable confirma derechos del proveedor, acuerdos, capacidades, límites y vencimiento; solo se usan cupos gratuitos confirmados. El piloto utiliza un cliente MCP separado y una clave comercial. No envíe documentos, caras ni claves del proveedor al MCP público. La validez básica no proporciona OTP ni prueba de titularidad.
 
@@ -151,3 +168,11 @@ Se validaron una consulta real de teléfono y la lectura de una sesión históri
 
 
 Use `gridzen start --task identity_onboarding --lang es` para encontrar la prueba anónima, la cuenta gratuita de sandbox y el asistente. El comando no hace llamadas de red. La medición de progreso requiere consentimiento opcional en la consola. Completar el sandbox no verifica a una persona real; los cobros reales siguen desactivados.
+
+## Guías y ejemplos ejecutables
+
+[Identity](https://gridzen.ai/console/learn/identity-first-run) · [Phone](https://gridzen.ai/console/learn/phone-check-boundaries) · [Callbacks](https://gridzen.ai/console/learn/callback-recovery) · [Permissions](https://gridzen.ai/console/learn/business-permission-boundary)
+
+[SQLite fixture](examples/verification_delivery/README.md) · [n8n fixture](examples/n8n/README.md)
+
+Synthetic only / Solo sintético / 仅模拟；没有真人核验、生产批准或真实收费。

{gridzen_developer_kit-0.6.1 → gridzen_developer_kit-0.7.1}/README.md

@@ -1,15 +1,45 @@
-# Gridzen Developer Kit 0.6.0
+# Gridzen Developer Kit 0.7.1
+
+The hosted developer interface supports Vietnamese alongside English, Spanish and Simplified Chinese: https://gridzen.ai/developers/?lang=vi . UI language does not enable live checks or country coverage. See [UI language maintenance](docs/multilingual-ui.md).
+
+[Choose direct integration or GridZen for your task](docs/verification-evaluation.md#english) · [Production and cost checklist](https://gridzen.ai/console/learn?lang=en&source=developer_kit#decision-fit)
+
+
+Single-task entry points: [tool catalog](https://gridzen.ai/tools/) · [setup and boundaries](docs/atomic-tools.md).
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install gridzen-developer-kit
+.venv/bin/gridzen tools
+.venv/bin/gridzen setup --client codex --product clabe-format --project .
+# Review the preview, then add --apply. No key is needed for local tools.
+```
 
 ## Start immediately without signup
 
 Open [GridZen instant trial](https://gridzen.ai/console/start?lang=en) to run synthetic signup-phone and identity-onboarding responses without an account, API key or approval. Success, rejection and unavailable scenarios make no upstream calls and verify no real person. Agents can use the separate [key-free trial MCP](https://gridzen.ai/console/downloads/quickstart_mcp.py), installed with `mcp==2.3.0` and `httpx==0.28.1` in a virtual environment.
 
-For persistent test records and supplier sandbox callbacks, connect a verified merchant sandbox account. Production is a separate controlled free pilot; self-service production and payments are not enabled. This documentation update does not change PyPI or the official MCP Registry version.
+For persistent test records and supplier sandbox callbacks, connect a verified merchant sandbox account. Production access is capability-specific: eligible routes may offer bounded real trials, while others remain unavailable. Read the authenticated capability conditions; published prices do not enable paid purchases. Package releases and the hosted MCP Registry entry have independent versions; installing this package grants no merchant permissions.
 
-Research for 198 countries/territories, a verification integration planner, five synthetic outcomes, an HTTP SDK, local MCP server and six Skills. **No live provider is enabled. No real person is verified.** The research snapshot is dated 2026-10-07, with source links and file hashes.
+Fourteen Skills: the original six research/workflow Skills plus eight single-task profiles. Three new tools run offline; five merchant profiles call the existing authenticated GridZen API only with separate authorization, current availability and permitted use. The anonymous remote MCP retains five research/synthetic tools and never performs live verification. Research covers 198 countries/territories as a dated 2026-10-07 snapshot, not live service coverage.
 
 [中文指南](README.zh-CN.md) · [Guía en español](README.es.md)
 
+## Runnable task guides and distribution
+
+| Customer task | Guide | Runnable code |
+| --- | --- | --- |
+| First identity onboarding | [Guide](https://gridzen.ai/console/learn/identity-first-run?lang=en) | [Delivery fixture](examples/verification_delivery/) |
+| Registration phone boundaries | [Guide](https://gridzen.ai/console/learn/phone-check-boundaries?lang=en) | [Four-branch example](https://gridzen.ai/guides/signup-phone-check/) |
+| Missing or delayed callback | [Guide](https://gridzen.ai/console/learn/callback-recovery?lang=en) | [Recovery fixture](examples/verification_delivery/) |
+| Verification to business permission | [Guide](https://gridzen.ai/console/learn/business-permission-boundary?lang=en) | [Self-hosted n8n fixture](examples/n8n/) |
+
+[Chinese and Spanish article files](https://github.com/immurray/gridzen-developer-kit/tree/main/distribution/market-expansion-2026-10-13/articles/) · [Demo video](https://github.com/immurray/gridzen-developer-kit/blob/main/distribution/market-expansion-2026-10-13/media/identity-three-outcomes.mp4).
+
+Public examples are synthetic. Approved prices and per-product availability are published at https://gridzen.ai/pricing/; paid activation remains unavailable. [Request an approved pilot](https://gridzen.ai/console/pilot), without sending identity documents or credentials to public MCP tools.
+
+[Per-check plan and activation requirements](https://gridzen.ai/console/quote?lang=en) · [JSON](https://gridzen.ai/console/api/commercial/options)
+
 ## Try it
 
 Public playground: https://gridzen.ai/developers/
@@ -21,9 +51,9 @@ python3 -m venv .venv
 . .venv/bin/activate
 python -m pip install './gridzen-developer-kit[mcp]'
 gridzen coverage --country ID --capability bank_account_match
-gridzen plan --country ID --event payout
+gridzen plan --country ID --event onboarding
 gridzen simulate --country ID --capability bank_account_match --scenario timeout
-python gridzen-developer-kit/examples/payout.py
+python gridzen-developer-kit/examples/customer_tasks.py
 ```
 
 Python 3.11+. CLI and MCP use the bundled offline catalog and fixtures; the Python HTTP client/example calls the public sandbox. Dependencies are downloaded only during installation. API reference: https://gridzen.ai/developers/api/openapi.json .
@@ -47,7 +77,7 @@ Copy the individual directories from `skills/` into your compatible agent's proj
 ```python
 from gridzen_developer.client import Gridzen
 client = Gridzen()
-plan = client.plan('ID', 'payout')
+plan = client.plan('ID', 'onboarding')
 result = client.simulate('ID', 'bank_account_match', 'not_found')
 assert result['status'] == 'inconclusive'
 assert result['verified'] is False
@@ -55,7 +85,7 @@ assert result['verified'] is False
 
 Only documented country/event/capability/scenario fields are accepted. Never send identity numbers, bank accounts, documents or credentials to the sandbox. Simulation IDs encode fixtures and are not unique transaction identifiers. A synthetic match cannot authorize real users or payments. Research evidence is distinct from Gridzen availability or commercial permission.
 
-## Repository checkout: local service and checks
+## Repository source: local service and checks
 
 ```sh
 python -m pip install '.[test,server]'
@@ -66,7 +96,7 @@ uvicorn gridzen_developer.server:app --host 127.0.0.1 --port 8030
 
 Production uses an independent container at localhost:8030 proxied only under `/developers/`. See deploy/compose.yml and deploy/developers.conf. Removing that proxy file and stopping this container rolls back the preview; the existing API and Agent Company stacks are separate.
 
-## Repository checkout: build distributions
+## Repository source: build distributions
 
 `python scripts/build_downloads.py` creates allowlisted developer-kit and Skills ZIPs; it excludes tests, deployment files, private credentials and itself from recursive download packaging. `python scripts/build_catalog.py <repo>/docs/research/identity-verification/2026-10-07` refreshes the public research projection. Main repository report files remain the provenance source.
 
@@ -83,11 +113,11 @@ npx skills add immurray/gridzen-developer-kit
 Install the tagged Python/MCP release from GitHub (Python 3.11+ and Git):
 
 ```sh
-python -m pip install "gridzen-developer-kit[mcp] @ git+https://github.com/immurray/gridzen-developer-kit.git@v0.6.0"
+python -m pip install "gridzen-developer-kit[mcp] @ git+https://github.com/immurray/gridzen-developer-kit.git@v0.7.1"
 ```
 
-PyPI 0.6.0 is published and verified. Install with `python -m pip install
-gridzen-developer-kit`. See [the release tracker](distribution/STATUS.md) for
+Install the latest PyPI release with `python -m pip install --upgrade
+gridzen-developer-kit`. See [the release tracker](https://github.com/immurray/gridzen-developer-kit/blob/main/distribution/STATUS.md) for
 publication and installation evidence.
 
 Remote client configuration (conventional JSON; client syntax may vary):
@@ -106,16 +136,17 @@ Original code and Skills: MIT. Research provenance and third-party rights:
 
 ## Marketplace availability
 
-Source, release downloads, the official MCP Registry entry and six Skills.sh pages are public. Docker catalog submission is awaiting review. See [the publication ledger](distribution/STATUS.md) for exact status and remaining platform steps.
+Source and previous release downloads are public. Existing Registry and Skills.sh listings cover the research service; new product profiles are not separate approved listings. Docker catalog submission is awaiting review. See [the publication ledger](https://github.com/immurray/gridzen-developer-kit/blob/main/distribution/STATUS.md) for exact status and remaining platform steps.
 
 
-## Six bundled Skills (0.6.0)
+## 14 bundled Skills (0.7.1)
 
 `python -m pip install gridzen-developer-kit` installs the CLI, stdio MCP dependencies
-and all six Skill directories. Version 0.6.0 is published on
-[PyPI](https://pypi.org/project/gridzen-developer-kit/0.6.0/); clean installation,
-CLI, stdio MCP and all six bundled Skill directories were verified. No extra MCP
-dependency installation is required.
+and all 14 Skill directories.
+
+The 14 Skills comprise 6 research/workflow Skills and 8 single-task profiles. Of the 8 profiles, 3 run offline and 5 merchant profiles require separate authorization. Five public MCP tools provide research/synthetic operations. No live identity verification. No extra MCP
+dependency installation is required. Check available versions on
+[PyPI](https://pypi.org/project/gridzen-developer-kit/).
 
 ```sh
 gridzen coverage --country MX
@@ -129,12 +160,12 @@ copy a complete directory into your assistant's configured Skills directory to
 activate it. Installing a wheel does not automatically activate a client's Skills.
 
 The existing select/integrate/explain Skills remain available. Added offline
-workflows, version 1.0.0: `mexico-pilot-scoper`, `payout-policy-designer`, and
-`provider-rights-readiness`. Each includes MIT, README, complete response fixtures
+workflows, version 1.0.0, cover evaluation scope, evidence-review policies and
+provider-rights readiness. Each includes MIT, README, complete response fixtures
 and agent acceptance prompts. They make no third-party calls and grant no real
 verification, legal approval or regulatory conclusion.
 
-## Configure your assistant (v0.6.0)
+## Configure your assistant (v0.7.1)
 
 ```sh
 python3 -m venv .venv
@@ -144,7 +175,7 @@ gridzen setup --client all --project .
 gridzen setup --client all --project . --apply
 ```
 
-Use `--client` for Codex, Claude Code/Desktop, Cursor, VS Code/Copilot, Copilot CLI, Gemini CLI, Cline, Roo Code or OpenCode. Setup previews by default, merges existing unrelated settings, backs up changed configurations and refuses differing Gridzen entries or Skill files. No global client settings are modified. Native clients require workspace trust; Desktop and Cline require manual MCP import. Desktop produces six separately uploadable ZIPs. See [client-specific instructions](docs/harness/README.md) and [actual compatibility evidence](clients/compatibility.json). Configuration preparation is not model acceptance or real verification.
+Use `--client` for Codex, Claude Code/Desktop, Cursor, VS Code/Copilot, Copilot CLI, Gemini CLI, Cline, Roo Code or OpenCode. Setup previews by default, merges existing unrelated settings, backs up changed configurations and refuses differing Gridzen entries or Skill files. No global client settings are modified. Native clients require workspace trust; Desktop and Cline require manual MCP import. Desktop produces separately uploadable Skill ZIPs. See [client-specific instructions](docs/harness/README.md) and [actual compatibility evidence](clients/compatibility.json). Configuration preparation is not model acceptance or real verification.
 
 ## Hosted MCP aggregate attribution
 
@@ -176,7 +207,7 @@ gridzen feedback --task signup_phone --country US --outcome blocked --blocker mi
 gridzen feedback --input task-summary.json --share
 ```
 
-Phone intelligence is not OTP or ownership verification. Identity fixtures are not hosted document/liveness sessions. Payout matching remains a prototype with no real enabled route. Provider intake Skills are for provider operations/BYO, not a universal customer gate.
+Phone intelligence is not OTP or ownership verification. Identity fixtures are not hosted document/liveness sessions. Provider intake Skills are for provider operations/BYO, not a universal customer gate.
 
 Remote APIs count fixed task/capability/country/stage/error categories for 90 days, including technical failures. They store no arguments, identity data, credentials, raw chats or per-user tracking. Local feedback is off by default. After explicit opt-in, CLI and stdio MCP automatically upload category-only events. Reading static Skills remains unobservable. Optional feedback requires explicit consent, contains only fixed categories, and is unverified self-reported evidence. A SHA-256 hash of its random receipt ID is retained 30 days for 30-day retry deduplication; the ID itself is not stored. Counters are capped at 10,000 requests/day and 500 summaries/day per database; missing history or offline usage is unknown. Requests are not unique customers.
 
@@ -199,7 +230,7 @@ Local queued events expire after 30 days and are removed on the next enqueue/flu
 
 ## Separate owner-approved customer pilot
 
-The published 0.6.0 kit and its five public tools remain research/synthetic tools. A separate hosted pilot accepts customer applications for basic signup-phone validity and hosted personal identity onboarding: [apply](https://gridzen.ai/console/pilot?lang=en), [integration guide](https://gridzen.ai/console/pilot-guide?lang=en), [public scope](https://gridzen.ai/guides/customer-pilot/).
+The package and its five public tools retain their research/synthetic boundaries. A separate hosted pilot accepts customer applications for basic signup-phone validity and hosted personal identity onboarding: [apply](https://gridzen.ai/console/pilot?lang=en), [integration guide](https://gridzen.ai/console/pilot-guide?lang=en), [public scope](https://gridzen.ai/guides/customer-pilot/).
 
 Submitting an application never activates production. The owner must approve supplier rights, downstream agreements, capabilities, request limits and expiry; only confirmed free allowances are used. The production pilot has its own downloaded MCP client and merchant API key. Do not send documents, faces or provider keys to the public research MCP. Basic phone validity does not provide OTP or ownership.
 
@@ -207,3 +238,50 @@ Real basic phone checks and retrieval of a historical Approved operator identity
 
 
 Use `gridzen start --task identity_onboarding --lang en` to find the anonymous trial, free sandbox account and integration assistant. `gridzen start` makes no network calls. Account progress measurement is a separate, optional console consent; completing a sandbox does not verify a real person. Real payments remain disabled.
+
+## Complete a customer task
+
+- [Identity onboarding: three outcomes and application decisions](https://gridzen.ai/console/learn/identity-first-run?lang=en)
+- [Phone checks: validity, ownership and unavailable outcomes](https://gridzen.ai/console/learn/phone-check-boundaries?lang=en)
+- [Recover delayed callbacks](https://gridzen.ai/console/learn/callback-recovery?lang=en)
+- [Bind verification to seller permissions](https://gridzen.ai/console/learn/business-permission-boundary?lang=en)
+- [Runnable SQLite delivery example](examples/verification_delivery/README.md)
+- [Importable n8n fixture workflow](examples/n8n/README.md)
+
+These are synthetic integration examples. They do not prove real identity,
+production webhook delivery, customer adoption or payment. No account is needed
+for the anonymous response trial or local examples.
+
+Install all fourteen skills into your project:
+
+```bash
+npx skills add immurray/gridzen-developer-kit --skill '*' --agent codex --copy -y
+```
+
+Choose your supported agent instead of `codex`. Installation compatibility does
+not prove all agents have executed or recommended the skills.
+
+## Existing Mexico SPEI payment evidence
+
+In the installed package or developer source ZIP, use `gridzen tools --product mx-cep` to discover the separate authenticated CEP workflow. Public tools remain research/synthetic only. [Live capability conditions](https://gridzen.ai/console/api/payment-evidence/mx/cep/capabilities) require a merchant key; do not send transaction details or keys to public tools. [Runnable offline example](examples/cep_reconciliation/) makes no network calls. CEP preserves original XML, independent signature and exact expected-transaction binding; historical names do not establish current identity or account control. This workflow verifies existing SPEI evidence; it does not initiate a transfer.
+
+## Mexico identity and beneficiary-name comparison
+
+[Task, pricing boundaries and zero-cost integration examples](docs/mexico-identity-account.md) cover first account binding, account changes and exception review. The 14 MXN quote does not enable production calls; read the authenticated capability response. Public MCP and Skills remain research/synthetic only.
+
+[Run the identity/account result example offline, without signup](examples/mx_identity_account/).
+
+## Documents included with pip installation
+
+The wheel and source distribution include the same 14 canonical Skill directories
+and public integration guides as the website source download. English, Chinese and
+Spanish READMEs, task guides, ten-client instructions, examples and client templates
+are installed under `share/gridzen-developer-kit/` in your Python environment.
+
+```sh
+python -c "import sysconfig; from pathlib import Path; print(Path(sysconfig.get_path('data')) / 'share/gridzen-developer-kit/README.md')"
+```
+
+Open that README or `docs/harness/README.md` locally. Research snapshots and old
+offline identifiers remain compatible; they do not grant live verification or
+business authorization. CEP/SPEI guides describe evidence for existing transactions.