palmier 0.8.11 → 0.9.2

package/README.md

@@ -78,7 +78,7 @@ Palmier exposes an [MCP](https://modelcontextprotocol.io) server at `http://loca
 
 Resources support MCP subscriptions — clients can subscribe via `resources/subscribe` and receive real-time `notifications/resources/updated` events via the streamable HTTP transport when the resource changes.
 
-All device tools work while the Palmier Android app is in the background — they communicate via FCM data messages which wake the app's service even when it's not in the foreground. Permissions listed above must be granted via toggles in the Android app's settings menu.
+All device tools work while the Palmier Android app is in the background — they communicate via FCM data messages which wake the app's service even when it's not in the foreground. Each host has one **linked device**: the phone the host uses for SMS, contacts, location, and other device capabilities. Choose it at pair time (the "Link to this device" checkbox) or later from the drawer. Permissions listed above must be granted via toggles in the linked device's drawer.
 
 ### Architecture
 
@@ -151,6 +151,8 @@ palmier clients revoke <token>
 palmier clients revoke-all
 ```
 
+Revoking the linked device also clears the host's linked-device record; device capabilities stop working until another paired device is linked from its drawer.
+
 ### The `init` Command
 
 The wizard:

package/dist/linked-device.d.ts

@@ -0,0 +1,9 @@
+export interface LinkedDevice {
+    clientToken: string;
+    fcmToken: string;
+}
+export declare function getLinkedDevice(): LinkedDevice | null;
+export declare function setLinkedDevice(clientToken: string, fcmToken: string): void;
+export declare function clearLinkedDevice(): void;
+export declare function clearLinkedDeviceIfMatches(clientToken: string): boolean;
+//# sourceMappingURL=linked-device.d.ts.map

package/dist/linked-device.js

@@ -0,0 +1,45 @@
+import * as fs from "fs";
+import * as path from "path";
+import { CONFIG_DIR } from "./config.js";
+const LINKED_DEVICE_FILE = path.join(CONFIG_DIR, "linked-device.json");
+function read() {
+    try {
+        if (!fs.existsSync(LINKED_DEVICE_FILE))
+            return null;
+        const raw = fs.readFileSync(LINKED_DEVICE_FILE, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!parsed?.clientToken || !parsed?.fcmToken)
+            return null;
+        return { clientToken: parsed.clientToken, fcmToken: parsed.fcmToken };
+    }
+    catch {
+        return null;
+    }
+}
+function write(device) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    if (!device) {
+        if (fs.existsSync(LINKED_DEVICE_FILE))
+            fs.unlinkSync(LINKED_DEVICE_FILE);
+        return;
+    }
+    fs.writeFileSync(LINKED_DEVICE_FILE, JSON.stringify(device, null, 2), "utf-8");
+}
+export function getLinkedDevice() {
+    return read();
+}
+export function setLinkedDevice(clientToken, fcmToken) {
+    write({ clientToken, fcmToken });
+}
+export function clearLinkedDevice() {
+    write(null);
+}
+export function clearLinkedDeviceIfMatches(clientToken) {
+    const current = read();
+    if (current?.clientToken === clientToken) {
+        write(null);
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=linked-device.js.map

package/dist/mcp-tools.js

@@ -1,6 +1,6 @@
 import { StringCodec } from "nats";
 import { registerPending } from "./pending-requests.js";
-import { getCapabilityDevice } from "./device-capabilities.js";
+import { getLinkedDevice } from "./linked-device.js";
 import { getNotifications, onNotificationsChanged } from "./notification-store.js";
 import { getSmsMessages, onSmsChanged } from "./sms-store.js";
 export class ToolError extends Error {
@@ -154,9 +154,9 @@ const deviceGeolocationTool = {
     async handler(_args, ctx) {
         if (!ctx.nc)
             throw new ToolError("Not connected to server (NATS unavailable)", 503);
-        const device = getCapabilityDevice("location");
+        const device = getLinkedDevice();
         if (!device)
-            throw new ToolError("No device has location access enabled", 400);
+            throw new ToolError("No linked device configured", 400);
         const sc = StringCodec();
         const ackReply = await ctx.nc.request(`host.${ctx.config.hostId}.fcm.geolocation`, sc.encode(JSON.stringify({ hostId: ctx.config.hostId, requestId: ctx.sessionId, fcmToken: device.fcmToken })), { timeout: 5_000 });
         const ack = JSON.parse(sc.decode(ackReply.data));
@@ -195,9 +195,9 @@ const readContactsTool = {
     async handler(_args, ctx) {
         if (!ctx.nc)
             throw new ToolError("Not connected to server (NATS unavailable)", 503);
-        const device = getCapabilityDevice("contacts");
+        const device = getLinkedDevice();
         if (!device)
-            throw new ToolError("No device has contacts access enabled", 400);
+            throw new ToolError("No linked device configured", 400);
         const sc = StringCodec();
         const ackReply = await ctx.nc.request(`host.${ctx.config.hostId}.fcm.contacts`, sc.encode(JSON.stringify({ hostId: ctx.config.hostId, requestId: ctx.sessionId, fcmToken: device.fcmToken, action: "read" })), { timeout: 5_000 });
         const ack = JSON.parse(sc.decode(ackReply.data));
@@ -241,9 +241,9 @@ const createContactTool = {
     async handler(args, ctx) {
         if (!ctx.nc)
             throw new ToolError("Not connected to server (NATS unavailable)", 503);
-        const device = getCapabilityDevice("contacts");
+        const device = getLinkedDevice();
         if (!device)
-            throw new ToolError("No device has contacts access enabled", 400);
+            throw new ToolError("No linked device configured", 400);
         const { name, phone, email } = args;
         if (!name)
             throw new ToolError("name is required", 400);
@@ -292,9 +292,9 @@ const readCalendarTool = {
     async handler(args, ctx) {
         if (!ctx.nc)
             throw new ToolError("Not connected to server (NATS unavailable)", 503);
-        const device = getCapabilityDevice("calendar");
+        const device = getLinkedDevice();
         if (!device)
-            throw new ToolError("No device has calendar access enabled", 400);
+            throw new ToolError("No linked device configured", 400);
         const { startDate, endDate } = args;
         const sc = StringCodec();
         const ackReply = await ctx.nc.request(`host.${ctx.config.hostId}.fcm.calendar`, sc.encode(JSON.stringify({
@@ -346,9 +346,9 @@ const createCalendarEventTool = {
     async handler(args, ctx) {
         if (!ctx.nc)
             throw new ToolError("Not connected to server (NATS unavailable)", 503);
-        const device = getCapabilityDevice("calendar");
+        const device = getLinkedDevice();
         if (!device)
-            throw new ToolError("No device has calendar access enabled", 400);
+            throw new ToolError("No linked device configured", 400);
         const { title, startTime, endTime, location, description } = args;
         if (!title || !startTime || !endTime)
             throw new ToolError("title, startTime, and endTime are required", 400);
@@ -400,7 +400,7 @@ const sendSmsTool = {
     async handler(args, ctx) {
         if (!ctx.nc)
             throw new ToolError("Not connected to server (NATS unavailable)", 503);
-        const device = getCapabilityDevice("sms-send");
+        const device = getLinkedDevice();
         if (!device)
             throw new ToolError("No device has SMS Send enabled", 400);
         const { to, body } = args;
@@ -452,9 +452,9 @@ const sendAlarmTool = {
     async handler(args, ctx) {
         if (!ctx.nc)
             throw new ToolError("Not connected to server (NATS unavailable)", 503);
-        const device = getCapabilityDevice("alarm");
+        const device = getLinkedDevice();
         if (!device)
-            throw new ToolError("No device has alarm access enabled", 400);
+            throw new ToolError("No linked device configured", 400);
         const { title, description } = args;
         if (!title)
             throw new ToolError("title is required", 400);
@@ -502,9 +502,9 @@ const readBatteryTool = {
     async handler(_args, ctx) {
         if (!ctx.nc)
             throw new ToolError("Not connected to server (NATS unavailable)", 503);
-        const device = getCapabilityDevice("battery");
+        const device = getLinkedDevice();
         if (!device)
-            throw new ToolError("No device has battery access enabled", 400);
+            throw new ToolError("No linked device configured", 400);
         const sc = StringCodec();
         const ackReply = await ctx.nc.request(`host.${ctx.config.hostId}.fcm.battery`, sc.encode(JSON.stringify({ hostId: ctx.config.hostId, requestId: ctx.sessionId, fcmToken: device.fcmToken })), { timeout: 5_000 });
         const ack = JSON.parse(sc.decode(ackReply.data));
@@ -546,7 +546,7 @@ const setRingerModeTool = {
     async handler(args, ctx) {
         if (!ctx.nc)
             throw new ToolError("Not connected to server (NATS unavailable)", 503);
-        const device = getCapabilityDevice("dnd");
+        const device = getLinkedDevice();
         if (!device)
             throw new ToolError("No device has Do Not Disturb control enabled", 400);
         const { mode } = args;
@@ -597,9 +597,9 @@ const sendEmailTool = {
     async handler(args, ctx) {
         if (!ctx.nc)
             throw new ToolError("Not connected to server (NATS unavailable)", 503);
-        const device = getCapabilityDevice("send-email");
+        const device = getLinkedDevice();
         if (!device)
-            throw new ToolError("No device has send-email access enabled", 400);
+            throw new ToolError("No linked device configured", 400);
         const { to, subject, body, cc, bcc } = args;
         if (!to)
             throw new ToolError("to is required", 400);