akanjs 3.0.0-alpha.20 → 3.0.0-alpha.21

package/package.json

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

package/server/akanOption.ts

@@ -1,4 +1,4 @@
-import type { BaseEnv, PromiseOrObject } from "akanjs/base";
+import type { BackendEnv, PromiseOrObject } from "akanjs/base";
 import type { Adaptor, AdaptorCls, LlmOption } from "akanjs/service";
 import type { AgentRelayPolicy, MiddlewareCls } from "akanjs/signal";
 import type { McpServerOption } from "./akanServer";
@@ -14,7 +14,7 @@ export interface AdaptorOverride {
  * App/library server option builder: use objects, signal middleware, adaptor overrides, web proxies, and the
  * server settings an app owns — MCP, the agent relay's access policy, and the LLM the relay speaks to.
  */
-export class AkanOption<Env extends BaseEnv = BaseEnv> {
+export class AkanOption<Env = unknown> {
   readonly #getUses: ((env: Env) => Record<string, PromiseOrObject<unknown>>)[];
   readonly #middlewares: MiddlewareCls[] = [];
   readonly #adaptorOverrides: AdaptorOverride[] = [];
@@ -25,7 +25,11 @@ export class AkanOption<Env extends BaseEnv = BaseEnv> {
   constructor() {
     this.#getUses = [];
   }
-  use(fnOrObject: ((env: Env) => Record<string, PromiseOrObject<unknown>>) | Record<string, PromiseOrObject<unknown>>) {
+  use(
+    fnOrObject:
+      | ((env: Env & BackendEnv) => Record<string, PromiseOrObject<unknown>>)
+      | Record<string, PromiseOrObject<unknown>>,
+  ) {
     if (typeof fnOrObject === "function")
       this.#getUses.push(fnOrObject as (env: Env) => Record<string, PromiseOrObject<unknown>>);
     else this.#getUses.push(() => fnOrObject);
@@ -67,7 +71,7 @@ export class AkanOption<Env extends BaseEnv = BaseEnv> {
     else this.#getLlms.push(() => llmOrFn);
     return this;
   }
-  getUses(env: Env): Record<string, PromiseOrObject<unknown>> {
+  getUses(env: Env & BackendEnv): Record<string, PromiseOrObject<unknown>> {
     const uses = this.#getUses.map((fn) => fn(env));
     return Object.assign({}, ...uses);
   }
@@ -86,11 +90,11 @@ export class AkanOption<Env extends BaseEnv = BaseEnv> {
   getAgentAccess(): AgentRelayPolicy | null | undefined {
     return this.#agentAccess;
   }
-  getLlm(env: Env): LlmOption {
+  getLlm(env: Env & BackendEnv): LlmOption {
     return Object.assign({}, ...this.#getLlms.map((fn) => fn(env)));
   }
 }
 
 export function createDefaultAkanOption() {
-  return new AkanOption<BaseEnv>().applyWebProxy(LocaleWebProxy, HostBasePathWebProxy);
+  return new AkanOption().applyWebProxy(LocaleWebProxy, HostBasePathWebProxy);
 }

package/server/akanServer.ts

@@ -129,7 +129,7 @@ export class AkanServer {
   #metricsTimer: Timer | null = null;
   constructor(
     name = "AkanServer",
-    env: BaseEnv = getEnv(),
+    env = {},
     serverMode: "federation" | "batch" | "all" = (process.env.SERVER_MODE as
       | "federation"
       | "batch"
@@ -141,7 +141,7 @@ export class AkanServer {
     this.name = name;
     this.logger = new Logger(name);
     this.libs = libs;
-    this.env = { ...env };
+    this.env = Object.assign(getEnv(), env);
     this.openapi = options?.openapi ?? this.openapi;
     
     libs.forEach((lib) => {

package/types/server/akanOption.d.ts

@@ -1,4 +1,4 @@
-import type { BaseEnv, PromiseOrObject } from "akanjs/base";
+import type { BackendEnv, PromiseOrObject } from "akanjs/base";
 import type { Adaptor, AdaptorCls, LlmOption } from "akanjs/service";
 import type { AgentRelayPolicy, MiddlewareCls } from "akanjs/signal";
 import type { McpServerOption } from "./akanServer.d.ts";
@@ -11,10 +11,10 @@ export interface AdaptorOverride {
  * App/library server option builder: use objects, signal middleware, adaptor overrides, web proxies, and the
  * server settings an app owns — MCP, the agent relay's access policy, and the LLM the relay speaks to.
  */
-export declare class AkanOption<Env extends BaseEnv = BaseEnv> {
+export declare class AkanOption<Env = unknown> {
     #private;
     constructor();
-    use(fnOrObject: ((env: Env) => Record<string, PromiseOrObject<unknown>>) | Record<string, PromiseOrObject<unknown>>): this;
+    use(fnOrObject: ((env: Env & BackendEnv) => Record<string, PromiseOrObject<unknown>>) | Record<string, PromiseOrObject<unknown>>): this;
     applyMiddleware(...middlewares: MiddlewareCls[]): this;
     /** Rebinds a predefined adaptor role (e.g. `LlmAdaptorRole`) to the app's own implementation. Last writer wins. */
     applyAdaptor<T extends Adaptor>(role: AdaptorCls<T>, adaptor: AdaptorCls<T>): this;
@@ -32,12 +32,12 @@ export declare class AkanOption<Env extends BaseEnv = BaseEnv> {
     setAgentAccess(policy: AgentRelayPolicy | null): this;
     /** Settings for whichever adaptor fills `LlmAdaptorRole`, injected into it as the `llmOption` use. */
     setLlm(llmOrFn: LlmOption | ((env: Env) => LlmOption)): this;
-    getUses(env: Env): Record<string, PromiseOrObject<unknown>>;
+    getUses(env: Env & BackendEnv): Record<string, PromiseOrObject<unknown>>;
     getMiddlewares(): MiddlewareCls[];
     getAdaptorOverrides(): AdaptorOverride[];
     getWebProxies(): WebProxyRegistration[];
     getMcp(): boolean | McpServerOption | undefined;
     getAgentAccess(): AgentRelayPolicy | null | undefined;
-    getLlm(env: Env): LlmOption;
+    getLlm(env: Env & BackendEnv): LlmOption;
 }
-export declare function createDefaultAkanOption(): AkanOption<BaseEnv>;
+export declare function createDefaultAkanOption(): AkanOption<unknown>;

package/types/server/akanServer.d.ts

@@ -81,7 +81,7 @@ export declare class AkanServer {
     mcpOption: Omit<McpServerOption, "enabled" | "readOnly" | "auth">;
     serverMode: "federation" | "batch" | "all";
     shutdownTimeoutMs: number;
-    constructor(name?: string, env?: BaseEnv, serverMode?: "federation" | "batch" | "all", ...libsOrOptions: (AkanLib | AkanServerOptions)[]);
+    constructor(name?: string, env?: {}, serverMode?: "federation" | "batch" | "all", ...libsOrOptions: (AkanLib | AkanServerOptions)[]);
     setPrefix(prefix: string): this;
     setWebsocketPrefix(websocketPrefix: string): this;
     setOpenApi(openapi?: boolean): this;