@spine-event-engine/server 2.0.0-snapshot.22 → 2.0.0-snapshot.23

package/dist/agent/agent-ai-binding.d.ts

@@ -0,0 +1,24 @@
+import type { AgentAi } from "@spine-event-engine/ai";
+interface AgentAiBindingAccess {
+    /**
+     * Attaches one handler-scoped facade and returns its release.
+     *
+     * @param agent Active Agent instance receiving the facade.
+     * @param ai Fenced facade for this handler invocation.
+     * @returns Callback that releases this exact binding.
+     */
+    bind(agent: object, ai: AgentAi): () => void;
+    /**
+     * Returns the facade attached to the active handler.
+     *
+     * @param agent Active Agent instance whose binding is required.
+     * @returns Handler-scoped facade or throws when none is bound.
+     */
+    require(agent: object): AgentAi;
+}
+/**
+ * Binds the protected Agent AI facade only during one selected handler scope.
+ */
+export declare const AgentAiBindings: AgentAiBindingAccess;
+export {};
+//# sourceMappingURL=agent-ai-binding.d.ts.map

package/dist/agent/agent-ai-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ai-binding.d.ts","sourceRoot":"","sources":["../../src/agent/agent-ai-binding.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAItD,UAAU,oBAAoB;IAC5B;;;;;;OAMG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,IAAI,CAAC;IAE7C;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,oBA2B5B,CAAC"}

package/dist/agent/agent-ai-binding.js

@@ -0,0 +1,48 @@
+/*
+ * 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.
+ */
+const bindings = new WeakMap();
+/**
+ * Binds the protected Agent AI facade only during one selected handler scope.
+ */
+export const AgentAiBindings = Object.freeze({
+    /**
+     * Attaches a facade and returns an idempotent release operation.
+     *
+     * @param agent Active Agent instance.
+     * @param ai Fenced invocation facade.
+     * @returns Release of this exact binding.
+     */
+    bind(agent, ai) {
+        if (bindings.has(agent))
+            throw new Error("Agent AI is already bound to an active handler.");
+        bindings.set(agent, ai);
+        return () => {
+            if (bindings.get(agent) === ai)
+                bindings.delete(agent);
+        };
+    },
+    /**
+     * Returns the facade scoped to this handler.
+     *
+     * @param agent Active Agent instance.
+     * @returns Fenced Agent AI operations.
+     */
+    require(agent) {
+        const ai = bindings.get(agent);
+        if (ai === undefined)
+            throw new Error("Agent AI is available only during a signal handler.");
+        return ai;
+    },
+});
+//# sourceMappingURL=agent-ai-binding.js.map

package/dist/agent/agent-ai-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ai-binding.js","sourceRoot":"","sources":["../../src/agent/agent-ai-binding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAmB,CAAC;AAqBhD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAyB,MAAM,CAAC,MAAM,CAAC;IACjE;;;;;;OAMG;IACH,IAAI,CAAC,KAAa,EAAE,EAAW;QAC7B,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAC5F,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE;gBAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAa;QACnB,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,EAAE,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QAC7F,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC,CAAC"}

package/dist/agent/agent-ai-runtime.d.ts

@@ -0,0 +1,76 @@
+import { type MessageShape } from "@bufbuild/protobuf";
+import { type MessageSchema } from "@spine-event-engine/core";
+import type { AgentAi, AiModel, AiRegistry, AiScope, AiResult, ModelRef } from "@spine-event-engine/ai";
+import { AiModelKind, type ConversationId } from "@spine-event-engine/proto/agent";
+import type { RepositoryAiOptions } from "../repository/repository.js";
+import { AgentExecutionSession } from "./agent-execution-session.js";
+import { AgentInteractionAudit } from "./agent-interaction-audit.js";
+/**
+ * Carries one named typed input within the accepted handler.
+ *
+ * @typeParam I Generated input descriptor.
+ */
+interface InvokeRequest<I extends MessageSchema> {
+    readonly call: string;
+    readonly conversation: ConversationId;
+    readonly input: MessageShape<I>;
+}
+/**
+ * Indicates a saved physical request with no recorded response after recovery.
+ */
+export declare class AgentUncertainAttemptError extends Error {
+    /**
+     * Creates an error that prevents replaying an unresolved physical request.
+     */
+    constructor();
+}
+/**
+ * Provides one handler's named AI calls against a fenced execution journal.
+ */
+export declare class AgentAiRuntime implements AgentAi {
+    #private;
+    private readonly registry;
+    private readonly repository;
+    private readonly scope;
+    private readonly session;
+    private readonly handlerOrdinal;
+    private readonly audit;
+    /**
+     * Binds named calls to the selected repository and fenced invocation.
+     *
+     * @param registry Configured model and MCP registrations.
+     * @param repository Repository model policy.
+     * @param scope Accepted actor, source, Bounded Context, and tenant.
+     * @param session Fenced durable execution session.
+     * @param handlerOrdinal Saved generated handler order.
+     * @param audit Paired Agent history and System Event writer.
+     */
+    constructor(registry: AiRegistry, repository: RepositoryAiOptions, scope: AiScope, session: AgentExecutionSession, handlerOrdinal: number, audit: AgentInteractionAudit | undefined);
+    /**
+     * Returns one saved or newly admitted typed model result.
+     *
+     * @typeParam I Generated input descriptor.
+     * @typeParam O Generated admitted-output descriptor.
+     * @param model Registered capability to invoke.
+     * @param request Named call, conversation, and typed input.
+     * @returns Saved or newly admitted result with its operation identity.
+     */
+    invoke<I extends MessageSchema, O extends MessageSchema>(model: AiModel<I, O>, request: InvokeRequest<I>): Promise<AiResult<MessageShape<O>>>;
+    /**
+     * Sets a preference only for a later accepted signal.
+     *
+     * @param kind Generation or decision selection.
+     * @param model Deployment to prefer for later accepted work.
+     */
+    select(kind: AiModelKind, model: ModelRef | undefined): void;
+    /**
+     * Rejects recovery when the accepted handler no longer issues its saved calls.
+     */
+    finish(): void;
+    /**
+     * Rejects callbacks retained after the generated handler returns.
+     */
+    close(): void;
+}
+export {};
+//# sourceMappingURL=agent-ai-runtime.d.ts.map

package/dist/agent/agent-ai-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ai-runtime.d.ts","sourceRoot":"","sources":["../../src/agent/agent-ai-runtime.ts"],"names":[],"mappings":"AAcA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIhF,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,OAAO,EAGP,OAAO,EACP,UAAU,EACV,OAAO,EACP,QAAQ,EACR,QAAQ,EACT,MAAM,wBAAwB,CAAC;AAkBhC,OAAO,EASL,WAAW,EA2BX,KAAK,cAAc,EACpB,MAAM,iCAAiC,CAAC;AAczC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAKrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAkBrE;;;;GAIG;AACH,UAAU,aAAa,CAAC,CAAC,SAAS,aAAa;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACjC;AAWD;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD;;OAEG;;CAIJ;AAED;;GAEG;AACH,qBAAa,cAAe,YAAW,OAAO;;IAwB1C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAhBxB;;;;;;;;;OASG;gBAEgB,QAAQ,EAAE,UAAU,EACpB,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,qBAAqB,EAC9B,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,qBAAqB,GAAG,SAAS;IAK3D;;;;;;;;OAQG;IACG,MAAM,CAAC,CAAC,SAAS,aAAa,EAAE,CAAC,SAAS,aAAa,EAC3D,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAwDrC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI;IAwB5D;;OAEG;IACH,MAAM,IAAI,IAAI;IAWd;;OAEG;IACH,KAAK,IAAI,IAAI;CA25Cd"}