agent-embed-widget 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thesys Inc.
+
+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,188 @@
+# Agent Embed Widget
+
+A JavaScript library for embedding c1 agent widgets into your application. Works with vanilla JavaScript, TypeScript, and any framework.
+
+## Installation
+
+```bash
+npm install agent-embed-widget
+# or
+yarn add agent-embed-widget
+# or
+pnpm add agent-embed-widget
+```
+
+## Usage
+
+### ES Module (Named Import)
+
+```typescript
+import { embedWidget } from 'agent-embed-widget';
+import 'agent-embed-widget/dist/agent-embed-widget.css';
+
+const widget = embedWidget({
+  type: 'tray', // or 'full-screen'
+  url: 'https://console.thesys.dev/your-published-agent-url.com',
+  theme: 'dark' // or 'light'
+});
+
+// Control the widget programmatically
+widget.open();
+widget.close();
+widget.destroy();
+```
+
+### CommonJS
+
+```javascript
+const { embedWidget } = require('agent-embed-widget');
+require('agent-embed-widget/dist/agent-embed-widget.css');
+
+const widget = embedWidget({
+  type: 'tray',
+  url: 'https://console.thesys.dev/app/your-app-id',
+  theme: 'dark'
+});
+```
+
+### UMD (Browser)
+
+```html
+<link rel="stylesheet" href="node_modules/agent-embed-widget/dist/agent-embed-widget.css">
+<script src="node_modules/agent-embed-widget/dist/agent-embed-widget.umd.js"></script>
+
+<script>
+  const { embedWidget } = window.AgentEmbedWidget;
+
+  const widget = embedWidget({
+    type: 'tray',
+    url: 'https://console.thesys.dev/app/your-app-id',
+    theme: 'dark'
+  });
+</script>
+```
+
+### CDN Usage
+
+```html
+<link rel="stylesheet" href="https://unpkg.com/agent-embed-widget/dist/agent-embed-widget.css">
+<script src="https://unpkg.com/agent-embed-widget/dist/agent-embed-widget.umd.js"></script>
+
+<script>
+  const { embedWidget } = window.AgentEmbedWidget;
+
+  const widget = embedWidget({
+    type: 'full-screen',
+    url: 'https://console.thesys.dev/app/your-app-id',
+    theme: 'light'
+  });
+</script>
+```
+
+## API Reference
+
+### `embedWidget(options)`
+
+Creates and embeds a widget into your application.
+
+#### Options
+
+- `type` (optional): `'tray'` | `'full-screen'` - Widget display type. Default: `'tray'`
+  - `'tray'`: A compact widget that appears in the bottom-right corner
+  - `'full-screen'`: A widget that covers the entire screen when opened
+- `url` (required): `string` - The URL of the playground to embed
+- `theme` (optional): `'dark'` | `'light'` - Widget theme. Default: `'dark'`
+
+#### Returns
+
+A `WidgetInstance` object with the following methods:
+
+- `open()`: Opens/shows the widget
+- `close()`: Closes/hides the widget
+- `destroy()`: Removes the widget from the DOM and cleans up resources
+
+#### Example
+
+```typescript
+const widget = embedWidget({
+  type: 'tray',
+  url: 'https://console.thesys.dev/app/your-app-id',
+  theme: 'dark'
+});
+
+// Open the widget after 2 seconds
+setTimeout(() => widget.open(), 2000);
+
+// Close it after 5 seconds
+setTimeout(() => widget.close(), 5000);
+
+// Clean up when done
+// widget.destroy();
+```
+
+## TypeScript Support
+
+This package includes TypeScript declarations out of the box. No additional setup required!
+
+```typescript
+import { embedWidget } from 'agent-embed-widget';
+import type { EmbedWidgetOptions, WidgetInstance } from 'agent-embed-widget';
+
+// TypeScript will automatically provide type checking and IntelliSense
+const widget: WidgetInstance = embedWidget({
+  type: 'tray',
+  url: 'https://console.thesys.dev/app/your-app-id',
+  theme: 'dark'
+});
+```
+
+## Development
+
+### Setup
+
+```bash
+pnpm install
+```
+
+### Development Server
+
+```bash
+pnpm run dev
+```
+
+### Build
+
+```bash
+pnpm run build
+```
+
+This will generate:
+- `dist/agent-embed-widget.es.js` - ES module build
+- `dist/agent-embed-widget.umd.js` - UMD build for browser
+- `dist/agent-embed-widget.css` - Styles
+- `dist/index.d.ts` - TypeScript declarations
+
+### Lint
+
+```bash
+pnpm run lint
+```
+
+## Publishing
+
+Before publishing to npm, make sure to:
+
+1. Update the version in `package.json`
+2. Update the repository URL in `package.json`
+3. Update the author field in `package.json`
+4. Build the package: `pnpm run build`
+5. Publish: `npm publish`
+
+## License
+
+MIT
+
+## Peer Dependencies
+
+- React 18.0.0+ or 19.0.0+
+- React DOM 18.0.0+ or 19.0.0+