@123toto/ai-app-assistant-server 0.2.0 → 0.2.2

package/dist/{managed-server-BGQ-1jkx.d.ts → managed-server-CusQWWBB.d.ts}

@@ -37,7 +37,9 @@ interface AiAppAssistant {
 declare function createAiAppAssistant(options: AiAppAssistantOptions): AiAppAssistant;
 
 /** Providers available without installing an additional AI SDK package. */
-type BuiltInProvider = "anthropic" | "google" | "mistral" | "ollama" | "openai";
+declare const AI_APP_ASSISTANT_PROVIDERS: readonly ["anthropic", "google", "mistral", "ollama", "openai"];
+/** Provider identifier derived from the runtime-neutral exported catalog. */
+type BuiltInProvider = typeof AI_APP_ASSISTANT_PROVIDERS[number];
 /** Stable provider metadata suitable for a settings interface. */
 interface AiProviderInfo {
     id: BuiltInProvider;
@@ -246,6 +248,8 @@ interface AiAppAssistantConfigurationSynchronizer {
 }
 interface AiAppAssistantConfigurationManagerOptions {
     repository: AiAppAssistantConfigurationRepository;
+    /** Global kill switch. When false, no provider operation is allowed. */
+    enabled?: boolean | (() => boolean);
     /** Defaults to the local in-memory quota implementation. */
     quotaStore?: AiAppAssistantQuotaStore;
     /** Environment or deployment defaults. They are never persisted automatically. */
@@ -270,7 +274,7 @@ interface AiAppAssistantConfigurationSaveResult {
     configuration?: AiAppAssistantManagedConfigurationView;
     reloadRequired: boolean;
 }
-type AiAppAssistantManagementErrorCode = "unauthorized" | "forbidden" | "conflict" | "invalid_request" | "not_configured" | "quota_reached" | "secret_storage_unavailable";
+type AiAppAssistantManagementErrorCode = "unauthorized" | "forbidden" | "conflict" | "invalid_request" | "not_configured" | "assistant_disabled" | "quota_reached" | "secret_storage_unavailable";
 /** Framework-neutral policy error that HTTP adapters can map safely. */
 declare class AiAppAssistantManagementError extends Error {
     readonly status: number;
@@ -285,6 +289,8 @@ declare class AiAppAssistantManagementError extends Error {
 declare class AiAppAssistantConfigurationManager {
     #private;
     constructor(options: AiAppAssistantConfigurationManagerOptions);
+    /** Returns the current state of the host-controlled global kill switch. */
+    isEnabled(): boolean;
     /** Returns the built-in provider catalogue; no credentials are exposed. */
     listProviders(): AiProviderInfo[];
     /** Discovers models with an explicit key or the currently configured secret. */
@@ -329,6 +335,7 @@ declare class AiAppAssistantConfigurationManager {
     private connectionSignature;
     private lastKnownConnection;
     private now;
+    private assertEnabled;
     private publishAndEmit;
     private emit;
 }
@@ -530,4 +537,4 @@ interface ManagedAiAppAssistantServer<TIdentity extends AiAppAssistantRuntimeIde
  */
 declare function createManagedAiAppAssistantServer<TIdentity extends AiAppAssistantRuntimeIdentity, TNativeContext = undefined>(options: CreateManagedAiAppAssistantServerOptions<TIdentity, TNativeContext>): ManagedAiAppAssistantServer<TIdentity, TNativeContext>;
 
-export { createManagedAiAppAssistantRuntime as $, type AiAppAssistant as A, type BuiltInProvider as B, type AiAppAssistantRecentFailure as C, type AiAppAssistantRedisClient as D, type AiAppAssistantRedisQuotaClient as E, type AiAppAssistantRedisTelemetryClient as F, type AiAppAssistantRuntimeIdentity as G, type AiAppAssistantSecretProtector as H, type AiAppAssistantTelemetryStore as I, type AiAppAssistantTelemetrySummary as J, AiModelDiscoveryError as K, type AiModelInfo as L, type ManagedAiAppAssistantServer as M, type AiProviderInfo as N, type CreateAiAppAssistantConfigurationRepositoryOptions as O, type CreateManagedAiAppAssistantRuntimeOptions as P, type CreateManagedAiAppAssistantServerOptions as Q, type ListAiModelsOptions as R, type ManagedAiAppAssistantFetchHandlerOptions as S, type ManagedAiAppAssistantFetchHandlers as T, type ManagedAiAppAssistantRuntime as U, createAes256GcmSecretProtector as V, createAiAppAssistant as W, createAiAppAssistantConfigurationRepository as X, createAiAppAssistantFailureEvent as Y, createDisabledSecretProtector as Z, createManagedAiAppAssistantFetchHandlers as _, type AiAppAssistantStreamEvent as a, createManagedAiAppAssistantServer as a0, createMemoryAiAppAssistantQuotaStore as a1, createMemoryAiAppAssistantStore as a2, createMemoryAiAppAssistantTelemetryStore as a3, createPollingAiAppAssistantConfigurationSynchronizer as a4, createRedisAiAppAssistantQuotaStore as a5, createRedisAiAppAssistantStore as a6, createRedisAiAppAssistantTelemetryStore as a7, listAiModels as a8, listAiProviders as a9, validateAndSaveAiAppAssistantConfiguration as aa, type AiAppAssistantConfiguration as b, type AiAppAssistantAccessRule as c, type AiAppAssistantConfigurationActor as d, type AiAppAssistantConfigurationAdministration as e, type AiAppAssistantConfigurationAuditChange as f, type AiAppAssistantConfigurationAuditEntry as g, type AiAppAssistantConfigurationAuditField as h, type AiAppAssistantConfigurationChangeEvent as i, AiAppAssistantConfigurationConflictError as j, AiAppAssistantConfigurationManager as k, type AiAppAssistantConfigurationManagerOptions as l, type AiAppAssistantConfigurationRepository as m, type AiAppAssistantConfigurationSaveResult as n, type AiAppAssistantConfigurationSynchronizer as o, type AiAppAssistantConfigurationView as p, type AiAppAssistantGenerationEvent as q, type AiAppAssistantGenerationOperation as r, type AiAppAssistantKeyValueStore as s, type AiAppAssistantManagedConfigurationSetup as t, type AiAppAssistantManagedStorage as u, AiAppAssistantManagementError as v, type AiAppAssistantManagementErrorCode as w, type AiAppAssistantQuotaPolicy as x, type AiAppAssistantQuotaResult as y, type AiAppAssistantQuotaStore as z };
+export { createManagedAiAppAssistantFetchHandlers as $, type AiAppAssistant as A, type BuiltInProvider as B, type AiAppAssistantQuotaStore as C, type AiAppAssistantRecentFailure as D, type AiAppAssistantRedisClient as E, type AiAppAssistantRedisQuotaClient as F, type AiAppAssistantRedisTelemetryClient as G, type AiAppAssistantRuntimeIdentity as H, type AiAppAssistantSecretProtector as I, type AiAppAssistantTelemetryStore as J, type AiAppAssistantTelemetrySummary as K, AiModelDiscoveryError as L, type ManagedAiAppAssistantServer as M, type AiModelInfo as N, type AiProviderInfo as O, type CreateAiAppAssistantConfigurationRepositoryOptions as P, type CreateManagedAiAppAssistantRuntimeOptions as Q, type CreateManagedAiAppAssistantServerOptions as R, type ListAiModelsOptions as S, type ManagedAiAppAssistantFetchHandlerOptions as T, type ManagedAiAppAssistantFetchHandlers as U, type ManagedAiAppAssistantRuntime as V, createAes256GcmSecretProtector as W, createAiAppAssistant as X, createAiAppAssistantConfigurationRepository as Y, createAiAppAssistantFailureEvent as Z, createDisabledSecretProtector as _, type AiAppAssistantStreamEvent as a, createManagedAiAppAssistantRuntime as a0, createManagedAiAppAssistantServer as a1, createMemoryAiAppAssistantQuotaStore as a2, createMemoryAiAppAssistantStore as a3, createMemoryAiAppAssistantTelemetryStore as a4, createPollingAiAppAssistantConfigurationSynchronizer as a5, createRedisAiAppAssistantQuotaStore as a6, createRedisAiAppAssistantStore as a7, createRedisAiAppAssistantTelemetryStore as a8, listAiModels as a9, listAiProviders as aa, validateAndSaveAiAppAssistantConfiguration as ab, type AiAppAssistantConfiguration as b, AI_APP_ASSISTANT_PROVIDERS as c, type AiAppAssistantAccessRule as d, type AiAppAssistantConfigurationActor as e, type AiAppAssistantConfigurationAdministration as f, type AiAppAssistantConfigurationAuditChange as g, type AiAppAssistantConfigurationAuditEntry as h, type AiAppAssistantConfigurationAuditField as i, type AiAppAssistantConfigurationChangeEvent as j, AiAppAssistantConfigurationConflictError as k, AiAppAssistantConfigurationManager as l, type AiAppAssistantConfigurationManagerOptions as m, type AiAppAssistantConfigurationRepository as n, type AiAppAssistantConfigurationSaveResult as o, type AiAppAssistantConfigurationSynchronizer as p, type AiAppAssistantConfigurationView as q, type AiAppAssistantGenerationEvent as r, type AiAppAssistantGenerationOperation as s, type AiAppAssistantKeyValueStore as t, type AiAppAssistantManagedConfigurationSetup as u, type AiAppAssistantManagedStorage as v, AiAppAssistantManagementError as w, type AiAppAssistantManagementErrorCode as x, type AiAppAssistantQuotaPolicy as y, type AiAppAssistantQuotaResult as z };

package/dist/{managed-server-CthTKEQ6.d.cts → managed-server-wXfu_9rp.d.cts}

@@ -37,7 +37,9 @@ interface AiAppAssistant {
 declare function createAiAppAssistant(options: AiAppAssistantOptions): AiAppAssistant;
 
 /** Providers available without installing an additional AI SDK package. */
-type BuiltInProvider = "anthropic" | "google" | "mistral" | "ollama" | "openai";
+declare const AI_APP_ASSISTANT_PROVIDERS: readonly ["anthropic", "google", "mistral", "ollama", "openai"];
+/** Provider identifier derived from the runtime-neutral exported catalog. */
+type BuiltInProvider = typeof AI_APP_ASSISTANT_PROVIDERS[number];
 /** Stable provider metadata suitable for a settings interface. */
 interface AiProviderInfo {
     id: BuiltInProvider;
@@ -246,6 +248,8 @@ interface AiAppAssistantConfigurationSynchronizer {
 }
 interface AiAppAssistantConfigurationManagerOptions {
     repository: AiAppAssistantConfigurationRepository;
+    /** Global kill switch. When false, no provider operation is allowed. */
+    enabled?: boolean | (() => boolean);
     /** Defaults to the local in-memory quota implementation. */
     quotaStore?: AiAppAssistantQuotaStore;
     /** Environment or deployment defaults. They are never persisted automatically. */
@@ -270,7 +274,7 @@ interface AiAppAssistantConfigurationSaveResult {
     configuration?: AiAppAssistantManagedConfigurationView;
     reloadRequired: boolean;
 }
-type AiAppAssistantManagementErrorCode = "unauthorized" | "forbidden" | "conflict" | "invalid_request" | "not_configured" | "quota_reached" | "secret_storage_unavailable";
+type AiAppAssistantManagementErrorCode = "unauthorized" | "forbidden" | "conflict" | "invalid_request" | "not_configured" | "assistant_disabled" | "quota_reached" | "secret_storage_unavailable";
 /** Framework-neutral policy error that HTTP adapters can map safely. */
 declare class AiAppAssistantManagementError extends Error {
     readonly status: number;
@@ -285,6 +289,8 @@ declare class AiAppAssistantManagementError extends Error {
 declare class AiAppAssistantConfigurationManager {
     #private;
     constructor(options: AiAppAssistantConfigurationManagerOptions);
+    /** Returns the current state of the host-controlled global kill switch. */
+    isEnabled(): boolean;
     /** Returns the built-in provider catalogue; no credentials are exposed. */
     listProviders(): AiProviderInfo[];
     /** Discovers models with an explicit key or the currently configured secret. */
@@ -329,6 +335,7 @@ declare class AiAppAssistantConfigurationManager {
     private connectionSignature;
     private lastKnownConnection;
     private now;
+    private assertEnabled;
     private publishAndEmit;
     private emit;
 }
@@ -530,4 +537,4 @@ interface ManagedAiAppAssistantServer<TIdentity extends AiAppAssistantRuntimeIde
  */
 declare function createManagedAiAppAssistantServer<TIdentity extends AiAppAssistantRuntimeIdentity, TNativeContext = undefined>(options: CreateManagedAiAppAssistantServerOptions<TIdentity, TNativeContext>): ManagedAiAppAssistantServer<TIdentity, TNativeContext>;
 
-export { createManagedAiAppAssistantRuntime as $, type AiAppAssistant as A, type BuiltInProvider as B, type AiAppAssistantRecentFailure as C, type AiAppAssistantRedisClient as D, type AiAppAssistantRedisQuotaClient as E, type AiAppAssistantRedisTelemetryClient as F, type AiAppAssistantRuntimeIdentity as G, type AiAppAssistantSecretProtector as H, type AiAppAssistantTelemetryStore as I, type AiAppAssistantTelemetrySummary as J, AiModelDiscoveryError as K, type AiModelInfo as L, type ManagedAiAppAssistantServer as M, type AiProviderInfo as N, type CreateAiAppAssistantConfigurationRepositoryOptions as O, type CreateManagedAiAppAssistantRuntimeOptions as P, type CreateManagedAiAppAssistantServerOptions as Q, type ListAiModelsOptions as R, type ManagedAiAppAssistantFetchHandlerOptions as S, type ManagedAiAppAssistantFetchHandlers as T, type ManagedAiAppAssistantRuntime as U, createAes256GcmSecretProtector as V, createAiAppAssistant as W, createAiAppAssistantConfigurationRepository as X, createAiAppAssistantFailureEvent as Y, createDisabledSecretProtector as Z, createManagedAiAppAssistantFetchHandlers as _, type AiAppAssistantStreamEvent as a, createManagedAiAppAssistantServer as a0, createMemoryAiAppAssistantQuotaStore as a1, createMemoryAiAppAssistantStore as a2, createMemoryAiAppAssistantTelemetryStore as a3, createPollingAiAppAssistantConfigurationSynchronizer as a4, createRedisAiAppAssistantQuotaStore as a5, createRedisAiAppAssistantStore as a6, createRedisAiAppAssistantTelemetryStore as a7, listAiModels as a8, listAiProviders as a9, validateAndSaveAiAppAssistantConfiguration as aa, type AiAppAssistantConfiguration as b, type AiAppAssistantAccessRule as c, type AiAppAssistantConfigurationActor as d, type AiAppAssistantConfigurationAdministration as e, type AiAppAssistantConfigurationAuditChange as f, type AiAppAssistantConfigurationAuditEntry as g, type AiAppAssistantConfigurationAuditField as h, type AiAppAssistantConfigurationChangeEvent as i, AiAppAssistantConfigurationConflictError as j, AiAppAssistantConfigurationManager as k, type AiAppAssistantConfigurationManagerOptions as l, type AiAppAssistantConfigurationRepository as m, type AiAppAssistantConfigurationSaveResult as n, type AiAppAssistantConfigurationSynchronizer as o, type AiAppAssistantConfigurationView as p, type AiAppAssistantGenerationEvent as q, type AiAppAssistantGenerationOperation as r, type AiAppAssistantKeyValueStore as s, type AiAppAssistantManagedConfigurationSetup as t, type AiAppAssistantManagedStorage as u, AiAppAssistantManagementError as v, type AiAppAssistantManagementErrorCode as w, type AiAppAssistantQuotaPolicy as x, type AiAppAssistantQuotaResult as y, type AiAppAssistantQuotaStore as z };
+export { createManagedAiAppAssistantFetchHandlers as $, type AiAppAssistant as A, type BuiltInProvider as B, type AiAppAssistantQuotaStore as C, type AiAppAssistantRecentFailure as D, type AiAppAssistantRedisClient as E, type AiAppAssistantRedisQuotaClient as F, type AiAppAssistantRedisTelemetryClient as G, type AiAppAssistantRuntimeIdentity as H, type AiAppAssistantSecretProtector as I, type AiAppAssistantTelemetryStore as J, type AiAppAssistantTelemetrySummary as K, AiModelDiscoveryError as L, type ManagedAiAppAssistantServer as M, type AiModelInfo as N, type AiProviderInfo as O, type CreateAiAppAssistantConfigurationRepositoryOptions as P, type CreateManagedAiAppAssistantRuntimeOptions as Q, type CreateManagedAiAppAssistantServerOptions as R, type ListAiModelsOptions as S, type ManagedAiAppAssistantFetchHandlerOptions as T, type ManagedAiAppAssistantFetchHandlers as U, type ManagedAiAppAssistantRuntime as V, createAes256GcmSecretProtector as W, createAiAppAssistant as X, createAiAppAssistantConfigurationRepository as Y, createAiAppAssistantFailureEvent as Z, createDisabledSecretProtector as _, type AiAppAssistantStreamEvent as a, createManagedAiAppAssistantRuntime as a0, createManagedAiAppAssistantServer as a1, createMemoryAiAppAssistantQuotaStore as a2, createMemoryAiAppAssistantStore as a3, createMemoryAiAppAssistantTelemetryStore as a4, createPollingAiAppAssistantConfigurationSynchronizer as a5, createRedisAiAppAssistantQuotaStore as a6, createRedisAiAppAssistantStore as a7, createRedisAiAppAssistantTelemetryStore as a8, listAiModels as a9, listAiProviders as aa, validateAndSaveAiAppAssistantConfiguration as ab, type AiAppAssistantConfiguration as b, AI_APP_ASSISTANT_PROVIDERS as c, type AiAppAssistantAccessRule as d, type AiAppAssistantConfigurationActor as e, type AiAppAssistantConfigurationAdministration as f, type AiAppAssistantConfigurationAuditChange as g, type AiAppAssistantConfigurationAuditEntry as h, type AiAppAssistantConfigurationAuditField as i, type AiAppAssistantConfigurationChangeEvent as j, AiAppAssistantConfigurationConflictError as k, AiAppAssistantConfigurationManager as l, type AiAppAssistantConfigurationManagerOptions as m, type AiAppAssistantConfigurationRepository as n, type AiAppAssistantConfigurationSaveResult as o, type AiAppAssistantConfigurationSynchronizer as p, type AiAppAssistantConfigurationView as q, type AiAppAssistantGenerationEvent as r, type AiAppAssistantGenerationOperation as s, type AiAppAssistantKeyValueStore as t, type AiAppAssistantManagedConfigurationSetup as u, type AiAppAssistantManagedStorage as v, AiAppAssistantManagementError as w, type AiAppAssistantManagementErrorCode as x, type AiAppAssistantQuotaPolicy as y, type AiAppAssistantQuotaResult as z };

package/dist/nest.d.cts

@@ -1,5 +1,5 @@
 import { ModuleMetadata, FactoryProvider, DynamicModule } from '@nestjs/common';
-import { M as ManagedAiAppAssistantServer } from './managed-server-CthTKEQ6.cjs';
+import { M as ManagedAiAppAssistantServer } from './managed-server-wXfu_9rp.cjs';
 import './ai-sdk-qU3KgNu-.cjs';
 import 'ai';
 import '@123toto/ai-app-assistant-contracts';

package/dist/nest.d.ts

@@ -1,5 +1,5 @@
 import { ModuleMetadata, FactoryProvider, DynamicModule } from '@nestjs/common';
-import { M as ManagedAiAppAssistantServer } from './managed-server-BGQ-1jkx.js';
+import { M as ManagedAiAppAssistantServer } from './managed-server-CusQWWBB.js';
 import './ai-sdk-qU3KgNu-.js';
 import 'ai';
 import '@123toto/ai-app-assistant-contracts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@123toto/ai-app-assistant-server",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "license": "MIT",
   "description": "Framework-neutral Node.js backend for contextual in-app AI assistants",
   "engines": {
@@ -77,7 +77,7 @@
     "@ai-sdk/openai": "^3.0.0",
     "ai": "^6.0.0",
     "zod": "^4.0.0",
-    "@123toto/ai-app-assistant-contracts": "0.2.0"
+    "@123toto/ai-app-assistant-contracts": "0.2.2"
   },
   "devDependencies": {
     "@nestjs/common": "~11.1.29",