akanjs 3.0.0-beta.17 → 3.0.0-beta.19

package/constant/mask.ts

@@ -1,4 +1,4 @@
-import { FIELD_META } from "akanjs/base";
+import { type Cls, FIELD_META, getNonArrayModel, type PrimitiveAgentFace, PrimitiveRegistry } from "akanjs/base";
 
 /**
  * A model as masking reads it — the constructor, for the field metadata it carries at runtime.
@@ -14,7 +14,10 @@ export interface MaskModel {
 interface MaskField {
   fieldType?: string;
   isClass?: boolean;
+  isMap?: boolean;
   modelRef?: MaskModel;
+  of?: unknown;
+  arrDepth?: number;
   visual?: boolean;
 }
 
@@ -40,7 +43,8 @@ export const leakingFieldsOf = (model: MaskModel, value: Record<string, unknown>
 /**
  * Strips what a model marks `hidden`, `secret`, or `visual`, by the model the caller names rather than by the one
  * the value happens to still carry. The first two are secrecy and the third is cost, but the answer is the same
- * one — leave the field out — and this is the only place every AI-facing read already passes through.
+ * one — leave the field out — and this is the only place every AI-facing read already passes through. For the same
+ * reason it is where a primitive declaring an agent face is read into that face (`agentRead`).
  *
  * That distinction is the whole point. A check that reads the class off the value can only mask what arrives as an
  * instance, so a `{ ...doc }` spread, a `toJSON()`, an `immerify()`, or a round-trip through `JSON.stringify` reaches
@@ -61,11 +65,39 @@ export const mask = (model: MaskModel, value: unknown): unknown => {
   const masked: Record<string, unknown> = {};
   for (const [key, field] of Object.entries(fields)) {
     if (field.fieldType === "hidden" || field.fieldType === "secret" || field.visual || !(key in source)) continue;
-    masked[key] = field.isClass && field.modelRef ? mask(field.modelRef, source[key]) : source[key];
+    masked[key] = maskField(field, source[key]);
   }
   return masked;
 };
 
+/**
+ * What an agent reads of a primitive value: the primitive's `agent.read` when it declares an agent face, the value
+ * untouched otherwise. The read is applied through `arrDepth` levels of array, the way a field declares them.
+ */
+export const agentRead = (modelRef: unknown, value: unknown, arrDepth = 0): unknown => {
+  const face = PrimitiveRegistry.agentOf(modelRef);
+  return face ? readThrough(face, value, arrDepth) : value;
+};
+
+const readThrough = (face: PrimitiveAgentFace, value: unknown, arrDepth: number): unknown => {
+  if (value === null || value === undefined) return value;
+  if (arrDepth > 0 && Array.isArray(value)) return value.map((item) => readThrough(face, item, arrDepth - 1));
+  return face.read(value);
+};
+
+const maskField = (field: MaskField, value: unknown): unknown => {
+  if (field.isClass && field.modelRef) return mask(field.modelRef, value);
+  if (field.isMap) return maskMapValues(field.of, value);
+  return agentRead(field.modelRef, value, field.arrDepth ?? 0);
+};
+
+const maskMapValues = (of: unknown, value: unknown): unknown => {
+  const [valueRef, arrDepth] = getNonArrayModel(of as Cls);
+  if (!PrimitiveRegistry.agentOf(valueRef) || value === null || typeof value !== "object") return value;
+  const entries = value instanceof Map ? [...value.entries()] : Object.entries(value);
+  return Object.fromEntries(entries.map(([key, item]) => [key, agentRead(valueRef, item, arrDepth)]));
+};
+
 /**
  * Drops what a model marks `hidden` or `secret`, and nothing else.
  *

package/dictionary/agent.dictionary.ts

@@ -29,4 +29,13 @@ export const agentDictionary = serviceDictionary(["en", "ko"])
       "{provider} refused this turn with status {status}. Reason: {reason}",
       "{provider}가 이번 턴을 거절했습니다 (status {status}). 사유: {reason}",
     ],
+    
+    contextOverflow: [
+      "This conversation no longer fits the model's context window at {provider}. Use /compact to summarize it, or /new to start over",
+      "대화가 {provider} 모델의 컨텍스트 창을 넘었습니다. /compact로 요약하거나 /new로 새로 시작할 수 있습니다.",
+    ],
+    quotaExceeded: [
+      "The agent's usage limit for this account has been reached",
+      "이 계정의 에이전트 사용 한도에 도달했습니다.",
+    ],
   });

package/dictionary/base.dictionary.ts

@@ -109,6 +109,11 @@ export const baseDictionary = serviceDictionary(["en", "ko"])
     agentToolRunning: ["Running", "실행 중"],
     agentToolResult: ["Show what this tool returned", "이 툴이 반환한 값 보기"],
     agentTokens: ["~{count} tokens", "약 {count} 토큰"],
+    agentTokensOf: ["~{count} / {limit} tokens", "약 {count} / {limit} 토큰"],
+    agentCompactsAt: [
+      "The conversation summarizes itself past {limit} tokens",
+      "{limit} 토큰을 넘으면 대화를 스스로 요약합니다",
+    ],
     agentSummarizing: ["Summarizing the conversation…", "대화를 요약하는 중…"],
     agentContinue: ["This is taking a while. Keep going?", "시간이 걸리고 있습니다. 계속할까요?"],
     agentKeepGoing: ["Keep going", "계속하기"],

package/document/dataLoader.ts

@@ -11,7 +11,12 @@ type BatchLoadFn<Key, Value> = (
 ) => PromiseLike<ReadonlyArray<Value | Error>> | ReadonlyArray<Value | Error>;
 
 interface DataLoaderOptions<Key, CacheKey> {
-  cache?: boolean;
+  /**
+   * How long a loaded key is answered from memory: `false` (the default) remembers nothing past its own batch,
+   * a number keeps each key for that many milliseconds, and `true` keeps it for the life of the loader. A model's
+   * loaders live as long as the process, so anything but `false` serves a stale document after it changes.
+   */
+  cache?: boolean | number;
   cacheKeyFn?: (key: Key) => CacheKey;
   batch?: boolean;
   batchScheduleFn?: (callback: () => void) => void;
@@ -27,20 +32,27 @@ interface BatchItem<Key, Value> {
 
 /** Minimal DataLoader-compatible batch loader used by Akan document resolvers. */
 export class DataLoader<Key, Value, CacheKey = Key> {
+  static readonly #minSweepSize = 1024;
   readonly name?: string;
   readonly #batchLoadFn: BatchLoadFn<Key, Value>;
-  readonly #cache: boolean;
+  readonly #ttl: number;
   readonly #cacheKeyFn: (key: Key) => CacheKey;
   readonly #batch: boolean;
   readonly #batchScheduleFn: (callback: () => void) => void;
   readonly #maxBatchSize: number;
-  readonly #promiseCache = new Map<CacheKey, Promise<Value>>();
+  readonly #promiseCache = new Map<CacheKey, { promise: Promise<Value>; expiresAt: number }>();
+  #sweepAt = DataLoader.#minSweepSize;
   #queue: BatchItem<Key, Value>[] = [];
   #scheduled = false;
 
   constructor(batchLoadFn: BatchLoadFn<Key, Value>, options: DataLoaderOptions<Key, CacheKey> = {}) {
     this.#batchLoadFn = batchLoadFn;
-    this.#cache = options.cache !== false;
+    this.#ttl =
+      options.cache === true
+        ? Number.POSITIVE_INFINITY
+        : typeof options.cache === "number" && options.cache > 0
+          ? options.cache
+          : 0;
     this.#cacheKeyFn = options.cacheKeyFn ?? ((key) => key as unknown as CacheKey);
     this.#batch = options.batch !== false;
     this.#batchScheduleFn = options.batchScheduleFn ?? ((callback) => queueMicrotask(callback));
@@ -50,17 +62,21 @@ export class DataLoader<Key, Value, CacheKey = Key> {
 
   load(key: Key): Promise<Value> {
     const cacheKey = this.#cacheKeyFn(key);
-    if (this.#cache) {
-      const cached = this.#promiseCache.get(cacheKey);
-      if (cached) return cached;
-    }
+    const cached = this.#cached(cacheKey);
+    if (cached) return cached;
 
     const promise = new Promise<Value>((resolve, reject) => {
       this.#queue.push({ key, resolve, reject });
       if (this.#batch) this.#schedule();
       else this.#dispatch();
     });
-    if (this.#cache) this.#promiseCache.set(cacheKey, promise);
+    if (this.#ttl > 0) {
+      this.#remember(cacheKey, promise);
+      
+      promise.catch(() => {
+        if (this.#promiseCache.get(cacheKey)?.promise === promise) this.#promiseCache.delete(cacheKey);
+      });
+    }
     return promise;
   }
 
@@ -80,13 +96,30 @@ export class DataLoader<Key, Value, CacheKey = Key> {
   }
 
   prime(key: Key, value: Value | Error): this {
-    if (!this.#cache) return this;
+    if (this.#ttl <= 0) return this;
     const cacheKey = this.#cacheKeyFn(key);
-    if (this.#promiseCache.has(cacheKey)) return this;
-    this.#promiseCache.set(cacheKey, value instanceof Error ? Promise.reject(value) : Promise.resolve(value));
+    if (this.#cached(cacheKey)) return this;
+    this.#remember(cacheKey, value instanceof Error ? Promise.reject(value) : Promise.resolve(value));
     return this;
   }
 
+  #cached(cacheKey: CacheKey): Promise<Value> | undefined {
+    if (this.#ttl <= 0) return undefined;
+    const entry = this.#promiseCache.get(cacheKey);
+    if (!entry) return undefined;
+    if (entry.expiresAt > Date.now()) return entry.promise;
+    this.#promiseCache.delete(cacheKey);
+    return undefined;
+  }
+
+  #remember(cacheKey: CacheKey, promise: Promise<Value>) {
+    this.#promiseCache.set(cacheKey, { promise, expiresAt: Date.now() + this.#ttl });
+    if (this.#promiseCache.size < this.#sweepAt) return;
+    const now = Date.now();
+    for (const [key, entry] of this.#promiseCache) if (entry.expiresAt <= now) this.#promiseCache.delete(key);
+    this.#sweepAt = Math.max(DataLoader.#minSweepSize, this.#promiseCache.size * 2);
+  }
+
   #schedule() {
     if (this.#scheduled) return;
     this.#scheduled = true;
@@ -159,7 +192,7 @@ export const createLoader = <Key, Value>(model: LoaderModel, fieldName = "id", d
       });
       return data as unknown as Promise<Value[]>;
     },
-    { name: "dataloader", cache: false },
+    { name: "dataloader" },
   );
 };
 export const createArrayLoader = <K, V>(model: LoaderModel, fieldName = "id", defaultQuery: QueryOf<unknown> = {}) => {
@@ -194,7 +227,7 @@ export const createArrayElementLoader = <K, V>(
       });
       return data as unknown as Promise<V[]>;
     },
-    { name: "dataloader", cache: false },
+    { name: "dataloader" },
   );
 };
 
@@ -214,7 +247,7 @@ export const createQueryLoader = <Key, Value>(
       });
       return data as unknown as Promise<Value[]>;
     },
-    { name: "dataloader", cache: false },
+    { name: "dataloader" },
   );
 };
 

package/document/database.ts

@@ -1,7 +1,7 @@
 import type { MergedValues, PromiseOrObject } from "akanjs/base";
 import { Logger } from "akanjs/common";
 import type { DocumentModel, QueryOf } from "akanjs/constant";
-import type { CacheAdaptor, CacheSetOptions } from "akanjs/service";
+import type { CacheAdaptor, CacheSetOptions, CacheValue } from "akanjs/service";
 import type { DataLoader } from "./dataLoader";
 import type { DocumentUpdateInput } from "./documentQuery";
 import type { ExtractQuery, ExtractSort, FilterInstance } from "./filterMeta";
@@ -16,15 +16,51 @@ export class CacheDatabase<T = unknown> {
   ) {
     this.logger = new Logger(`${refName}Cache`);
   }
-  async set(topic: string, key: string, value: string | number | Buffer, option: CacheSetOptions = {}) {
+  async set(topic: string, key: string, value: CacheValue, option: CacheSetOptions = {}) {
     await this.cache.set(this.refName, `${topic}:${key}`, value, option);
   }
-  async get<T extends string | number | Buffer>(topic: string, key: string): Promise<T | undefined> {
+  async get<T extends CacheValue = CacheValue>(topic: string, key: string): Promise<T | undefined> {
     return await this.cache.get<T>(this.refName, `${topic}:${key}`);
   }
   async delete(topic: string, key: string) {
     await this.cache.delete(this.refName, `${topic}:${key}`);
   }
+  async getDel<T extends CacheValue = CacheValue>(topic: string, key: string): Promise<T | undefined> {
+    return await this.cache.getDel<T>(this.refName, `${topic}:${key}`);
+  }
+  async setIfAbsent(topic: string, key: string, value: CacheValue, option: CacheSetOptions = {}) {
+    return await this.cache.setIfAbsent(this.refName, `${topic}:${key}`, value, option);
+  }
+  async incr(topic: string, key: string, by = 1, option: CacheSetOptions = {}) {
+    return await this.cache.incr(this.refName, `${topic}:${key}`, by, option);
+  }
+  async hset(topic: string, key: string, subKey: string, value: CacheValue, option: CacheSetOptions = {}) {
+    await this.cache.hset(this.refName, `${topic}:${key}`, subKey, value, option);
+  }
+  async hget<T extends CacheValue = CacheValue>(topic: string, key: string, subKey: string): Promise<T | undefined> {
+    return await this.cache.hget<T>(this.refName, `${topic}:${key}`, subKey);
+  }
+  async hdelete(topic: string, key: string, subKey: string) {
+    await this.cache.hdelete(this.refName, `${topic}:${key}`, subKey);
+  }
+  async hkeys(topic: string, key: string) {
+    return await this.cache.hkeys(this.refName, `${topic}:${key}`);
+  }
+  async hentries<T extends CacheValue = CacheValue>(topic: string, key: string): Promise<[string, T][]> {
+    return await this.cache.hentries<T>(this.refName, `${topic}:${key}`);
+  }
+  async hclear(topic: string, key: string) {
+    await this.cache.hclear(this.refName, `${topic}:${key}`);
+  }
+  async hgetDel<T extends CacheValue = CacheValue>(topic: string, key: string, subKey: string): Promise<T | undefined> {
+    return await this.cache.hgetDel<T>(this.refName, `${topic}:${key}`, subKey);
+  }
+  async hsetIfAbsent(topic: string, key: string, subKey: string, value: CacheValue, option: CacheSetOptions = {}) {
+    return await this.cache.hsetIfAbsent(this.refName, `${topic}:${key}`, subKey, value, option);
+  }
+  async hincr(topic: string, key: string, subKey: string, by = 1, option: CacheSetOptions = {}) {
+    return await this.cache.hincr(this.refName, `${topic}:${key}`, subKey, by, option);
+  }
 }
 /**
  * What `update<Filter>` returns. The patch cannot be a trailing parameter — a filter's own args may be optional,

package/document/loaderInfo.ts

@@ -15,25 +15,46 @@ export type ModelCls<
     _libsOnSchema: (schema: SchemaOf<any, any>) => void;
   }
 >;
+export interface LoaderOption {
+  /** `false` by default; a number of milliseconds, or `true` for as long as the process runs. */
+  cache?: boolean | number;
+}
+
 export class LoaderInfo<Doc = any, Key extends keyof Doc = keyof Doc, QueryArg = Doc[Key]> {
   type: LoaderType;
   field: Key | Key[];
   defaultQuery: QueryOf<unknown>;
+  cache: boolean | number;
   queryArg: QueryArg | undefined;
-  constructor(type: LoaderType, field: Key | Key[], defaultQuery: QueryOf<unknown> = {}) {
+  constructor(
+    type: LoaderType,
+    field: Key | Key[],
+    defaultQuery: QueryOf<unknown> = {},
+    { cache = false }: LoaderOption = {},
+  ) {
     this.type = type;
     this.field = field;
     this.defaultQuery = defaultQuery;
+    this.cache = cache;
   }
 }
 
 export const makeLoaderBuilder = <Doc>() => ({
-  byField: <Key extends keyof Doc & string>(fieldName: Key, defaultQuery: QueryOf<unknown> = {}) =>
-    new LoaderInfo<Doc, Key>("field", fieldName, defaultQuery),
-  byArrayField: <Key extends keyof Doc & string>(fieldName: Key, defaultQuery: QueryOf<unknown> = {}) =>
-    new LoaderInfo<Doc, Key>("arrayField", fieldName, defaultQuery),
-  byQuery: <Key extends keyof Doc & string>(queryKeys: readonly Key[], defaultQuery: QueryOf<unknown> = {}) =>
-    new LoaderInfo<Doc, Key, Pick<Doc, Key>>("query", queryKeys as Key[], defaultQuery),
+  byField: <Key extends keyof Doc & string>(
+    fieldName: Key,
+    defaultQuery: QueryOf<unknown> = {},
+    option: LoaderOption = {},
+  ) => new LoaderInfo<Doc, Key>("field", fieldName, defaultQuery, option),
+  byArrayField: <Key extends keyof Doc & string>(
+    fieldName: Key,
+    defaultQuery: QueryOf<unknown> = {},
+    option: LoaderOption = {},
+  ) => new LoaderInfo<Doc, Key>("arrayField", fieldName, defaultQuery, option),
+  byQuery: <Key extends keyof Doc & string>(
+    queryKeys: readonly Key[],
+    defaultQuery: QueryOf<unknown> = {},
+    option: LoaderOption = {},
+  ) => new LoaderInfo<Doc, Key, Pick<Doc, Key>>("query", queryKeys as Key[], defaultQuery, option),
 });
 
 export type LoaderBuilder<Doc = any> = (builder: ReturnType<typeof makeLoaderBuilder<Doc>>) => {

package/document/queryEvaluator.ts

@@ -217,7 +217,12 @@ export class DocumentQueryEvaluator {
         return this.#has(read, operand);
       case "contains":
         
-        return read.value !== null && String(read.value).toLowerCase().includes(String(operand).toLowerCase());
+        return (
+          read.value !== null &&
+          DocumentQueryEvaluator.#foldAscii(String(read.value)).includes(
+            DocumentQueryEvaluator.#foldAscii(String(operand)),
+          )
+        );
     }
   }
 
@@ -313,6 +318,10 @@ export class DocumentQueryEvaluator {
     return leftPoints.length === rightPoints.length ? 0 : leftPoints.length < rightPoints.length ? -1 : 1;
   }
 
+  static #foldAscii(text: string) {
+    return text.replace(/[A-Z]/g, (char) => char.toLowerCase());
+  }
+
   static #isNode(value: unknown): value is DocumentQueryNode {
     return !!value && typeof value === "object" && "kind" in value;
   }

package/fetch/client/fetchClient.ts

@@ -544,7 +544,7 @@ export class FetchClient {
 
     const anyCruGuards = signal.cruGuards ?? signal.createGuards ?? signal.updateGuards ?? signal.removeGuards;
     const updateGuards = signal.updateGuards ?? signal.cruGuards;
-    if (anyCruGuards) {
+    if (signal.getGuards) {
       this.#setHandlerFactory(names.viewModel, () =>
         this.#makeModelHandleFn(refName, names.model, names.viewModel, `${refName}View`),
       );
@@ -557,6 +557,8 @@ export class FetchClient {
             return { refName, [`${refName}Obj`]: modelObj, [`${refName}ViewAt`]: new Date() };
           }) as FetchHandler,
       );
+    }
+    if (signal.getGuards && anyCruGuards) {
       this.#setHandlerFactory(names.editModel, () =>
         this.#makeModelHandleFn(refName, names.model, names.editModel, `${refName}Edit`),
       );
@@ -569,17 +571,17 @@ export class FetchClient {
             return { refName, [`${refName}Obj`]: modelObj, [`${refName}ViewAt`]: new Date() };
           }) as FetchHandler,
       );
-      if (updateGuards) {
-        this.#setHandlerFactory(
-          names.mergeModel,
-          () =>
-            (async (modelOrId: string | { id: string }, data: UnknownRecord, option?: FetchPolicy) => {
-              const id = typeof modelOrId === "string" ? modelOrId : modelOrId.id;
-              const updateFn = this.#requireHandler(names.updateModel, names.mergeModel);
-              return await updateFn(id, data, option);
-            }) as FetchHandler,
-        );
-      }
+    }
+    if (updateGuards) {
+      this.#setHandlerFactory(
+        names.mergeModel,
+        () =>
+          (async (modelOrId: string | { id: string }, data: UnknownRecord, option?: FetchPolicy) => {
+            const id = typeof modelOrId === "string" ? modelOrId : modelOrId.id;
+            const updateFn = this.#requireHandler(names.updateModel, names.mergeModel);
+            return await updateFn(id, data, option);
+          }) as FetchHandler,
+      );
     }
 
     this.#setHandlerFactory(

package/fetch/client/httpClient.ts

@@ -207,7 +207,7 @@ export class HttpClient {
     const searchPath = searchParams.size > 0 ? `?${searchParams.toString()}` : "";
     const paramedPath = path.replace(/:(\w+)/g, (match, p1) => {
       const value = argMap.get(p1);
-      return value === null || value === undefined ? match : String(value);
+      return value === null || value === undefined ? match : encodeURIComponent(String(value));
     });
     return `${paramedPath}${searchPath}`;
   }

package/index.ts

@@ -229,9 +229,18 @@ export interface AkanApiConfig {
   websocketPrefix: string;
 }
 
+export interface AkanDatabaseConfig {
+  /**
+   * The modes this app's build can run in. `akan build` bundles the drivers of each, the image lets a deployment
+   * pick one of them with `AKAN_DATABASE_MODE` and no other, and `akan start` runs the first unless the shell names
+   * another. A deployment of a build carrying several has to name one.
+   */
+  modes: DatabaseMode[];
+}
+
 export interface AppConfigResult {
   docker: DockerConfig;
-  defaultDatabaseMode: DatabaseMode;
+  database: AkanDatabaseConfig;
   /**
    * Where this app mounts its endpoints. Declared here rather than only in `main.ts` because the value is baked
    * into every client bundle: a prebuilt CSR shell or a mobile bundle never reaches the server that would tell

package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0001.log

@@ -0,0 +1,44 @@
+[crossTest] 58035 - 09/25/2026, 16:51:41 PM VERBOSE  crossTest is serving on port 47811 +114ms
+[crossTest] 58035 - 09/25/2026, 16:51:41 PM VERBOSE  🚀 crossTest is running on port 47811 +117ms
+[scheduler] 58035 - 09/25/2026, 16:52:41 PM   DEBUG  Schedule interval searchIndexRetry finished 2ms +60110ms
+[scheduler] 58035 - 09/25/2026, 16:53:41 PM   DEBUG  Schedule interval searchIndexRetry finished 1ms +120110ms
+[crossTest] 58035 - 09/25/2026, 16:53:57 PM   DEBUG  Received SIGTERM, starting graceful shutdown... +135947ms
+[crossTest] 58035 - 09/25/2026, 16:53:57 PM    INFO  Shutting down gracefully... +135947ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Running destroy internals... +135947ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroy internals in 1ms +135948ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroying services... +135948ms
+[BaseService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  base service destroying... +135948ms
+[AgentService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  agent service destroying... +135948ms
+[CrossItemService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  crossItem service destroying... +135948ms
+[BaseService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  base service destroyed in 0ms +135948ms
+[AgentService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  agent service destroyed in 0ms +135948ms
+[CrossItemService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  crossItem service destroyed in 0ms +135948ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroy services in 0ms +135948ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroying adaptors... +135948ms
+[crossItemModel] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  crossItemModel adaptor destroying... +135948ms
+[crossItemModel] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  crossItemModel adaptor destroyed in 0ms +135948ms
+[sqliteDatabase] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  sqliteDatabase adaptor destroying... +135948ms
+[sqliteDatabase] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  sqliteDatabase adaptor destroyed in 5ms +135953ms
+[bullQueue] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  bullQueue adaptor destroying... +135953ms
+[scheduler] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  scheduler adaptor destroying... +135953ms
+[wsRedis] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  wsRedis adaptor destroying... +135953ms
+[scheduler] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  scheduler adaptor destroyed in 0ms +135953ms
+[bullQueue] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  bullQueue adaptor destroyed in 0ms +135953ms
+[wsRedis] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  WebSocket Redis adaptor destroyed +135957ms
+[wsRedis] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  wsRedis adaptor destroyed in 4ms +135957ms
+[redisCache] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  redisCache adaptor destroying... +135957ms
+[blobStorage] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  blobStorage adaptor destroying... +135957ms
+[consoleLogger] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  consoleLogger adaptor destroying... +135957ms
+[jsonCompressor] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  jsonCompressor adaptor destroying... +135957ms
+[openaiLlm] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  openaiLlm adaptor destroying... +135957ms
+[llmAdaptorRole] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  llmAdaptorRole adaptor destroying... +135957ms
+[redisCache] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  redisCache adaptor destroyed in 0ms +135957ms
+[blobStorage] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  blobStorage adaptor destroyed in 0ms +135957ms
+[consoleLogger] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  consoleLogger adaptor destroyed in 0ms +135957ms
+[jsonCompressor] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  jsonCompressor adaptor destroyed in 0ms +135957ms
+[openaiLlm] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  openaiLlm adaptor destroyed in 0ms +135957ms
+[llmAdaptorRole] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  llmAdaptorRole adaptor destroyed in 0ms +135957ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroy adaptors in 9ms +135957ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroying uses... +135957ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroy uses in 0ms +135957ms
+[crossTest] 58035 - 09/25/2026, 16:53:57 PM    INFO  Shutdown completed successfully in 10ms +135957ms

package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0002.log

@@ -0,0 +1,42 @@
+[crossTest] 59872 - 09/25/2026, 16:53:58 PM VERBOSE  crossTest is serving on port 47811 +109ms
+[crossTest] 59872 - 09/25/2026, 16:53:58 PM VERBOSE  🚀 crossTest is running on port 47811 +112ms
+[crossTest] 59872 - 09/25/2026, 16:54:10 PM   DEBUG  Received SIGTERM, starting graceful shutdown... +11999ms
+[crossTest] 59872 - 09/25/2026, 16:54:10 PM    INFO  Shutting down gracefully... +11999ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Running destroy internals... +12000ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroy internals in 0ms +12000ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroying services... +12000ms
+[BaseService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  base service destroying... +12000ms
+[AgentService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  agent service destroying... +12000ms
+[CrossItemService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  crossItem service destroying... +12000ms
+[BaseService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  base service destroyed in 0ms +12000ms
+[AgentService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  agent service destroyed in 0ms +12000ms
+[CrossItemService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  crossItem service destroyed in 0ms +12000ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroy services in 0ms +12000ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroying adaptors... +12000ms
+[crossItemModel] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  crossItemModel adaptor destroying... +12000ms
+[crossItemModel] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  crossItemModel adaptor destroyed in 0ms +12000ms
+[sqliteDatabase] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  sqliteDatabase adaptor destroying... +12000ms
+[sqliteDatabase] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  sqliteDatabase adaptor destroyed in 5ms +12005ms
+[bullQueue] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  bullQueue adaptor destroying... +12005ms
+[scheduler] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  scheduler adaptor destroying... +12005ms
+[wsRedis] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  wsRedis adaptor destroying... +12005ms
+[scheduler] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  scheduler adaptor destroyed in 1ms +12006ms
+[bullQueue] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  bullQueue adaptor destroyed in 1ms +12006ms
+[wsRedis] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  WebSocket Redis adaptor destroyed +12010ms
+[wsRedis] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  wsRedis adaptor destroyed in 5ms +12010ms
+[redisCache] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  redisCache adaptor destroying... +12010ms
+[blobStorage] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  blobStorage adaptor destroying... +12010ms
+[consoleLogger] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  consoleLogger adaptor destroying... +12010ms
+[jsonCompressor] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  jsonCompressor adaptor destroying... +12010ms
+[openaiLlm] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  openaiLlm adaptor destroying... +12010ms
+[llmAdaptorRole] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  llmAdaptorRole adaptor destroying... +12010ms
+[redisCache] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  redisCache adaptor destroyed in 0ms +12010ms
+[blobStorage] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  blobStorage adaptor destroyed in 0ms +12010ms
+[consoleLogger] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  consoleLogger adaptor destroyed in 0ms +12010ms
+[jsonCompressor] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  jsonCompressor adaptor destroyed in 0ms +12010ms
+[openaiLlm] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  openaiLlm adaptor destroyed in 0ms +12010ms
+[llmAdaptorRole] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  llmAdaptorRole adaptor destroyed in 0ms +12010ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroy adaptors in 10ms +12010ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroying uses... +12010ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroy uses in 0ms +12010ms
+[crossTest] 59872 - 09/25/2026, 16:54:10 PM    INFO  Shutdown completed successfully in 11ms +12010ms

package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0003.log

@@ -0,0 +1,43 @@
+[crossTest] 60280 - 09/25/2026, 16:54:26 PM VERBOSE  crossTest is serving on port 47811 +111ms
+[crossTest] 60280 - 09/25/2026, 16:54:26 PM VERBOSE  🚀 crossTest is running on port 47811 +114ms
+[scheduler] 60280 - 09/25/2026, 16:55:26 PM   DEBUG  Schedule interval searchIndexRetry finished 3ms +60108ms
+[crossTest] 60280 - 09/25/2026, 16:56:12 PM   DEBUG  Received SIGTERM, starting graceful shutdown... +105905ms
+[crossTest] 60280 - 09/25/2026, 16:56:12 PM    INFO  Shutting down gracefully... +105905ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Running destroy internals... +105905ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroy internals in 0ms +105905ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroying services... +105905ms
+[BaseService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  base service destroying... +105906ms
+[AgentService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  agent service destroying... +105906ms
+[CrossItemService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  crossItem service destroying... +105906ms
+[BaseService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  base service destroyed in 0ms +105906ms
+[AgentService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  agent service destroyed in 0ms +105906ms
+[CrossItemService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  crossItem service destroyed in 0ms +105906ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroy services in 1ms +105906ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroying adaptors... +105906ms
+[crossItemModel] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  crossItemModel adaptor destroying... +105906ms
+[crossItemModel] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  crossItemModel adaptor destroyed in 0ms +105906ms
+[sqliteDatabase] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  sqliteDatabase adaptor destroying... +105906ms
+[sqliteDatabase] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  sqliteDatabase adaptor destroyed in 4ms +105910ms
+[bullQueue] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  bullQueue adaptor destroying... +105910ms
+[scheduler] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  scheduler adaptor destroying... +105910ms
+[wsRedis] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  wsRedis adaptor destroying... +105910ms
+[scheduler] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  scheduler adaptor destroyed in 1ms +105911ms
+[bullQueue] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  bullQueue adaptor destroyed in 1ms +105911ms
+[wsRedis] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  WebSocket Redis adaptor destroyed +105912ms
+[wsRedis] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  wsRedis adaptor destroyed in 2ms +105912ms
+[redisCache] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  redisCache adaptor destroying... +105912ms
+[blobStorage] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  blobStorage adaptor destroying... +105912ms
+[consoleLogger] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  consoleLogger adaptor destroying... +105912ms
+[jsonCompressor] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  jsonCompressor adaptor destroying... +105912ms
+[openaiLlm] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  openaiLlm adaptor destroying... +105912ms
+[llmAdaptorRole] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  llmAdaptorRole adaptor destroying... +105912ms
+[redisCache] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  redisCache adaptor destroyed in 0ms +105912ms
+[blobStorage] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  blobStorage adaptor destroyed in 0ms +105912ms
+[consoleLogger] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  consoleLogger adaptor destroyed in 0ms +105912ms
+[jsonCompressor] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  jsonCompressor adaptor destroyed in 0ms +105912ms
+[openaiLlm] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  openaiLlm adaptor destroyed in 1ms +105913ms
+[llmAdaptorRole] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  llmAdaptorRole adaptor destroyed in 1ms +105913ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroy adaptors in 7ms +105913ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroying uses... +105913ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroy uses in 0ms +105913ms
+[crossTest] 60280 - 09/25/2026, 16:56:12 PM    INFO  Shutdown completed successfully in 8ms +105913ms

package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0004.log

@@ -0,0 +1,44 @@
+[crossTest] 61977 - 09/25/2026, 16:56:22 PM VERBOSE  crossTest is serving on port 47811 +113ms
+[crossTest] 61977 - 09/25/2026, 16:56:22 PM VERBOSE  🚀 crossTest is running on port 47811 +116ms
+[crossItemSliceEndpoint] 61977 - 09/25/2026, 16:56:22 PM   DEBUG  Before mutation-createCrossItem / 1790322982110 +171ms
+[crossItemSliceEndpoint] 61977 - 09/25/2026, 16:56:22 PM   DEBUG  After mutation-createCrossItem / 2ms +173ms
+[crossTest] 61977 - 09/25/2026, 16:57:03 PM   DEBUG  Received SIGTERM, starting graceful shutdown... +41514ms
+[crossTest] 61977 - 09/25/2026, 16:57:03 PM    INFO  Shutting down gracefully... +41515ms
+[DiLifecycle] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  Running destroy internals... +41515ms
+[DiLifecycle] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  Destroy internals in 0ms +41515ms
+[DiLifecycle] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  Destroying services... +41515ms
+[BaseService] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  base service destroying... +41515ms
+[AgentService] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  agent service destroying... +41515ms
+[CrossItemService] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  crossItem service destroying... +41515ms
+[BaseService] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  base service destroyed in 0ms +41515ms
+[AgentService] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  agent service destroyed in 0ms +41515ms
+[CrossItemService] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  crossItem service destroyed in 0ms +41515ms
+[DiLifecycle] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  Destroy services in 0ms +41515ms
+[DiLifecycle] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  Destroying adaptors... +41515ms
+[crossItemModel] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  crossItemModel adaptor destroying... +41515ms
+[crossItemModel] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  crossItemModel adaptor destroyed in 1ms +41516ms
+[sqliteDatabase] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  sqliteDatabase adaptor destroying... +41516ms
+[sqliteDatabase] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  sqliteDatabase adaptor destroyed in 3ms +41519ms
+[bullQueue] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  bullQueue adaptor destroying... +41519ms
+[scheduler] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  scheduler adaptor destroying... +41519ms
+[wsRedis] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  wsRedis adaptor destroying... +41519ms
+[scheduler] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  scheduler adaptor destroyed in 0ms +41519ms
+[bullQueue] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  bullQueue adaptor destroyed in 0ms +41519ms
+[wsRedis] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  WebSocket Redis adaptor destroyed +41521ms
+[wsRedis] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  wsRedis adaptor destroyed in 2ms +41521ms
+[redisCache] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  redisCache adaptor destroying... +41521ms
+[blobStorage] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  blobStorage adaptor destroying... +41521ms
+[consoleLogger] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  consoleLogger adaptor destroying... +41521ms
+[jsonCompressor] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  jsonCompressor adaptor destroying... +41521ms
+[openaiLlm] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  openaiLlm adaptor destroying... +41521ms
+[llmAdaptorRole] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  llmAdaptorRole adaptor destroying... +41521ms
+[redisCache] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  redisCache adaptor destroyed in 0ms +41521ms
+[blobStorage] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  blobStorage adaptor destroyed in 0ms +41521ms
+[consoleLogger] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  consoleLogger adaptor destroyed in 0ms +41521ms
+[jsonCompressor] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  jsonCompressor adaptor destroyed in 0ms +41521ms
+[openaiLlm] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  openaiLlm adaptor destroyed in 0ms +41521ms
+[llmAdaptorRole] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  llmAdaptorRole adaptor destroyed in 0ms +41521ms
+[DiLifecycle] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  Destroy adaptors in 6ms +41521ms
+[DiLifecycle] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  Destroying uses... +41521ms
+[DiLifecycle] 61977 - 09/25/2026, 16:57:03 PM VERBOSE  Destroy uses in 0ms +41521ms
+[crossTest] 61977 - 09/25/2026, 16:57:03 PM    INFO  Shutdown completed successfully in 6ms +41521ms