@mindstudio-ai/remy 0.1.0

package/dist/compiled/sdk-actions.md

@@ -0,0 +1,152 @@
+# MindStudio Agent SDK
+
+`@mindstudio-ai/agent` provides access to 200+ AI models and 1,000+ actions through a single API key. No separate provider keys needed — MindStudio routes to the correct provider (OpenAI, Anthropic, Google, etc.) server-side.
+
+**Full reference:** For complete method signatures, parameters, and output types, read `dist/methods/node_modules/@mindstudio-ai/agent/llms.txt`. This file ships with the package and contains the full API reference for all 170+ actions.
+
+## Usage in Methods
+
+Inside a MindStudio app method, create an instance with no arguments — credentials come from the execution environment:
+
+```typescript
+import { MindStudioAgent } from '@mindstudio-ai/agent';
+
+const agent = new MindStudioAgent();
+```
+
+Every action is a method on the agent instance:
+
+```typescript
+const { content } = await agent.generateText({ message: 'Summarize this...' });
+```
+
+Results are returned flat — output fields at the top level alongside metadata:
+
+```typescript
+const result = await agent.generateText({ message: 'Hello' });
+result.content;              // step-specific output
+result.$billingCost;         // cost in credits (if applicable)
+```
+
+## Available Actions
+
+### AI Generation
+
+| Action | What it does | Key input | Key output |
+|--------|-------------|-----------|------------|
+| `generateText` | Text generation with any LLM | `message`, `modelOverride?` | `content` |
+| `generateImage` | Image from text prompt | `prompt`, `modelOverride?` | `imageUrl` |
+| `generateVideo` | Video from text/image | `prompt`, `imageUrl?` | `videoUrl` |
+| `textToSpeech` | Text to spoken audio | `text`, `modelOverride?` | `audioUrl` |
+| `generateMusic` | Music from text description | `prompt` | `audioUrl` |
+| `generateLipsync` | Animate face to match audio | `imageUrl`, `audioUrl` | `videoUrl` |
+| `generateAsset` | HTML/PDF/PNG/video output | `prompt` | `assetUrl` |
+| `generateChart` | Chart from data | `data`, `chartType` | `imageUrl` |
+
+### AI Analysis
+
+| Action | What it does | Key input | Key output |
+|--------|-------------|-----------|------------|
+| `analyzeImage` | Vision model analysis | `prompt`, `imageUrl` | `analysis` |
+| `analyzeVideo` | Video analysis | `prompt`, `videoUrl` | `analysis` |
+| `transcribeAudio` | Audio to text | `audioUrl` | `transcription` |
+| `extractText` | Extract text from documents/images | `url` | `text` |
+| `detectPII` | Find personal data | `text` | `entities` |
+
+### Web & Search
+
+| Action | What it does | Key input | Key output |
+|--------|-------------|-----------|------------|
+| `scrapeUrl` | Extract page content | `url` | `markdown` |
+| `searchGoogle` | Google search | `query` | `results` |
+| `searchGoogleImages` | Image search | `query` | `results` |
+| `searchGoogleNews` | News search | `query` | `results` |
+| `searchPerplexity` | AI-powered search | `query` | `answer` |
+| `httpRequest` | Custom HTTP call | `url`, `method`, `headers?`, `body?` | `response` |
+
+### Communication
+
+| Action | What it does | Key input | Key output |
+|--------|-------------|-----------|------------|
+| `sendEmail` | Send an email | `to`, `subject`, `body` | `messageId` |
+| `sendSMS` | Send a text message | `to`, `message` | `messageId` |
+| `postToSlackChannel` | Post to Slack | `channel`, `message` | — |
+
+### Media Processing
+
+| Action | What it does |
+|--------|-------------|
+| `removeBackgroundFromImage` | Remove image background |
+| `upscaleImage` | Upscale image resolution |
+| `imageFaceSwap` | Swap faces in an image |
+| `imageRemoveWatermark` | Remove watermarks |
+| `mergeVideos` | Concatenate video clips |
+| `trimMedia` | Trim audio/video |
+| `addSubtitlesToVideo` | Auto-generate subtitles |
+| `extractAudioFromVideo` | Extract audio track |
+| `captureThumbnail` | Get video thumbnail |
+
+### Files & Data
+
+| Action | What it does |
+|--------|-------------|
+| `uploadFile` | Upload a file to CDN |
+| `downloadVideo` | Download a video URL |
+| `getMediaMetadata` | Get dimensions, duration, etc. |
+| `convertPdfToImages` | PDF pages to PNG images |
+
+### Third-Party Integrations (OAuth Connectors)
+
+850+ additional actions from the MindStudio Connector Registry, covering services like HubSpot, Salesforce, Airtable, Google Workspace, Notion, Coda, and many more. These require OAuth connections set up by the user in MindStudio.
+
+Built-in connector methods include: ActiveCampaign, Airtable, Apollo, Coda, Facebook, Gmail, Google Docs/Sheets/Calendar/Drive, HubSpot, Hunter.io, Instagram, LinkedIn, Notion, X (Twitter), YouTube.
+
+For other services, use `runFromConnectorRegistry`:
+
+```typescript
+// Discover available connectors
+const { connectors } = await agent.listConnectors();
+
+// Get action details
+const action = await agent.getConnectorAction('hubspot', 'create-contact');
+
+// Execute
+const result = await agent.runFromConnectorRegistry({
+  serviceId: 'hubspot',
+  actionId: 'create-contact',
+  input: { email: 'user@example.com', firstName: 'Alice' },
+});
+```
+
+### Model Selection
+
+Override the default model for any AI action:
+
+```typescript
+const { content } = await agent.generateText({
+  message: 'Hello',
+  modelOverride: {
+    model: 'claude-sonnet-4-6',
+    temperature: 0.7,
+    maxResponseTokens: 1024,
+  },
+});
+```
+
+Browse available models:
+
+```typescript
+const { models } = await agent.listModelsSummaryByType('llm_chat');
+```
+
+### Batch Execution
+
+Run up to 50 actions in parallel:
+
+```typescript
+const result = await agent.executeStepBatch([
+  { stepType: 'generateImage', step: { prompt: 'a sunset' } },
+  { stepType: 'textToSpeech', step: { text: 'hello world' } },
+]);
+// result.results[0].output, result.results[1].output
+```

package/dist/compiled/tables.md

@@ -0,0 +1,192 @@
+# Tables & Database
+
+## Defining a Table
+
+One file per table in `dist/methods/src/tables/`. Each table is a `defineTable<T>()` call with a typed interface. Table names must match `[a-zA-Z0-9_]` only (no hyphens, spaces, or special characters). Use `snake_case` for table names (e.g., `purchase_orders`, not `purchase-orders`).
+
+```typescript
+import { db } from '@mindstudio-ai/agent';
+
+interface Vendor {
+  name: string;
+  contactEmail: string;
+  status: 'pending' | 'approved' | 'rejected';
+  taxId: string;
+  paymentTerms?: string;
+}
+
+export const Vendors = db.defineTable<Vendor>('vendors');
+```
+
+One export per file. The export name is referenced in `mindstudio.json` and imported in methods. Only define your own columns in the interface — do not add `id`, `created_at`, `updated_at`, or `last_updated_by` (they're provided automatically, see below).
+
+### Column Types
+
+| TypeScript type | SQLite type | Notes |
+|----------------|-------------|-------|
+| `string` | TEXT | Default for most fields |
+| `number` | REAL | Numeric values |
+| `boolean` | INTEGER | Stored as 0/1 |
+| `object` / `array` / JSON types | TEXT | Stored as JSON string, parsed on read |
+| `User` (branded type) | TEXT | User ID with `@@user@@` prefix (transparent — your code works with clean UUIDs) |
+
+### System Columns
+
+Every table automatically has these columns. The SDK adds them to the TypeScript return type automatically — you can access them on any row returned from `get()`, `filter()`, `push()`, etc. without declaring them in your interface. They're also stripped from write inputs, so you never pass them to `push()` or `update()`.
+
+| Column | Type | Behavior |
+|--------|------|----------|
+| `id` | `string` (UUID) | Auto-generated on insert if not provided |
+| `created_at` | `number` (unix ms) | Set on insert, never changes |
+| `updated_at` | `number` (unix ms) | Updated on every write |
+| `last_updated_by` | `string` | Set from the current user's auth context |
+
+These are always available on read results:
+
+```typescript
+const vendor = await Vendors.get('some-id');
+vendor.id;          // string — always present
+vendor.created_at;  // number — unix ms
+vendor.name;        // string — your field
+
+// Sort/filter by system columns works too
+await Vendors.sortBy(v => v.created_at).reverse();
+await Vendors.filter(v => v.id === someId);
+```
+
+## The `db` API
+
+```typescript
+import { db } from '@mindstudio-ai/agent';
+import { Vendors } from './tables/vendors';
+```
+
+### Creating Records
+
+```typescript
+// Single insert — returns the full row with id, created_at, etc.
+const vendor = await Vendors.push({
+  name: 'Acme Corp',
+  contactEmail: 'billing@acme.com',
+  status: 'pending',
+  taxId: '12-3456789',
+});
+
+// Batch insert — returns array
+const vendors = await Vendors.push([
+  { name: 'Acme', status: 'pending', ... },
+  { name: 'Globex', status: 'pending', ... },
+]);
+```
+
+### Reading Records
+
+```typescript
+// By ID
+const vendor = await Vendors.get('uuid-here');  // Vendor | null
+
+// Find one matching a predicate
+const first = await Vendors.findOne(v => v.status === 'approved');
+
+// Filter — returns all matching rows
+const approved = await Vendors.filter(v => v.status === 'approved');
+
+// Chainable queries
+const results = await Vendors
+  .filter(v => v.status === 'approved')
+  .sortBy(v => v.name)
+  .skip(10)
+  .take(5);
+
+// Aggregates
+const count = await Vendors.count();
+const any = await Vendors.some(v => v.status === 'pending');
+const all = await Vendors.every(v => v.status !== 'rejected');
+const empty = await Vendors.isEmpty();
+const cheapest = await Vendors.min(v => v.totalCents);
+const grouped = await Vendors.groupBy(v => v.status);
+```
+
+### Updating Records
+
+```typescript
+// Update by ID — returns the updated row
+const updated = await Vendors.update(vendor.id, {
+  status: 'approved',
+});
+// updated.updated_at is bumped automatically
+```
+
+### Deleting Records
+
+```typescript
+await Vendors.remove(vendor.id);                                    // by ID
+const count = await Vendors.removeAll(v => v.status === 'rejected'); // by predicate
+await Vendors.clear();                                               // delete all
+```
+
+### Filter Predicates
+
+Predicates are arrow functions compiled to SQL WHERE clauses:
+
+```typescript
+Vendors.filter(v => v.status === 'approved')                          // equality
+Vendors.filter(v => v.totalCents > 10000)                             // comparison
+Vendors.filter(v => v.totalCents >= 5000 && v.totalCents <= 50000)    // range
+Vendors.filter(v => v.paymentTerms !== null)                          // null check
+Vendors.filter(v => v.status === 'approved' && v.totalCents > 10000)  // logical AND
+Vendors.filter(v => v.status === 'approved' || v.status === 'pending') // logical OR
+Vendors.filter(v => ['approved', 'pending'].includes(v.status))       // IN
+Vendors.filter(v => v.name.includes('Acme'))                          // LIKE
+Vendors.filter(v => v.address.city === 'New York')                    // nested JSON
+const minAmount = 10000;
+Vendors.filter(v => v.totalCents > minAmount)                         // captured variables
+```
+
+If a predicate can't be compiled to SQL (complex closures, function calls), the SDK falls back to fetching all rows and filtering in JavaScript. A warning is logged.
+
+### Time Helpers
+
+```typescript
+db.now()                          // current timestamp (unix ms)
+db.days(n)                        // n days in ms
+db.hours(n)                       // n hours in ms
+db.minutes(n)                     // n minutes in ms
+db.ago(duration)                  // now - duration
+db.fromNow(duration)              // now + duration
+db.ago(db.days(7) + db.hours(12)) // composable — 7.5 days ago
+
+// Use in queries
+Invoices.filter(i => i.dueDate < db.ago(db.days(30)))
+```
+
+### Batch Queries
+
+Execute multiple queries in a single round-trip:
+
+```typescript
+const [vendors, orders] = await db.batch(
+  Vendors.filter(v => v.status === 'approved'),
+  PurchaseOrders.filter(po => po.vendorId === vendorId),
+);
+```
+
+## Migrations
+
+No migration files. Migrations are automatic:
+- **New tables** — `CREATE TABLE` applied automatically
+- **New columns** — `ALTER TABLE ADD COLUMN` applied automatically
+- **Dropped columns** — `ALTER TABLE DROP COLUMN` applied automatically when a column is removed from the interface
+- **Dropped tables** — `DROP TABLE` applied automatically when a table file is removed from the manifest
+- **Type changes and renames** — not supported in the automatic migration path
+
+On deploy, the platform:
+1. Parses your table definition files (TypeScript AST — the interface IS the schema)
+2. Diffs against the current live database schema
+3. Generates DDL (`CREATE TABLE`, `ALTER TABLE ADD COLUMN`, `ALTER TABLE DROP COLUMN`, `DROP TABLE`)
+4. Applies to a staging copy of the database
+5. Promotes the staging copy to live
+
+The TypeScript interface is the single source of truth for the schema. Add a field to the interface, push, and the column exists. No migration files, no CLI commands.
+
+**In development**, schema changes are synced automatically to the dev database. The dev database is a disposable snapshot — it can be reset to a fresh copy of production data or truncated to empty tables at any time. There's no risk of breaking anything by experimenting with schema changes in dev.

package/dist/headless.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Headless mode — stdin/stdout JSON protocol for programmatic control.
+ *
+ * Designed for parent processes like the mindstudio-sandbox C&C server.
+ * Input: newline-delimited JSON on stdin  (e.g. {"action":"message","text":"..."})
+ * Output: newline-delimited JSON on stdout (e.g. {"event":"text","text":"..."})
+ */
+interface HeadlessOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+    lspUrl?: string;
+}
+declare function startHeadless(opts?: HeadlessOptions): Promise<void>;
+
+export { type HeadlessOptions, startHeadless };