open-index/open-npm huggingface dataset:
npm package: @objectql/plugin-ai-agent
Description: AI Agent plugin for ObjectQL - AI-powered application generation and validation
Latest version: 4.0.5

# @objectql/plugin-ai-agent

AI Agent plugin for ObjectQL - AI-powered application generation and validation using OpenAI.

## Features

- **Application Generation**: Generate complete ObjectQL applications from natural language descriptions
- **Metadata Validation**: AI-powered validation of ObjectQL metadata files
- **Conversational Generation**: Iterative application refinement through dialogue
- **Metadata Refinement**: Improve existing metadata based on feedback

## Installation

```bash
npm install @objectql/plugin-ai-agent
```

## Usage

```typescript
import { ObjectQLAgent, createAgent } from '@objectql/plugin-ai-agent';

// Create an agent instance
const agent = createAgent(process.env.OPENAI_API_KEY);

// Generate an application
const result = await agent.generateApp({
  description: 'A CRM system with contacts, companies, and opportunities',
  type: 'complete'
});

// Validate metadata
const validation = await agent.validateMetadata({
  metadata: myMetadataContent,
  filename: 'contact.object.yml',
  checkBusinessLogic: true
});
```

## API

### `ObjectQLAgent`

Main class for AI-powered application generation and validation.

#### Methods

- `generateApp(options)`: Generate application metadata from natural language
- `validateMetadata(options)`: Validate metadata using AI
- `refineMetadata(metadata, feedback)`: Refine metadata based on feedback
- `generateConversational(options)`: Conversational generation with step-by-step refinement

### `createAgent(apiKey, options?)`

Convenience function to create an `ObjectQLAgent` instance.

## License

MIT
npm package: @objectql/runtime
Description: ObjectQL Runtime - Core Runtime Types
Latest version: 0.4.1

# @objectql/runtime

ObjectStack Runtime - Core Runtime Types

This package contains the runtime type definitions for the ObjectStack ecosystem.

## Purpose

This stub package is part of the ObjectQL v4.0 migration to the @objectstack ecosystem. It provides:
- RuntimePlugin interface
- RuntimeContext interface
- ObjectStackKernel interface

## Migration Notes

This is a workspace stub package created during the ObjectQL type system cleanup phase. The real `@objectql/runtime` package will be published separately to npm.
npm package: @objectql/starter-basic
Description: Basic starter template for ObjectQL - Simple project structure with essential metadata files
Author: ObjectQL Contributors
Latest version: 1.8.4

# Basic Script Example

This is a minimal example demonstrating how to use ObjectQL as a library in a simple Node.js/TypeScript script.

It demonstrates:
1. How to initialize ObjectQL (`new ObjectQL(...)`)
2. How to connect to a SQLite database
3. How to define objects (`projects.object.yml`)
4. How to perform CRUD operations in a script

## Run

```bash
pnpm install
pnpm run build
node dist/index.js
```
npm package: @objectql/starter-express-api
Description: Express API starter template for ObjectQL - REST and GraphQL server implementation example
Author: ObjectQL Contributors
Latest version: 1.8.4

# Express API Example

This example demonstrates how to integrate ObjectQL with an Express.js server to expose a REST API.

It demonstrates:
1. Using `createNodeHandler` to mount ObjectQL as Express middleware
2. Starting an HTTP server to handle ObjectQL requests
3. Accessing data via the HTTP interface

## Run

```bash
pnpm install
pnpm start
```

Access API:
`POST http://localhost:3004/api/objectql`
npm package: @objectql/studio
Description: Web-based admin studio for ObjectQL - Visual database management, schema editor, and data browser
Latest version: 1.8.3

# @objectql/studio

Web-based admin studio for ObjectQL database management.

## Features

- **Object Browser**: View all registered objects/tables in your database
- **Data Grid**: Browse and search records with pagination
- **CRUD Operations**: Create, read, update, and delete records
- **Schema Inspector**: View object definitions and field metadata
- **Modern UI**: Clean, responsive design with intuitive navigation

## Usage

The console is typically served alongside your ObjectQL server:

```typescript
import express from 'express';
import { ObjectQL } from '@objectql/core';
import { createNodeHandler, createStudioHandler } from '@objectql/server';

const app = new ObjectQL({ /* ... */ });
const server = express();

// ... setup objectql ...

// Serve the Studio
server.get('/studio*', createStudioHandler());
```

// API endpoints
server.all('/api/objectql', createNodeHandler(app));

// Serve console UI
server.use('/console', serveConsole());

server.listen(3004);
```

Then visit `http://localhost:3004/console` in your browser.

## Development

```bash
pnpm install
pnpm run dev
```