@deslop/stash 0.1.0 → 0.1.1021

package/dist/cli.js

@@ -1,6 +1,669 @@
 #!/usr/bin/env -S node --max-old-space-size=16384 --heapsnapshot-near-heap-limit=3 --report-on-fatalerror
-import { Cc as getOrElse, Ci as fail, Cl as identity, Co as provideMerge, Ct as TrueLiterals, D as Stdio, Ea as void_, Ec as isNone, El as pipeArguments, Et as Union, Fc as some, Fi as gen, Gc as withFiber, Gi as map$3, Gs as isReadonlyArrayNonEmpty, Is as findFirst, Ji as match$2, Js as match, Jt as optional$2, Ka as round, Kc as assignProperty, Li as interrupt, Ls as findFirstIndex, Mc as match$1, Ms as empty, Nc as none, Oc as isSome, Oi as fnUntraced, Os as Prototype, Pt as decodeUnknownEffect, Qt as toCodecStringTree, Rs as findLast, Sc as fromUndefinedOr, St as TaggedError, Tc as getOrUndefined, Ti as flatMap$1, Tl as pipe, Ts as make$2, Vt as is, Wr as take, Xo as ConsoleRef, Xs as reduce, Yt as optionalKey, Zc as format, _a as sync$1, _s as Reference, a as LogToStderr, aa as provideContext, bo as merge, bs as empty$1, bt as String$6, c as runMain, ca as result, cl as hasProperty, d as layer, ds as taggedEnum, f as QuitError, fa as scoped, fi as catchFilter, ft as Literal, ga as suspend, gi as catchTags, h as layer$1, hc as succeed$2, hi as catchTag, ia as provide, ic as fail$1, ir as FileSystem, it as BooleanLiterals, jc as map$5, l as errorExitCode, lt as FalseLiterals, m as isQuitError, ma as succeed$1, mn as value, na as orDie, nt as ArraySchema, oa as provideService, ot as Defect, p as Terminal, pn as make$1, qi as mapError, qs as map$4, ri as andThen, rr as Path$2, rs as sync, sa as raceFirst, t as Media, u as errorReported, ul as isNotUndefined, vc as exists, vs as Service, xi as ensuring, xl as dual, zi as isEffect, zo as MinimumLogLevel } from "./service-D6Z3eq9Z.mjs";
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/Console.js
+import { $ as Socket, $l as dual, $o as MinimumLogLevel, Ao as effect, Ar as take, At as TaggedError, B as constPing, Ci as fnUntraced, Cl as assignProperty, Cr as failCause, Ct as Literal, D as option, Di as forkIn, Do as squash, Ea as timeoutOrElse, Er as offerAll, F as layerJson, Fa as whileLoop, Fi as interruptible, Fs as Reference, Gc as succeed$2, Gn as fromQueue, Gt as tag, Ha as exponential, Hc as isSuccess, Hl as hasProperty, Ho as Scope, Hs as getUnsafe, Ht as is, Ia as withFiber, Ic as fail$2, Ii as isEffect, Ir as makeUnsafe, Is as Service, It as decodeSync, J as spanAttributes, Jc as exists, Ji as matchCauseEffect, K as getStreamSchemas, Ki as mapError, Ks as Prototype, L as RequestId, Lo as provide$1, Lr as getCurrent, Ls as add, Lt as decodeUnknownEffect, Mi as ignore, N as withRunClient, Na as useSpan, Ni as ignoreCause, Nt as Union, Oi as forkScoped, Ot as String$6, P as RpcSerialization, Pa as void_, Pi as interrupt$1, Ps as toMillis, Qi as onError, Qs as empty$2, Rr as interrupt$2, Rs as empty$1, Rt as encodeEffect, Sa as tapCause, Sc as reduce, Sl as withFiber$1, So as interruptors, Sr as end, Ss as sync, Ti as forever, Tt as NonEmptyArray, U as exitSchema, Ua as min, Ui as makeSpanScoped, Ul as isNotUndefined, Uo as addFinalizer, Us as make$3, Ut as optional$2, Vi as logInfo, Vs as getOrUndefinedUnsafe, Wa as spaced, Wi as map$3, Wo as addFinalizerExit, Wt as optionalKey, X as Collector, Xa as isEmpty, Xr as andThen, Y as spanName, Z as makeCollectorUnsafe, Za as isNonEmpty, Zl as constVoid, Zr as annotateLogs, _ as QuitError, _a as serviceOption, _o as findError, _t as BooleanLiterals, aa as provide, al as isSome, ar as runHead, at as layerWebSocket, ba as suspend, bc as match, bi as flatMap$1, bo as hasInterrupts, br as bounded, c as NotesError, ca as raceFirst, cl as map$4, dt as HttpClientErrorSchema, el as fromUndefinedOr, et as SocketError, fa as runForkWith, fi as context, fl as some, g as layer, gc as join, gi as ensuring, gt as ArraySchema, h as errorReported, ha as scoped, hc as isReadonlyArrayNonEmpty, hn as value, ic as findLast, ii as catchCauseIf, il as isNone, is as interrupt, j as Stdio, ja as uninterruptibleMask, ji as gen, jl as format, js as taggedEnum, jt as TrueLiterals, kr as shutdownUnsafe, la as result, li as catchTag, ll as match$1, lo as round, m as errorExitCode, mi as delay, mn as make$2, ms as ConsoleRef, na as orDie, nc as findFirst, ni as callback, ns as fail, nu as pipe, oa as provideContext, oi as catchFilter, on as empty, os as isFailure, ot as layerWebSocketConstructorGlobal, p as runMain, pr as unwrap, q as isStreamSchema, qi as match$2, qt as toCodecStringTree, rc as findFirstIndex, ri as catchCause, rl as getOrUndefined, rs as failCause$1, rt as SocketReadError, ru as pipeArguments, sa as provideService, sn as fromInput, t as RpcContracts, ta as onInterrupt, tc as filter$1, tl as getOrElse, to as replace, ts as die, tt as SocketErrorReason, tu as identity, u as LogToStderr, ua as retryOrElse, ui as catchTags, ul as none, un as merge, uo as Clock, v as Terminal, va as succeed$1, vi as fail$1, vt as Defect, w as String$7, wa as timeout, wc as some$1, wi as forEach, x as Crypto, xa as sync$1, xt as FalseLiterals, y as isQuitError, yc as map$5, yt as Error$1, za as withParentSpan, zi as logError, zn as filter, zs as get } from "./contracts-B4aEKL_A.mjs";
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/workers/WorkerError.js
+/**
+* Worker error reason for failures while spawning or setting up a worker.
+*
+* @stability unstable
+* @category errors
+* @since 4.0.0
+*/
+var WorkerSpawnError = class extends (/*#__PURE__*/ Error$1("effect/workers/WorkerError/WorkerSpawnError")({
+	_tag: /*#__PURE__*/ tag("WorkerSpawnError"),
+	message: String$6,
+	cause: /*#__PURE__*/ optional$2(/*#__PURE__*/ Defect())
+})) {};
+/**
+* Worker error reason for failures while sending a message to a worker.
+*
+* @stability unstable
+* @category errors
+* @since 4.0.0
+*/
+var WorkerSendError = class extends (/*#__PURE__*/ Error$1("effect/workers/WorkerError/WorkerSendError")({
+	_tag: /*#__PURE__*/ tag("WorkerSendError"),
+	message: String$6,
+	cause: /*#__PURE__*/ optional$2(/*#__PURE__*/ Defect())
+})) {};
+/**
+* Worker error reason for failures while receiving or handling a message from a
+* worker.
+*
+* @stability unstable
+* @category errors
+* @since 4.0.0
+*/
+var WorkerReceiveError = class extends (/*#__PURE__*/ Error$1("effect/workers/WorkerError/WorkerReceiveError")({
+	_tag: /*#__PURE__*/ tag("WorkerReceiveError"),
+	message: String$6,
+	cause: /*#__PURE__*/ optional$2(/*#__PURE__*/ Defect())
+})) {};
+/**
+* Worker error reason for an unclassified worker failure.
+*
+* @stability unstable
+* @category errors
+* @since 4.0.0
+*/
+var WorkerUnknownError = class extends (/*#__PURE__*/ Error$1("effect/workers/WorkerError/WorkerUnknownError")({
+	_tag: /*#__PURE__*/ tag("WorkerUnknownError"),
+	message: String$6,
+	cause: /*#__PURE__*/ optional$2(/*#__PURE__*/ Defect())
+})) {};
+/**
+* Schema for decoding and encoding all supported worker error reason variants.
+*
+* @stability unstable
+* @category schemas
+* @since 4.0.0
+*/
+const WorkerErrorReason = /*#__PURE__*/ Union([
+	WorkerSpawnError,
+	WorkerSendError,
+	WorkerReceiveError,
+	WorkerUnknownError
+]);
+//#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/rpc/RpcClientError.js
+/**
+* Client-side protocol failures reported by unstable RPC transports.
+*
+* `RpcClientError` is the error type generated clients use when a call fails
+* before a remote handler can return its declared typed error. Its `reason`
+* covers built-in transport failures from HTTP, sockets, and workers, plus
+* `RpcClientDefect` values for malformed or incompatible protocol data.
+*
+* @stability unstable
+* @since 4.0.0
+*/
+const TypeId$4 = "~effect/rpc/RpcClientError";
+/**
+* Represents a client-side RPC defect, such as a protocol violation or
+* decoding failure, with a message and original cause.
+*
+* @stability unstable
+* @category errors
+* @since 4.0.0
+*/
+var RpcClientDefect = class extends (/*#__PURE__*/ Error$1("effect/rpc/RpcClientError/RpcClientDefect")({
+	_tag: /*#__PURE__*/ tag("RpcClientDefect"),
+	message: String$6,
+	cause: /*#__PURE__*/ Defect()
+})) {};
+/**
+* Error wrapper for RPC client failures, including worker, socket, HTTP client,
+* and client protocol defect failures.
+*
+* @stability unstable
+* @category errors
+* @since 4.0.0
+*/
+var RpcClientError = class extends (/*#__PURE__*/ Error$1(TypeId$4)({
+	_tag: /*#__PURE__*/ tag("RpcClientError"),
+	reason: /*#__PURE__*/ Union([
+		WorkerErrorReason,
+		SocketErrorReason,
+		HttpClientErrorSchema,
+		RpcClientDefect
+	])
+})) {
+	/**
+	* Marks this value as an RPC client error for runtime guards.
+	*
+	* @stability unstable
+	* @since 4.0.0
+	*/
+	[TypeId$4] = TypeId$4;
+	get message() {
+		return `${this.reason._tag}: ${this.reason.message}`;
+	}
+};
+//#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/rpc/RpcClient.js
+let requestIdCounter = 0;
+/**
+* Creates an RPC client for an already-decoded message channel, returning the
+* client API together with a `write` function for delivering server messages
+* back to the client.
+*
+* @stability unstable
+* @category constructors
+* @since 4.0.0
+*/
+const makeNoSerialization = /*#__PURE__*/ fnUntraced(function* (group, options) {
+	const spanPrefix = options.spanPrefix;
+	const supportsAck = options?.supportsAck ?? true;
+	const disableTracing = options?.disableTracing ?? false;
+	const generateRequestId = options?.generateRequestId ?? (() => requestIdCounter++);
+	const services = yield* context();
+	const scope = get(services, Scope);
+	const entries = /* @__PURE__ */ new Map();
+	let isShutdown = false;
+	yield* addFinalizer(scope, withFiber((parent) => {
+		isShutdown = true;
+		return clearEntries(interrupt(parent.id));
+	}));
+	const clearEntries = fnUntraced(function* (exit) {
+		for (const [id, entry] of entries) {
+			entries.delete(id);
+			if (entry._tag === "Queue") yield* exit._tag === "Success" ? end(entry.queue) : failCause(entry.queue, exit.cause);
+			else entry.resume(exit);
+		}
+	});
+	const onRequest = (rpc) => {
+		const isStream = isStreamSchema(rpc.successSchema);
+		const middleware = getRpcClientMiddleware(rpc);
+		return (payload, opts) => {
+			const headers = opts?.headers ? fromInput(opts.headers) : empty;
+			const context = opts?.context ?? empty$1();
+			if (!isStream) {
+				const onRequest = (span) => onEffectRequest(rpc, middleware, span, rpc.payloadSchema.make(payload), headers, context, opts?.discard ?? false);
+				return disableTracing ? onRequest(void 0) : useSpan(spanName(spanPrefix, rpc._tag), {
+					kind: "client",
+					attributes: spanAttributes(rpc._tag, options.spanAttributes)
+				}, onRequest);
+			}
+			const queue = onStreamRequest(rpc, middleware, rpc.payloadSchema.make(payload), headers, opts?.streamBufferSize ?? 16, context);
+			if (opts?.asQueue) return queue;
+			return unwrap(map$3(queue, fromQueue));
+		};
+	};
+	const onEffectRequest = (rpc, middleware, span, payload, headers, context, discard) => withFiber((parentFiber) => {
+		if (isShutdown) return interrupt$1;
+		const id = generateRequestId();
+		const send = middleware((message) => options.onFromClient({
+			message,
+			context,
+			discard
+		}), {
+			_tag: "Request",
+			id,
+			tag: rpc._tag,
+			payload,
+			...span ? {
+				traceId: span.traceId,
+				spanId: span.spanId,
+				sampled: span.sampled
+			} : {},
+			headers: merge(parentFiber.getRef(CurrentHeaders), headers)
+		});
+		if (discard) return send;
+		let fiber;
+		return onInterrupt(callback((resume) => {
+			const entry = {
+				_tag: "Effect",
+				rpc,
+				context,
+				resume(exit) {
+					resume(exit);
+					if (fiber && !fiber.pollUnsafe()) parentFiber.currentDispatcher.scheduleTask(() => {
+						fiber.interruptUnsafe(parentFiber.id);
+					}, 0);
+				}
+			};
+			entries.set(id, entry);
+			fiber = send.pipe(span ? withParentSpan(span, { captureStackTrace: false }) : identity, runForkWith(parentFiber.context));
+			fiber.addObserver((exit) => {
+				if (exit._tag === "Failure") return resume(exit);
+			});
+		}), (interruptors) => {
+			entries.delete(id);
+			return andThen(interrupt$2(fiber), sendInterrupt(id, Array.from(interruptors), context));
+		});
+	});
+	const onStreamRequest = fnUntraced(function* (rpc, middleware, payload, headers, streamBufferSize, context) {
+		if (isShutdown) return yield* interrupt$1;
+		const span = disableTracing ? void 0 : yield* makeSpanScoped(spanName(spanPrefix, rpc._tag), {
+			kind: "client",
+			attributes: spanAttributes(rpc._tag, options.spanAttributes)
+		});
+		const fiber = getCurrent();
+		const id = generateRequestId();
+		const scope = getUnsafe(fiber.context, Scope);
+		const queue = yield* bounded(streamBufferSize);
+		yield* addFinalizerExit(scope, (exit) => {
+			shutdownUnsafe(queue);
+			if (!entries.has(id)) return void_;
+			entries.delete(id);
+			return sendInterrupt(id, isFailure(exit) ? Array.from(interruptors(exit.cause)) : [], context);
+		});
+		entries.set(id, {
+			_tag: "Queue",
+			rpc,
+			queue,
+			scope,
+			context
+		});
+		yield* middleware((message) => options.onFromClient({
+			message,
+			context,
+			discard: false
+		}), {
+			_tag: "Request",
+			id,
+			tag: rpc._tag,
+			payload,
+			...span ? {
+				traceId: span.traceId,
+				spanId: span.spanId,
+				sampled: span.sampled
+			} : {},
+			headers: merge(fiber.getRef(CurrentHeaders), headers)
+		}).pipe(span ? withParentSpan(span, { captureStackTrace: false }) : identity, onError((cause) => failCause(queue, cause)), interruptible, forkIn(scope, { startImmediately: true }));
+		return queue;
+	});
+	const getRpcClientMiddleware = (rpc) => {
+		const middlewares = [];
+		for (const tag of rpc.middlewares.values()) {
+			const middleware = getOrUndefinedUnsafe(services, `${tag.key}/Client`);
+			if (!middleware) continue;
+			middlewares.push(middleware);
+		}
+		if (middlewares.length === 0) return (send, request) => send(request);
+		return function loop(send, request, index = middlewares.length - 1) {
+			if (index === -1) return send(request);
+			return middlewares[index]({
+				rpc,
+				request,
+				next(request) {
+					return loop(send, request, index - 1);
+				}
+			});
+		};
+	};
+	const sendInterrupt = (requestId, interruptors, context) => callback((resume) => {
+		const parentFiber = getCurrent();
+		options.onFromClient({
+			message: {
+				_tag: "Interrupt",
+				requestId,
+				interruptors
+			},
+			context,
+			discard: false
+		}).pipe(timeout(1e3), runForkWith(parentFiber.context)).addObserver(() => {
+			resume(void_);
+		});
+	});
+	const write = (message) => {
+		switch (message._tag) {
+			case "Chunk": {
+				const requestId = message.requestId;
+				const entry = entries.get(requestId);
+				if (!entry || entry._tag !== "Queue") return void_;
+				return offerAll(entry.queue, message.values).pipe(supportsAck ? flatMap$1(() => options.onFromClient({
+					message: {
+						_tag: "Ack",
+						requestId: message.requestId
+					},
+					context: entry.context,
+					discard: false
+				})) : identity, catchCause((cause) => failCause(entry.queue, cause)));
+			}
+			case "Exit": {
+				const requestId = message.requestId;
+				const entry = entries.get(requestId);
+				if (!entry) return void_;
+				entries.delete(requestId);
+				if (entry._tag === "Effect") {
+					entry.resume(message.exit);
+					return void_;
+				}
+				return message.exit._tag === "Success" ? end(entry.queue) : failCause(entry.queue, message.exit.cause);
+			}
+			case "Defect": return clearEntries(die(message.defect));
+			case "ClientEnd": return void_;
+		}
+	};
+	let client;
+	if (options.flatten) {
+		const fns = /* @__PURE__ */ new Map();
+		client = function client(tag, payload, options) {
+			let fn = fns.get(tag);
+			if (!fn) {
+				fn = onRequest(group.requests.get(tag));
+				fns.set(tag, fn);
+			}
+			return fn(payload, options);
+		};
+	} else {
+		client = {};
+		group.requests.forEach((rpc) => {
+			assignProperty(client, rpc._tag, onRequest(rpc));
+		});
+	}
+	return {
+		client,
+		write
+	};
+});
+let clientIdCounter = 0;
+/**
+* Creates a schema-aware RPC client for a group using the current client
+* `Protocol`, encoding requests and decoding server responses.
+*
+* @stability unstable
+* @category constructors
+* @since 4.0.0
+*/
+const make$1 = /*#__PURE__*/ fnUntraced(function* (group, options) {
+	const clientId = clientIdCounter++;
+	const { codecFor, run, send, supportsAck, supportsTransferables } = yield* Protocol;
+	const rpcSchemas = makeRpcSchemas(codecFor);
+	const decodeDefect = decodeSync(codecFor(Defect()));
+	const entries = /* @__PURE__ */ new Map();
+	const interruptRequest = (requestId) => {
+		if (!entries.has(requestId)) return void_;
+		entries.delete(requestId);
+		return send(clientId, {
+			_tag: "Interrupt",
+			requestId
+		});
+	};
+	const { client, write } = yield* makeNoSerialization(group, {
+		...options,
+		supportsAck,
+		onFromClient({ message }) {
+			switch (message._tag) {
+				case "Request": {
+					const rpc = group.requests.get(message.tag);
+					const collector = supportsTransferables ? makeCollectorUnsafe() : void 0;
+					const fiber = getCurrent();
+					const entry = {
+						rpc,
+						context: collector ? add(fiber.context, Collector, collector) : fiber.context,
+						schemas: rpcSchemas(rpc)
+					};
+					entries.set(message.id, entry);
+					return entry.schemas.encodePayload(message.payload).pipe(provideContext(entry.context), orDie, flatMap$1((payload) => send(clientId, {
+						...message,
+						id: message.id,
+						payload,
+						headers: Object.entries(message.headers)
+					}, collector && collector.readUnsafe())));
+				}
+				case "Ack":
+					if (!entries.get(message.requestId)) return void_;
+					return send(clientId, {
+						_tag: "Ack",
+						requestId: message.requestId
+					});
+				case "Interrupt": return interruptRequest(message.requestId);
+				case "Eof": return void_;
+			}
+		}
+	});
+	yield* run(clientId, (message) => {
+		switch (message._tag) {
+			case "Chunk": {
+				const requestId = RequestId(message.requestId);
+				const entry = entries.get(requestId);
+				if (!entry || isNone(entry.schemas.decodeChunk)) return void_;
+				const decodeChunk = entry.schemas.decodeChunk.value;
+				return uninterruptibleMask((restore) => restore(decodeChunk(message.values).pipe(provideContext(entry.context), orDie, flatMap$1((chunk) => write({
+					_tag: "Chunk",
+					clientId: 0,
+					requestId,
+					values: chunk
+				})))).pipe(onError((cause) => write({
+					_tag: "Exit",
+					clientId: 0,
+					requestId,
+					exit: failCause$1(cause)
+				}).pipe(andThen(hasInterrupts(cause) ? void_ : ignore(interruptRequest(requestId))))), catchCauseIf((cause) => !hasInterrupts(cause), () => void_)));
+			}
+			case "Exit": {
+				const requestId = RequestId(message.requestId);
+				const entry = entries.get(requestId);
+				if (!entry) return void_;
+				entries.delete(requestId);
+				return entry.schemas.decodeExit(message.exit).pipe(provideContext(entry.context), orDie, matchCauseEffect({
+					onSuccess: (exit) => write({
+						_tag: "Exit",
+						clientId: 0,
+						requestId,
+						exit
+					}),
+					onFailure: (cause) => write({
+						_tag: "Exit",
+						clientId: 0,
+						requestId,
+						exit: failCause$1(cause)
+					})
+				}));
+			}
+			case "Defect": return write({
+				_tag: "Defect",
+				clientId: 0,
+				defect: decodeDefect(message.defect)
+			});
+			case "ClientProtocolError": {
+				const exit = fail(message.error);
+				return forEach(Array.from(entries.keys()), (requestId) => write({
+					_tag: "Exit",
+					clientId: 0,
+					requestId,
+					exit
+				}));
+			}
+			default: return void_;
+		}
+	}).pipe(catchCause(logError), interruptible, forkScoped);
+	return client;
+});
+const makeRpcSchemas = (codecFor) => {
+	const cache = /* @__PURE__ */ new WeakMap();
+	return (rpc) => {
+		let entry = cache.get(rpc);
+		if (entry !== void 0) return entry;
+		const streamSchemas = getStreamSchemas(rpc.successSchema);
+		entry = {
+			decodeChunk: map$4(streamSchemas, (streamSchemas) => decodeUnknownEffect(codecFor(NonEmptyArray(streamSchemas.success)))),
+			encodePayload: encodeEffect(codecFor(rpc.payloadSchema)),
+			decodeExit: decodeUnknownEffect(codecFor(exitSchema(rpc)))
+		};
+		cache.set(rpc, entry);
+		return entry;
+	};
+};
+/**
+* Fiber reference containing headers that are merged into outgoing RPC
+* client requests.
+*
+* **When to use**
+*
+* Use to set request headers that should be automatically merged into outgoing
+* RPC client messages.
+*
+* @stability unstable
+* @category services
+* @since 4.0.0
+*/
+const CurrentHeaders = /*#__PURE__*/ Reference("effect/rpc/RpcClient/CurrentHeaders", { defaultValue: () => empty });
+/**
+* Defines the service interface for an RPC client transport, responsible for running the
+* receive loop and sending encoded client messages.
+*
+* **When to use**
+*
+* Use to provide the transport boundary for RPC clients over HTTP, WebSocket,
+* workers, sockets, or custom protocols.
+*
+* @stability unstable
+* @category services
+* @since 4.0.0
+*/
+var Protocol = class extends (/*#__PURE__*/ Service()("effect/rpc/RpcClient/Protocol")) {
+	/**
+	* Creates a client protocol service from the supplied RPC request runner.
+	*
+	* @stability unstable
+	* @since 4.0.0
+	*/
+	static make = withRunClient;
+};
+/**
+* Creates a client `Protocol` over the current `Socket`, using the current
+* `RpcSerialization`, connection hooks, ping timeouts, and the configured retry
+* policy.
+*
+* **Details**
+*
+* `pingInterval` defaults to 5 seconds. `pingTimeout` defaults to the interval
+* and measures time since the last decoded server frame, not the last pong.
+* The timeout is checked on each ping tick; any decoded frame counts as liveness.
+*
+* @stability unstable
+* @category protocols
+* @since 4.0.0
+*/
+const makeProtocolSocket = (options) => Protocol.make(fnUntraced(function* (writeResponse, clientIds) {
+	const socket = yield* Socket;
+	const serialization = yield* RpcSerialization;
+	const hooks = yield* serviceOption(ConnectionHooks);
+	const requestClientMap = /* @__PURE__ */ new Map();
+	const writer = yield* socket.writer;
+	let parser = serialization.makeUnsafe();
+	const pinger = yield* makePinger(suspend(() => writer.write(parser.encode(constPing))), options);
+	let currentError;
+	const broadcast = (response) => forEach(clientIds, (clientId) => writeResponse(clientId, response));
+	const broadcastError = (error) => {
+		currentError = error;
+		return broadcast({
+			_tag: "ClientProtocolError",
+			error
+		});
+	};
+	const processData = (data) => {
+		try {
+			const responses = parser.decode(data);
+			if (responses.length === 0) return void_;
+			pinger.onFrame();
+			let i = 0;
+			return whileLoop({
+				while: () => i < responses.length,
+				body: () => {
+					const response = responses[i++];
+					if (response._tag === "Pong") return void_;
+					if (Object.hasOwn(response, "requestId")) {
+						const requestId = response.requestId;
+						const clientId = requestClientMap.get(requestId);
+						if (clientId !== void 0) {
+							if (response._tag === "Exit") requestClientMap.delete(requestId);
+							return writeResponse(clientId, response);
+						}
+					}
+					return broadcast(response);
+				},
+				step: constVoid
+			});
+		} catch (defect) {
+			return broadcast({
+				_tag: "ClientProtocolError",
+				error: new RpcClientError({ reason: new RpcClientDefect({
+					message: "Error decoding message",
+					cause: defect
+				}) })
+			});
+		}
+	};
+	yield* suspend(() => {
+		parser = serialization.makeUnsafe();
+		pinger.reset();
+		return gen(function* () {
+			const { pull } = yield* socket.reader;
+			currentError = void 0;
+			if (isSome(hooks)) yield* hooks.value.onConnect;
+			while (true) {
+				const frames = yield* pull;
+				for (let i = 0; i < frames.length; i++) yield* processData(frames[i]);
+			}
+		}).pipe(scoped, raceFirst(flatMap$1(pinger.timeout, () => fail$1(new SocketError({ reason: new SocketReadError({ cause: /* @__PURE__ */ new Error("ping timeout") }) })))));
+	}).pipe(isSome(hooks) ? ensuring(hooks.value.onDisconnect) : identity, tapCause((cause) => {
+		const error = findError(cause);
+		const hasError = isSuccess(error);
+		const rpcError = new RpcClientError({ reason: hasError ? error.success.reason : new RpcClientDefect({
+			message: "Unknown socket error",
+			cause: squash(cause)
+		}) });
+		if (options?.retryTransientErrors && hasError && error.success.reason._tag === "SocketOpenError") return (options.onTransientError?.(rpcError) ?? void_).pipe(ignoreCause({
+			log: true,
+			message: "RpcClient onTransientError hook failed"
+		}));
+		return broadcastError(rpcError);
+	}), retryOrElse(options?.retryPolicy ?? defaultRetryPolicy, (error) => broadcastError(new RpcClientError({ reason: error.reason }))), annotateLogs({
+		module: "RpcClient",
+		method: "makeProtocolSocket"
+	}), forkScoped);
+	return {
+		send(clientId, request) {
+			if (currentError) return fail$1(currentError);
+			if (request._tag === "Request") requestClientMap.set(request.id, clientId);
+			const encoded = parser.encode(request);
+			if (encoded === void 0) return void_;
+			return orDie(writer.write(encoded));
+		},
+		supportsAck: true,
+		supportsTransferables: false,
+		codecFor: serialization.codecFor
+	};
+}));
+const defaultRetryPolicy = /*#__PURE__*/ min([/*#__PURE__*/ exponential(500, 1.5), /*#__PURE__*/ spaced(5e3)]);
+const makePinger = /*#__PURE__*/ fnUntraced(function* (writePing, options) {
+	const clock = yield* Clock;
+	const interval = options?.pingInterval ?? "5 seconds";
+	const timeoutMillis = toMillis(options?.pingTimeout ?? interval);
+	let lastSeen = clock.currentTimeMillisUnsafe();
+	const latch = makeUnsafe();
+	const onFrame = () => {
+		lastSeen = clock.currentTimeMillisUnsafe();
+	};
+	const reset = () => {
+		onFrame();
+		latch.closeUnsafe();
+	};
+	yield* suspend(() => {
+		if (clock.currentTimeMillisUnsafe() - lastSeen > timeoutMillis) return latch.open;
+		return writePing;
+	}).pipe(delay(interval), ignore, forever, interruptible, forkScoped);
+	return {
+		timeout: latch.await,
+		reset,
+		onFrame
+	};
+});
+/**
+* Provides a client `Protocol` backed by the current `Socket` and
+* `RpcSerialization` services.
+*
+* **Details**
+*
+* `pingInterval` defaults to 5 seconds. `pingTimeout` defaults to the interval
+* and measures time since the last decoded server frame, not the last pong.
+* The timeout is checked on each ping tick; any decoded frame counts as liveness.
+* `retryPolicy` configures retries after socket errors.
+*
+* @stability unstable
+* @category layers
+* @since 4.0.0
+*/
+const layerProtocolSocket = (options) => effect(Protocol)(makeProtocolSocket(options));
+/**
+* Represents optional client protocol hooks that run when a transport connects
+* and disconnects.
+*
+* **When to use**
+*
+* Use to run setup or cleanup effects when an RPC client transport opens or
+* closes.
+*
+* @stability unstable
+* @category services
+* @since 4.0.0
+*/
+var ConnectionHooks = class extends (/*#__PURE__*/ Service()("effect/rpc/RpcClient/ConnectionHooks")) {};
+//#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Console.js
 /**
 * Context reference for the current console service in the Effect system, allowing access to the active console implementation from within the Effect context.
 *
@@ -34,6 +697,7 @@ import { Cc as getOrElse, Ci as fail, Cl as identity, Co as provideMerge, Ct as
 *
 * @see {@link consoleWith} for using the current console service inside an effect
 *
+* @stability stable
 * @category services
 * @since 2.0.0
 */
@@ -62,10 +726,11 @@ const Console = ConsoleRef;
 * messages // => ["Hello, world!", "This is an error message"]
 * ```
 *
+* @stability stable
 * @category constructors
 * @since 2.0.0
 */
-const consoleWith = (f) => withFiber((fiber) => f(fiber.getRef(Console)));
+const consoleWith = (f) => withFiber$1((fiber) => f(fiber.getRef(Console)));
 /**
 * Writes an error-level message to the console, typically displayed with error
 * styling by the active console implementation.
@@ -95,6 +760,7 @@ const consoleWith = (f) => withFiber((fiber) => f(fiber.getRef(Console)));
 * messages // => expected
 * ```
 *
+* @stability stable
 * @category accessors
 * @since 2.0.0
 */
@@ -128,6 +794,7 @@ const error = (...args) => consoleWith((console) => sync(() => {
 * messages // => expected
 * ```
 *
+* @stability stable
 * @category accessors
 * @since 2.0.0
 */
@@ -135,7 +802,7 @@ const log = (...args) => consoleWith((console) => sync(() => {
 	console.log(...args);
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/CliError.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/CliError.js
 /**
 * Defines structured errors for the unstable CLI parser and runner.
 *
@@ -665,7 +1332,7 @@ var ShowHelp = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/ShowHelp`)(
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/Primitive.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/Primitive.js
 /**
 * Parses raw command-line strings into typed values.
 *
@@ -843,70 +1510,11 @@ const Choice = (choices) => {
 	const validChoices = choices.map(([key]) => format(key)).join(" | ");
 	const primitive = makePrimitive("Choice", (value) => {
 		if (choiceMap.has(value)) return succeed$1(choiceMap.get(value));
-		return fail(validChoices);
+		return fail$1(validChoices);
 	});
 	return Object.assign(primitive, { choiceKeys: choices.map(([key]) => key) });
 };
 /**
-* Creates a primitive that validates and resolves file system paths.
-*
-* **Example** (Parsing file system paths)
-*
-* ```ts import.meta.vitest
-* import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
-* import { Primitive } from "effect/cli"
-* import { ChildProcessSpawner } from "effect/process"
-*
-* const services = Layer.mergeAll(
-*   Path.layer,
-*   FileSystem.layerNoop({
-*     exists: () => Effect.succeed(true),
-*     stat: () => Effect.succeed({ type: "File" } as FileSystem.File.Info)
-*   }),
-*   Stdio.layerTest({}),
-*   Layer.succeed(Terminal.Terminal, Terminal.make({
-*     columns: Effect.succeed(80),
-*     rows: Effect.succeed(24),
-*     readInput: Effect.die("unused"),
-*     readLine: Effect.die("unused"),
-*     display: () => Effect.void
-*   })),
-*   Layer.succeed(
-*     ChildProcessSpawner.ChildProcessSpawner,
-*     ChildProcessSpawner.make(() => Effect.die("unused"))
-*   )
-* )
-*
-* const program = Effect.gen(function*() {
-*   const filePrimitive = Primitive.Path("file", true)
-*   const filePath = yield* filePrimitive.parse("./package.json")
-*   return filePath.endsWith("/package.json")
-* }).pipe(Effect.provide(services))
-*
-* await Effect.runPromise(program) // => true
-* ```
-*
-* @stability unstable
-* @category constructors
-* @since 4.0.0
-*/
-const Path$1 = (pathType, mustExist) => {
-	const primitive = makePrimitive("Path", fnUntraced(function* (value) {
-		const fs = yield* FileSystem;
-		const path = yield* Path$2;
-		const absolutePath = path.isAbsolute(value) ? value : path.resolve(value);
-		const exists = yield* mapError(fs.exists(absolutePath), (error) => `Failed to check path existence: ${error.message}`);
-		if (mustExist === true && !exists) return yield* fail(`Path does not exist: ${absolutePath}`);
-		if (exists && pathType !== "either") {
-			const stat = yield* mapError(fs.stat(absolutePath), (error) => `Failed to stat path: ${error.message}`);
-			if (pathType === "file" && stat.type !== "File") return yield* fail(`Path is not a file: ${absolutePath}`);
-			if (pathType === "directory" && stat.type !== "Directory") return yield* fail(`Path is not a directory: ${absolutePath}`);
-		}
-		return absolutePath;
-	}));
-	return Object.assign(primitive, { pathType });
-};
-/**
 * Gets a human-readable type name for a primitive.
 *
 * **When to use**
@@ -963,7 +1571,7 @@ const getChoiceKeys = (primitive) => primitive._tag === "Choice" ? primitive.cho
 */
 const getPathType = (primitive) => primitive._tag === "Path" ? primitive.pathType : void 0;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/ansi.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/ansi.js
 /**
 * Internal ANSI escape sequence helpers used by the unstable CLI rendering
 * implementation. This module centralizes the control codes for text styling,
@@ -1085,7 +1693,7 @@ const eraseLines = (rows) => {
 	return command;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/Prompt.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/Prompt.js
 /**
 * Builds interactive terminal prompts for CLI applications.
 *
@@ -1323,8 +1931,8 @@ const Number$1 = (options) => {
 		decrementBy: 1,
 		precision: 2,
 		validate: (n) => {
-			if (n < opts.min) return fail(`${n} must be greater than or equal to ${opts.min}`);
-			if (n > opts.max) return fail(`${n} must be less than or equal to ${opts.max}`);
+			if (n < opts.min) return fail$1(`${n} must be greater than or equal to ${opts.min}`);
+			if (n > opts.max) return fail$1(`${n} must be less than or equal to ${opts.max}`);
 			return succeed$1(n);
 		},
 		...options
@@ -1361,8 +1969,8 @@ const Int = (options) => {
 		incrementBy: 1,
 		decrementBy: 1,
 		validate: (n) => {
-			if (n < opts.min) return fail(`${n} must be greater than or equal to ${opts.min}`);
-			if (n > opts.max) return fail(`${n} must be less than or equal to ${opts.max}`);
+			if (n < opts.min) return fail$1(`${n} must be greater than or equal to ${opts.min}`);
+			if (n > opts.max) return fail$1(`${n} must be less than or equal to ${opts.max}`);
 			return succeed$1(n);
 		},
 		...options
@@ -1395,7 +2003,7 @@ const map$2 = /*#__PURE__*/ dual(2, (self, f) => flatMap(self, (a) => succeed(f(
 * @category constructors
 * @since 4.0.0
 */
-const Password = (options) => basePrompt(options, "password").pipe(map$2(make$1));
+const Password = (options) => basePrompt(options, "password").pipe(map$2(make$2));
 /**
 * Runs a prompt by reading terminal input and rendering prompt frames until the
 * prompt submits a value.
@@ -1563,7 +2171,7 @@ const eraseText = (text, columns) => {
 };
 const lines = (prompt, columns) => {
 	const lines = prompt.split(NEWLINE_REGEXP);
-	return columns === 0 ? lines.length : pipe(map$4(lines, (line) => Math.ceil(line.length / columns)), reduce(0, (left, right) => left + right));
+	return columns === 0 ? lines.length : pipe(map$5(lines, (line) => Math.ceil(line.length / columns)), reduce(0, (left, right) => left + right));
 };
 const clearOutputWithError = (outputText, columns, errorText) => {
 	if (errorText !== void 0 && errorText.length > 0) return cursorDown(lines(errorText, columns)) + eraseText(`\n${errorText}`, columns) + eraseText(outputText, columns);
@@ -1634,7 +2242,7 @@ const renderDateError = (state, pointer, theme) => {
 		const errorLines = state.error.value.split(NEWLINE_REGEXP);
 		if (isReadonlyArrayNonEmpty(errorLines)) {
 			const prefix = annotateSymbol(pointer, theme.errorColor);
-			const lines = map$4(errorLines, (str) => annotateErrorLine(str, theme.errorColor));
+			const lines = map$5(errorLines, (str) => annotateErrorLine(str, theme.errorColor));
 			return cursorSavePosition + "\n" + separateSymbol(prefix, lines.join("\n")) + cursorRestorePosition;
 		}
 	}
@@ -1842,7 +2450,7 @@ const makeDateParts = (dateMask, date, locales) => {
 		if (element.isToken() && lastElement !== void 0 && lastElement.isToken()) lastElement.setValue(element.token);
 		else array.push(element);
 		return array;
-	}, empty());
+	}, empty$2());
 	parts.splice(0, parts.length, ...orderedParts);
 	return parts;
 };
@@ -2048,7 +2656,7 @@ const renderPrompt = (confirm, message, leadingSymbol, trailingSymbol, options)
 	return match(message.split(NEWLINE_REGEXP), {
 		onEmpty: () => renderLine(""),
 		onNonEmpty: (promptLines) => {
-			const lines = map$4(promptLines, (line) => annotate(line));
+			const lines = map$5(promptLines, (line) => annotate(line));
 			return renderLine(lines.join("\n"));
 		}
 	});
@@ -2082,7 +2690,7 @@ const renderNumberError = (state, pointer, theme, renderOptions) => {
 		onNonEmpty: (errorLines) => {
 			if (renderOptions?.plain === true) return separateSymbol(pointer, errorLines.join("\n"));
 			const prefix = annotateSymbol(pointer, theme.errorColor);
-			const lines = map$4(errorLines, (str) => annotateErrorLine(str, theme.errorColor));
+			const lines = map$5(errorLines, (str) => annotateErrorLine(str, theme.errorColor));
 			return cursorSavePosition + "\n" + separateSymbol(prefix, lines.join("\n")) + cursorRestorePosition;
 		}
 	});
@@ -2359,7 +2967,7 @@ const renderTextError = (nextState, pointer, theme, renderOptions) => {
 		onNonEmpty: (errorLines) => {
 			if (renderOptions?.plain === true) return separateSymbol(pointer, errorLines.join("\n"));
 			const prefix = annotateSymbol(pointer, theme.errorColor);
-			const lines = map$4(errorLines, (str) => annotateErrorLine(str, theme.errorColor));
+			const lines = map$5(errorLines, (str) => annotateErrorLine(str, theme.errorColor));
 			return cursorSavePosition + "\n" + separateSymbol(prefix, lines.join("\n")) + cursorRestorePosition;
 		}
 	});
@@ -2587,7 +3195,20 @@ const entriesToDisplay = (cursor, total, maxVisible) => {
 	};
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/Param.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/Param.js
+/**
+* Defines the shared parameter model for CLI arguments and flags.
+*
+* A `Param<Kind, A>` describes how to consume parsed command-line input and
+* return a typed value. The `Kind` decides whether the parameter reads
+* positional arguments or named flags. `Argument` and `Flag` build on this
+* module to share parsing structure, primitive constructors, help metadata,
+* aliases, defaults, prompts, configuration fallbacks, validation, schema
+* decoding, fallback parameters, and traversal helpers.
+*
+* @stability unstable
+* @since 4.0.0
+*/
 const TypeId$1 = "~effect/cli/Param";
 /**
 * Defines the kind discriminator for positional argument parameters.
@@ -2791,71 +3412,6 @@ const Literals$1 = (kind, name, choices) => {
 	const mappedChoices = choices.map((value) => [value, value]);
 	return ChoiceWithValue$1(kind, name, mappedChoices);
 };
-/**
-* Creates a path parameter that accepts file or directory paths.
-*
-* **Example** (Creating path parameters)
-*
-* ```ts import.meta.vitest
-* import { Param } from "effect/cli"
-*
-* // Basic path parameter
-* const outputPath = Param.Path(Param.flagKind, "output")
-*
-* // Path that must exist
-* const inputPath = Param.Path(Param.flagKind, "input", { mustExist: true })
-*
-* // File-only path
-* const configFile = Param.Path(Param.flagKind, "config", {
-*   pathType: "file",
-*   mustExist: true,
-*   typeName: "config-file"
-* })
-* const kinds = [outputPath.kind, inputPath.kind, configFile.kind] // => ["flag", "flag", "flag"]
-* ```
-*
-* @stability unstable
-* @category constructors
-* @since 4.0.0
-*/
-const Path = (kind, name, options) => makeSingle({
-	name,
-	kind,
-	primitiveType: Path$1(options?.pathType ?? "either", options?.mustExist),
-	typeName: options?.typeName
-});
-/**
-* Creates a directory path parameter.
-*
-* **Details**
-*
-* This is a convenience function that creates a path parameter with the
-* `pathType` set to `"directory"` and a default type name of `"directory"`.
-*
-* **Example** (Creating directory parameters)
-*
-* ```ts import.meta.vitest
-* import { Param } from "effect/cli"
-*
-* // Basic directory parameter
-* const outputDir = Param.Directory(Param.flagKind, "output-dir")
-*
-* // Directory that must exist
-* const sourceDir = Param.Directory(Param.flagKind, "source", { mustExist: true })
-*
-* // Usage: --output-dir /path/to/dir --source /existing/dir
-* const kinds = [outputDir.kind, sourceDir.kind] // => ["flag", "flag"]
-* ```
-*
-* @stability unstable
-* @category constructors
-* @since 4.0.0
-*/
-const Directory$1 = (kind, name, options) => Path(kind, name, {
-	pathType: "directory",
-	typeName: "directory",
-	mustExist: options?.mustExist
-});
 const FLAG_DASH_REGEXP = /^-+/;
 /**
 * Adds an alias to an option.
@@ -3091,7 +3647,7 @@ const optional$1 = (param) => {
 * @category combinators
 * @since 4.0.0
 */
-const withDefault$2 = /*#__PURE__*/ dual(2, (self, defaultValue) => {
+const withDefault$1 = /*#__PURE__*/ dual(2, (self, defaultValue) => {
 	if (!isEffect(defaultValue)) return map$1(optional$1(self), getOrElse(() => defaultValue));
 	return mapEffect(optional$1(self), match$1({
 		onNone: () => defaultValue,
@@ -3099,6 +3655,44 @@ const withDefault$2 = /*#__PURE__*/ dual(2, (self, defaultValue) => {
 	}));
 });
 /**
+* Adds a fallback config that is loaded when a required parameter is missing.
+*
+* **When to use**
+*
+* Use when you need config to provide a fallback source for required flags or
+* arguments that are absent from CLI input.
+*
+* **Details**
+*
+* Provided CLI values win. Config is loaded only after a missing option or
+* missing argument error.
+*
+* **Gotchas**
+*
+* Missing config preserves the original missing-parameter error. Config parse
+* failure becomes `CliError.InvalidValue`.
+*
+* @see {@link withDefault} for a pure default value
+* @see {@link withFallbackPrompt} for prompting interactively when input is missing
+*
+* @stability unstable
+* @category combinators
+* @since 4.0.0
+*/
+const withFallbackConfig$1 = /*#__PURE__*/ dual(2, (self, config) => {
+	const toInvalidValue = (error, configError) => new InvalidValue({
+		option: error._tag === "MissingOption" ? error.option : error.argument,
+		value: "config",
+		expected: configError.message,
+		kind: error._tag === "MissingOption" ? "flag" : "argument"
+	});
+	const runConfig = (error, args) => option(config).pipe(mapError((configError) => toInvalidValue(error, configError)), flatMap$1(match$1({
+		onNone: () => fail$1(error),
+		onSome: (value) => succeed$1([args.arguments, value])
+	})));
+	return transform(self, (parse) => (args) => parse(args).pipe(catchTag(["MissingOption", "MissingArgument"], (error) => runConfig(error, args))));
+});
+/**
 * Creates a variadic parameter that can be specified multiple times.
 *
 * **Details**
@@ -3336,7 +3930,7 @@ const getParamMetadata = (param) => {
 	});
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/Argument.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/Argument.js
 /**
 * Creates a positional string argument.
 *
@@ -3355,23 +3949,6 @@ const getParamMetadata = (param) => {
 */
 const String$2 = (name) => String$3(argumentKind, name);
 /**
-* Creates a positional directory path argument.
-*
-* **Example** (Creating a directory path argument)
-*
-* ```ts import.meta.vitest
-* import { Argument } from "effect/cli"
-*
-* const workspace = Argument.Directory("workspace", { mustExist: true }) // Must exist
-* workspace.kind // => "argument"
-* ```
-*
-* @stability unstable
-* @category constructors
-* @since 4.0.0
-*/
-const Directory = (name, options) => Directory$1(argumentKind, name, options);
-/**
 * Adds a description to a positional argument.
 *
 * **Example** (Adding an argument description)
@@ -3390,25 +3967,8 @@ const Directory = (name, options) => Directory$1(argumentKind, name, options);
 * @since 4.0.0
 */
 const withDescription$2 = /*#__PURE__*/ dual(2, (self, description) => withDescription$3(self, description));
-/**
-* Provides a default value for a positional argument.
-*
-* **Example** (Providing a default value)
-*
-* ```ts import.meta.vitest
-* import { Argument } from "effect/cli"
-*
-* const port = Argument.Int("port").pipe(Argument.withDefault(8080))
-* port.kind // => "argument"
-* ```
-*
-* @stability unstable
-* @category combinators
-* @since 4.0.0
-*/
-const withDefault$1 = withDefault$2;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/CliOutput.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/CliOutput.js
 /**
 * Formats CLI help and errors as text.
 *
@@ -3676,7 +4236,7 @@ const formatHelpDocImpl = (doc, colors) => {
 	return sections.join("\n");
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/completions/bash.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/completions/bash.js
 const escapeForBash = (s) => s.replace(/'/g, "'\\''");
 const sanitizeFunctionName = (s) => s.replace(/[^a-zA-Z0-9_]/g, "_");
 const flagNamesForWordlist = (flag) => {
@@ -3946,7 +4506,7 @@ const generate$3 = (executableName, descriptor) => {
 	return lines.join("\n");
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/completions/fish.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/completions/fish.js
 const escapeFishString = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
 /** Escape choices for Fish's second expansion of `complete -a`. */
 const escapeFishChoice = (s) => escapeFishString(s.replace(/[^A-Za-z0-9_.,/@%+-]/gu, "\\$&"));
@@ -4096,7 +4656,7 @@ const generate$2 = (executableName, descriptor) => {
 	return lines.join("\n");
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/completions/zsh.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/completions/zsh.js
 const escapeZsh = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "'\\''").replace(/:/g, "\\:");
 /** Escape choices for the second parse of a Zsh `_arguments` action. */
 const escapeZshChoice = (s) => s.replace(/[^A-Za-z0-9_.,/@%+-]/gu, "\\$&").replace(/'/g, "'\\''");
@@ -4243,7 +4803,7 @@ const generate$1 = (executableName, descriptor) => {
 	return lines.join("\n");
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/Completions.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/Completions.js
 /**
 * The `Completions` module turns a plain description of an Effect CLI command
 * tree into shell completion scripts for Bash, Zsh, and Fish. It is the
@@ -4281,7 +4841,7 @@ const generate = (executableName, shell, descriptor) => {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/Flag.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/Flag.js
 /**
 * Creates a string flag that accepts text input.
 *
@@ -4504,7 +5064,27 @@ const optional = (param) => optional$1(param);
 * @category optionality
 * @since 4.0.0
 */
-const withDefault = withDefault$2;
+const withDefault = withDefault$1;
+/**
+* Adds a fallback config that is loaded when a required flag is missing.
+*
+* **Example** (Falling back to config)
+*
+* ```ts import.meta.vitest
+* import { Config } from "effect"
+* import { Flag } from "effect/cli"
+*
+* const verbose = Flag.Boolean("verbose").pipe(
+*   Flag.withFallbackConfig(Config.Boolean("VERBOSE"))
+* )
+* verbose.kind // => "flag"
+* ```
+*
+* @stability unstable
+* @category combinators
+* @since 4.0.0
+*/
+const withFallbackConfig = /*#__PURE__*/ dual(2, (self, config) => withFallbackConfig$1(self, config));
 /**
 * Transforms the parsed value of a flag using a mapping function.
 *
@@ -4531,7 +5111,7 @@ const withDefault = withDefault$2;
 */
 const map = /*#__PURE__*/ dual(2, (self, f) => map$1(self, f));
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/config.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/config.js
 /**
 * Config Internal
 * ================
@@ -4652,7 +5232,7 @@ const reconstructTree = (tree, results) => {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/command.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/command.js
 /**
 * Command Implementation
 * ======================
@@ -4682,7 +5262,7 @@ const makeCommand = (options) => {
 	const annotations = options.annotations ?? empty$1();
 	const globalFlags = options.globalFlags ?? [];
 	const subcommands = options.subcommands ?? [];
-	const handle = (input, commandPath) => isNotUndefined(options.handle) ? options.handle(input, commandPath) : fail(new ShowHelp({
+	const handle = (input, commandPath) => isNotUndefined(options.handle) ? options.handle(input, commandPath) : fail$1(new ShowHelp({
 		commandPath,
 		errors: []
 	}));
@@ -4723,7 +5303,7 @@ const makeCommand = (options) => {
 			if (visible.length === 0) continue;
 			subcommandDocs.push({
 				group: group.group,
-				commands: map$4(visible, (subcommand) => ({
+				commands: map$5(visible, (subcommand) => ({
 					name: subcommand.name,
 					alias: subcommand.alias,
 					shortDescription: subcommand.shortDescription,
@@ -4846,7 +5426,7 @@ const checkForDuplicateFlags = (parent, subcommands, options) => {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/completions/descriptor.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/completions/descriptor.js
 /**
 * CommandDescriptor — pure-data representation of a command tree for
 * shell completion generation.
@@ -4956,7 +5536,7 @@ const fromCommand = (cmd, inheritedFlags = []) => {
 	};
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/help.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/help.js
 /**
 * Help Documentation
 * ================
@@ -5066,7 +5646,7 @@ const getHelpForCommandPath = (command, commandPath, builtIns) => gen(function*
 	};
 });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/GlobalFlag.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/GlobalFlag.js
 /**
 * Global flags for Effect CLI command trees. Global flags are parsed outside a
 * single command's local flags and can apply to a command and its descendants.
@@ -5181,7 +5761,7 @@ const Completions = /*#__PURE__*/ Action({
 		"zsh",
 		"fish",
 		"sh"
-	]).pipe(optional, /*#__PURE__*/ map((v) => map$5(v, (s) => s === "sh" ? "bash" : s)), /*#__PURE__*/ withMetavar("<bash|zsh|fish|sh>"), /*#__PURE__*/ withDescription$1("Print shell completion script")),
+	]).pipe(optional, /*#__PURE__*/ map((v) => map$4(v, (s) => s === "sh" ? "bash" : s)), /*#__PURE__*/ withMetavar("<bash|zsh|fish|sh>"), /*#__PURE__*/ withDescription$1("Print shell completion script")),
 	run: /*#__PURE__*/ fnUntraced(function* (shell, { command }) {
 		if (isNone(shell)) return;
 		const descriptor = fromCommand(command);
@@ -5247,7 +5827,7 @@ const BuiltIns = [
 	LogLevel
 ];
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/CliConfig.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/CliConfig.js
 /**
 * Configuration for Effect CLI command execution.
 *
@@ -5277,7 +5857,7 @@ var CliConfig = class extends (/*#__PURE__*/ Reference("effect/cli/CliConfig", {
 */
 const defaults = { builtIns: BuiltIns };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/lexer.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/lexer.js
 /**
 * @internal
 */
@@ -5339,7 +5919,7 @@ const lexTokens = (args) => {
 	return tokens;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/auto-suggest.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/auto-suggest.js
 /**
 * Simple Levenshtein distance implementation (small N, no perf worries)
 */
@@ -5367,7 +5947,7 @@ const suggest = (input, candidates) => {
 	return distances.filter(([d]) => d === minDistance).map(([, c]) => c);
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/parser.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/parser.js
 /**
 * Parsing Pipeline for CLI Commands
 * ==================================
@@ -5899,7 +6479,7 @@ const scanCommandLevel = (tokens, context) => {
 	return toLeafResult(state);
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/internal/wizard.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/internal/wizard.js
 const run$1 = /*#__PURE__*/ fnUntraced(function* (command, options) {
 	const commandPath = options?.commandPath ?? [command.name];
 	const selected = getCommandAtPath(command, commandPath);
@@ -6069,7 +6649,7 @@ const wrapCommand = (commandLine) => {
 };
 const formatShellArg = (arg) => /^[A-Za-z0-9_./:@%+=,-]+$/.test(arg) ? arg : `'${arg.replaceAll("'", `'"'"'`)}'`;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.0/node_modules/effect/dist/cli/Command.js
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/Command.js
 /**
 * Returns `true` if the provided value is a `Command`.
 *
@@ -6668,44 +7248,56 @@ const runWith = (command, config) => {
 		}
 		const services = match$1(logLevel, {
 			onNone: () => empty$1(),
-			onSome: (level) => make$2(MinimumLogLevel, level)
+			onSome: (level) => make$3(MinimumLogLevel, level)
 		});
 		yield* provideContext(program, services);
-	}, catchFilter((error) => isCliError(error) && error._tag === "ShowHelp" ? succeed$2(error) : fail$1(error), (error) => andThen(showHelp(command, error, config.renderErrors !== false), fail(error))), catchFilter((error) => config.renderErrors !== false && isCliError(error) && error._tag === "UserError" ? succeed$2(error) : fail$1(error), (error) => andThen(showUserError(error), fail(error))), catchFilter((e) => isQuitError(e) ? succeed$2(e) : fail$1(e), (_) => interrupt));
+	}, catchFilter((error) => isCliError(error) && error._tag === "ShowHelp" ? succeed$2(error) : fail$2(error), (error) => andThen(showHelp(command, error, config.renderErrors !== false), fail$1(error))), catchFilter((error) => config.renderErrors !== false && isCliError(error) && error._tag === "UserError" ? succeed$2(error) : fail$2(error), (error) => andThen(showUserError(error), fail$1(error))), catchFilter((e) => isQuitError(e) ? succeed$2(e) : fail$2(e), (_) => interrupt$1));
 };
 //#endregion
 //#region package.json
-var version = "0.1.0";
+var version = "0.1.1021";
 //#endregion
 //#region src/main.cli.ts
-const media = pipe(make("media", {
-	language: pipe(String$1("language"), withDescription$1("Spoken language code, such as it; defaults to the original caption language, then the declared language, then English"), optional),
-	link: pipe(String$2("url"), withDescription$2("Video or post URL")),
-	output: pipe(Directory("output", { mustExist: false }), withDescription$2("Directory for info.md and transcript.txt"), withDefault$1("/tmp/media"))
+function section(title, text) {
+	return isEmpty(text) ? "" : `## ${title}\n\n${text}`;
+}
+const save = pipe(make("save", {
+	entry: pipe(String$2("text"), withDescription$2("A link, or the text of a note")),
+	server: pipe(String$1("server"), withDescription$1("Stash server; defaults to STASH_SERVER, then the tailnet address on dev"), withFallbackConfig(String$7("STASH_SERVER")), withDefault("https://dev.tailnet-8c4c.ts.net:8443"))
 }, fnUntraced(function* (input) {
-	const fs = yield* FileSystem;
-	const path = yield* Path$2;
-	const output = path.resolve(input.output);
-	const info = path.join(output, "info.md");
-	const transcript = path.join(output, "transcript.txt");
-	yield* fs.makeDirectory(output, { recursive: true });
-	yield* fs.remove(info, { force: true });
-	yield* fs.remove(transcript, { force: true });
-	const report = yield* (yield* Media).read({
-		language: input.language,
-		link: input.link,
-		maxWhisperSeconds: none()
-	});
-	yield* fs.writeFileString(info, report.info);
-	yield* log(`Wrote ${info}`);
-	yield* match$1(yield* report.transcript, {
-		onNone: () => void_,
-		onSome: (text) => andThen(fs.writeFileString(transcript, text.text), log(`Wrote ${transcript} from ${text.source === "captions" ? "published captions" : "local Whisper"}`))
-	});
-})), withDescription("Write info.md (title, author, date, description, chapters and X post text) and transcript.txt with [mm:ss] timestamps for a video or social post URL. Uses published captions when they exist, otherwise downloads the audio and transcribes it locally with Whisper. Needs ffmpeg on PATH; caches yt-dlp and the model in $XDG_CACHE_HOME/deslop/media, ~/.cache by default."), withExamples([{
-	command: "vpx @deslop/stash@latest media https://x.com/poteto/status/2102050467505430555 /tmp/media/poteto",
-	description: "Transcribe the talk attached to an X post."
+	const note = yield* pipe(gen(function* () {
+		const client = yield* make$1(RpcContracts);
+		const saved = yield* client["notes.capture"]({
+			id: yield* (yield* Crypto).randomUUIDv4,
+			text: input.entry
+		});
+		yield* logInfo("Saved; the server is reading and tagging it, which takes minutes for a long video");
+		yield* pipe(client["notes.watch"](void 0), filter((event) => some$1(event.upserted, (item) => item.id === saved.id && item.status !== "organizing")), runHead, timeoutOrElse({
+			duration: "2 hours",
+			orElse: () => fail$1(NotesError.make({ message: "The server did not finish the note within two hours." }))
+		}));
+		return yield* client["notes.get"]({ id: saved.id });
+	}), scoped, provide(pipe(layerProtocolSocket(), provide$1(layerWebSocket(pipe(new URL("/api/rpc", input.server).href, replace(/^http/u, "ws")))), provide$1(layerWebSocketConstructorGlobal), provide$1(layerJson))));
+	yield* log(pipe([
+		`# ${note.title}`,
+		join(filter$1([
+			note.author,
+			note.source,
+			note.url ?? ""
+		], isNonEmpty), " · "),
+		join(map$5(note.tags, (name) => `#${name}`), " "),
+		note.summary,
+		section("Notes", note.body ?? ""),
+		section("Topics", note.topics ?? ""),
+		section("Text in the images", note.screenText ?? ""),
+		section("Source", note.content),
+		section("Transcript", note.transcript ?? ""),
+		section("Issue", note.issue)
+	], filter$1(isNonEmpty), join("\n\n")));
+})), withDescription("Save a link or a note to stash and print it as Markdown: title, summary, tags, notes, source text and the transcript with [mm:ss] timestamps. The server reads the link, transcribes its video with published captions or Whisper, and tags it; the CLI waits until it finishes. Needs the tailnet."), withExamples([{
+	command: "vpx @deslop/stash@latest save https://x.com/poteto/status/2102050467505430555",
+	description: "Save the talk attached to an X post and print its note and transcript."
 }]));
-runMain(pipe(make("stash"), withDescription("Read what a video or social post says; the stash server and iOS app share this package."), withSubcommands([media]), run({ version }), scoped, provideService(LogToStderr, true), provide(pipe(Media.layer, provideMerge(merge(layer, layer$1))))));
+runMain(pipe(make("stash"), withDescription("Save links and notes to stash; the server and iOS app share this package."), withSubcommands([save]), run({ version }), provideService(LogToStderr, true), provide(layer)));
 //#endregion
 export {};