@accordproject/template-engine 3.1.0 → 4.2.1

package/lib/llm/LLMConfig.js

@@ -0,0 +1,30 @@
+"use strict";
+/*
+ * 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
+ *
+ * http://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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ANTHROPIC_EFFORT_LEVELS = exports.OPENAI_EFFORT_LEVELS = exports.GROQ_EFFORT_LEVELS = void 0;
+/** Effort levels the Groq API accepts. */
+exports.GROQ_EFFORT_LEVELS = ['none', 'low', 'medium', 'high'];
+/**
+ * Effort levels the OpenAI Chat Completions API accepts. Only reasoning models
+ * take the parameter at all — a non-reasoning model (e.g. `gpt-4o`) rejects it.
+ */
+exports.OPENAI_EFFORT_LEVELS = ['minimal', 'low', 'medium', 'high'];
+/**
+ * Effort levels the Anthropic Messages API accepts (GA, no beta header).
+ * Supported on Opus 4.5+ and Sonnet 5; `xhigh` arrived with Opus 4.7, and
+ * Sonnet 4.5 / Haiku 4.5 reject the parameter entirely.
+ */
+exports.ANTHROPIC_EFFORT_LEVELS = ['low', 'medium', 'high', 'xhigh', 'max'];
+//# sourceMappingURL=LLMConfig.js.map

package/lib/llm/LLMConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMConfig.js","sourceRoot":"","sources":["../../src/llm/LLMConfig.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAIH,0CAA0C;AAC7B,QAAA,kBAAkB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAI7E;;;GAGG;AACU,QAAA,oBAAoB,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAIlF;;;;GAIG;AACU,QAAA,uBAAuB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAU,CAAC"}

package/lib/llm/LLMExecutor.d.ts

@@ -0,0 +1,77 @@
+import { Template } from '@accordproject/cicero-core';
+import { LLMExecutorConfig } from './LLMConfig';
+import type { TriggerResponse, InitResponse } from '../TemplateArchiveProcessor';
+/**
+ * Executes an Accord Project template's `init` / `trigger` operations using an
+ * LLM, deriving the request/response/state/event schemas from the template's own
+ * ModelManager. Used as a fallback when a template carries no executable logic,
+ * or when LLM execution is explicitly forced.
+ */
+export declare class LLMExecutor {
+    /** The template being executed. */
+    private readonly template;
+    private readonly config;
+    private readonly reasoner;
+    private readonly fullSchema;
+    /**
+     * True when the schema defines no custom State type (only the base runtime
+     * State).  Stateless templates return `{}` from init and omit `state` from
+     * trigger responses entirely.
+     */
+    private readonly stateless;
+    /** Schema instances are per-executor so the object reference is stable for
+     *  Anthropic's 24-hour grammar cache (same object = cache hit).
+     *  For full-schema providers the defs are derived from the template's own
+     *  ModelManager via tree-shaking — no external schema.json required. */
+    private readonly initSchema;
+    private readonly triggerSchema;
+    private readonly roots;
+    private readonly promptSchema;
+    /**
+     * Creates an executor for a template.
+     * @param template - template to execute
+     * @param config - LLM configuration
+     */
+    constructor(template: Template, config: LLMExecutorConfig);
+    /**
+     * Builds the shared prompt context.
+     * @returns prompt context
+     */
+    private buildSharedContext;
+    /**
+     * Sends a request to the active reasoner with retries.
+     * @param messages - the chat messages to send
+     * @param schema - the JSON Schema the response must satisfy
+     * @returns the model response content
+     * @throws the last error if every attempt fails
+     */
+    private ask;
+    /**
+     * Computes the initial contract state.
+     * @param data - the data for the template
+     * @param currentTime - the current time, defaults to now
+     * @param utcOffset - the UTC offset, defaults to zero
+     * @returns the new state
+     */
+    init(data: any, currentTime?: string, utcOffset?: number): Promise<InitResponse>;
+    /**
+     * Evaluates a trigger request.
+     *
+     * Stateful templates (`!this.stateless`) must always be evaluated against
+     * `priorState` — the state produced by a prior call to {@link init} (or by
+     * a prior call to `trigger`) — since there is no implicit "empty" state for
+     * a template that declares custom State fields. Stateless templates ignore
+     * `priorState` entirely.
+     * @param data - the data for the template
+     * @param request - the request to send to the contract logic
+     * @param priorState - the state to evaluate the request against. Required
+     * for stateful templates (must originate from init() or a previous
+     * trigger()); ignored for stateless templates.
+     * @param currentTime - the current time. Only used when the request carries
+     * no `$timestamp`, which always takes precedence; defaults to now
+     * @param utcOffset - the UTC offset, defaults to zero
+     * @returns the response, updated state, and any events
+     * @throws {Error} if the template is stateful and no priorState is supplied
+     */
+    trigger(data: any, request: any, priorState?: any, currentTime?: string, utcOffset?: number): Promise<TriggerResponse>;
+}