api-to-cli 0.1.1 → 0.1.3

package/examples/openapi/sample-openapi-agent/cli/lib/client.js

@@ -0,0 +1,244 @@
+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": []
+};
+  const params = new URLSearchParams();
+  const commandParams = command.params || {};
+  let resolvedPath = command.path;
+  const headers = {
+    accept: 'application/json'
+  };
+
+  (auth.credentials || []).forEach((credential) => {
+    const envValue = process.env[credential.envVar];
+
+    if (!envValue) {
+      throw new Error(`Missing required auth environment variable: ${credential.envVar}`);
+    }
+
+    const authValue = credential.prefix ? `${credential.prefix}${envValue}` : envValue;
+
+    if (credential.in === 'header') {
+      headers[credential.name] = authValue;
+      return;
+    }
+
+    params.append(credential.name, authValue);
+  });
+
+  Object.entries(commandParams).forEach(([name, schema]) => {
+    const raw = readOption(options, name);
+
+    if ((raw === undefined || raw === null || raw === '') && schema.required) {
+      throw new Error(`Missing required parameter: --${name}`);
+    }
+
+    if (raw === undefined || raw === null || raw === '') {
+      return;
+    }
+
+    const value = coerceValue(raw, schema.type);
+    const token = `{${name}}`;
+
+    if (resolvedPath.includes(token)) {
+      resolvedPath = resolvedPath.replaceAll(token, encodeURIComponent(String(value)));
+      return;
+    }
+
+    params.append(name, String(value));
+  });
+
+  const query = params.toString();
+  const url = 'https://api.example-crm.com/v1' + 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,
+    body: requestBody !== null ? JSON.stringify(requestBody) : undefined
+  });
+
+  const text = await response.text();
+  let responseBody = text;
+
+  try {
+    responseBody = text ? JSON.parse(text) : null;
+  } catch (_err) {
+    responseBody = text;
+  }
+
+  if (!response.ok) {
+    const error = new Error(`HTTP ${response.status}`);
+    error.statusCode = response.status;
+    error.responseBody = responseBody;
+    throw error;
+  }
+
+  return responseBody;
+}
+
+module.exports = {
+  request
+};

package/examples/openapi/sample-openapi-agent/cli/lib/output.js

@@ -0,0 +1,21 @@
+function json(data, pretty) {
+  const text = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+  process.stdout.write(text + '\n');
+}
+
+function error(payload, pretty) {
+  const envelope = {
+    error: true,
+    code: payload.code || 'REQUEST_FAILED',
+    message: payload.message || 'Request failed',
+    details: payload.details || {}
+  };
+
+  const text = pretty ? JSON.stringify(envelope, null, 2) : JSON.stringify(envelope);
+  process.stderr.write(text + '\n');
+}
+
+module.exports = {
+  json,
+  error
+};

package/examples/openapi/sample-openapi-agent/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-agent/skill/SKILL.md

@@ -0,0 +1,50 @@
+# sample-crm-api CLI Skill
+
+## Purpose
+Use the generated sample-crm-api CLI from AgentBridge. Always prefer JSON output for machine parsing.
+
+## Location
+- CLI project: ./cli
+- Binary name: sample-crm-api
+
+## Setup
+1. cd ./cli
+2. npm install
+3. npm link
+
+## Auth
+- No auth env vars required
+
+## Commands
+- list-contacts: List contacts
+  - --limit <value> (optional)
+  - example: sample-crm-api list-contacts --limit <value>
+- create-contact: Create contact
+  - --yes (required for non-GET operations)
+  - --body <json> (raw JSON body fallback)
+  - --body-stdin (read JSON body from stdin)
+  - --body-name <value> (required)
+  - --body-email <value> (optional)
+  - --body-subscribed <value> (optional)
+  - example: sample-crm-api create-contact --yes --body-name <value> --body-email <value> --body-subscribed <value> --body '{"key":"value"}'
+- get-contacts-by-contactid: Get contact by ID
+  - --contact-id <value> (required)
+  - example: sample-crm-api get-contacts-by-contactid --contact-id <value>
+- patch-contacts-by-contactid: Update contact fields
+  - --contact-id <value> (required)
+  - --yes (required for non-GET operations)
+  - --body <json> (raw JSON body fallback)
+  - --body-stdin (read JSON body from stdin)
+  - --body-name <value> (optional)
+  - --body-email <value> (optional)
+  - example: sample-crm-api patch-contacts-by-contactid --contact-id <value> --yes --body-name <value> --body-email <value> --body '{"key":"value"}'
+- delete-contacts-by-contactid: Delete contact
+  - --contact-id <value> (required)
+  - --yes (required for non-GET operations)
+  - example: sample-crm-api delete-contacts-by-contactid --contact-id <value> --yes
+
+## Rules
+- Do not echo or log auth secrets.
+- Do not pass credentials as command flags.
+- Parse command stdout as JSON.
+- Treat non-zero exits as failure and read stderr JSON envelope.

package/examples/openapi/sample-openapi-cli/README.md

@@ -0,0 +1,18 @@
+# sample-crm-api CLI
+
+Generated by AgentBridge (api-to-cli).
+
+## Install
+
+```bash
+npm install
+npm link
+```
+
+## Commands
+
+- `sample-crm-api list-contacts` - List contacts
+- `sample-crm-api create-contact` - Create contact
+- `sample-crm-api get-contacts-by-contactid` - Get contact by ID
+- `sample-crm-api patch-contacts-by-contactid` - Update contact fields
+- `sample-crm-api delete-contacts-by-contactid` - Delete contact

package/examples/openapi/sample-openapi-cli/bin/sample-crm-api.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander');
+
+const cmd0 = require('../commands/list-contacts');
+const cmd1 = require('../commands/create-contact');
+const cmd2 = require('../commands/get-contacts-by-contactid');
+const cmd3 = require('../commands/patch-contacts-by-contactid');
+const cmd4 = require('../commands/delete-contacts-by-contactid');
+
+const program = new Command();
+
+program
+  .name('sample-crm-api')
+  .description('sample-crm-api CLI generated by AgentBridge')
+  .version('1.0.0');
+
+program
+  .command('list-contacts')
+  .description('List contacts')
+  .option('--limit <value>', 'Max contacts to return')
+  .option('--pretty', 'Pretty-print JSON')
+  .action((options) => cmd0.run(options));
+
+program
+  .command('create-contact')
+  .description('Create contact')
+  .option('--yes', 'Confirm non-GET operation')
+  .option('--body <json>', 'Raw JSON request body')
+  .option('--body-stdin', 'Read JSON body from stdin')
+  .option('--body-name <value>', 'Contact full name (required)')
+  .option('--body-email <value>', 'Contact email (optional)')
+  .option('--body-subscribed <value>', 'Newsletter subscription status (optional)')
+  .option('--pretty', 'Pretty-print JSON')
+  .action((options) => cmd1.run(options));
+
+program
+  .command('get-contacts-by-contactid')
+  .description('Get contact by ID')
+  .option('--contact-id <value>', 'Contact ID')
+  .option('--pretty', 'Pretty-print JSON')
+  .action((options) => cmd2.run(options));
+
+program
+  .command('patch-contacts-by-contactid')
+  .description('Update contact fields')
+  .option('--contact-id <value>', 'Contact ID')
+  .option('--yes', 'Confirm non-GET operation')
+  .option('--body <json>', 'Raw JSON request body')
+  .option('--body-stdin', 'Read JSON body from stdin')
+  .option('--body-name <value>', 'Updated full name (optional)')
+  .option('--body-email <value>', 'Updated email (optional)')
+  .option('--pretty', 'Pretty-print JSON')
+  .action((options) => cmd3.run(options));
+
+program
+  .command('delete-contacts-by-contactid')
+  .description('Delete contact')
+  .option('--contact-id <value>', 'Contact ID')
+  .option('--yes', 'Confirm non-GET operation')
+  .option('--pretty', 'Pretty-print JSON')
+  .action((options) => cmd4.run(options));
+
+program.parse(process.argv);

package/examples/openapi/sample-openapi-cli/commands/create-contact.js

@@ -0,0 +1,59 @@
+const { request } = require('../lib/client');
+const output = require('../lib/output');
+
+const command = {
+  "name": "create-contact",
+  "description": "Create contact",
+  "method": "POST",
+  "path": "/contacts",
+  "params": {},
+  "requestBody": {
+    "required": true,
+    "properties": {
+      "name": {
+        "type": "string",
+        "required": true,
+        "description": "Contact full name"
+      },
+      "email": {
+        "type": "string",
+        "required": false,
+        "description": "Contact email"
+      },
+      "subscribed": {
+        "type": "boolean",
+        "required": false,
+        "description": "Newsletter subscription status"
+      }
+    }
+  }
+};
+
+async function createContact(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) {
+    output.error(
+      {
+        code: error.statusCode ? 'HTTP_ERROR' : 'REQUEST_FAILED',
+        message: error.message,
+        details: {
+          statusCode: error.statusCode || null,
+          command: command.name
+        }
+      },
+      Boolean(options.pretty)
+    );
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  run: createContact,
+  command
+};

package/examples/openapi/sample-openapi-cli/commands/delete-contacts-by-contactid.js

@@ -0,0 +1,45 @@
+const { request } = require('../lib/client');
+const output = require('../lib/output');
+
+const command = {
+  "name": "delete-contacts-by-contactid",
+  "description": "Delete contact",
+  "method": "DELETE",
+  "path": "/contacts/{contactId}",
+  "params": {
+    "contactId": {
+      "type": "string",
+      "required": true,
+      "description": "Contact ID"
+    }
+  }
+};
+
+async function deleteContactsByContactid(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) {
+    output.error(
+      {
+        code: error.statusCode ? 'HTTP_ERROR' : 'REQUEST_FAILED',
+        message: error.message,
+        details: {
+          statusCode: error.statusCode || null,
+          command: command.name
+        }
+      },
+      Boolean(options.pretty)
+    );
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  run: deleteContactsByContactid,
+  command
+};

package/examples/openapi/sample-openapi-cli/commands/get-contacts-by-contactid.js

@@ -0,0 +1,45 @@
+const { request } = require('../lib/client');
+const output = require('../lib/output');
+
+const command = {
+  "name": "get-contacts-by-contactid",
+  "description": "Get contact by ID",
+  "method": "GET",
+  "path": "/contacts/{contactId}",
+  "params": {
+    "contactId": {
+      "type": "string",
+      "required": true,
+      "description": "Contact ID"
+    }
+  }
+};
+
+async function getContactsByContactid(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) {
+    output.error(
+      {
+        code: error.statusCode ? 'HTTP_ERROR' : 'REQUEST_FAILED',
+        message: error.message,
+        details: {
+          statusCode: error.statusCode || null,
+          command: command.name
+        }
+      },
+      Boolean(options.pretty)
+    );
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  run: getContactsByContactid,
+  command
+};

package/examples/openapi/sample-openapi-cli/commands/list-contacts.js

@@ -0,0 +1,45 @@
+const { request } = require('../lib/client');
+const output = require('../lib/output');
+
+const command = {
+  "name": "list-contacts",
+  "description": "List contacts",
+  "method": "GET",
+  "path": "/contacts",
+  "params": {
+    "limit": {
+      "type": "number",
+      "required": false,
+      "description": "Max contacts to return"
+    }
+  }
+};
+
+async function listContacts(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) {
+    output.error(
+      {
+        code: error.statusCode ? 'HTTP_ERROR' : 'REQUEST_FAILED',
+        message: error.message,
+        details: {
+          statusCode: error.statusCode || null,
+          command: command.name
+        }
+      },
+      Boolean(options.pretty)
+    );
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  run: listContacts,
+  command
+};

package/examples/openapi/sample-openapi-cli/commands/patch-contacts-by-contactid.js

@@ -0,0 +1,60 @@
+const { request } = require('../lib/client');
+const output = require('../lib/output');
+
+const command = {
+  "name": "patch-contacts-by-contactid",
+  "description": "Update contact fields",
+  "method": "PATCH",
+  "path": "/contacts/{contactId}",
+  "params": {
+    "contactId": {
+      "type": "string",
+      "required": true,
+      "description": "Contact ID"
+    }
+  },
+  "requestBody": {
+    "required": true,
+    "properties": {
+      "name": {
+        "type": "string",
+        "required": false,
+        "description": "Updated full name"
+      },
+      "email": {
+        "type": "string",
+        "required": false,
+        "description": "Updated email"
+      }
+    }
+  }
+};
+
+async function patchContactsByContactid(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) {
+    output.error(
+      {
+        code: error.statusCode ? 'HTTP_ERROR' : 'REQUEST_FAILED',
+        message: error.message,
+        details: {
+          statusCode: error.statusCode || null,
+          command: command.name
+        }
+      },
+      Boolean(options.pretty)
+    );
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  run: patchContactsByContactid,
+  command
+};