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

package/dist/internal/model.d.ts

@@ -0,0 +1,103 @@
+import type { MessageShape } from "@bufbuild/protobuf";
+import type { MessageSchema } from "@spine-event-engine/core";
+import { type ModelRef as ModelRefMessage } from "@spine-event-engine/proto/agent";
+import type { AiLimits, AiModelDefinition } from "./contracts.js";
+declare const aiModelBrand: unique symbol;
+/**
+ * Normalized model definition with an empty limits object when limits are omitted.
+ *
+ * @typeParam I Input message descriptor.
+ * @typeParam O Output message descriptor.
+ */
+type NormalizedAiModelDefinition<I extends MessageSchema, O extends MessageSchema> = AiModelDefinition<I, O> & {
+    readonly limits: AiLimits;
+};
+/**
+ * Factory-created typed capability accepted by the Agent runtime.
+ *
+ * @typeParam I - Input message descriptor.
+ * @typeParam O - Output message descriptor.
+ */
+export interface AiModel<I extends MessageSchema, O extends MessageSchema> {
+    /**
+     * Private marker carried only by a factory-created capability.
+     */
+    readonly [aiModelBrand]: true;
+    /**
+     * Validated immutable capability definition.
+     */
+    readonly definition: Readonly<NormalizedAiModelDefinition<I, O>>;
+}
+/**
+ * Checks whether a value came from the capability factory.
+ *
+ * @param value Untrusted candidate.
+ * @returns True only for an original factory result.
+ */
+export declare const isAiModel: (value: unknown) => value is AiModel<MessageSchema, MessageSchema>;
+/**
+ * Validates a nonblank application-supplied identifier.
+ *
+ * @param value Text to check.
+ * @param field Field named in failures.
+ * @returns Validated text without changing its identity.
+ */
+export declare const nonblank: (value: string, field: string) => string;
+/**
+ * Validates a bounded safe integer.
+ *
+ * @param value Number to check.
+ * @param field Field named in failures.
+ * @param allowZero Whether zero is valid.
+ * @returns Validated integer.
+ */
+export declare const positiveInteger: (value: number, field: string, allowZero?: boolean) => number;
+/**
+ * Creates credential-free, semantically validated deployment references.
+ */
+export declare const ModelRef: {
+    /**
+     * Creates a canonical Protobuf deployment reference.
+     *
+     * @param name Registry deployment name.
+     * @param revision Configuration revision.
+     * @returns New typed deployment reference.
+     */
+    of(name: string, revision: string): ModelRefMessage;
+};
+/**
+ * Checks a Protobuf deployment reference by value.
+ *
+ * @param candidate Reference supplied to registration or selection.
+ * @returns Key formed from the model name and revision.
+ */
+export declare const modelRefKey: (candidate: ModelRefMessage) => string;
+/**
+ * Defines factory-created capabilities independent of model connections.
+ */
+export declare const AiModel: {
+    /**
+     * Validates and snapshots a typed application capability.
+     *
+     * @typeParam I - Input message descriptor.
+     * @typeParam O - Output message descriptor.
+     * @param definition Generation or decision configuration.
+     * @returns Immutable factory-created capability.
+     */
+    define<I extends MessageSchema, O extends MessageSchema>(definition: AiModelDefinition<I, O>): AiModel<I, O>;
+};
+/**
+ * Maps a validated decision result with its declared pure function.
+ *
+ * @typeParam I - Input message descriptor.
+ * @typeParam O - Output message descriptor.
+ * @param model Decision capability.
+ * @param answers Validated answers.
+ * @param input Validated typed input.
+ * @returns Typed application output.
+ */
+export declare const mapDecision: <I extends MessageSchema, O extends MessageSchema>(model: AiModel<I, O>, answers: Parameters<Extract<AiModelDefinition<I, O>, {
+    kind: "decision";
+}>["mapping"]["toMessage"]>[0], input: MessageShape<I>) => MessageShape<O>;
+export {};
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/internal/model.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAIL,KAAK,QAAQ,IAAI,eAAe,EACjC,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAyB,MAAM,gBAAgB,CAAC;AAGzF,QAAA,MAAM,YAAY,EAAE,OAAO,MAA+B,CAAC;AAG3D;;;;;GAKG;AACH,KAAK,2BAA2B,CAC9B,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,IACrB,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,aAAa,EAAE,CAAC,SAAS,aAAa;IACvE;;OAEG;IACH,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;CAClE;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAO,CAAC,aAAa,EAAE,aAAa,CAEvF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,MAIvD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,mBAAiB,KAAG,MAMjF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB;;;;;;OAMG;aACM,MAAM,YAAY,MAAM,GAAG,eAAe;CAMpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,WAAW,eAAe,KAAG,MAWxD,CAAC;AAwLF;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB;;;;;;;OAOG;WACI,CAAC,SAAS,aAAa,EAAE,CAAC,SAAS,aAAa,cACzC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAClC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CAQjB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,aAAa,EAAE,CAAC,SAAS,aAAa,EAC1E,OAAO,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,SAAS,UAAU,CACjB,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAC/E,CAAC,CAAC,CAAC,EACJ,OAAO,YAAY,CAAC,CAAC,CAAC,KACrB,YAAY,CAAC,CAAC,CAIhB,CAAC"}

package/dist/internal/model.js

@@ -0,0 +1,292 @@
+/*
+ * 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 { create } from "@bufbuild/protobuf";
+import { ModelNameSchema, ModelRefSchema, ModelRevisionSchema, } from "@spine-event-engine/proto/agent";
+import { deriveOutputSchema } from "./schema.js";
+const aiModelBrand = Symbol("SpineAiModel");
+const models = new WeakSet();
+/**
+ * Checks whether a value came from the capability factory.
+ *
+ * @param value Untrusted candidate.
+ * @returns True only for an original factory result.
+ */
+export const isAiModel = (value) => {
+    return typeof value === "object" && value !== null && models.has(value);
+};
+/**
+ * Validates a nonblank application-supplied identifier.
+ *
+ * @param value Text to check.
+ * @param field Field named in failures.
+ * @returns Validated text without changing its identity.
+ */
+export const nonblank = (value, field) => {
+    if (typeof value !== "string" || value.trim().length === 0)
+        throw new TypeError(`${field} must be nonblank`);
+    return value;
+};
+/**
+ * Validates a bounded safe integer.
+ *
+ * @param value Number to check.
+ * @param field Field named in failures.
+ * @param allowZero Whether zero is valid.
+ * @returns Validated integer.
+ */
+export const positiveInteger = (value, field, allowZero = false) => {
+    if (!Number.isSafeInteger(value) || value < (allowZero ? 0 : 1))
+        throw new TypeError(`${field} must be a ${allowZero ? "nonnegative" : "positive"} safe integer`);
+    return value;
+};
+/**
+ * Creates credential-free, semantically validated deployment references.
+ */
+export const ModelRef = {
+    /**
+     * Creates a canonical Protobuf deployment reference.
+     *
+     * @param name Registry deployment name.
+     * @param revision Configuration revision.
+     * @returns New typed deployment reference.
+     */
+    of(name, revision) {
+        return create(ModelRefSchema, {
+            name: create(ModelNameSchema, { value: nonblank(name, "name") }),
+            revision: create(ModelRevisionSchema, { value: nonblank(revision, "revision") }),
+        });
+    },
+};
+/**
+ * Checks a Protobuf deployment reference by value.
+ *
+ * @param candidate Reference supplied to registration or selection.
+ * @returns Key formed from the model name and revision.
+ */
+export const modelRefKey = (candidate) => {
+    const supplied = candidate;
+    if (typeof supplied !== "object" ||
+        supplied === null ||
+        supplied.$typeName !== ModelRefSchema.typeName)
+        throw new TypeError("ModelRef must be a Protobuf deployment reference");
+    const name = nonblank(candidate.name?.value ?? "", "ModelRef.name");
+    const revision = nonblank(candidate.revision?.value ?? "", "ModelRef.revision");
+    return `${String(name.length)}:${name}${String(revision.length)}:${revision}`;
+};
+/**
+ * Copies validated, explicitly configured operation limits.
+ *
+ * @param limits Caller-supplied mutable limits.
+ * @param kind Capability kind.
+ * @returns Immutable configured limits with absent ceilings preserved.
+ */
+const copyLimits = (limits, kind) => {
+    if (limits === undefined)
+        return Object.freeze({});
+    const supplied = limits;
+    if (typeof supplied !== "object" || supplied === null)
+        throw new TypeError("limits must be an object");
+    const copy = {
+        ...(limits.modelRequests === undefined
+            ? {}
+            : { modelRequests: positiveInteger(limits.modelRequests, "modelRequests") }),
+        ...(limits.toolCalls === undefined
+            ? {}
+            : { toolCalls: positiveInteger(limits.toolCalls, "toolCalls", true) }),
+        ...(limits.deadlineMs === undefined
+            ? {}
+            : { deadlineMs: positiveInteger(limits.deadlineMs, "deadlineMs") }),
+        ...(limits.maxInputBytes === undefined
+            ? {}
+            : { maxInputBytes: positiveInteger(limits.maxInputBytes, "maxInputBytes") }),
+        ...(limits.maxOutputBytes === undefined
+            ? {}
+            : { maxOutputBytes: positiveInteger(limits.maxOutputBytes, "maxOutputBytes") }),
+        ...(limits.maxOutputTokens !== undefined
+            ? { maxOutputTokens: positiveInteger(limits.maxOutputTokens, "maxOutputTokens") }
+            : {}),
+    };
+    if (kind === "decision" && copy.maxOutputTokens !== undefined)
+        throw new TypeError("decision maxOutputTokens is unsupported");
+    if (kind === "decision" && copy.toolCalls !== undefined && copy.toolCalls !== 0)
+        throw new TypeError("decision toolCalls must be zero");
+    return Object.freeze(copy);
+};
+/**
+ * Copies application tool references without retaining mutable arrays.
+ *
+ * @param tools Configured references, if any.
+ * @returns Immutable deduplicated references.
+ */
+const copyTools = (tools) => {
+    const keys = new Set();
+    return Object.freeze((tools ?? []).map((tool) => {
+        const server = nonblank(tool.server, "tool.server");
+        const name = nonblank(tool.tool, "tool.tool");
+        const key = `${String(server.length)}:${server}${String(name.length)}:${name}`;
+        if (keys.has(key))
+            throw new TypeError("Duplicate tool reference");
+        keys.add(key);
+        return Object.freeze({ server, tool: name });
+    }));
+};
+/**
+ * Copies one declared decision question.
+ *
+ * @param id Question key.
+ * @param question Caller-supplied question.
+ * @returns Immutable question and criteria.
+ */
+const copyQuestion = (id, question) => {
+    nonblank(id, "question ID");
+    const instructions = nonblank(question.instructions, `question ${id} instructions`);
+    if (question.type === "boolean")
+        return Object.freeze({ type: "boolean", instructions });
+    if (question.type === "choice") {
+        const criteria = Object.fromEntries(Object.entries(question.criteria).map(([key, meaning]) => [
+            nonblank(key, `question ${id} choice`),
+            nonblank(meaning, `question ${id} meaning`),
+        ]));
+        if (Object.keys(criteria).length < 2)
+            throw new TypeError(`question ${id} needs two choices`);
+        return Object.freeze({ type: "choice", instructions, criteria: Object.freeze(criteria) });
+    }
+    const kind = question.type;
+    if (kind !== "score")
+        throw new TypeError(`question ${id} has unsupported kind`);
+    const criteria = question.criteria.map((level) => nonblank(level, `question ${id} rubric`));
+    if (criteria.length < 2)
+        throw new TypeError(`question ${id} needs two rubric levels`);
+    return Object.freeze({ type: "score", instructions, criteria: Object.freeze(criteria) });
+};
+/**
+ * Copies and validates shared definition fields.
+ *
+ * @typeParam I - Input message descriptor.
+ * @typeParam O - Output message descriptor.
+ * @param definition Caller-supplied capability.
+ * @returns Shared immutable values.
+ */
+const copyBase = (definition) => {
+    const input = definition.input;
+    const output = definition.output;
+    if (input?.kind !== "message" ||
+        output?.kind !== "message")
+        throw new TypeError("input and output must be Protobuf message schemas");
+    const validation = definition.validation;
+    if (validation && (typeof validation.check !== "function" || !validation.version.trim()))
+        throw new TypeError("validation needs a version and check callback");
+    return {
+        name: nonblank(definition.name, "name"),
+        version: nonblank(definition.version, "version"),
+        input: definition.input,
+        output: definition.output,
+        limits: copyLimits(definition.limits, definition.kind),
+        ...(validation ? { validation: Object.freeze({ ...validation }) } : {}),
+    };
+};
+/**
+ * Copies one validated generation or decision declaration.
+ *
+ * @typeParam I - Input message descriptor.
+ * @typeParam O - Output message descriptor.
+ * @param definition Caller-supplied capability.
+ * @returns Immutable definition snapshot.
+ */
+const copyDecision = (definition) => {
+    const mapping = definition.mapping;
+    if (typeof mapping !== "object" ||
+        mapping === null ||
+        typeof mapping.toMessage !== "function")
+        throw new TypeError("decision mapping is required");
+    const questions = Object.fromEntries(Object.entries(definition.questions).map(([id, question]) => [id, copyQuestion(id, question)]));
+    if (Object.keys(questions).length === 0)
+        throw new TypeError("decision questions are required");
+    return Object.freeze({
+        ...copyBase(definition),
+        kind: "decision",
+        questions: Object.freeze(questions),
+        requireProbabilities: definition.requireProbabilities ?? false,
+        requireIndependentQuestions: definition.requireIndependentQuestions ?? false,
+        mapping: Object.freeze({
+            version: nonblank(definition.mapping.version, "mapping.version"),
+            toMessage: definition.mapping.toMessage,
+        }),
+    });
+};
+/**
+ * Copies a validated capability definition.
+ *
+ * @typeParam I - Input message descriptor.
+ * @typeParam O - Output message descriptor.
+ * @param definition Caller-supplied capability.
+ * @returns Immutable definition snapshot.
+ */
+const copyDefinition = (definition) => {
+    if (definition.kind === "generation") {
+        const mode = definition.outputMode;
+        if (mode !== "native-schema" && mode !== "prompt-and-validate")
+            throw new TypeError("outputMode is unsupported");
+        deriveOutputSchema(definition.output);
+        return Object.freeze({
+            ...copyBase(definition),
+            kind: "generation",
+            instructions: nonblank(definition.instructions, "instructions"),
+            outputMode: definition.outputMode,
+            tools: copyTools(definition.tools),
+        });
+    }
+    const kind = definition.kind;
+    if (kind !== "decision")
+        throw new TypeError("model kind is unsupported");
+    return copyDecision(definition);
+};
+/**
+ * Defines factory-created capabilities independent of model connections.
+ */
+export const AiModel = {
+    /**
+     * Validates and snapshots a typed application capability.
+     *
+     * @typeParam I - Input message descriptor.
+     * @typeParam O - Output message descriptor.
+     * @param definition Generation or decision configuration.
+     * @returns Immutable factory-created capability.
+     */
+    define(definition) {
+        const model = Object.freeze({
+            [aiModelBrand]: true,
+            definition: copyDefinition(definition),
+        });
+        models.add(model);
+        return model;
+    },
+};
+/**
+ * Maps a validated decision result with its declared pure function.
+ *
+ * @typeParam I - Input message descriptor.
+ * @typeParam O - Output message descriptor.
+ * @param model Decision capability.
+ * @param answers Validated answers.
+ * @param input Validated typed input.
+ * @returns Typed application output.
+ */
+export const mapDecision = (model, answers, input) => {
+    const definition = model.definition;
+    if (definition.kind !== "decision")
+        throw new TypeError("decision capability required");
+    return definition.mapping.toMessage(answers, input);
+};
+//# sourceMappingURL=model.js.map

package/dist/internal/model.js.map

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

package/dist/internal/registration.d.ts

@@ -0,0 +1,102 @@
+import type { MessageSchema } from "@spine-event-engine/core";
+import type { ModelRef } from "@spine-event-engine/proto/agent";
+import type { AiConnectionIdentity, AiControl, AiModelDefinition, AiScope } from "./contracts.js";
+import type { AiBackendExecution, AiBackendOutcome, AiExecutionControl } from "./execution.js";
+import type { AiMcpProtocolFactory } from "./mcp-protocol.js";
+declare const aiBackendBrand: unique symbol;
+/**
+ * Adapter-created deployment admitted to an application registry.
+ */
+export interface AiBackendRegistration {
+    /**
+     * Private marker carried only by an adapter-created backend registration.
+     */
+    readonly [aiBackendBrand]: true;
+    /**
+     * Credential-free deployment reference.
+     */
+    readonly ref: ModelRef;
+    /**
+     * Declared generation or decision kind.
+     */
+    readonly kind: "generation" | "decision";
+}
+/**
+ * SDK-free adapter registration boundary used by optional integrations.
+ */
+export interface AiBackendDefinition {
+    /**
+     * Optional protocol factory used by this backend's registered MCP tools.
+     */
+    readonly mcp?: AiMcpProtocolFactory;
+    /**
+     * Credential-free deployment reference.
+     */
+    readonly ref: ModelRef;
+    /**
+     * Declared generation or decision kind.
+     */
+    readonly kind: "generation" | "decision";
+    /**
+     * Checks whether a deployment supports the declared capability.
+     *
+     * @param definition Typed capability requested by this registration.
+     * @returns Whether the deployment can perform the capability.
+     */
+    readonly supports: (definition: Readonly<AiModelDefinition<MessageSchema, MessageSchema>>) => boolean;
+    /**
+     * Resolves the credential-free identity before dispatch.
+     *
+     * @param scope Authenticated application scope.
+     * @param control Deadline and cancellation controls.
+     * @returns Credential-free backend identity.
+     */
+    resolveIdentity(scope: AiScope, control: AiControl): AiConnectionIdentity | Promise<AiConnectionIdentity>;
+    /**
+     * Checks authorization for one use of the resolved backend identity.
+     *
+     * @param scope Authenticated application scope.
+     * @param identity Resolved backend identity.
+     * @param control Deadline and cancellation controls.
+     * @returns Whether the backend use is authorized.
+     */
+    authorizeUse(scope: AiScope, identity: AiConnectionIdentity, control: AiControl): boolean | Promise<boolean>;
+    /**
+     * Connects after identity and policy checks.
+     *
+     * @param scope Authenticated application scope.
+     * @param expectedIdentity Previously resolved backend identity.
+     * @param control Deadline and cancellation controls.
+     * @returns Opaque model and checked connection identity.
+     */
+    connect(scope: AiScope, expectedIdentity: AiConnectionIdentity, control: AiExecutionControl): {
+        readonly model: unknown;
+        readonly identity: AiConnectionIdentity;
+    } | Promise<{
+        readonly model: unknown;
+        readonly identity: AiConnectionIdentity;
+    }>;
+    /**
+     * Executes one selected capability through fenced runtime controls.
+     *
+     * @param request Authenticated connection, typed capability, and runtime controls.
+     * @returns Admitted output or safe operational failure.
+     */
+    execute(request: AiBackendExecution): Promise<AiBackendOutcome>;
+}
+/**
+ * Creates a factory-proven deployment for the optional adapter.
+ *
+ * @param definition Static capability and trusted connection callbacks.
+ * @returns Immutable registration.
+ */
+export declare const createBackendRegistration: (definition: AiBackendDefinition) => AiBackendRegistration;
+/**
+ * Reads the original adapter definition after runtime provenance validation.
+ *
+ * @param registration Candidate registration.
+ * @returns Frozen adapter callbacks and reference.
+ */
+export declare const backendDefinition: (registration: AiBackendRegistration) => AiBackendDefinition;
+export {};
+//# sourceMappingURL=registration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../src/internal/registration.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAElG,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,QAAA,MAAM,cAAc,EAAE,OAAO,MAAiC,CAAC;AAG/D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;IAEzC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,CACjB,UAAU,EAAE,QAAQ,CAAC,iBAAiB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,KAClE,OAAO,CAAC;IAEb;;;;;;OAMG;IACH,eAAe,CACb,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,SAAS,GACjB,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAExD;;;;;;;OAOG;IACH,YAAY,CACV,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,SAAS,GACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9B;;;;;;;OAOG;IACH,OAAO,CACL,KAAK,EAAE,OAAO,EACd,gBAAgB,EAAE,oBAAoB,EACtC,OAAO,EAAE,kBAAkB,GAEzB;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;KAAE,GACpE,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;KAAE,CAAC,CAAC;IAElF;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACjE;AAED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GACpC,YAAY,mBAAmB,KAC9B,qBAyBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,cAAc,qBAAqB,KAAG,mBAQvE,CAAC"}

package/dist/internal/registration.js

@@ -0,0 +1,65 @@
+/*
+ * 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 { modelRefKey, nonblank } from "./model.js";
+const aiBackendBrand = Symbol("SpineAiBackend");
+const backendDefinitions = new WeakMap();
+/**
+ * Creates a factory-proven deployment for the optional adapter.
+ *
+ * @param definition Static capability and trusted connection callbacks.
+ * @returns Immutable registration.
+ */
+export const createBackendRegistration = (definition) => {
+    modelRefKey(definition.ref);
+    const kind = definition.kind;
+    if (kind !== "generation" && kind !== "decision")
+        throw new TypeError("backend kind is unsupported");
+    for (const name of ["supports", "resolveIdentity", "authorizeUse", "connect", "execute"])
+        if (typeof definition[name] !== "function")
+            throw new TypeError(`${name} callback is required`);
+    const ref = Object.freeze({
+        ...definition.ref,
+        name: Object.freeze({
+            ...definition.ref.name,
+            value: nonblank(definition.ref.name?.value ?? "", "name"),
+        }),
+        revision: Object.freeze({
+            ...definition.ref.revision,
+            value: nonblank(definition.ref.revision?.value ?? "", "revision"),
+        }),
+    });
+    const registration = Object.freeze({
+        [aiBackendBrand]: true,
+        ref,
+        kind: definition.kind,
+    });
+    backendDefinitions.set(registration, Object.freeze({ ...definition, ref }));
+    return registration;
+};
+/**
+ * Reads the original adapter definition after runtime provenance validation.
+ *
+ * @param registration Candidate registration.
+ * @returns Frozen adapter callbacks and reference.
+ */
+export const backendDefinition = (registration) => {
+    const candidate = registration;
+    const definition = typeof candidate === "object" && candidate !== null
+        ? backendDefinitions.get(candidate)
+        : undefined;
+    if (!definition)
+        throw new TypeError("backend registration must come from a factory");
+    return definition;
+};
+//# sourceMappingURL=registration.js.map

package/dist/internal/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../src/internal/registration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAInD,MAAM,cAAc,GAAkB,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAC/D,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAA+B,CAAC;AAsGtE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,UAA+B,EACR,EAAE;IACzB,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAY,UAAU,CAAC,IAAI,CAAC;IACtC,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,UAAU;QAC9C,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,CAAU;QAC/F,IAAI,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,uBAAuB,CAAC,CAAC;IAClG,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,GAAG,UAAU,CAAC,GAAG;QACjB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI;YACtB,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,EAAE,MAAM,CAAC;SAC1D,CAAC;QACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ;YAC1B,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,EAAE,UAAU,CAAC;SAClE,CAAC;KACH,CAAa,CAAC;IACf,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;QACjC,CAAC,cAAc,CAAC,EAAE,IAAa;QAC/B,GAAG;QACH,IAAI,EAAE,UAAU,CAAC,IAAI;KACtB,CAAC,CAAC;IACH,kBAAkB,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5E,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,YAAmC,EAAuB,EAAE;IAC5F,MAAM,SAAS,GAAY,YAAY,CAAC;IACxC,MAAM,UAAU,GACd,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI;QACjD,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC;QACnC,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IACtF,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC"}