@shpitdev/convex-cliproxy-observability 0.1.0

package/dist/protocols/index.js

@@ -0,0 +1,139 @@
+import { assembleResponsesStream } from "./responses.js";
+import { assembleChatStream } from "./chat-completions.js";
+import { assembleAnthropicStream } from "./anthropic-messages.js";
+import { SSEReader } from "./framing.js";
+import { object, parseObject } from "./values.js";
+import { requestInput, responseOutput } from "./output.js";
+export { SSEReader } from "./framing.js";
+export { assembleResponsesStream, assembleChatStream, assembleAnthropicStream };
+export { nanoTime } from "./values.js";
+export const PARSER_VERSION = "client-protocol-v1";
+export function protocolForRoute(route) {
+    if (route === "POST /v1/messages" || route === "POST /v1/messages/count_tokens")
+        return "anthropic_messages";
+    if (route === "POST /v1/responses")
+        return "responses";
+    if (route === "POST /v1/chat/completions")
+        return "chat_completions";
+    return "unknown";
+}
+/** Bounded replay helper for fixtures and selected-call export; never fetches data itself. */
+export function projectCapturedPayloads(args) {
+    const projection = {
+        version: 1,
+        protocol: protocolForRoute(args.route),
+        requestState: "absent",
+        responseState: "absent",
+        scalars: {},
+        metadata: { parserVersion: PARSER_VERSION, providerIdentity: "unavailable" },
+    };
+    const decoder = new TextDecoder("utf-8", { fatal: true });
+    if (args.request) {
+        try {
+            const req = parseObject(decoder.decode(args.request));
+            projection.input = requestInput(projection.protocol, req);
+            projection.requestState = "decoded";
+            if (typeof req.model === "string")
+                projection.scalars.requestModel = req.model;
+            if (typeof req.stream === "boolean")
+                projection.scalars.streamed = req.stream;
+        }
+        catch {
+            projection.requestState = "invalid";
+        }
+    }
+    let response = {};
+    if (args.response) {
+        try {
+            response = parseObject(decoder.decode(args.response));
+            projection.responseState = "decoded";
+            projection.metadata.terminalObserved = true;
+            projection.metadata.usageState = response.usage ? "terminal_snapshot" : "absent";
+        }
+        catch {
+            projection.responseState = "invalid";
+        }
+    }
+    if (args.chunks) {
+        const reader = new SSEReader();
+        const events = [];
+        let done = false;
+        let invalid = false;
+        let bytes = 0;
+        for (const chunk of args.chunks) {
+            bytes += chunk.byteLength;
+            if (bytes > 16 * 1024 * 1024)
+                throw new Error("bounded replay limit; use event pages for larger calls");
+            try {
+                for (const frame of reader.feed(chunk)) {
+                    if (frame.data === "[DONE]") {
+                        done = true;
+                        continue;
+                    }
+                    try {
+                        events.push(parseObject(frame.data));
+                    }
+                    catch {
+                        invalid = true;
+                    }
+                }
+            }
+            catch {
+                invalid = true;
+            }
+        }
+        try {
+            invalid ||= reader.finish().truncated;
+        }
+        catch {
+            invalid = true;
+        }
+        const assembled = projection.protocol === "responses"
+            ? assembleResponsesStream(events)
+            : projection.protocol === "chat_completions"
+                ? assembleChatStream(events, done, args.complete === true)
+                : assembleAnthropicStream(events);
+        response = assembled.response;
+        invalid ||= assembled.invalid;
+        projection.responseState = invalid
+            ? "invalid"
+            : !assembled.recognized || assembled.unsupported
+                ? "unsupported"
+                : assembled.terminal
+                    ? "decoded"
+                    : "truncated";
+        projection.metadata.terminalObserved = assembled.terminal;
+        const final = assembled.terminalUsage &&
+            assembled.terminal &&
+            !invalid &&
+            assembled.recognized &&
+            !assembled.unsupported;
+        projection.metadata.usageState =
+            final && response.usage
+                ? "terminal_snapshot"
+                : response.usage
+                    ? "partial_snapshot"
+                    : "absent";
+        if (!final) {
+            projection.metadata.partialUsage = response.usage;
+            delete response.usage;
+        }
+    }
+    if (projection.protocol !== "unknown" && (args.response || args.chunks))
+        responseOutput(projection, response);
+    if (projection.protocol === "responses" && typeof response.status === "string")
+        projection.scalars.statusJson = JSON.stringify({ responseStatus: response.status });
+    if (args.route === "POST /v1/messages/count_tokens") {
+        projection.metadata.operation = "token_count";
+        projection.metadata.tokenCount = object(response).input_tokens;
+        projection.scalars.inputTokens = undefined;
+        projection.scalars.outputTokens = undefined;
+        projection.scalars.totalTokens = undefined;
+    }
+    if (args.route === "GET /v1/models") {
+        projection.metadata.operation = "discovery";
+        projection.output = { native: response };
+    }
+    return projection;
+}
+//# sourceMappingURL=index.js.map

package/dist/protocols/index.js.map

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

package/dist/protocols/output.d.ts

@@ -0,0 +1,4 @@
+import type { CliproxyProjection, RecordValue } from "./types.js";
+export declare function requestInput(protocol: CliproxyProjection["protocol"], request: RecordValue): RecordValue;
+export declare function responseOutput(projection: CliproxyProjection, response: RecordValue): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/protocols/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/protocols/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAKlE,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACxC,OAAO,EAAE,WAAW,GACnB,WAAW,CAoBb;AACD,wBAAgB,cAAc,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,WAAW,QAgDnF"}

package/dist/protocols/output.js

@@ -0,0 +1,81 @@
+import { identity, list, object } from "./values.js";
+import { extractUsage } from "./usage.js";
+import { responsesMessages } from "./responses.js";
+import { anthropicMessages } from "./anthropic-messages.js";
+export function requestInput(protocol, request) {
+    if (protocol === "anthropic_messages") {
+        const messages = anthropicMessages(request.messages);
+        if (request.system !== undefined)
+            messages.unshift({ role: "system", content: request.system });
+        return { ...request, messages, nativeMessages: request.messages };
+    }
+    if (protocol === "responses") {
+        const { input, ...rest } = request;
+        return {
+            ...rest,
+            messages: [
+                ...(typeof request.instructions === "string"
+                    ? [{ role: "system", content: request.instructions }]
+                    : []),
+                ...(typeof input === "string" ? [{ role: "user", content: input }] : list(input)),
+            ],
+            nativeInput: input,
+        };
+    }
+    return request;
+}
+export function responseOutput(projection, response) {
+    projection.scalars.responseModel = identity(response.model);
+    projection.scalars.generationId = identity(response.id);
+    if (projection.responseState === "decoded" && response.usage !== undefined)
+        extractUsage(projection, object(response.usage));
+    let messages;
+    if (projection.protocol === "chat_completions") {
+        const choices = list(response.choices);
+        messages = choices.map((raw) => ({
+            ...object(object(raw).message),
+            choiceIndex: object(raw).index,
+            finishReason: object(raw).finish_reason,
+        }));
+        projection.scalars.finishReason = identity(object(choices[0]).finish_reason);
+    }
+    else if (projection.protocol === "responses") {
+        messages = responsesMessages(response.output);
+        projection.scalars.finishReason = identity(response.status);
+    }
+    else {
+        messages = anthropicMessages([{ role: "assistant", content: response.content }]);
+        projection.scalars.finishReason = identity(response.stop_reason);
+    }
+    const first = messages[0] ?? {};
+    const text = [];
+    const reasoning = [];
+    const selected = projection.protocol === "chat_completions" ? [first] : messages;
+    for (const message of selected) {
+        if (typeof message.content === "string")
+            text.push(message.content);
+        if (typeof message.reasoning_content === "string")
+            reasoning.push(message.reasoning_content);
+        if (typeof message.reasoning === "string")
+            reasoning.push(message.reasoning);
+        for (const raw of [...list(message.content), ...list(message.summary)]) {
+            const block = object(raw);
+            if (["text", "output_text"].includes(String(block.type)) && typeof block.text === "string")
+                text.push(block.text);
+            if (block.type === "thinking" && typeof block.thinking === "string")
+                reasoning.push(block.thinking);
+            if (block.type === "summary_text" && typeof block.text === "string")
+                reasoning.push(block.text);
+        }
+    }
+    projection.output = {
+        format: "cliproxy_response_v1",
+        protocol: projection.protocol,
+        completion: text.join(""),
+        reasoning: reasoning.join(""),
+        messages,
+        // Native blocks preserve signatures, tool results, refusal, unknown content and errors.
+        native: response,
+    };
+}
+//# sourceMappingURL=output.js.map

package/dist/protocols/output.js.map

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

package/dist/protocols/responses.d.ts

@@ -0,0 +1,12 @@
+import type { RecordValue } from "./types.js";
+/** Reconstruct only emitted Responses content; a completed item is not a completed call. */
+export declare function assembleResponsesStream(events: RecordValue[]): {
+    response: RecordValue;
+    terminal: boolean;
+    terminalUsage: boolean;
+    recognized: boolean;
+    invalid: boolean;
+    unsupported: boolean;
+};
+export declare function responsesMessages(output: unknown): RecordValue[];
+//# sourceMappingURL=responses.d.ts.map

package/dist/protocols/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/protocols/responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,4FAA4F;AAC5F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE;;;;;;;EAqK5D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,EAAE,CAgBhE"}

package/dist/protocols/responses.js

@@ -0,0 +1,189 @@
+import { append, count, list, object } from "./values.js";
+/** Reconstruct only emitted Responses content; a completed item is not a completed call. */
+export function assembleResponsesStream(events) {
+    const response = {};
+    const items = new Map();
+    let terminal = false;
+    let terminalUsage = false;
+    let terminalSnapshot = false;
+    let recognized = false;
+    let invalid = false;
+    let unsupported = false;
+    for (const event of events) {
+        const type = String(event.type);
+        if ([
+            "response.created",
+            "response.queued",
+            "response.in_progress",
+            "response.completed",
+            "response.failed",
+            "response.incomplete",
+        ].includes(type)) {
+            recognized = true;
+            const snapshot = object(event.response);
+            if (snapshot.object !== "response" || typeof snapshot.id !== "string") {
+                invalid = true;
+                continue;
+            }
+            if (["response.completed", "response.failed", "response.incomplete"].includes(type)) {
+                if (snapshot.status !== type.slice("response.".length) || !Array.isArray(snapshot.output)) {
+                    invalid = true;
+                    continue;
+                }
+                terminal = true;
+                terminalSnapshot = true;
+                terminalUsage = snapshot.usage !== undefined && snapshot.usage !== null;
+            }
+            Object.assign(response, snapshot);
+            continue;
+        }
+        if (type === "error") {
+            recognized = true;
+            terminal = true;
+            response.status = "failed";
+            response.error = event.error ?? {
+                type: event.type,
+                code: event.code,
+                message: event.message,
+            };
+            terminalUsage = false;
+            continue;
+        }
+        if (type === "response.output_item.added" || type === "response.output_item.done") {
+            recognized = true;
+            const index = count(event.output_index);
+            const item = object(event.item);
+            if (index === undefined || typeof item.type !== "string")
+                invalid = true;
+            else
+                items.set(index, item);
+            continue;
+        }
+        if ([
+            "response.content_part.added",
+            "response.content_part.done",
+            "response.output_text.delta",
+            "response.output_text.done",
+            "response.output_text.annotation.added",
+            "response.refusal.delta",
+            "response.refusal.done",
+            "response.function_call_arguments.delta",
+            "response.function_call_arguments.done",
+            "response.reasoning_summary_part.added",
+            "response.reasoning_summary_part.done",
+            "response.reasoning_summary_text.delta",
+            "response.reasoning_summary_text.done",
+        ].includes(type)) {
+            recognized = true;
+            const index = count(event.output_index);
+            const item = index === undefined ? undefined : items.get(index);
+            if (!item || item.id !== event.item_id) {
+                invalid = true;
+                continue;
+            }
+            if (type.startsWith("response.function_call_arguments.")) {
+                if (type.endsWith(".delta"))
+                    append(item, "arguments", event.delta);
+                else
+                    item.arguments = event.arguments;
+                continue;
+            }
+            const summary = type.startsWith("response.reasoning_summary_");
+            const partIndex = count(summary ? event.summary_index : event.content_index);
+            if (partIndex === undefined) {
+                invalid = true;
+                continue;
+            }
+            const field = summary ? "summary" : "content";
+            const parts = list(item[field]);
+            // Keep sparse provider indices in a map-like object rather than allocating a huge array.
+            if (partIndex > parts.length) {
+                invalid = true;
+                continue;
+            }
+            if (type.includes("_part."))
+                parts[partIndex] = object(event.part);
+            else {
+                const refusal = type.startsWith("response.refusal.");
+                const part = object(parts[partIndex]);
+                part.type ??= summary ? "summary_text" : refusal ? "refusal" : "output_text";
+                const key = refusal ? "refusal" : "text";
+                if (type === "response.output_text.annotation.added") {
+                    const annotations = list(part.annotations);
+                    const annotationIndex = count(event.annotation_index);
+                    if (annotationIndex === undefined || annotationIndex > annotations.length) {
+                        invalid = true;
+                        continue;
+                    }
+                    annotations[annotationIndex] = event.annotation;
+                    part.annotations = annotations;
+                }
+                else if (type.endsWith(".delta"))
+                    append(part, key, event.delta);
+                else
+                    part[key] = event[key];
+                parts[partIndex] = part;
+            }
+            item[field] = parts;
+            continue;
+        }
+        if ([
+            "response.web_search_call.in_progress",
+            "response.web_search_call.searching",
+            "response.web_search_call.completed",
+            "response.file_search_call.in_progress",
+            "response.file_search_call.searching",
+            "response.file_search_call.completed",
+            "response.code_interpreter_call.in_progress",
+            "response.code_interpreter_call.interpreting",
+            "response.code_interpreter_call.completed",
+            "response.image_generation_call.in_progress",
+            "response.image_generation_call.generating",
+            "response.image_generation_call.completed",
+            "response.mcp_call.in_progress",
+            "response.mcp_call.completed",
+            "response.mcp_call.failed",
+            "response.mcp_list_tools.in_progress",
+            "response.mcp_list_tools.completed",
+            "response.mcp_list_tools.failed",
+        ].includes(type)) {
+            // Tool lifecycle frames carry no content or call usage. Keep them in the raw
+            // transcript; only a response terminal event can establish final usage.
+            recognized = true;
+            continue;
+        }
+        // Retained in the raw transcript. Do not pretend an unknown protocol frame was decoded.
+        unsupported = true;
+    }
+    const emitted = [...items.entries()].toSorted(([a], [b]) => a - b).map(([, item]) => item);
+    if (!terminalSnapshot || !Array.isArray(response.output))
+        response.output = emitted;
+    else if (response.status === "failed" || response.status === "incomplete") {
+        const snapshotIds = new Set(response.output.map((item) => object(item).id));
+        // Failed terminal snapshots may omit unfinished items. Preserve emitted
+        // evidence while preferring terminal entries with the same exact item ID.
+        response.output = [
+            ...response.output,
+            ...emitted.filter((item) => typeof item.id !== "string" || !snapshotIds.has(item.id)),
+        ];
+    }
+    return { response, terminal, terminalUsage, recognized, invalid, unsupported };
+}
+export function responsesMessages(output) {
+    return list(output).map((raw) => {
+        const item = object(raw);
+        if (item.type === "function_call")
+            return {
+                role: "assistant",
+                tool_calls: [
+                    {
+                        id: item.call_id,
+                        type: "function",
+                        function: { name: item.name, arguments: item.arguments },
+                    },
+                ],
+            };
+        return { ...item, role: item.role ?? "assistant" };
+    });
+}
+//# sourceMappingURL=responses.js.map

package/dist/protocols/responses.js.map

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

package/dist/protocols/types.d.ts

@@ -0,0 +1,27 @@
+/** Native CLIProxy application-log projection. Upstream attempts are never usage sources. */
+export type ProjectionState = "absent" | "invalid" | "unsupported" | "truncated" | "decoded";
+export type RecordValue = Record<string, unknown>;
+export type CliproxyProjection = {
+    version: 1;
+    protocol: "chat_completions" | "anthropic_messages" | "responses" | "unknown";
+    requestState: ProjectionState;
+    responseState: ProjectionState;
+    input?: RecordValue;
+    output?: RecordValue;
+    scalars: {
+        requestModel?: string;
+        responseModel?: string;
+        generationId?: string;
+        streamed?: boolean;
+        startTimeUnixNano?: string;
+        finishReason?: string;
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+        reasoningTokens?: number;
+        cachedInputTokens?: number;
+        statusJson?: string;
+    };
+    metadata: RecordValue;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/protocols/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocols/types.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAC7F,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,WAAW,GAAG,SAAS,CAAC;IAC9E,YAAY,EAAE,eAAe,CAAC;IAC9B,aAAa,EAAE,eAAe,CAAC;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE;QACP,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE,WAAW,CAAC;CACvB,CAAC"}

package/dist/protocols/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/protocols/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocols/types.ts"],"names":[],"mappings":""}

package/dist/protocols/usage.d.ts

@@ -0,0 +1,3 @@
+import type { CliproxyProjection, RecordValue } from "./types.js";
+export declare function extractUsage(projection: CliproxyProjection, raw: RecordValue): void;
+//# sourceMappingURL=usage.d.ts.map

package/dist/protocols/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/protocols/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElE,wBAAgB,YAAY,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,EAAE,WAAW,QAiC5E"}

package/dist/protocols/usage.js

@@ -0,0 +1,27 @@
+import { count, object } from "./values.js";
+export function extractUsage(projection, raw) {
+    // Anthropic reports disjoint uncached/cache creation/cache read input counts.
+    // Never manufacture totals, costs, or token counts from byte/text lengths.
+    projection.metadata.usage = raw;
+    const anthropic = projection.protocol === "anthropic_messages";
+    const responses = projection.protocol === "responses";
+    const nativeInput = count(raw.input_tokens);
+    const cacheRead = count(raw.cache_read_input_tokens);
+    const cacheCreated = count(raw.cache_creation_input_tokens);
+    const anthropicInput = nativeInput !== undefined && cacheRead !== undefined && cacheCreated !== undefined
+        ? count(nativeInput + cacheRead + cacheCreated)
+        : undefined;
+    Object.assign(projection.scalars, {
+        inputTokens: anthropic ? anthropicInput : responses ? nativeInput : count(raw.prompt_tokens),
+        outputTokens: count(raw[anthropic || responses ? "output_tokens" : "completion_tokens"]),
+        totalTokens: count(raw.total_tokens),
+        cachedInputTokens: count(anthropic
+            ? raw.cache_read_input_tokens
+            : object(raw[responses ? "input_tokens_details" : "prompt_tokens_details"]).cached_tokens),
+        reasoningTokens: count(object(raw[anthropic || responses ? "output_tokens_details" : "completion_tokens_details"])[anthropic ? "thinking_tokens" : "reasoning_tokens"]),
+    });
+    projection.metadata.tokenSemantics = anthropic
+        ? "input_is_sum_of_reported_input_cache_creation_cache_read; cached_input_is_cache_read; missing_components_mean_unknown; no_synthesized_total"
+        : "input_includes_reported_cached_input; terminal_usage_snapshot";
+}
+//# sourceMappingURL=usage.js.map

package/dist/protocols/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/protocols/usage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC5C,MAAM,UAAU,YAAY,CAAC,UAA8B,EAAE,GAAgB;IAC3E,8EAA8E;IAC9E,2EAA2E;IAC3E,UAAU,CAAC,QAAQ,CAAC,KAAK,GAAG,GAAG,CAAC;IAChC,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,KAAK,oBAAoB,CAAC;IAE/D,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,KAAK,WAAW,CAAC;IAEtD,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAC5D,MAAM,cAAc,GAClB,WAAW,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS;QAChF,CAAC,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;QAC/C,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE;QAChC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;QAC5F,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QACxF,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;QACpC,iBAAiB,EAAE,KAAK,CACtB,SAAS;YACP,CAAC,CAAC,GAAG,CAAC,uBAAuB;YAC7B,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,aAAa,CAC5F;QACD,eAAe,EAAE,KAAK,CACpB,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CACzF,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,kBAAkB,CACnD,CACF;KACF,CAAC,CAAC;IACH,UAAU,CAAC,QAAQ,CAAC,cAAc,GAAG,SAAS;QAC5C,CAAC,CAAC,6IAA6I;QAC/I,CAAC,CAAC,+DAA+D,CAAC;AACtE,CAAC"}

package/dist/protocols/values.d.ts

@@ -0,0 +1,10 @@
+import type { RecordValue } from "./types.js";
+export declare const object: (value: unknown) => RecordValue;
+export declare const list: (value: unknown) => unknown[];
+export declare const string: (value: unknown) => string | undefined;
+export declare const identity: (value: unknown) => string | undefined;
+export declare const count: (value: unknown) => number | undefined;
+export declare function nanoTime(value: string | undefined): string | undefined;
+export declare function parseObject(raw: string): RecordValue;
+export declare function append(target: RecordValue, key: string, value: unknown): void;
+//# sourceMappingURL=values.d.ts.map

package/dist/protocols/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/protocols/values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,KAAG,WAGhC,CAAC;AACT,eAAO,MAAM,IAAI,GAAI,OAAO,OAAO,KAAG,OAAO,EAAyC,CAAC;AACvF,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SACF,CAAC;AAChD,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,uBAGtC,CAAC;AACF,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO,uBACwD,CAAC;AAC7F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,sBAUjD;AACD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAKpD;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,QAEtE"}

package/dist/protocols/values.js

@@ -0,0 +1,32 @@
+export const object = (value) => value !== null && typeof value === "object" && !Array.isArray(value)
+    ? value
+    : {};
+export const list = (value) => (Array.isArray(value) ? value : []);
+export const string = (value) => typeof value === "string" ? value : undefined;
+export const identity = (value) => {
+    const text = string(value);
+    return text && text.length <= 256 ? text : undefined;
+};
+export const count = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+export function nanoTime(value) {
+    if (!value)
+        return;
+    const match = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2})(?:\.(\d{1,9}))?(Z|[+-]\d{2}:\d{2})$/.exec(value);
+    if (!match)
+        return;
+    const seconds = Date.parse(`${match[1]}${match[3]}`);
+    return Number.isFinite(seconds)
+        ? String(BigInt(seconds) * 1000000n + BigInt((match[2] ?? "").padEnd(9, "0")))
+        : undefined;
+}
+export function parseObject(raw) {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        throw new Error("Object required");
+    return parsed;
+}
+export function append(target, key, value) {
+    if (typeof value === "string")
+        target[key] = (string(target[key]) ?? "") + value;
+}
+//# sourceMappingURL=values.js.map

package/dist/protocols/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/protocols/values.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAe,EAAE,CACpD,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;IAClE,CAAC,CAAE,KAAqB;IACxB,CAAC,CAAC,EAAE,CAAC;AACT,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAc,EAAa,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACvF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAsB,EAAE,CAC3D,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAE,EAAE;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,OAAO,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC,CAAC;AACF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,EAAE,CACtC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7F,MAAM,UAAU,QAAQ,CAAC,KAAyB;IAChD,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,KAAK,GAAG,4EAA4E,CAAC,IAAI,CAC7F,KAAK,CACN,CAAC;IACF,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC7B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,QAAU,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AACD,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,OAAO,MAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,MAAmB,EAAE,GAAW,EAAE,KAAc;IACrE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC;AACnF,CAAC"}