relay-companion 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relay-companion",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Relay companion: connects local coding agents to Relay tasks, approvals, and connector tools.",
   "type": "module",
   "bin": {

package/src/client.js

@@ -182,12 +182,21 @@ export class RelayClient {
     return this.#req("GET", "/v1/contacts");
   }
 
-  upsertContact({ name, email, emails }) {
-    return this.#req("POST", "/v1/contacts", { name, email, emails });
-  }
-
-  updateContact(contactId, { name, email, emails } = {}) {
-    return this.#req("PATCH", `/v1/contacts/${encodeURIComponent(contactId)}`, { name, email, emails });
+  upsertContact({ name, firstName, surname, lastName, email, emails, notes, idempotencyKey }) {
+    return this.#req("POST", "/v1/contacts", { name, firstName, surname, lastName, email, emails, notes, idempotencyKey });
+  }
+
+  updateContact(contactId, { name, firstName, surname, lastName, email, emails, notes, idempotencyKey } = {}) {
+    return this.#req("PATCH", `/v1/contacts/${encodeURIComponent(contactId)}`, {
+      name,
+      firstName,
+      surname,
+      lastName,
+      email,
+      emails,
+      notes,
+      idempotencyKey,
+    });
   }
 
   importContacts(contacts, source = "imported") {

package/src/mcp.js

@@ -45,6 +45,25 @@ export const TOOLS = [
       required: ["query"],
     },
   },
+  {
+    name: "relay_contact_update",
+    description:
+      "Correct a Relay contact in this human's contact book. Use this after relay_send auto-creates an email-only contact, or when the human asks you to fix a saved contact. Prefer firstName and surname over a single name string. If you are not sure of the person's first name and surname, ask the human for clarification before editing the contact.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        contactId: { type: "string", description: "The contactId returned by relay_contacts_search or relay_send.contact.contactId." },
+        firstName: { type: "string" },
+        surname: { type: "string" },
+        name: { type: "string", description: "Fallback display name; prefer firstName + surname when possible." },
+        email: { type: "string" },
+        emails: { type: "array", items: { type: "string" } },
+        notes: { type: "string" },
+        idempotencyKey: { type: "string" },
+      },
+      required: ["contactId", "idempotencyKey"],
+    },
+  },
   {
     name: "relay_inbox_list",
     description:
@@ -318,11 +337,26 @@ function text(obj) {
   return { content: [{ type: "text", text: typeof obj === "string" ? obj : JSON.stringify(obj, null, 2) }] };
 }
 
+function relaySendResultForAgent(result) {
+  if (!result?.contact?.autoCreated) return result;
+  return {
+    ...result,
+    agentInstruction:
+      result.agentInstruction ||
+      [
+        `Relay auto-added ${result.contact.email} to this human's contact book because there was no saved contact for this recipient.`,
+        "You are responsible for correcting the contact's firstName and surname with relay_contact_update if you know them from reliable context.",
+        "If you are not sure of the person's first name and surname, ask the human for clarification before editing the contact.",
+      ].join(" "),
+    nextRecommendedTool: "relay_contact_update",
+  };
+}
+
 export async function handleCall(client, name, args) {
   switch (name) {
     case "relay_send":
       return text(
-        await client.sendRelay({
+        relaySendResultForAgent(await client.sendRelay({
           recipient: args.recipient,
           kind: args.kind || "message",
           title: args.title,
@@ -332,10 +366,22 @@ export async function handleCall(client, name, args) {
           targetSurfaces: args.targetSurfaces || [],
           attachments: args.attachments || [],
           idempotencyKey: args.idempotencyKey,
-        }),
+        })),
       );
     case "relay_contacts_search":
       return text(await client.searchContacts(args.query));
+    case "relay_contact_update":
+      return text(
+        await client.updateContact(args.contactId, {
+          firstName: args.firstName,
+          surname: args.surname,
+          name: args.name,
+          email: args.email,
+          emails: args.emails,
+          notes: args.notes,
+          idempotencyKey: args.idempotencyKey,
+        }),
+      );
     case "relay_inbox_list":
       return text(await client.inbox());
     case "relay_acknowledge":