@iloveagents/foundry-agent 0.9.0 → 0.10.0

package/dist/client/agui-runner.js

@@ -152,7 +152,8 @@ export class AGUIRunner {
                 // The user's reasoning-effort choice rides on every turn as an
                 // AG-UI forwardedProp — read at request time so changing it
                 // mid-conversation takes effect on the next message. "default"
-                // sends nothing so the backend keeps its configured level.
+                // sends nothing, which is what makes the backend's own configured
+                // level apply; the picker shows the user what that resolves to.
                 const chosenEffort = reasoningEffortStore.getState().effort;
                 const forwardedProps = chosenEffort === "default" ? {} : { reasoningEffort: chosenEffort };
                 const runInputSnapshot = {

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { RunnerEvent } from "./client/runner-events.js";
 export { createServiceFetch, type ServiceFetch, type ServiceFetchOptions, } from "./client/service-fetch.js";
 export { clientToolRegistry, type ClientToolEntry, type ToolRegistry } from "./tools/registry.js";
 export { agentStateStore } from "./store/agent-state-store.js";
-export { reasoningEffortStore, REASONING_EFFORT_LABELS, type ReasoningEffort, } from "./store/reasoning-effort-store.js";
+export { reasoningDefaultStore, reasoningEffortStore, REASONING_EFFORT_LABELS, type ReasoningEffort, type ResolvedReasoningEffort, } from "./store/reasoning-effort-store.js";
 export { streamingStatusStore, type StreamingStatus } from "./store/streaming-status-store.js";
 export { citationStore, type CitationResult, type CitationHandler, } from "./store/citation-store.js";
 export { linkStore, resolveLinkHandler, type LinkHandler, type ResolvedLinkHandler, } from "./store/link-store.js";

package/dist/index.js

@@ -6,7 +6,7 @@ export { createServiceFetch, } from "./client/service-fetch.js";
 export { clientToolRegistry } from "./tools/registry.js";
 // --- Stores (vanilla) ---
 export { agentStateStore } from "./store/agent-state-store.js";
-export { reasoningEffortStore, REASONING_EFFORT_LABELS, } from "./store/reasoning-effort-store.js";
+export { reasoningDefaultStore, reasoningEffortStore, REASONING_EFFORT_LABELS, } from "./store/reasoning-effort-store.js";
 export { streamingStatusStore } from "./store/streaming-status-store.js";
 export { citationStore, } from "./store/citation-store.js";
 export { linkStore, resolveLinkHandler, } from "./store/link-store.js";

package/dist/store/reasoning-effort-store.d.ts

@@ -1,18 +1,55 @@
 /**
  * How hard the model should think before answering.
  *
- * `"default"` sends nothing and leaves the backend's configured level
- * alone — the user hasn't expressed a preference, so we don't override
- * one. The remaining levels map to the AG-UI/Responses reasoning effort.
+ * `"default"` is a deferral, not a level: it sends nothing, so whatever the
+ * backend is configured for applies. Every other member maps to a real
+ * AG-UI/Responses reasoning effort and is sent verbatim.
+ *
+ * A deferral is only honest if the user can see what it currently resolves
+ * to — otherwise you believe you are on Extra High and are quietly running
+ * Instant, and the control silently decides cost and latency. That is what
+ * {@link reasoningDefaultStore} is for.
  */
 export type ReasoningEffort = "default" | "low" | "medium" | "high" | "xhigh";
+/** A real effort level — everything except the deferral. */
+export type ResolvedReasoningEffort = Exclude<ReasoningEffort, "default">;
 /**
  * Level names follow the convention users already know from other assistants
  * (Instant / Medium / High / Extra High) rather than inventing a private
- * vocabulary. `Auto` is ours: it means "no preference — use whatever the app
- * is configured for", which the protocol enum has no member for.
+ * vocabulary. `Auto` is ours, for the case the protocol enum has no member
+ * for: follow whatever the app is configured for.
  */
 export declare const REASONING_EFFORT_LABELS: Record<ReasoningEffort, string>;
+interface ReasoningDefaultState {
+    /**
+     * What `"default"` resolves to right now, or `null` while unknown.
+     *
+     * `null` also covers a backend with reasoning switched off entirely, where
+     * there is no level to name.
+     */
+    resolved: ResolvedReasoningEffort | null;
+    /**
+     * Where that came from, for the picker's hint — e.g. `"this workspace"`.
+     * `null` means unattributed, and the hint stays generic.
+     */
+    scope: string | null;
+    setResolved: (resolved: ResolvedReasoningEffort | null, scope?: string | null) => void;
+}
+/**
+ * What the backend will actually do when the client sends no effort.
+ *
+ * Populated by the host app, never derived here. Re-deriving the backend's
+ * fallback chain client-side is exactly how a label goes stale and starts
+ * lying: the backend changes its default and the UI keeps claiming the old
+ * one. The app fetches this from the server and sets it, and updates it
+ * when the context it depends on changes — switching workspace, say — so
+ * `Auto` always names the level that will really be used.
+ *
+ * Left unset, the picker says it does not know rather than guessing.
+ *
+ * Vanilla store — this package stays zero-React.
+ */
+export declare const reasoningDefaultStore: import("zustand/vanilla").StoreApi<ReasoningDefaultState>;
 interface ReasoningEffortState {
     effort: ReasoningEffort;
     setEffort: (effort: ReasoningEffort) => void;
@@ -23,6 +60,9 @@ interface ReasoningEffortState {
  * Vanilla store (this package is zero-React); the runner reads it when
  * building each request so the choice applies per turn — change it
  * mid-conversation and the next message uses the new level.
+ *
+ * An explicit level is a pin: nothing moves it, including a change of
+ * context. Only `"default"` follows.
  */
 export declare const reasoningEffortStore: import("zustand/vanilla").StoreApi<ReasoningEffortState>;
 export {};

package/dist/store/reasoning-effort-store.js

@@ -2,8 +2,8 @@ import { createStore } from "zustand/vanilla";
 /**
  * Level names follow the convention users already know from other assistants
  * (Instant / Medium / High / Extra High) rather than inventing a private
- * vocabulary. `Auto` is ours: it means "no preference — use whatever the app
- * is configured for", which the protocol enum has no member for.
+ * vocabulary. `Auto` is ours, for the case the protocol enum has no member
+ * for: follow whatever the app is configured for.
  */
 export const REASONING_EFFORT_LABELS = {
     default: "Auto",
@@ -12,6 +12,25 @@ export const REASONING_EFFORT_LABELS = {
     high: "High",
     xhigh: "Extra High",
 };
+/**
+ * What the backend will actually do when the client sends no effort.
+ *
+ * Populated by the host app, never derived here. Re-deriving the backend's
+ * fallback chain client-side is exactly how a label goes stale and starts
+ * lying: the backend changes its default and the UI keeps claiming the old
+ * one. The app fetches this from the server and sets it, and updates it
+ * when the context it depends on changes — switching workspace, say — so
+ * `Auto` always names the level that will really be used.
+ *
+ * Left unset, the picker says it does not know rather than guessing.
+ *
+ * Vanilla store — this package stays zero-React.
+ */
+export const reasoningDefaultStore = createStore((set) => ({
+    resolved: null,
+    scope: null,
+    setResolved: (resolved, scope) => set({ resolved, scope: scope ?? null }),
+}));
 const STORAGE_KEY = "foundry:reasoning-effort";
 function readPersisted() {
     if (typeof localStorage === "undefined")
@@ -27,6 +46,9 @@ function readPersisted() {
  * Vanilla store (this package is zero-React); the runner reads it when
  * building each request so the choice applies per turn — change it
  * mid-conversation and the next message uses the new level.
+ *
+ * An explicit level is a pin: nothing moves it, including a change of
+ * context. Only `"default"` follows.
  */
 export const reasoningEffortStore = createStore((set) => ({
     effort: readPersisted(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iloveagents/foundry-agent",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "license": "MIT",
   "description": "Cross-runtime AG-UI transport for Foundry UI — AGUIRunner protocol engine, vanilla zustand stores, optional MSAL auth subpath, service-fetch factory. Zero React, zero DOM.",
   "keywords": [