@haustle/notion-orm 0.0.44 → 0.0.45

package/README.md

@@ -1,132 +1,472 @@
 # Notion ORM
 
-<aside>
-👉 This package is currently still in development.
+A lightweight TypeScript [Notion API](https://developers.notion.com/) wrapper that aims to improve interactions with databases and custom agents, by leveraging static schema types
 
-</aside>
+## Key Features
 
-# Description
+- Type inference when interacting with databases (e.g, `add` and `query`)
+- Sync remote schema changes in single command
+- Quickly start/resume chat streams with your agents
+- Access exported property values, schemas, and types
+- Logs console warnings when local vs remote schema drift is detected
 
-A library to simplify interacting with [Notion](https://notion.so/product) databases/tables via Notion API
+## Installation
 
-## Disclaimer
-### Available Database Features
-- Adding
-- Querying
+```bash
+npm install @haustle/notion-orm
+# or: pnpm add / yarn add / bun add @haustle/notion-orm
+```
+
+The CLI is installed as the `**notion**` binary and runs on **Node.js 18+** (the published shebang is `node`). After upgrading the package, run `**npx notion sync`** (or `**pnpm exec notion sync**`, `**yarn notion sync**`, `**bunx notion sync**`) so generated files under `**notion/**` stay in sync with the version you installed (stale codegen can break at runtime when imports from the ORM package change). In app code, prefer `**import { NotionORM } from "./notion/"**` — the directory import resolves to `index.ts`, so you do not need to spell `**index**`.
+
+**Config file:** use `**notion.config.js`** or `**notion.config.mjs**` if you run the CLI with plain Node. `**notion.config.ts**` is supported when your runtime can load TypeScript (for example Bun or a project using a TS loader); otherwise compile the config or use JavaScript.
 
-### Supported Column Types
-- Multiselect
-- Select
-- Status
-- Date
-- Text
-- Url
-- Checkbox
-- Email 
-- Phone Number
+Generated database and agent modules live in your app's local `**./notion/**` folder after `notion sync`; import those relative files directly if you need a generated factory outside the `NotionORM` wrapper.
 
-# Install and Setup
+# Quick start
+
+Initialize config from your project root (recommended):
 
 ```bash
-npm install @haustle/notion-orm
+npx notion init
+```
+
+Generated config shape:
+
+```ts
+// notion.config.ts
+
+// If you don't have an API key, sign up for free
+// [here](https://developers.notion.com)
+
+const auth = process.env.NOTION_KEY || "your-notion-api-key-here";
+const NotionConfig = {
+  auth,
+  databases: [
+    // Use: notion add <database-id>
+  ],
+  agents: [
+    // Auto-populated by: notion sync
+  ],
+};
+
+export default NotionConfig;
+```
+
+### Adding databases
+
+Add new database to track and generate static types (ex. how to find ID [here](https://developers.notion.com/guides/data-apis/working-with-databases#adding-pages-to-a-database) )
+
+```bash
+npx notion add <database-id>
 ```
 
-The only requirement is a Notion Developer API Key ([here](https://developers.notion.com/)) and database IDs you want
-
-1. At the root of your project create pass your developer key and database IDs ([help](https://en.wikipedia.org/wiki/Object%E2%80%93relational_mapping)). 
-    ```
-    Copy database/table URL
-    https://www.notion.so/haustle/<This-is-the-database-id>?v=123
-    ```
-    ```jsx
-    // notion.config.js
-    
-    const NotionConfig = {
-    	auth: process.env.NOTION_KEY,
-    	databaseIds: [
-    	    "a52239e4839d4a3a8f4875376cfbfb02", 
-    	    "5f4bf76a1e3f48d684d2506ea2690d64"
-    	],
-    };
-    
-    module.exports = NotionConfig;
-    ```
-    - Be sure to connect your integration with your tables
-    
-2. Generate Types
-    
-    ```bash
-    npx notion generate
-    ```
-    
-3. Import databases in your TypeScript file
-    
-    ```tsx
-    // Barrel import, giving you access to all your databases
-    import * as notion from "@haustle/notion-orm"
-    
-    // Import specific database
-    import { databaseName } from "@haustle/notion-orm"
-    ```
-    
-
-# Actions
-
-## Add a page
-
-Page title is required when adding
-
-```tsx
-notion.books.add({
-    name: "Catcher in the Rye",
-    rating: "⭐️⭐️⭐️⭐️⭐️"
-})
-```
-
-## Query Database
-
-### Single Filter
-
-```tsx
-notion.books.query({
-    filter: {
-        genre: {
-            contains: "Sci-Fi"
-        }
-    }
-})
-```
-
-### Nested Filters
-
-```tsx
-await notion.books.query({
-    filter: {
+### Adding agents (paid feature)
+
+Agent support requires the [Notion Agents SDK](https://github.com/makenotion/notion-agents-sdk-js), which is **currently in alpha** and not published to npm. Because of this, a one-command setup handles the entire download-and-install flow for you:
+
+```bash
+npx notion setup-agents-sdk
+```
+
+**What this does:**
+
+1. Clones the SDK repository into a local cache (`node_modules/.cache/.notion-agents-sdk`)
+2. Installs the SDK's dependencies and builds it
+3. Adds the built `@notionhq/agents-client` package to your project
+
+After setup, run `notion sync` to generate agent types. Agents linked to your integration are automatically discovered.
+
+**Updating:** When the upstream SDK receives changes, rerun the same command. It pulls the latest from the cached clone, rebuilds, and reinstalls:
+
+```bash
+npx notion setup-agents-sdk
+npx notion sync
+```
+
+If you have not run the setup command, `notion sync` will skip agent generation and only produce database types. Once the SDK is published to npm, this step will no longer be necessary.
+
+Learn more about [Custom Agents](https://www.notion.com/help/custom-agents) in the Notion documentation.
+
+### Full sync command (`notion sync`)
+
+Fetch/refresh database schemas. If the agents SDK is installed, also syncs custom agents.
+
+```bash
+npx notion sync
+```
+
+## Basic examples
+
+### Create page in a database
+
+```ts
+await notion.databases.books.create({
+  icon: {
+    type: "emoji",
+    emoji: "📕",
+  },
+  // Expected <key,value> is constrained to `books` database schema
+  properties: {
+    bookName: "Creativity, Inc.",
+    genre: ["Non-fiction"],
+    publishDate: {
+      start: "2026-03-01",
+    },
+  },
+});
+
+```
+
+### Query/filter database
+
+```ts
+const books = await notion.databases.books.findMany({
+  where: {
+    and: [
+      { genre: { contains: "Non-fiction" } },
+      { publishDate: { on_or_after: "2026-01-01" } },
+      {
         or: [
-            {
-                genre: {
-                    contains: "Sci-Fi",
-                },
-            },
-            {
-                genre: {
-                    contains: "Biography",
-                },
-            },
+          { bookName: { contains: "Creativity" } },
+          { bookName: { contains: "Innovation" } },
         ],
+      },
+    ],
+  },
+  sortBy: [{ property: "bookName", direction: "ascending" }],
+  select: ["bookName", "genre"],
+});
+
+```
+
+### Chat with agent
+
+```ts
+const chat = await notion.agents.helpBot.chat({message: "Is the company closed today"})
+await notion.agents.helpBot.pollThread(chat.threadId)
+const messages = await notion.agents.helpBot.getMessages(chat.threadId, {
+  role: "agent",
+});
+```
+
+### Chat with agent (stream)
+
+```ts
+const thread = await notion.agents.helpBot.chatStream({
+  message: "How can I update my shipping address?",
+  onMessage: ({content, role}) => (msg.content),
+});
+
+```
+
+# Implementation
+
+### Client setup
+
+Create a single ORM instance with your Notion integration key. Import from the generated `**notion/**` folder (directory specifier → `index`):
+
+```ts
+import { NotionORM } from "./notion/";
+
+const notion = new NotionORM({
+  auth: process.env.NOTION_KEY!,
+});
+
+const db = notion.databases.yourDatabaseName; // DatabaseClient
+const agent = notion.agents.yourAgentName; // AgentClient
+```
+
+Generated database and agent names are camelCased and exposed on an instance of `NotionORM`.
+
+- Use `notion.databases.<camelCaseDatabaseName>` for typed CRUD + query operations (`findMany`, `findFirst`, `findUnique`, `create`, `update`, `delete`, and more).
+- Use `notion.agents.<camelCaseAgentName>` for `chat()`, `chatStream()`, thread helpers, and history APIs.
+- For full method signatures and response shapes, see [API Reference](#api-reference).
+
+# Available database operations
+
+## Adding
+
+Only title is required by Notion for a minimal page.
+
+```ts
+await notion.databases.books.create({
+  properties: {
+    bookName: "Raphael, Painter in Rome: a Novel", // title
+    author: "Stephanie Storey", // rich_text
+    status: "In progress", // status
+    numberOfPages: 307, // number
+    genre: ["Historical Fiction"], // multi_select
+    startDate: {
+      start: "2023-01-01",
+    }, // date
+    phone: "0000000000", // phone_number
+    email: "tyrus@haustle.studio", // email
+  },
+});
+```
+
+## Adding page content with markdown
+
+Pass a `markdown` string alongside `properties` to create a page with body content in a single call. This uses Notion's [enhanced markdown format](https://developers.notion.com/guides/data-apis/working-with-markdown-content#block-type-support), which supports headings, lists, code blocks, quotes, checklists, and more.
+
+```ts
+await notion.databases.books.create({
+  properties: {
+    bookName: "Hello World",
+  },
+  markdown: "# Hello World\n\nThis is a page created with **markdown**.",
+});
+```
+
+`markdown` is mutually exclusive with `children` / `content` — use one or the other. When `properties.title` is provided, the `# h1` heading is treated as body content; when omitted, Notion extracts it as the page title.
+
+## Querying
+
+Query filters are typed by your generated schema, including nested compound filters. Find Notion filter operators [here](https://developers.notion.com/reference/post-database-query-filter).
+
+Example single filter:
+
+```ts
+await notion.databases.books.findMany({
+  where: {
+    genre: {
+      contains: "Sci-Fi",
+    },
+  },
+  sortBy: [
+    {
+      property: "bookName",
+      direction: "ascending",
     },
+  ],
+});
+```
+
+Example compound filters:
+
+```ts
+await notion.databases.books.findMany({
+  where: {
+    and: [
+      {
+        or: [
+          { genre: { contains: "Sci-Fi" } },
+          { genre: { contains: "Biography" } },
+        ],
+      },
+      { numberOfPages: { greater_than: 250 } },
+    ],
+  },
+});
+```
+
+Projection is available via `select` and `omit` string arrays:
+
+```ts
+const response = await notion.databases.books.findMany({
+  where: {
+    genre: { contains: "Sci-Fi" },
+  },
+  select: ["bookName", "genre"],
 });
 ```
 
-## What is Object Relational Map (ORM)
+Successful response shape:
+
+```ts
+[
+  {
+    bookName: "The Dream Machine",
+    genre: ["Non-fiction"],
+  },
+]
+```
+
+### Agents
 
-> …[programming](https://en.wikipedia.org/wiki/Computer_programming) technique for converting data between [type systems](https://en.wikipedia.org/wiki/Type_system) using [object-oriented](https://en.wikipedia.org/wiki/Object-oriented)  programming languages. This creates, in effect, a "virtual [object database](https://en.wikipedia.org/wiki/Object_database)" that can be used from within the programming language.
-> 
+Agents are generated from those shared with your integration and exposed at `notion.agents.*`.
 
-[Wikipedia](https://en.wikipedia.org/wiki/Object%E2%80%93relational_mapping)
+#### Basic chat (non-streaming)
 
-# Story
+- Useful when you want a straightforward request/response flow.
+- Helpful when you plan to fetch message history after completion.
 
-While taking a databases class I got exposed to Prisma and thought the developer experience was magical. Around the same time the Notion Developer API was rolling out and I thought the idea of bringing creating a ORM to Notion databases would be a fun cool idea, but I was terrible at TypeScript.
+```ts
+const chat = await notion.agents.yourAgentName.chat({
+  message: "Give me a summary of this month",
+});
+
+await notion.agents.yourAgentName.pollThread(chat.threadId);
+
+const messages = await notion.agents.yourAgentName.getMessages(chat.threadId, {
+  role: "agent",
+});
+```
+
+#### Continue an existing thread
+
+- Useful when you want to preserve context across follow-up prompts.
+- Helpful for chat UIs where users continue the same conversation.
+
+```ts
+const nextTurn = await notion.agents.yourAgentName.chat({
+  threadId: chat.threadId,
+  message: "Now turn that into a grocery list.",
+});
+```
+
+#### Streaming patterns
+
+How to start a new chat stream (pass `threadId` to resume):
+
+```ts
+import { AgentClient } from "@haustle/notion-orm";
+
+const thread = await notion.agents.yourAgentName.chatStream({
+  message: "Generate a prep list for that plan.",
+
+  onMessage: (msg) => {
+    if (msg.role === "agent") process.stdout.write(msg.content);
+  },
+});
+
+
+const finalResponse = AgentClient.getAgentResponse(thread);
+console.log("Thread ID:", thread.threadId);
+console.log("Final:", finalResponse);
+```
+
+See [API Reference](#api-reference) for full method signatures, `ThreadInfo` shape, and message schemas.
+
+# API Reference
+
+## Runtime access (detailed)
+
+
+| runtime property   | type                             | description                                                    | go deeper                                          |
+| ------------------ | -------------------------------- | -------------------------------------------------------------- | -------------------------------------------------- |
+| `notion.databases` | `Record<string, DatabaseClient>` | Generated database client map keyed by camelCase database name | [Adding](#adding), [Querying](#querying)           |
+| `notion.agents`    | `Record<string, AgentClient>`    | Generated agent client map keyed by camelCase agent name       | [Agents](#agents), [Agent methods](#agent-methods) |
+
+
+## Database client methods
+
+
+| member                                                                  | kind     | description                                                                                                                                           | go deeper                                                                              |
+| ----------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| `id`                                                                    | property | Notion data source ID used by this client instance                                                                                                    | -                                                                                      |
+| `name`                                                                  | property | Human-readable database name captured during generation                                                                                               | -                                                                                      |
+| `findMany({ where?, sortBy?, size?, select?, omit?, stream?, after? })` | method   | Queries database pages with typed filters, projection, pagination, or streaming                                                                       | [Querying](#querying), [Supported database properties](#supported-database-properties) |
+| `findFirst({ where?, sortBy?, select?, omit? })`                        | method   | Returns the first matching row or `null`                                                                                                              | [Querying](#querying)                                                                  |
+| `findUnique({ where: { id }, select?, omit? })`                         | method   | Fetches a row by page ID with optional projection                                                                                                     | [Querying](#querying)                                                                  |
+| `create({ properties, icon?, cover?, markdown? })`                      | method   | Creates a page with optional [markdown body content](https://developers.notion.com/guides/data-apis/working-with-markdown-content#block-type-support) | [Adding](#adding), [Markdown](#adding-page-content-with-markdown)                      |
+
+
+## Agent methods
+
+
+| member                                           | kind     | description                                                     | go deeper                                                            |
+| ------------------------------------------------ | -------- | --------------------------------------------------------------- | -------------------------------------------------------------------- |
+| `id`                                             | property | Notion agent ID used by this client instance                    | -                                                                    |
+| `name`                                           | property | Human-readable agent name                                       | -                                                                    |
+| `icon`                                           | property | Normalized agent icon metadata (or `null`)                      | -                                                                    |
+| `listThreads()`                                  | method   | Lists recent threads with `id`, `title`, and `status`           | [Thread response shapes](#thread-response-shapes)                    |
+| `getThreadInfo(threadId)`                        | method   | Fetches a single thread record                                  | [Thread response shapes](#thread-response-shapes)                    |
+| `getThreadTitle(threadId)`                       | method   | Convenience helper to fetch just the thread title               | [Thread response shapes](#thread-response-shapes)                    |
+| `chat({ message, threadId? })`                   | method   | Sends a message and creates/resumes a thread                    | [Agents](#agents), [Thread response shapes](#thread-response-shapes) |
+| `chatStream({ message, threadId?, onMessage? })` | method   | Streams messages and returns final `ThreadInfo`                 | [Agents](#agents), [Thread response shapes](#thread-response-shapes) |
+| `getMessages(threadId, { role? })`               | method   | Gets full (or role-filtered) message history                    | [Thread response shapes](#thread-response-shapes)                    |
+| `pollThread(threadId, options?)`                 | method   | Polls until thread processing completes                         | [Thread response shapes](#thread-response-shapes)                    |
+| `AgentClient.getAgentResponse(threadInfo)`       | method   | Extract combined plain-text agent output from a streamed thread | [Thread response shapes](#thread-response-shapes)                    |
+
+
+## Generated exports
+
+
+| import path                            | what you get                                                                                                                                                                     | when to use                                                  |
+| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| `./notion/` (relative)                 | `NotionORM` class (generated entry; same as `./notion/index` but shorter)                                                                                                        | Typical app code after `**notion sync**`                     |
+| `./notion/databases/<DatabaseName>.js` | `<DatabaseName>(auth)` factory, `PageSchema`, `CreateSchema`, `QuerySchema`, generated Zod schema, generated option tuples (for select/status/multi-select), schema/type aliases | Script-level direct DB usage without the `NotionORM` wrapper |
+| `./notion/agents/<AgentName>.js`       | `<AgentName>(auth)` factory that returns an `AgentClient` (PascalCase export; registry keys on `notion.agents` stay camelCase)                                                   | Script-level direct agent usage                              |
+| `./notion/databases/index.js`          | `databases` barrel object (all database factories)                                                                                                                               | Dynamic database selection or custom registry wiring         |
+| `./notion/agents/index.js`             | `agents` barrel object (all agent factories)                                                                                                                                     | Dynamic agent selection or custom registry wiring            |
+
+
+## Thread response shapes
+
+`chatStream(...)` returns `ThreadInfo` with the following properties:
+
+
+| ThreadInfo property | type                  | description                                              | example                                                |
+| ------------------- | --------------------- | -------------------------------------------------------- | ------------------------------------------------------ |
+| `threadId`          | `string`              | Stable thread identifier used to continue a conversation | `"1f4e6f4a-5b58-4d91-a7fc-2f5f2a0f6bb1"`               |
+| `agentId`           | `string`              | Agent identifier that produced the response              | `"2c3c495da03c8078b95500927f02d213"`                   |
+| `messages`          | `Array<{ role: "user" | "agent"; content: string }>`                             | Full message history currently available in the thread |
+
+
+`messages` item shape:
+
+
+| message property | type     | description                |
+| ---------------- | -------- | -------------------------- |
+| `role`           | `user`   | `agent` (`string`)         |
+| `content`        | `string` | Plain text message content |
+
+
+## Supported database properties
+
+
+| property_type      | expected returned shape                | example value                                 |
+| ------------------ | -------------------------------------- | --------------------------------------------- |
+| `title`            | `string`                               | `"The Dream Machine"`                         |
+| `rich_text`        | `string`                               | `"Long-form notes from the page"`             |
+| `number`           | `number`                               | `460`                                         |
+| `date`             | `{ start: string; end: string }`       | `{ start: "2026-03-01", end: "2026-03-02" }`  |
+| `status`           | `string`                               | `"In progress"`                               |
+| `select`           | `string`                               | `"Non-fiction"`                               |
+| `multi_select`     | `string[]`                             | `["Sci-Fi", "Biography"]`                     |
+| `checkbox`         | `boolean`                              | `true`                                        |
+| `email`            | `string`                               | `"tyrus@haustle.studio"`                      |
+| `phone_number`     | `string`                               | `"0000000000"`                                |
+| `url`              | `string`                               | `"https://developers.notion.com/"`            |
+| `files`            | `Array<{ name: string; url: string }>` | `[{ name: "brief.pdf", url: "https://..." }]` |
+| `people`           | `string[]`                             | `["1f4e6f4a-5b58-4d91-a7fc-2f5f2a0f6bb1"]`    |
+| `relation`         | `string[]`                             | `["6f7f9cbf-8d45-48f8-a194-661e73f7f5d9"]`    |
+| `created_by`       | `string`                               | `"Ada Lovelace"`                              |
+| `last_edited_by`   | `string`                               | `"user_123"`                                  |
+| `created_time`     | `string`                               | `"2026-03-01T10:30:00.000Z"`                  |
+| `last_edited_time` | `string`                               | `"2026-03-01T13:15:00.000Z"`                  |
+| `unique_id`        | `string`                               | `"TASK-42"`                                   |
+
+
+## Unsupported properties
+
+`rollup` and `formula` are intentionally unsupported.
+
+- `formula`: Notion computes formula values at read time, and the actual output shape depends on the formula expression and its current result type. That makes it a poor fit for the generated static schema this client exposes. Because we cannot provide a stable contract for reads, writes, or filters, formula properties are skipped entirely during code generation.
+- `rollup`: Rollup values are polymorphic and still need additional normalization before we can expose them as a predictable typed contract.
+
+All supported properties can be used in typed filters. Formula properties are not surfaced in the generated client at all, so they are unavailable for selection, filtering, and normalized query results.
+
+## Project Structure
+
+```txt
+.
+├── src
+│   ├── cli              # notion init / add / sync / setup-agents-sdk
+│   ├── config           # config discovery, loading, and validation
+│   ├── client           # runtime DatabaseClient + AgentClient
+│   │   └── query        # typed filters + response simplification
+│   ├── ast              # code generation internals
+│   │   ├── database
+│   │   ├── agents
+│   │   └── shared
+│   └── types            # local type bridges
+├── plugins              # lint/tooling helpers
+└── notion               # generated output (after notion sync)
+    ├── index.*          # import as ./notion/
+    ├── databases
+    └── agents
+```
 
-This project was started as a way to strengthen my TypeScript knowledge. I’ve succeeded in some regard, but there are still a few `@ts-ignore` in the project.

package/build/src/agents-sdk-resolver.d.ts

@@ -0,0 +1,8 @@
+export declare const AGENTS_SDK_SETUP_COMMAND = "notion setup-agents-sdk";
+export declare const AGENTS_SDK_REPO_URL = "https://github.com/makenotion/notion-agents-sdk-js.git";
+/** Filesystem probe instead of `createRequire` so resolution works the same in Node and other runtimes. */
+export declare function isAgentsSdkAvailable(): boolean;
+export declare function loadAgentsSdk(): Promise<typeof import("@notionhq/agents-client")>;
+/** Inlined so `AgentClient.getAgentResponse` works without eagerly importing the SDK. */
+export declare function stripLangTags(text: string): string;
+//# sourceMappingURL=agents-sdk-resolver.d.ts.map

package/build/src/agents-sdk-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-sdk-resolver.d.ts","sourceRoot":"","sources":["../../src/agents-sdk-resolver.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,wBAAwB,4BAA4B,CAAC;AAElE,eAAO,MAAM,mBAAmB,2DACyB,CAAC;AAM1D,2GAA2G;AAC3G,wBAAgB,oBAAoB,IAAI,OAAO,CAQ9C;AAED,wBAAsB,aAAa,IAAI,OAAO,CAC7C,cAAc,yBAAyB,CAAC,CACxC,CAKA;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/build/src/agents-sdk-resolver.js

@@ -0,0 +1,23 @@
+import fs from "fs";
+import path from "path";
+const AGENTS_SDK_PACKAGE = "@notionhq/agents-client";
+export const AGENTS_SDK_SETUP_COMMAND = "notion setup-agents-sdk";
+export const AGENTS_SDK_REPO_URL = "https://github.com/makenotion/notion-agents-sdk-js.git";
+const AGENTS_SDK_MISSING_MESSAGE = `Agent support requires the Notion Agents SDK (paid feature).\n` +
+    `Run \`${AGENTS_SDK_SETUP_COMMAND}\` to install it, then run \`notion sync\`.`;
+/** Filesystem probe instead of `createRequire` so resolution works the same in Node and other runtimes. */
+export function isAgentsSdkAvailable() {
+    const sdkPackageJson = path.join(process.cwd(), "node_modules", ...AGENTS_SDK_PACKAGE.split("/"), "package.json");
+    return fs.existsSync(sdkPackageJson);
+}
+export async function loadAgentsSdk() {
+    if (!isAgentsSdkAvailable()) {
+        throw new Error(AGENTS_SDK_MISSING_MESSAGE);
+    }
+    return import(AGENTS_SDK_PACKAGE);
+}
+/** Inlined so `AgentClient.getAgentResponse` works without eagerly importing the SDK. */
+export function stripLangTags(text) {
+    return text.replace(/<\/?lang[^>]*>/g, "");
+}
+//# sourceMappingURL=agents-sdk-resolver.js.map

package/build/src/agents-sdk-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-sdk-resolver.js","sourceRoot":"","sources":["../../src/agents-sdk-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAErD,MAAM,CAAC,MAAM,wBAAwB,GAAG,yBAAyB,CAAC;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAC/B,wDAAwD,CAAC;AAE1D,MAAM,0BAA0B,GAC/B,gEAAgE;IAChE,SAAS,wBAAwB,6CAA6C,CAAC;AAEhF,2GAA2G;AAC3G,MAAM,UAAU,oBAAoB;IACnC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAC/B,OAAO,CAAC,GAAG,EAAE,EACb,cAAc,EACd,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,EAChC,cAAc,CACd,CAAC;IACF,OAAO,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IAGlC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC,kBAAkB,CAAC,CAAC;AACnC,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/build/src/ast/agents/agent-file-writer.d.ts

@@ -0,0 +1,21 @@
+import type { AgentIcon } from "../../client/agent/AgentClient";
+import { type CodegenEnvironment } from "../shared/codegen-environment";
+export declare function renderAgentModule(args: {
+    agentId: string;
+    agentName: string;
+    agentIcon: AgentIcon;
+    agentModuleName?: string;
+}): {
+    tsCode: string;
+    agentId: string;
+    agentName: string;
+    agentModuleName: string;
+};
+export declare function createTypescriptFileForAgent(args: {
+    agentId: string;
+    agentName: string;
+    agentModuleName: string;
+    agentIcon: AgentIcon;
+    environment: CodegenEnvironment;
+}): Promise<void>;
+//# sourceMappingURL=agent-file-writer.d.ts.map

package/build/src/ast/agents/agent-file-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-file-writer.d.ts","sourceRoot":"","sources":["../../../../src/ast/agents/agent-file-writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAIhE,OAAO,EACN,KAAK,kBAAkB,EAEvB,MAAM,+BAA+B,CAAC;AAwLvC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACxB,CAQA;AAED,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,kBAAkB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBhB"}