Commit Graph

123 Commits

Author SHA1 Message Date
David Noël-Romas ca3752be4f docs: add backup API server implementation spec
Describes the three endpoints the CLI expects for the backup
feature (PUT/GET /backup/files, GET /backup/status), including
request/response shapes, auth pattern, and storage considerations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 00:16:55 -06:00
David Noël-Romas 1c10051244 docs(atxp): address ClawHub OpenClaw scanner concerns
The OpenClaw LLM scanner flagged the skill as "suspicious" across
five dimensions. Changes to improve the score:

- Add top-level permissions field to frontmatter declaring network,
  filesystem, subprocess, and credential access explicitly
- Expand compatibility field to mention all runtime requirements
  (credential, network, filesystem, npx download)
- Add Runtime Execution Model section documenting npx download
  behavior, version pinning, source verification, and cache location
- Add human-approval recommendations for financial operations:
  require approval before first paid call, use test wallets,
  implement per-session spending caps, treat email send as high-risk
- Remove "No human approval per transaction" claim and replace with
  pointer to Financial Safety guardrails

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
v1.11.0
2026-02-21 23:42:17 -06:00
David Noël-Romas e2b9d9a15f docs(atxp): harden SKILL.md against security audit findings
Address Snyk W007 (HIGH): remove --token CLI examples and echo
$ATXP_CONNECTION pattern that expose secrets in process listings
and shell history. Add explicit rule against passing credentials
as CLI arguments.

Address Snyk W011 / Trust Hub prompt injection: add boundary
marker guidance ([BEGIN/END UNTRUSTED CONTENT]) for untrusted
output from search, email, and X commands.

Address Snyk W009: add Financial Safety section with guardrails
against externally-triggered spending, payment link generation,
and social engineering vectors.

Address Trust Hub command execution: add explicit rule against
sourcing ~/.atxp/config (uses export syntax = shell execution).

Update version pinning guidance to recommend exact versions and
npm audit signatures for supply-chain verification.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-21 23:39:47 -06:00
David Noël-Romas 66b8b1fe02 feat(atxp): add backup command for agent identity and memory files
Push/pull .md files to ATXP servers so agents can preserve their
identity (SOUL.md, MEMORY.md, etc.) across workspace rebuilds.
Separate skill file with its own security boundary since it reads/writes
arbitrary directories.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-21 23:38:40 -06:00
David N f4ac1d9187 Merge pull request #46 from atxp-dev/claude/update-atxp-llm-gateway-vgqhS 2026-02-19 19:17:05 -06:00
Claude f7fa095fea docs(atxp): expand LLM Gateway section with OpenAI-compatible API details
Adds detail to the SKILL.md LLM Gateway section explaining that:
- The gateway accepts ATXP credits and exposes state-of-the-art models
- It features an OpenAI-compatible API for easy drop-in integration
- Authentication uses the existing ATXP_CONNECTION token
- Links to https://docs.atxp.ai/agents/llm-gateway

https://claude.ai/code/session_01VwZwfGeDbJMJrB39TV8ucv
2026-02-20 00:30:01 +00:00
R-M-Naveen b8fc220eb8 Merge pull request #45 from atxp-dev/naveen/skill.md-refinements
docs: rewrite SKILL.md with security model, expanded metadata, and @latest pinning
2026-02-19 10:45:03 -06:00
R-M-Naveen 5ec26b9a14 docs: rewrite SKILL.md with security model, expanded metadata, and @latest pinning
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 10:31:56 -06:00
R-M-Naveen 8472aff7a2 Merge pull request #44 from atxp-dev/naveen/agent-register-cli-added
Naveen/agent register cli added
2026-02-18 16:50:36 -06:00
R-M-Naveen dfdc05cd3c Merge remote-tracking branch 'origin/main' into naveen/agent-register-cli-added 2026-02-18 16:47:41 -06:00
R-M-Naveen 2152d56446 docs: add agent, topup, and whoami commands to SKILL.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 16:47:41 -06:00
GitHub Action a4f0d06d0b bump version to 1.10.9 [skip ci] 2026-02-18 22:01:26 +00:00
R-M-Naveen a841f37272 Merge pull request #43 from atxp-dev/naveen/agent-register-cli-added
feat: add topup command and owner info in whoami
v1.10.9
2026-02-18 15:57:55 -06:00
R-M-Naveen ec82f9653c feat: add topup command and owner info in whoami
Add `npx atxp topup` command for agent funding via Stripe Payment Links
with payer-adjustable amounts ($1-$1000, default $10). Update whoami to
display owner email and orphan status for agent accounts.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 15:29:47 -06:00
GitHub Action 44d7574982 bump version to 1.10.8 [skip ci] 2026-02-18 01:06:33 +00:00
R-M-Naveen 11dd8e3c8f fix: login --token with full connection string URL no longer doubles the URL
When passing a full connection string (starting with http) via --token,
the login command was wrapping it inside another URL, producing an invalid
doubled connection string. Now detects full URLs and uses them as-is.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
v1.10.8
2026-02-17 19:05:14 -06:00
GitHub Action 2a2eeb9390 bump version to 1.10.7 [skip ci] 2026-02-18 00:59:09 +00:00
R-M-Naveen eb46594598 Merge pull request #42 from atxp-dev/naveen/agent-register-cli-added
feat: simplify agent register to single-step and add whoami command
v1.10.7
2026-02-17 18:53:26 -06:00
R-M-Naveen 7c3524dc65 feat: simplify agent register to single-step and add whoami command
Remove the two-step challenge/verify flow from `agent register` — now a
single POST creates the agent account and returns credentials immediately.

Add `whoami` command that displays account info (ID, email, wallet, team,
connection string) by hitting GET /me with Basic auth.

- Remove readline import, promptForInput helper, --answer/--registration-id flags
- Single POST to /agents/register returns full account data
- New commands/whoami.ts with formatted output matching register style
- Wire whoami into index.ts and help.ts

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 18:45:37 -06:00
GitHub Action 8193ebcf9e bump version to 1.10.6 [skip ci] 2026-02-17 23:01:41 +00:00
David Noël-Romas f72ca50a88 feat: Add email reply, search, delete, and attachment commands
- reply: Reply to a message with auto-populated threading headers ($0.01)
- search: Search emails by subject or sender address (FREE)
- delete: Soft-delete an email (FREE)
- get-attachment: Download attachment content as base64 (FREE)
- Show read/unread status in inbox and search listings
- Show attachment list when reading a message

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
v1.10.6
2026-02-17 17:00:44 -06:00
GitHub Action 5b644397bc bump version to 1.10.5 [skip ci] 2026-02-17 20:57:17 +00:00
David Noël-Romas 198ffbab37 feat: Add email username claim/release commands
Support the new email_claim_username and email_release_username MCP
tools. Users can claim a human-readable username ($1.00) to use
{username}@atxp.email instead of {user_id}@atxp.email.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
v1.10.5
2026-02-17 14:56:21 -06:00
GitHub Action 738d33b60c bump version to 1.10.4 [skip ci] 2026-02-17 20:23:28 +00:00
David Noël-Romas a30f677e5b feat: Rename deposit to fund, add credit card payment option
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
v1.10.4
2026-02-17 14:22:30 -06:00
GitHub Action 943f211ca6 bump version to 1.10.3 [skip ci] 2026-02-16 17:42:34 +00:00
David Noël-Romas e1fbefbfd1 feat: Add deposit address command
Adds `npx atxp deposit` to fetch and display the user's deposit
addresses (typically Base and Solana) for topping up their ATXP
account with USDC.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
v1.10.3
2026-02-16 11:41:49 -06:00
GitHub Action e11337018e bump version to 1.10.2 [skip ci] 2026-02-12 17:28:16 +00:00
R-M-Naveen 9a798209ab Merge pull request #41 from atxp-dev/naveen/agent-register-cli-added
feat: Add --registration-id flag for two-step agent registration
v1.10.2
2026-02-12 12:26:27 -05:00
R-M-Naveen d053f244a0 feat: Add --registration-id flag for two-step agent registration
Allows agents to resume a previous registration challenge without
fetching a new one. When both --registration-id and --answer are
provided, the CLI skips step 1 (challenge fetch) and goes directly
to verification. This enables non-interactive registration flows.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-12 11:21:42 -06:00
GitHub Action e3adb9ad2c bump version to 1.10.1 [skip ci] 2026-02-12 16:30:15 +00:00
R-M-Naveen 390757cbd9 Merge pull request #40 from atxp-dev/naveen/agent-register-cli-added
feat: Add agent self-registration CLI command
v1.10.1
2026-02-12 11:15:47 -05:00
R-M-Naveen 796140e546 feat: Add agent self-registration CLI command
Adds `npx atxp agent register` for AI agents to self-register without
requiring an existing login. The command handles the 2-step flow:
fetches a base64-encoded captcha challenge, decodes and displays it,
prompts for the answer, then verifies and creates the account.

Supports --server flag for custom server URL and --answer for
non-interactive use.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-12 10:10:52 -06:00
GitHub Action 88db529a4b bump version to 1.10.0 [skip ci] 2026-02-10 15:11:47 +00:00
R-M-Naveen 2f0c140f6a Merge pull request #39 from atxp-dev/naveen/agent-account-cli-changes
feat: Add agent create/list CLI commands
v1.10.0
2026-02-10 08:47:08 -06:00
R-M-Naveen b4c0eb35d9 feat: Add agent create/list CLI commands
Adds `npx atxp agent create` and `npx atxp agent list` commands
for managing agent accounts directly from the CLI.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-10 09:36:29 -05:00
GitHub Action a20941e9ae bump version to 1.9.0 [skip ci] 2026-02-06 22:38:23 +00:00
David Noël-Romas cd730d8600 feat: Add balance command and update atxp skill with LLM gateway, Clowdbot, and support info
Add `npx atxp balance` command that queries the ATXP accounts API to
display combined USDC + IOU balance. Update the atxp skill with guidance
on LLM Gateway access, Clowdbot environment configuration, contacting
support@atxp.ai, and checking email inbox daily for skill updates.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
v1.9.0
2026-02-06 16:37:19 -06:00
GitHub Action 3208b5e5d4 bump version to 1.8.2 [skip ci] 2026-02-01 06:21:27 +00:00
David Noël-Romas 7f86b2163b feat: Display agent email address in read and send responses
The email MCP server now returns inboxAddress in every response.
Updated readMessage and sendEmail to display this information.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
v1.8.2
2026-02-01 00:20:41 -06:00
GitHub Action 13e981d6c1 bump version to 1.8.1 [skip ci] 2026-01-31 08:25:43 +00:00
David Noël-Romas 674056d6d1 feat: Add email read command for fetching full message content
- Add `npx atxp email read <messageId>` command to read full message body
- Update inbox display to show message IDs
- Integrate with new `email_get_message` MCP tool
- Update skill documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
v1.8.1
2026-01-31 02:25:05 -06:00
GitHub Action a28b673bf8 bump version to 1.8.0 [skip ci] 2026-01-31 08:08:06 +00:00
David Noël-Romas 52cc48fb19 feat: Add email service support to CLI
- Add `npx atxp email inbox` command to check inbox (free)
- Add `npx atxp email send` command with --to, --subject, --body options ($0.01/email)
- Integrate with email.mcp.atxp.ai MCP server
- Update help to include email commands
- Update atxp skill documentation with email usage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
v1.8.0
2026-01-31 02:06:51 -06:00
GitHub Action bae8f11b94 bump version to 1.7.0 [skip ci] 2026-01-28 21:38:12 +00:00
emilioacc 64a15133fe feat: Add worker info command to display worker details (#31)
* feat: Add worker info command to display worker details

- Add workerInfoCommand() function that calls get_worker_info tool
- Display worker name, URL, creation/modification timestamps
- Format bindings output: databases, storage, analytics, env vars, secrets
- Add 'info' case to handleWorkerCommand() switch
- Update help text and error messages to include info command

ATXP-1430

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* chore: trigger CI

* test: add tests for workerInfoCommand

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: correct process.exit mocking in workerInfoCommand tests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* chore: trigger CI

* chore: trigger CI build

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
v1.7.0
2026-01-28 16:36:24 -05:00
emilioacc 39b440334b feat: Add comprehensive tests for env vars and secrets (ATXP-1436) (#36)
- Add unit tests for parseEnvArg(), parseEnvFile(), validateEnvVarName()
- Add tests for SENSITIVE_PATTERNS and getReservedEnvNames()
- Add tests for --env flag precedence over --env-file
- Add tests for sensitive pattern warnings
- Create secrets.test.ts with tests for parseKeyValue(), isValidSecretKey()
- Add tests for secretsSetCommand, secretsListCommand, secretsDeleteCommand
- Export helper functions for direct unit testing

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-28 16:22:54 -05:00
emilioacc 049d5ede0e feat(paas): add real-time log streaming with --follow flag (#34)
Add --follow (-f) flag to `npx atxp paas worker logs` command for
continuous log streaming via client-side polling.

Features:
- Stream logs continuously with Ctrl+C to stop
- Configurable polling interval via --interval flag (default: 2000ms)
- Color-coded log output by level (error, warn, info, debug)
- Deduplication to prevent duplicate log entries
- Automatic retry logic (3 attempts with 5s delay)
- Memory-bounded deduplication set (max 10k entries)
- Works with existing filters (--level, --since)

Usage:
  npx atxp paas worker logs my-api --follow
  npx atxp paas worker logs my-api -f --interval 500
  npx atxp paas worker logs my-api --follow --level error

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-28 16:00:21 -05:00
emilioacc 0c42583cf4 feat(cli): make OAuth debug logs opt-in via --verbose flag (#35)
Suppress [atxp] OAuth debug logs by default. Enable them via:
- --verbose or -v flag
- DEBUG=atxp, DEBUG=1, or DEBUG=true environment variable

Changes:
- Add verbose.ts utility with isVerboseMode() and getCliLogger()
- Update atxpClient() to use LogLevel.WARN by default
- Add Global Options section to help output
- Add unit tests for verbose mode detection

Fixes: ATXP-1428

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-28 15:56:50 -05:00
emilioacc 9929d0b00a feat(paas): implement consistent --help at all PAAS command levels (#33)
* feat(paas): implement consistent --help at all PAAS command levels

- Stop global --help interception for paas commands in index.ts
- Create centralized help registry with data-driven definitions in help.ts
- Handle --help at category, command, and subcommand levels
- Add CI test coverage to ensure help documentation for all commands

Closes ATXP-1426

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix(paas): fix test to handle multi-word related commands

Use replaceAll instead of replace to convert all spaces to dots
for nested commands like "dns record create" -> "dns.record.create"

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-28 13:05:14 -05:00