@spine-event-engine/ai 0.0.0-stage → 2.0.0-snapshot.24

package/dist/internal/decision.d.ts

@@ -0,0 +1,54 @@
+import type { MessageShape } from "@bufbuild/protobuf";
+import { type MessageSchema } from "@spine-event-engine/core";
+import type { AiDecisionResult, AiValidationIssue } from "./contracts.js";
+import type { AiModel } from "./model.js";
+/**
+ * Decimal precision declared by a decision provider; absent means no rounding allowance.
+ */
+export interface AiDistributionRounding {
+    /**
+     * Configured probability decimals for this contract.
+     */
+    readonly probabilityDecimals?: number;
+    /**
+     * Configured score decimals for this contract.
+     */
+    readonly scoreDecimals?: number;
+}
+/**
+ * Validated mapped output or local decision issues.
+ *
+ * @typeParam O - Output message descriptor.
+ */
+export type AiDecisionAdmission<O extends MessageSchema> = {
+    /**
+     * Indicates the mapped result was admitted.
+     */
+    readonly ok: true;
+    /**
+     * Validated typed application output.
+     */
+    readonly value: MessageShape<O>;
+} | {
+    /**
+     * Indicates local decision admission failed.
+     */
+    readonly ok: false;
+    /**
+     * Local validation defects.
+     */
+    readonly issues: readonly AiValidationIssue[];
+};
+/**
+ * Admits a decision without generating or correcting chat text.
+ *
+ * @typeParam I - Input message descriptor.
+ * @typeParam O - Output message descriptor.
+ * @param model Factory-created decision capability.
+ * @param result Provider decision result.
+ * @param input Validated application input.
+ * @param rounding Explicit provider distribution rounding allowance.
+ * @returns Validated mapped Protobuf output or issues.
+ */
+export declare const admitDecision: <I extends MessageSchema, O extends MessageSchema>(model: AiModel<I, O>, result: AiDecisionResult, input: MessageShape<I>, rounding: AiDistributionRounding) => AiDecisionAdmission<O>;
+//# sourceMappingURL=decision.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/internal/decision.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAEV,gBAAgB,EAGhB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,aAAa,IACnD;IACE;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACjC,GACD;IACE;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C,CAAC;AA6NN;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,aAAa,EAAE,CAAC,SAAS,aAAa,EAC5E,OAAO,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,QAAQ,gBAAgB,EACxB,OAAO,YAAY,CAAC,CAAC,CAAC,EACtB,UAAU,sBAAsB,KAC/B,mBAAmB,CAAC,CAAC,CAYvB,CAAC"}

package/dist/internal/decision.js

@@ -0,0 +1,197 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { Validate } from "@spine-event-engine/core";
+import { isAiModel } from "./model.js";
+/**
+ * @param path Question or distribution path. @param message Safe diagnostic. @returns Issue.
+ */
+const invalid = (path, message) => {
+    return { code: "INVALID_DECISION", path, message };
+};
+/**
+ * @param value Candidate probability. @returns Whether it is finite and inside [0,1].
+ */
+const probability = (value) => {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= 1;
+};
+/**
+ * Checks full distribution identity, values and sum against explicit rounding.
+ *
+ * @param values Provider probabilities.
+ * @param keys Declared alternatives.
+ * @param path Question path.
+ * @param error Aggregate error from declared decimal rounding.
+ * @returns Local issues.
+ */
+const distribution = (values, keys, path, error) => {
+    if (!values)
+        return [invalid(path, "Full distribution required")];
+    const actual = Object.keys(values);
+    if (actual.length !== keys.length || actual.some((key) => !keys.includes(key)))
+        return [invalid(path, "Distribution keys must match declared alternatives")];
+    const probabilities = actual.map((key) => values[key] ?? Number.NaN);
+    if (probabilities.some((value) => !probability(value)))
+        return [invalid(path, "Distribution probabilities must be finite and in [0,1]")];
+    const total = probabilities.reduce((sum, value) => sum + value, 0);
+    return Math.abs(total - 1) <= error
+        ? []
+        : [invalid(path, "Distribution sum exceeds rounding allowance")];
+};
+/**
+ * @param decimals Declared decimal places. @returns Half-unit rounding allowance.
+ */
+const halfUnit = (decimals) => decimals === undefined ? 0 : 0.5 * 10 ** -decimals;
+/**
+ * @param rounding Provider precision. @returns Checked precision.
+ */
+const checkedRounding = (rounding) => {
+    for (const [name, decimals] of Object.entries(rounding))
+        if (!Number.isInteger(decimals) || decimals < 0 || decimals > 15)
+            throw new TypeError(`${name} must be an integer in [0,15]`);
+    return rounding;
+};
+/**
+ * Checks a choice or score against its reported distribution.
+ *
+ * @param answer Choice or score answer.
+ * @param keys Declared alternatives.
+ * @param rounding Provider precision.
+ * @param path Issue path.
+ * @returns Coherence issues.
+ */
+const coherenceIssues = (answer, keys, rounding, path) => {
+    const values = answer.probabilities;
+    if (!values)
+        return [];
+    if (answer.type === "choice") {
+        const maximum = Math.max(...keys.map((key) => values[key] ?? -1));
+        return (values[answer.choice] ?? -1) >= maximum
+            ? []
+            : [invalid(path, "Chosen alternative must have maximal probability")];
+    }
+    const mean = keys.reduce((sum, key, index) => sum + index * (values[key] ?? 0), 0);
+    const error = keys.reduce((sum, _, index) => sum + index * halfUnit(rounding.probabilityDecimals), halfUnit(rounding.scoreDecimals));
+    return Math.abs(answer.score - mean) <= error + Number.EPSILON
+        ? []
+        : [invalid(path, "Score differs from probability-weighted mean")];
+};
+/**
+ * Checks confidence and any requested complete probability distribution.
+ *
+ * @param answer Choice or score answer.
+ * @param keys Declared alternatives.
+ * @param path Question path.
+ * @param rounding Provider precision.
+ * @param required Whether a distribution is required.
+ * @returns Confidence and distribution issues.
+ */
+const answerDistributionIssues = (answer, keys, path, rounding, required) => {
+    const issues = [];
+    if (answer.confidence !== undefined && !probability(answer.confidence))
+        issues.push(invalid(path, "Confidence must be in [0,1]"));
+    if (answer.probabilities || required)
+        issues.push(...distribution(answer.probabilities, keys, path, keys.length * halfUnit(rounding.probabilityDecimals) + Number.EPSILON));
+    return issues;
+};
+/**
+ * Validates one answer against a declared question.
+ *
+ * @param answer Provider answer.
+ * @param question Declared question.
+ * @param path Question path.
+ * @param rounding Aggregate rounding allowance.
+ * @param requireProbabilities Whether full distributions are mandatory.
+ * @returns Local issues.
+ */
+const answerIssues = (answer, question, path, rounding, requireProbabilities) => {
+    if (answer?.type !== question.type)
+        return [invalid(path, "Answer kind differs")];
+    if (answer.type === "boolean")
+        return probability(answer.probability) ? [] : [invalid(path, "Invalid boolean probability")];
+    if (question.type === "boolean")
+        return [invalid(path, "Answer kind differs")];
+    const keys = question.type === "choice"
+        ? Object.keys(question.criteria)
+        : question.criteria.map((_, index) => String(index));
+    const valueValid = answer.type === "choice"
+        ? keys.includes(answer.choice)
+        : typeof answer.score === "number" &&
+            Number.isFinite(answer.score) &&
+            answer.score >= 0 &&
+            answer.score <= keys.length - 1;
+    const issues = valueValid ? [] : [invalid(path, "Answer value is outside declared alternatives")];
+    issues.push(...answerDistributionIssues(answer, keys, path, rounding, requireProbabilities));
+    if (issues.length === 0)
+        issues.push(...coherenceIssues(answer, keys, rounding, path));
+    return issues;
+};
+/**
+ * Checks all answer IDs and declared question kinds.
+ *
+ * @param questions Declared IDs and kinds.
+ * @param result Provider answers.
+ * @param rounding Provider precision.
+ * @param required Whether full distributions are required.
+ * @returns Answer issues.
+ */
+const answerSetIssues = (questions, result, rounding, required) => {
+    const answers = result.answers;
+    const IDs = Object.keys(questions);
+    if (Object.keys(answers).length !== IDs.length ||
+        Object.keys(answers).some((id) => !Object.hasOwn(questions, id)))
+        return [invalid("answers", "Answer IDs must match declared questions")];
+    return Object.entries(questions).flatMap(([id, question]) => answerIssues(answers[id], question, `answers.${id}`, rounding, required));
+};
+/**
+ * Maps admitted answers to a typed application output.
+ *
+ * @typeParam I - Input message descriptor.
+ * @typeParam O - Output message descriptor.
+ * @param definition Declared decision mapping.
+ * @param result Checked answers.
+ * @param input Typed facts.
+ * @returns Validated output or issues.
+ */
+const mappedOutput = (definition, result, input) => {
+    const value = definition.mapping.toMessage(result, input);
+    const checked = Validate.message(definition.output, value);
+    if (!checked.valid)
+        return {
+            ok: false,
+            issues: checked.violations.map((entry) => invalid(entry.fieldPath?.fieldName.join(".") ?? "$", entry.message?.withPlaceholders ?? "Invalid output")),
+        };
+    const appIssues = definition.validation?.check(value, input) ?? [];
+    return appIssues.length ? { ok: false, issues: appIssues } : { ok: true, value };
+};
+/**
+ * Admits a decision without generating or correcting chat text.
+ *
+ * @typeParam I - Input message descriptor.
+ * @typeParam O - Output message descriptor.
+ * @param model Factory-created decision capability.
+ * @param result Provider decision result.
+ * @param input Validated application input.
+ * @param rounding Explicit provider distribution rounding allowance.
+ * @returns Validated mapped Protobuf output or issues.
+ */
+export const admitDecision = (model, result, input, rounding) => {
+    const definition = model.definition;
+    if (!isAiModel(model) || definition.kind !== "decision")
+        throw new TypeError("Factory-created decision capability required");
+    const issues = answerSetIssues(definition.questions, result, checkedRounding(rounding), definition.requireProbabilities ?? false);
+    if (issues.length)
+        return { ok: false, issues };
+    return mappedOutput(definition, result, input);
+};
+//# sourceMappingURL=decision.js.map

package/dist/internal/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../src/internal/decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AASxE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA8CvC;;GAEG;AACH,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,OAAe,EAAqB,EAAE;IACnE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACrD,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,GAAG,CAAC,KAAa,EAAW,EAAE;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACzF,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,YAAY,GAAG,CACnB,MAAoD,EACpD,IAAuB,EACvB,IAAY,EACZ,KAAa,EACQ,EAAE;IACvB,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5E,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,oDAAoD,CAAC,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;IACrE,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACpD,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,wDAAwD,CAAC,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,KAAK;QACjC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,6CAA6C,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,QAAQ,GAAG,CAAC,QAA4B,EAAU,EAAE,CACxD,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC;AAErD;;GAEG;AACH,MAAM,eAAe,GAAG,CAAC,QAAgC,EAA0B,EAAE;IACnF,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,EAAE;YAC9D,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,+BAA+B,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,eAAe,GAAG,CACtB,MAAuD,EACvD,IAAuB,EACvB,QAAgC,EAChC,IAAY,EACS,EAAE;IACvB,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC;IACpC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO;YAC7C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,kDAAkD,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CACvB,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EACvE,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CACjC,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO;QAC5D,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,8CAA8C,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,wBAAwB,GAAG,CAC/B,MAAuD,EACvD,IAAuB,EACvB,IAAY,EACZ,QAAgC,EAChC,QAAiB,EACI,EAAE;IACvB,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,aAAa,IAAI,QAAQ;QAClC,MAAM,CAAC,IAAI,CACT,GAAG,YAAY,CACb,MAAM,CAAC,aAAa,EACpB,IAAI,EACJ,IAAI,EACJ,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,OAAO,CACtE,CACF,CAAC;IACJ,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,YAAY,GAAG,CACnB,MAA4B,EAC5B,QAAoB,EACpB,IAAY,EACZ,QAAgC,EAChC,oBAA6B,EACR,EAAE;IACvB,IAAI,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC,IAAI;QAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAClF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAC3B,OAAO,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAC,CAAC;IAC/F,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAC/E,MAAM,IAAI,GACR,QAAQ,CAAC,IAAI,KAAK,QAAQ;QACxB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAChC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,MAAM,UAAU,GACd,MAAM,CAAC,IAAI,KAAK,QAAQ;QACtB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QAC9B,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAChC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;YAC7B,MAAM,CAAC,KAAK,IAAI,CAAC;YACjB,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,+CAA+C,CAAC,CAAC,CAAC;IAClG,MAAM,CAAC,IAAI,CAAC,GAAG,wBAAwB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC7F,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IACvF,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,eAAe,GAAG,CACtB,SAA+C,EAC/C,MAAwB,EACxB,QAAgC,EAChC,QAAiB,EACI,EAAE;IACvB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnC,IACE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;QAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAEhE,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,0CAA0C,CAAC,CAAC,CAAC;IAC1E,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAC1D,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,CACzE,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,YAAY,GAAG,CACnB,UAAkE,EAClE,MAAwB,EACxB,KAAsB,EACE,EAAE;IAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO,CAAC,KAAK;QAChB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACvC,OAAO,CACL,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAC3C,KAAK,CAAC,OAAO,EAAE,gBAAgB,IAAI,gBAAgB,CACpD,CACF;SACF,CAAC;IACJ,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACnE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACnF,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,KAAoB,EACpB,MAAwB,EACxB,KAAsB,EACtB,QAAgC,EACR,EAAE;IAC1B,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU;QACrD,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,eAAe,CAC5B,UAAU,CAAC,SAAS,EACpB,MAAM,EACN,eAAe,CAAC,QAAQ,CAAC,EACzB,UAAU,CAAC,oBAAoB,IAAI,KAAK,CACzC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChD,OAAO,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC,CAAC"}

package/dist/internal/execution.d.ts

@@ -0,0 +1,309 @@
+import type { MessageShape } from "@bufbuild/protobuf";
+import type { MessageSchema } from "@spine-event-engine/core";
+import type { AgentAiOperationFailed, AgentToolCallFinished, AiOperationId, AiUsage, DecisionRequest, DecisionResponse, GenerationRequest, GenerationResponse, ToolResponse } from "@spine-event-engine/proto/agent";
+import type { AiConnectionIdentity, AiControl, AiDecisionResult, AiFailure, AiLimits, AiModelDefinition, AiScope, AiValidationIssue } from "./contracts.js";
+import type { AiMcpAdvertisedTool } from "./mcp-protocol.js";
+/**
+ * One model-facing request already recorded against the signal budget.
+ */
+export type AiAttemptRequest = {
+    /**
+     * Identifies a generation request.
+     */
+    readonly kind: "generation";
+    /**
+     * Actual model-facing generation content.
+     */
+    readonly content: GenerationRequest;
+} | {
+    /**
+     * Identifies a non-generative decision request.
+     */
+    readonly kind: "decision";
+    /**
+     * Actual model-facing decision content.
+     */
+    readonly content: DecisionRequest;
+};
+/**
+ * One model-facing response journaled before result admission.
+ */
+export type AiAttemptResponse = GenerationResponse | DecisionResponse;
+/**
+ * Rejects a nonterminal tool proposal in incompatible conversation/event contexts.
+ *
+ * @param content Typed response or terminal System event.
+ */
+export declare const assertAiOutcomeContext: (content: GenerationResponse | DecisionResponse | ToolResponse | AgentToolCallFinished | AgentAiOperationFailed) => void;
+/**
+ * One persisted physical request identity and its reserved resource bounds.
+ */
+export interface AiAttemptTicket {
+    /**
+     * Runtime-assigned attempt ID; one ticket admits at most one transport fetch.
+     */
+    readonly id: string;
+    /**
+     * Actual serialized provider request-body ceiling.
+     */
+    readonly maxInputBytes?: number;
+    /**
+     * Full reserved decoded response-body allowance.
+     */
+    readonly maxOutputBytes?: number;
+    /**
+     * Absolute deadline read through the runtime Time service.
+     */
+    readonly deadlineEpochMs?: number;
+    /**
+     * Cancellation and execution-fence loss signal.
+     */
+    readonly signal: AbortSignal;
+}
+/**
+ * Completed physical attempt returned from a durable journal without redispatch.
+ */
+export interface AiAttemptReplay {
+    /**
+     * Distinguishes saved content from a new physical-attempt ticket.
+     */
+    readonly kind: "replay";
+    /**
+     * Original attempt identity retained for tool-call correlation.
+     */
+    readonly id: string;
+    /**
+     * Previously journaled bounded provider response.
+     */
+    readonly response: AiAttemptResponse;
+    /**
+     * Previously journaled local validation issues, when any.
+     */
+    readonly issues?: readonly AiValidationIssue[];
+    /**
+     * Original persisted failure and retryability matching the response diagnostic.
+     */
+    readonly failure?: AiFailure;
+}
+/**
+ * Fenced completion record for one physical model attempt.
+ */
+export interface AiAttemptCompletion {
+    /**
+     * Previously allocated physical attempt identity.
+     */
+    readonly ticketId: string;
+    /**
+     * Complete measured response bytes; absent for an incomplete or unknown receipt.
+     */
+    readonly receivedBytes?: number;
+    /**
+     * Complete bounded provider and validation response content.
+     */
+    readonly response: AiAttemptResponse;
+    /**
+     * Actual bounded local validation issues, when applicable.
+     */
+    readonly issues?: readonly AiValidationIssue[];
+    /**
+     * Provider token counts; absent means unknown rather than zero.
+     */
+    readonly usage?: AiUsage;
+}
+/**
+ * Runtime admission of a generated ProtoJSON candidate.
+ */
+export type AiCandidateAdmission = {
+    /**
+     * Indicates the output passed definitive local validation.
+     */
+    readonly ok: true;
+    /**
+     * Validated application output.
+     */
+    readonly value: MessageShape<MessageSchema>;
+} | {
+    /**
+     * Indicates local output validation failed.
+     */
+    readonly ok: false;
+    /**
+     * Actual bounded issues available for correction.
+     */
+    readonly issues: readonly AiValidationIssue[];
+};
+/**
+ * Runtime-authorized tool call without a model-selected effect.
+ */
+export interface AiToolInvocation {
+    /**
+     * Physical attempt whose recorded response proposed this call.
+     */
+    readonly ticketId: string;
+    /**
+     * Configured MCP server name.
+     */
+    readonly server: string;
+    /**
+     * Configured tool name within that server.
+     */
+    readonly tool: string;
+    /**
+     * Canonical JSON arguments validated against tool policy.
+     */
+    readonly argumentsJson: string;
+    /**
+     * Provider call ID used only to correlate the model continuation.
+     */
+    readonly providerCallId: string;
+}
+/**
+ * Runtime controls shared by optional model adapters and scripted backends.
+ */
+export interface AiExecutionControl extends AiControl {
+    /**
+     * Reads Unix milliseconds through the runtime Time service.
+     *
+     * @returns Current Unix epoch milliseconds.
+     */
+    readonly nowEpochMs: () => number;
+    /**
+     * Checks whether the current execution fence still permits work.
+     *
+     * @returns Whether the current execution fence remains valid.
+     */
+    readonly hasAuthority: () => boolean;
+    /**
+     * Records the actual request and reserves one physical attempt.
+     *
+     * @param request Typed generation or decision content, including correction text.
+     * @returns Runtime-assigned ticket after the journal and budget barrier.
+     */
+    readonly beginAttempt: (request: AiAttemptRequest) => Promise<AiAttemptTicket | AiAttemptReplay>;
+    /**
+     * Records transport bytes against the existing attempt ticket.
+     *
+     * @param ticketId Runtime-assigned attempt ID.
+     * @param inputBytes Actual serialized provider request-body bytes.
+     * @param outputCredit Configured output allowance, if present.
+     * @returns Effective finite credit after the durable reservation barrier, if any.
+     */
+    readonly reserveTransport: (ticketId: string, inputBytes: number, outputCredit?: number) => Promise<number | undefined>;
+    /**
+     * Records a received platform chunk before parser delivery.
+     *
+     * @param ticketId Runtime-assigned attempt ID.
+     * @param bytes Actual received byte count for this chunk.
+     */
+    readonly onReceived: (ticketId: string, bytes: number) => void;
+    /**
+     * Records bounded response content and known receipt before output returns.
+     *
+     * @param completion Fenced response, usage, receipt, and local validation issues.
+     * @returns Completion of the durable journal barrier.
+     */
+    readonly finishAttempt: (completion: AiAttemptCompletion) => Promise<void>;
+    /**
+     * Persists a bounded safe diagnostic without finishing the attempt or operation.
+     *
+     * @param code Allowlisted failure category.
+     * @param retryableByNewSignal Whether a later accepted signal may retry.
+     * @returns Runtime-allocated checked failure and diagnostic reference.
+     */
+    readonly recordFailure: (code: AiFailure["code"], retryableByNewSignal: boolean) => Promise<AiFailure>;
+    /**
+     * Applies definitive Proto and application validation to a generation candidate.
+     *
+     * @param candidate Exact bounded provider text candidate.
+     * @param definition Registered typed generation capability.
+     * @param input Validated application facts for this invocation.
+     * @returns Admitted output or actual issues for a bounded Ax correction.
+     */
+    readonly admitGeneration: (candidate: string, definition: Readonly<AiModelDefinition<MessageSchema, MessageSchema>>, input: MessageShape<MessageSchema>) => AiCandidateAdmission | Promise<AiCandidateAdmission>;
+    /**
+     * Applies definitive answer, mapping, Proto, and application validation.
+     *
+     * @param result Provider's non-generative answers and rounding.
+     * @param definition Registered typed decision capability.
+     * @param input Validated application facts for this invocation.
+     * @param rounding Provider-declared decimal precision, if known.
+     * @returns Admitted mapped output or local issues; no chat correction.
+     */
+    readonly admitDecision: (result: AiDecisionResult, definition: Readonly<AiModelDefinition<MessageSchema, MessageSchema>>, input: MessageShape<MessageSchema>, rounding?: {
+        readonly probabilityDecimals?: number;
+        readonly scoreDecimals?: number;
+    }) => AiCandidateAdmission | Promise<AiCandidateAdmission>;
+    /**
+     * Executes one authorized tool call using runtime policy and identity.
+     *
+     * @param invocation Model request without an authoritative effect or tool-call ID.
+     * @returns Recorded bounded result or unresolved write outcome.
+     */
+    readonly callTool: (invocation: AiToolInvocation) => Promise<ToolResponse>;
+}
+/**
+ * One selected, authenticated request to an adapter-created backend.
+ */
+export interface AiBackendExecution {
+    /**
+     * Exact discovered and allowlisted definitions prepared before model dispatch.
+     */
+    readonly advertisedTools?: readonly AiMcpAdvertisedTool[];
+    /**
+     * Invocation name supplied by the application handler.
+     */
+    readonly call: string;
+    /**
+     * Runtime-assigned logical operation spanning physical attempts.
+     */
+    readonly operationId: AiOperationId;
+    /**
+     * Trusted authenticated signal scope.
+     */
+    readonly scope: AiScope;
+    /**
+     * Identity established before connection and matched after it.
+     */
+    readonly identity: AiConnectionIdentity;
+    /**
+     * Opaque model handle returned by the trusted connection callback.
+     */
+    readonly model: unknown;
+    /**
+     * Registered typed capability and limits.
+     */
+    readonly definition: Readonly<AiModelDefinition<MessageSchema, MessageSchema> & {
+        readonly limits: AiLimits;
+    }>;
+    /**
+     * Validated application facts.
+     */
+    readonly input: MessageShape<MessageSchema>;
+    /**
+     * Fenced runtime budgets, journal, admission, and tool authority.
+     */
+    readonly control: AiExecutionControl;
+}
+/**
+ * Backend result without a fabricated runtime operation identity.
+ */
+export type AiBackendOutcome = {
+    /**
+     * Indicates a typed application output was admitted.
+     */
+    readonly ok: true;
+    /**
+     * Definitively validated output.
+     */
+    readonly value: MessageShape<MessageSchema>;
+} | {
+    /**
+     * Indicates no application output was admitted.
+     */
+    readonly ok: false;
+    /**
+     * Safe recorded operational failure.
+     */
+    readonly failure: AiFailure;
+};
+//# sourceMappingURL=execution.d.ts.map

package/dist/internal/execution.d.ts.map

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