@axlsdk/axl 0.6.0 → 0.7.1

package/dist/index.d.cts

@@ -462,6 +462,63 @@ type Agent = {
  */
 declare function agent(config: AgentConfig): Agent;
 
+/** A pending human decision awaiting resolution. */
+type PendingDecision = {
+    executionId: string;
+    channel: string;
+    prompt: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+};
+/** Persisted execution state for suspend/resume. */
+type ExecutionState = {
+    workflow: string;
+    input: unknown;
+    step: number;
+    status: 'waiting' | 'running';
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Pluggable state persistence interface.
+ *
+ * Built-in implementations: MemoryStore (testing), SQLiteStore (file-based),
+ * Redis (production).
+ */
+interface StateStore {
+    saveCheckpoint(executionId: string, step: number, data: unknown): Promise<void>;
+    getCheckpoint(executionId: string, step: number): Promise<unknown | null>;
+    getLatestCheckpoint(executionId: string): Promise<{
+        step: number;
+        data: unknown;
+    } | null>;
+    saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
+    getSession(sessionId: string): Promise<ChatMessage[]>;
+    deleteSession(sessionId: string): Promise<void>;
+    saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
+    getSessionMeta(sessionId: string, key: string): Promise<unknown | null>;
+    savePendingDecision(executionId: string, decision: PendingDecision): Promise<void>;
+    getPendingDecisions(): Promise<PendingDecision[]>;
+    resolveDecision(executionId: string, result: HumanDecision): Promise<void>;
+    saveExecutionState(executionId: string, state: ExecutionState): Promise<void>;
+    getExecutionState(executionId: string): Promise<ExecutionState | null>;
+    listPendingExecutions(): Promise<string[]>;
+    /** Save a memory entry (key-value). */
+    saveMemory?(scope: string, key: string, value: unknown): Promise<void>;
+    /** Get a memory entry by key. */
+    getMemory?(scope: string, key: string): Promise<unknown | null>;
+    /** Get all memory entries for a scope. */
+    getAllMemory?(scope: string): Promise<Array<{
+        key: string;
+        value: unknown;
+    }>>;
+    /** Delete a memory entry by key. */
+    deleteMemory?(scope: string, key: string): Promise<void>;
+    /** List all session IDs (used by Studio session browser). */
+    listSessions?(): Promise<string[]>;
+    close?(): Promise<void>;
+    deleteCheckpoints?(executionId: string): Promise<void>;
+}
+
 /** Configuration for OpenTelemetry integration. */
 type TelemetryConfig = {
     /** Whether telemetry is enabled. Defaults to false. */
@@ -560,15 +617,13 @@ type TraceConfig = {
     /** When true, redact prompt/response data from agent_call trace events to prevent PII leakage. */
     redact?: boolean;
 };
+
 /** State store configuration */
 type StateConfig = {
-    store?: 'memory' | 'sqlite' | 'redis';
+    store?: StateStore | 'memory' | 'sqlite';
     sqlite?: {
         path: string;
     };
-    redis?: {
-        url: string;
-    };
 };
 /** Global defaults */
 type DefaultsConfig = {
@@ -680,63 +735,6 @@ declare class ProviderRegistry {
     clearFactories(): void;
 }
 
-/** A pending human decision awaiting resolution. */
-type PendingDecision = {
-    executionId: string;
-    channel: string;
-    prompt: string;
-    metadata?: Record<string, unknown>;
-    createdAt: string;
-};
-/** Persisted execution state for suspend/resume. */
-type ExecutionState = {
-    workflow: string;
-    input: unknown;
-    step: number;
-    status: 'waiting' | 'running';
-    metadata?: Record<string, unknown>;
-};
-/**
- * Pluggable state persistence interface.
- *
- * Built-in implementations: MemoryStore (testing), SQLiteStore (file-based),
- * Redis (production).
- */
-interface StateStore {
-    saveCheckpoint(executionId: string, step: number, data: unknown): Promise<void>;
-    getCheckpoint(executionId: string, step: number): Promise<unknown | null>;
-    getLatestCheckpoint(executionId: string): Promise<{
-        step: number;
-        data: unknown;
-    } | null>;
-    saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
-    getSession(sessionId: string): Promise<ChatMessage[]>;
-    deleteSession(sessionId: string): Promise<void>;
-    saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
-    getSessionMeta(sessionId: string, key: string): Promise<unknown | null>;
-    savePendingDecision(executionId: string, decision: PendingDecision): Promise<void>;
-    getPendingDecisions(): Promise<PendingDecision[]>;
-    resolveDecision(executionId: string, result: HumanDecision): Promise<void>;
-    saveExecutionState(executionId: string, state: ExecutionState): Promise<void>;
-    getExecutionState(executionId: string): Promise<ExecutionState | null>;
-    listPendingExecutions(): Promise<string[]>;
-    /** Save a memory entry (key-value). */
-    saveMemory?(scope: string, key: string, value: unknown): Promise<void>;
-    /** Get a memory entry by key. */
-    getMemory?(scope: string, key: string): Promise<unknown | null>;
-    /** Get all memory entries for a scope. */
-    getAllMemory?(scope: string): Promise<Array<{
-        key: string;
-        value: unknown;
-    }>>;
-    /** Delete a memory entry by key. */
-    deleteMemory?(scope: string, key: string): Promise<void>;
-    /** List all session IDs (used by Studio session browser). */
-    listSessions?(): Promise<string[]>;
-    close?(): Promise<void>;
-    deleteCheckpoints?(executionId: string): Promise<void>;
-}
-
 /**
  * MCP (Model Context Protocol) types for tool discovery and execution.
  */
@@ -1688,17 +1686,23 @@ declare class SQLiteStore implements StateStore {
 }
 
 /**
- * Redis-backed StateStore using ioredis.
+ * Redis-backed StateStore using the official `redis` (node-redis) client.
  *
  * Designed for multi-process and sidecar deployments where
  * multiple runtime instances need shared state.
  *
- * Requires `ioredis` as a peer dependency. If not installed,
- * the constructor throws a clear error message.
+ * Requires `redis` as a peer dependency. Create instances via the
+ * async `RedisStore.create()` factory, which connects before returning.
  */
 declare class RedisStore implements StateStore {
     private client;
-    constructor(url?: string);
+    private constructor();
+    /**
+     * Create a connected RedisStore instance.
+     *
+     * @param url - Redis connection URL (e.g. `redis://localhost:6379`). Defaults to `redis://localhost:6379`.
+     */
+    static create(url?: string): Promise<RedisStore>;
     private checkpointKey;
     private sessionKey;
     private sessionMetaKey;

package/dist/index.d.ts

@@ -462,6 +462,63 @@ type Agent = {
  */
 declare function agent(config: AgentConfig): Agent;
 
+/** A pending human decision awaiting resolution. */
+type PendingDecision = {
+    executionId: string;
+    channel: string;
+    prompt: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+};
+/** Persisted execution state for suspend/resume. */
+type ExecutionState = {
+    workflow: string;
+    input: unknown;
+    step: number;
+    status: 'waiting' | 'running';
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Pluggable state persistence interface.
+ *
+ * Built-in implementations: MemoryStore (testing), SQLiteStore (file-based),
+ * Redis (production).
+ */
+interface StateStore {
+    saveCheckpoint(executionId: string, step: number, data: unknown): Promise<void>;
+    getCheckpoint(executionId: string, step: number): Promise<unknown | null>;
+    getLatestCheckpoint(executionId: string): Promise<{
+        step: number;
+        data: unknown;
+    } | null>;
+    saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
+    getSession(sessionId: string): Promise<ChatMessage[]>;
+    deleteSession(sessionId: string): Promise<void>;
+    saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
+    getSessionMeta(sessionId: string, key: string): Promise<unknown | null>;
+    savePendingDecision(executionId: string, decision: PendingDecision): Promise<void>;
+    getPendingDecisions(): Promise<PendingDecision[]>;
+    resolveDecision(executionId: string, result: HumanDecision): Promise<void>;
+    saveExecutionState(executionId: string, state: ExecutionState): Promise<void>;
+    getExecutionState(executionId: string): Promise<ExecutionState | null>;
+    listPendingExecutions(): Promise<string[]>;
+    /** Save a memory entry (key-value). */
+    saveMemory?(scope: string, key: string, value: unknown): Promise<void>;
+    /** Get a memory entry by key. */
+    getMemory?(scope: string, key: string): Promise<unknown | null>;
+    /** Get all memory entries for a scope. */
+    getAllMemory?(scope: string): Promise<Array<{
+        key: string;
+        value: unknown;
+    }>>;
+    /** Delete a memory entry by key. */
+    deleteMemory?(scope: string, key: string): Promise<void>;
+    /** List all session IDs (used by Studio session browser). */
+    listSessions?(): Promise<string[]>;
+    close?(): Promise<void>;
+    deleteCheckpoints?(executionId: string): Promise<void>;
+}
+
 /** Configuration for OpenTelemetry integration. */
 type TelemetryConfig = {
     /** Whether telemetry is enabled. Defaults to false. */
@@ -560,15 +617,13 @@ type TraceConfig = {
     /** When true, redact prompt/response data from agent_call trace events to prevent PII leakage. */
     redact?: boolean;
 };
+
 /** State store configuration */
 type StateConfig = {
-    store?: 'memory' | 'sqlite' | 'redis';
+    store?: StateStore | 'memory' | 'sqlite';
     sqlite?: {
         path: string;
     };
-    redis?: {
-        url: string;
-    };
 };
 /** Global defaults */
 type DefaultsConfig = {
@@ -680,63 +735,6 @@ declare class ProviderRegistry {
     clearFactories(): void;
 }
 
-/** A pending human decision awaiting resolution. */
-type PendingDecision = {
-    executionId: string;
-    channel: string;
-    prompt: string;
-    metadata?: Record<string, unknown>;
-    createdAt: string;
-};
-/** Persisted execution state for suspend/resume. */
-type ExecutionState = {
-    workflow: string;
-    input: unknown;
-    step: number;
-    status: 'waiting' | 'running';
-    metadata?: Record<string, unknown>;
-};
-/**
- * Pluggable state persistence interface.
- *
- * Built-in implementations: MemoryStore (testing), SQLiteStore (file-based),
- * Redis (production).
- */
-interface StateStore {
-    saveCheckpoint(executionId: string, step: number, data: unknown): Promise<void>;
-    getCheckpoint(executionId: string, step: number): Promise<unknown | null>;
-    getLatestCheckpoint(executionId: string): Promise<{
-        step: number;
-        data: unknown;
-    } | null>;
-    saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
-    getSession(sessionId: string): Promise<ChatMessage[]>;
-    deleteSession(sessionId: string): Promise<void>;
-    saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
-    getSessionMeta(sessionId: string, key: string): Promise<unknown | null>;
-    savePendingDecision(executionId: string, decision: PendingDecision): Promise<void>;
-    getPendingDecisions(): Promise<PendingDecision[]>;
-    resolveDecision(executionId: string, result: HumanDecision): Promise<void>;
-    saveExecutionState(executionId: string, state: ExecutionState): Promise<void>;
-    getExecutionState(executionId: string): Promise<ExecutionState | null>;
-    listPendingExecutions(): Promise<string[]>;
-    /** Save a memory entry (key-value). */
-    saveMemory?(scope: string, key: string, value: unknown): Promise<void>;
-    /** Get a memory entry by key. */
-    getMemory?(scope: string, key: string): Promise<unknown | null>;
-    /** Get all memory entries for a scope. */
-    getAllMemory?(scope: string): Promise<Array<{
-        key: string;
-        value: unknown;
-    }>>;
-    /** Delete a memory entry by key. */
-    deleteMemory?(scope: string, key: string): Promise<void>;
-    /** List all session IDs (used by Studio session browser). */
-    listSessions?(): Promise<string[]>;
-    close?(): Promise<void>;
-    deleteCheckpoints?(executionId: string): Promise<void>;
-}
-
 /**
  * MCP (Model Context Protocol) types for tool discovery and execution.
  */
@@ -1688,17 +1686,23 @@ declare class SQLiteStore implements StateStore {
 }
 
 /**
- * Redis-backed StateStore using ioredis.
+ * Redis-backed StateStore using the official `redis` (node-redis) client.
  *
  * Designed for multi-process and sidecar deployments where
  * multiple runtime instances need shared state.
  *
- * Requires `ioredis` as a peer dependency. If not installed,
- * the constructor throws a clear error message.
+ * Requires `redis` as a peer dependency. Create instances via the
+ * async `RedisStore.create()` factory, which connects before returning.
  */
 declare class RedisStore implements StateStore {
     private client;
-    constructor(url?: string);
+    private constructor();
+    /**
+     * Create a connected RedisStore instance.
+     *
+     * @param url - Redis connection URL (e.g. `redis://localhost:6379`). Defaults to `redis://localhost:6379`.
+     */
+    static create(url?: string): Promise<RedisStore>;
     private checkpointKey;
     private sessionKey;
     private sessionMetaKey;

package/dist/index.js

@@ -1983,10 +1983,13 @@ function resolveConfig(config) {
     resolved.defaultProvider = process.env.AXL_DEFAULT_PROVIDER;
   }
   if (process.env.AXL_STATE_STORE) {
-    resolved.state = {
-      ...resolved.state,
-      store: process.env.AXL_STATE_STORE
-    };
+    const envStore = process.env.AXL_STATE_STORE;
+    if (envStore === "memory" || envStore === "sqlite") {
+      resolved.state = {
+        ...resolved.state,
+        store: envStore
+      };
+    }
   }
   if (process.env.AXL_TRACE_ENABLED !== void 0) {
     resolved.trace = { ...resolved.trace, enabled: process.env.AXL_TRACE_ENABLED === "true" };
@@ -4113,122 +4116,6 @@ var SQLiteStore = class {
   }
 };
 
-// src/state/redis.ts
-var RedisStore = class {
-  client;
-  constructor(url) {
-    let Redis;
-    try {
-      const mod = __require("ioredis");
-      Redis = mod.default ?? mod;
-    } catch {
-      throw new Error("ioredis is required for RedisStore. Install it with: npm install ioredis");
-    }
-    this.client = url ? new Redis(url) : new Redis();
-  }
-  // ── Key helpers ──────────────────────────────────────────────────────
-  checkpointKey(executionId) {
-    return `axl:checkpoint:${executionId}`;
-  }
-  sessionKey(sessionId) {
-    return `axl:session:${sessionId}`;
-  }
-  sessionMetaKey(sessionId) {
-    return `axl:session-meta:${sessionId}`;
-  }
-  decisionsKey() {
-    return "axl:decisions";
-  }
-  executionStateKey(executionId) {
-    return `axl:exec-state:${executionId}`;
-  }
-  pendingExecSetKey() {
-    return "axl:pending-executions";
-  }
-  // ── Checkpoints ──────────────────────────────────────────────────────
-  async saveCheckpoint(executionId, step, data) {
-    await this.client.hset(this.checkpointKey(executionId), String(step), JSON.stringify(data));
-  }
-  async getCheckpoint(executionId, step) {
-    const raw = await this.client.hget(this.checkpointKey(executionId), String(step));
-    return raw !== null ? JSON.parse(raw) : null;
-  }
-  async getLatestCheckpoint(executionId) {
-    const all = await this.client.hgetall(this.checkpointKey(executionId));
-    if (!all || Object.keys(all).length === 0) return null;
-    let maxStep = -1;
-    let maxData = null;
-    for (const [stepStr, raw] of Object.entries(all)) {
-      const step = Number(stepStr);
-      if (step > maxStep) {
-        maxStep = step;
-        maxData = JSON.parse(raw);
-      }
-    }
-    return { step: maxStep, data: maxData };
-  }
-  // ── Sessions ─────────────────────────────────────────────────────────
-  async saveSession(sessionId, history) {
-    await this.client.set(this.sessionKey(sessionId), JSON.stringify(history));
-    await this.client.sadd("axl:session-ids", sessionId);
-  }
-  async getSession(sessionId) {
-    const raw = await this.client.get(this.sessionKey(sessionId));
-    return raw ? JSON.parse(raw) : [];
-  }
-  async deleteSession(sessionId) {
-    await this.client.del(this.sessionKey(sessionId));
-    await this.client.del(this.sessionMetaKey(sessionId));
-    await this.client.srem("axl:session-ids", sessionId);
-  }
-  async saveSessionMeta(sessionId, key, value) {
-    await this.client.hset(this.sessionMetaKey(sessionId), key, JSON.stringify(value));
-  }
-  async getSessionMeta(sessionId, key) {
-    const raw = await this.client.hget(this.sessionMetaKey(sessionId), key);
-    return raw !== null ? JSON.parse(raw) : null;
-  }
-  // ── Pending Decisions ────────────────────────────────────────────────
-  async savePendingDecision(executionId, decision) {
-    await this.client.hset(this.decisionsKey(), executionId, JSON.stringify(decision));
-  }
-  async getPendingDecisions() {
-    const all = await this.client.hgetall(this.decisionsKey());
-    if (!all) return [];
-    return Object.values(all).map((raw) => JSON.parse(raw));
-  }
-  async resolveDecision(executionId, _result) {
-    await this.client.hdel(this.decisionsKey(), executionId);
-  }
-  // ── Execution State ──────────────────────────────────────────────────
-  async saveExecutionState(executionId, state) {
-    await this.client.set(this.executionStateKey(executionId), JSON.stringify(state));
-    if (state.status === "waiting") {
-      await this.client.sadd(this.pendingExecSetKey(), executionId);
-    } else {
-      await this.client.srem(this.pendingExecSetKey(), executionId);
-    }
-  }
-  async getExecutionState(executionId) {
-    const raw = await this.client.get(this.executionStateKey(executionId));
-    return raw ? JSON.parse(raw) : null;
-  }
-  async listPendingExecutions() {
-    return this.client.smembers(this.pendingExecSetKey());
-  }
-  // ── Sessions (Studio introspection) ────────────────────────────────────
-  async listSessions() {
-    return this.client.smembers("axl:session-ids");
-  }
-  /** Close the Redis connection. */
-  async close() {
-    await this.client.quit();
-  }
-  async deleteCheckpoints(executionId) {
-    await this.client.del(this.checkpointKey(executionId));
-  }
-};
-
 // src/session.ts
 var Session = class _Session {
   constructor(sessionId, runtime, store, options) {
@@ -5114,12 +5001,11 @@ var AxlRuntime = class extends EventEmitter2 {
     return this.mcpManager;
   }
   createStateStore() {
-    const storeType = this.config.state?.store ?? "memory";
-    switch (storeType) {
+    const storeOption = this.config.state?.store ?? "memory";
+    if (typeof storeOption !== "string") return storeOption;
+    switch (storeOption) {
       case "sqlite":
         return new SQLiteStore(this.config.state?.sqlite?.path ?? "./data/axl.db");
-      case "redis":
-        return new RedisStore(this.config.state?.redis?.url);
       case "memory":
       default:
         return new MemoryStore();
@@ -5750,6 +5636,137 @@ var AxlRuntime = class extends EventEmitter2 {
   }
 };
 
+// src/state/redis.ts
+var RedisStore = class _RedisStore {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a connected RedisStore instance.
+   *
+   * @param url - Redis connection URL (e.g. `redis://localhost:6379`). Defaults to `redis://localhost:6379`.
+   */
+  static async create(url) {
+    let createClient;
+    try {
+      const mod = __require("redis");
+      createClient = mod.createClient ?? mod.default?.createClient;
+      if (typeof createClient !== "function") {
+        throw new Error(
+          "redis package does not export createClient. Ensure you have redis ^5.0.0 installed: npm install redis"
+        );
+      }
+    } catch (err) {
+      if (err instanceof Error && err.message.includes("createClient")) throw err;
+      throw new Error("redis is required for RedisStore. Install it with: npm install redis");
+    }
+    const client = url ? createClient({ url }) : createClient();
+    await client.connect();
+    return new _RedisStore(client);
+  }
+  // ── Key helpers ──────────────────────────────────────────────────────
+  checkpointKey(executionId) {
+    return `axl:checkpoint:${executionId}`;
+  }
+  sessionKey(sessionId) {
+    return `axl:session:${sessionId}`;
+  }
+  sessionMetaKey(sessionId) {
+    return `axl:session-meta:${sessionId}`;
+  }
+  decisionsKey() {
+    return "axl:decisions";
+  }
+  executionStateKey(executionId) {
+    return `axl:exec-state:${executionId}`;
+  }
+  pendingExecSetKey() {
+    return "axl:pending-executions";
+  }
+  // ── Checkpoints ──────────────────────────────────────────────────────
+  async saveCheckpoint(executionId, step, data) {
+    await this.client.hSet(this.checkpointKey(executionId), String(step), JSON.stringify(data));
+  }
+  async getCheckpoint(executionId, step) {
+    const raw = await this.client.hGet(this.checkpointKey(executionId), String(step));
+    return raw != null ? JSON.parse(raw) : null;
+  }
+  async getLatestCheckpoint(executionId) {
+    const all = await this.client.hGetAll(this.checkpointKey(executionId));
+    if (!all || Object.keys(all).length === 0) return null;
+    let maxStep = -1;
+    let maxData = null;
+    for (const [stepStr, raw] of Object.entries(all)) {
+      const step = Number(stepStr);
+      if (step > maxStep) {
+        maxStep = step;
+        maxData = JSON.parse(raw);
+      }
+    }
+    return { step: maxStep, data: maxData };
+  }
+  // ── Sessions ─────────────────────────────────────────────────────────
+  async saveSession(sessionId, history) {
+    await this.client.set(this.sessionKey(sessionId), JSON.stringify(history));
+    await this.client.sAdd("axl:session-ids", sessionId);
+  }
+  async getSession(sessionId) {
+    const raw = await this.client.get(this.sessionKey(sessionId));
+    return raw ? JSON.parse(raw) : [];
+  }
+  async deleteSession(sessionId) {
+    await this.client.del(this.sessionKey(sessionId));
+    await this.client.del(this.sessionMetaKey(sessionId));
+    await this.client.sRem("axl:session-ids", sessionId);
+  }
+  async saveSessionMeta(sessionId, key, value) {
+    await this.client.hSet(this.sessionMetaKey(sessionId), key, JSON.stringify(value));
+  }
+  async getSessionMeta(sessionId, key) {
+    const raw = await this.client.hGet(this.sessionMetaKey(sessionId), key);
+    return raw != null ? JSON.parse(raw) : null;
+  }
+  // ── Pending Decisions ────────────────────────────────────────────────
+  async savePendingDecision(executionId, decision) {
+    await this.client.hSet(this.decisionsKey(), executionId, JSON.stringify(decision));
+  }
+  async getPendingDecisions() {
+    const all = await this.client.hGetAll(this.decisionsKey());
+    if (!all) return [];
+    return Object.values(all).map((raw) => JSON.parse(raw));
+  }
+  async resolveDecision(executionId, _result) {
+    await this.client.hDel(this.decisionsKey(), executionId);
+  }
+  // ── Execution State ──────────────────────────────────────────────────
+  async saveExecutionState(executionId, state) {
+    await this.client.set(this.executionStateKey(executionId), JSON.stringify(state));
+    if (state.status === "waiting") {
+      await this.client.sAdd(this.pendingExecSetKey(), executionId);
+    } else {
+      await this.client.sRem(this.pendingExecSetKey(), executionId);
+    }
+  }
+  async getExecutionState(executionId) {
+    const raw = await this.client.get(this.executionStateKey(executionId));
+    return raw ? JSON.parse(raw) : null;
+  }
+  async listPendingExecutions() {
+    return this.client.sMembers(this.pendingExecSetKey());
+  }
+  // ── Sessions (Studio introspection) ────────────────────────────────────
+  async listSessions() {
+    return this.client.sMembers("axl:session-ids");
+  }
+  /** Close the Redis connection. */
+  async close() {
+    await this.client.quit();
+  }
+  async deleteCheckpoints(executionId) {
+    await this.client.del(this.checkpointKey(executionId));
+  }
+};
+
 // src/memory/embedder-openai.ts
 var OpenAIEmbedder = class {
   apiKey;