@tellagen/mcp-server 0.4.2 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +337 -104
- package/SKILL.md +83 -17
- package/contracts/mcp-protocol.json +155 -0
- package/contracts/runbooks/manifest.json +26 -6
- package/contracts/runbooks/v2/cause-lead.guidance.json +37 -0
- package/contracts/runbooks/v2/client-protocol.json +926 -0
- package/contracts/runbooks/v2/client-writes.guidance.json +42 -0
- package/contracts/runbooks/v2/fixtures/timeline-event-blocks-rejected.json +30 -5
- package/contracts/runbooks/v2/result-summary.guidance.json +21 -0
- package/contracts/runbooks/v2/timeline-event-blocks.schema.json +18 -11
- package/contracts/tellagen-runbook-contracts.json +4 -4
- package/dist/active-run.d.ts +29 -0
- package/dist/active-run.js +67 -0
- package/dist/active-run.js.map +1 -0
- package/dist/bootstrap.d.ts +20 -0
- package/dist/bootstrap.js +29 -0
- package/dist/bootstrap.js.map +1 -0
- package/dist/cause-lead.d.ts +25 -0
- package/dist/cause-lead.js +145 -0
- package/dist/cause-lead.js.map +1 -0
- package/dist/cli/auth.d.ts +22 -0
- package/dist/cli/auth.js +207 -0
- package/dist/cli/auth.js.map +1 -0
- package/dist/cli/io.d.ts +16 -0
- package/dist/cli/io.js +53 -0
- package/dist/cli/io.js.map +1 -0
- package/dist/cli/listen-guard.d.ts +12 -0
- package/dist/cli/listen-guard.js +50 -0
- package/dist/cli/listen-guard.js.map +1 -0
- package/dist/cli/listen.d.ts +28 -0
- package/dist/cli/listen.js +205 -0
- package/dist/cli/listen.js.map +1 -0
- package/dist/cli/main.d.ts +3 -0
- package/dist/cli/main.js +53 -0
- package/dist/cli/main.js.map +1 -0
- package/dist/cli/trace-hook.d.ts +23 -0
- package/dist/cli/trace-hook.js +99 -0
- package/dist/cli/trace-hook.js.map +1 -0
- package/dist/client.d.ts +92 -6
- package/dist/client.js +300 -23
- package/dist/client.js.map +1 -1
- package/dist/config.d.ts +17 -0
- package/dist/config.js +38 -0
- package/dist/config.js.map +1 -0
- package/dist/credentials.d.ts +120 -0
- package/dist/credentials.js +363 -0
- package/dist/credentials.js.map +1 -0
- package/dist/diagnosis-structure.d.ts +257 -197
- package/dist/diagnosis-structure.js +144 -1
- package/dist/diagnosis-structure.js.map +1 -1
- package/dist/diff-figure.d.ts +56 -0
- package/dist/diff-figure.js +276 -0
- package/dist/diff-figure.js.map +1 -0
- package/dist/errors.d.ts +21 -0
- package/dist/errors.js +60 -0
- package/dist/errors.js.map +1 -1
- package/dist/figures.d.ts +312 -232
- package/dist/figures.js +189 -47
- package/dist/figures.js.map +1 -1
- package/dist/guide-resources.d.ts +28 -0
- package/dist/guide-resources.js +81 -0
- package/dist/guide-resources.js.map +1 -0
- package/dist/heartbeat.d.ts +24 -0
- package/dist/heartbeat.js +94 -0
- package/dist/heartbeat.js.map +1 -0
- package/dist/home.d.ts +8 -0
- package/dist/home.js +14 -0
- package/dist/home.js.map +1 -0
- package/dist/identity.d.ts +32 -0
- package/dist/identity.js +83 -0
- package/dist/identity.js.map +1 -0
- package/dist/index.js +46 -14
- package/dist/index.js.map +1 -1
- package/dist/listen-config.d.ts +67 -0
- package/dist/listen-config.js +83 -0
- package/dist/listen-config.js.map +1 -0
- package/dist/listen-probe.d.ts +57 -0
- package/dist/listen-probe.js +158 -0
- package/dist/listen-probe.js.map +1 -0
- package/dist/listen-rules.d.ts +88 -0
- package/dist/listen-rules.js +252 -0
- package/dist/listen-rules.js.map +1 -0
- package/dist/listen-settings.d.ts +18 -0
- package/dist/listen-settings.js +50 -0
- package/dist/listen-settings.js.map +1 -0
- package/dist/listen-wrap.d.ts +21 -0
- package/dist/listen-wrap.js +52 -0
- package/dist/listen-wrap.js.map +1 -0
- package/dist/listener.d.ts +195 -0
- package/dist/listener.js +600 -0
- package/dist/listener.js.map +1 -0
- package/dist/open-run.d.ts +2 -0
- package/dist/open-run.js +5 -0
- package/dist/open-run.js.map +1 -0
- package/dist/prompts.d.ts +12 -0
- package/dist/prompts.js +37 -0
- package/dist/prompts.js.map +1 -0
- package/dist/redact.d.ts +13 -0
- package/dist/redact.js +76 -0
- package/dist/redact.js.map +1 -0
- package/dist/run-events.d.ts +54 -0
- package/dist/run-events.js +210 -0
- package/dist/run-events.js.map +1 -0
- package/dist/run-state.d.ts +221 -0
- package/dist/run-state.js +221 -0
- package/dist/run-state.js.map +1 -0
- package/dist/server.d.ts +22 -2
- package/dist/server.js +137 -29
- package/dist/server.js.map +1 -1
- package/dist/session.d.ts +99 -0
- package/dist/session.js +187 -0
- package/dist/session.js.map +1 -0
- package/dist/shell-rules.d.ts +49 -0
- package/dist/shell-rules.js +335 -0
- package/dist/shell-rules.js.map +1 -0
- package/dist/signin-index.d.ts +164 -0
- package/dist/signin-index.js +116 -0
- package/dist/signin-index.js.map +1 -0
- package/dist/signin.d.ts +169 -0
- package/dist/signin.js +541 -0
- package/dist/signin.js.map +1 -0
- package/dist/source-bases.d.ts +75 -0
- package/dist/source-bases.js +125 -0
- package/dist/source-bases.js.map +1 -0
- package/dist/start.d.ts +7 -6
- package/dist/start.js +14 -7
- package/dist/start.js.map +1 -1
- package/dist/tools/catalog.d.ts +44 -0
- package/dist/tools/catalog.js +105 -0
- package/dist/tools/catalog.js.map +1 -0
- package/dist/tools/causes.d.ts +6 -6
- package/dist/tools/causes.js +4 -5
- package/dist/tools/causes.js.map +1 -1
- package/dist/tools/context.js +5 -5
- package/dist/tools/context.js.map +1 -1
- package/dist/tools/datasources.js +71 -14
- package/dist/tools/datasources.js.map +1 -1
- package/dist/tools/diagnostics.js +2 -2
- package/dist/tools/diagnostics.js.map +1 -1
- package/dist/tools/figures.d.ts +3 -2
- package/dist/tools/figures.js +38 -13
- package/dist/tools/figures.js.map +1 -1
- package/dist/tools/findings.d.ts +28 -0
- package/dist/tools/findings.js +75 -12
- package/dist/tools/findings.js.map +1 -1
- package/dist/tools/incidents.js +5 -5
- package/dist/tools/incidents.js.map +1 -1
- package/dist/tools/index.d.ts +19 -2
- package/dist/tools/index.js +115 -14
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/investigations.d.ts +54 -0
- package/dist/tools/investigations.js +372 -68
- package/dist/tools/investigations.js.map +1 -1
- package/dist/tools/next.d.ts +20 -0
- package/dist/tools/next.js +136 -0
- package/dist/tools/next.js.map +1 -0
- package/dist/tools/postmortem-runbooks.d.ts +52 -52
- package/dist/tools/postmortem-runbooks.js +3 -10
- package/dist/tools/postmortem-runbooks.js.map +1 -1
- package/dist/tools/resume.d.ts +5 -0
- package/dist/tools/resume.js +136 -0
- package/dist/tools/resume.js.map +1 -0
- package/dist/tools/signin.d.ts +12 -0
- package/dist/tools/signin.js +54 -0
- package/dist/tools/signin.js.map +1 -0
- package/dist/tools/source-links.d.ts +16 -0
- package/dist/tools/source-links.js +25 -13
- package/dist/tools/source-links.js.map +1 -1
- package/dist/tools/timeline.js +57 -11
- package/dist/tools/timeline.js.map +1 -1
- package/dist/trace-record.d.ts +36 -0
- package/dist/trace-record.js +283 -0
- package/dist/trace-record.js.map +1 -0
- package/dist/version.d.ts +10 -2
- package/dist/version.js +20 -1
- package/dist/version.js.map +1 -1
- package/package.json +23 -3
- package/server.json +9 -9
- package/contracts/runbooks/v1/fixtures/global-runbook.json +0 -7
- package/contracts/runbooks/v1/runbook-definition.schema.json +0 -25
- package/dist/auth.d.ts +0 -7
- package/dist/auth.js +0 -19
- package/dist/auth.js.map +0 -1
package/dist/signin.js
ADDED
|
@@ -0,0 +1,541 @@
|
|
|
1
|
+
import { spawn } from "node:child_process";
|
|
2
|
+
import { accountFor, describeStore } from "./credentials.js";
|
|
3
|
+
import { computerName } from "./identity.js";
|
|
4
|
+
import { MCP_SERVER_VERSION } from "./version.js";
|
|
5
|
+
/**
|
|
6
|
+
* Browser sign-in for a client (the device-code flow).
|
|
7
|
+
*
|
|
8
|
+
* 1. Start: Tellagen answers with a short code to show and a secret device
|
|
9
|
+
* code that only this process keeps.
|
|
10
|
+
* 2. The person opens the address, signs in and approves the code.
|
|
11
|
+
* 3. Poll: Tellagen creates a personal key when this client collects it, and
|
|
12
|
+
* shows it once. It goes to the keychain at once.
|
|
13
|
+
*
|
|
14
|
+
* The device code and the key never leave this file's variables except
|
|
15
|
+
* to Tellagen and to the keychain. They are not logged, not returned from a
|
|
16
|
+
* tool and not part of an error message.
|
|
17
|
+
*/
|
|
18
|
+
export const DEFAULT_SIGN_IN_URL = "https://api.tellagen.com";
|
|
19
|
+
const REQUEST_TIMEOUT_MS = 15_000;
|
|
20
|
+
const MAX_POLL_FAILURES = 5;
|
|
21
|
+
export const EXPIRY_WARNING_DAYS = 7;
|
|
22
|
+
export class SignInError extends Error {
|
|
23
|
+
code;
|
|
24
|
+
reason;
|
|
25
|
+
constructor(code, message,
|
|
26
|
+
/** For `denied`: the reason Tellagen gave, such as responder_seat_required. */
|
|
27
|
+
reason) {
|
|
28
|
+
super(message);
|
|
29
|
+
this.code = code;
|
|
30
|
+
this.reason = reason;
|
|
31
|
+
this.name = "SignInError";
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
/** A secret that prints as a placeholder, so a log line or JSON dump cannot leak it. */
|
|
35
|
+
export class Secret {
|
|
36
|
+
#value;
|
|
37
|
+
constructor(value) {
|
|
38
|
+
this.#value = value;
|
|
39
|
+
}
|
|
40
|
+
reveal() {
|
|
41
|
+
return this.#value;
|
|
42
|
+
}
|
|
43
|
+
toString() {
|
|
44
|
+
return "[secret]";
|
|
45
|
+
}
|
|
46
|
+
toJSON() {
|
|
47
|
+
return "[secret]";
|
|
48
|
+
}
|
|
49
|
+
[Symbol.for("nodejs.util.inspect.custom")]() {
|
|
50
|
+
return "[secret]";
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
function isRecord(value) {
|
|
54
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
55
|
+
}
|
|
56
|
+
/** A URL that may receive a key or be opened: https, or http on this computer. */
|
|
57
|
+
export function safeUrl(value) {
|
|
58
|
+
if (typeof value !== "string" || value.length > 500)
|
|
59
|
+
return undefined;
|
|
60
|
+
let url;
|
|
61
|
+
try {
|
|
62
|
+
url = new URL(value);
|
|
63
|
+
}
|
|
64
|
+
catch {
|
|
65
|
+
return undefined;
|
|
66
|
+
}
|
|
67
|
+
if (url.username || url.password)
|
|
68
|
+
return undefined;
|
|
69
|
+
const loopback = url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "[::1]" || url.hostname.endsWith(".localhost");
|
|
70
|
+
if (url.protocol === "https:" || (url.protocol === "http:" && loopback))
|
|
71
|
+
return url;
|
|
72
|
+
return undefined;
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* The address that starts a sign-in: TELLAGEN_SIGN_IN_URL, else the API
|
|
76
|
+
* address already chosen, else the Tellagen cloud. Every API host accepts the
|
|
77
|
+
* start route, so a workspace address works too.
|
|
78
|
+
*/
|
|
79
|
+
/** Second-level public suffixes that need three labels for a registrable domain. */
|
|
80
|
+
const TWO_LEVEL_SUFFIXES = new Set([
|
|
81
|
+
"co.uk", "org.uk", "ac.uk", "gov.uk", "com.au", "net.au", "org.au", "co.nz", "co.jp", "com.br",
|
|
82
|
+
"co.in", "co.za", "com.sg", "com.hk", "com.mx", "com.tr", "co.kr",
|
|
83
|
+
]);
|
|
84
|
+
/** The domain a host is registered under, such as `tellagen.com` for `acme.api.tellagen.com`. */
|
|
85
|
+
export function registrableDomain(host) {
|
|
86
|
+
const name = host.toLowerCase().replace(/\.$/, "");
|
|
87
|
+
// An address, a bracketed IPv6 address or a single label stands for itself.
|
|
88
|
+
if (/^[\d.]+$/.test(name) || name.startsWith("[") || !name.includes("."))
|
|
89
|
+
return name;
|
|
90
|
+
const labels = name.split(".");
|
|
91
|
+
const tail2 = labels.slice(-2).join(".");
|
|
92
|
+
return TWO_LEVEL_SUFFIXES.has(tail2) && labels.length >= 3 ? labels.slice(-3).join(".") : tail2;
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Whether an address from Tellagen's answer is on the same registered domain
|
|
96
|
+
* as the address the sign-in started at. A page to open and a host to send a
|
|
97
|
+
* key to must both pass: otherwise a server that was told to start a sign-in
|
|
98
|
+
* could send the person, and the key, anywhere.
|
|
99
|
+
*/
|
|
100
|
+
export function sameRegistrableDomain(candidate, expected) {
|
|
101
|
+
const want = expected.hostname.toLowerCase();
|
|
102
|
+
const got = candidate.hostname.toLowerCase();
|
|
103
|
+
// The Tellagen cloud: the registered domain is known.
|
|
104
|
+
if (registrableDomain(want) === "tellagen.com")
|
|
105
|
+
return registrableDomain(got) === "tellagen.com";
|
|
106
|
+
// Any other address (a self-hosted Tellagen): the same host, a host below it, or the parent of its
|
|
107
|
+
// first label when that parent has three labels or more. The suffix table is short, so a wider
|
|
108
|
+
// rule could let a whole public suffix such as vercel.app pass.
|
|
109
|
+
if (got === want || got.endsWith(`.${want}`))
|
|
110
|
+
return true;
|
|
111
|
+
const labels = want.split(".");
|
|
112
|
+
if (labels.length >= 4 && !/^[\d.]+$/.test(want)) {
|
|
113
|
+
const parent = labels.slice(1).join(".");
|
|
114
|
+
return got === parent || got.endsWith(`.${parent}`);
|
|
115
|
+
}
|
|
116
|
+
return false;
|
|
117
|
+
}
|
|
118
|
+
export function signInBaseUrl(env, override) {
|
|
119
|
+
for (const candidate of [override, env.TELLAGEN_SIGN_IN_URL, env.TELLAGEN_API_URL]) {
|
|
120
|
+
const value = (candidate ?? "").trim();
|
|
121
|
+
if (value) {
|
|
122
|
+
const url = safeUrl(value);
|
|
123
|
+
if (!url)
|
|
124
|
+
throw new SignInError("bad_answer", "The sign-in address must be an https address.");
|
|
125
|
+
return url.origin;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
return DEFAULT_SIGN_IN_URL;
|
|
129
|
+
}
|
|
130
|
+
async function postJson(fetchFn, url, body) {
|
|
131
|
+
const controller = new AbortController();
|
|
132
|
+
const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
|
|
133
|
+
try {
|
|
134
|
+
const res = await fetchFn(url, {
|
|
135
|
+
method: "POST",
|
|
136
|
+
headers: { "Content-Type": "application/json", Accept: "application/json" },
|
|
137
|
+
body: JSON.stringify(body),
|
|
138
|
+
signal: controller.signal,
|
|
139
|
+
});
|
|
140
|
+
let json = {};
|
|
141
|
+
try {
|
|
142
|
+
const parsed = (await res.json());
|
|
143
|
+
if (isRecord(parsed))
|
|
144
|
+
json = parsed;
|
|
145
|
+
}
|
|
146
|
+
catch {
|
|
147
|
+
// Not JSON: the status carries the meaning.
|
|
148
|
+
}
|
|
149
|
+
const retry = Number(res.headers.get("retry-after"));
|
|
150
|
+
return { status: res.status, json, retryAfter: Number.isFinite(retry) && retry > 0 ? retry : undefined };
|
|
151
|
+
}
|
|
152
|
+
catch {
|
|
153
|
+
throw new SignInError("network", "Tellagen could not be reached. Check the network and the sign-in address, then try again.");
|
|
154
|
+
}
|
|
155
|
+
finally {
|
|
156
|
+
clearTimeout(timer);
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
function cleanText(value, max) {
|
|
160
|
+
return typeof value === "string" ? value.replace(/[\u0000-\u001f\u007f]+/g, " ").trim().slice(0, max) : "";
|
|
161
|
+
}
|
|
162
|
+
/** Step 1. Asks Tellagen for a code, naming this client and computer. */
|
|
163
|
+
export async function startDeviceSignIn(baseUrl, client, fetchFn = fetch) {
|
|
164
|
+
const { status, json, retryAfter } = await postJson(fetchFn, `${baseUrl}/api/v1/auth/device/start`, {
|
|
165
|
+
client_name: client.name,
|
|
166
|
+
client_version: client.version,
|
|
167
|
+
server_version: MCP_SERVER_VERSION,
|
|
168
|
+
computer_name: computerName(),
|
|
169
|
+
});
|
|
170
|
+
if (status === 429) {
|
|
171
|
+
throw new SignInError("rate_limited", `Too many sign-in attempts from this address. Try again in ${Math.ceil((retryAfter ?? 60) / 60)} minute(s).`);
|
|
172
|
+
}
|
|
173
|
+
if (status === 503) {
|
|
174
|
+
throw new SignInError("busy", "Tellagen is busy with other sign-ins. Try again in a minute.");
|
|
175
|
+
}
|
|
176
|
+
const deviceCode = cleanText(json.device_code, 200);
|
|
177
|
+
const userCode = cleanText(json.user_code, 40);
|
|
178
|
+
const verificationUri = safeUrl(json.verification_uri);
|
|
179
|
+
const complete = safeUrl(json.verification_uri_complete) ?? verificationUri;
|
|
180
|
+
const expectedHost = new URL(baseUrl);
|
|
181
|
+
for (const page of [verificationUri, complete]) {
|
|
182
|
+
if (page && !sameRegistrableDomain(page, expectedHost)) {
|
|
183
|
+
throw new SignInError("bad_answer", `The server at ${expectedHost.hostname} sent a sign-in page on another domain (${page.hostname.slice(0, 80)}). Nothing was opened and no code is shown. Check the address you signed in at: the --url flag, TELLAGEN_SIGN_IN_URL or TELLAGEN_API_URL.`);
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
if (status !== 200 || !deviceCode || !userCode || !verificationUri || !complete) {
|
|
187
|
+
throw new SignInError("bad_answer", `Tellagen did not start a sign-in (HTTP ${status}). Check that the sign-in address is a Tellagen API address.`);
|
|
188
|
+
}
|
|
189
|
+
const expires = Number(json.expires_in);
|
|
190
|
+
const interval = Number(json.interval);
|
|
191
|
+
return {
|
|
192
|
+
deviceCode: new Secret(deviceCode),
|
|
193
|
+
userCode,
|
|
194
|
+
verificationUri: verificationUri.toString(),
|
|
195
|
+
verificationUriComplete: complete.toString(),
|
|
196
|
+
expiresInSeconds: Number.isFinite(expires) && expires > 0 ? Math.min(expires, 1800) : 600,
|
|
197
|
+
intervalSeconds: Number.isFinite(interval) && interval > 0 ? Math.min(interval, 30) : 5,
|
|
198
|
+
};
|
|
199
|
+
}
|
|
200
|
+
/** Step 3. One poll. A pending answer carries the interval to wait. */
|
|
201
|
+
export async function pollDeviceToken(baseUrl, deviceCode, fetchFn = fetch) {
|
|
202
|
+
const { status, json } = await postJson(fetchFn, `${baseUrl}/api/v1/auth/device/token`, {
|
|
203
|
+
device_code: deviceCode.reveal(),
|
|
204
|
+
});
|
|
205
|
+
const code = cleanText(json.code ?? (isRecord(json.error) ? json.error.code : undefined), 60);
|
|
206
|
+
const details = isRecord(json.details) ? json.details : {};
|
|
207
|
+
if (status === 410 || code === "expired") {
|
|
208
|
+
throw new SignInError("expired", "The code expired before it was approved. Start the sign-in again.");
|
|
209
|
+
}
|
|
210
|
+
if (status === 403 || code === "denied") {
|
|
211
|
+
const reason = cleanText(details.reason, 60);
|
|
212
|
+
throw new SignInError("denied", cleanText(json.message, 300) || "The sign-in was not approved.", reason || undefined);
|
|
213
|
+
}
|
|
214
|
+
if (status === 400 || code === "invalid_device_code") {
|
|
215
|
+
throw new SignInError("invalid_device_code", "Tellagen does not know this code any more. Start the sign-in again.");
|
|
216
|
+
}
|
|
217
|
+
if (status === 429) {
|
|
218
|
+
return { state: "pending", intervalSeconds: 10 };
|
|
219
|
+
}
|
|
220
|
+
if (status !== 200) {
|
|
221
|
+
throw new SignInError("bad_answer", `Tellagen answered the sign-in poll with HTTP ${status}.`);
|
|
222
|
+
}
|
|
223
|
+
const answer = cleanText(json.status, 40);
|
|
224
|
+
const interval = Number(json.interval);
|
|
225
|
+
if (answer === "authorization_pending" || answer === "slow_down") {
|
|
226
|
+
return { state: "pending", intervalSeconds: Number.isFinite(interval) && interval > 0 ? Math.min(interval, 30) : 5 };
|
|
227
|
+
}
|
|
228
|
+
if (answer !== "approved") {
|
|
229
|
+
throw new SignInError("bad_answer", "Tellagen answered the sign-in poll in a form this server does not know.");
|
|
230
|
+
}
|
|
231
|
+
const key = typeof json.api_key === "string" ? json.api_key.trim() : "";
|
|
232
|
+
const apiUrl = safeUrl(json.api_base_url);
|
|
233
|
+
if (apiUrl && !sameRegistrableDomain(apiUrl, new URL(baseUrl))) {
|
|
234
|
+
throw new SignInError("bad_answer", `The server at ${new URL(baseUrl).hostname} named a workspace on another domain (${apiUrl.hostname.slice(0, 80)}). The key was not stored and not used. Check the address you signed in at: the --url flag, TELLAGEN_SIGN_IN_URL or TELLAGEN_API_URL.`);
|
|
235
|
+
}
|
|
236
|
+
if (!key || !apiUrl) {
|
|
237
|
+
throw new SignInError("bad_answer", "Tellagen approved the sign-in but sent no usable key or workspace address.");
|
|
238
|
+
}
|
|
239
|
+
const workspace = isRecord(json.workspace) ? json.workspace : {};
|
|
240
|
+
const keyInfo = isRecord(json.key) ? json.key : {};
|
|
241
|
+
return {
|
|
242
|
+
state: "approved",
|
|
243
|
+
signIn: {
|
|
244
|
+
apiKey: new Secret(key),
|
|
245
|
+
apiUrl: apiUrl.origin,
|
|
246
|
+
keyExpiresAt: cleanText(keyInfo.expires_at, 40) || undefined,
|
|
247
|
+
workspaceName: cleanText(workspace.name, 200) || undefined,
|
|
248
|
+
workspaceUrl: (() => { const w = safeUrl(workspace.url); return w && sameRegistrableDomain(w, new URL(baseUrl)) ? w.origin : undefined; })(),
|
|
249
|
+
},
|
|
250
|
+
};
|
|
251
|
+
}
|
|
252
|
+
/** Whether this process can show a browser to the person. */
|
|
253
|
+
export function canOpenBrowser(env = process.env, platform = process.platform) {
|
|
254
|
+
if (env.SSH_CONNECTION || env.SSH_CLIENT || env.SSH_TTY)
|
|
255
|
+
return false;
|
|
256
|
+
if (env.CI)
|
|
257
|
+
return false;
|
|
258
|
+
if (platform === "linux" && !env.DISPLAY && !env.WAYLAND_DISPLAY)
|
|
259
|
+
return false;
|
|
260
|
+
return true;
|
|
261
|
+
}
|
|
262
|
+
/** Opens an address in the browser. It never throws and shows nothing. */
|
|
263
|
+
export function openInBrowser(address, platform = process.platform) {
|
|
264
|
+
const url = safeUrl(address);
|
|
265
|
+
if (!url)
|
|
266
|
+
return false;
|
|
267
|
+
try {
|
|
268
|
+
const [command, args] = platform === "darwin"
|
|
269
|
+
? ["open", [url.toString()]]
|
|
270
|
+
: platform === "win32"
|
|
271
|
+
? ["rundll32", ["url.dll,FileProtocolHandler", url.toString()]]
|
|
272
|
+
: ["xdg-open", [url.toString()]];
|
|
273
|
+
const child = spawn(command, args, { stdio: "ignore", detached: true, windowsHide: true });
|
|
274
|
+
child.on("error", () => undefined);
|
|
275
|
+
child.unref();
|
|
276
|
+
return true;
|
|
277
|
+
}
|
|
278
|
+
catch {
|
|
279
|
+
return false;
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
/**
|
|
283
|
+
* TELLAGEN_API_KEY and TELLAGEN_API_URL win over a stored sign-in. If only
|
|
284
|
+
* the address is set, the stored sign-in for that address is used. If
|
|
285
|
+
* neither is set, the current sign-in is used.
|
|
286
|
+
*/
|
|
287
|
+
export async function resolveCredentials(env, vault, index) {
|
|
288
|
+
const envKey = (env.TELLAGEN_API_KEY ?? "").trim();
|
|
289
|
+
const envUrl = (env.TELLAGEN_API_URL ?? "").trim();
|
|
290
|
+
if (envKey)
|
|
291
|
+
return { apiUrl: envUrl, apiKey: envKey, source: "environment" };
|
|
292
|
+
let account;
|
|
293
|
+
if (envUrl) {
|
|
294
|
+
try {
|
|
295
|
+
account = accountFor(envUrl);
|
|
296
|
+
}
|
|
297
|
+
catch {
|
|
298
|
+
return { apiUrl: envUrl, apiKey: "", source: "none" };
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
const found = index.find(account);
|
|
302
|
+
if (!found || !vault)
|
|
303
|
+
return { apiUrl: envUrl, apiKey: "", source: "none" };
|
|
304
|
+
try {
|
|
305
|
+
const key = await vault.load(found.account, found.entry.storage);
|
|
306
|
+
if (!key) {
|
|
307
|
+
return {
|
|
308
|
+
apiUrl: envUrl || found.entry.api_url,
|
|
309
|
+
apiKey: "",
|
|
310
|
+
source: "none",
|
|
311
|
+
problem: `The key of the sign-in for ${found.account} is not in the ${describeStore(found.entry.storage)} any more. Sign in again.`,
|
|
312
|
+
};
|
|
313
|
+
}
|
|
314
|
+
return { apiUrl: envUrl || found.entry.api_url, apiKey: key, source: "sign-in", account: found.account, entry: found.entry };
|
|
315
|
+
}
|
|
316
|
+
catch (err) {
|
|
317
|
+
return {
|
|
318
|
+
apiUrl: envUrl || found.entry.api_url,
|
|
319
|
+
apiKey: "",
|
|
320
|
+
source: "none",
|
|
321
|
+
problem: err instanceof Error ? err.message : "The stored key could not be read.",
|
|
322
|
+
};
|
|
323
|
+
}
|
|
324
|
+
}
|
|
325
|
+
/** The days until a date, rounded up; negative when it is past. */
|
|
326
|
+
export function daysUntil(iso, now = Date.now()) {
|
|
327
|
+
if (!iso)
|
|
328
|
+
return undefined;
|
|
329
|
+
const at = Date.parse(iso);
|
|
330
|
+
if (!Number.isFinite(at))
|
|
331
|
+
return undefined;
|
|
332
|
+
return Math.ceil((at - now) / 86_400_000);
|
|
333
|
+
}
|
|
334
|
+
/** The line for a key that is about to expire or has expired, or nothing. */
|
|
335
|
+
export function expiryLine(entry, now = Date.now()) {
|
|
336
|
+
const days = daysUntil(entry?.expires_at, now);
|
|
337
|
+
if (days === undefined)
|
|
338
|
+
return undefined;
|
|
339
|
+
if (days <= 0) {
|
|
340
|
+
return "The Tellagen sign-in on this computer has expired. Ask the person to sign in again (tellagen_sign_in).";
|
|
341
|
+
}
|
|
342
|
+
if (days < EXPIRY_WARNING_DAYS) {
|
|
343
|
+
return `The Tellagen sign-in on this computer expires in ${days} day${days === 1 ? "" : "s"}. Ask the person to sign in again (tellagen_sign_in) soon.`;
|
|
344
|
+
}
|
|
345
|
+
return undefined;
|
|
346
|
+
}
|
|
347
|
+
const defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms).unref?.());
|
|
348
|
+
/**
|
|
349
|
+
* Runs one sign-in at a time for a client. `begin` returns at once with the
|
|
350
|
+
* code to show; the polling goes on in the background and stores the key when
|
|
351
|
+
* the person approves. A later call asks how it went.
|
|
352
|
+
*/
|
|
353
|
+
export class SignInManager {
|
|
354
|
+
client;
|
|
355
|
+
options;
|
|
356
|
+
flow;
|
|
357
|
+
cancelled = false;
|
|
358
|
+
constructor(client, options) {
|
|
359
|
+
this.client = client;
|
|
360
|
+
this.options = options;
|
|
361
|
+
}
|
|
362
|
+
env() {
|
|
363
|
+
return this.options.env ?? process.env;
|
|
364
|
+
}
|
|
365
|
+
/** Stops the polling. The server calls it when the client disconnects. */
|
|
366
|
+
cancel() {
|
|
367
|
+
this.cancelled = true;
|
|
368
|
+
}
|
|
369
|
+
/** The state of the sign-in without starting one. */
|
|
370
|
+
current() {
|
|
371
|
+
return this.flow ? this.view(this.flow) : undefined;
|
|
372
|
+
}
|
|
373
|
+
view(flow) {
|
|
374
|
+
const out = { status: flow.status, message: flow.message };
|
|
375
|
+
if (flow.status === "waiting") {
|
|
376
|
+
out.user_code = flow.start.userCode;
|
|
377
|
+
out.verification_uri = flow.start.verificationUri;
|
|
378
|
+
out.verification_uri_complete = flow.start.verificationUriComplete;
|
|
379
|
+
const left = flow.start.expiresInSeconds - Math.floor(((this.options.now?.() ?? Date.now()) - flow.startedAt) / 1000);
|
|
380
|
+
out.expires_in_seconds = Math.max(0, left);
|
|
381
|
+
out.opened_browser = flow.openedBrowser;
|
|
382
|
+
}
|
|
383
|
+
if (flow.reason)
|
|
384
|
+
out.reason = flow.reason;
|
|
385
|
+
if (flow.result) {
|
|
386
|
+
out.workspace = flow.result.workspace;
|
|
387
|
+
out.api_url = flow.result.apiUrl;
|
|
388
|
+
out.key_expires_at = flow.result.keyExpiresAt;
|
|
389
|
+
out.storage = flow.result.storage;
|
|
390
|
+
if (flow.result.notice)
|
|
391
|
+
out.storage_notice = flow.result.notice;
|
|
392
|
+
}
|
|
393
|
+
return out;
|
|
394
|
+
}
|
|
395
|
+
/**
|
|
396
|
+
* Starts a sign-in, or reports the one that runs. With `waitMs` it waits
|
|
397
|
+
* that long for the person to approve before it answers.
|
|
398
|
+
*/
|
|
399
|
+
async begin(args) {
|
|
400
|
+
const env = this.env();
|
|
401
|
+
if ((env.TELLAGEN_API_KEY ?? "").trim()) {
|
|
402
|
+
return {
|
|
403
|
+
status: "failed",
|
|
404
|
+
message: "TELLAGEN_API_KEY is set in the environment of this MCP server. It wins over a sign-in, so a sign-in would change nothing. Remove TELLAGEN_API_KEY from the MCP server settings to sign in with the browser.",
|
|
405
|
+
};
|
|
406
|
+
}
|
|
407
|
+
if (!this.flow || this.flow.status !== "waiting" || args.restart) {
|
|
408
|
+
if (this.flow?.status === "signed_in" && !args.restart) {
|
|
409
|
+
// The last flow worked; report it.
|
|
410
|
+
return this.view(this.flow);
|
|
411
|
+
}
|
|
412
|
+
this.flow = await this.start(args);
|
|
413
|
+
}
|
|
414
|
+
const flow = this.flow;
|
|
415
|
+
if (args.waitMs && flow.status === "waiting") {
|
|
416
|
+
await Promise.race([flow.done, (this.options.sleep ?? defaultSleep)(args.waitMs)]);
|
|
417
|
+
}
|
|
418
|
+
return this.view(flow);
|
|
419
|
+
}
|
|
420
|
+
async start(args) {
|
|
421
|
+
const fetchFn = this.options.fetch ?? fetch;
|
|
422
|
+
const baseUrl = signInBaseUrl(this.env(), args.baseUrl);
|
|
423
|
+
const identity = this.client.session.identity;
|
|
424
|
+
const facts = { name: identity?.name ?? "mcp-client", version: identity?.version ?? "" };
|
|
425
|
+
const start = await startDeviceSignIn(baseUrl, facts, fetchFn);
|
|
426
|
+
const allowBrowser = args.openBrowser !== false && (this.options.canOpenBrowser ?? (() => canOpenBrowser(this.env())))();
|
|
427
|
+
const opened = allowBrowser ? (this.options.openBrowser ?? openInBrowser)(start.verificationUriComplete) : false;
|
|
428
|
+
const flow = {
|
|
429
|
+
baseUrl,
|
|
430
|
+
start,
|
|
431
|
+
startedAt: this.options.now?.() ?? Date.now(),
|
|
432
|
+
openedBrowser: opened,
|
|
433
|
+
status: "waiting",
|
|
434
|
+
message: opened
|
|
435
|
+
? "A browser window was opened. Tell the person to check that the code on the page matches the code below, then approve."
|
|
436
|
+
: "Tell the person to open the address below in a browser, check that the code on the page matches the code below, then approve.",
|
|
437
|
+
done: Promise.resolve(),
|
|
438
|
+
};
|
|
439
|
+
this.cancelled = false;
|
|
440
|
+
flow.done = this.poll(flow, fetchFn).catch(() => undefined);
|
|
441
|
+
return flow;
|
|
442
|
+
}
|
|
443
|
+
async poll(flow, fetchFn) {
|
|
444
|
+
const sleep = this.options.sleep ?? defaultSleep;
|
|
445
|
+
const now = this.options.now ?? Date.now;
|
|
446
|
+
let interval = flow.start.intervalSeconds;
|
|
447
|
+
let failures = 0;
|
|
448
|
+
const deadline = flow.startedAt + (flow.start.expiresInSeconds + 15) * 1000;
|
|
449
|
+
try {
|
|
450
|
+
while (!this.cancelled && now() < deadline) {
|
|
451
|
+
await sleep(interval * 1000);
|
|
452
|
+
if (this.cancelled)
|
|
453
|
+
return;
|
|
454
|
+
let result;
|
|
455
|
+
try {
|
|
456
|
+
result = await pollDeviceToken(flow.baseUrl, flow.start.deviceCode, fetchFn);
|
|
457
|
+
failures = 0;
|
|
458
|
+
}
|
|
459
|
+
catch (err) {
|
|
460
|
+
if (err instanceof SignInError && err.code === "network" && ++failures < MAX_POLL_FAILURES)
|
|
461
|
+
continue;
|
|
462
|
+
throw err;
|
|
463
|
+
}
|
|
464
|
+
if (result.state === "pending") {
|
|
465
|
+
interval = result.intervalSeconds;
|
|
466
|
+
continue;
|
|
467
|
+
}
|
|
468
|
+
await this.finish(flow, result.signIn);
|
|
469
|
+
return;
|
|
470
|
+
}
|
|
471
|
+
if (!this.cancelled) {
|
|
472
|
+
flow.status = "expired";
|
|
473
|
+
flow.message = "The code expired before it was approved. Call tellagen_sign_in again to get a new one.";
|
|
474
|
+
}
|
|
475
|
+
}
|
|
476
|
+
catch (err) {
|
|
477
|
+
if (err instanceof SignInError) {
|
|
478
|
+
flow.status = err.code === "expired" ? "expired" : err.code === "denied" ? "denied" : "failed";
|
|
479
|
+
flow.reason = err.reason;
|
|
480
|
+
flow.message =
|
|
481
|
+
err.code === "denied"
|
|
482
|
+
? `${err.message} The key was not created.`
|
|
483
|
+
: `${err.message}${err.code === "expired" || err.code === "invalid_device_code" ? " Call tellagen_sign_in again for a new code." : ""}`;
|
|
484
|
+
}
|
|
485
|
+
else {
|
|
486
|
+
flow.status = "failed";
|
|
487
|
+
flow.message = "The sign-in failed. Call tellagen_sign_in again.";
|
|
488
|
+
}
|
|
489
|
+
}
|
|
490
|
+
}
|
|
491
|
+
async finish(flow, approved) {
|
|
492
|
+
const vault = this.options.vault;
|
|
493
|
+
if (!vault)
|
|
494
|
+
throw new SignInError("storage", "No key storage is available in this process.");
|
|
495
|
+
const account = accountFor(approved.apiUrl);
|
|
496
|
+
let saved;
|
|
497
|
+
try {
|
|
498
|
+
saved = await vault.save(account, approved.apiKey.reveal());
|
|
499
|
+
}
|
|
500
|
+
catch (err) {
|
|
501
|
+
throw new SignInError("storage", `${err instanceof Error ? err.message : "The key could not be stored."} Sign in again, or set TELLAGEN_API_KEY.`);
|
|
502
|
+
}
|
|
503
|
+
const at = new Date((this.options.now?.() ?? Date.now())).toISOString();
|
|
504
|
+
this.options.index.save(account, {
|
|
505
|
+
api_url: approved.apiUrl,
|
|
506
|
+
workspace_name: approved.workspaceName,
|
|
507
|
+
workspace_url: approved.workspaceUrl,
|
|
508
|
+
signed_in_at: at,
|
|
509
|
+
expires_at: approved.keyExpiresAt,
|
|
510
|
+
storage: saved.kind,
|
|
511
|
+
});
|
|
512
|
+
this.client.setCredentials({ apiUrl: approved.apiUrl, apiKey: approved.apiKey.reveal() });
|
|
513
|
+
this.client.session.setNotice(expiryLine({ expires_at: approved.keyExpiresAt }, this.options.now?.() ?? Date.now()));
|
|
514
|
+
void this.client.checkAuth();
|
|
515
|
+
flow.status = "signed_in";
|
|
516
|
+
flow.message = `Signed in${approved.workspaceName ? ` to ${approved.workspaceName}` : ""}. The key is stored in the ${describeStore(saved.kind)}. The Tellagen tools work now.`;
|
|
517
|
+
flow.result = {
|
|
518
|
+
workspace: approved.workspaceName,
|
|
519
|
+
apiUrl: approved.apiUrl,
|
|
520
|
+
keyExpiresAt: approved.keyExpiresAt,
|
|
521
|
+
storage: describeStore(saved.kind),
|
|
522
|
+
notice: saved.fileNotice,
|
|
523
|
+
};
|
|
524
|
+
}
|
|
525
|
+
}
|
|
526
|
+
/**
|
|
527
|
+
* Signs out: the key leaves the keychain and the index, and the client keeps
|
|
528
|
+
* nothing. Tellagen's API does not let a key revoke itself, so the key stays
|
|
529
|
+
* valid on the server until a person revokes it in Tellagen. The answer says
|
|
530
|
+
* so.
|
|
531
|
+
*/
|
|
532
|
+
export async function signOut(vault, index, account) {
|
|
533
|
+
const targets = account ? [account] : index.list().map((item) => item.account);
|
|
534
|
+
for (const name of targets) {
|
|
535
|
+
await vault?.remove(name);
|
|
536
|
+
index.remove(name);
|
|
537
|
+
}
|
|
538
|
+
return { signedOut: targets, remaining: index.list().map((item) => item.account) };
|
|
539
|
+
}
|
|
540
|
+
export const KEY_NOT_REVOKED_NOTE = "The key was removed from this computer. Tellagen keeps it valid until it expires or a person revokes it: in Tellagen, open Settings > Local diagnosis, find the client under Connected clients, and use Sign out there. That revokes the key.";
|
|
541
|
+
//# sourceMappingURL=signin.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"signin.js","sourceRoot":"","sources":["../src/signin.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { TellagenClient } from "./client.js";
|
|
3
|
+
/**
|
|
4
|
+
* The browser addresses of the integrations of a workspace.
|
|
5
|
+
*
|
|
6
|
+
* A pickup answer and the context read of a run carry them as `source_bases`:
|
|
7
|
+
* the enabled Grafana and GitHub addresses, so a source link needs no address
|
|
8
|
+
* in the client environment. A Tellagen that predates the field sends none,
|
|
9
|
+
* and the client then works as it did before.
|
|
10
|
+
*/
|
|
11
|
+
export declare const SOURCE_BASE_KINDS: readonly ["grafana", "github"];
|
|
12
|
+
export type SourceBaseKind = (typeof SOURCE_BASE_KINDS)[number];
|
|
13
|
+
export declare const MAX_SOURCE_BASES = 10;
|
|
14
|
+
/** The schema of a base as it is kept in the state file. */
|
|
15
|
+
export declare const sourceBaseSchema: z.ZodObject<{
|
|
16
|
+
kind: z.ZodEnum<["grafana", "github"]>;
|
|
17
|
+
name: z.ZodString;
|
|
18
|
+
base_url: z.ZodString;
|
|
19
|
+
network: z.ZodOptional<z.ZodString>;
|
|
20
|
+
repositories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
21
|
+
}, "strip", z.ZodTypeAny, {
|
|
22
|
+
name: string;
|
|
23
|
+
kind: "grafana" | "github";
|
|
24
|
+
base_url: string;
|
|
25
|
+
network?: string | undefined;
|
|
26
|
+
repositories?: string[] | undefined;
|
|
27
|
+
}, {
|
|
28
|
+
name: string;
|
|
29
|
+
kind: "grafana" | "github";
|
|
30
|
+
base_url: string;
|
|
31
|
+
network?: string | undefined;
|
|
32
|
+
repositories?: string[] | undefined;
|
|
33
|
+
}>;
|
|
34
|
+
export type SourceBase = z.infer<typeof sourceBaseSchema>;
|
|
35
|
+
/** Where an address came from. */
|
|
36
|
+
export type AddressSource = "pickup" | "GRAFANA_URL" | "datasource";
|
|
37
|
+
/**
|
|
38
|
+
* Keeps the usable bases of a `source_bases` value. A kind this client does not
|
|
39
|
+
* know, an address that is not http or https, a reserved example address and
|
|
40
|
+
* an entry with no name are dropped; credentials, query and fragment are
|
|
41
|
+
* removed from the address. Anything that is not a list gives an empty list.
|
|
42
|
+
*/
|
|
43
|
+
export declare function cleanSourceBases(raw: unknown): SourceBase[];
|
|
44
|
+
/** The bases of a pickup answer or a context read, from the top level of the response. */
|
|
45
|
+
export declare function sourceBasesOf(response: unknown): SourceBase[];
|
|
46
|
+
/**
|
|
47
|
+
* The bases this process knows for a run: the ones of its own pickup or
|
|
48
|
+
* context read, else the ones in the state file when it names the run. With no
|
|
49
|
+
* run, or a run this computer never picked up, the answer is an empty list.
|
|
50
|
+
*/
|
|
51
|
+
export declare function knownSourceBases(client: TellagenClient, runId?: string): SourceBase[];
|
|
52
|
+
/** Remembers the bases of a pickup answer or a context read for a run. */
|
|
53
|
+
export declare function rememberSourceBases(client: TellagenClient, runId: string, response: unknown): void;
|
|
54
|
+
export type GrafanaBaseChoice = {
|
|
55
|
+
base: SourceBase;
|
|
56
|
+
ambiguous?: undefined;
|
|
57
|
+
} | {
|
|
58
|
+
base?: undefined;
|
|
59
|
+
ambiguous: string[];
|
|
60
|
+
} | {
|
|
61
|
+
base?: undefined;
|
|
62
|
+
ambiguous?: undefined;
|
|
63
|
+
};
|
|
64
|
+
/**
|
|
65
|
+
* The Grafana base to use. With a connector name, the base of that name. With
|
|
66
|
+
* none, the only Grafana base; several of them are ambiguous and the caller
|
|
67
|
+
* decides (an explicit address, or asking for a connector).
|
|
68
|
+
*/
|
|
69
|
+
export declare function chooseGrafanaBase(bases: readonly SourceBase[], connector?: string): GrafanaBaseChoice;
|
|
70
|
+
/**
|
|
71
|
+
* The GitHub address for a repository: the base that lists the repository, else
|
|
72
|
+
* the only GitHub base that lists none. With several candidates there is no
|
|
73
|
+
* choice, and the link goes to github.com as before.
|
|
74
|
+
*/
|
|
75
|
+
export declare function chooseGithubBase(bases: readonly SourceBase[], repo: string): SourceBase | undefined;
|