reactor-effect-client 0.0.0-reserved.0 → 0.2.0

package/dist/h3/_internal/contracts.d.ts

@@ -0,0 +1,123 @@
+import * as Schema from "effect/Schema";
+import type { MessageType } from "../messages.js";
+/**
+ * One command-to-reply authority for deployment admission and client calls.
+ * Required keys describe what this adapter always supplies, not what a server
+ * must require. Nullable parameters describe the documented deployment shape;
+ * the adapter's outgoing arguments omit null and retain its existing validators.
+ */
+export declare const Commands: {
+    readonly enqueue: {
+        readonly args: Schema.Struct<{
+            readonly prompt: Schema.String;
+            readonly reference_images: Schema.NullOr<Schema.$Array<Schema.Struct<{
+                readonly upload_id: Schema.String;
+                readonly name: Schema.String;
+                readonly mime_type: Schema.String;
+                readonly size: Schema.Int;
+            }>>>;
+            readonly seconds: Schema.optionalKey<Schema.NullOr<Schema.Number>>;
+            readonly seed: Schema.optionalKey<Schema.NullOr<Schema.Int>>;
+            readonly position: Schema.optionalKey<Schema.NullOr<Schema.Int>>;
+            readonly metadata: Schema.String;
+            readonly continue_from_clip_id: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly reply: "clip_queued";
+    };
+    readonly move: {
+        readonly args: Schema.Struct<{
+            readonly clip_id: Schema.String;
+            readonly position: Schema.Int;
+        }>;
+        readonly reply: "clip_moved";
+    };
+    readonly pop: {
+        readonly args: Schema.Struct<{
+            readonly clip_id: Schema.String;
+        }>;
+        readonly reply: "clip_popped";
+    };
+    readonly play: {
+        readonly args: Schema.Struct<{
+            readonly clip_id: Schema.String;
+        }>;
+        readonly reply: null;
+    };
+    readonly stop: {
+        readonly args: Schema.$Record<Schema.String, Schema.Never>;
+        readonly reply: null;
+    };
+    readonly set_seed: {
+        readonly args: Schema.Struct<{
+            readonly seed: Schema.Int;
+        }>;
+        readonly reply: "seed_accepted";
+    };
+    readonly set_clip_seconds: {
+        readonly args: Schema.Struct<{
+            readonly seconds: Schema.Number;
+        }>;
+        readonly reply: "clip_length_accepted";
+    };
+    readonly set_canvas: {
+        readonly args: Schema.Struct<{
+            readonly aspect: Schema.String;
+        }>;
+        readonly reply: "canvas_accepted";
+    };
+    readonly set_autoplay: {
+        readonly args: Schema.Struct<{
+            readonly enabled: Schema.Boolean;
+        }>;
+        readonly reply: "autoplay_accepted";
+    };
+    readonly set_flush_on_clip_end: {
+        readonly args: Schema.Struct<{
+            readonly enabled: Schema.Boolean;
+        }>;
+        readonly reply: "flush_accepted";
+    };
+    readonly get_queue: {
+        readonly args: Schema.$Record<Schema.String, Schema.Never>;
+        readonly reply: "queue_update";
+    };
+    readonly get_state: {
+        readonly args: Schema.$Record<Schema.String, Schema.Never>;
+        readonly reply: "state_update";
+    };
+    readonly reset: {
+        readonly args: Schema.$Record<Schema.String, Schema.Never>;
+        readonly reply: "session_reset";
+    };
+};
+export type CommandName = keyof typeof Commands;
+export type CommandArgs<K extends CommandName> = {
+    readonly [F in keyof (typeof Commands)[K]["args"]["Type"]]: Exclude<(typeof Commands)[K]["args"]["Type"][F], null>;
+};
+export type ReplyCommand = {
+    [K in CommandName]: (typeof Commands)[K]["reply"] extends MessageType ? K : never;
+}[CommandName];
+export type ReplyType<K extends ReplyCommand> = (typeof Commands)[K]["reply"];
+export type ControlCommand = Exclude<CommandName, ReplyCommand>;
+/** Only the structural subset already required by H3 deployment admission. */
+export interface Shape {
+    readonly type: "string" | "number" | "integer" | "boolean" | "object" | "array";
+    readonly nullable?: boolean;
+    readonly fields?: Readonly<Record<string, Shape>>;
+    readonly required?: readonly string[];
+    readonly items?: Shape;
+}
+export declare const messageShapes: Readonly<Record<MessageType, Shape>>;
+export declare const deploymentCommands: {
+    name: string;
+    args: {
+        type: "string" | "number" | "integer" | "boolean" | "object" | "array";
+        nullable?: boolean;
+        fields?: Readonly<Record<string, Shape>>;
+        items?: Shape;
+        required: never[];
+    };
+    supplied: readonly string[];
+    reply: "autoplay_accepted" | "canvas_accepted" | "clip_length_accepted" | "clip_moved" | "clip_popped" | "clip_queued" | "flush_accepted" | "queue_update" | "seed_accepted" | "session_reset" | "state_update" | null;
+}[];
+//# sourceMappingURL=contracts.d.ts.map

package/dist/h3/_internal/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/h3/_internal/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAWlD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;iBAEjB,IAAI;;;;;;;;;;;;;;iBASJ,KAAK,EAAE,aAAa;;;iBAGpB,IAAI;;;;iBACJ,KAAK,EAAE,YAAY;;;iBAEd,IAAI;;;iBAA6C,KAAK,EAAE,aAAa;;;iBACpE,IAAI;;;iBAA6C,KAAK;;;iBACtD,IAAI;iBAAe,KAAK;;;iBACpB,IAAI;;;iBAAuC,KAAK,EAAE,eAAe;;;iBAE3E,IAAI;;;iBACJ,KAAK,EAAE,sBAAsB;;;iBAEjB,IAAI;;;iBAA4C,KAAK,EAAE,iBAAiB;;;iBACtE,IAAI;;;iBAA8C,KAAK,EAAE,mBAAmB;;;iBAE1F,IAAI;;;iBACJ,KAAK,EAAE,gBAAgB;;;iBAEZ,IAAI;iBAAe,KAAK,EAAE,cAAc;;;iBACxC,IAAI;iBAAe,KAAK,EAAE,cAAc;;;iBAC5C,IAAI;iBAAe,KAAK,EAAE,eAAe;;CAGnD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,QAAQ,CAAC;AAChD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,WAAW,IAAI;IAC/C,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CACjE,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EACvC,IAAI,CACL;CACF,CAAC;AACF,MAAM,MAAM,YAAY,GAAG;KACxB,CAAC,IAAI,WAAW,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,WAAW,GAAG,CAAC,GAAG,KAAK;CAClF,CAAC,WAAW,CAAC,CAAC;AACf,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC9E,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AAEhE,8EAA8E;AAC9E,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAuDD,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAEtB,CAAC;AAE1C,eAAO,MAAM,kBAAkB;;;cAhEd,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO;mBAC3D,OAAO;iBACT,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBAEhC,KAAK;;;;;GAoEtB,CAAC"}

package/dist/h3/_internal/contracts.js

@@ -0,0 +1,113 @@
+import * as Schema from "effect/Schema";
+import { isRecord } from "../../json.js";
+import { Payloads } from "../messages.js";
+const NumberArgument = Schema.Number.check(Schema.isFinite());
+const NoArguments = Schema.Record(Schema.String, Schema.Never);
+const Upload = Schema.Struct({
+    upload_id: Schema.String,
+    name: Schema.String,
+    mime_type: Schema.String,
+    size: Schema.Int,
+});
+/**
+ * One command-to-reply authority for deployment admission and client calls.
+ * Required keys describe what this adapter always supplies, not what a server
+ * must require. Nullable parameters describe the documented deployment shape;
+ * the adapter's outgoing arguments omit null and retain its existing validators.
+ */
+export const Commands = {
+    enqueue: {
+        args: Schema.Struct({
+            prompt: Schema.String,
+            reference_images: Schema.NullOr(Schema.Array(Upload)),
+            seconds: Schema.optionalKey(Schema.NullOr(NumberArgument)),
+            seed: Schema.optionalKey(Schema.NullOr(Schema.Int)),
+            position: Schema.optionalKey(Schema.NullOr(Schema.Int)),
+            metadata: Schema.String,
+            continue_from_clip_id: Schema.optionalKey(Schema.String),
+        }),
+        reply: "clip_queued",
+    },
+    move: {
+        args: Schema.Struct({ clip_id: Schema.String, position: Schema.Int }),
+        reply: "clip_moved",
+    },
+    pop: { args: Schema.Struct({ clip_id: Schema.String }), reply: "clip_popped" },
+    play: { args: Schema.Struct({ clip_id: Schema.String }), reply: null },
+    stop: { args: NoArguments, reply: null },
+    set_seed: { args: Schema.Struct({ seed: Schema.Int }), reply: "seed_accepted" },
+    set_clip_seconds: {
+        args: Schema.Struct({ seconds: NumberArgument }),
+        reply: "clip_length_accepted",
+    },
+    set_canvas: { args: Schema.Struct({ aspect: Schema.String }), reply: "canvas_accepted" },
+    set_autoplay: { args: Schema.Struct({ enabled: Schema.Boolean }), reply: "autoplay_accepted" },
+    set_flush_on_clip_end: {
+        args: Schema.Struct({ enabled: Schema.Boolean }),
+        reply: "flush_accepted",
+    },
+    get_queue: { args: NoArguments, reply: "queue_update" },
+    get_state: { args: NoArguments, reply: "state_update" },
+    reset: { args: NoArguments, reply: "session_reset" },
+};
+const internalShapeError = () => {
+    throw new Error("H3 contract schemas must have concrete inline JSON shapes");
+};
+const schemaObject = (value) => isRecord(value) ? value : internalShapeError();
+/**
+ * Project the pinned Effect schema's JSON representation once. This is not a
+ * second payload decoder: numeric/string refinements still belong exclusively
+ * to messages.ts. Optional observations do not become deployment requirements.
+ */
+const structuralShape = (schema, includeOptional = false) => {
+    const document = Schema.toJsonSchemaDocument(schema);
+    if (Object.keys(document.definitions).length !== 0)
+        return internalShapeError();
+    const visit = (input, allFields = false) => {
+        let node = schemaObject(input);
+        let nullable = false;
+        if (Array.isArray(node.anyOf)) {
+            const nonNull = node.anyOf.filter((choice) => schemaObject(choice).type !== "null");
+            if (nonNull.length !== 1 || nonNull.length === node.anyOf.length)
+                return internalShapeError();
+            nullable = true;
+            node = schemaObject(nonNull[0]);
+        }
+        const type = node.type;
+        if (type !== "string" &&
+            type !== "number" &&
+            type !== "integer" &&
+            type !== "boolean" &&
+            type !== "object" &&
+            type !== "array")
+            return internalShapeError();
+        const base = { type, ...(nullable ? { nullable } : {}) };
+        if (type === "array")
+            return { ...base, items: visit(node.items) };
+        if (type !== "object")
+            return base;
+        const properties = schemaObject(node.properties ?? {});
+        const required = node.required ?? [];
+        if (!Array.isArray(required) || required.some((key) => typeof key !== "string"))
+            return internalShapeError();
+        return {
+            ...base,
+            required,
+            fields: Object.fromEntries(Object.entries(properties)
+                .filter(([name]) => allFields || required.includes(name))
+                .map(([name, field]) => [name, visit(field)])),
+        };
+    };
+    return visit(document.schema, includeOptional);
+};
+export const messageShapes = Object.fromEntries(Object.entries(Payloads).map(([name, schema]) => [name, structuralShape(schema)]));
+export const deploymentCommands = Object.entries(Commands).map(([name, command]) => {
+    const shape = structuralShape(command.args, true);
+    return {
+        name,
+        args: { ...shape, required: [] },
+        supplied: shape.required ?? [],
+        reply: command.reply,
+    };
+});
+//# sourceMappingURL=contracts.js.map

package/dist/h3/_internal/contracts.js.map

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

package/dist/h3/_internal/deployment.d.ts

@@ -0,0 +1,8 @@
+import type { Contract } from "../types.js";
+/**
+ * Matches the pinned reactor-runtime ModelSchema.to_openapi representation:
+ * https://github.com/reactor-team/reactor-runtime/blob/8e98536c6daedca298700dc45cbb5fd9e3676f16/src/reactor_runtime/interface/model/schema.py
+ * No network references are followed, and prose/name mentions cannot establish compatibility.
+ */
+export declare const validateDeployment: (input: unknown) => Contract;
+//# sourceMappingURL=deployment.d.ts.map

package/dist/h3/_internal/deployment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../../src/h3/_internal/deployment.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAc5C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,UAAW,OAAO,KAAG,QA0HnD,CAAC"}

package/dist/h3/_internal/deployment.js

@@ -0,0 +1,132 @@
+import { ReactorError } from "../../errors.js";
+import { isRecord, jsonObject } from "../../json.js";
+import { documentedVersion, modelName, referenceLimits, source } from "../profile.js";
+import { deploymentCommands, messageShapes } from "./contracts.js";
+const incompatible = (location) => {
+    throw new ReactorError("UnsupportedCapability", `Deployment does not structurally support H3 ${documentedVersion}: ${location}`, { operation: "H3 schema", outcome: "not-submitted" });
+};
+const record = (input, path) => isRecord(input) ? input : incompatible(path);
+/**
+ * Matches the pinned reactor-runtime ModelSchema.to_openapi representation:
+ * https://github.com/reactor-team/reactor-runtime/blob/8e98536c6daedca298700dc45cbb5fd9e3676f16/src/reactor_runtime/interface/model/schema.py
+ * No network references are followed, and prose/name mentions cannot establish compatibility.
+ */
+export const validateDeployment = (input) => {
+    const doc = jsonObject(input);
+    if (typeof doc.openapi !== "string" || !/^3\.(0|1)\./.test(doc.openapi))
+        return incompatible("OpenAPI version");
+    let checks = 0;
+    const resolve = (input, location) => {
+        let value = record(input, location);
+        const seen = new Set();
+        while (typeof value.$ref === "string") {
+            const ref = value.$ref;
+            if (!ref.startsWith("#/components/schemas/") || seen.has(ref) || seen.size >= 32)
+                return incompatible(`${location} reference`);
+            seen.add(ref);
+            let current = doc;
+            for (const part of ref.slice(2).split("/"))
+                current = record(current, location)[part.replace(/~1/g, "/").replace(/~0/g, "~")];
+            value = record(current, location);
+        }
+        return value;
+    };
+    const check = (input, expected, location, depth = 0) => {
+        if (++checks > 10000 || depth > 32)
+            return incompatible("schema complexity bound");
+        let actual = resolve(input, location);
+        const choices = actual.anyOf ?? actual.oneOf;
+        let nullable = actual.nullable === true;
+        if (Array.isArray(choices)) {
+            const nonNull = choices.filter((choice) => resolve(choice, location).type !== "null");
+            nullable = nonNull.length !== choices.length;
+            if (nonNull.length !== 1)
+                return incompatible(`${location} union`);
+            actual = resolve(nonNull[0], location);
+        }
+        const types = Array.isArray(actual.type) ? actual.type : [actual.type];
+        nullable ||= types.includes("null");
+        const nonNullTypes = types.filter((type) => type !== "null");
+        if (nonNullTypes.length !== 1 ||
+            !(nonNullTypes[0] === expected.type ||
+                (location.startsWith("message ") &&
+                    expected.type === "number" &&
+                    nonNullTypes[0] === "integer")))
+            return incompatible(`${location} type`);
+        // Nullable outputs must declare the null alternative; nullable request
+        // parameters may also be a narrower non-null type because this client omits null.
+        if (location.startsWith("message ") && expected.nullable === true && !nullable)
+            return incompatible(`${location} nullability`);
+        if (expected.nullable !== true && nullable)
+            return incompatible(`${location} nullability`);
+        if (expected.type === "array") {
+            if (location === "command enqueue.reference_images" &&
+                ((typeof actual.minItems === "number" && actual.minItems > 0) ||
+                    (typeof actual.maxItems === "number" && actual.maxItems < referenceLimits.maxImages)))
+                return incompatible("command enqueue.reference_images count bounds");
+            if (expected.items !== undefined)
+                check(actual.items, expected.items, `${location} items`, depth + 1);
+        }
+        else if (expected.type === "object") {
+            const properties = actual.properties === undefined ? {} : record(actual.properties, `${location} properties`);
+            const required = actual.required ?? [];
+            if (!Array.isArray(required) || required.some((key) => typeof key !== "string"))
+                return incompatible(`${location} required fields`);
+            for (const name of expected.required ?? [])
+                if (!required.includes(name))
+                    return incompatible(`${location}.${name} required`);
+            for (const [name, shape] of Object.entries(expected.fields ?? {}))
+                check(properties[name], shape, `${location}.${name}`, depth + 1);
+        }
+    };
+    const bodySchema = (input, location) => {
+        const body = record(input, location), content = record(body.content, location);
+        return record(content["application/json"], location).schema;
+    };
+    const paths = record(doc.paths, "command paths"), webhooks = record(doc.webhooks, "message webhooks");
+    const messageSchemas = new Map();
+    for (const [name, shape] of Object.entries(messageShapes)) {
+        const post = record(record(webhooks[name], `message ${name}`).post, `message ${name}`);
+        if (post.operationId !== name)
+            return incompatible(`message ${name} operationId`);
+        const schema = bodySchema(post.requestBody, `message ${name}`);
+        check(schema, shape, `message ${name}`);
+        messageSchemas.set(name, schema);
+    }
+    for (const command of deploymentCommands) {
+        const { name } = command;
+        const post = record(record(paths[`/events/${name}`], `command ${name}`).post, `command ${name}`);
+        if (post.operationId !== name)
+            return incompatible(`command ${name} operationId`);
+        const args = bodySchema(post.requestBody, `command ${name}`);
+        check(args, command.args, `command ${name}`);
+        const required = resolve(args, `command ${name}`).required ?? [];
+        if (!Array.isArray(required) || required.some((key) => !command.supplied.includes(String(key))))
+            return incompatible(`command ${name} unsupported required argument`);
+        const responses = record(post.responses, `command ${name} responses`);
+        if (command.reply === null) {
+            const accepted = record(responses["202"], `command ${name} acceptance`);
+            if (accepted.content !== undefined)
+                return incompatible(`command ${name} bodyless acceptance`);
+        }
+        else {
+            const schema = bodySchema(responses["200"], `command ${name} response`);
+            check(schema, messageShapes[command.reply], `message ${command.reply}`);
+            const expected = record(messageSchemas.get(command.reply), `message ${command.reply}`), response = record(schema, `command ${name}`);
+            if (typeof expected.$ref === "string" && response.$ref !== expected.$ref)
+                return incompatible(`command ${name} response identity`);
+        }
+    }
+    const info = isRecord(doc.info) ? doc.info : {};
+    return Object.freeze({
+        modelName,
+        documentedVersion,
+        source,
+        subset: "prompt-and-images",
+        deployment: Object.freeze({
+            title: typeof info.title === "string" ? info.title : null,
+            version: typeof info.version === "string" ? info.version : null,
+        }),
+    });
+};
+//# sourceMappingURL=deployment.js.map

package/dist/h3/_internal/deployment.js.map

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

package/dist/h3/_internal/evidence.d.ts

@@ -0,0 +1,17 @@
+import type { CommandReply } from "../../session/index.js";
+import type { Clip } from "../messages.js";
+import type { Acceptance } from "../types.js";
+/** Captured once for a submission; pending registration and retirement belong to the client. */
+export interface AcceptanceIdentity {
+    readonly id: string;
+    readonly metadata: string;
+    readonly prompt: string;
+    readonly generation: bigint;
+}
+/** Namespaced acceptance metadata is not a claim about the provider's own state. */
+export declare const encodeMetadata: (namespace: string, submission: string, caller?: string) => string;
+/** Foreign, malformed and extended annotations cannot identify a local pending submission. */
+export declare const submissionFromMetadata: (namespace: string, value: string) => string | undefined;
+/** Only exact captured data in its generation proves acceptance; an ACK has no clip to supply. */
+export declare const acceptanceFor: (identity: AcceptanceIdentity, clip: Clip, source: CommandReply) => Acceptance | undefined;
+//# sourceMappingURL=evidence.d.ts.map

package/dist/h3/_internal/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../../src/h3/_internal/evidence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,gGAAgG;AAChG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,oFAAoF;AACpF,eAAO,MAAM,cAAc,cAAe,MAAM,cAAc,MAAM,sBAAgB,MASnF,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,cAAe,MAAM,SAAS,MAAM,KAAG,MAAM,GAAG,SAgBlF,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,aAAa,aACd,kBAAkB,QACtB,IAAI,UACF,YAAY,KACnB,UAAU,GAAG,SAoBf,CAAC"}

package/dist/h3/_internal/evidence.js

@@ -0,0 +1,48 @@
+import { ReactorError } from "../../errors.js";
+import { metadataMaxChars } from "../profile.js";
+import { Commands } from "./contracts.js";
+import { plain } from "./references.js";
+/** Namespaced acceptance metadata is not a claim about the provider's own state. */
+export const encodeMetadata = (namespace, submission, caller = "") => {
+    const value = JSON.stringify({ reactor_effect_h3: 1, namespace, submission, caller });
+    if (Array.from(value).length > metadataMaxChars)
+        throw new ReactorError("InvalidInput", `Metadata including acceptance identity exceeds ${metadataMaxChars} characters`, { operation: "enqueue", outcome: "not-submitted" });
+    return value;
+};
+/** Foreign, malformed and extended annotations cannot identify a local pending submission. */
+export const submissionFromMetadata = (namespace, value) => {
+    try {
+        const object = JSON.parse(value);
+        const fields = plain(object, ["reactor_effect_h3", "namespace", "submission", "caller"]);
+        if (fields.reactor_effect_h3 !== 1 ||
+            typeof fields.namespace !== "string" ||
+            fields.namespace !== namespace ||
+            typeof fields.submission !== "string" ||
+            typeof fields.caller !== "string")
+            return undefined;
+        return fields.submission;
+    }
+    catch {
+        return undefined;
+    }
+};
+/** Only exact captured data in its generation proves acceptance; an ACK has no clip to supply. */
+export const acceptanceFor = (identity, clip, source) => {
+    if (identity.generation !== source.generation ||
+        identity.metadata !== clip.metadata ||
+        identity.prompt !== clip.prompt)
+        return undefined;
+    return Object.freeze({
+        submissionId: identity.id,
+        clip,
+        evidence: Object.freeze({
+            kind: source.kind === "message" &&
+                source.type === Commands.enqueue.reply &&
+                source.correlation === "matched"
+                ? "correlated"
+                : "metadata",
+            source,
+        }),
+    });
+};
+//# sourceMappingURL=evidence.js.map

package/dist/h3/_internal/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../../src/h3/_internal/evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAUxC,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAiB,EAAE,UAAkB,EAAE,MAAM,GAAG,EAAE,EAAU,EAAE;IAC3F,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IACtF,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,gBAAgB;QAC7C,MAAM,IAAI,YAAY,CACpB,cAAc,EACd,kDAAkD,gBAAgB,aAAa,EAC/E,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,CACnD,CAAC;IACJ,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,8FAA8F;AAC9F,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,SAAiB,EAAE,KAAa,EAAsB,EAAE;IAC7F,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,mBAAmB,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;QACzF,IACE,MAAM,CAAC,iBAAiB,KAAK,CAAC;YAC9B,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YACpC,MAAM,CAAC,SAAS,KAAK,SAAS;YAC9B,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;YACrC,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;YAEjC,OAAO,SAAS,CAAC;QACnB,OAAO,MAAM,CAAC,UAAU,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF,kGAAkG;AAClG,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,QAA4B,EAC5B,IAAU,EACV,MAAoB,EACI,EAAE;IAC1B,IACE,QAAQ,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU;QACzC,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;QACnC,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAE/B,OAAO,SAAS,CAAC;IACnB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,YAAY,EAAE,QAAQ,CAAC,EAAE;QACzB,IAAI;QACJ,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,IAAI,EACF,MAAM,CAAC,IAAI,KAAK,SAAS;gBACzB,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,CAAC,KAAK;gBACtC,MAAM,CAAC,WAAW,KAAK,SAAS;gBAC9B,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,UAAU;YAChB,MAAM;SACP,CAAC;KACH,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/h3/_internal/references.d.ts

@@ -0,0 +1,18 @@
+import * as Effect from "effect/Effect";
+import { ReactorError } from "../../errors.js";
+import type { UploadReference } from "../../wire.generated.js";
+import type { Reference, ValidatedReference } from "../types.js";
+export type Material = {
+    readonly _tag: "Bytes";
+    readonly bytes: Uint8Array<ArrayBuffer>;
+} | {
+    readonly _tag: "Uploaded";
+    readonly file: UploadReference;
+};
+export declare const plain: (input: unknown, allowed: readonly string[]) => Record<string, unknown>;
+/** Validates wire identity and a safe JSON size projection without inventing upload provenance. */
+export declare const checkedUpload: (input: unknown) => UploadReference;
+export declare const captureReference: (input: Reference | ValidatedReference) => ValidatedReference;
+export declare const referenceMaterial: (reference: ValidatedReference) => Material;
+export declare const validateReference: (input: Reference) => Effect.Effect<ValidatedReference, ReactorError>;
+//# sourceMappingURL=references.d.ts.map

package/dist/h3/_internal/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../src/h3/_internal/references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAOjE,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AA+GlE,eAAO,MAAM,KAAK,UAAW,OAAO,WAAW,SAAS,MAAM,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAgBxF,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,eAqB9C,CAAC;AAEF,eAAO,MAAM,gBAAgB,UAAW,SAAS,GAAG,kBAAkB,KAAG,kBAoCxE,CAAC;AAEF,eAAO,MAAM,iBAAiB,cAAe,kBAAkB,KAAG,QACE,CAAC;AACrE,eAAO,MAAM,iBAAiB,UACrB,SAAS,KACf,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,YAAY,CAO7C,CAAC"}