@vforsh/argus-core 0.2.0 → 0.4.0

package/dist/http/fetch.js

@@ -1,3 +1,45 @@
+/**
+ * Thrown when the server answered with a non-2xx status.
+ *
+ * Distinct from a transport failure (connection refused, DNS, timeout): the peer is
+ * alive and rejected this specific request. Callers that treat failures as liveness
+ * signals — such as registry pruning — must not evict a peer that threw this.
+ */
+export class HttpResponseError extends Error {
+    /** HTTP status code returned by the server. */
+    status;
+    /** Brand, so the check survives two copies of this module in one process. */
+    isHttpResponseError = true;
+    constructor(message, status) {
+        super(message);
+        this.name = 'HttpResponseError';
+        this.status = status;
+    }
+}
+/** Type guard for {@link HttpResponseError} that tolerates duplicate module instances. */
+export const isHttpResponseError = (error) => error != null && typeof error === 'object' && error.isHttpResponseError === true;
+/**
+ * Thrown when a request exceeded its timeout budget.
+ *
+ * Distinct from a connection failure: a slow endpoint on a perfectly healthy peer produces this,
+ * so callers that treat failures as liveness signals — registry pruning — must not evict on it.
+ * Typed rather than message-matched because `fetch`'s connection errors carry runtime-specific
+ * shapes (Bun sets `code: 'ConnectionRefused'`, Node nests an errno under `cause`), so the timeout
+ * is the one failure we can identify reliably ourselves.
+ */
+export class HttpTimeoutError extends Error {
+    /** The budget that elapsed, in milliseconds. */
+    timeoutMs;
+    /** Brand, so the check survives two copies of this module in one process. */
+    isHttpTimeoutError = true;
+    constructor(timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms`);
+        this.name = 'HttpTimeoutError';
+        this.timeoutMs = timeoutMs;
+    }
+}
+/** Type guard for {@link HttpTimeoutError} that tolerates duplicate module instances. */
+export const isHttpTimeoutError = (error) => error != null && typeof error === 'object' && error.isHttpTimeoutError === true;
 export const fetchJson = async (url, options = {}) => {
     const controller = new AbortController();
     const timeoutMs = options.timeoutMs ?? 5_000;
@@ -15,13 +57,13 @@ export const fetchJson = async (url, options = {}) => {
                 return (await response.json());
             }
             const errorMessage = await extractErrorMessage(response);
-            throw new Error(errorMessage ?? `Request failed (${response.status} ${response.statusText})`);
+            throw new HttpResponseError(errorMessage ?? `Request failed (${response.status} ${response.statusText})`, response.status);
         }
         return (await response.json());
     }
     catch (error) {
         if (isAbortError(error)) {
-            throw new Error(`Request timed out after ${timeoutMs}ms`);
+            throw new HttpTimeoutError(timeoutMs);
         }
         throw error;
     }
@@ -42,13 +84,13 @@ export const fetchText = async (url, options = {}) => {
             headers: body ? { 'Content-Type': 'application/json' } : undefined,
         });
         if (!response.ok) {
-            throw new Error(`Request failed (${response.status} ${response.statusText})`);
+            throw new HttpResponseError(`Request failed (${response.status} ${response.statusText})`, response.status);
         }
         return await response.text();
     }
     catch (error) {
         if (isAbortError(error)) {
-            throw new Error(`Request timed out after ${timeoutMs}ms`);
+            throw new HttpTimeoutError(timeoutMs);
         }
         throw error;
     }

package/dist/http/fetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/http/fetch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/http/fetch.ts"],"names":[],"mappings":"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"}

package/dist/http/watcher.d.ts

@@ -0,0 +1,34 @@
+import type { WatcherRecord } from '../registry/types.js';
+/** Build the URL for a watcher endpoint. */
+export declare const buildWatcherUrl: (watcher: Pick<WatcherRecord, "host" | "port">, path: string, query?: URLSearchParams) => string;
+/** Describe a failure to reach a watcher, in the phrasing both the CLI and the SDK surface. */
+export declare const formatWatcherTransportError: (watcher: Pick<WatcherRecord, "id">, error: unknown) => string;
+/**
+ * How a failed watcher request should be interpreted.
+ *
+ * - `api-rejection`: the watcher answered and refused this request, so it is demonstrably alive.
+ * - `unreachable`: nothing is listening on the watcher's port (connection refused, DNS failure,
+ *   host unreachable). Strong evidence the watcher is gone.
+ * - `transport`: the request failed without saying anything about liveness — a timeout or abort,
+ *   which a slow command produces against a perfectly healthy watcher.
+ */
+export type WatcherFailureKind = 'api-rejection' | 'unreachable' | 'transport';
+/**
+ * Classify a thrown watcher-request failure.
+ *
+ * Identified by what we can recognize reliably rather than by errno: `fetch` reports connection
+ * failures with runtime-specific shapes (Bun sets `code: 'ConnectionRefused'` on the error, Node
+ * nests an errno under `cause`), so anything that is neither our own response error nor our own
+ * timeout is treated as the connection never having been answered.
+ */
+export declare const classifyWatcherFailure: (error: unknown) => WatcherFailureKind;
+/**
+ * Whether a failed request should evict the watcher from the shared on-disk registry.
+ *
+ * The registry is shared between the CLI and the SDK, so this decision cannot live on one side:
+ * an eviction by either stack deletes an entry the other reads. Only `unreachable` evicts. An
+ * `api-rejection` came from a live watcher, and a `transport` failure is a timeout on a slow
+ * command — evicting there would delete healthy watchers mid-session.
+ */
+export declare const shouldEvictWatcherOnFailure: (failure: WatcherFailureKind) => boolean;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/http/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/http/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAIzD,4CAA4C;AAC5C,eAAO,MAAM,eAAe,GAAI,SAAS,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,MAAM,MAAM,EAAE,QAAQ,eAAe,KAAG,MAGtH,CAAA;AAED,+FAA+F;AAC/F,eAAO,MAAM,2BAA2B,GAAI,SAAS,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,OAAO,OAAO,KAAG,MAChC,CAAA;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,CAAA;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,kBAMvD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,GAAI,SAAS,kBAAkB,KAAG,OAAoC,CAAA"}

package/dist/http/watcher.js

@@ -0,0 +1,33 @@
+import { isHttpResponseError, isHttpTimeoutError } from './fetch.js';
+import { formatError } from '../errorMessage.js';
+/** Build the URL for a watcher endpoint. */
+export const buildWatcherUrl = (watcher, path, query) => {
+    const qs = query?.toString();
+    return `http://${watcher.host}:${watcher.port}${path}${qs ? `?${qs}` : ''}`;
+};
+/** Describe a failure to reach a watcher, in the phrasing both the CLI and the SDK surface. */
+export const formatWatcherTransportError = (watcher, error) => `${watcher.id}: failed to reach watcher (${formatError(error)})`;
+/**
+ * Classify a thrown watcher-request failure.
+ *
+ * Identified by what we can recognize reliably rather than by errno: `fetch` reports connection
+ * failures with runtime-specific shapes (Bun sets `code: 'ConnectionRefused'` on the error, Node
+ * nests an errno under `cause`), so anything that is neither our own response error nor our own
+ * timeout is treated as the connection never having been answered.
+ */
+export const classifyWatcherFailure = (error) => {
+    if (isHttpResponseError(error)) {
+        return 'api-rejection';
+    }
+    return isHttpTimeoutError(error) ? 'transport' : 'unreachable';
+};
+/**
+ * Whether a failed request should evict the watcher from the shared on-disk registry.
+ *
+ * The registry is shared between the CLI and the SDK, so this decision cannot live on one side:
+ * an eviction by either stack deletes an entry the other reads. Only `unreachable` evicts. An
+ * `api-rejection` came from a live watcher, and a `transport` failure is a timeout on a slow
+ * command — evicting there would delete healthy watchers mid-session.
+ */
+export const shouldEvictWatcherOnFailure = (failure) => failure === 'unreachable';
+//# sourceMappingURL=watcher.js.map

package/dist/http/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/http/watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAA6C,EAAE,IAAY,EAAE,KAAuB,EAAU,EAAE;IAC/H,MAAM,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAA;IAC5B,OAAO,UAAU,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AAC5E,CAAC,CAAA;AAED,+FAA+F;AAC/F,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,OAAkC,EAAE,KAAc,EAAU,EAAE,CACzG,GAAG,OAAO,CAAC,EAAE,8BAA8B,WAAW,CAAC,KAAK,CAAC,GAAG,CAAA;AAajE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAc,EAAsB,EAAE;IAC5E,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,eAAe,CAAA;IACvB,CAAC;IAED,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAA;AAC/D,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,OAA2B,EAAW,EAAE,CAAC,OAAO,KAAK,aAAa,CAAA"}

package/dist/index.d.ts

@@ -3,12 +3,16 @@ export * from './protocol/http.js';
 export * from './protocol/schema.js';
 export { AUTH_STATE_METADATA_SCHEMA_VERSION } from './protocol/http/auth.js';
 export * from './protocol/version.js';
+export * from './protocol/native-messaging.js';
 export * from './registry/registry.js';
 export * from './registry/types.js';
 export * from './registry/paths.js';
 export * from './logs/previewStringify.js';
+export * from './errorMessage.js';
 export * from './textPattern.js';
+export * from './time.js';
 export * from './auth/cookies.js';
 export * from './auth/state.js';
 export * from './http/fetch.js';
+export * from './http/watcher.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAA;AAC5E,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAA;AAC5E,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA"}

package/dist/index.js

@@ -3,12 +3,16 @@ export * from './protocol/http.js';
 export * from './protocol/schema.js';
 export { AUTH_STATE_METADATA_SCHEMA_VERSION } from './protocol/http/auth.js';
 export * from './protocol/version.js';
+export * from './protocol/native-messaging.js';
 export * from './registry/registry.js';
 export * from './registry/types.js';
 export * from './registry/paths.js';
 export * from './logs/previewStringify.js';
+export * from './errorMessage.js';
 export * from './textPattern.js';
+export * from './time.js';
 export * from './auth/cookies.js';
 export * from './auth/state.js';
 export * from './http/fetch.js';
+export * from './http/watcher.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAA;AAC5E,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAA;AAC5E,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA"}

package/dist/protocol/http/auth.d.ts

@@ -1,3 +1,4 @@
+import type { Ok } from './errors.js';
 /** Cookie metadata exposed by the auth cookie endpoints. */
 export type AuthCookie = {
     name: string;
@@ -18,21 +19,19 @@ export type AuthCookieIdentity = {
     path: string;
 };
 /** Response payload for GET /auth/cookies. */
-export type AuthCookiesResponse = {
-    ok: true;
+export type AuthCookiesResponse = Ok<{
     origin: string;
     cookies: AuthCookie[];
-};
+}>;
 /** Request payload for exact cookie lookup. */
 export type AuthCookieGetRequest = AuthCookieIdentity & {
     includeValue?: boolean;
 };
 /** Response payload for exact cookie lookup. */
-export type AuthCookieGetResponse = {
-    ok: true;
+export type AuthCookieGetResponse = Ok<{
     origin: string;
     cookie: AuthCookie | null;
-};
+}>;
 /** Cookie payload used by auth-state export and import. */
 export type AuthStateCookie = {
     name: string;
@@ -50,20 +49,18 @@ export type AuthCookieSetRequest = {
     cookie: AuthStateCookie;
 };
 /** Response payload for cookie upserts. */
-export type AuthCookieSetResponse = {
-    ok: true;
+export type AuthCookieSetResponse = Ok<{
     origin: string;
     cookie: AuthCookie;
-};
+}>;
 /** Request payload for exact cookie deletion. */
 export type AuthCookieDeleteRequest = AuthCookieIdentity;
 /** Response payload for exact cookie deletion. */
-export type AuthCookieDeleteResponse = {
-    ok: true;
+export type AuthCookieDeleteResponse = Ok<{
     origin: string;
     deleted: boolean;
     cookie: AuthCookieIdentity;
-};
+}>;
 /** Scope used by bulk cookie clearing. */
 export type AuthCookieClearScope = 'origin' | 'site' | 'domain' | 'browserContext';
 /** Request payload for scoped cookie clearing. */
@@ -74,8 +71,7 @@ export type AuthCookieClearRequest = {
     authOnly?: boolean;
 };
 /** Response payload for scoped cookie clearing. */
-export type AuthCookieClearResponse = {
-    ok: true;
+export type AuthCookieClearResponse = Ok<{
     origin: string;
     scope: AuthCookieClearScope;
     scopeValue: string | null;
@@ -83,7 +79,7 @@ export type AuthCookieClearResponse = {
     authOnly: boolean;
     cleared: number;
     cookies: AuthCookieIdentity[];
-};
+}>;
 /** A single storage entry for localStorage/sessionStorage snapshots. */
 export type AuthStateStorageEntry = {
     name: string;
@@ -139,22 +135,30 @@ export type AuthStateSnapshotMetadata = {
     recommendedStartupUrl: string | null;
 };
 /** Portable auth snapshot used to rehydrate a fresh browser session. */
-export type AuthStateSnapshot = {
-    ok: true;
+export type AuthStateSnapshot = Ok<{
     url: string;
     origin: string;
     cookies: AuthStateCookie[];
     origins: AuthStateOrigin[];
     metadata: AuthStateSnapshotMetadata;
-};
+}>;
 /** Request payload for loading an auth-state snapshot into an attached watcher target. */
 export type AuthStateLoadRequest = {
     snapshot: AuthStateSnapshot;
     url?: string;
 };
 /** Response payload for auth-state hydration requests. */
-export type AuthStateLoadResponse = {
-    ok: true;
+export type AuthStateLoadResponse = Ok<{
     startupUrl: string | null;
-};
+}>;
+/** Scopes accepted by POST /auth/cookies/clear. */
+export declare const AUTH_COOKIE_CLEAR_SCOPES: readonly ["origin", "site", "domain", "browserContext"];
+/** Schema for POST /auth/cookies/get request payloads. */
+export declare const authCookieGetRequestSchema: import("../schema.js").ProtocolSchema<AuthCookieGetRequest>;
+/** Schema for POST /auth/cookies/delete request payloads. */
+export declare const authCookieDeleteRequestSchema: import("../schema.js").ProtocolSchema<AuthCookieIdentity>;
+/** Schema for POST /auth/cookies/set request payloads. */
+export declare const authCookieSetRequestSchema: import("../schema.js").ProtocolSchema<AuthCookieSetRequest>;
+/** Schema for POST /auth/cookies/clear request payloads. */
+export declare const authCookieClearRequestSchema: import("../schema.js").ProtocolSchema<AuthCookieClearRequest>;
 //# sourceMappingURL=auth.d.ts.map

package/dist/protocol/http/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/auth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/auth.ts"],"names":[],"mappings":"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"}

package/dist/protocol/http/auth.js

@@ -1,3 +1,128 @@
+import { normalizeCookieDomainFilter, normalizeCookieSameSite } from '../../auth/cookies.js';
+import { defineProtocolSchema, invalidProtocolPayload, validProtocolPayload } from '../schema.js';
+import { compact, fieldError, optionalBoolean, optionalEnum, optionalNumber, optionalRecord, optionalString, readFields, requireObject, requiredString, } from '../schemaFields.js';
 /** Schema version for the auth-state metadata block. */
 export const AUTH_STATE_METADATA_SCHEMA_VERSION = 1;
+// ─────────────────────────────────────────────────────────────────────────────
+// Request schemas
+// ─────────────────────────────────────────────────────────────────────────────
+/** Scopes accepted by POST /auth/cookies/clear. */
+export const AUTH_COOKIE_CLEAR_SCOPES = ['origin', 'site', 'domain', 'browserContext'];
+/** Read the name/domain/path triple that identifies one cookie. */
+const readCookieIdentity = (source) => {
+    const fields = readFields(source, { name: requiredString, domain: requiredString, path: requiredString });
+    if (!fields.ok) {
+        // requiredString names the field, which is the message these routes already used.
+        return fieldError(fields.issues[0]?.message ?? 'name, domain, and path are required');
+    }
+    if (!fields.value.path.startsWith('/')) {
+        return fieldError('path must start with "/"');
+    }
+    return fields.value;
+};
+/** Schema for POST /auth/cookies/get request payloads. */
+export const authCookieGetRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const source = value;
+    const identity = readCookieIdentity(source);
+    if ('__fieldError' in identity)
+        return invalidProtocolPayload(identity.__fieldError);
+    const fields = readFields(source, { includeValue: optionalBoolean });
+    if (!fields.ok)
+        return fields;
+    return validProtocolPayload(compact({ ...identity, ...fields.value }));
+});
+/** Schema for POST /auth/cookies/delete request payloads. */
+export const authCookieDeleteRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const identity = readCookieIdentity(value);
+    if ('__fieldError' in identity)
+        return invalidProtocolPayload(identity.__fieldError);
+    return validProtocolPayload(identity);
+});
+/** Schema for POST /auth/cookies/set request payloads. */
+export const authCookieSetRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const outer = readFields(value, { cookie: optionalRecord });
+    if (!outer.ok)
+        return outer;
+    if (outer.value.cookie == null) {
+        return invalidProtocolPayload('cookie is required');
+    }
+    const source = outer.value.cookie;
+    const identity = readCookieIdentity(source);
+    if ('__fieldError' in identity)
+        return invalidProtocolPayload(identity.__fieldError);
+    const fields = readFields(source, {
+        value: optionalString,
+        secure: optionalBoolean,
+        httpOnly: optionalBoolean,
+        session: optionalBoolean,
+        sameSite: optionalString,
+        expires: (input, key) => optionalNumber(input, key),
+    });
+    if (!fields.ok)
+        return fields;
+    const { value: cookieValue, secure, httpOnly, session, sameSite, expires } = fields.value;
+    if (typeof cookieValue !== 'string')
+        return invalidProtocolPayload('cookie.value must be a string');
+    if (secure == null)
+        return invalidProtocolPayload('cookie.secure must be a boolean');
+    if (httpOnly == null)
+        return invalidProtocolPayload('cookie.httpOnly must be a boolean');
+    if (session == null)
+        return invalidProtocolPayload('cookie.session must be a boolean');
+    const normalizedSameSite = sameSite ? normalizeCookieSameSite(sameSite) : null;
+    if (sameSite && !normalizedSameSite) {
+        return invalidProtocolPayload('cookie.sameSite must be one of: Strict, Lax, None');
+    }
+    if (session && expires != null) {
+        return invalidProtocolPayload('cookie.expires must be null when cookie.session is true');
+    }
+    if (!session && expires == null) {
+        return invalidProtocolPayload('cookie.expires is required when cookie.session is false');
+    }
+    if (normalizedSameSite === 'None' && !secure) {
+        return invalidProtocolPayload('cookie.secure must be true when cookie.sameSite is None');
+    }
+    return validProtocolPayload({
+        cookie: compact({
+            ...identity,
+            value: cookieValue,
+            secure,
+            httpOnly,
+            session,
+            sameSite: normalizedSameSite,
+            expires: expires ?? null,
+        }),
+    });
+});
+/** Schema for POST /auth/cookies/clear request payloads. */
+export const authCookieClearRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const fields = readFields(value, {
+        scope: (source, key) => optionalEnum(source, key, AUTH_COOKIE_CLEAR_SCOPES),
+        domain: optionalString,
+        sessionOnly: optionalBoolean,
+        authOnly: optionalBoolean,
+    });
+    if (!fields.ok)
+        return fields;
+    const { scope, domain } = fields.value;
+    if (scope == null) {
+        return invalidProtocolPayload(`scope must be one of: ${AUTH_COOKIE_CLEAR_SCOPES.join(', ')}`);
+    }
+    if (scope === 'domain' && !normalizeCookieDomainFilter(domain)) {
+        return invalidProtocolPayload('domain is required when scope is "domain"');
+    }
+    return validProtocolPayload(compact({ ...fields.value, scope }));
+});
 //# sourceMappingURL=auth.js.map

package/dist/protocol/http/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/protocol/http/auth.ts"],"names":[],"mappings":"AAgHA,wDAAwD;AACxD,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAA"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/protocol/http/auth.ts"],"names":[],"mappings":"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"}

package/dist/protocol/http/code.d.ts

@@ -1,3 +1,4 @@
+import type { Ok } from './errors.js';
 /** Runtime resource type exposed by the live runtime-code API. */
 export type CodeResourceType = 'script' | 'stylesheet';
 /** Runtime script/stylesheet metadata. */
@@ -13,10 +14,9 @@ export type CodeListRequest = {
     pattern?: string;
 };
 /** Response payload for POST /code/list. */
-export type CodeListResponse = {
-    ok: true;
+export type CodeListResponse = Ok<{
     resources: CodeResource[];
-};
+}>;
 /** Request payload for POST /code/read. */
 export type CodeReadRequest = {
     /** Resource URL from /code/list. */
@@ -27,8 +27,7 @@ export type CodeReadRequest = {
     limit?: number;
 };
 /** Response payload for POST /code/read. */
-export type CodeReadResponse = {
-    ok: true;
+export type CodeReadResponse = Ok<{
     resource: CodeResource;
     /** Raw source text for the requested line slice. */
     source: string;
@@ -36,7 +35,7 @@ export type CodeReadResponse = {
     totalLines: number;
     startLine: number;
     endLine: number;
-};
+}>;
 /** Request payload for POST /code/grep. */
 export type CodeGrepRequest = {
     /** Plain string or /regex/flags pattern to match within source lines. */
@@ -61,12 +60,11 @@ export type CodeGrepSkippedResource = {
     reason: string;
 };
 /** Response payload for POST /code/grep. */
-export type CodeGrepResponse = {
-    ok: true;
+export type CodeGrepResponse = Ok<{
     matches: CodeGrepMatch[];
     /** Non-fatal runtime resources skipped while searching. */
     skippedResources: CodeGrepSkippedResource[];
-};
+}>;
 /** Request payload for POST /code/edit. */
 export type CodeEditRequest = {
     /** Resource URL from /code/list. */
@@ -75,8 +73,15 @@ export type CodeEditRequest = {
     source: string;
 };
 /** Response payload for POST /code/edit. */
-export type CodeEditResponse = {
-    ok: true;
+export type CodeEditResponse = Ok<{
     resource: CodeResource;
-};
+}>;
+/** Schema for POST /code/list request payloads. */
+export declare const codeListRequestSchema: import("../schema.js").ProtocolSchema<CodeListRequest>;
+/** Schema for POST /code/read request payloads. */
+export declare const codeReadRequestSchema: import("../schema.js").ProtocolSchema<CodeReadRequest>;
+/** Schema for POST /code/grep request payloads. */
+export declare const codeGrepRequestSchema: import("../schema.js").ProtocolSchema<CodeGrepRequest>;
+/** Schema for POST /code/edit request payloads. */
+export declare const codeEditRequestSchema: import("../schema.js").ProtocolSchema<CodeEditRequest>;
 //# sourceMappingURL=code.d.ts.map

package/dist/protocol/http/code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/code.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,YAAY,CAAA;AAEtD,0CAA0C;AAC1C,MAAM,MAAM,YAAY,GAAG;IAC1B,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,IAAI,EAAE,gBAAgB,CAAA;CACtB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,SAAS,EAAE,YAAY,EAAE,CAAA;CACzB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,YAAY,CAAA;IACtB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,gBAAgB,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,sFAAsF;AACtF,MAAM,MAAM,uBAAuB,GAAG;IACrC,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,IAAI,EAAE,gBAAgB,CAAA;IACtB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,2DAA2D;IAC3D,gBAAgB,EAAE,uBAAuB,EAAE,CAAA;CAC3C,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,YAAY,CAAA;CACtB,CAAA"}
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/code.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAErC,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,YAAY,CAAA;AAEtD,0CAA0C;AAC1C,MAAM,MAAM,YAAY,GAAG;IAC1B,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,IAAI,EAAE,gBAAgB,CAAA;CACtB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG,EAAE,CAAC;IACjC,SAAS,EAAE,YAAY,EAAE,CAAA;CACzB,CAAC,CAAA;AAEF,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG,EAAE,CAAC;IACjC,QAAQ,EAAE,YAAY,CAAA;IACtB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CACf,CAAC,CAAA;AAEF,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,gBAAgB,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,sFAAsF;AACtF,MAAM,MAAM,uBAAuB,GAAG;IACrC,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,IAAI,EAAE,gBAAgB,CAAA;IACtB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG,EAAE,CAAC;IACjC,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,2DAA2D;IAC3D,gBAAgB,EAAE,uBAAuB,EAAE,CAAA;CAC3C,CAAC,CAAA;AAEF,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG,EAAE,CAAC;IACjC,QAAQ,EAAE,YAAY,CAAA;CACtB,CAAC,CAAA;AAEF,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,wDAQhC,CAAA;AAEF,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,wDAYhC,CAAA;AAEF,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,wDAWhC,CAAA;AAEF,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,wDAYhC,CAAA"}

package/dist/protocol/http/code.js

@@ -1,2 +1,54 @@
-export {};
+import { defineProtocolSchema, validProtocolPayload } from '../schema.js';
+import { compact, fieldError, optionalInteger, optionalNonEmptyString, readFields, requireObject, requiredString } from '../schemaFields.js';
+/** Schema for POST /code/list request payloads. */
+export const codeListRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const fields = readFields(value, { pattern: optionalNonEmptyString });
+    if (!fields.ok)
+        return fields;
+    return validProtocolPayload(compact(fields.value));
+});
+/** Schema for POST /code/read request payloads. */
+export const codeReadRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const fields = readFields(value, {
+        url: requiredString,
+        offset: (source, key) => optionalInteger(source, key, { min: 0 }),
+        limit: (source, key) => optionalInteger(source, key, { min: 1 }),
+    });
+    if (!fields.ok)
+        return fields;
+    return validProtocolPayload(compact(fields.value));
+});
+/** Schema for POST /code/grep request payloads. */
+export const codeGrepRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const fields = readFields(value, {
+        pattern: requiredString,
+        urlPattern: optionalNonEmptyString,
+    });
+    if (!fields.ok)
+        return fields;
+    return validProtocolPayload(compact(fields.value));
+});
+/** Schema for POST /code/edit request payloads. */
+export const codeEditRequestSchema = defineProtocolSchema((value) => {
+    const invalid = requireObject(value);
+    if (invalid)
+        return invalid;
+    const fields = readFields(value, {
+        url: requiredString,
+        // Empty source is legal: it clears the resource.
+        source: (source, key) => (typeof source[key] === 'string' ? source[key] : fieldError('source must be a string')),
+    });
+    if (!fields.ok)
+        return fields;
+    return validProtocolPayload(fields.value);
+});
 //# sourceMappingURL=code.js.map

package/dist/protocol/http/code.js.map

@@ -1 +1 @@
-{"version":3,"file":"code.js","sourceRoot":"","sources":["../../../src/protocol/http/code.ts"],"names":[],"mappings":""}
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../../src/protocol/http/code.ts"],"names":[],"mappings":"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"}