@hasna/terminal 4.3.2 → 4.3.3

package/dist/db/pg-migrations.js

@@ -0,0 +1,70 @@
+/**
+ * PostgreSQL migrations for open-terminal cloud sync.
+ *
+ * Equivalent to the SQLite schema in sessions-db.ts, translated for PostgreSQL.
+ */
+export const PG_MIGRATIONS = [
+    // Migration 1: sessions table
+    `CREATE TABLE IF NOT EXISTS sessions (
+    id TEXT PRIMARY KEY,
+    started_at BIGINT NOT NULL,
+    ended_at BIGINT,
+    cwd TEXT NOT NULL,
+    provider TEXT,
+    model TEXT
+  )`,
+    // Migration 2: interactions table
+    `CREATE TABLE IF NOT EXISTS interactions (
+    id SERIAL PRIMARY KEY,
+    session_id TEXT NOT NULL REFERENCES sessions(id),
+    nl TEXT NOT NULL,
+    command TEXT,
+    output TEXT,
+    exit_code INTEGER,
+    tokens_used INTEGER DEFAULT 0,
+    tokens_saved INTEGER DEFAULT 0,
+    duration_ms INTEGER,
+    model TEXT,
+    cached BOOLEAN DEFAULT FALSE,
+    created_at BIGINT NOT NULL
+  )`,
+    // Migration 3: indexes on interactions and sessions
+    `CREATE INDEX IF NOT EXISTS idx_interactions_session ON interactions(session_id)`,
+    `CREATE INDEX IF NOT EXISTS idx_sessions_started ON sessions(started_at)`,
+    // Migration 4: corrections table
+    `CREATE TABLE IF NOT EXISTS corrections (
+    id SERIAL PRIMARY KEY,
+    prompt TEXT NOT NULL,
+    failed_command TEXT NOT NULL,
+    error_output TEXT,
+    corrected_command TEXT NOT NULL,
+    worked BOOLEAN DEFAULT TRUE,
+    error_type TEXT,
+    created_at BIGINT NOT NULL
+  )`,
+    // Migration 5: outputs table
+    `CREATE TABLE IF NOT EXISTS outputs (
+    id SERIAL PRIMARY KEY,
+    session_id TEXT,
+    command TEXT NOT NULL,
+    raw_output_path TEXT,
+    compressed_summary TEXT,
+    tokens_raw INTEGER DEFAULT 0,
+    tokens_compressed INTEGER DEFAULT 0,
+    provider TEXT,
+    model TEXT,
+    created_at BIGINT NOT NULL
+  )`,
+    // Migration 6: index on corrections
+    `CREATE INDEX IF NOT EXISTS idx_corrections_prompt ON corrections(prompt)`,
+    // Migration 7: feedback table
+    `CREATE TABLE IF NOT EXISTS feedback (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    message TEXT NOT NULL,
+    email TEXT,
+    category TEXT DEFAULT 'general',
+    version TEXT,
+    machine_id TEXT,
+    created_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+];

package/dist/mcp/server.js

@@ -1,6 +1,7 @@
 // MCP Server for terminal — exposes terminal capabilities to AI agents
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
 import { createSession } from "../sessions-db.js";
 import { createHelpers } from "./tools/helpers.js";
 // Tool registration modules
@@ -45,6 +46,39 @@ export function createServer() {
     registerMemoryTools(server, h);
     registerMetaTools(server, h);
     registerCloudTools(server, "terminal");
+    // ── Agent Tools ──────────────────────────────────────────────────────────
+    const _agentReg = new Map();
+    server.tool("register_agent", "Register an agent session (idempotent). Auto-updates last_seen_at on re-register.", { name: z.string(), session_id: z.string().optional() }, async (a) => {
+        const existing = [..._agentReg.values()].find(x => x.name === a.name);
+        if (existing) {
+            existing.last_seen_at = new Date().toISOString();
+            return { content: [{ type: "text", text: JSON.stringify(existing) }] };
+        }
+        const id = Math.random().toString(36).slice(2, 10);
+        const ag = { id, name: a.name, last_seen_at: new Date().toISOString() };
+        _agentReg.set(id, ag);
+        return { content: [{ type: "text", text: JSON.stringify(ag) }] };
+    });
+    server.tool("heartbeat", "Update last_seen_at to signal agent is active.", { agent_id: z.string() }, async (a) => {
+        const ag = _agentReg.get(a.agent_id);
+        if (!ag)
+            return { content: [{ type: "text", text: `Agent not found: ${a.agent_id}` }], isError: true };
+        ag.last_seen_at = new Date().toISOString();
+        return { content: [{ type: "text", text: JSON.stringify({ id: ag.id, name: ag.name, last_seen_at: ag.last_seen_at }) }] };
+    });
+    server.tool("set_focus", "Set active project context for this agent session.", { agent_id: z.string(), project_id: z.string().nullable().optional() }, async (a) => {
+        const ag = _agentReg.get(a.agent_id);
+        if (!ag)
+            return { content: [{ type: "text", text: `Agent not found: ${a.agent_id}` }], isError: true };
+        ag.project_id = a.project_id ?? undefined;
+        return { content: [{ type: "text", text: a.project_id ? `Focus: ${a.project_id}` : "Focus cleared" }] };
+    });
+    server.tool("list_agents", "List all registered agents.", {}, async () => {
+        const agents = [..._agentReg.values()];
+        if (agents.length === 0)
+            return { content: [{ type: "text", text: "No agents registered." }] };
+        return { content: [{ type: "text", text: JSON.stringify(agents, null, 2) }] };
+    });
     return server;
 }
 // ── main: start MCP server via stdio ─────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/terminal",
-  "version": "4.3.2",
+  "version": "4.3.3",
   "description": "Smart terminal wrapper for AI agents and humans — structured output, token compression, MCP server, natural language",
   "type": "module",
   "files": [

package/src/db/pg-migrations.ts

@@ -0,0 +1,77 @@
+/**
+ * PostgreSQL migrations for open-terminal cloud sync.
+ *
+ * Equivalent to the SQLite schema in sessions-db.ts, translated for PostgreSQL.
+ */
+
+export const PG_MIGRATIONS: string[] = [
+  // Migration 1: sessions table
+  `CREATE TABLE IF NOT EXISTS sessions (
+    id TEXT PRIMARY KEY,
+    started_at BIGINT NOT NULL,
+    ended_at BIGINT,
+    cwd TEXT NOT NULL,
+    provider TEXT,
+    model TEXT
+  )`,
+
+  // Migration 2: interactions table
+  `CREATE TABLE IF NOT EXISTS interactions (
+    id SERIAL PRIMARY KEY,
+    session_id TEXT NOT NULL REFERENCES sessions(id),
+    nl TEXT NOT NULL,
+    command TEXT,
+    output TEXT,
+    exit_code INTEGER,
+    tokens_used INTEGER DEFAULT 0,
+    tokens_saved INTEGER DEFAULT 0,
+    duration_ms INTEGER,
+    model TEXT,
+    cached BOOLEAN DEFAULT FALSE,
+    created_at BIGINT NOT NULL
+  )`,
+
+  // Migration 3: indexes on interactions and sessions
+  `CREATE INDEX IF NOT EXISTS idx_interactions_session ON interactions(session_id)`,
+  `CREATE INDEX IF NOT EXISTS idx_sessions_started ON sessions(started_at)`,
+
+  // Migration 4: corrections table
+  `CREATE TABLE IF NOT EXISTS corrections (
+    id SERIAL PRIMARY KEY,
+    prompt TEXT NOT NULL,
+    failed_command TEXT NOT NULL,
+    error_output TEXT,
+    corrected_command TEXT NOT NULL,
+    worked BOOLEAN DEFAULT TRUE,
+    error_type TEXT,
+    created_at BIGINT NOT NULL
+  )`,
+
+  // Migration 5: outputs table
+  `CREATE TABLE IF NOT EXISTS outputs (
+    id SERIAL PRIMARY KEY,
+    session_id TEXT,
+    command TEXT NOT NULL,
+    raw_output_path TEXT,
+    compressed_summary TEXT,
+    tokens_raw INTEGER DEFAULT 0,
+    tokens_compressed INTEGER DEFAULT 0,
+    provider TEXT,
+    model TEXT,
+    created_at BIGINT NOT NULL
+  )`,
+
+  // Migration 6: index on corrections
+  `CREATE INDEX IF NOT EXISTS idx_corrections_prompt ON corrections(prompt)`,
+
+  // Migration 7: feedback table
+  `CREATE TABLE IF NOT EXISTS feedback (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    message TEXT NOT NULL,
+    email TEXT,
+    category TEXT DEFAULT 'general',
+    version TEXT,
+    machine_id TEXT,
+    created_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+];

package/src/mcp/server.ts

@@ -2,6 +2,7 @@
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
 import { createSession } from "../sessions-db.js";
 import { createHelpers } from "./tools/helpers.js";
 
@@ -52,6 +53,58 @@ export function createServer(): McpServer {
   registerMetaTools(server, h);
   registerCloudTools(server, "terminal");
 
+  // ── Agent Tools ──────────────────────────────────────────────────────────
+  const _agentReg = new Map<string, { id: string; name: string; last_seen_at: string; project_id?: string }>();
+
+  server.tool(
+    "register_agent",
+    "Register an agent session (idempotent). Auto-updates last_seen_at on re-register.",
+    { name: z.string(), session_id: z.string().optional() },
+    async (a) => {
+      const existing = [..._agentReg.values()].find(x => x.name === a.name);
+      if (existing) { existing.last_seen_at = new Date().toISOString(); return { content: [{ type: "text" as const, text: JSON.stringify(existing) }] }; }
+      const id = Math.random().toString(36).slice(2, 10);
+      const ag = { id, name: a.name, last_seen_at: new Date().toISOString() };
+      _agentReg.set(id, ag);
+      return { content: [{ type: "text" as const, text: JSON.stringify(ag) }] };
+    }
+  );
+
+  server.tool(
+    "heartbeat",
+    "Update last_seen_at to signal agent is active.",
+    { agent_id: z.string() },
+    async (a) => {
+      const ag = _agentReg.get(a.agent_id);
+      if (!ag) return { content: [{ type: "text" as const, text: `Agent not found: ${a.agent_id}` }], isError: true };
+      ag.last_seen_at = new Date().toISOString();
+      return { content: [{ type: "text" as const, text: JSON.stringify({ id: ag.id, name: ag.name, last_seen_at: ag.last_seen_at }) }] };
+    }
+  );
+
+  server.tool(
+    "set_focus",
+    "Set active project context for this agent session.",
+    { agent_id: z.string(), project_id: z.string().nullable().optional() },
+    async (a) => {
+      const ag = _agentReg.get(a.agent_id);
+      if (!ag) return { content: [{ type: "text" as const, text: `Agent not found: ${a.agent_id}` }], isError: true };
+      (ag as any).project_id = a.project_id ?? undefined;
+      return { content: [{ type: "text" as const, text: a.project_id ? `Focus: ${a.project_id}` : "Focus cleared" }] };
+    }
+  );
+
+  server.tool(
+    "list_agents",
+    "List all registered agents.",
+    {},
+    async () => {
+      const agents = [..._agentReg.values()];
+      if (agents.length === 0) return { content: [{ type: "text" as const, text: "No agents registered." }] };
+      return { content: [{ type: "text" as const, text: JSON.stringify(agents, null, 2) }] };
+    }
+  );
+
   return server;
 }