agentclick 0.1.0 → 0.1.1

package/AGENTS.md

@@ -132,10 +132,12 @@ Read `docs/dev-rules.md` before writing any code. Key rules:
 - Minimal CI build workflow (GitHub Actions: `npm ci && npm run build`)
 - Deployment guide (`docs/deployment.md`) for single-port runtime, env vars, reverse proxy, and Docker/OpenClaw notes
 - Global CLI packaging entrypoint (`bin/agentclick.mjs`) for `agentclick` command startup
+- npm package published: `agentclick@0.1.0`
+- CC suggestions checkbox UI (returns selected suggestions in review completion payload)
+- Summary view fetches `/api/sessions/:id/summary` and renders mock summary response (backend endpoint included)
 
 **Pending:**
-- npm publish execution (`npm publish`) after final package review
-- CC suggestions as checkboxes (currently free-text input; agent can pass `ccSuggestions[]`)
+- Replace mock summary endpoint with real agent-generated summaries
 
 ---
 

package/README.md

@@ -69,6 +69,15 @@ agentclick
 
 This starts the AgentClick server on `http://localhost:3001` and serves the built web UI on the same port.
 
+CLI options:
+
+```bash
+agentclick --help
+PORT=3002 agentclick
+```
+
+By default, `agentclick` starts on port `3001`. If that port is in use, it automatically tries `3002`, `3003`, and so on.
+
 Optional server config (defaults shown in `.env.example`):
 
 ```bash

package/bin/agentclick.mjs

@@ -4,11 +4,39 @@ import { existsSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { spawnSync } from 'node:child_process'
+import net from 'node:net'
 
 const __filename = fileURLToPath(import.meta.url)
 const rootDir = dirname(dirname(__filename))
 const webDistIndex = join(rootDir, 'packages', 'web', 'dist', 'index.html')
 const serverDistEntry = join(rootDir, 'packages', 'server', 'dist', 'index.js')
+const args = process.argv.slice(2)
+
+function printHelp() {
+  console.log(`AgentClick CLI
+
+Usage:
+  agentclick
+  agentclick --help
+
+Options:
+  --help, -h   Show this help message
+`)
+}
+
+function parseArgs(argv) {
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i]
+    if (arg === '--help' || arg === '-h') {
+      printHelp()
+      process.exit(0)
+    }
+    console.error(`[agentclick] Unknown argument: ${arg}`)
+    console.error('[agentclick] Run "agentclick --help" for usage.')
+    process.exit(1)
+  }
+  return {}
+}
 
 function run(command, args) {
   const result = spawnSync(command, args, {
@@ -25,6 +53,8 @@ function run(command, args) {
   }
 }
 
+parseArgs(args)
+
 if (!existsSync(webDistIndex) || !existsSync(serverDistEntry)) {
   console.log('[agentclick] Build artifacts not found, running npm run build...')
   const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm'
@@ -36,4 +66,48 @@ if (!existsSync(serverDistEntry)) {
   process.exit(1)
 }
 
-run(process.execPath, [serverDistEntry])
+async function canListen(port) {
+  return await new Promise(resolve => {
+    const server = net.createServer()
+    server.once('error', err => {
+      if ((err).code === 'EADDRINUSE') {
+        resolve(false)
+        return
+      }
+      console.error(`[agentclick] Port check failed for ${port}: ${err.message}`)
+      process.exit(1)
+    })
+    server.once('listening', () => {
+      server.close(() => resolve(true))
+    })
+    server.listen(port)
+  })
+}
+
+async function resolvePort() {
+  if (process.env.PORT) return process.env.PORT
+
+  let port = 3001
+  while (true) {
+    const available = await canListen(port)
+    if (available) return String(port)
+    console.log(`[agentclick] Port ${port} in use, trying ${port + 1}...`)
+    port += 1
+  }
+}
+
+const childEnv = { ...process.env }
+childEnv.PORT = await resolvePort()
+
+const result = spawnSync(process.execPath, [serverDistEntry], {
+  cwd: rootDir,
+  stdio: 'inherit',
+  env: childEnv,
+})
+if (result.error) {
+  console.error('[agentclick] Failed to start server:', result.error.message)
+  process.exit(1)
+}
+if (typeof result.status === 'number' && result.status !== 0) {
+  process.exit(result.status)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentclick",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "bin": {
     "agentclick": "./bin/agentclick.mjs"
   },

package/packages/server/dist/index.js

@@ -74,6 +74,35 @@ app.get('/api/sessions/:id', (req, res) => {
         return res.status(404).json({ error: 'Session not found' });
     res.json(session);
 });
+// Mock summary endpoint for inbox items (UI integration first)
+app.get('/api/sessions/:id/summary', (req, res) => {
+    const session = getSession(req.params.id);
+    if (!session)
+        return res.status(404).json({ error: 'Session not found' });
+    const payload = session.payload;
+    const inbox = payload?.inbox ?? [];
+    const emailId = req.query.emailId;
+    const email = inbox.find(item => item.id === emailId);
+    if (!email) {
+        return res.status(404).json({ error: 'Email not found in session' });
+    }
+    const preview = String(email.preview ?? '');
+    const summaryText = preview.length > 0
+        ? `This email appears to be about: ${preview}`
+        : 'No preview text is available for this email yet.';
+    const from = String(email.from ?? 'Unknown sender');
+    const category = String(email.category ?? 'Unknown');
+    res.json({
+        emailId,
+        summary: summaryText,
+        bullets: [
+            `From: ${from}`,
+            `Category: ${category}`,
+            'Source: mock summary endpoint (replace with agent summary later)',
+        ],
+        confidence: 'mock',
+    });
+});
 // Long-poll: agent calls this and blocks until user completes review (up to 5 min)
 app.get('/api/sessions/:id/wait', async (req, res) => {
     const TIMEOUT_MS = 5 * 60 * 1000;

package/packages/server/src/index.ts

@@ -83,6 +83,40 @@ app.get('/api/sessions/:id', (req, res) => {
   res.json(session)
 })
 
+// Mock summary endpoint for inbox items (UI integration first)
+app.get('/api/sessions/:id/summary', (req, res) => {
+  const session = getSession(req.params.id)
+  if (!session) return res.status(404).json({ error: 'Session not found' })
+
+  const payload = session.payload as Record<string, unknown> | undefined
+  const inbox = (payload?.inbox as Array<Record<string, unknown>> | undefined) ?? []
+  const emailId = req.query.emailId as string | undefined
+  const email = inbox.find(item => item.id === emailId)
+
+  if (!email) {
+    return res.status(404).json({ error: 'Email not found in session' })
+  }
+
+  const preview = String(email.preview ?? '')
+  const summaryText = preview.length > 0
+    ? `This email appears to be about: ${preview}`
+    : 'No preview text is available for this email yet.'
+
+  const from = String(email.from ?? 'Unknown sender')
+  const category = String(email.category ?? 'Unknown')
+
+  res.json({
+    emailId,
+    summary: summaryText,
+    bullets: [
+      `From: ${from}`,
+      `Category: ${category}`,
+      'Source: mock summary endpoint (replace with agent summary later)',
+    ],
+    confidence: 'mock',
+  })
+})
+
 // Long-poll: agent calls this and blocks until user completes review (up to 5 min)
 app.get('/api/sessions/:id/wait', async (req, res) => {
   const TIMEOUT_MS = 5 * 60 * 1000