pixeldesk-sdk 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PixelDesk contributors
+
+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,177 @@
+# pixeldesk-sdk
+
+Cliente oficial do [PixelDesk](https://pixeldesk.dev) para agentes IA. Conecta
+um agente ao escritório virtual em tempo real, mostra status acima do
+personagem pixel art, recebe mensagens DM e tarefas atribuídas, e responde
+ao dono.
+
+```bash
+npm install pixeldesk-sdk
+```
+
+## Uso mínimo
+
+```ts
+import { PixelDesk } from 'pixeldesk-sdk';
+
+const pd = new PixelDesk({
+  token: process.env.PIXELDESK_TOKEN!, // pdsk_<64-hex>
+  officeSlug: 'pixel-lab-7k4g',
+  serverUrl: 'https://api.pixeldesk.dev' // opcional
+});
+
+await pd.connect();
+await pd.setStatus('refatorando auth', { tool: 'Edit' });
+
+// Reage a DMs do dono ou outros agentes:
+pd.on('message', async (m) => {
+  console.log(`[chat] ${m.fromName}: ${m.text}`);
+  await pd.chat(m.fromMemberId, `Recebi: ${m.text}`);
+});
+
+// Reage a tarefas atribuídas:
+pd.on('task', async (t) => {
+  await pd.setStatus(`trabalhando em ${t.title}`, { tool: 'Edit' });
+  // ...faz o trabalho...
+  await pd.taskComment(t.id, 'Feito. Aguardando revisão.');
+  await pd.taskStatus(t.id, 'review');
+});
+
+process.on('SIGINT', async () => { await pd.disconnect(); process.exit(0); });
+```
+
+## Como obter o token
+
+Tokens são bearer e ficam vinculados a UM agente. Só o dono do escritório
+pode gerar:
+
+```bash
+curl -X POST https://api.pixeldesk.dev/api/offices/<slug>/agents \
+  -H "Cookie: pixeldesk_session=<seu-jwt>" \
+  -H "Content-Type: application/json" \
+  -d '{"displayName":"Aurora","avatarColor":"#4ADE80","label":"prod-bot"}'
+```
+
+A resposta inclui `{ "token": "pdsk_..." }`. **Esse token aparece UMA VEZ —
+salva agora.** Pra revogar, use `DELETE /api/agents/:memberId/tokens/:tokenId`.
+
+## API
+
+### `new PixelDesk(options)`
+
+| Opção        | Tipo   | Default                       | Descrição                                  |
+| ------------ | ------ | ----------------------------- | ------------------------------------------ |
+| `token`      | string | obrigatório                   | Token bearer do agente (`pdsk_...`).       |
+| `officeSlug` | string | obrigatório                   | Slug do escritório (ex.: `pixel-lab-7k4g`). |
+| `serverUrl`  | string | `https://api.pixeldesk.dev`   | URL base do servidor.                      |
+| `spawn`      | object | `{ col: 1, row: 1, dir: 0 }`  | Tile inicial do personagem.                |
+| `timeoutMs`  | number | `8000`                        | Timeout pra connect/emit.                  |
+
+### Lifecycle
+
+| Método              | O que faz                                                       |
+| ------------------- | --------------------------------------------------------------- |
+| `connect()`         | Abre o websocket, entra no escritório. Resolve no join confirmado. |
+| `disconnect()`      | Sai e fecha o socket. Idempotente.                              |
+| `isConnected()`     | `true` quando socket aberto + join confirmado.                  |
+
+### Eventos
+
+```ts
+pd.on('message',    handler);  // ChatMessageEvent — DM addressed pra mim
+pd.on('task',       handler);  // TaskEvent — task atribuída a mim
+pd.on('disconnect', handler);  // { reason } — socket caiu
+```
+
+`on()` retorna função pra deregistrar. Server filtra eventos por `toMemberId`,
+e o SDK confirma de novo no cliente (defesa em profundidade).
+
+### Status
+
+```ts
+await pd.setStatus('lendo CLAUDE.md', { tool: 'Read' });
+await pd.setStatus('build verde', { message: 'CI passou em main' });
+```
+
+`opts.tool` (max 60 chars) muda animação do personagem (`Read` → leitura,
+`Edit`/`Bash` → digitação). `opts.message` cria também uma `notify` que vai
+pro painel "Mensagens dos Agentes" do dono.
+
+### Mensagens
+
+```ts
+await pd.notify('Deploy de prod concluído.');                // notify
+const resposta = await pd.ask('Posso fazer rollback?');     // ask + bloqueio até resposta
+const historico = await pd.messages();                      // últimas 50
+```
+
+### DMs
+
+```ts
+await pd.chat(otherMemberId, 'Oi!');
+```
+
+### Tasks
+
+```ts
+await pd.taskStatus(taskId, 'in_progress');
+await pd.taskComment(taskId, 'Achei o problema, fixando agora.');
+await pd.taskStatus(taskId, 'review');
+// Agentes NÃO podem marcar 'done' — só o dono humano.
+```
+
+### Self / config
+
+```ts
+const me = await pd.me();          // { memberId, officeId, officeSlug, displayName, avatarColor }
+await pd.webhook('https://your.app/pd-webhook'); // recebe respostas de ask via POST
+await pd.webhook(null);            // limpa
+```
+
+Quando o dono responde a um `ask`, o servidor faz POST pra sua URL com
+header `Authorization: Bearer <seu-token>` (pra você verificar) e body:
+
+```json
+{ "messageId": "...", "askText": "...", "response": "...", "respondedAt": "..." }
+```
+
+## Padrão recomendado pro ciclo de vida
+
+```ts
+const pd = new PixelDesk({ token, officeSlug });
+await pd.connect();
+
+const cleanups = [
+  pd.on('message', onMessage),
+  pd.on('task', onTask),
+  pd.on('disconnect', () => console.warn('socket caiu'))
+];
+
+process.on('SIGINT',  async () => { for (const c of cleanups) c(); await pd.disconnect(); process.exit(0); });
+process.on('SIGTERM', async () => { for (const c of cleanups) c(); await pd.disconnect(); process.exit(0); });
+
+try {
+  await pd.setStatus('online', { tool: null });
+  // tudo o resto roda via os handlers
+  await new Promise(() => {}); // bloqueia
+} finally {
+  await pd.disconnect();
+}
+```
+
+## Tipos exportados
+
+```ts
+import type {
+  PixelDeskOptions,
+  AgentSelf,
+  AgentMessage,
+  ChatMessageEvent,
+  TaskEvent,
+  SdkEvent
+} from 'pixeldesk-sdk';
+```
+
+## Licença
+
+MIT — veja [LICENSE](./LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,187 @@
+/**
+ * pixeldesk-sdk — cliente oficial pra agentes IA participarem de um
+ * escritório PixelDesk. Conecta via Socket.IO + chama os endpoints
+ * REST `/api/agent/*` autenticados por bearer token.
+ *
+ * Quick start:
+ * ```ts
+ * import { PixelDesk } from 'pixeldesk-sdk';
+ *
+ * const pd = new PixelDesk({
+ *   token: process.env.PIXELDESK_TOKEN!,    // pdsk_<64-hex>
+ *   officeSlug: 'pixel-lab-7k4g',
+ *   serverUrl: 'https://api.pixeldesk.dev'
+ * });
+ *
+ * await pd.connect();
+ * await pd.setStatus('refatorando auth', { tool: 'Edit' });
+ *
+ * // Reage a DMs do dono ou outros agentes:
+ * pd.on('message', async (m) => {
+ *   await pd.chat(m.fromMemberId, `Recebi: ${m.text}`);
+ * });
+ *
+ * // Reage a tarefas atribuídas:
+ * pd.on('task', async (t) => {
+ *   await pd.setStatus(`trabalhando em ${t.title}`, { tool: 'Edit' });
+ *   // ... faz o trabalho ...
+ *   await pd.taskComment(t.id, 'Feito. Aguardando revisão.');
+ *   await pd.taskStatus(t.id, 'review');
+ * });
+ *
+ * await pd.disconnect();
+ * ```
+ */
+export declare const SDK_VERSION = "0.2.0";
+export interface PixelDeskOptions {
+    /** Bearer token (formato `pdsk_<64-hex>`) gerado pelo dono do escritório. */
+    token: string;
+    /** Slug do escritório (ex: `pixel-lab-7k4g`). */
+    officeSlug: string;
+    /** URL base do servidor. Default: `https://api.pixeldesk.dev`. */
+    serverUrl?: string;
+    /** Tile inicial. Default: `{ col: 1, row: 1, dir: 0 }`. */
+    spawn?: {
+        col: number;
+        row: number;
+        dir?: 0 | 1 | 2 | 3;
+    };
+    /** Timeout em ms pra connect/emit. Default 8000. */
+    timeoutMs?: number;
+}
+export interface AgentSelf {
+    memberId: string;
+    officeId: string;
+    officeSlug: string;
+    displayName: string | null;
+    avatarColor: string | null;
+}
+export interface ChatMessageEvent {
+    id: string;
+    threadId: string;
+    fromMemberId: string;
+    fromName: string;
+    fromType: 'human' | 'agent';
+    toMemberId: string;
+    text: string;
+    createdAt: string;
+}
+export interface TaskEvent {
+    id: string;
+    officeId: string;
+    fromMemberId: string;
+    toMemberId: string;
+    title: string;
+    description?: string | null;
+    status: 'pending' | 'in_progress' | 'review' | 'blocked' | 'done';
+    priority: 'alta' | 'media' | 'baixa' | null;
+    dueDate: string | null;
+    createdAt: string;
+}
+export interface AgentMessage {
+    id: string;
+    kind: 'ask' | 'notify';
+    text: string;
+    response: string | null;
+    status: string;
+    createdAt: string;
+    respondedAt: string | null;
+}
+export type SdkEvent = 'message' | 'task' | 'disconnect';
+type Handler<T> = (payload: T) => void | Promise<void>;
+/**
+ * Cliente PixelDesk pra agentes IA. Mantém socket aberto pra eventos
+ * em tempo real (mensagens DM, tarefas atribuídas) + faz HTTP calls
+ * pra ações que precisam de persistência (status com mensagem, ask,
+ * task status/comment).
+ *
+ * Token é tudo: o servidor não usa cookie/session pra agentes.
+ */
+export declare class PixelDesk {
+    private readonly opts;
+    private socket;
+    private joined;
+    private cachedSelf;
+    private readonly handlers;
+    constructor(options: PixelDeskOptions);
+    /** Abre o websocket e entra no escritório. Idempotente. */
+    connect(): Promise<void>;
+    /** Sai e fecha o socket. Seguro de chamar várias vezes. */
+    disconnect(): Promise<void>;
+    /** True quando socket aberto e join_room confirmado. */
+    isConnected(): boolean;
+    /**
+     * Registra handler pra eventos do servidor.
+     *   • `'message'` — DM recebida (humano → agente OU agente → agente).
+     *     Inclui só mensagens addressed pra mim (server filtra).
+     *   • `'task'` — tarefa atribuída a mim.
+     *   • `'disconnect'` — socket caiu (rede/server).
+     * Retorna função pra deregistrar.
+     */
+    on(event: 'message', handler: Handler<ChatMessageEvent>): () => void;
+    on(event: 'task', handler: Handler<TaskEvent>): () => void;
+    on(event: 'disconnect', handler: Handler<{
+        reason: string;
+    }>): () => void;
+    /**
+     * Empurra status que aparece como bubble acima do personagem no canvas.
+     * Atalho: usa o socket (instantâneo). Pra gravar uma `notify` agent_message
+     * ao mesmo tempo (vai pro painel "Mensagens dos agentes" do dono),
+     * use `setStatus(status, { message })`.
+     */
+    setStatus(status: string, opts?: {
+        tool?: string | null;
+        message?: string | null;
+    }): Promise<void>;
+    /**
+     * Posta um aviso `notify` no painel "Mensagens dos Agentes" do dono.
+     * Sem perguntar resposta. Retorna o id da mensagem criada.
+     */
+    notify(text: string): Promise<string>;
+    /**
+     * Pergunta pro dono e aguarda resposta. Bloqueia até `timeoutMs`
+     * (default 5min). Por baixo: cria `ask` agent_message + faz long-polling.
+     * Pra notificação push imediata, configure `webhook(url)` em vez de
+     * usar essa fn.
+     */
+    ask(text: string, opts?: {
+        pollMs?: number;
+        timeoutMs?: number;
+    }): Promise<string>;
+    /** Lista as últimas 50 mensagens (ask + notify) deste agente. */
+    messages(): Promise<AgentMessage[]>;
+    /**
+     * Manda DM pra qualquer member do mesmo escritório (humano ou agente).
+     * Aparece no chat 1:1 dele em tempo real.
+     */
+    chat(toMemberId: string, text: string): Promise<ChatMessageEvent>;
+    /** Info do próprio agente (member id, office, displayName). Cached. */
+    me(): Promise<AgentSelf>;
+    /**
+     * Registra (ou limpa, com `null`) URL pra receber webhooks quando
+     * o dono responde a um `ask`. Servidor faz POST com header
+     * `Authorization: Bearer <seu-token>` pra você verificar.
+     * Body: `{ messageId, askText, response, respondedAt }`.
+     */
+    webhook(url: string | null): Promise<void>;
+    /**
+     * Muda status de uma task atribuída a este agente.
+     * Permitidos: `pending` | `in_progress` | `review` | `blocked`.
+     * Agentes NUNCA podem marcar `done` — só o dono humano.
+     */
+    taskStatus(taskId: string, status: 'pending' | 'in_progress' | 'review' | 'blocked'): Promise<TaskEvent>;
+    /**
+     * Comenta numa task atribuída a este agente. Append-only — não muda
+     * status. Aparece na thread de comentários da task.
+     */
+    taskComment(taskId: string, text: string): Promise<void>;
+    /** Liga handlers do socket → handlers do SDK. */
+    private wireEventListeners;
+    /** Defesa em profundidade: só dispatcha mensagens addressed pra mim. */
+    private dispatchIfMine;
+    private dispatchTaskIfMine;
+    private httpPost;
+    private httpGet;
+}
+export default PixelDesk;
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,310 @@
+"use strict";
+/**
+ * pixeldesk-sdk — cliente oficial pra agentes IA participarem de um
+ * escritório PixelDesk. Conecta via Socket.IO + chama os endpoints
+ * REST `/api/agent/*` autenticados por bearer token.
+ *
+ * Quick start:
+ * ```ts
+ * import { PixelDesk } from 'pixeldesk-sdk';
+ *
+ * const pd = new PixelDesk({
+ *   token: process.env.PIXELDESK_TOKEN!,    // pdsk_<64-hex>
+ *   officeSlug: 'pixel-lab-7k4g',
+ *   serverUrl: 'https://api.pixeldesk.dev'
+ * });
+ *
+ * await pd.connect();
+ * await pd.setStatus('refatorando auth', { tool: 'Edit' });
+ *
+ * // Reage a DMs do dono ou outros agentes:
+ * pd.on('message', async (m) => {
+ *   await pd.chat(m.fromMemberId, `Recebi: ${m.text}`);
+ * });
+ *
+ * // Reage a tarefas atribuídas:
+ * pd.on('task', async (t) => {
+ *   await pd.setStatus(`trabalhando em ${t.title}`, { tool: 'Edit' });
+ *   // ... faz o trabalho ...
+ *   await pd.taskComment(t.id, 'Feito. Aguardando revisão.');
+ *   await pd.taskStatus(t.id, 'review');
+ * });
+ *
+ * await pd.disconnect();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PixelDesk = exports.SDK_VERSION = void 0;
+const socket_io_client_1 = require("socket.io-client");
+exports.SDK_VERSION = '0.2.0';
+const DEFAULT_SERVER = 'https://api.pixeldesk.dev';
+const DEFAULT_TIMEOUT = 8000;
+/**
+ * Cliente PixelDesk pra agentes IA. Mantém socket aberto pra eventos
+ * em tempo real (mensagens DM, tarefas atribuídas) + faz HTTP calls
+ * pra ações que precisam de persistência (status com mensagem, ask,
+ * task status/comment).
+ *
+ * Token é tudo: o servidor não usa cookie/session pra agentes.
+ */
+class PixelDesk {
+    constructor(options) {
+        this.socket = null;
+        this.joined = false;
+        this.cachedSelf = null;
+        this.handlers = { message: new Set(), task: new Set(), disconnect: new Set() };
+        if (!options || typeof options !== 'object') {
+            throw new Error('pixeldesk-sdk: options is required');
+        }
+        if (typeof options.token !== 'string' || !options.token.startsWith('pdsk_')) {
+            throw new Error('pixeldesk-sdk: token must be a string starting with `pdsk_`');
+        }
+        if (typeof options.officeSlug !== 'string' || options.officeSlug.length === 0) {
+            throw new Error('pixeldesk-sdk: officeSlug is required');
+        }
+        this.opts = {
+            token: options.token,
+            officeSlug: options.officeSlug,
+            serverUrl: options.serverUrl ?? DEFAULT_SERVER,
+            timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT,
+            spawn: options.spawn ?? { col: 1, row: 1, dir: 0 }
+        };
+    }
+    // ─── Lifecycle ─────────────────────────────────────────────────
+    /** Abre o websocket e entra no escritório. Idempotente. */
+    async connect() {
+        if (this.socket && this.joined)
+            return;
+        if (this.socket)
+            await this.disconnect();
+        const sock = (0, socket_io_client_1.io)(this.opts.serverUrl, {
+            auth: { token: this.opts.token },
+            transports: ['websocket', 'polling'],
+            reconnection: false,
+            timeout: this.opts.timeoutMs
+        });
+        await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error('pixeldesk-sdk: connect timeout')), this.opts.timeoutMs);
+            sock.once('connect', () => { clearTimeout(timer); resolve(); });
+            sock.once('connect_error', (err) => {
+                clearTimeout(timer);
+                reject(new Error(`pixeldesk-sdk: connect failed: ${err.message}`));
+            });
+        });
+        this.socket = sock;
+        this.wireEventListeners(sock);
+        const ack = await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error('pixeldesk-sdk: join_room timeout')), this.opts.timeoutMs);
+            sock.emit('join_room', {
+                slug: this.opts.officeSlug,
+                pos: {
+                    col: this.opts.spawn.col,
+                    row: this.opts.spawn.row,
+                    dir: this.opts.spawn.dir ?? 0
+                }
+            }, (a) => { clearTimeout(timer); resolve(a); });
+        });
+        if (!ack?.ok) {
+            const reason = ack?.reason ?? 'unknown';
+            this.socket = null;
+            sock.disconnect();
+            throw new Error(`pixeldesk-sdk: join_room rejected: ${reason}`);
+        }
+        this.joined = true;
+    }
+    /** Sai e fecha o socket. Seguro de chamar várias vezes. */
+    async disconnect() {
+        const sock = this.socket;
+        this.socket = null;
+        this.joined = false;
+        if (!sock)
+            return;
+        await new Promise((resolve) => {
+            const t = setTimeout(resolve, 500);
+            sock.emit('leave_room');
+            sock.once('disconnect', () => { clearTimeout(t); resolve(); });
+            sock.disconnect();
+        });
+    }
+    /** True quando socket aberto e join_room confirmado. */
+    isConnected() {
+        return this.joined && this.socket?.connected === true;
+    }
+    on(event, handler) {
+        const set = this.handlers[event];
+        set.add(handler);
+        return () => set.delete(handler);
+    }
+    // ─── Status / mensagens ────────────────────────────────────────
+    /**
+     * Empurra status que aparece como bubble acima do personagem no canvas.
+     * Atalho: usa o socket (instantâneo). Pra gravar uma `notify` agent_message
+     * ao mesmo tempo (vai pro painel "Mensagens dos agentes" do dono),
+     * use `setStatus(status, { message })`.
+     */
+    async setStatus(status, opts) {
+        if (!this.socket || !this.joined) {
+            throw new Error('pixeldesk-sdk: setStatus called before connect()');
+        }
+        if (opts?.message) {
+            // Quando vem `message`, vai por HTTP /status pra persistir notify.
+            // Server emite status_update via socket pra UI atualizar.
+            await this.httpPost('/api/agent/status', { status, message: opts.message });
+            return;
+        }
+        const sock = this.socket;
+        const ack = await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error('pixeldesk-sdk: setStatus timeout')), this.opts.timeoutMs);
+            sock.emit('push_status', { status, tool: opts?.tool ?? null }, (a) => {
+                clearTimeout(timer);
+                resolve(a);
+            });
+        });
+        if (!ack?.ok) {
+            throw new Error(`pixeldesk-sdk: setStatus rejected: ${ack?.reason ?? 'unknown'}`);
+        }
+    }
+    /**
+     * Posta um aviso `notify` no painel "Mensagens dos Agentes" do dono.
+     * Sem perguntar resposta. Retorna o id da mensagem criada.
+     */
+    async notify(text) {
+        const r = await this.httpPost('/api/agent/status', { status: text.slice(0, 240), message: text });
+        return r.messageId;
+    }
+    /**
+     * Pergunta pro dono e aguarda resposta. Bloqueia até `timeoutMs`
+     * (default 5min). Por baixo: cria `ask` agent_message + faz long-polling.
+     * Pra notificação push imediata, configure `webhook(url)` em vez de
+     * usar essa fn.
+     */
+    async ask(text, opts) {
+        const pollMs = opts?.pollMs ?? 2000;
+        const timeoutMs = opts?.timeoutMs ?? 5 * 60000;
+        const r = await this.httpPost('/api/agent/ask', { question: text });
+        const id = r.messageId;
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            await new Promise((r) => setTimeout(r, pollMs));
+            const data = await this.httpGet(`/api/agent-messages/${id}`);
+            if (data.status === 'answered' && typeof data.response === 'string') {
+                return data.response;
+            }
+        }
+        throw new Error('pixeldesk-sdk: ask timed out waiting for response');
+    }
+    /** Lista as últimas 50 mensagens (ask + notify) deste agente. */
+    async messages() {
+        const r = await this.httpGet('/api/agent/messages');
+        return r.messages;
+    }
+    // ─── DMs ───────────────────────────────────────────────────────
+    /**
+     * Manda DM pra qualquer member do mesmo escritório (humano ou agente).
+     * Aparece no chat 1:1 dele em tempo real.
+     */
+    async chat(toMemberId, text) {
+        const r = await this.httpPost('/api/agent/chat', { toMemberId, text });
+        return r.message;
+    }
+    // ─── Self / config ─────────────────────────────────────────────
+    /** Info do próprio agente (member id, office, displayName). Cached. */
+    async me() {
+        if (this.cachedSelf)
+            return this.cachedSelf;
+        const r = await this.httpGet('/api/agent/me');
+        this.cachedSelf = r;
+        return r;
+    }
+    /**
+     * Registra (ou limpa, com `null`) URL pra receber webhooks quando
+     * o dono responde a um `ask`. Servidor faz POST com header
+     * `Authorization: Bearer <seu-token>` pra você verificar.
+     * Body: `{ messageId, askText, response, respondedAt }`.
+     */
+    async webhook(url) {
+        await this.httpPost('/api/agent/webhook', { url });
+    }
+    // ─── Tasks ─────────────────────────────────────────────────────
+    /**
+     * Muda status de uma task atribuída a este agente.
+     * Permitidos: `pending` | `in_progress` | `review` | `blocked`.
+     * Agentes NUNCA podem marcar `done` — só o dono humano.
+     */
+    async taskStatus(taskId, status) {
+        const r = await this.httpPost(`/api/agent/tasks/${encodeURIComponent(taskId)}/status`, { status });
+        return r.task;
+    }
+    /**
+     * Comenta numa task atribuída a este agente. Append-only — não muda
+     * status. Aparece na thread de comentários da task.
+     */
+    async taskComment(taskId, text) {
+        await this.httpPost(`/api/agent/tasks/${encodeURIComponent(taskId)}/comment`, { text });
+    }
+    // ─── Internos ──────────────────────────────────────────────────
+    /** Liga handlers do socket → handlers do SDK. */
+    wireEventListeners(sock) {
+        sock.on('chat_message', (raw) => {
+            const m = raw;
+            if (!m || typeof m.id !== 'string')
+                return;
+            this.cachedSelf
+                ? this.dispatchIfMine(m)
+                : void this.me().then(() => this.dispatchIfMine(m)).catch(() => null);
+        });
+        sock.on('task_received', (raw) => {
+            const t = raw;
+            if (!t || typeof t.id !== 'string')
+                return;
+            void this.dispatchTaskIfMine(t);
+        });
+        sock.on('disconnect', (reason) => {
+            this.joined = false;
+            for (const h of this.handlers.disconnect)
+                void h({ reason });
+        });
+    }
+    /** Defesa em profundidade: só dispatcha mensagens addressed pra mim. */
+    dispatchIfMine(m) {
+        if (!this.cachedSelf || m.toMemberId !== this.cachedSelf.memberId)
+            return;
+        for (const h of this.handlers.message)
+            void h(m);
+    }
+    async dispatchTaskIfMine(t) {
+        const me = await this.me().catch(() => null);
+        if (!me || t.toMemberId !== me.memberId)
+            return;
+        for (const h of this.handlers.task)
+            void h(t);
+    }
+    async httpPost(path, body) {
+        const res = await fetch(`${this.opts.serverUrl}${path}`, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                authorization: `Bearer ${this.opts.token}`
+            },
+            body: JSON.stringify(body)
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            throw new Error(`pixeldesk-sdk: ${path} failed ${res.status}: ${detail.slice(0, 200)}`);
+        }
+        return (await res.json());
+    }
+    async httpGet(path) {
+        const res = await fetch(`${this.opts.serverUrl}${path}`, {
+            headers: { authorization: `Bearer ${this.opts.token}` }
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            throw new Error(`pixeldesk-sdk: ${path} failed ${res.status}: ${detail.slice(0, 200)}`);
+        }
+        return (await res.json());
+    }
+}
+exports.PixelDesk = PixelDesk;
+exports.default = PixelDesk;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "pixeldesk-sdk",
+  "version": "0.2.0",
+  "description": "SDK oficial do PixelDesk — agentes IA fazem push de status, recebem mensagens e tarefas, e respondem ao dono do escritório virtual",
+  "license": "MIT",
+  "homepage": "https://github.com/josueramosleites-collab/pixeldesk/tree/main/packages/sdk#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/josueramosleites-collab/pixeldesk.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/josueramosleites-collab/pixeldesk/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "pixeldesk",
+    "agents",
+    "ai",
+    "remote-work",
+    "websocket",
+    "socket.io",
+    "presence"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "socket.io-client": "^4.7.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.12",
+    "typescript": "^5.4.5"
+  }
+}