rolodex · diff

v1.1.0 to v1.2.0

31 added, 76 removed. Audit A to A.

---
name: rolodex
- description: Follow up on people you recommended, check whether the owner has marked them met, find Rolodex cards, mark or undo meetings, and offer gratitude after a meaningful interaction. Use for meeting updates and replies to introduction or evening questions. Live reads use the existing paired account; writes need the owner's request.
- version: 1.1.0
+ description: Open the Village Rolodex for shared profiles, meeting marks and gratitude. Meeting changes are website-only. When Gold Stars is installed, its scoped native recipient search can resolve names for a star.
+ version: 1.2.0
author: Edge City
---
# Village Rolodex
- The Rolodex is Agent Village's directory of people in the village. It shows
- shared profiles, Telegram introductions and Skylight characters where available.
- The signed-in person can mark **We met**, undo it with **Undo met**, and send
- Gold Stars. These are separate actions: recording a meeting does not send a star.
-
- When asked, give the useful link immediately:
+ The Rolodex is Agent Village's directory of shared profiles, Telegram
+ introductions and Skylight characters where available. Give the useful link:
https://agents.edgecity.live/rolodex
- For “I met Naman”, call `village` with `operation: "rolodex.search"` and
- `query: "Naman"`. Use the returned attendee id. Prefix a returned `/rolodex` path with
- `https://agents.edgecity.live` when sharing its link. If more than one person fits,
- ask which one, using their shared role/organization to distinguish them. Never
- choose the first result, guess an id, or infer a meeting from a match. Then
- call `rolodex.meeting` with that `attendeeId` and `met: true`. A clear request
- to undo uses `met: false`. Search again if the target is unclear.
-
- A clear request authorizes the meeting change using the existing paired account. Do not
- ask for redundant website confirmation. Only report completion from a successful
- receipt. A `historicalReceipt` records an older change: search current state
- before saying it still applies. On a timeout or unknown outcome, check the
- current mark and explain uncertainty; do not claim success. Never log meetings
- from background tasks, group discussions, inferred relationships or unsolicited
- suggestions. Meeting marks follow the Rolodex's existing settling notification
- and mutual-friend rules. They do not send a Gold Star.
+ The signed-in person can mark **We met**, use **Undo met**, and send Gold Stars
+ on the website. These are separate actions: a meeting mark does not send a star.
+ There is no installed native permission to mark or undo meetings. For “I met
+ Naman”, acknowledge the interaction and offer the Rolodex link; never claim you
+ updated a mark, or call a removed `rolodex.meeting` operation.
- An existing Index lookup may return a verified person URL in the Rolodex.
- Preserve it exactly. Do not invent an attendee id, guess a profile URL from a
- name or Telegram handle, or assume an Index match proves a meeting. If no
- verified person link is available, use the directory link and the search box.
- For discovering who to meet or requesting an introduction, use `index-network`.
+ When the optional **Gold Stars** mini-app is installed, `village` with
+ `operation: "rolodex.search"` and `query` resolves its recipients. Ask when
+ ambiguous; never choose the first result or guess an attendee id. A result is
+ shared directory data, not proof of a meeting, recommendation or friendship.
+ Preserve verified person URLs exactly; prefix a returned `/rolodex` path with
+ `https://agents.edgecity.live`. Without a verified link, use the directory and
+ its search box. For discovering people or requesting introductions use
+ `index-network`, not a guessed Rolodex identifier.
## Follow through in conversation
- In the owner's private conversation, when a past recommendation or meeting is
- relevant, use the conversation or `recall` to establish who you actually
- recommended. Do not claim a recommendation from an unrelated directory match.
- Search that person's current Rolodex state before saying whether it is marked.
- Disambiguate names; an Index identifier is not a Rolodex attendee identifier.
-
- - If `met` is false: “Did you get to meet Naman? I can mark it in your Rolodex.”
- An unmarked card does not prove they haven't met. Their answer resolves that.
- - If `met` is true: “I see you've marked Naman as met in your Rolodex. How was it?”
- Say you recommended them only if the earlier recommendation is supported.
- The mark does not prove when, where, how well, or whether they enjoyed meeting.
- - If they clearly ask to mark/undo, or answer yes to your specific offer to
- mark that named person, perform the requested change. A reply to a generic
- “Did you meet?” question can start reflection; ask before recording it if
- the request to update the Rolodex is unclear.
- - After they describe a meaningful interaction, load `gold-stars` and optionally
- ask whether they'd like to thank the person. A meeting is never a star approval.
-
- Use one natural follow-up at a time, not a meeting questionnaire after every
- message. Skip it if already answered, declined, unrelated to what they need,
- or they asked you to stop. Respect corrections and undo; do not re-mark from
- old memory. These are contextual reads in a live private conversation, not
- continuous monitoring or permission to poll the whole directory. You cannot
- use this tool from cron, a group, or a delegated child.
-
- Replies to existing evening/Index questions follow this same conversation
- flow. Keep Index connection outcomes separate from Rolodex marks. Never
- deterministically parse a reply into either a meeting change or a star.
-
- Sign in using the email associated with the person's Edge City ticket and the
- code emailed to them. Never ask them to paste the code, cookies or tokens into
- chat. They can use the Rolodex after sign-in without connecting a Telegram agent.
-
- The skill uses the person's existing Agent Village account and paired Telegram
- agent automatically. There is no new Connect step. If access is pending after
- an update, suggest retrying shortly and offer the Rolodex link in the meantime.
- If sign-in has expired, link to https://agents.edgecity.live/signin; access
- updates automatically after their normal sign-in. If they deliberately turned
- access off, respect that choice. They can manage it in Settings:
- https://agents.edgecity.live/connections/village
+ Use the private conversation or `recall` to establish who you actually
+ recommended. One gentle follow-up is enough; skip it when already answered,
+ declined, irrelevant or the owner asked you to stop. Never infer enjoyment,
+ when/where a meeting happened, or a request to record it from a directory match.
+ After they describe a meaningful interaction, offer gratitude only when it
+ fits. If Gold Stars is installed, load its skill; otherwise use the website.
+ A meeting or chat yes is not authority to send a star: exact preview and real
+ manual approval are required. Do not create schedules or poll the directory.
- The agent can read matching shared profiles and the owner's meeting state,
- and mark/undo their meetings. Access follows current account and Telegram
- pairing. The tool is for the paired owner's private Telegram chat. For other
- contexts give the website link.
- Never borrow credentials or call APIs through the shell to bypass a refusal.
- A missing person may be a directory issue, not evidence they have no ticket.
+ Sign in through the website with the email associated with the person's ticket.
+ Never request codes, cookies or tokens in chat. Respect install opt-outs and
+ private-owner chat restrictions. Never borrow credentials or use shell/API
+ calls to bypass an unavailable native operation. A missing person may be a
+ directory issue, not evidence they have no ticket.
- For gratitude, load `gold-stars`. For characters and islands, load `skylight`.
+ For characters and islands, load `skylight`.