Skip to content

docs: add scope3 package to CLI installation instructions#22

Merged
bokelley merged 4 commits into
mainfrom
update-readme-scope3
Nov 8, 2025
Merged

docs: add scope3 package to CLI installation instructions#22
bokelley merged 4 commits into
mainfrom
update-readme-scope3

Conversation

@bokelley
Copy link
Copy Markdown
Collaborator

@bokelley bokelley commented Nov 8, 2025

Adds documentation for the recommended scope3 package for shorter CLI commands.

This is a documentation-only change to highlight the convenience package for users.

Example:

npx scope3 brand-agent list

Instead of:

npx @scope3/agentic-client brand-agent list

Highlights the recommended scope3 package for shorter npx commands.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@bokelley bokelley requested a review from a team November 8, 2025 15:42
@bokelley bokelley enabled auto-merge (squash) November 8, 2025 15:42
bokelley and others added 3 commits November 8, 2025 10:42
Makes the client fail loudly when the API doesn't return structuredContent,
helping catch API specification violations that need upstream fixes.

Changes:
- Remove fallback JSON parsing from text content
- Throw descriptive error when structuredContent is missing
- Include debug details (tool name, content type, preview) in error
- Update tests to verify strict validation

This ensures we catch and report any API endpoints that aren't following
the Scope3 MCP specification correctly.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
When the MCP API returns both content.text (human message) and structuredContent
(structured data), the CLI now displays both:
1. Human-readable message in cyan
2. Blank line
3. Structured data in table/list format

In JSON mode, includes _message field with the text.

Changes:
- Client extracts text message from content and includes as _message
- CLI detects _message and displays it before structured data
- Updated tests to verify message handling
- 84 tests passing

Example output:
  Found 1 agent:

  1. Yahoo Staging Sales Agent
     [table with structured data follows]

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@bokelley bokelley merged commit 5b88de3 into main Nov 8, 2025
6 checks passed
@bokelley bokelley deleted the update-readme-scope3 branch November 8, 2025 15:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants