akanjs 3.0.0-alpha.17 → 3.0.0-alpha.18

package/constant/labelOf.ts

@@ -6,8 +6,8 @@
 export const labelOf = (model: unknown, value: unknown): string | undefined => {
   if (!value || typeof value !== "object") return undefined;
   const source = value as Record<string, unknown>;
-  const paths = (model as { text?: { title?: readonly string[] } } | null)?.text?.title;
-  const titlePath = paths?.find((path) => !path.includes(".") && !path.includes("["));
+  const paths = (model as { text?: { title?: Iterable<string> } } | null)?.text?.title;
+  const titlePath = [...(paths ?? [])].find((path) => !path.includes(".") && !path.includes("["));
   for (const key of [titlePath, "title", "name"]) {
     if (!key) continue;
     const candidate = source[key];

package/fetch/client/fetchClient.ts

@@ -10,6 +10,7 @@ import type {
   SerializedSlice,
   ServiceSignal,
 } from "akanjs/signal";
+import { agentTurnConstant } from "../agentTurn";
 import type { ClientSignal, FetchClientType, FetchSignalInput, MergeAllFetchTypes, SliceMeta } from "../fetchType";
 import { memoizeRequestQuery, cookies as requestCookies, headers as requestHeaders } from "../requestStorage";
 import type { GetSliceMetaObjFromDatabaseSignals } from "../types";
@@ -47,6 +48,19 @@ const globalWithSharedClient = globalThis as typeof globalThis & { [SHARED_CLIEN
 const sharedClientState: SharedClientState = globalWithSharedClient[SHARED_CLIENT_KEY] ?? { proxy: null, origin: null };
 globalWithSharedClient[SHARED_CLIENT_KEY] = sharedClientState;
 
+interface SharedSignalRegistry {
+  signal: { [key: string]: SerializedSignal };
+  version: number;
+}
+
+const SHARED_SIGNAL_KEY = Symbol.for("akanjs.fetch.sharedSignalRegistry");
+const globalWithSharedSignal = globalThis as typeof globalThis & { [SHARED_SIGNAL_KEY]?: SharedSignalRegistry };
+const sharedSignalRegistry: SharedSignalRegistry = globalWithSharedSignal[SHARED_SIGNAL_KEY] ?? {
+  signal: {},
+  version: 0,
+};
+globalWithSharedSignal[SHARED_SIGNAL_KEY] = sharedSignalRegistry;
+
 type ClientSignalMap<SigType extends { fetch: any }> = {
   [K in keyof SigType as SigType[K] extends DatabaseSignal<any, any, any, any>
     ? K
@@ -57,8 +71,9 @@ type ClientSignalMap<SigType extends { fetch: any }> = {
 
 /** Runtime fetch client that registers serialized Akan signals as HTTP/WebSocket methods. */
 export class FetchClient {
-  static #sharedSerializedSignal: { [key: string]: SerializedSignal } = {};
-  static #sharedRegistryVersion = 0;
+  static {
+    ConstantRegistry.setScalar(agentTurnConstant.refName, agentTurnConstant);
+  }
   readonly logger = new Logger("FetchClient");
   readonly origin: string;
   readonly http: HttpClient;
@@ -93,11 +108,11 @@ export class FetchClient {
    * would change what the next client applies. Read by the agent catalogue, which needs the argument schemas.
    */
   static get sharedSerializedSignal(): { [key: string]: SerializedSignal } {
-    return { ...FetchClient.#sharedSerializedSignal };
+    return { ...sharedSignalRegistry.signal };
   }
   static resetSharedRegistry() {
-    FetchClient.#sharedSerializedSignal = {};
-    FetchClient.#sharedRegistryVersion++;
+    sharedSignalRegistry.signal = {};
+    sharedSignalRegistry.version++;
   }
   static resetSharedClient() {
     sharedClientState.proxy = null;
@@ -147,9 +162,9 @@ export class FetchClient {
   applySignal(serializedSignal: { [key: string]: SerializedSignal }, { share = true }: { share?: boolean } = {}) {
     if (share && Object.keys(serializedSignal).length > 0) {
       for (const [refName, signal] of Object.entries(serializedSignal))
-        FetchClient.#mergeSerializedSignalInto(FetchClient.#sharedSerializedSignal, refName, signal);
-      FetchClient.#sharedRegistryVersion++;
-      this.#sharedRegistryAppliedVersion = FetchClient.#sharedRegistryVersion;
+        FetchClient.#mergeSerializedSignalInto(sharedSignalRegistry.signal, refName, signal);
+      sharedSignalRegistry.version++;
+      this.#sharedRegistryAppliedVersion = sharedSignalRegistry.version;
     }
     for (const [refName, signal] of Object.entries(serializedSignal))
       FetchClient.#mergeSerializedSignalInto(this.serializedSignal, refName, signal);
@@ -183,9 +198,9 @@ export class FetchClient {
     });
   }
   #syncSharedRegistry() {
-    if (this.#sharedRegistryAppliedVersion === FetchClient.#sharedRegistryVersion) return;
-    this.applySignal(FetchClient.#sharedSerializedSignal, { share: false });
-    this.#sharedRegistryAppliedVersion = FetchClient.#sharedRegistryVersion;
+    if (this.#sharedRegistryAppliedVersion === sharedSignalRegistry.version) return;
+    this.applySignal(sharedSignalRegistry.signal, { share: false });
+    this.#sharedRegistryAppliedVersion = sharedSignalRegistry.version;
   }
   #getOrCreateHandler(key: string): FetchHandler | undefined {
     const current = this.#handlerStore[key];
@@ -719,9 +734,16 @@ export class FetchClient {
         });
       }
     });
-    const instance = new FetchClient(getEnv().serverHttpUri, handler, serializedSignal);
+    const instance = new FetchClient(FetchClient.#originFromEnv(), handler, serializedSignal);
     return FetchClient.#makeProxy<MergeAllFetchTypes<Signals>, GetSliceMetaObjFromDatabaseSignals<Signals>>(instance);
   }
+  static #originFromEnv() {
+    try {
+      return getEnv().serverHttpUri;
+    } catch {
+      return "";
+    }
+  }
   static build<SigType extends { fetch: any }>(
     constant: object,
     serializedSignal: { [key: string]: SerializedSignal },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "3.0.0-alpha.17",
+  "version": "3.0.0-alpha.18",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {

package/server/rscWorker.tsx

@@ -13,6 +13,7 @@ import {
   getRequestFrameState,
   getRequestPolicy,
   getRequestTheme,
+  pushRequestFallback,
   requestStorage,
   setRequestFrameState,
   untrackedCookies,
@@ -1182,8 +1183,11 @@ export class RscRenderer {
   }
 
   #runWithRequest<T>(request: Request, fn: () => Promise<T>): Promise<T> {
-    if (requestStorage) return Promise.resolve(requestStorage.run(request, fn));
-    return fn();
+
+    const cleanup = pushRequestFallback(request);
+    const run = () => Promise.resolve(fn()).finally(() => cleanup());
+    if (requestStorage) return Promise.resolve(requestStorage.run(request, run));
+    return run();
   }
 
   async #renderFallbackDocument({

package/server/vendor/akanjs-fetch.ts

@@ -0,0 +1 @@
+export * from "akanjs/fetch";

package/service/predefinedAdaptor/deepseekLlm.ts

@@ -32,7 +32,7 @@ export class DeepseekLlm
   implements LlmAdaptor
 {
   get #model() {
-    return this.llmOption.model ?? "deepseek-chat";
+    return this.llmOption.model ?? "deepseek-v4-flash";
   }
   get #host() {
     return this.llmOption.host ?? "https://api.deepseek.com";

package/store/agent/ScreenReader.ts

@@ -83,35 +83,54 @@ export class ScreenReader {
     if (el.hasAttribute("data-agent-ui") || el.hasAttribute("hidden") || el.getAttribute("aria-hidden") === "true")
       return;
     if (typeof el.checkVisibility === "function" && !el.checkVisibility()) return;
-    if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return this.#control(el, tag);
+    if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") {
+      this.#control(el, tag);
+      return;
+    }
     if (tag === "IMG") {
       const alt = el.getAttribute("alt");
       if (alt) this.#buffer += ` [image: ${alt}]`;
       return;
     }
-    if (tag === "BR") return this.#flush();
-    if (tag === "PRE") return this.#pre(el);
-    if (tag === "A") return this.#anchor(el);
-    if (tag === "BUTTON" || el.getAttribute("role") === "button") return this.#button(el);
+    if (tag === "BR") {
+      this.#flush();
+      return;
+    }
+    if (tag === "PRE") {
+      this.#pre(el);
+      return;
+    }
+    if (tag === "A") {
+      this.#anchor(el);
+      return;
+    }
+    if (tag === "BUTTON" || el.getAttribute("role") === "button") {
+      this.#button(el);
+      return;
+    }
     const level = headingLevels[tag as keyof typeof headingLevels];
     if (level) {
       this.#flush();
       this.#walkChildren(el);
-      return this.#flush(`${"#".repeat(level)} `);
+      this.#flush(`${"#".repeat(level)} `);
+      return;
     }
     if (tag === "LI") {
       this.#flush();
       this.#walkChildren(el);
-      return this.#flush("- ");
+      this.#flush("- ");
+      return;
     }
     if (tag === "TD" || tag === "TH") {
       if (this.#buffer.trim()) this.#buffer += " |";
-      return this.#walkChildren(el);
+      this.#walkChildren(el);
+      return;
     }
     if (blockTags.has(tag)) {
       this.#flush();
       this.#walkChildren(el);
-      return this.#flush();
+      this.#flush();
+      return;
     }
     this.#walkChildren(el);
   }

package/store/agent/StoreCatalogue.ts

@@ -1,5 +1,5 @@
 import { type Cls, FIELD_META, PrimitiveRegistry, type PrimitiveScalar } from "akanjs/base";
-import { capitalize } from "akanjs/common";
+import { capitalize, Logger } from "akanjs/common";
 import { ConstantRegistry } from "akanjs/constant";
 import type { AgentRefusal, SerializedArg, SerializedSignal } from "akanjs/signal";
 
@@ -71,7 +71,10 @@ export class StoreCatalogue {
   readonly #instance: StoreInstance;
   readonly #endpoints = new Map<string, { endpoint: SerializedSignal["endpoint"][string]; refName: string }>();
   readonly #refused = new Set<string>();
+  readonly #baseFieldSetters = new Set<string>();
   #formSetterCache: Map<string, SerializedStoreAction> | null = null;
+  static readonly #baseDocumentFields = new Set(["id", "createdAt", "updatedAt", "removedAt"]);
+  static readonly #warnedMismatches = new Set<string>();
 
   constructor(instance: StoreInstance, serializedSignal: Record<string, SerializedSignal>) {
     this.#instance = instance;
@@ -154,9 +157,12 @@ export class StoreCatalogue {
     if (this.#refused.has(key)) return null;
 
     if (this.#instance.generatedSetters.has(key)) return null;
+    
+    if (this.#baseFieldSetters.has(key)) return null;
     if (!this.visibility.visibleAction(key, this.#instance.actionOwners.get(key)?.refName)) return null;
     const endpoint = this.#endpoints.get(key);
-    if (endpoint) return [key, this.#endpointAction(key, endpoint)];
+    if (endpoint)
+      return this.#actionFitsEndpoint(key, endpoint.endpoint) ? [key, this.#endpointAction(key, endpoint)] : null;
     const formSetter = this.#formSetterCache?.get(key);
     if (formSetter) return [key, formSetter];
     const slice = this.#sliceAction(key);
@@ -165,9 +171,33 @@ export class StoreCatalogue {
   }
 
   /**
-   * An action named after an endpoint takes the endpoint's arguments. That is not a coincidence to be verified but
-   * the house naming rule — "the signal, store, and dictionary re-add the model, so `st.do.X` reads the same as
-   * `fetch.X`" — and it is where the store's schemas come from for free.
+   * The borrowed schema is only honest when the action can consume it: one that declares fewer parameters than the
+   * endpoint silently drops the tail and reads stale form state instead, so a schema-correct call becomes a wrong
+   * mutation reported as success. More parameters than the endpoint is the generated shape —
+   * `create<Model>(data, options?)` — and stays published. `Function.length` stops at the first default, so a
+   * defaulted mirror parameter reads as missing here; align it with the endpoint or exclude the action.
+   */
+  #actionFitsEndpoint(key: string, endpoint: SerializedSignal["endpoint"][string]) {
+    const arity = this.#instance.actionArity.get(key) ?? 0;
+    const declared = endpoint.args.length;
+    if (arity >= declared) return true;
+    this.#refuse(
+      key,
+      `it declares ${arity} parameter${arity === 1 ? "" : "s"} while the same-named endpoint takes ${declared} — a schema-shaped call would drop the tail and read form state instead. Align the action's parameters with the endpoint, or exclude the action.`,
+    );
+    if (!StoreCatalogue.#warnedMismatches.has(key)) {
+      StoreCatalogue.#warnedMismatches.add(key);
+      Logger.warn(
+        `st.do.${key} does not mirror endpoint ${key} (${arity} vs ${declared} args) — not published to agents.`,
+      );
+    }
+    return false;
+  }
+
+  /**
+   * An action named after an endpoint takes the endpoint's arguments — the house naming rule ("the signal, store,
+   * and dictionary re-add the model, so `st.do.X` reads the same as `fetch.X`") is where the store's schemas come
+   * from for free, and #actionFitsEndpoint is what holds the rule to its word.
    */
   #endpointAction(
     key: string,
@@ -193,6 +223,10 @@ export class StoreCatalogue {
       if (!fields) continue;
       for (const [field, meta] of Object.entries(fields)) {
         const names = formSetterNames(className, field);
+        if (StoreCatalogue.#baseDocumentFields.has(field)) {
+          for (const name of Object.values(names)) if (name in this.#instance.do) this.#baseFieldSetters.add(name);
+          continue;
+        }
         if (!(names.setFieldOnModel in this.#instance.do)) continue;
         if (names.uploadFieldOnModel in this.#instance.do)
           this.#refuse(names.uploadFieldOnModel, "it takes a browser `FileList`, which an agent has no way to hold.");

package/store/agent/StoreSurfaceSource.ts

@@ -25,7 +25,8 @@ export class StoreSurfaceSource implements SurfaceSource {
 
   tools = (view: string[] = []): ToolEntry[] => {
     const viewKey = view.join(".");
-    const bridge = (this.#bridge ??= AgentBridge.of());
+    this.#bridge ??= AgentBridge.of();
+    const bridge = this.#bridge;
     const live = bridge.toolsFor(viewKey);
     const cached = this.#wrapped.get(viewKey);
     if (cached?.source !== live)
@@ -107,7 +108,10 @@ export class StoreSurfaceSource implements SurfaceSource {
         additionalProperties: false,
       },
       effect: "state",
-      run: (args: Record<string, unknown>) => (this.#bridge ??= AgentBridge.of()).read(String(args.key), viewKey),
+      run: (args: Record<string, unknown>) => {
+        this.#bridge ??= AgentBridge.of();
+        return this.#bridge.read(String(args.key), viewKey);
+      },
     };
   }
 

package/types/server/vendor/akanjs-fetch.d.ts

@@ -0,0 +1 @@
+export * from "akanjs/fetch";