@agentmanifest/cli 0.1.10 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,52 @@ All notable changes to the AMP CLI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-02-19
+
+### Added
+- AMP v0.2 spec support (agentmanifest-0.2)
+- New categories: food-science, materials, construction, music-gear, agriculture, computing, language, history, commerce, identity, logistics, other
+- New primary categories: reference, live, computational, transactional, enrichment, personal, discovery
+- New pricing models: per-query, pay-what-you-want, tiered
+- Required reliability section with maintained_by
+- Endpoint parameters as array format; response_description required
+
+### Changed
+- `amp init` now scaffolds a manifest (no wizard). Edit the file or use an AI agent to fill.
+- Removed interactive wizard - scaffold-only approach for simpler UX
+- Overwrite confirmation when agent-manifest.json already exists
+- Type definitions updated for v0.2 schema
+- Contact is now a single string (email or URL)
+- Authentication uses required flag + instructions instead of config
+
+### Removed
+- Interactive wizard (20+ prompts)
+- Rate limits (not in v0.2 spec)
+- Homepage/documentation from required fields
+- Old v0.1 category and pricing models
+
+## [0.1.11] - 2026-02-16
+
+### Fixed
+- Fixed `amp publish` to recognize 'completed' status from registry
+- Improved async polling to correctly handle registry response format
+- All publish features now fully functional with live registry
+
+## [0.1.10] - 2026-02-16
+
+### Fixed
+- Fixed `amp publish` to handle async registry submissions with status polling
+- Fixed registry URL from `agent-manifest.com` to `api.agent-manifest.com`
+- Added support for 'completed' status in addition to 'approved'
+- Increased polling timeout to 60 seconds
+- Improved error messages to show full response when details are missing
+
+## [0.1.9] - 2026-02-16
+
+### Fixed
+- Fixed validator response field in publish command (changed from 'valid' to 'passed')
+- Aligned publish command validation logic with validate command
+
 ## [0.1.8] - 2026-02-16
 
 ### Fixed

package/PROJECT_STRUCTURE.md

@@ -8,7 +8,7 @@ Complete Node.js CLI tool for the Agent Manifest Protocol, ready for npm publica
 amp-cli/
 ├── src/                          # TypeScript source files
 │   ├── commands/                 # Command implementations
-│   │   ├── init.ts              # Interactive manifest creation
+│   │   ├── init.ts              # Manifest scaffolding
 │   │   ├── validate.ts          # Manifest validation
 │   │   └── publish.ts           # Registry submission
 │   ├── constants.ts             # Controlled vocabularies
@@ -38,12 +38,10 @@ amp-cli/
 - Defines three main commands: init, validate, publish
 - Includes version and help information
 
-#### `commands/init.ts` (Interactive Scaffolding)
-- Full wizard for creating agent-manifest.json
-- Inquirer prompts for all required fields
-- Validates user input in real-time
-- Supports multiple endpoints with parameters
-- Generates compliant AMP v0.1 manifest
+#### `commands/init.ts` (Scaffolding)
+- Creates minimal valid agent-manifest.json per AMP v0.2 spec
+- No prompts - edit the file or have an AI agent fill it in
+- Prompts for overwrite confirmation if file already exists
 
 #### `commands/validate.ts` (Validation)
 - Reads manifest from filesystem
@@ -58,12 +56,14 @@ amp-cli/
 - Returns listing ID and registry URL
 
 #### `constants.ts` (Controlled Vocabularies)
-- Standard categories (15 categories)
-- Pricing models (free, usage_based, subscription)
+- Standard categories (20 categories: food-science, materials, chemistry, etc.)
+- Primary categories (reference, live, computational, transactional, enrichment, personal, discovery)
+- Pricing models (free, per-query, subscription, pay-what-you-want, tiered)
 - Authentication types (none, api_key, oauth2, bearer)
+- Maintained-by options (individual, organization, community)
 
 #### `types.ts` (TypeScript Definitions)
-- Complete type definitions for AMP v0.1
+- Complete type definitions for AMP v0.2
 - Interfaces for all manifest sections
 - Type safety for parameters and responses
 
@@ -125,14 +125,10 @@ amp-cli/
 
 ## Key Features
 
-### Interactive Creation (`amp init`)
-- Step-by-step wizard
-- Real-time validation
-- Multi-endpoint support
-- Parameter configuration
-- Optional sections (rate limits, reliability)
-- Contact information
-- Agent guidance notes
+### Scaffolding (`amp init`)
+- Instant manifest creation
+- Minimal valid template per spec
+- Edit directly or use AI agent to fill in
 
 ### Validation (`amp validate`)
 - API integration

package/QUICK_START.md

@@ -17,7 +17,7 @@ cd /path/to/your/api
 amp init
 ```
 
-Follow the prompts to create your `agent-manifest.json`.
+Creates `agent-manifest.json`. Edit it to add your API details.
 
 ### 2. Validate Your Manifest
 
@@ -52,15 +52,14 @@ amp publish
 
 ## Minimal Manifest Example
 
-The wizard will help you create something like this:
+`amp init` creates a scaffold like this. Edit to add your API details:
 
 ```json
 {
-  "spec_version": "agentmanifest-0.1",
+  "spec_version": "agentmanifest-0.2",
   "name": "Weather Data API",
   "version": "1.0.0",
   "description": "Provides real-time weather data and forecasts for locations worldwide with high accuracy and comprehensive coverage including current conditions, hourly forecasts, and historical data.",
-  "homepage": "https://api.weather-data.com",
   "categories": ["weather"],
   "primary_category": "live",
   "endpoints": [
@@ -68,19 +67,24 @@ The wizard will help you create something like this:
       "path": "/current",
       "method": "GET",
       "description": "Get current weather for a location",
-      "response": {
-        "type": "object",
-        "description": "Current weather conditions"
-      }
+      "parameters": [],
+      "response_description": "Current weather conditions including temperature and conditions"
     }
   ],
   "pricing": {
-    "model": "free"
+    "model": "free",
+    "free_tier": { "queries_per_day": null, "queries_per_month": null }
   },
   "authentication": {
+    "required": false,
     "type": "none"
   },
+  "reliability": {
+    "maintained_by": "organization"
+  },
   "agent_notes": "Simple weather API. Use location parameter with city names or coordinates for precise results.",
+  "contact": "support@weather-data.com",
+  "listing_requested": true,
   "last_updated": "2026-02-15T10:30:00Z"
 }
 ```
@@ -122,8 +126,8 @@ amp publish
 
 1. **Description Length**: Must be ≥100 characters. Be descriptive!
 2. **Agent Notes**: Must be ≥50 characters. Tell agents how to use your API.
-3. **Categories**: Choose the most relevant. Primary category must be in your categories list.
-4. **Homepage**: This is where your manifest will be hosted (`https://your-api.com/.well-known/agent-manifest.json`)
+3. **Categories**: Choose the most relevant. Primary category (reference, live, computational, etc.) is separate from categories.
+4. **Homepage**: Host your manifest at `https://your-api.com/.well-known/agent-manifest.json`
 
 ## Hosting Your Manifest
 

package/README.md

@@ -28,54 +28,20 @@ npx amp --help
 
 ### `amp init`
 
-Interactively create a new `agent-manifest.json` file in the current directory.
+Scaffold a valid `agent-manifest.json` file in the current directory.
 
 ```bash
 amp init
 ```
 
-This command walks you through all required fields defined in the AMP v0.1 specification:
-
-- **Basic Information**: Name, version, description, URLs
-- **Categories**: Primary and secondary categories from controlled vocabulary
-- **Endpoints**: API endpoints with methods, parameters, and responses
-- **Pricing**: Free, usage-based, or subscription models
-- **Authentication**: None, API key, OAuth2, or bearer token
-- **Rate Limits**: Request limits per minute/day (optional)
-- **Reliability**: Uptime and response time metrics (optional)
-- **Contact**: Support email, URLs, GitHub (optional)
-- **Agent Notes**: Implementation guidance for AI agents (min 50 chars)
-
-The generated manifest will be saved as `agent-manifest.json` in your current directory.
-
-#### Example Session
+Creates a minimal valid manifest per the AMP v0.2 specification. Edit the file to add your API details, or have an AI agent fill it in. Then run `amp validate` to check compliance.
 
 ```bash
 $ amp init
 
-🚀 Agent Manifest Protocol - Interactive Setup
-
-📋 Basic Information
-? API name: Chemistry Calculator API
-? Version (semantic versioning): 1.0.0
-? Description (min 100 characters): A comprehensive chemistry API providing molecular calculations, compound information, and reaction predictions for AI agents working with chemical data
-? Homepage URL (optional): https://api.chemcalc.com
-? Documentation URL (optional): https://docs.chemcalc.com
-
-🏷️  Categories
-? Select categories: chemistry, education
-? Select primary category: chemistry
-
-🔌 Endpoints
-? Endpoint path: /calculate/molar-mass
-? HTTP method: POST
-? Endpoint description: Calculate molar mass of chemical compounds
-? Response description: Returns molar mass in g/mol with compound details
-? Add parameters to this endpoint? Yes
-...
-
-✅ Success!
-Manifest created at: /path/to/agent-manifest.json
+✅ Created agent-manifest.json
+
+Edit the file, then run "amp validate".
 ```
 
 ---
@@ -119,7 +85,7 @@ File: /path/to/agent-manifest.json
 Sending to validator API...
 ✅ Validation Passed
 
-Your manifest is compliant with AMP specification v0.1
+Your manifest is compliant with AMP specification v0.2
 
 Next step: Run "amp publish" to submit to registry
 ```
@@ -138,7 +104,7 @@ Sending to validator API...
 
 Errors:
   1. description: Must be at least 100 characters (currently 45)
-  2. primary_category: Must be one of the categories in the categories array
+  2. primary_category: Must be one of: reference, live, computational, transactional, enrichment, personal, discovery
   3. agent_notes: Must be at least 50 characters (currently 20)
 
 Please fix the errors and try again.
@@ -223,7 +189,7 @@ Run "amp validate" for detailed validation output.
 ### Complete Setup Flow
 
 ```bash
-# 1. Create a new manifest interactively
+# 1. Create a new manifest
 amp init
 
 # 2. Review the generated file
@@ -240,20 +206,23 @@ amp publish
 
 ---
 
-## Manifest Schema (v0.1)
+## Manifest Schema (v0.2)
 
 ### Required Fields
 
-- `spec_version`: Always `"agentmanifest-0.1"`
-- `name`: API name (string)
+- `spec_version`: Always `"agentmanifest-0.2"`
+- `name`: API name (3-100 characters)
 - `version`: Semantic version (e.g., "1.0.0")
 - `description`: Min 100 characters
 - `categories`: Array of domain categories (from controlled vocabulary below)
 - `primary_category`: API type - one of: "reference", "live", "computational", "transactional", "enrichment", "personal", "discovery"
 - `endpoints`: At least one endpoint required
-- `pricing.model`: "free", "usage_based", or "subscription"
-- `authentication.type`: "none", "api_key", "oauth2", or "bearer"
+- `pricing.model`: "free", "per-query", "subscription", "pay-what-you-want", or "tiered"
+- `authentication.required`: Boolean; `type`: "api_key", "oauth2", "bearer", or "none"
+- `reliability.maintained_by`: "individual", "organization", or "community"
 - `agent_notes`: Min 50 characters - guidance for AI agents
+- `contact`: Contact email or URL (string)
+- `listing_requested`: Boolean
 
 ### Primary Category Types
 
@@ -268,21 +237,19 @@ amp publish
 ### Standard Domain Categories
 
 ```
-chemistry, biology, physics, mathematics, finance, weather,
-geography, food-science, engineering, legal, medical,
-education, translation, media, general
+food-science, materials, construction, music-gear, chemistry, biology,
+geography, finance, legal, medical, engineering, agriculture, computing,
+language, history, commerce, identity, weather, logistics, other
 ```
 
 ### Example Manifest
 
 ```json
 {
-  "spec_version": "agentmanifest-0.1",
+  "spec_version": "agentmanifest-0.2",
   "name": "Weather Data API",
   "version": "2.1.0",
   "description": "Real-time weather data and forecasts for locations worldwide. Provides current conditions, hourly forecasts, and historical weather data with high accuracy and global coverage.",
-  "homepage": "https://api.weather-data.com",
-  "documentation": "https://docs.weather-data.com",
   "categories": ["weather", "geography"],
   "primary_category": "live",
   "endpoints": [
@@ -290,45 +257,41 @@ education, translation, media, general
       "path": "/current",
       "method": "GET",
       "description": "Get current weather conditions for a location",
-      "parameters": {
-        "query": {
-          "location": {
-            "type": "string",
-            "required": true,
-            "description": "City name or coordinates (lat,lon)"
-          }
+      "parameters": [
+        {
+          "name": "location",
+          "type": "string",
+          "required": true,
+          "description": "City name or coordinates (lat,lon)"
         }
-      },
-      "response": {
-        "type": "object",
-        "description": "Current weather data including temperature, conditions, and metadata"
-      }
+      ],
+      "response_description": "Current weather data including temperature, conditions, and metadata"
     }
   ],
   "pricing": {
-    "model": "usage_based",
-    "details": "First 1000 requests free per month, then $0.001 per request"
+    "model": "per-query",
+    "free_tier": {
+      "queries_per_day": 1000,
+      "queries_per_month": 10000
+    },
+    "paid_tier": {
+      "amount_usd": 0.001,
+      "unit": "per request",
+      "description": "$0.001 per request after free tier"
+    }
   },
   "authentication": {
+    "required": true,
     "type": "api_key",
-    "config": {
-      "header": "X-API-Key",
-      "signup_url": "https://api.weather-data.com/signup"
-    }
-  },
-  "rate_limits": {
-    "requests_per_minute": 60,
-    "requests_per_day": 10000
-  },
-  "reliability_metrics": {
-    "uptime_percentage": 99.9,
-    "avg_response_time_ms": 150
+    "instructions": "Obtain API key at https://api.weather-data.com/signup"
   },
-  "contact": {
-    "email": "support@weather-data.com",
-    "support_url": "https://support.weather-data.com"
+  "reliability": {
+    "maintained_by": "organization",
+    "status_url": "https://status.weather-data.com",
+    "expected_uptime_pct": 99.9
   },
   "agent_notes": "Use the 'location' parameter with city names for simplicity. Coordinates provide more precise results. Response includes semantic metadata to help interpret weather conditions.",
+  "contact": "support@weather-data.com",
   "listing_requested": true,
   "last_updated": "2026-02-15T10:30:00Z"
 }
@@ -340,14 +303,14 @@ education, translation, media, general
 
 The validator checks for:
 
-1. **Spec Version**: Must be `"agentmanifest-0.1"`
-2. **Semantic Versioning**: Version must follow `x.y.z` format
+1. **Spec Version**: Must be `"agentmanifest-0.2"`
+2. **Semantic Versioning**: Version must follow `x.y.z` format (with optional pre-release/build)
 3. **Description Length**: Minimum 100 characters
 4. **Agent Notes Length**: Minimum 50 characters
-5. **Category Consistency**: Primary category must be in categories array
-6. **Endpoints**: At least one endpoint required
+5. **Primary Category**: Must be one of reference, live, computational, transactional, enrichment, personal, discovery
+6. **Endpoints**: At least one endpoint; description and response_description min 20 characters
 7. **Valid URLs**: All URLs must be HTTPS
-8. **Required Fields**: All mandatory fields present
+8. **Required Fields**: All mandatory fields present including reliability
 9. **Type Validation**: Fields match expected types
 
 ---
@@ -439,7 +402,7 @@ If you get validation errors, review the error messages carefully. Common issues
 - **Description too short**: Must be at least 100 characters
 - **Agent notes too short**: Must be at least 50 characters
 - **Invalid version**: Must follow semantic versioning (e.g., "1.0.0")
-- **Category mismatch**: Primary category must be in your categories array
+- **Invalid primary category**: Must be one of reference, live, computational, transactional, enrichment, personal, discovery
 - **Missing endpoints**: At least one endpoint required
 
 ---

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAOA,wBAAsB,WAAW,kBA6chC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAuCA,wBAAsB,WAAW,kBAkChC"}