@agentmc/api 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentMC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,197 @@
+# @agentmc/api
+
+TypeScript SDK + endpoint docs + CLI for the AgentMC API.
+
+- API domain: [https://agentmc.ai](https://agentmc.ai)
+- OpenAPI source: `https://agentmc.ai/api/openapi.json`
+- Default SDK base URL: `https://agentmc.ai/api/v1`
+
+## Install
+
+```bash
+npm install @agentmc/api
+```
+
+## What This Package Includes
+
+- Fully generated, typed SDK surface from OpenAPI.
+- Generated operation docs for every included endpoint:
+  - `docs/operations/*.md`
+  - `docs/operations/index.json`
+- Per-endpoint runnable TypeScript examples:
+  - `examples/http/*.ts`
+- CLI for operation discovery and direct API calls.
+
+## Included Endpoint Scope
+
+This package includes the documented AgentMC HTTP integration endpoints for Node clients.
+
+## Quick Start (SDK)
+
+```ts
+import { AgentMCApi } from "@agentmc/api";
+
+const client = new AgentMCApi({
+  apiKey: process.env.AGENTMC_API_KEY
+});
+
+const result = await client.operations.listTasks({
+  params: {
+    query: {
+      per_page: 20
+    }
+  }
+});
+
+if (result.error) {
+  console.error(result.status, result.error);
+} else {
+  console.log(result.data);
+}
+```
+
+## Auth Configuration
+
+Supported auth schemes:
+
+- `ApiKeyAuth` via `X-Api-Key`
+- `AgentBearerAuth` via `Authorization: Bearer <agent-token>`
+- `BearerAuth` via `Authorization: Bearer <user-token>`
+- `ConnectTokenAuth` via `X-Connect-Token` (for `/agents/connect`)
+
+Configure once at client creation:
+
+```ts
+const client = new AgentMCApi({
+  apiKey: process.env.AGENTMC_API_KEY,
+  agentToken: process.env.AGENTMC_AGENT_TOKEN,
+  bearerToken: process.env.AGENTMC_BEARER_TOKEN,
+  connectToken: process.env.AGENTMC_CONNECT_TOKEN
+});
+```
+
+Override auth per request:
+
+```ts
+await client.request("connectAgent", {
+  auth: {
+    connectToken: process.env.AGENTMC_CONNECT_TOKEN
+  },
+  body: {
+    runtime: {
+      name: "example-runtime"
+    }
+  }
+});
+```
+
+## API Discovery Helpers
+
+```ts
+import { operations, operationsById } from "@agentmc/api";
+
+console.log(operations.length); // 44
+console.log(operationsById.listTasks.path); // /tasks
+```
+
+Runtime helpers on client:
+
+```ts
+const allOperations = client.listOperations();
+const oneOperation = client.getOperation("listTasks");
+```
+
+## CLI
+
+After install, use:
+
+```bash
+npx agentmc-api list-operations
+```
+
+List as JSON:
+
+```bash
+npx agentmc-api list-operations --json
+```
+
+Show operation metadata:
+
+```bash
+npx agentmc-api show-operation listTasks
+```
+
+Show generated markdown docs:
+
+```bash
+npx agentmc-api show-doc listTasks
+```
+
+Call endpoint directly:
+
+```bash
+npx agentmc-api call listTasks \
+  --api-key "$AGENTMC_API_KEY" \
+  --params '{"query":{"limit":20}}'
+```
+
+## Development
+
+### 1) Install
+
+```bash
+npm install
+```
+
+### 2) Sync source OpenAPI
+
+```bash
+npm run sync:spec
+```
+
+Optional environment variables:
+
+- `AGENTMC_OPENAPI_PATH` (local file path override)
+- `AGENTMC_OPENAPI_URL` (remote URL override)
+
+### 3) Generate typed client artifacts/docs/examples
+
+```bash
+npm run generate
+```
+
+Outputs:
+
+- `spec/openapi.filtered.json`
+- `src/generated/schema.ts`
+- `src/generated/operations.ts`
+- `docs/operations/*.md`
+- `docs/operations/index.json`
+- `examples/http/*.ts`
+
+### 4) Build package
+
+```bash
+npm run build
+```
+
+## Release Flow (Auto-Publish)
+
+This repo uses Changesets + GitHub Actions:
+
+- CI workflow validates build and generated artifacts.
+- Release workflow on `main` automatically:
+  - opens/updates a release PR from pending changesets
+  - publishes to npm when the release PR is merged
+
+Required secrets:
+
+- `NPM_TOKEN`
+
+## Notes For Agent Authors
+
+- Use `client.operations.<operationId>` for named operation calls.
+- Use `client.request(operationId, options)` for dynamic routing.
+- Read per-endpoint docs from `docs/operations/<operationId>.md` when selecting params/body fields.
+- Treat the generated docs/index as the operation registry:
+  - `docs/operations/index.json`

package/bin/agentmc-api.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import("../dist/cli.js")
+  .then((mod) => mod.runCli())
+  .catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+  });

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+declare function runCli(argv?: string[]): Promise<void>;
+
+export { runCli };