@gracefultools/astrid-sdk 0.7.15 → 0.8.0

package/README.md

@@ -1,341 +1,127 @@
-# @gracefultools/astrid-sdk
-
-AI agent SDK for automated coding tasks with Claude, OpenAI, and Gemini.
-
-## Installation
-
-```bash
-npm install -g @gracefultools/astrid-sdk
-```
-
-## Quick Start
-
-### Three Execution Modes
-
-| Mode | Command | Best For |
-|------|---------|----------|
-| **API** | `npx astrid-agent` | Cloud execution via Claude Agent SDK API |
-| **Terminal** | `npx astrid-agent --terminal` | Local Claude Code CLI (remote control) |
-| **Webhook** | `npx astrid-agent serve` | Always-on servers (fly.io, VPS, AWS) |
-
-### Terminal Mode (Remote Control Your Local Claude Code)
-
-Uses your local Claude Code CLI to process tasks. Enables remote control of your local Claude Code from Astrid.
-
-```bash
-# Prerequisites: Install Claude Code CLI
-npm install -g @anthropic-ai/claude-code
-
-# Set up environment
-export ANTHROPIC_API_KEY=sk-ant-...
-export ASTRID_OAUTH_CLIENT_ID=your_client_id
-export ASTRID_OAUTH_CLIENT_SECRET=your_client_secret
-export ASTRID_OAUTH_LIST_ID=your_list_id
-
-# Start in terminal mode
-cd /your/project
-npx astrid-agent --terminal
-
-# With options
-npx astrid-agent --terminal --model=sonnet --cwd=/path/to/project --max-turns=100
-
-# Or via environment variable
-ASTRID_TERMINAL_MODE=true npx astrid-agent
-```
-
-**How it works:**
-1. Agent polls Astrid for tasks assigned to AI agents
-2. When a task is found, it spawns the local Claude Code CLI with `--print`
-3. Claude Code executes in your project directory
-4. Results are posted back to Astrid as comments
-5. Session IDs are stored for resumption support
-
-### API Mode (Default)
-
-Uses Claude Agent SDK API for cloud execution. Best for CI/CD and servers.
-
-```bash
-# Set up environment
-export ANTHROPIC_API_KEY=sk-ant-...
-export ASTRID_OAUTH_CLIENT_ID=your_client_id
-export ASTRID_OAUTH_CLIENT_SECRET=your_client_secret
-export ASTRID_OAUTH_LIST_ID=your_list_id
-
-# Start polling for tasks (API mode)
-npx astrid-agent
-```
-
-### Webhook Mode (For Always-On Servers)
-
-Receives instant task notifications via webhook. Requires a permanent IP or domain.
-
-```bash
-# Set up environment
-export ANTHROPIC_API_KEY=sk-ant-...
-export ASTRID_WEBHOOK_SECRET=your_webhook_secret
-
-# Start webhook server
-npx astrid-agent serve --port=3001
-
-# Optional: Install express for the server
-npm install express
-```
-
-Then configure your webhook URL in Astrid Settings.
-
-## Environment Variables
-
-| Variable | Mode | Description |
-|----------|------|-------------|
-| **AI Providers** | All | |
-| `ANTHROPIC_API_KEY` | All | Anthropic API key (for Claude) |
-| `OPENAI_API_KEY` | All | OpenAI API key |
-| `GEMINI_API_KEY` | All | Google Gemini API key |
-| **Polling/Terminal Mode** | Polling, Terminal | |
-| `ASTRID_OAUTH_CLIENT_ID` | Polling, Terminal | OAuth client ID from Astrid |
-| `ASTRID_OAUTH_CLIENT_SECRET` | Polling, Terminal | OAuth client secret |
-| `ASTRID_OAUTH_LIST_ID` | Polling, Terminal | List ID to monitor for tasks |
-| **Terminal Mode** | Terminal | |
-| `ASTRID_TERMINAL_MODE` | Terminal | Enable terminal mode (or use --terminal flag) |
-| `CLAUDE_MODEL` | Terminal | Model to use (default: opus) |
-| `CLAUDE_MAX_TURNS` | Terminal | Max turns per execution (default: 50) |
-| `DEFAULT_PROJECT_PATH` | Terminal | Project directory (default: current dir) |
-| **Webhook Mode** | Webhook | |
-| `ASTRID_WEBHOOK_SECRET` | Webhook | Secret from Astrid webhook settings |
-| `ASTRID_CALLBACK_URL` | Webhook | Optional callback URL |
-| **Other** | All | |
-| `GITHUB_TOKEN` | All | GitHub token for cloning private repos |
-| `POLL_INTERVAL_MS` | Polling, Terminal | Poll interval (default: 30000) |
-| `MAX_BUDGET_USD` | API | Max budget per task (default: 10.0) |
-| **Agent Workflow** | Terminal | |
-| `ASTRID_AGENT_CREATE_BRANCH` | Terminal | Create feature branches (default: true) |
-| `ASTRID_AGENT_CREATE_PR` | Terminal | Create pull requests (default: true) |
-| `ASTRID_AGENT_BRANCH_PREFIX` | Terminal | Branch name prefix (default: "task/") |
-| `ASTRID_AGENT_RUN_TESTS` | Terminal | Run tests before committing (default: true) |
-| `ASTRID_AGENT_TEST_COMMAND` | Terminal | Test command (default: "npm run predeploy") |
-| **Vercel Deployment** | Terminal | |
-| `ASTRID_AGENT_VERCEL_DEPLOY` | Terminal | Trigger Vercel preview deployment (default: true) |
-| `ASTRID_AGENT_VERCEL_USE_API` | Terminal | Use Vercel API instead of CLI (default: false) |
-| `ASTRID_AGENT_PREVIEW_DOMAIN` | Terminal | Domain for preview aliases (e.g., "astrid.cc") |
-| `ASTRID_AGENT_PREVIEW_PATTERN` | Terminal | Subdomain pattern (default: "{branch}") |
-| `VERCEL_TOKEN` | Terminal | Vercel API token for deployments |
-| `VERCEL_PROJECT_NAME` | Terminal | Vercel project name (auto-detected) |
-| `VERCEL_TEAM_ID` | Terminal | Vercel team ID (optional) |
-
-## Agent Workflow Configuration
-
-Control how AI agents create branches, PRs, and preview deployments via environment variables. No package update needed to change behavior.
-
-### Example: Full PR + Preview Workflow (Recommended)
-
-```bash
-# Git workflow
-export ASTRID_AGENT_CREATE_BRANCH=true    # Create feature branches
-export ASTRID_AGENT_CREATE_PR=true        # Create pull requests
-export ASTRID_AGENT_RUN_TESTS=true        # Run tests before commit
-
-# Vercel preview deployment
-export ASTRID_AGENT_VERCEL_DEPLOY=true    # Deploy to Vercel
-export ASTRID_AGENT_PREVIEW_DOMAIN=astrid.cc  # Custom subdomain (for passkey support)
-export VERCEL_TOKEN=your-vercel-token     # Required for deployment
-export GITHUB_TOKEN=your-github-token     # Required for PR creation
-```
-
-### Example: Direct to Main (No PR)
-
-```bash
-export ASTRID_AGENT_CREATE_BRANCH=false
-export ASTRID_AGENT_CREATE_PR=false
-export ASTRID_AGENT_VERCEL_DEPLOY=false
-```
-
-### Preview URL Configuration
-
-When `ASTRID_AGENT_PREVIEW_DOMAIN` is set (e.g., `astrid.cc`), preview URLs are aliased to subdomains:
-
-- Branch: `task/abc12345` → Preview URL: `https://task-abc12345.astrid.cc`
-
-This is required for features that need same-origin (passkeys, Google OAuth cookies).
-
-### Programmatic Configuration
-
-```typescript
-import {
-  getAgentWorkflowConfig,
-  validateWorkflowConfig,
-  logWorkflowConfig,
-  deployToVercel,
-} from '@gracefultools/astrid-sdk'
-
-// Get current config (reads from env)
-const config = getAgentWorkflowConfig()
-
-// Validate config
-const { valid, errors, warnings } = validateWorkflowConfig()
-if (!valid) {
-  console.error('Config errors:', errors)
-}
-
-// Log config for debugging
-logWorkflowConfig()
-
-// Deploy to Vercel manually
-const result = await deployToVercel('task/abc12345', '/path/to/project')
-console.log('Preview URL:', result.previewUrl)
-```
-
-## Supported AI Providers
-
-The SDK automatically routes tasks to the correct provider based on the assignee email:
-
-| Agent Email | Provider | Model |
-|-------------|----------|-------|
-| `claude@astrid.cc` | Claude | claude-sonnet-4 |
-| `openai@astrid.cc` | OpenAI | gpt-4o |
-| `gemini@astrid.cc` | Gemini | gemini-2.0-flash |
-
-## Deployment Examples
-
-### Fly.io (Webhook Mode)
-
-```toml
-# fly.toml
-app = "astrid-agent"
-primary_region = "iad"
-
-[http_service]
-  internal_port = 3001
-
-[env]
-  PORT = "3001"
-```
-
-```bash
-fly secrets set ANTHROPIC_API_KEY=sk-ant-...
-fly secrets set ASTRID_WEBHOOK_SECRET=...
-fly deploy
-```
-
-### Docker (Webhook Mode)
-
-```dockerfile
-FROM node:20-slim
-RUN npm install -g @gracefultools/astrid-sdk express
-WORKDIR /app
-EXPOSE 3001
-CMD ["npx", "astrid-agent", "serve", "--port=3001"]
-```
-
-### PM2 (Polling Mode)
-
-```bash
-# ecosystem.config.js
-module.exports = {
-  apps: [{
-    name: 'astrid-agent',
-    script: 'npx',
-    args: 'astrid-agent',
-    env: {
-      ANTHROPIC_API_KEY: 'sk-ant-...',
-      ASTRID_OAUTH_CLIENT_ID: '...',
-      ASTRID_OAUTH_CLIENT_SECRET: '...',
-      ASTRID_OAUTH_LIST_ID: '...'
-    }
-  }]
-}
-```
-
-## Programmatic Usage
-
-```typescript
-import {
-  planWithClaude,
-  executeWithClaude,
-  AstridOAuthClient,
-} from '@gracefultools/astrid-sdk'
-
-// Connect to Astrid
-const client = new AstridOAuthClient({
-  clientId: process.env.ASTRID_OAUTH_CLIENT_ID,
-  clientSecret: process.env.ASTRID_OAUTH_CLIENT_SECRET,
-})
-
-// Get tasks
-const tasks = await client.getTasks(listId)
-
-// Plan implementation
-const planResult = await planWithClaude(
-  task.title,
-  task.description,
-  {
-    repoPath: '/path/to/repo',
-    apiKey: process.env.ANTHROPIC_API_KEY,
-    maxBudgetUsd: 5.0,
-    logger: console.log,
-    onProgress: (msg) => console.log(msg),
-  }
-)
-
-// Execute the plan
-if (planResult.success && planResult.plan) {
-  const execResult = await executeWithClaude(
-    planResult.plan,
-    task.title,
-    task.description,
-    config
-  )
-
-  console.log('Files modified:', execResult.files.length)
-}
-```
-
-## CLI Reference
-
-```bash
-# Show help
-npx astrid-agent --help
-
-# API mode (default - cloud execution)
-npx astrid-agent
-
-# Terminal mode (local Claude Code CLI)
-npx astrid-agent --terminal
-npx astrid-agent --terminal --model=sonnet --cwd=/path/to/project
-
-# Process a specific task
-npx astrid-agent <taskId>
-npx astrid-agent --terminal <taskId>
-
-# Webhook mode
-npx astrid-agent serve --port=3001
-```
-
-## Comparison: Terminal vs API vs Webhook
-
-| Feature | Terminal | API | Webhook |
-|---------|----------|-----|---------|
-| Execution | Local CLI | Cloud API | Cloud API |
-| Requires Claude Code CLI | Yes | No | No |
-| Permanent IP needed | No | No | Yes |
-| Works behind NAT | Yes | Yes | No |
-| Session resume | Yes | No | No |
-| Task notification | ~30s poll | ~30s poll | Instant |
-| Best for | Local dev | CI/CD, servers | Always-on servers |
-| Project access | Local files | Clones repo | Clones repo |
-
-## Updating
-
-```bash
-# Update to latest version
-npm update -g @gracefultools/astrid-sdk
-```
-
-## License
-
-MIT
-
-## Links
-
-- [Astrid](https://astrid.cc)
-- [Documentation](https://astrid.cc/docs)
-- [GitHub](https://github.com/Graceful-Tools/astrid-res-www)
+# @gracefultools/astrid-sdk
+
+SDK for integrating AI agents with [Astrid.cc](https://www.astrid.cc) task management.
+
+## Installation
+
+```bash
+npm install @gracefultools/astrid-sdk
+```
+
+## What's Included
+
+### OAuth API Client
+Full Astrid REST API client with OAuth2 client_credentials flow:
+
+```typescript
+import { AstridOAuthClient } from '@gracefultools/astrid-sdk'
+
+const client = new AstridOAuthClient({
+  clientId: 'your-client-id',
+  clientSecret: 'your-client-secret',
+})
+
+// Get assigned tasks
+const tasks = await client.getTasks({ completed: false })
+
+// Post a comment
+await client.addComment(taskId, 'Working on this now...')
+
+// Complete a task
+await client.updateTask(taskId, { completed: true })
+```
+
+### OpenClaw Channel Plugin
+Connect [OpenClaw](https://openclaw.ai) to Astrid as a task channel. Your agent receives tasks via SSE (outbound connection — works behind NAT/firewalls):
+
+```typescript
+import { AstridChannel, SSEClient, RestClient, SessionMapper, taskToMessage } from '@gracefultools/astrid-sdk'
+```
+
+#### How it works
+
+1. Agent connects **outbound** to `astrid.cc/api/v1/agent/events` (SSE)
+2. When a task is assigned → agent receives it in real-time
+3. **List description = agent instructions** — each list's description tells the agent how to handle tasks
+4. Agent posts results as task comments
+5. Agent marks task complete when done
+
+#### Quick Setup
+
+Add to your OpenClaw config:
+
+```json5
+{
+  channels: {
+    astrid: {
+      enabled: true,
+      clientId: "your-client-id",
+      clientSecret: "your-client-secret"
+    }
+  }
+}
+```
+
+### Agent Protocol
+
+The SDK uses the Astrid Agent Protocol:
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/v1/agent/events` | GET | SSE stream (task.assigned, task.commented, etc.) |
+| `/api/v1/agent/tasks` | GET | List assigned tasks |
+| `/api/v1/agent/tasks/:id` | GET/PATCH | Get or update a task |
+| `/api/v1/agent/tasks/:id/comments` | GET/POST | Read or post comments |
+
+All endpoints require OAuth Bearer token with appropriate scopes.
+
+### List Descriptions as Agent Instructions
+
+Each Astrid list's **description** field serves as instructions for AI agents:
+
+```markdown
+# Example "Code Reviews" list description:
+Review PRs for security issues, test coverage, and style.
+Post findings as comments. Mark complete when done.
+```
+
+When an agent receives a task from this list, the description is included as context. Different lists = different agent behaviors. No code changes needed.
+
+## Configuration
+
+### Agent Config
+```typescript
+import { getAgentConfig, isRegisteredAgent } from '@gracefultools/astrid-sdk'
+
+// Check if an email is a registered agent
+isRegisteredAgent('claude@astrid.cc')     // true
+isRegisteredAgent('mybot.oc@astrid.cc')   // true (OpenClaw pattern)
+
+// Get agent configuration
+const config = getAgentConfig('claude@astrid.cc')
+```
+
+### Workflow Config
+```typescript
+import { getAgentWorkflowConfig, buildWorkflowInstructions } from '@gracefultools/astrid-sdk'
+
+const config = getAgentWorkflowConfig(task, list, repository)
+const instructions = buildWorkflowInstructions(config)
+```
+
+## Changelog
+
+### 0.8.0
+- **Channel plugin**: OpenClaw integration via outbound SSE (no inbound gateway needed)
+- **Agent protocol**: SSE events, REST client, session mapper, message formatter
+- **Removed**: Built-in AI executors (Claude, OpenAI, Gemini) — agents run externally now
+- **Security**: Per-endpoint OAuth scope enforcement, comment rate limiting
+
+### 0.7.x
+- OAuth API client
+- Agent workflow configuration
+- Vercel deployment support
+
+## License
+
+MIT

package/dist/channel/channel.d.ts

@@ -0,0 +1,33 @@
+import type { AstridChannelConfig, InboundMessage, OutboundMessage } from './types.js';
+/**
+ * Astrid channel plugin for OpenClaw.
+ */
+export declare const astridChannel: {
+    id: "astrid";
+    meta: {
+        id: string;
+        label: string;
+        selectionLabel: string;
+        docsPath: string;
+        blurb: string;
+    };
+    capabilities: {
+        chatTypes: readonly ["direct"];
+        media: boolean;
+        reactions: boolean;
+        edit: boolean;
+        polls: boolean;
+    };
+    createAdapter(config: AstridChannelConfig): {
+        init(): Promise<void>;
+        connect(onMessage: (msg: InboundMessage) => void): Promise<void>;
+        disconnect(): Promise<void>;
+        send(msg: OutboundMessage): Promise<void>;
+        isConnected(): boolean;
+        getHealth(): {
+            connected: boolean;
+            activeSessions: number;
+        };
+    };
+};
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/channel/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAOtF;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;0BAmBF,mBAAmB;gBAOvB,OAAO,CAAC,IAAI,CAAC;2BAaF,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;sBAyBlD,OAAO,CAAC,IAAI,CAAC;kBAIjB,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;uBAShC,OAAO;;;;;;CAY3B,CAAA"}

package/dist/channel/channel.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.astridChannel = void 0;
+const oauth_client_js_1 = require("./oauth-client.js");
+const rest_client_js_1 = require("./rest-client.js");
+const sse_client_js_1 = require("./sse-client.js");
+const session_mapper_js_1 = require("./session-mapper.js");
+const message_formatter_js_1 = require("./message-formatter.js");
+/**
+ * Astrid channel plugin for OpenClaw.
+ */
+exports.astridChannel = {
+    id: 'astrid',
+    meta: {
+        id: 'astrid',
+        label: 'Astrid',
+        selectionLabel: 'Astrid.cc',
+        docsPath: '/channels/astrid',
+        blurb: 'Task management',
+    },
+    capabilities: {
+        chatTypes: ['direct'],
+        media: false,
+        reactions: false,
+        edit: false,
+        polls: false,
+    },
+    createAdapter(config) {
+        const oauth = new oauth_client_js_1.OAuthClient(config);
+        const rest = new rest_client_js_1.RestClient(config.apiBase, oauth);
+        const sse = new sse_client_js_1.SSEClient(config, oauth);
+        const sessions = new session_mapper_js_1.SessionMapper();
+        return {
+            async init() {
+                if (!config.clientId || !config.clientSecret) {
+                    throw new Error('Astrid channel: clientId and clientSecret are required');
+                }
+                await oauth.ensureToken();
+                // Recover existing sessions
+                const tasks = await rest.getAssignedTasks(false);
+                for (const task of tasks) {
+                    sessions.getOrCreate(task.id);
+                }
+            },
+            async connect(onMessage) {
+                sse.on('task.assigned', (event) => {
+                    if (!event.data.task)
+                        return;
+                    const msg = (0, message_formatter_js_1.taskToMessage)(event.data.task);
+                    sessions.getOrCreate(event.data.taskId);
+                    onMessage(msg);
+                });
+                sse.on('task.commented', (event) => {
+                    const sessionKey = sessions.get(event.data.taskId);
+                    if (!sessionKey || !event.data.comment)
+                        return;
+                    onMessage((0, message_formatter_js_1.commentToMessage)(event.data.taskId, event.data.comment));
+                });
+                sse.on('task.completed', (event) => {
+                    sessions.end(event.data.taskId);
+                });
+                sse.on('task.deleted', (event) => {
+                    sessions.end(event.data.taskId);
+                });
+                await sse.connect();
+            },
+            async disconnect() {
+                sse.disconnect();
+            },
+            async send(msg) {
+                const taskId = sessions.getTaskId(msg.sessionKey);
+                if (!taskId) {
+                    throw new Error(`No Astrid task mapped to session ${msg.sessionKey}`);
+                }
+                const content = (0, message_formatter_js_1.responseToComment)(msg);
+                await rest.postComment(taskId, content);
+            },
+            isConnected() {
+                return sse.isConnected();
+            },
+            getHealth() {
+                return {
+                    connected: sse.isConnected(),
+                    activeSessions: sessions.activeCount(),
+                };
+            },
+        };
+    },
+};
+//# sourceMappingURL=channel.js.map

package/dist/channel/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/channel/channel.ts"],"names":[],"mappings":";;;AACA,uDAA+C;AAC/C,qDAA6C;AAC7C,mDAA2C;AAC3C,2DAAmD;AACnD,iEAA2F;AAE3F;;GAEG;AACU,QAAA,aAAa,GAAG;IAC3B,EAAE,EAAE,QAAiB;IAErB,IAAI,EAAE;QACJ,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,QAAQ;QACf,cAAc,EAAE,WAAW;QAC3B,QAAQ,EAAE,kBAAkB;QAC5B,KAAK,EAAE,iBAAiB;KACzB;IAED,YAAY,EAAE;QACZ,SAAS,EAAE,CAAC,QAAQ,CAAU;QAC9B,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,KAAK;QAChB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,KAAK;KACb;IAED,aAAa,CAAC,MAA2B;QACvC,MAAM,KAAK,GAAG,IAAI,6BAAW,CAAC,MAAM,CAAC,CAAA;QACrC,MAAM,IAAI,GAAG,IAAI,2BAAU,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAClD,MAAM,GAAG,GAAG,IAAI,yBAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACxC,MAAM,QAAQ,GAAG,IAAI,iCAAa,EAAE,CAAA;QAEpC,OAAO;YACL,KAAK,CAAC,IAAI;gBACR,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;oBAC7C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;gBAC3E,CAAC;gBACD,MAAM,KAAK,CAAC,WAAW,EAAE,CAAA;gBAEzB,4BAA4B;gBAC5B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;gBAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBAC/B,CAAC;YACH,CAAC;YAED,KAAK,CAAC,OAAO,CAAC,SAAwC;gBACpD,GAAG,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;oBAChC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI;wBAAE,OAAM;oBAC5B,MAAM,GAAG,GAAG,IAAA,oCAAa,EAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBAC1C,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;oBACvC,SAAS,CAAC,GAAG,CAAC,CAAA;gBAChB,CAAC,CAAC,CAAA;gBAEF,GAAG,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;oBACjC,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;oBAClD,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO;wBAAE,OAAM;oBAC9C,SAAS,CAAC,IAAA,uCAAgB,EAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;gBACpE,CAAC,CAAC,CAAA;gBAEF,GAAG,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;oBACjC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACjC,CAAC,CAAC,CAAA;gBAEF,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE;oBAC/B,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACjC,CAAC,CAAC,CAAA;gBAEF,MAAM,GAAG,CAAC,OAAO,EAAE,CAAA;YACrB,CAAC;YAED,KAAK,CAAC,UAAU;gBACd,GAAG,CAAC,UAAU,EAAE,CAAA;YAClB,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,GAAoB;gBAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;gBACjD,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAA;gBACvE,CAAC;gBACD,MAAM,OAAO,GAAG,IAAA,wCAAiB,EAAC,GAAG,CAAC,CAAA;gBACtC,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YACzC,CAAC;YAED,WAAW;gBACT,OAAO,GAAG,CAAC,WAAW,EAAE,CAAA;YAC1B,CAAC;YAED,SAAS;gBACP,OAAO;oBACL,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;oBAC5B,cAAc,EAAE,QAAQ,CAAC,WAAW,EAAE;iBACvC,CAAA;YACH,CAAC;SACF,CAAA;IACH,CAAC;CACF,CAAA"}

package/dist/channel/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Astrid Channel Plugin for OpenClaw
+ *
+ * Connect OpenClaw to Astrid.cc via outbound SSE — no inbound gateway URL needed.
+ */
+export { astridChannel as AstridChannel } from './channel.js';
+export { SSEClient } from './sse-client.js';
+export { OAuthClient } from './oauth-client.js';
+export { RestClient } from './rest-client.js';
+export { SessionMapper } from './session-mapper.js';
+export { taskToMessage, commentToMessage, responseToComment } from './message-formatter.js';
+export type { AstridChannelConfig, AgentTask, AgentComment, AgentSSEEvent, InboundMessage, OutboundMessage, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channel/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,IAAI,aAAa,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC3F,YAAY,EACV,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAA"}

package/dist/channel/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Astrid Channel Plugin for OpenClaw
+ *
+ * Connect OpenClaw to Astrid.cc via outbound SSE — no inbound gateway URL needed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.responseToComment = exports.commentToMessage = exports.taskToMessage = exports.SessionMapper = exports.RestClient = exports.OAuthClient = exports.SSEClient = exports.AstridChannel = void 0;
+var channel_js_1 = require("./channel.js");
+Object.defineProperty(exports, "AstridChannel", { enumerable: true, get: function () { return channel_js_1.astridChannel; } });
+var sse_client_js_1 = require("./sse-client.js");
+Object.defineProperty(exports, "SSEClient", { enumerable: true, get: function () { return sse_client_js_1.SSEClient; } });
+var oauth_client_js_1 = require("./oauth-client.js");
+Object.defineProperty(exports, "OAuthClient", { enumerable: true, get: function () { return oauth_client_js_1.OAuthClient; } });
+var rest_client_js_1 = require("./rest-client.js");
+Object.defineProperty(exports, "RestClient", { enumerable: true, get: function () { return rest_client_js_1.RestClient; } });
+var session_mapper_js_1 = require("./session-mapper.js");
+Object.defineProperty(exports, "SessionMapper", { enumerable: true, get: function () { return session_mapper_js_1.SessionMapper; } });
+var message_formatter_js_1 = require("./message-formatter.js");
+Object.defineProperty(exports, "taskToMessage", { enumerable: true, get: function () { return message_formatter_js_1.taskToMessage; } });
+Object.defineProperty(exports, "commentToMessage", { enumerable: true, get: function () { return message_formatter_js_1.commentToMessage; } });
+Object.defineProperty(exports, "responseToComment", { enumerable: true, get: function () { return message_formatter_js_1.responseToComment; } });
+//# sourceMappingURL=index.js.map

package/dist/channel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channel/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAA6D;AAApD,2GAAA,aAAa,OAAiB;AACvC,iDAA2C;AAAlC,0GAAA,SAAS,OAAA;AAClB,qDAA+C;AAAtC,8GAAA,WAAW,OAAA;AACpB,mDAA6C;AAApC,4GAAA,UAAU,OAAA;AACnB,yDAAmD;AAA1C,kHAAA,aAAa,OAAA;AACtB,+DAA2F;AAAlF,qHAAA,aAAa,OAAA;AAAE,wHAAA,gBAAgB,OAAA;AAAE,yHAAA,iBAAiB,OAAA"}

package/dist/channel/message-formatter.d.ts

@@ -0,0 +1,14 @@
+import type { AgentTask, AgentComment, InboundMessage, OutboundMessage } from './types.js';
+/**
+ * Format an Astrid task as an OpenClaw inbound message.
+ */
+export declare function taskToMessage(task: AgentTask): InboundMessage;
+/**
+ * Format a human comment as a follow-up inbound message.
+ */
+export declare function commentToMessage(taskId: string, comment: AgentComment): InboundMessage;
+/**
+ * Strip agent response for posting as an Astrid comment.
+ */
+export declare function responseToComment(msg: OutboundMessage): string;
+//# sourceMappingURL=message-formatter.d.ts.map