diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..96b3cb8
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,45 @@
+name: CI
+
+on:
+ push:
+ branches: [main]
+ pull_request:
+ branches: [main]
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.ref }}
+ cancel-in-progress: true
+
+jobs:
+ ci:
+ name: Typecheck ยท Lint ยท Test ยท Build
+ runs-on: ubuntu-latest
+ timeout-minutes: 15
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@v4
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: 22
+ cache: pnpm
+
+ - name: Install dependencies
+ run: pnpm install --frozen-lockfile
+
+ - name: Typecheck
+ run: pnpm typecheck
+
+ - name: Lint
+ run: pnpm lint || echo "No lint script found, skipping"
+
+ - name: Test
+ run: pnpm test || echo "No tests yet, skipping"
+
+ - name: Build
+ run: pnpm build
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
new file mode 100644
index 0000000..ed9cb5f
--- /dev/null
+++ b/.github/workflows/deploy.yml
@@ -0,0 +1,44 @@
+name: Deploy
+
+on:
+ push:
+ branches: [main]
+ paths:
+ - packages/backend/**
+ - pnpm-lock.yaml
+
+jobs:
+ deploy:
+ name: Deploy backend to Cloudflare Workers
+ runs-on: ubuntu-latest
+ timeout-minutes: 15
+
+ permissions:
+ contents: read
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@v4
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: 22
+ cache: pnpm
+
+ - name: Install dependencies
+ run: pnpm install --frozen-lockfile
+
+ - name: Build backend
+ run: pnpm --filter backend build
+
+ - name: Deploy to Cloudflare Workers
+ uses: cloudflare/wrangler-action@v3
+ with:
+ apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+ accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+ workingDirectory: packages/backend
+ command: deploy
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
new file mode 100644
index 0000000..8fae939
--- /dev/null
+++ b/.github/workflows/publish.yml
@@ -0,0 +1,41 @@
+name: Publish
+
+on:
+ release:
+ types: [published]
+
+jobs:
+ publish:
+ name: Publish widget to npm
+ runs-on: ubuntu-latest
+ timeout-minutes: 15
+
+ permissions:
+ contents: read
+ id-token: write # for npm provenance
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@v4
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: 22
+ registry-url: https://registry.npmjs.org
+ cache: pnpm
+
+ - name: Install dependencies
+ run: pnpm install --frozen-lockfile
+
+ - name: Build
+ run: pnpm build
+
+ - name: Publish widget
+ working-directory: packages/widget
+ run: pnpm publish --access public --no-git-checks
+ env:
+ NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..17a1e11
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,9 @@
+node_modules/
+dist/
+.turbo/
+.wrangler/
+*.tsbuildinfo
+.env
+.env.local
+.dev.vars
+coverage/
diff --git a/.prettierrc b/.prettierrc
new file mode 100644
index 0000000..4cbc711
--- /dev/null
+++ b/.prettierrc
@@ -0,0 +1,7 @@
+{
+ "semi": true,
+ "singleQuote": true,
+ "trailingComma": "all",
+ "printWidth": 100,
+ "tabWidth": 2
+}
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..66c4916
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VibeTechnologies
+
+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.
diff --git a/examples/basic/index.html b/examples/basic/index.html
new file mode 100644
index 0000000..34d7603
--- /dev/null
+++ b/examples/basic/index.html
@@ -0,0 +1,57 @@
+
+
+
+
+
+ WebAgent โ Basic Example
+
+
+
+ ๐ค WebAgent โ Basic Example
+ This page demonstrates the minimal WebAgent widget integration.
+
+
+
Try it out
+
Click the chat bubble in the bottom-right corner to start a conversation.
+
The agent can help with general questions and demonstrate tool usage.
+
Integration Code
+ <script src="https://cdn.example.com/webagent.min.js"></script>
+<script>
+ WebAgent.init({
+ apiBase: 'http://localhost:8787',
+ apiKey: 'your-api-key',
+ systemPrompt: 'You are a helpful assistant.',
+ welcomeMessage: 'Hi! How can I help you today?',
+ theme: 'light',
+ });
+</script>
+
+
+
+
+
+
diff --git a/examples/docs-site/index.html b/examples/docs-site/index.html
new file mode 100644
index 0000000..fc77570
--- /dev/null
+++ b/examples/docs-site/index.html
@@ -0,0 +1,70 @@
+
+
+
+
+
+ WebAgent โ Docs Site Example
+
+
+
+ ๐ API Documentation
+ Welcome to the ExampleAPI documentation. Our AI assistant can help you find the right endpoints and code examples.
+
+
+
Ask the AI assistant
+
Try: "How do I authenticate?" or "Show me an example of creating a user"
+
Authentication
+ All API requests require a Bearer token in the Authorization header.
+ curl -H "Authorization: Bearer YOUR_TOKEN" https://api.example.com/v1/users
+
+ Endpoints
+
+ GET /v1/users
+ List all users. Supports pagination with page and limit query parameters.
+
+ POST /v1/users
+ Create a new user. Requires name and email in the request body.
+ {
+ "name": "Jane Doe",
+ "email": "jane@example.com"
+}
+
+ GET /v1/users/:id
+ Get a single user by ID.
+
+ DELETE /v1/users/:id
+ Delete a user. Returns 204 No Content on success.
+
+
+
+
+
diff --git a/examples/ecommerce/index.html b/examples/ecommerce/index.html
new file mode 100644
index 0000000..7666a98
--- /dev/null
+++ b/examples/ecommerce/index.html
@@ -0,0 +1,106 @@
+
+
+
+
+
+ WebAgent โ E-commerce Example
+
+
+
+ ๐ Acme Store
+ Welcome to the Acme Store! Our AI assistant can help you find products and place orders.
+
+
+
Chat with our assistant
+
Try asking: "Show me laptops under $1000" or "What's your return policy?"
+
Featured Products
+
+
+
Wireless Headphones
+
Premium noise-cancelling
+
$149.99
+
+
+
Laptop Pro 15"
+
M3 chip, 16GB RAM
+
$1,299.99
+
+
+
Smart Watch
+
Health & fitness tracking
+
$299.99
+
+
+
USB-C Hub
+
7-in-1 multiport adapter
+
$49.99
+
+
+
${msg.role === 'user' ? (userName || 'Customer') : 'Agent'}:
+
${msg.content.replace(//g, '>')}
+
+
๐ซ Escalation Request โ ${ticketId}
+
+ | Customer Email | ${userEmail} |
+ ${userName ? `| Name | ${userName} |
` : ''}
+ ${context ? `| Context | ${context} |
` : ''}
+
+
Chat Transcript
+
+ ${transcriptHtml}
+
+ ${metadata ? `
Metadata: ${JSON.stringify(metadata)}
` : ''}
+