@ampcode/plugin 0.0.0-20261007001957-g339d9e8 → 0.0.0-20261008001818-g5d841b4

package/README.md

@@ -15,7 +15,8 @@ Plugins can:
   reasoning unless `{ reasoningEffort }` is set
 - **Decide fast** — `amp.ai.decide(...)`, `amp.ai.choice(...)`, `amp.ai.noul(...)`, and
   `amp.ai.score(...)` for typed decisions with calibrated probabilities and no generated text,
-  answered by a decision model (currently TypeSafe's Jev)
+  answered by TypeSafe's Jev, or by OpenAI's Decisions API when you pass
+  `{ model: 'openai/gpt-6-luna' }`
 - **Label threads** — `ctx.thread.labels()`, `ctx.thread.addLabels(...)`, and
   `ctx.thread.setLabels(...)` to read and change the current thread's labels
 - **Upload attachments** — `amp.attachments.upload(...)` to upload image bytes and get back a URL

package/index.d.ts

@@ -806,7 +806,10 @@ declare module '@ampcode/plugin' {
 		legend: Record<string, string>
 		/** Probability of each level index. */
 		probabilities: Record<string, number>
-		/** Probability of the most likely level. */
+		/**
+		 * The model's confidence in the score, from 0 to 1. Each model defines it; it is not always
+		 * the probability of the most likely level.
+		 */
 		confidence: number
 	}
 
@@ -815,7 +818,10 @@ declare module '@ampcode/plugin' {
 		choice: Option
 		/** Probability of each option. */
 		probabilities: Record<Option, number>
-		/** Probability of `choice`. */
+		/**
+		 * The model's confidence in `choice`, from 0 to 1. Each model defines it; it is not always
+		 * the probability of `choice`.
+		 */
 		confidence: number
 	}
 
@@ -829,10 +835,28 @@ declare module '@ampcode/plugin' {
 				? ScoreAnswer
 				: NoulAnswer
 
+	/**
+	 * A decision model, written as `provider/model`. `typesafe/jev` is TypeSafe's Jev.
+	 * `openai/gpt-6-luna` is OpenAI's Decisions API. A workspace can disable a provider, so a model
+	 * that exists here can still be unavailable in a thread.
+	 *
+	 * The models answer the same questions but are calibrated differently, so a threshold tuned on
+	 * one does not carry over to the other. With `openai/gpt-6-luna`, JSON in `state`,
+	 * `instructions`, and `criteria` is sent as its JSON text, the criteria of a `noul` question are
+	 * appended to its instructions, and the call rejects if OpenAI declines to answer a question.
+	 */
+	export type DecisionModel = 'typesafe/jev' | 'openai/gpt-6-luna'
+
 	/** The state every decision is judged against, and the thread that routes the request. */
 	export interface DecisionOptions {
 		/** Thread to route the request through. Required outside a thread-bound handler. */
 		threadID?: ThreadID
+		/**
+		 * The decision model to ask. Defaults to `typesafe/jev`. The call fails if the thread's
+		 * workspace has disabled that model; Amp never asks another model in its place, so name
+		 * `openai/gpt-6-luna` for a workspace that allows only OpenAI.
+		 */
+		model?: DecisionModel
 		/** The situation to judge: text, or JSON the model reads as-is. Up to 50,000 characters of text. */
 		state: DecisionInput
 	}
@@ -848,8 +872,9 @@ declare module '@ampcode/plugin' {
 		Q extends Record<string, DecisionQuestion> = Record<string, DecisionQuestion>,
 	> {
 		/**
-		 * The decision model that answered, such as `jev-1.13.0`. Amp picks the model; record it when
-		 * you tune thresholds so a model change is visible.
+		 * The exact model version that answered, as its provider reports it, such as `jev-1.13.0` or
+		 * `gpt-6-luna`.
+		 * Record it when you tune thresholds so a model change is visible.
 		 */
 		model: string
 		answers: { [K in keyof Q]: DecisionAnswerFor<Q[K]> }
@@ -910,8 +935,10 @@ declare module '@ampcode/plugin' {
 		 * is typed as the option names you passed. The typed shape is guaranteed; the answer can
 		 * still be wrong, and adversarial text inside `state` can move it.
 		 *
-		 * Amp chooses the underlying model (currently TypeSafe's Jev) and may change it;
-		 * {@link DecisionResult.model} reports which one answered.
+		 * TypeSafe's Jev answers unless you pass {@link DecisionOptions.model}, and
+		 * {@link DecisionResult.model} reports the version that answered. The call rejects when the
+		 * thread's workspace has disabled the model, so handle the error where a decision is
+		 * optional.
 		 *
 		 * Calls are routed through the current thread. Pass `threadID` when calling outside a
 		 * thread-bound handler.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20261007001957-g339d9e8",
+	"version": "0.0.0-20261008001818-g5d841b4",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/docs/plugin-api",
 	"author": {