@vibesdotdev/moderation 0.0.0-stage → 1.0.0-rc.2

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './schemas/index.ts';
+export { MODERATION_SUBJECT_KIND_ID, moderationSubjectKind } from './kinds/subject.kind.ts';
+export { MODERATION_ERROR_CODES, ModerationError, type ModerationErrorCode } from './errors.ts';
+export { decideModeration } from './decide.ts';
+export { moderateSubject, type ModerateSubjectInput, type ModerateSubjectOptions } from './moderate.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACN,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// @vibesdotdev/moderation: universal root. No node:, bun:, process or
+// browser globals; everything resolves on the runtime the caller passes.
+export * from "./schemas/index.js";
+export { MODERATION_SUBJECT_KIND_ID, moderationSubjectKind } from "./kinds/subject.kind.js";
+export { MODERATION_ERROR_CODES, ModerationError } from "./errors.js";
+export { decideModeration } from "./decide.js";
+export { moderateSubject } from "./moderate.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,yEAAyE;AAEzE,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAA4B,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACN,eAAe,EAGf,MAAM,eAAe,CAAC"}

package/dist/kinds/subject.kind.d.ts

@@ -0,0 +1,10 @@
+/** Kind id consumers pass to `runtime.query()`. */
+export declare const MODERATION_SUBJECT_KIND_ID: "moderation/subject";
+/**
+ * `moderation/subject`: a moderatable content type registered by the feature
+ * that owns the content. Descriptor-only: no default implementation and no
+ * loaders. Single-owner, so a subject id cannot be re-registered by a second
+ * origin; a host that wants different thresholds registers its own id.
+ */
+export declare const moderationSubjectKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<unknown>;
+//# sourceMappingURL=subject.kind.d.ts.map

package/dist/kinds/subject.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.kind.d.ts","sourceRoot":"","sources":["../../src/kinds/subject.kind.ts"],"names":[],"mappings":"AAMA,mDAAmD;AACnD,eAAO,MAAM,0BAA0B,EAAG,oBAA6B,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,oEAIhC,CAAC"}

package/dist/kinds/subject.kind.js

@@ -0,0 +1,16 @@
+import { createRuntimeKind } from '@vibesdotdev/kernel';
+import { ModerationSubjectDescriptorSchema } from "../schemas/subject.js";
+/** Kind id consumers pass to `runtime.query()`. */
+export const MODERATION_SUBJECT_KIND_ID = 'moderation/subject';
+/**
+ * `moderation/subject`: a moderatable content type registered by the feature
+ * that owns the content. Descriptor-only: no default implementation and no
+ * loaders. Single-owner, so a subject id cannot be re-registered by a second
+ * origin; a host that wants different thresholds registers its own id.
+ */
+export const moderationSubjectKind = createRuntimeKind({
+    id: MODERATION_SUBJECT_KIND_ID,
+    descriptorSchema: ModerationSubjectDescriptorSchema,
+    descriptorOwnership: 'single-owner'
+});
+//# sourceMappingURL=subject.kind.js.map

package/dist/kinds/subject.kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.kind.js","sourceRoot":"","sources":["../../src/kinds/subject.kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACN,iCAAiC,EAEjC,MAAM,uBAAuB,CAAC;AAE/B,mDAAmD;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAA6B,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAuC;IAC5F,EAAE,EAAE,0BAA0B;IAC9B,gBAAgB,EAAE,iCAAiC;IACnD,mBAAmB,EAAE,cAAc;CACnC,CAAC,CAAC"}

package/dist/moderate.d.ts

@@ -0,0 +1,17 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { ModerationDecision } from './schemas/decision.ts';
+import { type ModerateSubjectInput, type ModerateSubjectOptions } from './schemas/input.ts';
+export type { ModerateSubjectInput, ModerateSubjectOptions, ModerationState, ModerationStateValue, ModerationStateInput } from './schemas/input.ts';
+/**
+ * Judge one subject through the passed runtime.
+ *
+ * Order: parse the ref and snapshot JSON state; resolve the subject; resolve its battery once; check
+ * the battery contract (heads equal labels, all noul, non-empty
+ * requiredState); check the state; resolve runtime/client `ai`; evaluate with
+ * the pre-resolved questions; validate every answer; apply the threshold
+ * policy. Domain preconditions fail with a named ModerationError before any
+ * inference is spent. Evaluator errors propagate unchanged. Nothing is
+ * persisted or enqueued.
+ */
+export declare function moderateSubject(runtime: VibesRuntime, input: ModerateSubjectInput, options?: ModerateSubjectOptions): Promise<ModerationDecision>;
+//# sourceMappingURL=moderate.d.ts.map

package/dist/moderate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moderate.d.ts","sourceRoot":"","sources":["../src/moderate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAA0D,KAAK,oBAAoB,EAAE,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAIpJ,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,eAAe,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEpJ;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACpC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,oBAAoB,EAC3B,OAAO,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAuB7B"}

package/dist/moderate.js

@@ -0,0 +1,38 @@
+import { decideModeration } from "./decide.js";
+import { ModerationEnvelopeSchema, ModerateSubjectOptionsSchema } from "./schemas/input.js";
+import { snapshotState } from "./orchestration/state.js";
+import { resolveSubject, resolveBattery, assertBatteryContract, assertState, resolveEvaluator } from "./orchestration/resolve.js";
+import { readLabels } from "./orchestration/labels.js";
+/**
+ * Judge one subject through the passed runtime.
+ *
+ * Order: parse the ref and snapshot JSON state; resolve the subject; resolve its battery once; check
+ * the battery contract (heads equal labels, all noul, non-empty
+ * requiredState); check the state; resolve runtime/client `ai`; evaluate with
+ * the pre-resolved questions; validate every answer; apply the threshold
+ * policy. Domain preconditions fail with a named ModerationError before any
+ * inference is spent. Evaluator errors propagate unchanged. Nothing is
+ * persisted or enqueued.
+ */
+export async function moderateSubject(runtime, input, options) {
+    const { subject: ref, state: inputState } = ModerationEnvelopeSchema.parse(input);
+    const parsedOptions = ModerateSubjectOptionsSchema.parse(options === undefined ? {} : options);
+    const state = snapshotState(inputState);
+    const subject = await resolveSubject(runtime, ref.type);
+    const battery = await resolveBattery(runtime, subject);
+    const requiredState = assertBatteryContract(subject, battery);
+    assertState(battery.id, requiredState, state);
+    const evaluator = await resolveEvaluator(runtime);
+    const questions = {};
+    for (const [name, question] of Object.entries(battery.questions)) {
+        questions[name] = { ...question };
+    }
+    const response = await evaluator.evaluate({
+        schemaId: battery.id,
+        questions,
+        state
+    });
+    const labels = readLabels(subject, ref, response);
+    return decideModeration(subject, labels, (parsedOptions.now ?? (() => new Date()))());
+}
+//# sourceMappingURL=moderate.js.map

package/dist/moderate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moderate.js","sourceRoot":"","sources":["../src/moderate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,wBAAwB,EAAE,4BAA4B,EAA0D,MAAM,oBAAoB,CAAC;AACpJ,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAClI,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGvD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,OAAqB,EACrB,KAA2B,EAC3B,OAAgC;IAEhC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClF,MAAM,aAAa,GAAG,4BAA4B,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAExC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9D,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;IAE9C,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,SAAS,GAA6B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IACnC,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC;QACzC,QAAQ,EAAE,OAAO,CAAC,EAAE;QACpB,SAAS;QACT,KAAK;KACL,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAClD,OAAO,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AACvF,CAAC"}

package/dist/moderation.plugin.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Moderation Plugin
+ *
+ * Registers the `moderation/subject` kind and the owner-authored `docs/topic`
+ * descriptors. Features register their own subjects and batteries from their
+ * own plugins; this plugin registers no subject, no battery and no loader.
+ * The docs topics wait in the runtime's pending queue until `docs/topic`
+ * registers, so plugin order does not matter.
+ */
+export declare const moderationPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default moderationPlugin;
+//# sourceMappingURL=moderation.plugin.d.ts.map

package/dist/moderation.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moderation.plugin.d.ts","sourceRoot":"","sources":["../src/moderation.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,eAAO,MAAM,gBAAgB,6CAO3B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/moderation.plugin.js

@@ -0,0 +1,23 @@
+/**
+ * Moderation Plugin
+ *
+ * Registers the `moderation/subject` kind and the owner-authored `docs/topic`
+ * descriptors. Features register their own subjects and batteries from their
+ * own plugins; this plugin registers no subject, no battery and no loader.
+ * The docs topics wait in the runtime's pending queue until `docs/topic`
+ * registers, so plugin order does not matter.
+ */
+import { createRuntimePlugin } from '@vibesdotdev/kernel';
+import moderationDocs from "./docs/moderation.docs.descriptor.js";
+import moderationDecisionsDocs from "./docs/moderation.decisions.docs.descriptor.js";
+import moderationSubjectsDocs from "./docs/moderation.subjects.docs.descriptor.js";
+import { moderationSubjectKind } from "./kinds/subject.kind.js";
+export const moderationPlugin = createRuntimePlugin({
+    id: 'moderation',
+    name: 'Moderation',
+    description: 'Content moderation contract: the moderation/subject kind features register their content types against, plus the label and decision records moderateSubject produces.',
+    kinds: [moderationSubjectKind],
+    descriptors: [moderationDocs, moderationSubjectsDocs, moderationDecisionsDocs]
+});
+export default moderationPlugin;
+//# sourceMappingURL=moderation.plugin.js.map

package/dist/moderation.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moderation.plugin.js","sourceRoot":"","sources":["../src/moderation.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,cAAc,MAAM,sCAAsC,CAAC;AAClE,OAAO,uBAAuB,MAAM,gDAAgD,CAAC;AACrF,OAAO,sBAAsB,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;IACnD,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,YAAY;IAClB,WAAW,EACV,uKAAuK;IACxK,KAAK,EAAE,CAAC,qBAAqB,CAAC;IAC9B,WAAW,EAAE,CAAC,cAAc,EAAE,sBAAsB,EAAE,uBAAuB,CAAC;CAC9E,CAAC,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/orchestration/labels.d.ts

@@ -0,0 +1,5 @@
+import { type EvaluationResponse } from '../schemas/evaluation.ts';
+import type { ModerationSubjectDescriptor, ModerationSubjectRef } from '../schemas/subject.ts';
+import type { ModerationLabel } from '../schemas/decision.ts';
+export declare function readLabels(subject: ModerationSubjectDescriptor, ref: ModerationSubjectRef, response: EvaluationResponse): ModerationLabel[];
+//# sourceMappingURL=labels.d.ts.map

package/dist/orchestration/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/orchestration/labels.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8C,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC/G,OAAO,KAAK,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,wBAAgB,UAAU,CACzB,OAAO,EAAE,2BAA2B,EACpC,GAAG,EAAE,oBAAoB,EACzB,QAAQ,EAAE,kBAAkB,GAC1B,eAAe,EAAE,CA4CnB"}

package/dist/orchestration/labels.js

@@ -0,0 +1,34 @@
+import * as z from 'zod/v4';
+import { ModerationError } from "../errors.js";
+import { EvaluationResponseSchema, NoulAnswerSchema } from "../schemas/evaluation.js";
+export function readLabels(subject, ref, response) {
+    const batteryId = subject.batteryId;
+    const parsed = EvaluationResponseSchema.safeParse(response);
+    if (!parsed.success) {
+        throw new ModerationError('MODERATION_EVALUATION_INVALID', `battery '${batteryId}' response is not an evaluation response: ${z.prettifyError(parsed.error)}`);
+    }
+    const { answers } = parsed.data;
+    const answerSource = parsed.data.source ?? 'native';
+    const labels = [];
+    for (const value of subject.labels) {
+        if (!Object.hasOwn(answers, value)) {
+            throw new ModerationError('MODERATION_EVALUATION_INVALID', `battery '${batteryId}' answer is missing head '${value}'`);
+        }
+        const answer = NoulAnswerSchema.safeParse(answers[value]);
+        if (!answer.success) {
+            throw new ModerationError('MODERATION_EVALUATION_INVALID', `battery '${batteryId}' answer for head '${value}' is not a noul in [0, 1]`);
+        }
+        labels.push({
+            subject: ref,
+            value,
+            score: answer.data.noul,
+            source: { batteryId, answerSource }
+        });
+    }
+    const undeclared = Object.keys(answers).filter((head) => !subject.labels.some((label) => label === head));
+    if (undeclared.length > 0) {
+        throw new ModerationError('MODERATION_EVALUATION_INVALID', `battery '${batteryId}' answered undeclared heads [${undeclared.join(', ')}]`);
+    }
+    return labels;
+}
+//# sourceMappingURL=labels.js.map

package/dist/orchestration/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../src/orchestration/labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAA2B,MAAM,0BAA0B,CAAC;AAI/G,MAAM,UAAU,UAAU,CACzB,OAAoC,EACpC,GAAyB,EACzB,QAA4B;IAE5B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,eAAe,CACxB,+BAA+B,EAC/B,YAAY,SAAS,6CAA6C,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACjG,CAAC;IACH,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAChC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC;IACpD,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,eAAe,CACxB,+BAA+B,EAC/B,YAAY,SAAS,6BAA6B,KAAK,GAAG,CAC1D,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,IAAI,eAAe,CACxB,+BAA+B,EAC/B,YAAY,SAAS,sBAAsB,KAAK,2BAA2B,CAC3E,CAAC;QACH,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACX,OAAO,EAAE,GAAG;YACZ,KAAK;YACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;YACvB,MAAM,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE;SACnC,CAAC,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAC7C,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CACzD,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,eAAe,CACxB,+BAA+B,EAC/B,YAAY,SAAS,gCAAgC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7E,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/orchestration/resolve.d.ts

@@ -0,0 +1,11 @@
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { type ModerationSubjectDescriptor } from '../schemas/subject.ts';
+import { type ModerationState } from '../schemas/input.ts';
+import { EvaluationBatterySchema, type ModerationEvaluator } from '../schemas/evaluation.ts';
+export declare function resolveSubject(runtime: VibesRuntime, type: string): Promise<ModerationSubjectDescriptor>;
+export declare function resolveBattery(runtime: VibesRuntime, subject: ModerationSubjectDescriptor): Promise<z.infer<typeof EvaluationBatterySchema>>;
+export declare function assertBatteryContract(subject: ModerationSubjectDescriptor, battery: z.infer<typeof EvaluationBatterySchema>): string[];
+export declare function assertState(batteryId: string, requiredState: readonly string[], state: ModerationState): void;
+export declare function resolveEvaluator(runtime: VibesRuntime): Promise<ModerationEvaluator>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/orchestration/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/orchestration/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,OAAO,EAAqC,KAAK,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAA4B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAMvH,wBAAsB,cAAc,CACnC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,2BAA2B,CAAC,CAyBtC;AAED,wBAAsB,cAAc,CACnC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,2BAA2B,GAClC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC,CA0BlD;AAED,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,GAC9C,MAAM,EAAE,CA2BV;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAU7G;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6B1F"}

package/dist/orchestration/resolve.js

@@ -0,0 +1,90 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+import * as z from 'zod/v4';
+import { ModerationError } from "../errors.js";
+import { MODERATION_SUBJECT_KIND_ID } from "../kinds/subject.kind.js";
+import { ModerationSubjectDescriptorSchema } from "../schemas/subject.js";
+import { EmptyStateValueSchema } from "../schemas/input.js";
+import { EvaluationBatterySchema, EvaluatorAdmissionSchema } from "../schemas/evaluation.js";
+const BATTERY_KIND_ID = 'ai/evaluation-schema';
+function isEvaluator(client) {
+    return EvaluatorAdmissionSchema.safeParse(client).success;
+}
+export async function resolveSubject(runtime, type) {
+    if (!runtime.hasKind(MODERATION_SUBJECT_KIND_ID)) {
+        throw new ModerationError('MODERATION_SUBJECT_UNKNOWN', `no moderation/subject '${type}' is registered (kind not mounted; compose the moderation plugin)`);
+    }
+    const descriptors = await runtime.query(MODERATION_SUBJECT_KIND_ID).descriptorsAsync();
+    const found = descriptors.find((descriptor) => descriptor.id === type && descriptor.enabled !== false);
+    if (!found) {
+        throw new ModerationError('MODERATION_SUBJECT_UNKNOWN', `no enabled moderation/subject '${type}' is registered`);
+    }
+    const parsed = ModerationSubjectDescriptorSchema.safeParse(found);
+    if (!parsed.success) {
+        throw new ModerationError('MODERATION_SUBJECT_UNKNOWN', `moderation/subject '${type}' is registered but is not a valid subject: ${z.prettifyError(parsed.error)}`);
+    }
+    return parsed.data;
+}
+export async function resolveBattery(runtime, subject) {
+    const batteryId = subject.batteryId;
+    if (!runtime.hasKind(BATTERY_KIND_ID)) {
+        throw new ModerationError('MODERATION_BATTERY_UNKNOWN', `subject '${subject.id}' names battery '${batteryId}', but no ai/evaluation-schema kind is registered`);
+    }
+    const descriptors = await runtime.query(BATTERY_KIND_ID).descriptorsAsync();
+    const found = descriptors.find((descriptor) => descriptor.id === batteryId && descriptor.enabled !== false);
+    if (!found) {
+        throw new ModerationError('MODERATION_BATTERY_UNKNOWN', `subject '${subject.id}' names battery '${batteryId}', which is not registered or is disabled`);
+    }
+    const parsed = EvaluationBatterySchema.safeParse(found);
+    if (!parsed.success) {
+        throw new ModerationError('MODERATION_BATTERY_MISMATCH', `battery '${batteryId}' is not a readable evaluation battery: ${z.prettifyError(parsed.error)}`);
+    }
+    return parsed.data;
+}
+export function assertBatteryContract(subject, battery) {
+    const heads = Object.keys(battery.questions);
+    const missing = subject.labels.filter((label) => !heads.includes(label));
+    const extra = heads.filter((head) => !subject.labels.some((label) => label === head));
+    if (missing.length > 0 || extra.length > 0) {
+        throw new ModerationError('MODERATION_BATTERY_MISMATCH', `battery '${battery.id}' heads [${heads.join(', ')}] must equal subject '${subject.id}' labels [${subject.labels.join(', ')}]` +
+            (missing.length > 0 ? `; missing [${missing.join(', ')}]` : '') +
+            (extra.length > 0 ? `; undeclared [${extra.join(', ')}]` : ''));
+    }
+    const notNoul = heads.filter((head) => battery.questions[head]?.type !== 'noul');
+    if (notNoul.length > 0) {
+        throw new ModerationError('MODERATION_BATTERY_MISMATCH', `battery '${battery.id}' heads must all be 'noul'; not noul: [${notNoul.join(', ')}]`);
+    }
+    const requiredState = battery.requiredState ?? [];
+    if (requiredState.length === 0) {
+        throw new ModerationError('MODERATION_BATTERY_MISMATCH', `battery '${battery.id}' must declare a non-empty requiredState so moderation can refuse empty input`);
+    }
+    return requiredState;
+}
+export function assertState(batteryId, requiredState, state) {
+    const empty = requiredState.filter((key) => EmptyStateValueSchema.safeParse(Object.hasOwn(state, key) ? state[key] : undefined).success);
+    if (empty.length > 0) {
+        throw new ModerationError('MODERATION_STATE_INVALID', `battery '${batteryId}' state is missing or empty for [${empty.join(', ')}]`);
+    }
+}
+export async function resolveEvaluator(runtime) {
+    // Never let getVibesClient auto-register runtime/client on a runtime the
+    // host did not compose it into: that would mint a second client graph.
+    if (!runtime.hasKind('runtime/client')) {
+        throw new ModerationError('MODERATION_EVALUATOR_UNAVAILABLE', "runtime/client is not registered, so no 'ai' client can evaluate");
+    }
+    let client;
+    try {
+        client = await getVibesClient('ai', runtime);
+    }
+    catch (cause) {
+        if (cause instanceof Error && CapabilityError.isAbsenceOf(cause, 'runtime/client', 'ai')) {
+            throw new ModerationError('MODERATION_EVALUATOR_UNAVAILABLE', 'runtime/client ai did not resolve', { cause });
+        }
+        throw cause;
+    }
+    if (!isEvaluator(client)) {
+        throw new ModerationError('MODERATION_EVALUATOR_UNAVAILABLE', "runtime/client 'ai' has no evaluate function");
+    }
+    return client;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/orchestration/resolve.js.map

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

package/dist/orchestration/state.d.ts

@@ -0,0 +1,10 @@
+import { type ModerationState, type ModerationCallerState } from '../schemas/input.ts';
+/**
+ * Take the owned snapshot of the caller's state before the first await.
+ * Accessor properties and cycles are refused by path without being read;
+ * other non-JSON values fail the schema, whose error is the cause. A failure
+ * the caller's own object raises while it is read (a proxy trap, or nesting
+ * deeper than the call stack) propagates unchanged.
+ */
+export declare function snapshotState(state: ModerationCallerState): ModerationState;
+//# sourceMappingURL=state.d.ts.map

package/dist/orchestration/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/orchestration/state.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAA6B,MAAM,qBAAqB,CAAC;AAgCzI;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,qBAAqB,GAAG,eAAe,CAa3E"}

package/dist/orchestration/state.js

@@ -0,0 +1,58 @@
+import { ModerationError } from "../errors.js";
+import { ModerationStateSchema } from "../schemas/input.js";
+const NOT_PLAIN_JSON = 'moderation state must be a plain JSON object';
+/** Plain objects and arrays: the containers the schema reads as JSON. Anything else is a leaf it judges. */
+function isJsonContainer(value) {
+    if (value === null || value === undefined)
+        return false;
+    if (Array.isArray(value))
+        return true;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+/**
+ * Name the first place the schema could not read `value` as data without
+ * running caller code or recursing without end: an accessor property, or a
+ * container that encloses itself. Reads property descriptors only, so no
+ * getter runs. Shared, non-enclosing references are plain JSON and pass.
+ */
+function findNonData(value, path, enclosing) {
+    if (!isJsonContainer(value))
+        return null;
+    if (enclosing.has(value))
+        return `${path} refers back to an enclosing value`;
+    enclosing.add(value);
+    for (const key of Reflect.ownKeys(value)) {
+        const at = `${path}.${String(key)}`;
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor !== undefined && !('value' in descriptor))
+            return `${at} is an accessor property`;
+        const found = findNonData(descriptor?.value, at, enclosing);
+        if (found !== null)
+            return found;
+    }
+    enclosing.delete(value);
+    return null;
+}
+/**
+ * Take the owned snapshot of the caller's state before the first await.
+ * Accessor properties and cycles are refused by path without being read;
+ * other non-JSON values fail the schema, whose error is the cause. A failure
+ * the caller's own object raises while it is read (a proxy trap, or nesting
+ * deeper than the call stack) propagates unchanged.
+ */
+export function snapshotState(state) {
+    if (Array.isArray(state) || !isJsonContainer(state)) {
+        throw new ModerationError('MODERATION_STATE_INVALID', NOT_PLAIN_JSON);
+    }
+    const nonData = findNonData(state, 'state', new Set());
+    if (nonData !== null) {
+        throw new ModerationError('MODERATION_STATE_INVALID', `${NOT_PLAIN_JSON}; ${nonData}`);
+    }
+    const parsed = ModerationStateSchema.safeParse(state);
+    if (!parsed.success) {
+        throw new ModerationError('MODERATION_STATE_INVALID', NOT_PLAIN_JSON, { cause: parsed.error });
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=state.js.map

package/dist/orchestration/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/orchestration/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAA+E,MAAM,qBAAqB,CAAC;AACzI,MAAM,cAAc,GAAG,8CAA8C,CAAC;AAEtE,4GAA4G;AAC5G,SAAS,eAAe,CAAC,KAA4B;IACpD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,SAAS,GAAY,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACxD,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,KAA4B,EAAE,IAAY,EAAE,SAAsB;IACtF,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,IAAI,oCAAoC,CAAC;IAC7E,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,GAAG,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/D,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC;YAAE,OAAO,GAAG,EAAE,0BAA0B,CAAC;QACjG,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;QAC5D,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;IAClC,CAAC;IACD,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAA4B;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,eAAe,CAAC,0BAA0B,EAAE,cAAc,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IACvD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,eAAe,CAAC,0BAA0B,EAAE,GAAG,cAAc,KAAK,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,eAAe,CAAC,0BAA0B,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/schemas/decision.d.ts

@@ -0,0 +1,131 @@
+import * as z from 'zod/v4';
+/**
+ * Where the scores came from. `native` answers are calibrated probabilities
+ * from a structured-evaluation model; `adapted` answers come from a JSON-mode
+ * chat model running the same battery and carry no calibration.
+ */
+export declare const ModerationAnswerSourceSchema: z.ZodEnum<{
+    native: "native";
+    adapted: "adapted";
+}>;
+export type ModerationAnswerSource = z.infer<typeof ModerationAnswerSourceSchema>;
+/** One label score for one subject, with the battery and answer source that produced it. */
+export declare const ModerationLabelSchema: z.ZodObject<{
+    subject: z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+        containerId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    value: z.ZodEnum<{
+        harassment: "harassment";
+        hate: "hate";
+        sexual: "sexual";
+        sexual_minors: "sexual_minors";
+        violence: "violence";
+        self_harm: "self_harm";
+        spam: "spam";
+        scam: "scam";
+    }>;
+    score: z.ZodNumber;
+    source: z.ZodObject<{
+        batteryId: z.ZodString;
+        answerSource: z.ZodEnum<{
+            native: "native";
+            adapted: "adapted";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ModerationLabel = z.infer<typeof ModerationLabelSchema>;
+export declare const ModerationActionSchema: z.ZodEnum<{
+    allow: "allow";
+    review: "review";
+    hide: "hide";
+}>;
+export type ModerationAction = z.infer<typeof ModerationActionSchema>;
+/** A label whose score crossed a threshold, and which threshold it crossed. */
+export declare const ModerationTriggerSchema: z.ZodObject<{
+    label: z.ZodEnum<{
+        harassment: "harassment";
+        hate: "hate";
+        sexual: "sexual";
+        sexual_minors: "sexual_minors";
+        violence: "violence";
+        self_harm: "self_harm";
+        spam: "spam";
+        scam: "scam";
+    }>;
+    score: z.ZodNumber;
+    threshold: z.ZodNumber;
+    level: z.ZodEnum<{
+        review: "review";
+        hide: "hide";
+    }>;
+}, z.core.$strip>;
+export type ModerationTrigger = z.infer<typeof ModerationTriggerSchema>;
+/**
+ * The outcome of moderating one subject. The refinement keeps the action,
+ * the triggers and the labels mutually consistent, so a decision that says
+ * `allow` while carrying a hide trigger cannot be constructed.
+ */
+export declare const ModerationDecisionSchema: z.ZodObject<{
+    subject: z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+        containerId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    action: z.ZodEnum<{
+        allow: "allow";
+        review: "review";
+        hide: "hide";
+    }>;
+    answerSource: z.ZodEnum<{
+        native: "native";
+        adapted: "adapted";
+    }>;
+    labels: z.ZodArray<z.ZodObject<{
+        subject: z.ZodObject<{
+            type: z.ZodString;
+            id: z.ZodString;
+            containerId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        value: z.ZodEnum<{
+            harassment: "harassment";
+            hate: "hate";
+            sexual: "sexual";
+            sexual_minors: "sexual_minors";
+            violence: "violence";
+            self_harm: "self_harm";
+            spam: "spam";
+            scam: "scam";
+        }>;
+        score: z.ZodNumber;
+        source: z.ZodObject<{
+            batteryId: z.ZodString;
+            answerSource: z.ZodEnum<{
+                native: "native";
+                adapted: "adapted";
+            }>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    triggers: z.ZodArray<z.ZodObject<{
+        label: z.ZodEnum<{
+            harassment: "harassment";
+            hate: "hate";
+            sexual: "sexual";
+            sexual_minors: "sexual_minors";
+            violence: "violence";
+            self_harm: "self_harm";
+            spam: "spam";
+            scam: "scam";
+        }>;
+        score: z.ZodNumber;
+        threshold: z.ZodNumber;
+        level: z.ZodEnum<{
+            review: "review";
+            hide: "hide";
+        }>;
+    }, z.core.$strip>>;
+    decidedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type ModerationDecision = z.infer<typeof ModerationDecisionSchema>;
+//# sourceMappingURL=decision.d.ts.map

package/dist/schemas/decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/schemas/decision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;;EAAgC,CAAC;AAE1E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;iBAQhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,sBAAsB;;;;EAAsC,CAAC;AAE1E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;iBAKlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMxE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0DlC,CAAC;AAEJ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}