zeta-assistant 0.1.0

package/README.md

@@ -0,0 +1,238 @@
+# Zeta Assistant
+
+A locally running AI operator controlled via WhatsApp Web. Send a message from your phone and Zeta plans, validates, and executes tasks autonomously — all from your terminal.
+
+> **Status:** Phase 2 complete — AI agent loop with o3-mini, command execution, and WhatsApp replies working.
+
+---
+
+## How It Works
+
+```
+You (WhatsApp) → Message → Zeta (terminal) → o3-mini plans commands → Executes on your machine → Replies on WhatsApp
+```
+
+1. Run `OPEN_AI_API_KEY=sk-... npx zeta-assistant` in your terminal
+2. Scan the QR code with WhatsApp on your phone
+3. Send yourself a message (to your own number) — Zeta picks it up
+4. The AI planner (o3-mini) decides what shell commands to run
+5. Commands execute in parallel on your machine
+6. Zeta summarises the results and replies on WhatsApp
+
+The assistant runs **only while the terminal is open**. No cloud, no webhooks, no public exposure. Only messages you send to yourself are processed — messages from others are ignored.
+
+---
+
+## Prerequisites
+
+- **Node.js** >= 20.0.0
+- A **WhatsApp** account
+
+---
+
+## Quick Start
+
+### Option 1: npx (recommended)
+
+```bash
+OPEN_AI_API_KEY=sk-... npx zeta-assistant
+```
+
+Or with the flag:
+
+```bash
+npx zeta-assistant --OPEN_AI_API_KEY=sk-...
+```
+
+### Option 2: Clone and run with npm
+
+```bash
+# 1. Clone the repository
+git clone https://github.com/your-org/zeta-assistant.git
+cd zeta-assistant
+
+# 2. Install dependencies
+npm install
+
+# 3. Build
+npm run build
+
+# 4. Run
+OPEN_AI_API_KEY=sk-... npm start
+```
+
+On first run, a **QR code** appears in the terminal. Scan it with WhatsApp on your phone. The session is persisted in `~/.zeta/whatsapp-session/` so you only need to scan once.
+
+---
+
+## Dedicated Browser
+
+Zeta downloads and manages its **own Chromium instance** — completely separate from your personal browser. This is the "Zeta browser".
+
+**Why?** This is both a feature and a security model:
+
+- **You control what Zeta can access.** Log into sites (Instagram, Twitter, Gmail, etc.) inside the Zeta browser and the assistant can operate them on your behalf.
+- **Your personal browser is never touched.** Zeta has zero access to your personal cookies, sessions, or passwords.
+- **Sites you don't log into are inaccessible.** Zeta can only control what you explicitly grant.
+
+The Chromium binary is downloaded automatically during `npm install` via Puppeteer.
+
+---
+
+## CLI Usage
+
+```bash
+zeta-assistant [options]
+```
+
+| Flag | Description |
+|---|---|
+| `--OPEN_AI_API_KEY=<key>` | OpenAI API key **(required)**. Also reads `OPEN_AI_API_KEY` env var. |
+| `--reset-whatsapp` | Clear saved session and force a new QR code scan |
+| `--help`, `-h` | Show help message |
+| `--version`, `-v` | Show version number |
+
+---
+
+## Tech Stack
+
+### Current (Phase 1–2)
+
+| Category | Technology | Purpose |
+|---|---|---|
+| **Language** | [TypeScript](https://www.typescriptlang.org/) 5.x | Strict mode, no `any`, fully typed |
+| **Runtime** | [Node.js](https://nodejs.org/) >= 20 | ESM, modern APIs |
+| **AI** | [OpenAI o3-mini](https://platform.openai.com/) | Planner — batches shell commands from natural language |
+| **WhatsApp** | [whatsapp-web.js](https://github.com/pedroslopez/whatsapp-web.js) | WhatsApp Web client via Puppeteer |
+| **Browser** | Chromium (via Puppeteer) | Dedicated browser instance, isolated from personal browser |
+| **QR Display** | [qrcode-terminal](https://www.npmjs.com/package/qrcode-terminal) | QR code rendered in the terminal |
+| **Logging** | [Winston](https://github.com/winstonjs/winston) | Colored console to stderr + JSON lines to file |
+| **Testing** | [Jest](https://jestjs.io/) + [ts-jest](https://kulshekhar.github.io/ts-jest/) | Unit tests, ESM mode, 80%+ coverage |
+| **Linting** | [ESLint](https://eslint.org/) + [@typescript-eslint](https://typescript-eslint.io/) | Strict type-checked rules |
+| **Formatting** | [Prettier](https://prettier.io/) | Consistent code style |
+| **Git Hooks** | [Husky](https://typicode.github.io/husky/) + [lint-staged](https://github.com/lint-staged/lint-staged) | Pre-commit lint + format |
+
+### Planned (Upcoming Phases)
+
+| Category | Technology | Phase | Purpose |
+|---|---|---|---|
+| **Database** | [better-sqlite3](https://github.com/WiseLibs/better-sqlite3) | 4 | Task queue, session messages (SQLite) |
+| **Screenshot** | [Puppeteer](https://pptr.dev/) (direct) | 3 | `take_screenshot` tool |
+
+### Intentionally Not Used
+
+| Technology | Reason |
+|---|---|
+| Twilio / ngrok | No cloud dependency. WhatsApp Web only. |
+| Express / Fastify | No HTTP server. No webhooks. |
+| Commander / yargs | Minimal deps. Raw `process.argv` for 3 flags. |
+| dotenv | No `.env` files. API key passed via CLI flag or env var directly. |
+| Prisma / TypeORM | `better-sqlite3` is simpler for a single-file embedded database. |
+
+---
+
+## Project Structure
+
+```
+zeta-assistant/
+├── src/
+│   ├── main.ts                        # CLI entry point (shebang, arg parsing, shutdown)
+│   ├── index.ts                      # Library entry point (public API exports)
+│   ├── agent/
+│   │   ├── agent-loop.ts             # Orchestrates: message → plan → execute → reply
+│   │   └── planner.ts               # o3-mini planner (batches shell commands)
+│   ├── executor/
+│   │   └── command-executor.ts       # Parallel shell command execution (/bin/bash)
+│   ├── config/
+│   │   └── config-loader.ts          # Directory setup (~/.zeta)
+│   ├── whatsapp/
+│   │   └── whatsapp-client.ts        # whatsapp-web.js wrapper
+│   ├── logger/
+│   │   ├── logger.ts                 # Logger interface (swap implementations easily)
+│   │   └── winston-logger.ts         # Winston impl: colored stderr + JSON lines to file
+│   ├── types/
+│   │   ├── index.ts                  # Shared interfaces (ZetaConfig, CliArgs, PlannerOutput)
+│   │   └── qrcode-terminal.d.ts      # Type declarations for untyped package
+│   └── utils/
+│       └── cli-parser.ts             # Minimal process.argv parser
+├── tests/
+│   └── unit/                         # Mirrors src/ structure
+├── docs/
+│   └── prd.md                        # Product requirements & technical spec
+├── package.json
+├── tsconfig.json
+├── tsconfig.build.json
+├── tsconfig.test.json
+├── jest.config.ts
+├── eslint.config.js
+├── .prettierrc
+└── CONTRIBUTING.md                    # Coding standards & best practices
+```
+
+### Runtime Data (`~/.zeta/`)
+
+```
+~/.zeta/
+├── whatsapp-session/     # Persisted WhatsApp login (LocalAuth)
+├── logs/
+│   └── zeta.log          # JSON lines log file (Winston file transport)
+├── scripts/              # Reusable scripts (Phase 7)
+├── sessions.db           # SQLite task queue (Phase 4)
+└── global_context.json   # Cross-task memory (Phase 9)
+```
+
+---
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Type check
+npm run typecheck
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Run tests with coverage report
+npm run test:coverage
+
+# Lint
+npm run lint
+
+# Format
+npm run format
+```
+
+---
+
+## Roadmap
+
+| Phase | Goal | Status |
+|---|---|---|
+| 1 | WhatsApp connection, QR login, message reception | ✅ Done |
+| 2 | AI agent loop (o3-mini), command execution, reply to messages | ✅ Done |
+| 3 | Screenshot tool, media attachments | ⬜ |
+| 4 | SQLite task queue, FIFO processing | ⬜ |
+| 5 | Governor + Decision Engine, confirmation flow | ⬜ |
+| 6 | Script registry (create, reuse, update) | ⬜ |
+| 7 | Full JSONL structured logging | ⬜ |
+| 8 | Global context persistence | ⬜ |
+
+> Full product requirements and technical specification: [`docs/prd.md`](docs/prd.md)
+
+---
+
+## Contributing
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for coding standards, naming conventions, testing requirements, and best practices.
+
+---
+
+## License
+
+MIT

package/dist/agent/agent-loop.d.ts

@@ -0,0 +1,7 @@
+export declare class AgentLoop {
+    private readonly planner;
+    private readonly executor;
+    constructor(apiKey: string);
+    run(userMessage: string): Promise<string>;
+}
+//# sourceMappingURL=agent-loop.d.ts.map

package/dist/agent/agent-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../../src/agent/agent-loop.ts"],"names":[],"mappings":"AAOA,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;gBAEtC,MAAM,EAAE,MAAM;IAIpB,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAkBhD"}

package/dist/agent/agent-loop.js

@@ -0,0 +1,34 @@
+import { Planner } from './planner.js';
+import { CommandExecutor } from '../executor/index.js';
+import { WinstonLogger } from '../logger/index.js';
+const logger = new WinstonLogger('AgentLoop');
+export class AgentLoop {
+    planner;
+    executor = new CommandExecutor();
+    constructor(apiKey) {
+        this.planner = new Planner(apiKey);
+    }
+    async run(userMessage) {
+        logger.info(`Running agent loop for: "${userMessage}"`);
+        const plan = await this.planner.plan(userMessage);
+        logger.info(`Reasoning: ${plan.reasoning}`);
+        if (plan.commands.length === 0) {
+            return plan.reply || 'Done.';
+        }
+        logger.info(`Executing ${String(plan.commands.length)} command(s) in parallel...`);
+        const results = await this.executor.run(plan.commands);
+        const commandResults = formatCommandResults(results);
+        logger.info(`Command results:\n${commandResults}`);
+        return this.planner.summarise(userMessage, commandResults);
+    }
+}
+function formatCommandResults(results) {
+    return results
+        .map((r) => {
+        const status = r.exitCode === 0 ? '✓' : '✗';
+        const output = r.stdout || r.stderr || '(no output)';
+        return `${status} ${r.command}\n${output}`;
+    })
+        .join('\n\n');
+}
+//# sourceMappingURL=agent-loop.js.map

package/dist/agent/agent-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.js","sourceRoot":"","sources":["../../src/agent/agent-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;AAE9C,MAAM,OAAO,SAAS;IACH,OAAO,CAAU;IACjB,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IAElD,YAAY,MAAc;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,WAAmB;QAC3B,MAAM,CAAC,IAAI,CAAC,4BAA4B,WAAW,GAAG,CAAC,CAAC;QAExD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAE5C,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC;QAC/B,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEvD,MAAM,cAAc,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,qBAAqB,cAAc,EAAE,CAAC,CAAC;QAEnD,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,SAAS,oBAAoB,CAAC,OAAiC;IAC7D,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC5C,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,aAAa,CAAC;QACrD,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;IAC7C,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/dist/agent/index.d.ts

@@ -0,0 +1,2 @@
+export { AgentLoop } from './agent-loop.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,2 @@
+export { AgentLoop } from './agent-loop.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/agent/planner.d.ts

@@ -0,0 +1,8 @@
+import type { PlannerOutput } from '../types/index.js';
+export declare class Planner {
+    private readonly client;
+    constructor(apiKey: string);
+    plan(userMessage: string): Promise<PlannerOutput>;
+    summarise(userMessage: string, commandResults: string): Promise<string>;
+}
+//# sourceMappingURL=planner.d.ts.map

package/dist/agent/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/agent/planner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAsCvD,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM;IAIpB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBjD,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiB9E"}

package/dist/agent/planner.js

@@ -0,0 +1,87 @@
+import { homedir } from 'node:os';
+import { platform, arch } from 'node:process';
+import OpenAI from 'openai';
+import { WinstonLogger } from '../logger/index.js';
+// o3-mini is the best reasoning/planning model — ideal for batching multi-step actions.
+const PLANNER_MODEL = 'o3-mini';
+function buildSystemPrompt() {
+    return `You are Zeta, an AI assistant that controls a computer via shell commands.
+
+Environment:
+- OS: ${platform} (${arch})
+- Shell: /bin/bash
+- Home directory: ${homedir()}
+- Working directory: ${homedir()}
+
+When the user sends a request, you must:
+1. Determine ALL commands needed to answer the request in ONE response.
+2. Batch all necessary commands together. Prefer fewer, broader commands over many narrow ones.
+3. Return a JSON object with this exact shape:
+
+{
+  "commands": ["cmd1", "cmd2"],
+  "reasoning": "why these commands answer the request",
+  "reply": ""
+}
+
+If no commands are needed (e.g. a greeting or simple question), return an empty commands array and put the answer directly in reply.
+
+Rules:
+- All commands run in /bin/bash from the home directory.
+- Use absolute paths or cd into directories explicitly.
+- Always prefer read-only commands unless the user explicitly asks to change something.
+- Never use sudo unless explicitly requested.
+- Do NOT have conversations. You are a task executor, not a chatbot. If the message is just a greeting or casual chat, reply briefly and do not ask follow-up questions.
+- The "reply" field is filled AFTER command results are observed. Leave it empty when commands are present.`;
+}
+const logger = new WinstonLogger('Planner');
+export class Planner {
+    client;
+    constructor(apiKey) {
+        this.client = new OpenAI({ apiKey });
+    }
+    async plan(userMessage) {
+        logger.info(`Planning for: ${userMessage}`);
+        const response = await this.client.chat.completions.create({
+            model: PLANNER_MODEL,
+            response_format: { type: 'json_object' },
+            messages: [
+                { role: 'system', content: buildSystemPrompt() },
+                { role: 'user', content: userMessage },
+            ],
+        });
+        const raw = response.choices[0]?.message?.content ?? '{}';
+        logger.info(`Planner raw response: ${raw}`);
+        return parsePlannerOutput(raw);
+    }
+    async summarise(userMessage, commandResults) {
+        logger.info('Summarising command results...');
+        const response = await this.client.chat.completions.create({
+            model: PLANNER_MODEL,
+            messages: [
+                { role: 'system', content: buildSystemPrompt() },
+                { role: 'user', content: userMessage },
+                {
+                    role: 'user',
+                    content: `Command results:\n${commandResults}\n\nNow write the final reply to the user based on these results. Be concise and direct.`,
+                },
+            ],
+        });
+        return response.choices[0]?.message?.content?.trim() ?? 'Done.';
+    }
+}
+function parsePlannerOutput(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return {
+            commands: Array.isArray(parsed.commands) ? parsed.commands : [],
+            reasoning: typeof parsed.reasoning === 'string' ? parsed.reasoning : '',
+            reply: typeof parsed.reply === 'string' ? parsed.reply : '',
+        };
+    }
+    catch {
+        logger.warn(`Failed to parse planner output, treating as plain reply: ${raw}`);
+        return { commands: [], reasoning: '', reply: raw };
+    }
+}
+//# sourceMappingURL=planner.js.map

package/dist/agent/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/agent/planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,wFAAwF;AACxF,MAAM,aAAa,GAAG,SAAS,CAAC;AAEhC,SAAS,iBAAiB;IACxB,OAAO;;;QAGD,QAAQ,KAAK,IAAI;;oBAEL,OAAO,EAAE;uBACN,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;4GAqB4E,CAAC;AAC7G,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AAE5C,MAAM,OAAO,OAAO;IACD,MAAM,CAAS;IAEhC,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC5B,MAAM,CAAC,IAAI,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAC;QAE5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACzD,KAAK,EAAE,aAAa;YACpB,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;YACxC,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE;gBAChD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;aACvC;SACF,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;QAC1D,MAAM,CAAC,IAAI,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;QAE5C,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,WAAmB,EAAE,cAAsB;QACzD,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAE9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACzD,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE;gBAChD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;gBACtC;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,qBAAqB,cAAc,0FAA0F;iBACvI;aACF;SACF,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC;IAClE,CAAC;CACF;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC;QAEzD,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;YAC/D,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;YACvE,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;SAC5D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,4DAA4D,GAAG,EAAE,CAAC,CAAC;QAC/E,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/config/config-loader.d.ts

@@ -0,0 +1,5 @@
+import type { ZetaConfig } from '../types/index.js';
+export declare function ensureDirectory(dirPath: string): void;
+export declare function ensureZetaDirectories(zetaDir: string): void;
+export declare function initConfig(): ZetaConfig;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/config/config-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAK3D;AAED,wBAAgB,UAAU,IAAI,UAAU,CAWvC"}

package/dist/config/config-loader.js

@@ -0,0 +1,27 @@
+import { mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const DEFAULT_ZETA_DIR = join(homedir(), '.zeta');
+const REQUIRED_SUBDIRS = ['whatsapp-session', 'logs', 'scripts'];
+export function ensureDirectory(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+export function ensureZetaDirectories(zetaDir) {
+    ensureDirectory(zetaDir);
+    for (const subdir of REQUIRED_SUBDIRS) {
+        ensureDirectory(join(zetaDir, subdir));
+    }
+}
+export function initConfig() {
+    const zetaDir = DEFAULT_ZETA_DIR;
+    ensureZetaDirectories(zetaDir);
+    return {
+        zetaDir,
+        whatsappSessionPath: join(zetaDir, 'whatsapp-session'),
+        logsDir: join(zetaDir, 'logs'),
+        scriptsDir: join(zetaDir, 'scripts'),
+    };
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/config/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../src/config/config-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,gBAAgB,GAAG,CAAC,kBAAkB,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAE1E,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,gBAAgB,CAAC;IAEjC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE/B,OAAO;QACL,OAAO;QACP,mBAAmB,EAAE,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC;QACtD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;QAC9B,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,2 @@
+export { initConfig, ensureDirectory, ensureZetaDirectories } from './config-loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export { initConfig, ensureDirectory, ensureZetaDirectories } from './config-loader.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/executor/command-executor.d.ts

@@ -0,0 +1,7 @@
+import type { CommandResult } from '../types/index.js';
+export declare class CommandExecutor {
+    private readonly logger;
+    run(commands: readonly string[]): Promise<CommandResult[]>;
+    private runOne;
+}
+//# sourceMappingURL=command-executor.d.ts.map

package/dist/executor/command-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../src/executor/command-executor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAE5D,GAAG,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;YAIlD,MAAM;CAuBrB"}

package/dist/executor/command-executor.js

@@ -0,0 +1,34 @@
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { homedir } from 'node:os';
+import { WinstonLogger } from '../logger/index.js';
+const execAsync = promisify(exec);
+const COMMAND_TIMEOUT_MS = 30_000;
+export class CommandExecutor {
+    logger = new WinstonLogger(CommandExecutor.name);
+    async run(commands) {
+        return Promise.all(commands.map((cmd) => this.runOne(cmd)));
+    }
+    async runOne(command) {
+        this.logger.warn(`Executing command: ${command}`);
+        try {
+            const { stdout, stderr } = await execAsync(command, {
+                timeout: COMMAND_TIMEOUT_MS,
+                encoding: 'utf-8',
+                shell: '/bin/bash',
+                cwd: homedir(),
+            });
+            return { command, stdout: stdout.trim(), stderr: stderr.trim(), exitCode: 0 };
+        }
+        catch (error) {
+            const err = error;
+            return {
+                command,
+                stdout: err.stdout?.trim() ?? '',
+                stderr: err.stderr?.trim() ?? err.message ?? 'Unknown error',
+                exitCode: err.code ?? 1,
+            };
+        }
+    }
+}
+//# sourceMappingURL=command-executor.js.map

package/dist/executor/command-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-executor.js","sourceRoot":"","sources":["../../src/executor/command-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAClC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,OAAO,eAAe;IACT,MAAM,GAAG,IAAI,aAAa,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAElE,KAAK,CAAC,GAAG,CAAC,QAA2B;QACnC,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,OAAe;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QAElD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;gBAClD,OAAO,EAAE,kBAAkB;gBAC3B,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,WAAW;gBAClB,GAAG,EAAE,OAAO,EAAE;aACf,CAAC,CAAC;YAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,KAA8E,CAAC;YAE3F,OAAO;gBACL,OAAO;gBACP,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;gBAChC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,IAAI,eAAe;gBAC5D,QAAQ,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC;aACxB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/executor/index.d.ts

@@ -0,0 +1,2 @@
+export { CommandExecutor } from './command-executor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/executor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/executor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/executor/index.js

@@ -0,0 +1,2 @@
+export { CommandExecutor } from './command-executor.js';
+//# sourceMappingURL=index.js.map

package/dist/executor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/executor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { initConfig } from './config/index.js';
+export { WhatsappClient, initWhatsapp } from './whatsapp/index.js';
+export { WinstonLogger, initLoggerTransports } from './logger/index.js';
+export type { Logger, LogLevel } from './logger/index.js';
+export type { ZetaConfig, CliArgs } from './types/index.js';
+export type { WhatsappClientOptions, MessageHandler } from './whatsapp/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { initConfig } from './config/index.js';
+export { WhatsappClient, initWhatsapp } from './whatsapp/index.js';
+export { WinstonLogger, initLoggerTransports } from './logger/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/logger/index.d.ts

@@ -0,0 +1,3 @@
+export type { Logger, LogLevel } from './logger.js';
+export { WinstonLogger, initLoggerTransports } from './winston-logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/logger/index.js

@@ -0,0 +1,2 @@
+export { WinstonLogger, initLoggerTransports } from './winston-logger.js';
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/logger/logger.d.ts

@@ -0,0 +1,8 @@
+export type LogLevel = 'info' | 'warn' | 'error' | 'debug';
+export interface Logger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B"}

package/dist/logger/logger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.js.map

package/dist/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":""}

package/dist/logger/winston-logger.d.ts

@@ -0,0 +1,19 @@
+import type { Logger } from './logger.js';
+export declare function initLoggerTransports(logsDir: string): void;
+/** @internal */
+export declare function _resetFileTransport(): void;
+export declare function formatLogEntry(entry: {
+    level: string;
+    message: string;
+    timestamp?: string;
+    context?: string;
+}): string;
+export declare class WinstonLogger implements Logger {
+    private readonly context;
+    constructor(context: string);
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+}
+//# sourceMappingURL=winston-logger.d.ts.map

package/dist/logger/winston-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winston-logger.d.ts","sourceRoot":"","sources":["../../src/logger/winston-logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA+B1C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAa1D;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAKT;AAED,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,MAAM;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG7B"}

package/dist/logger/winston-logger.js

@@ -0,0 +1,65 @@
+import { createLogger, format, transports } from 'winston';
+import { join } from 'node:path';
+const LEVEL_COLORS = {
+    info: '\x1b[36m',
+    warn: '\x1b[33m',
+    error: '\x1b[31m',
+    debug: '\x1b[90m',
+};
+const RESET = '\x1b[0m';
+const consoleFormat = format.printf(({ level, message, timestamp, context }) => {
+    const color = LEVEL_COLORS[level] ?? '';
+    const tag = level.toUpperCase().padEnd(5);
+    const ctx = typeof context === 'string' ? context : 'App';
+    return `${color}[${String(timestamp)}] [${tag}] [${ctx}]${RESET} ${String(message)}`;
+});
+const winstonInstance = createLogger({
+    level: 'debug',
+    transports: [
+        new transports.Console({
+            stderrLevels: ['info', 'warn', 'error', 'debug'],
+            format: format.combine(format.timestamp(), consoleFormat),
+        }),
+    ],
+});
+// Winston throws if you add the same file transport twice, so we guard with a flag.
+let fileTransportAdded = false;
+export function initLoggerTransports(logsDir) {
+    if (fileTransportAdded) {
+        return;
+    }
+    winstonInstance.add(new transports.File({
+        filename: join(logsDir, 'zeta.log'),
+        format: format.combine(format.timestamp(), format.json()),
+    }));
+    fileTransportAdded = true;
+}
+/** @internal */
+export function _resetFileTransport() {
+    fileTransportAdded = false;
+}
+export function formatLogEntry(entry) {
+    const color = LEVEL_COLORS[entry.level] ?? '';
+    const tag = entry.level.toUpperCase().padEnd(5);
+    const ctx = typeof entry.context === 'string' ? entry.context : 'App';
+    return `${color}[${String(entry.timestamp ?? new Date().toISOString())}] [${tag}] [${ctx}]${RESET} ${String(entry.message)}`;
+}
+export class WinstonLogger {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    info(message) {
+        winstonInstance.info(message, { context: this.context });
+    }
+    warn(message) {
+        winstonInstance.warn(message, { context: this.context });
+    }
+    error(message) {
+        winstonInstance.error(message, { context: this.context });
+    }
+    debug(message) {
+        winstonInstance.debug(message, { context: this.context });
+    }
+}
+//# sourceMappingURL=winston-logger.js.map

package/dist/logger/winston-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"winston-logger.js","sourceRoot":"","sources":["../../src/logger/winston-logger.ts"],"names":[],"mappings":"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"}

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { initConfig } from './config/index.js';
+import { initWhatsapp } from './whatsapp/index.js';
+import { parseCliArgs, getHelpText } from './utils/index.js';
+import { WinstonLogger, initLoggerTransports } from './logger/index.js';
+import { AgentLoop } from './agent/index.js';
+const logger = new WinstonLogger('Main');
+function getVersion() {
+    const require = createRequire(import.meta.url);
+    const pkg = require('../package.json');
+    return pkg.version;
+}
+function requirePlannerApiKey(plannerApiKey) {
+    if (!plannerApiKey) {
+        logger.error('OPEN_AI_API_KEY is required. Pass it via --OPEN_AI_API_KEY=<key> or set OPEN_AI_API_KEY env var.');
+        process.exit(1);
+    }
+    return plannerApiKey;
+}
+function initGracefulShutdown(whatsapp) {
+    const shutdown = async (signal) => {
+        logger.info(`Received ${signal}. Shutting down gracefully...`);
+        await whatsapp.destroy();
+        process.exit(0);
+    };
+    process.on('SIGINT', () => void shutdown('SIGINT'));
+    process.on('SIGTERM', () => void shutdown('SIGTERM'));
+}
+async function main() {
+    const args = parseCliArgs(process.argv);
+    if (args.help) {
+        console.error(getHelpText());
+        process.exit(0);
+    }
+    if (args.version) {
+        console.error(getVersion());
+        process.exit(0);
+    }
+    const apiKey = requirePlannerApiKey(args.plannerApiKey);
+    const agentLoop = new AgentLoop(apiKey);
+    logger.info(`Zeta Assistant v${getVersion()} starting...`);
+    const config = initConfig();
+    initLoggerTransports(config.logsDir);
+    const whatsapp = await initWhatsapp({
+        config,
+        resetSession: args.resetWhatsapp,
+        onMessage: (sender, body) => {
+            agentLoop
+                .run(body)
+                .then(async (reply) => {
+                await whatsapp.sendMessage(sender, reply);
+            })
+                .catch((error) => {
+                const message = error instanceof Error ? error.message : String(error);
+                logger.error(`Agent loop error: ${message}`);
+            });
+        },
+    });
+    initGracefulShutdown(whatsapp);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(`Fatal: ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,24 @@
+export interface ZetaConfig {
+    readonly zetaDir: string;
+    readonly whatsappSessionPath: string;
+    readonly logsDir: string;
+    readonly scriptsDir: string;
+}
+export interface CliArgs {
+    readonly resetWhatsapp: boolean;
+    readonly help: boolean;
+    readonly version: boolean;
+    readonly plannerApiKey: string | null;
+}
+export interface CommandResult {
+    readonly command: string;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number;
+}
+export interface PlannerOutput {
+    readonly commands: readonly string[];
+    readonly reasoning: string;
+    readonly reply: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/cli-parser.d.ts

@@ -0,0 +1,4 @@
+import type { CliArgs } from '../types/index.js';
+export declare function parseCliArgs(argv: readonly string[]): CliArgs;
+export declare function getHelpText(): string;
+//# sourceMappingURL=cli-parser.d.ts.map

package/dist/utils/cli-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parser.d.ts","sourceRoot":"","sources":["../../src/utils/cli-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAc7D;AAED,wBAAgB,WAAW,IAAI,MAAM,CAmBpC"}

package/dist/utils/cli-parser.js

@@ -0,0 +1,34 @@
+export function parseCliArgs(argv) {
+    const args = argv.slice(2);
+    const plannerApiKeyArg = args.find((a) => a.startsWith('--OPEN_AI_API_KEY='));
+    const plannerApiKey = plannerApiKeyArg
+        ? (plannerApiKeyArg.split('=')[1] ?? null)
+        : (process.env['OPEN_AI_API_KEY'] ?? null);
+    return {
+        resetWhatsapp: args.includes('--reset-whatsapp'),
+        help: args.includes('--help') || args.includes('-h'),
+        version: args.includes('--version') || args.includes('-v'),
+        plannerApiKey,
+    };
+}
+export function getHelpText() {
+    return `
+Usage: zeta-assistant [options]
+
+A locally running AI operator controlled via WhatsApp Web.
+
+Options:
+  --OPEN_AI_API_KEY=<key>      OpenAI API key (required). Can also be set via OPEN_AI_API_KEY env var.
+  --reset-whatsapp             Clear saved session and scan a new QR code
+  --help, -h                   Show this help message
+  --version, -v                Show version number
+
+Prerequisites:
+  - Node.js >= 20
+
+Examples:
+  npx zeta-assistant --OPEN_AI_API_KEY=sk-...
+  OPEN_AI_API_KEY=sk-... npx zeta-assistant
+`.trim();
+}
+//# sourceMappingURL=cli-parser.js.map

package/dist/utils/cli-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parser.js","sourceRoot":"","sources":["../../src/utils/cli-parser.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,IAAuB;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE3B,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC9E,MAAM,aAAa,GAAG,gBAAgB;QACpC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC1C,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,CAAC;IAE7C,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAChD,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpD,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC1D,aAAa;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO;;;;;;;;;;;;;;;;;CAiBR,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { parseCliArgs, getHelpText } from './cli-parser.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export { parseCliArgs, getHelpText } from './cli-parser.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/whatsapp/index.d.ts

@@ -0,0 +1,3 @@
+export { WhatsappClient, initWhatsapp } from './whatsapp-client.js';
+export type { WhatsappClientOptions, MessageHandler } from './whatsapp-client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/whatsapp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/whatsapp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/whatsapp/index.js

@@ -0,0 +1,2 @@
+export { WhatsappClient, initWhatsapp } from './whatsapp-client.js';
+//# sourceMappingURL=index.js.map

package/dist/whatsapp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/whatsapp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/whatsapp/whatsapp-client.d.ts

@@ -0,0 +1,25 @@
+import type { ZetaConfig } from '../types/index.js';
+export type MessageHandler = (sender: string, body: string) => void;
+export interface WhatsappClientOptions {
+    readonly config: ZetaConfig;
+    readonly resetSession: boolean;
+    readonly onMessage?: MessageHandler;
+}
+export declare class WhatsappClient {
+    private readonly client;
+    private readonly logger;
+    private readonly sessionPath;
+    private readonly sentByBot;
+    private isReady;
+    constructor(options: WhatsappClientOptions);
+    initialize(): Promise<void>;
+    destroy(): Promise<void>;
+    getIsReady(): boolean;
+    private clearSession;
+    private removeStaleLocks;
+    private killOrphanedChrome;
+    private registerEventHandlers;
+    sendMessage(to: string, text: string): Promise<void>;
+}
+export declare function initWhatsapp(options: WhatsappClientOptions): Promise<WhatsappClient>;
+//# sourceMappingURL=whatsapp-client.d.ts.map

package/dist/whatsapp/whatsapp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-client.d.ts","sourceRoot":"","sources":["../../src/whatsapp/whatsapp-client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;CACrC;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,qBAAqB;IA2BpC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,UAAU,IAAI,OAAO;IAIrB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,qBAAqB;IA6CvB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI3D;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAI1F"}

package/dist/whatsapp/whatsapp-client.js

@@ -0,0 +1,150 @@
+import pkg from 'whatsapp-web.js';
+const { Client, LocalAuth } = pkg;
+import qrcode from 'qrcode-terminal';
+import { rmSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { WinstonLogger } from '../logger/index.js';
+export class WhatsappClient {
+    client;
+    logger = new WinstonLogger(WhatsappClient.name);
+    sessionPath;
+    // Tracks messages sent by the bot itself to prevent re-processing and infinite loops.
+    sentByBot = new Set();
+    isReady = false;
+    constructor(options) {
+        this.sessionPath = options.config.whatsappSessionPath;
+        if (options.resetSession) {
+            this.clearSession();
+        }
+        this.removeStaleLocks();
+        this.client = new Client({
+            authStrategy: new LocalAuth({
+                dataPath: this.sessionPath,
+            }),
+            puppeteer: {
+                headless: true,
+                args: [
+                    '--no-sandbox',
+                    '--disable-setuid-sandbox',
+                    '--disable-dev-shm-usage',
+                    '--disable-gpu',
+                ],
+            },
+        });
+        this.registerEventHandlers(options.onMessage);
+    }
+    async initialize() {
+        this.logger.info('Initializing WhatsApp Web client...');
+        await this.client.initialize();
+    }
+    async destroy() {
+        this.logger.info('Shutting down WhatsApp Web client...');
+        try {
+            await this.client.destroy();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Error during shutdown: ${message}`);
+        }
+    }
+    getIsReady() {
+        return this.isReady;
+    }
+    clearSession() {
+        this.logger.warn('Resetting WhatsApp session (will require new QR scan)...');
+        try {
+            rmSync(this.sessionPath, { recursive: true, force: true });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to clear session: ${message}`);
+        }
+    }
+    removeStaleLocks() {
+        const lockFiles = [
+            join(this.sessionPath, 'session', 'SingletonLock'),
+            join(this.sessionPath, 'session', 'SingletonSocket'),
+            join(this.sessionPath, 'session', 'SingletonCookie'),
+        ];
+        for (const lockFile of lockFiles) {
+            if (existsSync(lockFile)) {
+                try {
+                    rmSync(lockFile, { force: true });
+                    this.logger.debug(`Removed stale lock: ${lockFile}`);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    this.logger.warn(`Could not remove lock file ${lockFile}: ${message}`);
+                }
+            }
+        }
+        this.killOrphanedChrome();
+    }
+    killOrphanedChrome() {
+        try {
+            // Find Chrome processes using this session directory
+            const result = execSync(`ps aux | grep -i "chrome" | grep "${this.sessionPath}" | grep -v grep | awk '{print $2}'`, { encoding: 'utf-8' });
+            const pids = result.trim().split('\n').filter(Boolean);
+            if (pids.length > 0) {
+                this.logger.debug(`Found ${String(pids.length)} orphaned Chrome process(es), killing...`);
+                for (const pid of pids) {
+                    execSync(`kill -9 ${pid}`, { stdio: 'ignore' });
+                }
+                // Give OS time to clean up
+                execSync('sleep 1', { stdio: 'ignore' });
+            }
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        }
+        catch (_) {
+            // Ignore errors — Chrome might not be running, which is fine
+        }
+    }
+    registerEventHandlers(onMessage) {
+        this.client.on('qr', (qr) => {
+            this.logger.info('QR code received. Scan with WhatsApp on your phone:');
+            qrcode.generate(qr, { small: true });
+        });
+        this.client.on('ready', () => {
+            this.isReady = true;
+            const info = this.client.info;
+            const owner = info?.wid._serialized ?? 'unknown';
+            this.logger.info(`Client is ready. Owner: ${owner}`);
+        });
+        this.client.on('authenticated', () => {
+            this.logger.info('Session authenticated successfully.');
+        });
+        this.client.on('auth_failure', (msg) => {
+            this.isReady = false;
+            this.logger.error(`Authentication failed: ${msg}`);
+        });
+        this.client.on('disconnected', (reason) => {
+            this.isReady = false;
+            this.logger.warn(`Disconnected: ${reason}`);
+        });
+        this.client.on('message_create', (msg) => {
+            if (!msg.fromMe || !msg.body) {
+                return;
+            }
+            // Since we send messages to our own number, bot replies arrive back as new incoming
+            // messages (owner → OpenAI → reply → WhatsApp → same number → triggers onMessage again).
+            // We track bot-sent texts in sentByBot to break this infinite loop.
+            if (this.sentByBot.has(msg.body)) {
+                this.sentByBot.delete(msg.body);
+                return;
+            }
+            this.logger.info(`Message from owner: ${msg.body}`);
+            onMessage?.(msg.from, msg.body);
+        });
+    }
+    async sendMessage(to, text) {
+        this.sentByBot.add(text);
+        await this.client.sendMessage(to, text);
+    }
+}
+export async function initWhatsapp(options) {
+    const client = new WhatsappClient(options);
+    await client.initialize();
+    return client;
+}
+//# sourceMappingURL=whatsapp-client.js.map

package/dist/whatsapp/whatsapp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-client.js","sourceRoot":"","sources":["../../src/whatsapp/whatsapp-client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "zeta-assistant",
+  "version": "0.1.0",
+  "description": "A locally running AI operator controlled via WhatsApp Web",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "zeta-assistant": "./dist/main.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "node --loader ts-node/esm src/main.ts",
+    "start": "node dist/main.js",
+    "test": "node --experimental-vm-modules node_modules/.bin/jest",
+    "test:coverage": "node --experimental-vm-modules node_modules/.bin/jest --coverage",
+    "lint": "eslint src/ tests/",
+    "lint:fix": "eslint src/ tests/ --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "prepare": "husky",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "whatsapp",
+    "ai",
+    "assistant",
+    "gpt",
+    "automation",
+    "cli"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "openai": "6.22.0",
+    "qrcode-terminal": "0.12.0",
+    "whatsapp-web.js": "1.34.6",
+    "winston": "3.19.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "22.13.4",
+    "@typescript-eslint/eslint-plugin": "8.24.0",
+    "@typescript-eslint/parser": "8.24.0",
+    "eslint": "9.20.0",
+    "husky": "9.1.7",
+    "jest": "29.7.0",
+    "lint-staged": "15.4.3",
+    "prettier": "3.5.1",
+    "ts-jest": "29.2.5",
+    "ts-node": "10.9.2",
+    "typescript": "5.7.3"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  }
+}