@deslop/scope 0.1.1204 → 0.1.1206

package/README.md

@@ -23,9 +23,7 @@ The public `/.well-known/oauth-protected-resource/mcp` document names the author
 | Tool              | Returns                                                                                                    |
 | ----------------- | ---------------------------------------------------------------------------------------------------------- |
 | `list_services`   | Every stored service's latest run, runtime, last event time and entry count, plus rejected-export counters |
-| `find_traces`     | Matching traces, newest or slowest first, with the total match count                                       |
-| `find_spans`      | Matching spans with their original OTLP fields                                                             |
-| `find_logs`       | Matching logs, standalone or attached to a span                                                            |
+| `find`            | Matching traces, spans with their OTLP fields, or logs, newest or slowest first, with the total count      |
 | `measure_latency` | Span count, errors and p50, p95 and max latency over the whole window                                      |
 | `read_trace`      | One stored trace whole, including earlier runs, with parent order, offsets and logs                        |
 

package/dist/server.js

@@ -14421,6 +14421,23 @@ globalThis.String;
 */
 const isString$1 = isString$2;
 /**
+* Converts a string to uppercase.
+*
+* **Example** (Converting strings to uppercase)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("a", String.toUpperCase) // => "A"
+* String.toUpperCase("hello") // => "HELLO"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const toUpperCase = (self) => self.toUpperCase();
+/**
 * Converts a string to lowercase.
 *
 * **Example** (Converting strings to lowercase)
@@ -14438,6 +14455,27 @@ const isString$1 = isString$2;
 */
 const toLowerCase = (self) => self.toLowerCase();
 /**
+* Capitalizes the first character (Unicode code point) of a string.
+*
+* **Example** (Capitalizing a string)
+*
+* ```ts import.meta.vitest
+* import { pipe, String } from "effect"
+*
+* pipe("abc", String.capitalize) // => "Abc"
+* String.capitalize("hello") // => "Hello"
+* String.capitalize("𐐨foo") // => "𐐀foo"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const capitalize = (self) => {
+	const [first = ""] = self;
+	return toUpperCase(first) + self.slice(first.length);
+};
+/**
 * Checks whether a `string` is non-empty.
 *
 * **Example** (Checking for non-empty strings)
@@ -71316,6 +71354,8 @@ const User = Struct({
 	name: NonEmptyString
 });
 const Resource$1 = Literals([
+	"https://gateway.mp281x.xyz",
+	"https://gateway.mp281x.xyz/mcp",
 	"https://stash.mp281x.xyz",
 	"https://stash.mp281x.xyz/mcp",
 	"https://opm.mp281x.xyz",
@@ -71428,11 +71468,11 @@ const previewAuth = fnUntraced(function* (resource, issuerUrl, client) {
 		if (next.origin !== origin || next.username !== "" || next.password !== "") return yield* expired();
 		if (isNone(address(request.headers))) {
 			if (request.headers["host"] !== new URL(resource).host) return yield* expired();
-			return redirect(`${AUTH_URL}/auth/github?${new URLSearchParams({ next: next.href })}`);
+			return redirect(`${AUTH_URL}/?${new URLSearchParams({ next: next.href })}`);
 		}
 		const callback = `${origin}/auth/callback`;
 		const registration = yield* pipe(post(`${issuerUrl}/api/auth/oauth2/register`), bodyJson({
-			client_name: `${new URL(resource).hostname} ${origin}`,
+			client_name: `${capitalize(headNonEmpty(split(new URL(resource).hostname, ".")))} preview`,
 			redirect_uris: [callback],
 			token_endpoint_auth_method: "none"
 		}), flatMap$1((value) => client.execute(value)), flatMap$1(schemaBodyJson$1(ClientRegistration)), timeout("10 seconds"));
@@ -71673,7 +71713,7 @@ const layerNodeHttpServer = layerConfig(createServer, {
 	port: pipe(Port("PORT"), withDefault(5e3))
 });
 // package.json
-var version = "0.1.1204";
+var version = "0.1.1206";
 // src/services/telemetry/schema.ts
 var TelemetryError = class extends TaggedError()("TelemetryError", {
 	cause: optional$6(Defect()),
@@ -71766,7 +71806,10 @@ const Query = Struct({
 		maximum: 1e3,
 		minimum: 1
 	}))),
-	offset: Natural,
+	offset: pipe(Int, check(isBetween({
+		maximum: 1e5,
+		minimum: 0
+	}))),
 	operation: String$2,
 	runs: Literals(["current", "all"]),
 	service: String$2,
@@ -71857,13 +71900,12 @@ const Filters = Struct({
 	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("")), annotateEncoded({ description: "Only entries of this trace." }))
 });
-const PageFilters = Struct({
-	...Filters.fields,
-	limit: pipe(Query.fields.limit, withDecodingDefaultTypeKey(succeed$4(20)), annotateEncoded({ description: "Page size, 1 to 1000." })),
-	offset: pipe(Query.fields.offset, withDecodingDefaultTypeKey(succeed$4(0)), annotateEncoded({ description: "Entries to skip, for the next page." }))
-});
 const SortFilters = Struct({
-	...PageFilters.fields,
+	...Struct({
+		...Filters.fields,
+		limit: pipe(Query.fields.limit, withDecodingDefaultTypeKey(succeed$4(20)), annotateEncoded({ description: "Page size, 1 to 1000." })),
+		offset: pipe(Query.fields.offset, withDecodingDefaultTypeKey(succeed$4(0)), annotateEncoded({ description: "Entries to skip, for the next page." }))
+	}).fields,
 	sort: pipe(Query.fields.sort, withDecodingDefaultTypeKey(succeed$4("recent")), annotateEncoded({ description: "\"recent\" puts the newest first, \"slowest\" the longest first." }))
 });
 // src/services/telemetry/lib/utils.ts
@@ -72190,31 +72232,28 @@ var Telemetry = class extends Service$2()("@deslop/scope/services/telemetry/serv
 };
 // src/tools/contracts.ts
 const Tools = make$6(make$7("list_services", {
-	description: "Check ingestion first: every stored service, its runtime, latest run, last event time and entry count. Event/run times use the exporter clock (Unix nanoseconds), not receiver arrival time. Rejected OTLP requests are grouped by route, HTTP status and credential-header presence, never attributed to an app. Rejection counters and since (Unix milliseconds) reset when Scope restarts. A missing service has no telemetry kept from the last three days: check the rejections above and its exporter before concluding it sent nothing.",
+	description: "Start here: each service with its latest run, last event and entry count, plus rejected exports. A service missing here sent nothing in the last three days.",
 	failure: TelemetryError,
 	success: IngestionStatus
-}).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.",
+}).annotate(Readonly, true), make$7("find", {
+	description: "Find traces (one request or action each), single spans with their attributes, or logs, newest or slowest first; searches the latest run of each service unless runs is \"all\". Open a trace with read_trace.",
 	failure: TelemetryError,
-	parameters: SortFilters,
-	success: TracesPage
+	parameters: Struct({
+		...SortFilters.fields,
+		kind: Literals([
+			"traces",
+			"spans",
+			"logs"
+		]).annotate({ description: "What to find." })
+	}),
+	success: Union([TracesPage, Page])
 }).annotate(Readonly, true), make$7("read_trace", {
-	description: "Read one stored trace whole, including earlier runs: every span in parent order with its depth, start offset, runtime and logs. Shows where an action spent its time and which span failed.",
+	description: "One trace whole: every span in order with its depth, offset, duration and logs.",
 	failure: TelemetryError,
-	parameters: Struct({ id: pipe(TraceId, annotateEncoded({ description: "The 32-character id from find_traces or a span." })) }),
+	parameters: Struct({ id: pipe(TraceId, annotateEncoded({ description: "The 32-character id from find." })) }),
 	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("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.",
+	description: "Count, errors and p50, p95 and max milliseconds of the matching spans; run it before and after a change to compare.",
 	failure: TelemetryError,
 	parameters: Filters,
 	success: Stats
@@ -72234,9 +72273,7 @@ const query = fnUntraced(function* (filters) {
 const ToolHandlers = Tools.toLayer(gen(function* () {
 	const telemetry = yield* Telemetry;
 	return Tools.of({
-		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),
+		find: (input) => flatMap$1(query(input), (filters) => pipe(value(input.kind), when("traces", () => telemetry.traces(filters)), when("spans", () => telemetry.spans(filters)), when("logs", () => telemetry.logs(filters)), exhaustive)),
 		list_services: () => telemetry.services(),
 		measure_latency: (filters) => flatMap$1(query(filters), telemetry.stats),
 		read_trace: (input) => telemetry.trace(input.id)
@@ -72285,7 +72322,7 @@ const observe = make$27((app) => pipe(app, onExit$1((exit) => gen(function* () {
 	});
 }))));
 const mcp = layerMcp({
-	instructions: "Scope is the debugger for the user's Effect apps. Start with list_services for ingestion freshness and rejected exports, then reproduce the action and use find_traces/read_trace or find_logs. Searches default to each service's latest process/page load/app launch; runs: all includes retained earlier runs in the lookback. read_trace always opens the whole stored trace. Use measure_latency on the same operation before and after a change. If tools are missing, check the client's MCP connection/authentication; stored OAuth credentials alone do not prove a working connection.",
+	instructions: "Scope is the debugger for the user's Effect apps: their traces, spans and logs.",
 	name: "scope",
 	registrations: pipe(toolkit(Tools), provide$2(ToolHandlers)),
 	version

package/package.json

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