@deslop/scope 0.1.1102 → 0.1.1107

package/dist/server.js

@@ -67036,7 +67036,6 @@ const Resource$1 = Literals([
 	"https://stash.mp281x.xyz",
 	"https://stash.mp281x.xyz/mcp",
 	"https://scope.mp281x.xyz/mcp",
-	"https://portfolio.mp281x.xyz/mcp",
 	"https://otel.mp281x.xyz"
 ]);
 const authorizationFields = {
@@ -67223,7 +67222,11 @@ var Auth = class Auth extends Service$2()("@deslop/auth/service/Auth") {
 	static layer = (resource) => effectContext(gen(function* () {
 		const url = yield* pipe(String$1("AUTH_URL"), withDefault(AUTH_URL));
 		const client = filterStatusOk(yield* HttpClient);
-		const origins = [new URL(url).origin, ...map$5(Resource$1.literals, (identifier) => new URL(identifier).origin)];
+		const origins = [
+			new URL(url).origin,
+			"https://portfolio.mp281x.xyz",
+			...map$5(Resource$1.literals, (identifier) => new URL(identifier).origin)
+		];
 		const access = fn("Auth.access")(function* (headers, audience) {
 			return yield* pipe(client.get(`${url}/auth/verify`, {
 				headers: { authorization: headers["authorization"] ?? "" },
@@ -67253,7 +67256,6 @@ var Auth = class Auth extends Service$2()("@deslop/auth/service/Auth") {
 			users: Array$1(String$2, "GITHUB_USERS")
 		});
 		yield* sql`CREATE TABLE IF NOT EXISTS auth_state (hash TEXT PRIMARY KEY, payload TEXT NOT NULL, expires_at INTEGER NOT NULL)`;
-		yield* sql`DELETE FROM auth_state WHERE json_extract(payload, '$._tag') = 'Request' AND json_extract(payload, '$.id') IS NULL`;
 		const hash = fnUntraced(function* (value) {
 			return encode(yield* random.digest("SHA-256", new TextEncoder().encode(value)));
 		});
@@ -67711,7 +67713,7 @@ const layerNodeHttpServer = layerConfig(createServer, {
 });
 //#endregion
 //#region package.json
-var version = "0.1.1102";
+var version = "0.1.1107";
 //#endregion
 //#region src/services/telemetry/schema.ts
 var TelemetryError = class extends TaggedError()("TelemetryError", {
@@ -67863,19 +67865,19 @@ const StoredEntry = Struct({ json: fromJsonString(Entry) });
 const Filters = Struct({
 	errors: pipe(Query.fields.errors, withDecodingDefaultTypeKey(succeed$4(false)), annotateEncoded({ description: "Only failed spans and error logs." })),
 	operation: pipe(Query.fields.operation, withDecodingDefaultTypeKey(succeed$4("")), annotateEncoded({ description: "Exact span name." })),
-	service: pipe(Query.fields.service, withDecodingDefaultTypeKey(succeed$4("")), annotateEncoded({ description: "Exact service name, from the services tool." })),
+	service: pipe(Query.fields.service, withDecodingDefaultTypeKey(succeed$4("")), annotateEncoded({ description: "Exact service name, from list_services." })),
 	since: pipe(DurationFromString, check(makeFilter(isFinite$1, { expected: "a finite duration" })), withDecodingDefaultTypeKey(succeed$4(minutes(10))), annotateEncoded({ description: "Lookback, such as \"10 minutes\" or \"1 hour\"." })),
 	text: pipe(Query.fields.text, withDecodingDefaultTypeKey(succeed$4("")), annotateEncoded({ description: "Case-insensitive text in the span name, log message or attributes." })),
-	traceId: pipe(Query.fields.traceId, withDecodingDefaultTypeKey(succeed$4("")))
+	traceId: pipe(Query.fields.traceId, withDecodingDefaultTypeKey(succeed$4("")), annotateEncoded({ description: "Only entries of this trace." }))
 });
 const PageFilters = Struct({
 	...Filters.fields,
 	limit: pipe(Query.fields.limit, withDecodingDefaultTypeKey(succeed$4(100)), annotateEncoded({ description: "Page size, 1 to 1000." })),
-	offset: pipe(Query.fields.offset, withDecodingDefaultTypeKey(succeed$4(0)))
+	offset: pipe(Query.fields.offset, withDecodingDefaultTypeKey(succeed$4(0)), annotateEncoded({ description: "Entries to skip, for the next page." }))
 });
 const SortFilters = Struct({
 	...PageFilters.fields,
-	sort: pipe(Query.fields.sort, withDecodingDefaultTypeKey(succeed$4("recent")))
+	sort: pipe(Query.fields.sort, withDecodingDefaultTypeKey(succeed$4("recent")), annotateEncoded({ description: "\"recent\" puts the newest first, \"slowest\" the longest first." }))
 });
 //#endregion
 //#region src/services/telemetry/lib/utils.ts
@@ -68125,35 +68127,35 @@ var Telemetry = class extends Service$2()("@deslop/scope/services/telemetry/serv
 };
 //#endregion
 //#region src/tools/contracts.ts
-const Tools = make$6(make$7("services", {
-	description: "List the services with current runs and their runtime: web, mobile or server.",
+const Tools = make$6(make$7("list_services", {
+	description: "List the apps sending telemetry in their current run, with their runtime: web, mobile or server. Call it first: the other tools filter by these exact names.",
 	failure: TelemetryError,
 	success: Struct({ services: ArraySchema(Service) })
-}).annotate(Readonly, true), make$7("traces", {
-	description: "Search traces, newest or slowest first. The total counts every match; page with offset.",
+}).annotate(Readonly, true), make$7("find_traces", {
+	description: "Find traces, each one request or user action across client and server, newest or slowest first. Call it after reproducing a bug, or with sort \"slowest\" before claiming an action is fast; then open one with read_trace.",
 	failure: TelemetryError,
 	parameters: SortFilters,
 	success: TracesPage
-}).annotate(Readonly, true), make$7("spans", {
-	description: "Search single spans with their original OTLP fields.",
+}).annotate(Readonly, true), make$7("read_trace", {
+	description: "Read one trace whole: every span in parent order with its depth, start offset, runtime and logs. Shows where an action spent its time and which span failed.",
 	failure: TelemetryError,
-	parameters: SortFilters,
-	success: Page
-}).annotate(Readonly, true), make$7("logs", {
-	description: "Search logs, standalone or attached to a span, newest first.",
+	parameters: Struct({ id: pipe(TraceId, annotateEncoded({ description: "The 32-character id from find_traces or a span." })) }),
+	success: Trace
+}).annotate(Readonly, true), make$7("find_logs", {
+	description: "Find what the apps logged, newest first, with or without a span; errors: true keeps only failures. Call it to see what happened during a reproduced bug.",
 	failure: TelemetryError,
 	parameters: PageFilters,
 	success: Page
-}).annotate(Readonly, true), make$7("stats", {
-	description: "Span count, errors and p50, p95 and max latency over the whole window.",
+}).annotate(Readonly, true), make$7("find_spans", {
+	description: "Find single spans with their original OTLP attributes and events, when one operation matters more than its trace, such as every failed call to one endpoint.",
+	failure: TelemetryError,
+	parameters: SortFilters,
+	success: Page
+}).annotate(Readonly, true), make$7("measure_latency", {
+	description: "Count, errors and p50, p95 and max latency of the matching spans over the lookback. Run it on the same operation before and after a change to prove it got faster.",
 	failure: TelemetryError,
 	parameters: Filters,
 	success: Stats
-}).annotate(Readonly, true), make$7("trace", {
-	description: "Read one trace whole: spans in parent order with depth, offset, runtime and their logs. No window or cap.",
-	failure: TelemetryError,
-	parameters: Struct({ id: TraceId }),
-	success: Trace
 }).annotate(Readonly, true));
 //#endregion
 //#region src/tools/handlers.ts
@@ -68171,12 +68173,12 @@ const query = fnUntraced(function* (filters) {
 const ToolHandlers = Tools.toLayer(gen(function* () {
 	const telemetry = yield* Telemetry;
 	return Tools.of({
-		logs: (filters) => flatMap$1(query(filters), telemetry.logs),
-		services: () => map$2(telemetry.services(), (services) => ({ services })),
-		spans: (filters) => flatMap$1(query(filters), telemetry.spans),
-		stats: (filters) => flatMap$1(query(filters), telemetry.stats),
-		trace: (input) => telemetry.trace(input.id),
-		traces: (filters) => flatMap$1(query(filters), telemetry.traces)
+		find_logs: (filters) => flatMap$1(query(filters), telemetry.logs),
+		find_spans: (filters) => flatMap$1(query(filters), telemetry.spans),
+		find_traces: (filters) => flatMap$1(query(filters), telemetry.traces),
+		list_services: () => map$2(telemetry.services(), (services) => ({ services })),
+		measure_latency: (filters) => flatMap$1(query(filters), telemetry.stats),
+		read_trace: (input) => telemetry.trace(input.id)
 	});
 }));
 //#endregion
@@ -68221,7 +68223,7 @@ const receiver = use((router) => gen(function* () {
 	yield* router.add("GET", "/health", text("ready"));
 }));
 const mcp = pipe(toolkit(Tools), provide$3(ToolHandlers), provide$3(layerMcp({
-	instructions: "Scope receives OTLP/HTTP JSON traces and logs from Effect apps in development and keeps only the current run of each app. Start with services, then traces; read one trace whole with trace.",
+	instructions: "Scope is the debugger for the user's Effect apps: each app's web, mobile and server code exports its traces and logs here, and Scope keeps only the current run of each app. Use it to see what the code actually did instead of guessing: reproduce the action, then list_services, find_traces and read_trace; find_logs for what the app said; measure_latency before and after a change to prove it got faster.",
 	name: "scope",
 	version
 })));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deslop/scope",
-  "version": "0.1.1102",
+  "version": "0.1.1107",
   "description": "An Effect development debugger: an OTLP/HTTP JSON receiver whose traces and logs agents query over MCP.",
   "repository": {
     "type": "git",