open-index/open-npm huggingface dataset:
npm package: @mimicai/adapter-mongodb
Description: MongoDB database adapter for Mimic — insertMany batching, schema inference, auto-indexing
Author: Mimic AI Lab
Latest version: 0.11.1

# @mimicai/adapter-mongodb

MongoDB database adapter for [Mimic](https://github.com/mimicailab/mimic) — seeds collections with embedded documents and persona-consistent data.

## Install

```bash
npm install @mimicai/adapter-mongodb
```

## Usage

```json
{
  "databases": [
    {
      "adapter": "mongodb",
      "connectionString": "mongodb://localhost:27017/testdb"
    }
  ]
}
```

## License

[Apache 2.0](../../../LICENSE-APACHE-2.0)
npm package: @mimicai/adapter-mysql
Description: MySQL database adapter for Mimic — batch INSERT, upsert, INFORMATION_SCHEMA introspection
Author: Mimic AI Lab
Latest version: 0.11.1

# @mimicai/adapter-mysql

MySQL database adapter for [Mimic](https://github.com/mimicailab/mimic) — seeds tables with persona-consistent data and relational integrity.

## Install

```bash
npm install @mimicai/adapter-mysql
```

## Usage

```json
{
  "databases": [
    {
      "adapter": "mysql",
      "connectionString": "mysql://root:password@localhost:3306/testdb"
    }
  ]
}
```

## License

[Apache 2.0](../../../LICENSE-APACHE-2.0)
npm package: @mimicai/adapter-postgres
Description: PostgreSQL database adapter for Mimic — batch INSERT, COPY protocol, upsert support
Author: Mimic AI Lab
Latest version: 0.11.1

# @mimicai/adapter-postgres

PostgreSQL database adapter for [Mimic](https://github.com/mimicailab/mimic) — seeds tables with persona-consistent data using FK-aware ordering, batch INSERT, and COPY.

## Install

```bash
npm install @mimicai/adapter-postgres
```

## Features

- FK-aware table ordering for referential integrity
- Batch INSERT for small datasets (<500 rows)
- COPY FROM STDIN for high-volume seeding (>=500 rows)
- Automatic sequence synchronization after seeding
- Atomic transactions — all-or-nothing seeding

## Usage

Used automatically by `mimic seed` when configured in `mimic.json`:

```json
{
  "databases": [
    {
      "adapter": "postgres",
      "connectionString": "postgresql://localhost:5432/testdb"
    }
  ]
}
```

## License

[Apache 2.0](../../../LICENSE-APACHE-2.0)
npm package: @mimicai/adapter-sdk
Description: SDK for building Mimic API mock adapters — base class, test helpers, and shared utilities
Author: Mimic AI Lab
Latest version: 0.11.1

# @mimicai/adapter-sdk

SDK for building custom [Mimic](https://github.com/mimicailab/mimic) API mock adapters — base class, test helpers, and shared utilities.

## Install

```bash
npm install @mimicai/adapter-sdk
```

## Usage

Create a new adapter by extending `BaseApiMockAdapter`:

```typescript
import { BaseApiMockAdapter } from '@mimicai/adapter-sdk';

export class MyServiceAdapter extends BaseApiMockAdapter {
  name = 'my-service';

  buildRoutes() {
    return [
      {
        method: 'GET',
        path: '/api/items',
        handler: (req) => this.handleListItems(req),
      },
    ];
  }
}
```

## Test helpers

The SDK includes test utilities for verifying your adapter:

```typescript
import { createTestAdapter } from '@mimicai/adapter-sdk';

const adapter = createTestAdapter(MyServiceAdapter);
const response = await adapter.request('GET', '/api/items');
```

## See also

- [Adapter Development Guide](../../docs/ADAPTER_GUIDE.md)
- [Existing adapters](../adapters/) for reference implementations

## License

[Apache 2.0](../../LICENSE-APACHE-2.0)
npm package: @mimicai/adapter-slack
Description: Slack API mock adapter for Mimic — channels, messages, reactions, file uploads
Author: Mimic AI Lab
Latest version: 0.7.0

# @mimicai/adapter-slack

Slack API mock adapter for [Mimic](https://github.com/mimicailab/mimic) — mock Slack Web API endpoints with persona-consistent workspace data + built-in MCP server.

## Install

```bash
npm install @mimicai/adapter-slack
```

## Mocked endpoints

Channels, messages, users, reactions, files, threads, conversations, and team info.

## Usage

Add to your `mimic.json`:

```json
{
  "apis": [{ "adapter": "slack" }]
}
```

Then run `mimic host` — Slack API will be available at `http://localhost:4000/slack`.

### MCP server

```json
{
  "mcpServers": {
    "mimic-slack": {
      "command": "npx",
      "args": ["-y", "@mimicai/adapter-slack", "mcp"]
    }
  }
}
```

## License

[Apache 2.0](../../../LICENSE-APACHE-2.0)
npm package: @mimicai/adapter-sqlite
Description: SQLite database adapter for Mimic — prepared statements, WAL mode, PRAGMA introspection
Author: Mimic AI Lab
Latest version: 0.11.1

# @mimicai/adapter-sqlite

SQLite database adapter for [Mimic](https://github.com/mimicailab/mimic) — seeds tables with persona-consistent data using better-sqlite3.

## Install

```bash
npm install @mimicai/adapter-sqlite
```

## Usage

```json
{
  "databases": [
    {
      "adapter": "sqlite",
      "connectionString": "./data/test.db"
    }
  ]
}
```

## License

[Apache 2.0](../../../LICENSE-APACHE-2.0)
npm package: @mimicai/adapter-stripe
Description: Stripe API mock adapter for Mimic — payments, billing, subscriptions, invoices
Author: Mimic AI Lab
Latest version: 0.11.1

# @mimicai/adapter-stripe

Stripe API mock adapter for [Mimic](https://github.com/mimicailab/mimic) — mock Stripe endpoints with persona-consistent payment data + built-in MCP server.

## Install

```bash
npm install @mimicai/adapter-stripe
```

## Mocked endpoints

Customers, payment intents, charges, subscriptions, invoices, products, prices, payment methods, refunds, balance, and webhooks.

## Usage

Add to your `mimic.json`:

```json
{
  "apis": [{ "adapter": "stripe" }]
}
```

Then run `mimic host` — Stripe API will be available at `http://localhost:4000/stripe/v1`.

### MCP server

```json
{
  "mcpServers": {
    "mimic-stripe": {
      "command": "npx",
      "args": ["-y", "@mimicai/adapter-stripe", "mcp"]
    }
  }
}
```

## License

[Apache 2.0](../../../LICENSE-APACHE-2.0)
npm package: @mimicai/blueprints
Description: Pre-built persona blueprints for Mimic — finance, calendar, and support domains
Author: Mimic AI Lab
Latest version: 0.11.1

# @mimicai/blueprints

Pre-built persona blueprints for [Mimic](https://github.com/mimicailab/mimic) — ready-to-use synthetic data profiles for AI agent testing.

## Install

```bash
npm install @mimicai/blueprints
```

## Available blueprints

| Blueprint | Description |
|-----------|-------------|
| `young-professional` | 28yo software engineer, moderate income, active banking |
| `freelancer` | Self-employed designer, variable income, multiple clients |
| `college-student` | 21yo student, limited finances, part-time work |

## Usage

```typescript
import { blueprints } from '@mimicai/blueprints';

const persona = blueprints['young-professional'];
```

Or use via the CLI — blueprints are referenced by name in `mimic.json`:

```json
{
  "personas": [{ "name": "alex", "blueprint": "young-professional" }]
}
```

## License

[Apache 2.0](../../LICENSE-APACHE-2.0)
npm package: @mimicai/cli
Description: CLI for Mimic — generate, seed, serve, and test synthetic data for AI agents
Author: Mimic AI Lab
Latest version: 0.11.1

# @mimicai/cli

CLI for [Mimic](https://github.com/mimicailab/mimic) — generate, seed, serve, and test synthetic data for AI agents.

## Install

```bash
npm install -g @mimicai/cli
```

## Commands

```
mimic init          Create a new mimic.json project config
mimic run           Generate blueprints and expand persona data
mimic seed          Seed databases from persona blueprint
mimic host          Start mock API + MCP servers
mimic test          Run test scenarios against your agent
mimic inspect       View schema, data, or blueprint information
mimic clean         Remove all seeded data
mimic adapters      Manage API mock adapters (add, remove, list)
```

## Quick start

```bash
mimic init
mimic run
mimic seed
mimic host
```

## Configuration

The CLI reads `mimic.json` from the current working directory. Run `mimic init` to generate one interactively.

```json
{
  "domain": "fintech agent testing",
  "personas": [{ "name": "finance-alex", "blueprint": "young-professional" }],
  "databases": [{ "adapter": "postgres", "connectionString": "postgresql://localhost:5432/testdb" }],
  "apis": [{ "adapter": "stripe" }, { "adapter": "plaid" }]
}
```

## Requirements

- Node.js >= 22

## License

[Apache 2.0](../../LICENSE-APACHE-2.0)
npm package: @mimicai/core
Description: Core engine for Mimic — persona-driven synthetic data generation, schema parsing, database seeding, and MCP server
Author: Mimic AI Lab
Latest version: 0.11.1

# @mimicai/core

Core engine for [Mimic](https://github.com/mimicailab/mimic) — persona-driven synthetic data generation, schema parsing, database seeding, MCP server, and test runner.

## Install

```bash
npm install @mimicai/core
```

## What's inside

- **Schema parsing** — Prisma files, raw SQL DDL, or live PostgreSQL introspection
- **Blueprint generation** — LLM-powered persona data via Vercel AI SDK, or pre-built JSON blueprints
- **Database seeding** — Batch INSERT or COPY for high-volume seeding with FK-aware ordering
- **MCP server** — Auto-generates tools from your schema for Model Context Protocol agents
- **Test runner** — Keyword matching + LLM-as-judge evaluation for agent testing
- **Adapter system** — Pluggable adapter registry for databases, API mocks, file storage, and events

## Usage

```typescript
import { loadConfig, parseSchema, generateBlueprint, seedDatabase } from '@mimicai/core';

const config = await loadConfig('mimic.json');
const schema = await parseSchema(config);
const blueprint = await generateBlueprint(schema, config);
await seedDatabase(blueprint, config);
```

## Requirements

- Node.js >= 22

## License

[Apache 2.0](../../LICENSE-APACHE-2.0)