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

package/dist/internal/contracts.d.ts

@@ -0,0 +1,648 @@
+import type { MessageShape } from "@bufbuild/protobuf";
+import type { MessageSchema } from "@spine-event-engine/core";
+import type { AiModelKind, AiOperationId, AgentHistoryCursor, ConversationId, ModelRef } from "@spine-event-engine/proto/agent";
+import type { ActorContext, MessageId, TenantId } from "@spine-event-engine/proto";
+import type { AiModel } from "./model.js";
+/**
+ * Optional application ceilings for one capability, including corrections and tool continuations.
+ * An absent field does not impose that ceiling.
+ */
+export interface AiLimits {
+    /**
+     * Maximum physical provider requests.
+     */
+    readonly modelRequests?: number;
+    /**
+     * Maximum external tool calls.
+     */
+    readonly toolCalls?: number;
+    /**
+     * Maximum elapsed milliseconds.
+     */
+    readonly deadlineMs?: number;
+    /**
+     * Maximum bytes in one materialized request.
+     */
+    readonly maxInputBytes?: number;
+    /**
+     * Maximum received response bytes.
+     */
+    readonly maxOutputBytes?: number;
+    /**
+     * Optional generation-only ceiling when the selected deployment can enforce it.
+     */
+    readonly maxOutputTokens?: number;
+}
+/**
+ * Optional application ceilings shared by handlers for one accepted signal.
+ * An absent field does not impose that ceiling.
+ */
+export interface AiInvocationLimits {
+    /**
+     * Maximum model operations for one accepted signal.
+     */
+    readonly operations?: number;
+    /**
+     * Maximum physical provider requests across one accepted signal.
+     */
+    readonly modelRequests?: number;
+    /**
+     * Maximum external tool calls across one accepted signal.
+     */
+    readonly toolCalls?: number;
+    /**
+     * Maximum recorded history reads for one accepted signal.
+     */
+    readonly recordedReads?: number;
+    /**
+     * Maximum elapsed time in milliseconds.
+     */
+    readonly deadlineMs?: number;
+    /**
+     * Maximum cumulative input bytes for one accepted signal.
+     */
+    readonly totalInputBytes?: number;
+    /**
+     * Maximum cumulative output bytes for one accepted signal.
+     */
+    readonly totalOutputBytes?: number;
+    /**
+     * Maximum bytes retained for replay after interruption.
+     */
+    readonly maxRecoveryBytes?: number;
+}
+/**
+ * A concrete local defect that may inform a bounded generation correction.
+ */
+export interface AiValidationIssue {
+    /**
+     * Safe failure or validation category.
+     */
+    readonly code: string;
+    /**
+     * Field path affected by this issue.
+     */
+    readonly path: string;
+    /**
+     * Safe validation message for application handling.
+     */
+    readonly message: string;
+}
+/**
+ * Reference to one expressly permitted MCP tool.
+ */
+export interface AiToolRef {
+    /**
+     * MCP server identifier selected by the application.
+     */
+    readonly server: string;
+    /**
+     * Exact permitted MCP tool name.
+     */
+    readonly tool: string;
+}
+/**
+ * Shared typed capability definition.
+ *
+ * @typeParam I - Input message descriptor.
+ * @typeParam O - Output message descriptor.
+ */
+export interface AiModelBase<I extends MessageSchema, O extends MessageSchema> {
+    /**
+     * Application capability or deployment name.
+     */
+    readonly name: string;
+    /**
+     * Version of this application capability definition.
+     */
+    readonly version: string;
+    /**
+     * Generated Protobuf descriptor for typed input.
+     */
+    readonly input: I;
+    /**
+     * Generated Protobuf descriptor for typed output.
+     */
+    readonly output: O;
+    /**
+     * Optional application bounds for this capability.
+     */
+    readonly limits?: AiLimits;
+    /**
+     * Versioned pure application validation rule.
+     */
+    readonly validation?: {
+        /**
+         * Version of the application output validation rule.
+         */
+        readonly version: string;
+        /**
+         * Applies a pure application rule to candidate output and invocation facts.
+         *
+         * @param value Candidate output after Proto validation.
+         * @param input Application facts supplied to the invocation.
+         * @returns Domain validation issues, or an empty list when valid.
+         */
+        check(value: MessageShape<O>, input: MessageShape<I>): readonly AiValidationIssue[];
+    };
+}
+/**
+ * Question evaluated by a non-generative backend.
+ */
+export type AiQuestion = {
+    /**
+     * Boolean proposition kind.
+     */
+    readonly type: "boolean";
+    /**
+     * Proposition the backend evaluates.
+     */
+    readonly instructions: string;
+} | {
+    /**
+     * Choice question kind.
+     */
+    readonly type: "choice";
+    /**
+     * Application instructions supplied to the model.
+     */
+    readonly instructions: string;
+    /**
+     * Named alternatives available to this choice.
+     */
+    readonly criteria: Readonly<Record<string, string>>;
+} | {
+    /**
+     * Score question kind.
+     */
+    readonly type: "score";
+    /**
+     * Application instructions supplied to the model.
+     */
+    readonly instructions: string;
+    /**
+     * Ordered score levels, starting at zero.
+     */
+    readonly criteria: readonly string[];
+};
+/**
+ * Provider answer after kind and range validation; absence means unknown.
+ */
+export type AiAnswer = {
+    /**
+     * Boolean answer kind.
+     */
+    readonly type: "boolean";
+    /**
+     * Probability that the proposition is true.
+     */
+    readonly probability: number;
+} | {
+    /**
+     * Choice answer kind.
+     */
+    readonly type: "choice";
+    /**
+     * Selected declared alternative key.
+     */
+    readonly choice: string;
+    /**
+     * Full distribution over declared alternatives when reported.
+     */
+    readonly probabilities?: Readonly<Record<string, number>>;
+    /**
+     * Separate provider confidence when reported.
+     */
+    readonly confidence?: number;
+} | {
+    /**
+     * Score answer kind.
+     */
+    readonly type: "score";
+    /**
+     * Fractional score within the declared rubric.
+     */
+    readonly score: number;
+    /**
+     * Full distribution over declared alternatives when reported.
+     */
+    readonly probabilities?: Readonly<Record<string, number>>;
+    /**
+     * Separate provider confidence when reported.
+     */
+    readonly confidence?: number;
+};
+/**
+ * Exactly the answers keyed by declared question IDs.
+ */
+export interface AiDecisionResult {
+    /**
+     * Answers keyed by the original question IDs.
+     */
+    readonly answers: Readonly<Record<string, AiAnswer>>;
+}
+/**
+ * One application-defined generation or decision capability.
+ *
+ * @typeParam I - Input message descriptor.
+ * @typeParam O - Output message descriptor.
+ */
+export type AiModelDefinition<I extends MessageSchema, O extends MessageSchema> = AiModelBase<I, O> & ({
+    /**
+     * Generative capability kind.
+     */
+    readonly kind: "generation";
+    /**
+     * Application instructions supplied to the model.
+     */
+    readonly instructions: string;
+    /**
+     * Structured generation mode fixed before dispatch.
+     */
+    readonly outputMode: "native-schema" | "prompt-and-validate";
+    /**
+     * Explicitly permitted tool references or policies.
+     */
+    readonly tools?: readonly AiToolRef[];
+} | {
+    /**
+     * Non-generative decision capability kind.
+     */
+    readonly kind: "decision";
+    /**
+     * Questions keyed by application-defined IDs.
+     */
+    readonly questions: Readonly<Record<string, AiQuestion>>;
+    /**
+     * Whether every non-boolean answer must include a full distribution.
+     */
+    readonly requireProbabilities?: boolean;
+    /**
+     * Whether the backend must evaluate questions independently.
+     */
+    readonly requireIndependentQuestions?: boolean;
+    /**
+     * Versioned pure decision-to-Protobuf mapping.
+     */
+    readonly mapping: {
+        /**
+         * Version of the decision-to-output mapping rule.
+         */
+        readonly version: string;
+        /**
+         * Maps validated decision answers to typed application output.
+         *
+         * @param result Validated provider answers.
+         * @param input Application facts supplied to this invocation.
+         * @returns Typed application output.
+         */
+        readonly toMessage: (result: AiDecisionResult, input: MessageShape<I>) => MessageShape<O>;
+    };
+});
+/**
+ * Safe operational failure that an Agent may turn into a domain outcome.
+ */
+export interface AiFailure {
+    /**
+     * Safe failure or validation category.
+     */
+    readonly code: "INVALID_INPUT" | "UNSUPPORTED_CAPABILITY" | "AUTHENTICATION_REQUIRED" | "RATE_LIMITED" | "UNAVAILABLE" | "REFUSED" | "INVALID_OUTPUT" | "BUDGET_EXCEEDED" | "TOOL_FAILED" | "TOOL_OUTCOME_UNKNOWN" | "CANCELLED" | "DEADLINE_EXCEEDED";
+    /**
+     * Whether a later accepted signal may retry this failure.
+     */
+    readonly retryableByNewSignal: boolean;
+    /**
+     * Safe diagnostic reference without provider secrets.
+     */
+    readonly diagnosticId: string;
+}
+/**
+ * Validated output or recorded operational failure.
+ *
+ * @typeParam T - Validated application output.
+ */
+export type AiResult<T> = {
+    /**
+     * Indicates a validated result was admitted.
+     */
+    readonly ok: true;
+    /**
+     * Validated typed application output.
+     */
+    readonly value: T;
+    /**
+     * Logical operation covering all physical attempts.
+     */
+    readonly operationId: AiOperationId;
+} | {
+    /**
+     * Indicates no result was admitted.
+     */
+    readonly ok: false;
+    /**
+     * Safe operational failure category and diagnostic reference.
+     */
+    readonly failure: AiFailure;
+    /**
+     * Logical operation covering all physical attempts.
+     */
+    readonly operationId: AiOperationId;
+};
+/**
+ * Model operations available only inside an Agent signal handler.
+ */
+export interface AgentAi {
+    /**
+     * Invokes a typed capability for a named Agent call.
+     *
+     * @typeParam I - Input message descriptor.
+     * @typeParam O - Output message descriptor.
+     * @param model Capability registered for this repository.
+     * @param request Named call, explicit conversation and typed facts.
+     * @returns Validated output or bounded operational failure.
+     */
+    invoke<I extends MessageSchema, O extends MessageSchema>(model: AiModel<I, O>, request: {
+        /**
+         * Invocation name used to identify this call.
+         */
+        readonly call: string;
+        /**
+         * Conversation in which this invocation occurs.
+         */
+        readonly conversation: ConversationId;
+        /**
+         * Validated application input facts for this invocation.
+         */
+        readonly input: MessageShape<I>;
+    }): Promise<AiResult<MessageShape<O>>>;
+    /**
+     * Sets a deployment preference for later signals.
+     *
+     * @param kind Generation or decision kind.
+     * @param model Explicit deployment or inheritance when absent.
+     */
+    select(kind: AiModelKind, model: ModelRef | undefined): void;
+}
+/**
+ * Cancellation and deadline supplied to each asynchronous callback.
+ */
+export interface AiControl {
+    /**
+     * Cancellation signal for this callback.
+     */
+    readonly signal: AbortSignal;
+    /**
+     * Absolute deadline in Unix milliseconds.
+     */
+    readonly deadlineEpochMs?: number;
+}
+/**
+ * Trusted selection and authorization scope from an accepted signal.
+ */
+export interface AiScope {
+    /**
+     * Authenticated actor from the accepted signal.
+     */
+    readonly actor: ActorContext;
+    /**
+     * Tenant scope established for the accepted signal.
+     */
+    readonly tenant: {
+        readonly kind: "tenant";
+        readonly id: TenantId;
+    } | {
+        readonly kind: "single-tenant";
+    };
+    /**
+     * Canonical Agent instance identity.
+     */
+    readonly agent: MessageId;
+    /**
+     * Canonical source signal identity.
+     */
+    readonly source: MessageId;
+}
+/**
+ * Non-secret identity of an authenticated model connection.
+ */
+export interface AiConnectionIdentity {
+    /**
+     * Authenticated provider or local service name.
+     */
+    readonly provider: string;
+    /**
+     * Verified provider account or local execution identity.
+     */
+    readonly account: string;
+    /**
+     * Credential-free canonical endpoint identity.
+     */
+    readonly endpoint: string;
+    /**
+     * Concrete provider model identity or selected deployment.
+     */
+    readonly model: string;
+}
+/**
+ * Optional per-kind deployment defaults.
+ */
+export interface AiDefaultModels {
+    /**
+     * Application generation default, when configured.
+     */
+    readonly generation?: ModelRef;
+    /**
+     * Application decision default, when configured.
+     */
+    readonly decision?: ModelRef;
+}
+/**
+ * Application-wide registry limits and defaults.
+ */
+export interface AiRegistryOptions {
+    /**
+     * Application-wide model preferences by capability kind.
+     */
+    readonly defaultModels: AiDefaultModels;
+    /**
+     * Bounds shared by all handlers for one accepted signal.
+     */
+    readonly invocationLimits?: AiInvocationLimits;
+    /**
+     * Maximum concurrent Agent signal executions sharing this registry object.
+     * A slot covers the handlers and completion, including saved-output delivery.
+     * This limit applies within one process.
+     */
+    readonly concurrentOperations?: number;
+    /**
+     * Maximum additional Agent executions waiting in memory for a slot.
+     * Further accepted signals remain in durable storage until capacity is available.
+     */
+    readonly queuedOperations?: number;
+    /**
+     * Maximum duration allowed for an application callback.
+     */
+    readonly hookTimeoutMs?: number;
+}
+/**
+ * Selects one newest-first page from the current Agent's history.
+ */
+export interface HistoryRead {
+    /**
+     * Positive safe number of requested items.
+     */
+    readonly pageSize: number;
+    /**
+     * Opaque continuation from the preceding page.
+     */
+    readonly cursor?: AgentHistoryCursor;
+}
+/**
+ * Selects one conversation within the current Agent.
+ */
+export interface ConversationHistoryRead extends HistoryRead {
+    /**
+     * Explicitly identified conversation.
+     */
+    readonly conversation: ConversationId;
+}
+/**
+ * Newest-first page with an optional continuation toward older items.
+ *
+ * @typeParam T - History item type.
+ */
+export interface HistoryPage<T> {
+    /**
+     * Entries returned by this read.
+     */
+    readonly items: readonly T[];
+    /**
+     * Opaque continuation when older entries remain.
+     */
+    readonly nextCursor?: AgentHistoryCursor;
+}
+/**
+ * JSON values admitted for MCP arguments.
+ */
+export type AiJson = null | boolean | number | string | readonly AiJson[] | {
+    readonly [name: string]: AiJson;
+};
+/**
+ * Validated tool call presented to application authorization.
+ */
+export interface AiToolCall {
+    /**
+     * Exact permitted MCP tool name.
+     */
+    readonly tool: AiToolRef;
+    /**
+     * Validated JSON arguments supplied to the tool.
+     */
+    readonly arguments: Readonly<Record<string, AiJson>>;
+}
+/**
+ * Application policy for one permitted tool.
+ */
+export interface McpToolPolicy {
+    /**
+     * Application-established read or write effect.
+     */
+    readonly effect: "read" | "write";
+    /**
+     * Optional application maximum time for one tool call.
+     */
+    readonly timeoutMs?: number;
+    /**
+     * Optional application maximum encoded tool argument bytes.
+     */
+    readonly maxArgumentBytes?: number;
+    /**
+     * Optional application maximum received tool result bytes.
+     */
+    readonly maxResultBytes?: number;
+    /**
+     * Checks application permission for one tool call.
+     *
+     * @param scope Authenticated tenant and actor context.
+     * @param call Validated MCP tool name and arguments.
+     * @param control Cancellation and deadline controls.
+     * @returns Whether the application permits this tool call.
+     */
+    readonly authorize: (scope: AiScope, call: AiToolCall, control: AiControl) => boolean | Promise<boolean>;
+}
+/**
+ * Application-selected remote or local MCP transport.
+ */
+export type McpTransport = {
+    /**
+     * Streamable HTTP transport kind.
+     */
+    readonly kind: "streamable-http";
+    /**
+     * Absolute streamable HTTP endpoint without credentials.
+     */
+    readonly url: string;
+    /**
+     * Returns scoped HTTP headers for one MCP connection.
+     *
+     * @param scope Authenticated tenant and actor context.
+     * @param control Cancellation and deadline controls.
+     * @returns Headers for this scoped connection.
+     */
+    readonly headers?: (scope: AiScope, control: AiControl) => Readonly<Record<string, string>> | Promise<Readonly<Record<string, string>>>;
+} | {
+    /**
+     * Local stdio transport kind.
+     */
+    readonly kind: "stdio";
+    /**
+     * Absolute path to the local MCP executable.
+     */
+    readonly executable: string;
+    /**
+     * Fixed executable arguments.
+     */
+    readonly args: readonly string[];
+    /**
+     * Optional absolute working directory.
+     */
+    readonly cwd?: string;
+    /**
+     * Returns scoped environment variables for one local process.
+     *
+     * @param scope Authenticated tenant and actor context.
+     * @param control Cancellation and deadline controls.
+     * @returns Environment variables for this scoped process.
+     */
+    readonly environment?: (scope: AiScope, control: AiControl) => Readonly<Record<string, string>> | Promise<Readonly<Record<string, string>>>;
+};
+/**
+ * Explicit MCP connection and tool policy.
+ */
+export interface McpServerDefinition {
+    /**
+     * Validated MCP server identifier.
+     */
+    readonly id: string;
+    /**
+     * Configuration revision pinned to this registration.
+     */
+    readonly revision: string;
+    /**
+     * Validated HTTP or local process connection settings.
+     */
+    readonly transport: McpTransport;
+    /**
+     * Checks application permission to connect to the MCP server.
+     *
+     * @param scope Authenticated tenant and actor context.
+     * @param control Cancellation and deadline controls.
+     * @returns Whether this scope may connect to the MCP server.
+     */
+    readonly authorizeConnect: (scope: AiScope, control: AiControl) => boolean | Promise<boolean>;
+    /**
+     * Explicitly permitted tool references or policies.
+     */
+    readonly tools: Readonly<Record<string, McpToolPolicy>>;
+}
+//# sourceMappingURL=contracts.d.ts.map

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

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

package/dist/internal/contracts.js

@@ -0,0 +1,15 @@
+/*
+ * 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.
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/internal/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/internal/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}