Shared components
These services are defined in org-runink/ui, not in PULSE. PULSE registers the
shared Go handlers with its own hooks. For message fields, read the .proto
files in that repository; this page covers what PULSE does with each service.
runink.ui.billing.v1.BillingService
The Billing page. See Billing.
| Method | In PULSE |
|---|---|
ListPlans, QuotePlan | Work. Pure price arithmetic over PULSE’s own plans, in US-dollar list prices. |
GetOverview | The viewer’s subscription (from their purchaser’s row in RUNINK_ACCOUNTS_FILE, else TENANT_ID and SUBSCRIPTION_*) and, on a trial, the seat’s daily fast-task count. |
StartCheckout, OpenPortal | No payment provider: the answer is “not configured”, never an error and never a URL that leads nowhere. |
ListSeats, AssignSeat, RevokeSeat | PULSE keeps no seat roster. |
runink.ui.datasources.v1.ConnectionsService
The Data sources tab. PULSE serves it over its own integrations table and
narrows the catalog to HubSpot and GitHub.
| Method | Purpose |
|---|---|
ListConnectionTypes | The connector types offered: HubSpot and GitHub |
ListConnections, ListConnectionNames, GetConnection | Read your connections |
CreateConnection, UpdateConnection, DeleteConnection | Manage them |
RotateCredentials | Replace the stored token |
TestConnection | Check the token against the platform |
A connection that sets a runner, an environment, or properties is refused, and nothing is stored.
runink.ui.datasources.v1.RunnersService
PULSE runs its connectors inside the server and has no remote runners. The service is registered so the shared page can say so. It reports no runners.
runink.ui.profile.v1.ProfileService
The Account page. Plan and usage are the billing section embedded in it.
| Method | In PULSE |
|---|---|
GetProfile | Your email, display name, and role from the users table, plus your session. Tenant from TENANT_ID (the platform keeps no tenant display name). PULSE has no platform admin, so the page does not show that row. |
ListInstances | The one instance this deployment serves, with your role and, when the instance’s member list states it, when your access ends (or that it does not). Without that list the expiry shows as not stated. Marked as a local development instance only when not running in a cluster. The app’s Admin menu entry reads this. |
EndAllSessions | Ends all of your own sessions on every device |
runink.ui.access.v1.AccessService
The Admin page. Admins only; the role is read fresh on every call. See Users and access.
| Method | Purpose |
|---|---|
ListMembers | Members and their roles |
InviteMember | Grant a person a role. PULSE does not limit invites by seats. |
SetMemberRole | Change a role. Not your own, and never the last admin. |
RemoveMember | Remove a member. Not yourself, and never the last admin. |
runink.ui.comms.v1.CommsService
Send and Call: WhatsApp, SMS and voice calls to a contact an admin has configured. Reads are open to any signed-in account, sending needs editor, and the contact list and carrier settings are admin-only. Carrier settings are sealed before they are stored.
| Method | Purpose | Least role |
|---|---|---|
GetCarrierStatus | Whether messaging is configured | viewer |
ListContacts | The configured contacts | viewer |
GetDelivery, ListDeliveries | What was sent and what became of it | viewer |
PrepareSend | Draft and confirm a message before it leaves | editor |
SendNotification | Send a WhatsApp message or SMS to a configured contact | editor |
PlaceCall | Place a call to a configured contact | editor |
UpsertContact, DeleteContact | Manage the contact list | admin |
SetCarrierConfig | Set the messaging carrier credentials | admin |
Delivery status arrives back on POST /comms/twilio/status; see
HTTP endpoints.
runink.ui.chat.v1.ChatService
The assistant’s chat history (Settings › Chat history). The assistant
starts empty on every page load, sign-in and app start; each question and
answer is saved here instead, in PULSE’s own database, with the text sealed.
Every method needs viewer and works only on the caller’s own chats: another
person’s chat is NotFound.
| Method | In PULSE |
|---|---|
ListChats | The caller’s chats, newest first. An unreadable history is Unavailable, never an empty list. |
GetChat | One chat and its messages, oldest first. A failed answer is kept and marked failed; a run or report it produced is its link. |
CreateChat | A new chat, titled after its first question. The subject is always assistant. |
AppendMessages | Adds the question and the answer. A chat keeps its newest 400 messages. |