Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions assistant/docs/runbook-trusted-contacts.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Trusted Contacts — Operator Runbook

Operational procedures for inspecting, managing, and debugging the trusted contact access flow. All HTTP commands use the runtime API (default `http://localhost:7821`) with bearer authentication.
Operational procedures for inspecting, managing, and debugging the trusted contact access flow. All HTTP commands use the gateway API (default `http://localhost:7830`) with bearer authentication.

## Prerequisites

Expand All @@ -9,7 +9,7 @@ Operational procedures for inspecting, managing, and debugging the trusted conta
TOKEN=$(cat ~/.vellum/http-token)

# Base URL (adjust if using a non-default port)
BASE=http://localhost:7821
BASE=http://localhost:7830
```

## 1. Inspect Trusted Contacts (Members)
Expand Down
14 changes: 7 additions & 7 deletions assistant/src/config/vellum-skills/trusted-contacts/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@ user-invocable: true
metadata: {"vellum": {"emoji": "\ud83d\udc65"}}
---

You are helping your user manage trusted contacts for the Vellum Assistant. Trusted contacts control who is allowed to send messages to the assistant through external channels like Telegram and SMS. All operations go through the runtime HTTP API using `curl` with bearer auth.
You are helping your user manage trusted contacts for the Vellum Assistant. Trusted contacts control who is allowed to send messages to the assistant through external channels like Telegram and SMS. All operations go through the gateway HTTP API using `curl` with bearer auth.

## Prerequisites

- The runtime HTTP API is available at `http://localhost:7821` (or the configured `RUNTIME_HTTP_PORT`).
- The gateway API is available at `http://localhost:7830` (or the configured gateway port).
- The bearer token is stored at `~/.vellum/http-token`. Read it with: `TOKEN=$(cat ~/.vellum/http-token)`.

## Concepts
Expand All @@ -27,7 +27,7 @@ Use this to show the user who currently has access, or to look up a specific con

```bash
TOKEN=$(cat ~/.vellum/http-token)
curl -s http://localhost:7821/v1/ingress/members \
curl -s http://localhost:7830/v1/ingress/members \
-H "Authorization: Bearer $TOKEN"
```

Expand All @@ -38,7 +38,7 @@ Optional query parameters for filtering:

Example with filters:
```bash
curl -s "http://localhost:7821/v1/ingress/members?sourceChannel=telegram&status=active" \
curl -s "http://localhost:7830/v1/ingress/members?sourceChannel=telegram&status=active" \
-H "Authorization: Bearer $TOKEN"
```

Expand All @@ -63,7 +63,7 @@ Ask the user: *"I'll add [name/identifier] on [channel] as an allowed contact. S

```bash
TOKEN=$(cat ~/.vellum/http-token)
curl -s -X POST http://localhost:7821/v1/ingress/members \
curl -s -X POST http://localhost:7830/v1/ingress/members \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{
Expand Down Expand Up @@ -95,7 +95,7 @@ First, list members to find the member's `id`, then revoke:

```bash
TOKEN=$(cat ~/.vellum/http-token)
curl -s -X DELETE "http://localhost:7821/v1/ingress/members/<member_id>" \
curl -s -X DELETE "http://localhost:7830/v1/ingress/members/<member_id>" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"reason": "<optional reason>"}'
Expand All @@ -111,7 +111,7 @@ Ask the user: *"I'll block [name/identifier]. They will be permanently denied fr

```bash
TOKEN=$(cat ~/.vellum/http-token)
curl -s -X POST "http://localhost:7821/v1/ingress/members/<member_id>/block" \
curl -s -X POST "http://localhost:7830/v1/ingress/members/<member_id>/block" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{"reason": "<optional reason>"}'
Expand Down
14 changes: 7 additions & 7 deletions skills/trusted-contacts/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@ user-invocable: true
metadata: {"vellum": {"emoji": "\ud83d\udc65"}}
---

You are helping your user manage trusted contacts for the Vellum Assistant. Trusted contacts control who is allowed to send messages to the assistant through external channels like Telegram and SMS. All operations go through the runtime HTTP API using `curl` with bearer auth.
You are helping your user manage trusted contacts for the Vellum Assistant. Trusted contacts control who is allowed to send messages to the assistant through external channels like Telegram and SMS. All operations go through the gateway HTTP API using `curl` with bearer auth.

## Prerequisites

- The runtime HTTP API is available at `http://localhost:7821` (or the configured `RUNTIME_HTTP_PORT`).
- The gateway API is available at `http://localhost:7830` (or the configured gateway port).
- The bearer token is stored at `~/.vellum/http-token`. Read it with: `TOKEN=$(cat ~/.vellum/http-token)`.

## Concepts
Expand All @@ -27,7 +27,7 @@ Use this to show the user who currently has access, or to look up a specific con

```bash
TOKEN=$(cat ~/.vellum/http-token)
curl -s http://localhost:7821/v1/ingress/members \
curl -s http://localhost:7830/v1/ingress/members \
-H "Authorization: Bearer $TOKEN"
```

Expand All @@ -38,7 +38,7 @@ Optional query parameters for filtering:

Example with filters:
```bash
curl -s "http://localhost:7821/v1/ingress/members?sourceChannel=telegram&status=active" \
curl -s "http://localhost:7830/v1/ingress/members?sourceChannel=telegram&status=active" \
-H "Authorization: Bearer $TOKEN"
```

Expand All @@ -63,7 +63,7 @@ Ask the user: *"I'll add [name/identifier] on [channel] as an allowed contact. S

```bash
TOKEN=$(cat ~/.vellum/http-token)
curl -s -X POST http://localhost:7821/v1/ingress/members \
curl -s -X POST http://localhost:7830/v1/ingress/members \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{
Expand Down Expand Up @@ -95,7 +95,7 @@ First, list members to find the member's `id`, then revoke:

```bash
TOKEN=$(cat ~/.vellum/http-token)
curl -s -X DELETE "http://localhost:7821/v1/ingress/members/<member_id>" \
curl -s -X DELETE "http://localhost:7830/v1/ingress/members/<member_id>" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"reason": "<optional reason>"}'
Expand All @@ -111,7 +111,7 @@ Ask the user: *"I'll block [name/identifier]. They will be permanently denied fr

```bash
TOKEN=$(cat ~/.vellum/http-token)
curl -s -X POST "http://localhost:7821/v1/ingress/members/<member_id>/block" \
curl -s -X POST "http://localhost:7830/v1/ingress/members/<member_id>/block" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{"reason": "<optional reason>"}'
Expand Down