@teeras/afterhours-mcp 0.1.0

package/README.md

@@ -0,0 +1,27 @@
+# Teeras Afterhours MCP
+
+Connect an account first with `npx @teeras/afterhours`. Activity tools refuse
+to scan local agent histories until that Google-backed Teeras connection exists.
+
+An optional, read-only local MCP adapter for Teeras Afterhours.
+
+```json
+{
+  "mcpServers": {
+    "afterhours": {
+      "command": "npx",
+      "args": ["-y", "@teeras/afterhours-mcp"]
+    }
+  }
+}
+```
+
+It gives a coding agent three local tools:
+
+- `afterhours_week` — the human's current AI-life balance and one boundary
+- `afterhours_sources` — detected coding-agent apps and data fidelity
+- `afterhours_privacy` — the exact retained/never-retained contract
+
+The MCP server does not expose prompt text, code, outputs, repositories, working
+directories, or file paths. It has no write tools and makes no network or LLM
+calls. The collector remains independently useful without MCP.

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createAfterhoursServer } from "./server.js";
+const server = createAfterhoursServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;AACxC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createAfterhoursServer } from "./server.js";
+export { afterhoursPrivacy, afterhoursSources, afterhoursWeek, type WeekResult } from "./tools.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,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createAfterhoursServer } from "./server.js";
+export { afterhoursPrivacy, afterhoursSources, afterhoursWeek } from "./tools.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,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAmB,MAAM,YAAY,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createAfterhoursServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,sBAAsB,IAAI,SAAS,CAkClD"}

package/dist/server.js

@@ -0,0 +1,25 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { afterhoursPrivacy, afterhoursSources, afterhoursWeek } from "./tools.js";
+function text(value) {
+    return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };
+}
+export function createAfterhoursServer() {
+    const server = new McpServer({ name: "teeras-afterhours", version: "0.1.0" });
+    server.registerTool("afterhours_week", {
+        description: "Read the human's private local AI-life-balance report. Use it to protect their stop time and reduce needless supervision—not to optimize them for more work.",
+        inputSchema: {
+            stopHour: z.number().int().min(18).max(23).optional().describe("The human's local planned stop hour."),
+        },
+    }, ({ stopHour }) => text(afterhoursWeek(stopHour)));
+    server.registerTool("afterhours_sources", {
+        description: "List locally detected coding-agent apps and the fidelity available from each source.",
+        inputSchema: {},
+    }, () => text(afterhoursSources()));
+    server.registerTool("afterhours_privacy", {
+        description: "Read the immutable local data boundary: what Afterhours retains and never retains.",
+        inputSchema: {},
+    }, () => text(afterhoursPrivacy()));
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElF,SAAS,IAAI,CAAC,KAAc;IAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAE9E,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,8JAA8J;QAChK,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SACvG;KACF,EACD,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CACjD,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EAAE,sFAAsF;QACnG,WAAW,EAAE,EAAE;KAChB,EACD,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAChC,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EAAE,oFAAoF;QACjG,WAAW,EAAE,EAAE;KAChB,EACD,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAChC,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,14 @@
+import { detectCodingAgents, type AfterhoursReport, type AfterhoursSnapshot } from "@teeras/afterhours";
+export interface WeekResult {
+    report: AfterhoursReport;
+    generatedAt: string;
+    note: string;
+}
+export declare function afterhoursWeek(stopHour?: number): WeekResult;
+export declare function afterhoursSources(): {
+    generatedAt: string;
+    sources: Array<Pick<AfterhoursSnapshot["sources"][number], "id" | "name" | "configured" | "fidelity" | "sessions">>;
+    detected: ReturnType<typeof detectCodingAgents>;
+};
+export declare function afterhoursPrivacy(): AfterhoursSnapshot["boundary"];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,kBAAkB,EAGlB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAQ5B,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,cAAc,CAAC,QAAQ,SAAK,GAAG,UAAU,CAQxD;AAED,wBAAgB,iBAAiB,IAAI;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC;IACpH,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;CACjD,CAcA;AAED,wBAAgB,iBAAiB,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAElE"}

package/dist/tools.js

@@ -0,0 +1,34 @@
+import { collectAfterhours, DATA_BOUNDARY, detectCodingAgents, readCredentials, reportFrom, } from "@teeras/afterhours";
+function requireAccount() {
+    if (!readCredentials()) {
+        throw new Error("Afterhours needs a Teeras account. Run `npx @teeras/afterhours` once; it opens Google sign-in and returns here automatically.");
+    }
+}
+export function afterhoursWeek(stopHour = 22) {
+    requireAccount();
+    const snapshot = collectAfterhours();
+    return {
+        report: reportFrom(snapshot, stopHour),
+        generatedAt: snapshot.generatedAt,
+        note: "Use this to protect the human's boundary, never to rank, shame, or increase output.",
+    };
+}
+export function afterhoursSources() {
+    requireAccount();
+    const snapshot = collectAfterhours();
+    return {
+        generatedAt: snapshot.generatedAt,
+        sources: snapshot.sources.map((source) => ({
+            id: source.id,
+            name: source.name,
+            configured: source.configured,
+            fidelity: source.fidelity,
+            sessions: source.sessions,
+        })),
+        detected: detectCodingAgents().filter((agent) => agent.installed),
+    };
+}
+export function afterhoursPrivacy() {
+    return DATA_BOUNDARY;
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,UAAU,GAGX,MAAM,oBAAoB,CAAC;AAE5B,SAAS,cAAc;IACrB,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,+HAA+H,CAAC,CAAC;IACnJ,CAAC;AACH,CAAC;AAQD,MAAM,UAAU,cAAc,CAAC,QAAQ,GAAG,EAAE;IAC1C,cAAc,EAAE,CAAC;IACjB,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACtC,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,IAAI,EAAE,qFAAqF;KAC5F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAK/B,cAAc,EAAE,CAAC;IACjB,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACzC,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;QACH,QAAQ,EAAE,kBAAkB,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@teeras/afterhours-mcp",
+  "version": "0.1.0",
+  "description": "Account-gated MCP tools for private coding-agent usage and AI-life balance.",
+  "homepage": "https://teeras.com",
+  "keywords": [
+    "mcp",
+    "coding-agents",
+    "ai-life-balance",
+    "codex",
+    "claude-code",
+    "developer-wellbeing"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "afterhours-mcp": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "prebuild": "npm run build -w @teeras/afterhours",
+    "build": "tsc -p tsconfig.build.json",
+    "pretypecheck": "npm run build -w @teeras/afterhours",
+    "typecheck": "tsc --noEmit",
+    "pretest": "npm run build -w @teeras/afterhours",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@teeras/afterhours": "^0.1.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
+  }
+}