api-to-cli 0.1.2 → 0.1.3

package/examples/openapi/sample-openapi-cli/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "sample-crm-api-cli",
+  "version": "1.0.0",
+  "description": "sample-crm-api CLI generated by AgentBridge",
+  "license": "MIT",
+  "type": "commonjs",
+  "bin": {
+    "sample-crm-api": "./bin/sample-crm-api.js"
+  },
+  "scripts": {
+    "start": "node ./bin/sample-crm-api.js"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  }
+}

package/examples/openapi/sample-openapi.yaml

@@ -0,0 +1,67 @@
+openapi: 3.0.3
+info:
+  title: Sample CRM API
+  version: 1.0.0
+servers:
+  - url: https://api.example-crm.com/v1
+paths:
+  /contacts:
+    get:
+      summary: List contacts
+      operationId: listContacts
+      parameters:
+        - in: query
+          name: limit
+          required: false
+          schema:
+            type: integer
+          description: Max contacts to return
+    post:
+      summary: Create contact
+      operationId: createContact
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - name
+              properties:
+                name:
+                  type: string
+                  description: Contact full name
+                email:
+                  type: string
+                  description: Contact email
+                subscribed:
+                  type: boolean
+                  description: Newsletter subscription status
+    
+  /contacts/{contactId}:
+    parameters:
+      - in: path
+        name: contactId
+        required: true
+        schema:
+          type: string
+        description: Contact ID
+    get:
+      summary: Get contact by ID
+    patch:
+      summary: Update contact fields
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                name:
+                  type: string
+                  description: Updated full name
+                email:
+                  type: string
+                  description: Updated email
+    delete:
+      summary: Delete contact

package/examples/trello/trelloapi-agent/README.md

@@ -2,6 +2,7 @@
 
 ## Contents
 - CLI project: ./cli
+- Input source: config (/Users/randall/Developer/Src/Repos/api-to-cli/examples/trello/api-to-cli.config.js)
 - Skill file: ./skill/SKILL.md
 - Manifest: ./agentbridge.manifest.json
 

package/examples/trello/trelloapi-agent/agentbridge.manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "1.0",
   "generatedBy": "AgentBridge",
-  "generatedAt": "2026-02-20T00:42:33.467Z",
+  "generatedAt": "2026-02-20T01:48:45.357Z",
   "project": {
     "name": "trelloapi",
     "version": "1.0.0"

package/examples/trello/trelloapi-agent/cli/commands/get-board.js

@@ -17,6 +17,10 @@ const command = {
 
 async function getBoard(options) {
   try {
+    if (command.method !== 'GET' && !options.yes) {
+      throw new Error('This operation changes state. Re-run with --yes to confirm.');
+    }
+
     const data = await request(command, options);
     output.json(data, Boolean(options.pretty));
   } catch (error) {

package/examples/trello/trelloapi-agent/cli/commands/list-board-lists.js

@@ -17,6 +17,10 @@ const command = {
 
 async function listBoardLists(options) {
   try {
+    if (command.method !== 'GET' && !options.yes) {
+      throw new Error('This operation changes state. Re-run with --yes to confirm.');
+    }
+
     const data = await request(command, options);
     output.json(data, Boolean(options.pretty));
   } catch (error) {

package/examples/trello/trelloapi-agent/cli/commands/list-list-cards.js

@@ -17,6 +17,10 @@ const command = {
 
 async function listListCards(options) {
   try {
+    if (command.method !== 'GET' && !options.yes) {
+      throw new Error('This operation changes state. Re-run with --yes to confirm.');
+    }
+
     const data = await request(command, options);
     output.json(data, Boolean(options.pretty));
   } catch (error) {

package/examples/trello/trelloapi-agent/cli/lib/client.js

@@ -1,3 +1,161 @@
+const fs = require('fs');
+
+function toKebab(name) {
+  return String(name)
+    .trim()
+    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+}
+
+function toCamelCase(name) {
+  return String(name).replace(/[-_]+([a-zA-Z0-9])/g, (_m, g1) => g1.toUpperCase());
+}
+
+function readOption(options, name) {
+  if (Object.prototype.hasOwnProperty.call(options, name)) {
+    return options[name];
+  }
+
+  const camel = toCamelCase(name);
+  if (Object.prototype.hasOwnProperty.call(options, camel)) {
+    return options[camel];
+  }
+
+  return undefined;
+}
+
+function coerceValue(value, type) {
+  if (value === undefined || value === null || value === '') {
+    return value;
+  }
+
+  if (type === 'number') {
+    const parsed = Number(value);
+    if (Number.isNaN(parsed)) {
+      throw new Error(`Expected number but received: ${value}`);
+    }
+    return parsed;
+  }
+
+  if (type === 'boolean') {
+    if (typeof value === 'boolean') {
+      return value;
+    }
+
+    const normalized = String(value).toLowerCase();
+    if (normalized === 'true' || normalized === '1') {
+      return true;
+    }
+
+    if (normalized === 'false' || normalized === '0') {
+      return false;
+    }
+
+    throw new Error(`Expected boolean but received: ${value}`);
+  }
+
+  return String(value);
+}
+
+function parseJsonText(raw, label) {
+  try {
+    return JSON.parse(raw);
+  } catch (_error) {
+    throw new Error(`Invalid JSON for ${label}`);
+  }
+}
+
+function parseJsonBody(rawBody) {
+  if (rawBody === undefined || rawBody === null || rawBody === '') {
+    return null;
+  }
+
+  return parseJsonText(rawBody, '--body');
+}
+
+function parseBodyFromStdin(enabled) {
+  if (!enabled) {
+    return null;
+  }
+
+  const raw = fs.readFileSync(0, 'utf8').trim();
+  if (!raw) {
+    throw new Error('Expected JSON on stdin because --body-stdin was provided');
+  }
+
+  return parseJsonText(raw, '--body-stdin');
+}
+
+function buildRequestBody(command, options) {
+  const requestBody = command.requestBody || null;
+  if (!requestBody) {
+    return null;
+  }
+
+  const direct = parseJsonBody(readOption(options, 'body'));
+  const stdin = parseBodyFromStdin(Boolean(readOption(options, 'body-stdin')));
+
+  if (direct !== null && stdin !== null) {
+    throw new Error('Use either --body or --body-stdin, not both');
+  }
+
+  const properties = requestBody.properties || {};
+  const hasBodyProps = Object.keys(properties).length > 0;
+
+  let payload = direct !== null ? direct : stdin !== null ? stdin : hasBodyProps ? {} : null;
+  if (payload !== null && (typeof payload !== 'object' || Array.isArray(payload))) {
+    throw new Error('Request body must be a JSON object');
+  }
+
+  if (payload === null && requestBody.required) {
+    throw new Error('Missing required request body. Provide --body, --body-stdin, or body field flags.');
+  }
+
+  let hadBodyFlag = false;
+  Object.entries(properties).forEach(([propName, schema]) => {
+    const optionName = `body-${toKebab(propName)}`;
+    const raw = readOption(options, optionName);
+    if (raw === undefined || raw === null || raw === '') {
+      return;
+    }
+
+    if (payload === null) {
+      payload = {};
+    }
+
+    payload[propName] = coerceValue(raw, schema.type);
+    hadBodyFlag = true;
+  });
+
+  if (hasBodyProps) {
+    if (payload === null) {
+      payload = {};
+    }
+
+    Object.entries(properties).forEach(([propName, schema]) => {
+      if (!schema.required) {
+        return;
+      }
+
+      if (!Object.prototype.hasOwnProperty.call(payload, propName) || payload[propName] === undefined || payload[propName] === null || payload[propName] === '') {
+        const optionName = `--body-${toKebab(propName)}`;
+        throw new Error(`Missing required request body field: ${optionName}`);
+      }
+    });
+  }
+
+  if (payload !== null) {
+    const isEmptyObject = typeof payload === 'object' && !Array.isArray(payload) && Object.keys(payload).length === 0;
+    if (isEmptyObject && !requestBody.required && !hadBodyFlag && direct === null && stdin === null) {
+      return null;
+    }
+  }
+
+  return payload;
+}
+
 async function request(command, options) {
   const auth = {
   "credentials": [
@@ -38,16 +196,17 @@ async function request(command, options) {
   });
 
   Object.entries(commandParams).forEach(([name, schema]) => {
-    const value = options[name];
+    const raw = readOption(options, name);
 
-    if ((value === undefined || value === null || value === '') && schema.required) {
+    if ((raw === undefined || raw === null || raw === '') && schema.required) {
       throw new Error(`Missing required parameter: --${name}`);
     }
 
-    if (value === undefined || value === null || value === '') {
+    if (raw === undefined || raw === null || raw === '') {
       return;
     }
 
+    const value = coerceValue(raw, schema.type);
     const token = `{${name}}`;
 
     if (resolvedPath.includes(token)) {
@@ -60,29 +219,35 @@ async function request(command, options) {
 
   const query = params.toString();
   const url = 'https://api.trello.com/1' + resolvedPath + (query ? '?' + query : '');
+  const requestBody = buildRequestBody(command, options);
+
+  if (requestBody !== null) {
+    headers['content-type'] = 'application/json';
+  }
 
   const response = await fetch(url, {
     method: command.method,
-    headers
+    headers,
+    body: requestBody !== null ? JSON.stringify(requestBody) : undefined
   });
 
   const text = await response.text();
-  let body = text;
+  let responseBody = text;
 
   try {
-    body = text ? JSON.parse(text) : null;
+    responseBody = text ? JSON.parse(text) : null;
   } catch (_err) {
-    body = text;
+    responseBody = text;
   }
 
   if (!response.ok) {
     const error = new Error(`HTTP ${response.status}`);
     error.statusCode = response.status;
-    error.responseBody = body;
+    error.responseBody = responseBody;
     throw error;
   }
 
-  return body;
+  return responseBody;
 }
 
 module.exports = {

package/examples/trello/trelloapi-cli/commands/get-board.js

@@ -17,6 +17,10 @@ const command = {
 
 async function getBoard(options) {
   try {
+    if (command.method !== 'GET' && !options.yes) {
+      throw new Error('This operation changes state. Re-run with --yes to confirm.');
+    }
+
     const data = await request(command, options);
     output.json(data, Boolean(options.pretty));
   } catch (error) {

package/examples/trello/trelloapi-cli/commands/list-board-lists.js

@@ -17,6 +17,10 @@ const command = {
 
 async function listBoardLists(options) {
   try {
+    if (command.method !== 'GET' && !options.yes) {
+      throw new Error('This operation changes state. Re-run with --yes to confirm.');
+    }
+
     const data = await request(command, options);
     output.json(data, Boolean(options.pretty));
   } catch (error) {

package/examples/trello/trelloapi-cli/commands/list-list-cards.js

@@ -17,6 +17,10 @@ const command = {
 
 async function listListCards(options) {
   try {
+    if (command.method !== 'GET' && !options.yes) {
+      throw new Error('This operation changes state. Re-run with --yes to confirm.');
+    }
+
     const data = await request(command, options);
     output.json(data, Boolean(options.pretty));
   } catch (error) {

package/examples/trello/trelloapi-cli/lib/client.js

@@ -1,3 +1,161 @@
+const fs = require('fs');
+
+function toKebab(name) {
+  return String(name)
+    .trim()
+    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+}
+
+function toCamelCase(name) {
+  return String(name).replace(/[-_]+([a-zA-Z0-9])/g, (_m, g1) => g1.toUpperCase());
+}
+
+function readOption(options, name) {
+  if (Object.prototype.hasOwnProperty.call(options, name)) {
+    return options[name];
+  }
+
+  const camel = toCamelCase(name);
+  if (Object.prototype.hasOwnProperty.call(options, camel)) {
+    return options[camel];
+  }
+
+  return undefined;
+}
+
+function coerceValue(value, type) {
+  if (value === undefined || value === null || value === '') {
+    return value;
+  }
+
+  if (type === 'number') {
+    const parsed = Number(value);
+    if (Number.isNaN(parsed)) {
+      throw new Error(`Expected number but received: ${value}`);
+    }
+    return parsed;
+  }
+
+  if (type === 'boolean') {
+    if (typeof value === 'boolean') {
+      return value;
+    }
+
+    const normalized = String(value).toLowerCase();
+    if (normalized === 'true' || normalized === '1') {
+      return true;
+    }
+
+    if (normalized === 'false' || normalized === '0') {
+      return false;
+    }
+
+    throw new Error(`Expected boolean but received: ${value}`);
+  }
+
+  return String(value);
+}
+
+function parseJsonText(raw, label) {
+  try {
+    return JSON.parse(raw);
+  } catch (_error) {
+    throw new Error(`Invalid JSON for ${label}`);
+  }
+}
+
+function parseJsonBody(rawBody) {
+  if (rawBody === undefined || rawBody === null || rawBody === '') {
+    return null;
+  }
+
+  return parseJsonText(rawBody, '--body');
+}
+
+function parseBodyFromStdin(enabled) {
+  if (!enabled) {
+    return null;
+  }
+
+  const raw = fs.readFileSync(0, 'utf8').trim();
+  if (!raw) {
+    throw new Error('Expected JSON on stdin because --body-stdin was provided');
+  }
+
+  return parseJsonText(raw, '--body-stdin');
+}
+
+function buildRequestBody(command, options) {
+  const requestBody = command.requestBody || null;
+  if (!requestBody) {
+    return null;
+  }
+
+  const direct = parseJsonBody(readOption(options, 'body'));
+  const stdin = parseBodyFromStdin(Boolean(readOption(options, 'body-stdin')));
+
+  if (direct !== null && stdin !== null) {
+    throw new Error('Use either --body or --body-stdin, not both');
+  }
+
+  const properties = requestBody.properties || {};
+  const hasBodyProps = Object.keys(properties).length > 0;
+
+  let payload = direct !== null ? direct : stdin !== null ? stdin : hasBodyProps ? {} : null;
+  if (payload !== null && (typeof payload !== 'object' || Array.isArray(payload))) {
+    throw new Error('Request body must be a JSON object');
+  }
+
+  if (payload === null && requestBody.required) {
+    throw new Error('Missing required request body. Provide --body, --body-stdin, or body field flags.');
+  }
+
+  let hadBodyFlag = false;
+  Object.entries(properties).forEach(([propName, schema]) => {
+    const optionName = `body-${toKebab(propName)}`;
+    const raw = readOption(options, optionName);
+    if (raw === undefined || raw === null || raw === '') {
+      return;
+    }
+
+    if (payload === null) {
+      payload = {};
+    }
+
+    payload[propName] = coerceValue(raw, schema.type);
+    hadBodyFlag = true;
+  });
+
+  if (hasBodyProps) {
+    if (payload === null) {
+      payload = {};
+    }
+
+    Object.entries(properties).forEach(([propName, schema]) => {
+      if (!schema.required) {
+        return;
+      }
+
+      if (!Object.prototype.hasOwnProperty.call(payload, propName) || payload[propName] === undefined || payload[propName] === null || payload[propName] === '') {
+        const optionName = `--body-${toKebab(propName)}`;
+        throw new Error(`Missing required request body field: ${optionName}`);
+      }
+    });
+  }
+
+  if (payload !== null) {
+    const isEmptyObject = typeof payload === 'object' && !Array.isArray(payload) && Object.keys(payload).length === 0;
+    if (isEmptyObject && !requestBody.required && !hadBodyFlag && direct === null && stdin === null) {
+      return null;
+    }
+  }
+
+  return payload;
+}
+
 async function request(command, options) {
   const auth = {
   "credentials": [
@@ -38,16 +196,17 @@ async function request(command, options) {
   });
 
   Object.entries(commandParams).forEach(([name, schema]) => {
-    const value = options[name];
+    const raw = readOption(options, name);
 
-    if ((value === undefined || value === null || value === '') && schema.required) {
+    if ((raw === undefined || raw === null || raw === '') && schema.required) {
       throw new Error(`Missing required parameter: --${name}`);
     }
 
-    if (value === undefined || value === null || value === '') {
+    if (raw === undefined || raw === null || raw === '') {
       return;
     }
 
+    const value = coerceValue(raw, schema.type);
     const token = `{${name}}`;
 
     if (resolvedPath.includes(token)) {
@@ -60,29 +219,35 @@ async function request(command, options) {
 
   const query = params.toString();
   const url = 'https://api.trello.com/1' + resolvedPath + (query ? '?' + query : '');
+  const requestBody = buildRequestBody(command, options);
+
+  if (requestBody !== null) {
+    headers['content-type'] = 'application/json';
+  }
 
   const response = await fetch(url, {
     method: command.method,
-    headers
+    headers,
+    body: requestBody !== null ? JSON.stringify(requestBody) : undefined
   });
 
   const text = await response.text();
-  let body = text;
+  let responseBody = text;
 
   try {
-    body = text ? JSON.parse(text) : null;
+    responseBody = text ? JSON.parse(text) : null;
   } catch (_err) {
-    body = text;
+    responseBody = text;
   }
 
   if (!response.ok) {
     const error = new Error(`HTTP ${response.status}`);
     error.statusCode = response.status;
-    error.responseBody = body;
+    error.responseBody = responseBody;
     throw error;
   }
 
-  return body;
+  return responseBody;
 }
 
 module.exports = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "api-to-cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Generate AI-agent-friendly CLIs, skills, and manifests from API configs",
   "license": "MIT",
   "type": "commonjs",
@@ -36,11 +36,17 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
   "scripts": {
     "validate:trello": "node ./bin/api-to-cli.js validate --config ./examples/trello/api-to-cli.config.js",
     "generate:trello": "node ./bin/api-to-cli.js generate --config ./examples/trello/api-to-cli.config.js --output ./examples/trello/trelloapi-cli",
     "scaffold:trello": "node ./bin/api-to-cli.js scaffold --config ./examples/trello/api-to-cli.config.js --output ./examples/trello/trelloapi-agent",
-    "test:smoke": "npm run validate:trello && npm run generate:trello && npm run scaffold:trello",
+    "validate:openapi": "node ./bin/api-to-cli.js validate --spec ./examples/openapi/sample-openapi.yaml",
+    "generate:openapi": "node ./bin/api-to-cli.js generate --spec ./examples/openapi/sample-openapi.yaml --output ./examples/openapi/sample-openapi-cli",
+    "scaffold:openapi": "node ./bin/api-to-cli.js scaffold --spec ./examples/openapi/sample-openapi.yaml --output ./examples/openapi/sample-openapi-agent",
+    "test:smoke": "npm run validate:trello && npm run generate:trello && npm run scaffold:trello && npm run validate:openapi && npm run generate:openapi && npm run scaffold:openapi",
     "pack:check": "npm pack --dry-run"
   }
 }