@theoremjs/web 0.3.4-next.484.g20d8b9d → 0.3.4-next.508.geda6db0

package/README.md

@@ -485,7 +485,7 @@ On the browser side, `@theoremjs/web/client` reads what your server sends:
 | `fetchConversation(url, body, options?)` | POSTs a conversation read, and checks the view your server answers. |
 | `fetchRewound(url, body, options?)` | POSTs a rewind, and checks the rewound conversation. |
 | `fetchStarted(url, body, options?)` | POSTs blocks to start a conversation on, and checks the started conversation. |
-| `failedDecisionTraces(err)` | The trace records that a failed decision left, for the trace inspector. |
+| `failedTraces(err)` | The trace records that a failed decision left, for the trace inspector. |
 
 ## More documentation
 

package/client/decision-transport.d.ts

@@ -13,11 +13,8 @@ export type DecisionQuestionView = {
     type: DecisionQuestion['type'];
     /** A choice's labels, a score's levels from 0 up; empty for a number. */
     labels: string[];
-    /**
-     * A box's image: the one its question gives, a reference or a state field, else the field its
-     * instructions first name in backticks.
-     */
-    field?: string;
+    /** A box's image, as its question gives it: a reference, or the state field that holds one. */
+    image?: string;
 };
 /** What a decision profile shows the page. */
 export type DecisionInterface = {
@@ -57,7 +54,6 @@ export interface DecisionTransport {
 export declare function withFailedTraces(err: unknown, traces: readonly TraceRecord[]): unknown;
 /** The trace records a failed decision left; none when its host sent none. */
 export declare function failedTraces(err: unknown): readonly TraceRecord[];
-export declare const failedDecisionTraces: typeof failedTraces;
 /** POSTs `body` and reads its reply with `read`; a failure keeps the trace records its body carried. */
 export declare function postWithTraces<Reply>(url: string, body: unknown, signal: AbortSignal | undefined, options: HttpOptions, read: (raw: unknown) => Reply): Promise<Reply>;
 /** POSTs a decision and reads its reply; a failure keeps the trace records its body carried. */

package/client/decision-transport.js

@@ -14,21 +14,6 @@ function entryLabel(entry, fallback) {
     const entries = Array.isArray(entry) ? entry : Object.keys(entry);
     return entries.length ? entryLabel(entries[0], fallback) : fallback;
 }
-function withField(field) {
-    return field === undefined ? {} : { field };
-}
-/** The first field an entry names in backticks, as in "the mug in `photo`". */
-function namedField(entry) {
-    if (typeof entry === 'string')
-        return /\x60([^\x60\s]+)\x60/.exec(entry)?.[1];
-    const entries = Array.isArray(entry) ? entry : Object.values(entry);
-    for (const each of entries) {
-        const field = namedField(each);
-        if (field !== undefined)
-            return field;
-    }
-    return undefined;
-}
 /** The page's view of a decision profile, the questions its host asks, and the host's own images. */
 export function decisionInterface(profile, questions, images) {
     return {
@@ -46,9 +31,7 @@ export function decisionInterface(profile, questions, images) {
                 : question.type === 'score'
                     ? question.criteria.map((entry, level) => entryLabel(entry, String(level)))
                     : [],
-            ...(question.type === 'box'
-                ? withField(question.image ?? namedField(question.instructions))
-                : {}),
+            ...(question.type === 'box' && question.image !== undefined ? { image: question.image } : {}),
         })),
         ...(images && Object.keys(images).length > 0 ? { images } : {}),
         ...(profile.observability
@@ -68,10 +51,9 @@ export function decisionAssets(host, page) {
     const all = { ...host, ...page };
     return Object.keys(all).length > 0 ? all : undefined;
 }
+// why: The host's kernel checks each answer against its question; the page checks only the shape it draws.
 const probability = z.number().min(0).max(1);
-const probabilities = z
-    .record(z.string(), probability)
-    .refine((record) => Math.abs(Object.values(record).reduce((sum, value) => sum + value, 0) - 1) <= 0.001);
+const probabilities = z.record(z.string(), probability);
 const answerSchema = z.discriminatedUnion('type', [
     z.object({
         type: z.literal('choice'),
@@ -119,7 +101,6 @@ export function withFailedTraces(err, traces) {
 export function failedTraces(err) {
     return (typeof err === 'object' && err !== null && traceFailures.get(err)) || [];
 }
-export const failedDecisionTraces = failedTraces;
 const failedBody = z.object({ traces: z.array(traceRecordSchema) });
 /** POSTs `body` and reads its reply with `read`; a failure keeps the trace records its body carried. */
 export async function postWithTraces(url, body, signal, options, read) {
@@ -155,7 +136,7 @@ const describedSchema = z.object({
             id: z.string(),
             type: z.enum(['choice', 'noul', 'score', 'box']),
             labels: z.array(z.string()),
-            field: z.string().optional(),
+            image: z.string().optional(),
         })),
         images: z
             .record(z.string(), z.object({ mimeType: z.enum(['image/png', 'image/jpeg']), data: z.string() }))

package/client/index.d.ts

@@ -3,7 +3,7 @@ export { type ChatController, type ChatOptions, type ChatSlots, type ChatState,
 export { type ComposerDrawerKind, type ComposerDrawerSummary, composerDrawerSummary, } from './composer-drawer.ts';
 export { type ComposerHint, isStashShortcut, resolveComposerHint, STASH_SHORTCUT, } from './composer-hints.ts';
 export { type ComposerActionState, composerActionState, composerHasPayload, } from './composer-primary.ts';
-export { createDecisionTransport, type DecisionInterface, type DecisionQuestionView, type DecisionReply, type DecisionTransport, decisionAssets, decisionInterface, failedDecisionTraces, failedTraces, postDecision, readDecisionReply, withFailedTraces, } from './decision-transport.ts';
+export { createDecisionTransport, type DecisionInterface, type DecisionQuestionView, type DecisionReply, type DecisionTransport, decisionAssets, decisionInterface, failedTraces, postDecision, readDecisionReply, withFailedTraces, } from './decision-transport.ts';
 export { type ComposerDraftFields, composerFieldsFromDraft } from './decode-composer-draft.ts';
 export { addUsage, checkEmbeddingInputs, checkInputs, cosineSimilarity, type EmbeddingFields, type EmbeddingInputCheck, type EmbeddingMatch, type EmbeddingMediaPart, type EmbeddingSplit, embeddingBatches, fieldsInput, inputFields, MAX_BATCH_INPUTS, rankMatches, readEmbeddingInput, readEmbeddingInputs, readsAsText, splitText, } from './embedding-input.ts';
 export { type EmbeddingSpace, layoutSpace, layoutSpaceSoon, outlierThreshold, placeQuery, type SpaceCluster, type SpaceDocument, type SpaceLink, type SpacePoint, } from './embedding-space.ts';

package/client/index.js

@@ -3,7 +3,7 @@ export { createChatController, } from "./chat.js";
 export { composerDrawerSummary, } from "./composer-drawer.js";
 export { isStashShortcut, resolveComposerHint, STASH_SHORTCUT, } from "./composer-hints.js";
 export { composerActionState, composerHasPayload, } from "./composer-primary.js";
-export { createDecisionTransport, decisionAssets, decisionInterface, failedDecisionTraces, failedTraces, postDecision, readDecisionReply, withFailedTraces, } from "./decision-transport.js";
+export { createDecisionTransport, decisionAssets, decisionInterface, failedTraces, postDecision, readDecisionReply, withFailedTraces, } from "./decision-transport.js";
 export { composerFieldsFromDraft } from "./decode-composer-draft.js";
 export { addUsage, checkEmbeddingInputs, checkInputs, cosineSimilarity, embeddingBatches, fieldsInput, inputFields, MAX_BATCH_INPUTS, rankMatches, readEmbeddingInput, readEmbeddingInputs, readsAsText, splitText, } from "./embedding-input.js";
 export { layoutSpace, layoutSpaceSoon, outlierThreshold, placeQuery, } from "./embedding-space.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theoremjs/web",
-  "version": "0.3.4-next.484.g20d8b9d",
+  "version": "0.3.4-next.508.geda6db0",
   "description": "Theorem on the web platform, with no UI framework: Web-standard server handlers that serve a profile, and the browser client that talks to them.",
   "license": "MIT",
   "type": "module",
@@ -25,6 +25,6 @@
   },
   "peerDependencies": {
     "zod": "^4.6.5",
-    "@theoremjs/agents": "^0.3.4-next.484.g20d8b9d"
+    "@theoremjs/agents": "^0.3.4-next.508.geda6db0"
   }
 }