apcore-js 0.10.0 → 0.12.0

package/dist/sys-modules/index.d.ts

@@ -0,0 +1,8 @@
+export { ToggleState, ToggleFeatureModule, defaultToggleState, isModuleDisabled, checkModuleDisabled } from './toggle.js';
+export { HealthSummaryModule, HealthModuleModule, classifyHealthStatus } from './health.js';
+export { ManifestModuleModule, ManifestFullModule } from './manifest.js';
+export { UpdateConfigModule, ReloadModuleModule } from './control.js';
+export { UsageSummaryModule, UsageModuleModule } from './usage.js';
+export { registerSysModules, registerSubscriberType, unregisterSubscriberType, resetSubscriberRegistry } from './registration.js';
+export type { SysModulesContext } from './registration.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sys-modules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sys-modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC1H,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAClI,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/sys-modules/index.js

@@ -0,0 +1,7 @@
+export { ToggleState, ToggleFeatureModule, defaultToggleState, isModuleDisabled, checkModuleDisabled } from './toggle.js';
+export { HealthSummaryModule, HealthModuleModule, classifyHealthStatus } from './health.js';
+export { ManifestModuleModule, ManifestFullModule } from './manifest.js';
+export { UpdateConfigModule, ReloadModuleModule } from './control.js';
+export { UsageSummaryModule, UsageModuleModule } from './usage.js';
+export { registerSysModules, registerSubscriberType, unregisterSubscriberType, resetSubscriberRegistry } from './registration.js';
+//# sourceMappingURL=index.js.map

package/dist/sys-modules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sys-modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC1H,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/sys-modules/manifest.d.ts

@@ -0,0 +1,38 @@
+/**
+ * System manifest modules -- module metadata and full system manifest.
+ */
+import type { Registry } from '../registry/registry.js';
+import type { Config } from '../config.js';
+export declare class ManifestModuleModule {
+    readonly description = "Full manifest for a registered module including source path";
+    readonly annotations: {
+        readonly: boolean;
+        destructive: boolean;
+        idempotent: boolean;
+        requiresApproval: boolean;
+        openWorld: boolean;
+        streaming: boolean;
+    };
+    private readonly _registry;
+    private readonly _config;
+    constructor(registry: Registry, config?: Config | null);
+    execute(inputs: Record<string, unknown>, _context: unknown): Record<string, unknown>;
+    private _computeSourcePath;
+}
+export declare class ManifestFullModule {
+    readonly description = "Complete system manifest with filtering by prefix and tags";
+    readonly annotations: {
+        readonly: boolean;
+        destructive: boolean;
+        idempotent: boolean;
+        requiresApproval: boolean;
+        openWorld: boolean;
+        streaming: boolean;
+    };
+    private readonly _registry;
+    private readonly _config;
+    constructor(registry: Registry, config?: Config | null);
+    execute(inputs: Record<string, unknown>, _context: unknown): Record<string, unknown>;
+    private _computeSourcePath;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/sys-modules/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/sys-modules/manifest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,WAAW,iEAAiE;IACrF,QAAQ,CAAC,WAAW;;;;;;;MAAyH;IAE7I,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAGtC,QAAQ,EAAE,QAAQ,EAClB,MAAM,GAAE,MAAM,GAAG,IAAW;IAM9B,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAyBpF,OAAO,CAAC,kBAAkB;CAO3B;AAED,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,WAAW,gEAAgE;IACpF,QAAQ,CAAC,WAAW;;;;;;;MAAyH;IAE7I,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAGtC,QAAQ,EAAE,QAAQ,EAClB,MAAM,GAAE,MAAM,GAAG,IAAW;IAM9B,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA+BpF,OAAO,CAAC,kBAAkB;CAM3B"}

package/dist/sys-modules/manifest.js

@@ -0,0 +1,91 @@
+/**
+ * System manifest modules -- module metadata and full system manifest.
+ */
+import { InvalidInputError, ModuleNotFoundError } from '../errors.js';
+export class ManifestModuleModule {
+    description = 'Full manifest for a registered module including source path';
+    annotations = { readonly: true, destructive: false, idempotent: true, requiresApproval: false, openWorld: false, streaming: false };
+    _registry;
+    _config;
+    constructor(registry, config = null) {
+        this._registry = registry;
+        this._config = config;
+    }
+    execute(inputs, _context) {
+        const moduleId = inputs['module_id'];
+        if (typeof moduleId !== 'string' || !moduleId) {
+            throw new InvalidInputError('module_id is required');
+        }
+        const descriptor = this._registry.getDefinition(moduleId);
+        if (!descriptor) {
+            throw new ModuleNotFoundError(moduleId);
+        }
+        const sourcePath = this._computeSourcePath(moduleId);
+        return {
+            module_id: descriptor.moduleId,
+            description: descriptor.description,
+            documentation: descriptor.documentation,
+            source_path: sourcePath,
+            input_schema: descriptor.inputSchema,
+            output_schema: descriptor.outputSchema,
+            annotations: descriptor.annotations,
+            tags: descriptor.tags,
+            metadata: descriptor.metadata ?? {},
+        };
+    }
+    _computeSourcePath(moduleId) {
+        if (!this._config)
+            return null;
+        const sourceRoot = this._config.get('project.source_root', '');
+        if (!sourceRoot)
+            return null;
+        const relativePath = moduleId.replace(/\./g, '/') + '.ts';
+        return `${sourceRoot}/${relativePath}`;
+    }
+}
+export class ManifestFullModule {
+    description = 'Complete system manifest with filtering by prefix and tags';
+    annotations = { readonly: true, destructive: false, idempotent: true, requiresApproval: false, openWorld: false, streaming: false };
+    _registry;
+    _config;
+    constructor(registry, config = null) {
+        this._registry = registry;
+        this._config = config;
+    }
+    execute(inputs, _context) {
+        const includeSchemas = inputs['include_schemas'] !== false;
+        const includeSourcePaths = inputs['include_source_paths'] !== false;
+        const prefix = inputs['prefix'];
+        const tags = inputs['tags'];
+        const moduleIds = this._registry.list({ prefix, tags });
+        const modules = [];
+        for (const mid of moduleIds) {
+            const descriptor = this._registry.getDefinition(mid);
+            if (!descriptor)
+                continue;
+            const sourcePath = includeSourcePaths ? this._computeSourcePath(mid) : null;
+            modules.push({
+                module_id: descriptor.moduleId,
+                description: descriptor.description,
+                documentation: descriptor.documentation,
+                source_path: sourcePath,
+                input_schema: includeSchemas ? descriptor.inputSchema : null,
+                output_schema: includeSchemas ? descriptor.outputSchema : null,
+                annotations: descriptor.annotations,
+                tags: descriptor.tags,
+                metadata: descriptor.metadata ?? {},
+            });
+        }
+        const projectName = (this._config?.get('project.name', '') ?? '');
+        return { project_name: projectName, module_count: modules.length, modules };
+    }
+    _computeSourcePath(moduleId) {
+        if (!this._config)
+            return null;
+        const sourceRoot = this._config.get('project.source_root', '');
+        if (!sourceRoot)
+            return null;
+        return `${sourceRoot}/${moduleId.replace(/\./g, '/')}.ts`;
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/sys-modules/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/sys-modules/manifest.ts"],"names":[],"mappings":"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"}

package/dist/sys-modules/registration.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Auto-registration of sys.* modules and middleware from config.
+ */
+import type { Registry } from '../registry/registry.js';
+import type { Executor } from '../executor.js';
+import type { Config } from '../config.js';
+import type { MetricsCollector } from '../observability/metrics.js';
+import { ErrorHistory } from '../observability/error-history.js';
+import { ErrorHistoryMiddleware } from '../middleware/error-history.js';
+import { UsageCollector, UsageMiddleware } from '../observability/usage.js';
+import type { EventSubscriber } from '../events/emitter.js';
+import { EventEmitter } from '../events/emitter.js';
+import { PlatformNotifyMiddleware } from '../middleware/platform-notify.js';
+type SubscriberFactory = (config: Record<string, unknown>) => EventSubscriber;
+export declare function registerSubscriberType(typeName: string, factory: SubscriberFactory): void;
+export declare function unregisterSubscriberType(typeName: string): void;
+export declare function resetSubscriberRegistry(): void;
+/**
+ * Instantiate subscribers from config and subscribe them to the emitter.
+ */
+export declare function _instantiateSubscribers(config: Config, eventEmitter: EventEmitter): void;
+export interface SysModulesContext {
+    errorHistory?: ErrorHistory;
+    errorHistoryMiddleware?: ErrorHistoryMiddleware;
+    usageCollector?: UsageCollector;
+    usageMiddleware?: UsageMiddleware;
+    eventEmitter?: EventEmitter;
+    platformNotifyMiddleware?: PlatformNotifyMiddleware;
+}
+/**
+ * Auto-register all sys.* modules and middleware based on config.
+ */
+export declare function registerSysModules(registry: Registry, executor: Executor, config: Config, metricsCollector?: MetricsCollector | null): SysModulesContext;
+export {};
+//# sourceMappingURL=registration.d.ts.map

package/dist/sys-modules/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../src/sys-modules/registration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAe,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAW5E,KAAK,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,eAAe,CAAC;AAwB9E,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAEN;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAK/D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,GACzB,IAAI,CAwBN;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACzC,iBAAiB,CAuEnB"}

package/dist/sys-modules/registration.js

@@ -0,0 +1,132 @@
+/**
+ * Auto-registration of sys.* modules and middleware from config.
+ */
+import { ErrorHistory } from '../observability/error-history.js';
+import { ErrorHistoryMiddleware } from '../middleware/error-history.js';
+import { UsageCollector, UsageMiddleware } from '../observability/usage.js';
+import { EventEmitter, createEvent } from '../events/emitter.js';
+import { WebhookSubscriber, A2ASubscriber } from '../events/subscribers.js';
+import { PlatformNotifyMiddleware } from '../middleware/platform-notify.js';
+import { HealthSummaryModule, HealthModuleModule } from './health.js';
+import { ManifestFullModule, ManifestModuleModule } from './manifest.js';
+import { ToggleFeatureModule } from './toggle.js';
+import { UpdateConfigModule, ReloadModuleModule } from './control.js';
+import { UsageSummaryModule, UsageModuleModule } from './usage.js';
+const _subscriberFactories = new Map();
+function _registerBuiltInFactories() {
+    _subscriberFactories.set('webhook', (config) => {
+        const url = config['url'];
+        const headers = config['headers'];
+        const retryCount = config['retry_count'];
+        const timeoutMs = config['timeout_ms'];
+        return new WebhookSubscriber(url, headers, retryCount, timeoutMs);
+    });
+    _subscriberFactories.set('a2a', (config) => {
+        const platformUrl = config['platform_url'];
+        const auth = config['auth'];
+        const timeoutMs = config['timeout_ms'];
+        return new A2ASubscriber(platformUrl, auth, timeoutMs);
+    });
+}
+// Register built-in factories on module load
+_registerBuiltInFactories();
+export function registerSubscriberType(typeName, factory) {
+    _subscriberFactories.set(typeName, factory);
+}
+export function unregisterSubscriberType(typeName) {
+    if (!_subscriberFactories.has(typeName)) {
+        throw new Error(`Subscriber type '${typeName}' is not registered`);
+    }
+    _subscriberFactories.delete(typeName);
+}
+export function resetSubscriberRegistry() {
+    _subscriberFactories.clear();
+    _registerBuiltInFactories();
+}
+/**
+ * Instantiate subscribers from config and subscribe them to the emitter.
+ */
+export function _instantiateSubscribers(config, eventEmitter) {
+    const subscriberConfigs = config.get('sys_modules.events.subscribers', []);
+    for (const subscriberConfig of subscriberConfigs) {
+        const typeName = subscriberConfig['type'];
+        if (typeof typeName !== 'string') {
+            console.warn('[apcore:events]', 'Subscriber config missing "type" field, skipping');
+            continue;
+        }
+        const factory = _subscriberFactories.get(typeName);
+        if (factory === undefined) {
+            console.warn('[apcore:events]', `Unknown subscriber type '${typeName}', skipping`);
+            continue;
+        }
+        try {
+            const subscriber = factory(subscriberConfig);
+            eventEmitter.subscribe(subscriber);
+        }
+        catch (err) {
+            console.warn('[apcore:events]', `Failed to create subscriber of type '${typeName}':`, err);
+        }
+    }
+}
+/**
+ * Auto-register all sys.* modules and middleware based on config.
+ */
+export function registerSysModules(registry, executor, config, metricsCollector) {
+    const result = {};
+    if (!config.get('sys_modules.enabled', false)) {
+        return result;
+    }
+    // Error history
+    const maxPerModule = Number(config.get('sys_modules.error_history.max_entries_per_module', 50));
+    const maxTotal = Number(config.get('sys_modules.error_history.max_total_entries', 1000));
+    const errorHistory = new ErrorHistory(maxPerModule, maxTotal);
+    result.errorHistory = errorHistory;
+    const ehMiddleware = new ErrorHistoryMiddleware(errorHistory);
+    executor.use(ehMiddleware);
+    result.errorHistoryMiddleware = ehMiddleware;
+    // Usage tracking
+    const usageCollector = new UsageCollector();
+    result.usageCollector = usageCollector;
+    const usageMiddleware = new UsageMiddleware(usageCollector);
+    executor.use(usageMiddleware);
+    result.usageMiddleware = usageMiddleware;
+    // Register sys modules via registerInternal to bypass reserved-word checks
+    const reg = (id, mod) => {
+        registry.registerInternal(id, mod);
+    };
+    // Health modules
+    reg('system.health.summary', new HealthSummaryModule(registry, metricsCollector ?? null, errorHistory, config));
+    reg('system.health.module', new HealthModuleModule(registry, metricsCollector ?? null, errorHistory));
+    // Manifest modules
+    reg('system.manifest.module', new ManifestModuleModule(registry, config));
+    reg('system.manifest.full', new ManifestFullModule(registry, config));
+    // Usage modules
+    reg('system.usage.summary', new UsageSummaryModule(usageCollector));
+    reg('system.usage.module', new UsageModuleModule(registry, usageCollector));
+    // Events system
+    if (config.get('sys_modules.events.enabled', false)) {
+        const eventEmitter = new EventEmitter();
+        result.eventEmitter = eventEmitter;
+        // Config-driven subscribers
+        _instantiateSubscribers(config, eventEmitter);
+        // PlatformNotifyMiddleware
+        const errorRateThreshold = Number(config.get('sys_modules.events.thresholds.error_rate', 0.1));
+        const latencyP99Threshold = Number(config.get('sys_modules.events.thresholds.latency_p99_ms', 5000));
+        const pnMiddleware = new PlatformNotifyMiddleware(eventEmitter, metricsCollector ?? null, errorRateThreshold, latencyP99Threshold);
+        executor.use(pnMiddleware);
+        result.platformNotifyMiddleware = pnMiddleware;
+        // Control modules (require EventEmitter)
+        reg('system.control.toggle_feature', new ToggleFeatureModule(registry, eventEmitter));
+        reg('system.control.update_config', new UpdateConfigModule(config, eventEmitter));
+        reg('system.control.reload_module', new ReloadModuleModule(registry, eventEmitter));
+        // Bridge registry events
+        registry.on('register', (moduleId) => {
+            eventEmitter.emit(createEvent('module_registered', moduleId, 'info', {}));
+        });
+        registry.on('unregister', (moduleId) => {
+            eventEmitter.emit(createEvent('module_unregistered', moduleId, 'info', {}));
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=registration.js.map

package/dist/sys-modules/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../src/sys-modules/registration.ts"],"names":[],"mappings":"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"}

package/dist/sys-modules/toggle.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Module toggle system -- disable/enable modules without unloading.
+ */
+import type { Registry } from '../registry/registry.js';
+import type { EventEmitter } from '../events/emitter.js';
+/**
+ * Toggle state container. Tracks which modules are disabled.
+ * State survives module reload since it lives outside the Registry.
+ */
+export declare class ToggleState {
+    private readonly _disabled;
+    isDisabled(moduleId: string): boolean;
+    disable(moduleId: string): void;
+    enable(moduleId: string): void;
+    clear(): void;
+}
+/** Default global toggle state. */
+export declare const defaultToggleState: ToggleState;
+/** Check if a module is disabled using the default toggle state. */
+export declare function isModuleDisabled(moduleId: string): boolean;
+/** Throw ModuleDisabledError if the module is disabled. */
+export declare function checkModuleDisabled(moduleId: string): void;
+/**
+ * Disable or enable a module without unloading it from the Registry.
+ * A disabled module remains registered but calls return MODULE_DISABLED error.
+ */
+export declare class ToggleFeatureModule {
+    readonly description = "Disable or enable a module without unloading it";
+    readonly annotations: {
+        readonly: boolean;
+        destructive: boolean;
+        idempotent: boolean;
+        requiresApproval: boolean;
+        openWorld: boolean;
+        streaming: boolean;
+    };
+    private readonly _registry;
+    private readonly _emitter;
+    private readonly _toggleState;
+    constructor(registry: Registry, eventEmitter: EventEmitter, toggleState?: ToggleState);
+    execute(inputs: Record<string, unknown>, _context: unknown): Record<string, unknown>;
+    private _validateInputs;
+}
+//# sourceMappingURL=toggle.d.ts.map

package/dist/sys-modules/toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../src/sys-modules/toggle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IAEpD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIrC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI/B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9B,KAAK,IAAI,IAAI;CAGd;AAED,mCAAmC;AACnC,eAAO,MAAM,kBAAkB,aAAoB,CAAC;AAEpD,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI1D;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,WAAW,qDAAqD;IACzE,QAAQ,CAAC,WAAW;;;;;;;MAAyH;IAE7I,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;gBAE/B,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,WAAW;IAMrF,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAcpF,OAAO,CAAC,eAAe;CAexB"}

package/dist/sys-modules/toggle.js

@@ -0,0 +1,82 @@
+/**
+ * Module toggle system -- disable/enable modules without unloading.
+ */
+import { InvalidInputError, ModuleNotFoundError, ModuleDisabledError } from '../errors.js';
+import { createEvent } from '../events/emitter.js';
+/**
+ * Toggle state container. Tracks which modules are disabled.
+ * State survives module reload since it lives outside the Registry.
+ */
+export class ToggleState {
+    _disabled = new Set();
+    isDisabled(moduleId) {
+        return this._disabled.has(moduleId);
+    }
+    disable(moduleId) {
+        this._disabled.add(moduleId);
+    }
+    enable(moduleId) {
+        this._disabled.delete(moduleId);
+    }
+    clear() {
+        this._disabled.clear();
+    }
+}
+/** Default global toggle state. */
+export const defaultToggleState = new ToggleState();
+/** Check if a module is disabled using the default toggle state. */
+export function isModuleDisabled(moduleId) {
+    return defaultToggleState.isDisabled(moduleId);
+}
+/** Throw ModuleDisabledError if the module is disabled. */
+export function checkModuleDisabled(moduleId) {
+    if (isModuleDisabled(moduleId)) {
+        throw new ModuleDisabledError(moduleId);
+    }
+}
+/**
+ * Disable or enable a module without unloading it from the Registry.
+ * A disabled module remains registered but calls return MODULE_DISABLED error.
+ */
+export class ToggleFeatureModule {
+    description = 'Disable or enable a module without unloading it';
+    annotations = { readonly: false, destructive: false, idempotent: true, requiresApproval: true, openWorld: false, streaming: false };
+    _registry;
+    _emitter;
+    _toggleState;
+    constructor(registry, eventEmitter, toggleState) {
+        this._registry = registry;
+        this._emitter = eventEmitter;
+        this._toggleState = toggleState ?? defaultToggleState;
+    }
+    execute(inputs, _context) {
+        const { moduleId, enabled, reason } = this._validateInputs(inputs);
+        if (!this._registry.has(moduleId)) {
+            throw new ModuleNotFoundError(moduleId);
+        }
+        if (enabled) {
+            this._toggleState.enable(moduleId);
+        }
+        else {
+            this._toggleState.disable(moduleId);
+        }
+        this._emitter.emit(createEvent('module_health_changed', moduleId, 'info', { enabled, reason }));
+        return { success: true, module_id: moduleId, enabled, reason };
+    }
+    _validateInputs(inputs) {
+        const moduleId = inputs['module_id'];
+        if (typeof moduleId !== 'string' || !moduleId) {
+            throw new InvalidInputError("'module_id' is required and must be a non-empty string");
+        }
+        const enabled = inputs['enabled'];
+        if (typeof enabled !== 'boolean') {
+            throw new InvalidInputError("'enabled' is required and must be a boolean");
+        }
+        const reason = inputs['reason'];
+        if (typeof reason !== 'string' || !reason) {
+            throw new InvalidInputError("'reason' is required and must be a non-empty string");
+        }
+        return { moduleId, enabled, reason };
+    }
+}
+//# sourceMappingURL=toggle.js.map

package/dist/sys-modules/toggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.js","sourceRoot":"","sources":["../../src/sys-modules/toggle.ts"],"names":[],"mappings":"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"}

package/dist/sys-modules/usage.d.ts

@@ -0,0 +1,35 @@
+/**
+ * System usage modules -- summary and single-module usage detail.
+ */
+import type { Registry } from '../registry/registry.js';
+import type { UsageCollector } from '../observability/usage.js';
+export declare class UsageSummaryModule {
+    readonly description = "All modules usage overview with trend detection";
+    readonly annotations: {
+        readonly: boolean;
+        destructive: boolean;
+        idempotent: boolean;
+        requiresApproval: boolean;
+        openWorld: boolean;
+        streaming: boolean;
+    };
+    private readonly _collector;
+    constructor(collector: UsageCollector);
+    execute(inputs: Record<string, unknown>, _context: unknown): Record<string, unknown>;
+}
+export declare class UsageModuleModule {
+    readonly description = "Detailed usage statistics for a single module";
+    readonly annotations: {
+        readonly: boolean;
+        destructive: boolean;
+        idempotent: boolean;
+        requiresApproval: boolean;
+        openWorld: boolean;
+        streaming: boolean;
+    };
+    private readonly _registry;
+    private readonly _collector;
+    constructor(registry: Registry, usageCollector: UsageCollector);
+    execute(inputs: Record<string, unknown>, _context: unknown): Record<string, unknown>;
+}
+//# sourceMappingURL=usage.d.ts.map

package/dist/sys-modules/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/sys-modules/usage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAmChE,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,WAAW,qDAAqD;IACzE,QAAQ,CAAC,WAAW;;;;;;;MAAyH;IAE7I,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;gBAEhC,SAAS,EAAE,cAAc;IAIrC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAsBrF;AAED,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,WAAW,mDAAmD;IACvE,QAAQ,CAAC,WAAW;;;;;;;MAAyH;IAE7I,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;gBAEhC,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc;IAK9D,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAmCrF"}

package/dist/sys-modules/usage.js

@@ -0,0 +1,105 @@
+/**
+ * System usage modules -- summary and single-module usage detail.
+ */
+import { InvalidInputError, ModuleNotFoundError } from '../errors.js';
+import { bucketKey } from '../observability/usage.js';
+function computeP99(latencies) {
+    if (latencies.length === 0)
+        return 0;
+    const sorted = [...latencies].sort((a, b) => a - b);
+    const idx = Math.max(0, Math.ceil(0.99 * sorted.length) - 1);
+    return sorted[idx];
+}
+function padHourlyDistribution(buckets) {
+    const now = new Date();
+    const existing = new Map();
+    for (const b of buckets)
+        existing.set(b.hour, b);
+    const keys = [];
+    for (let i = 0; i < 24; i++) {
+        const d = new Date(now.getTime() - (23 - i) * 3600_000);
+        keys.push(bucketKey(d));
+    }
+    for (const k of existing.keys()) {
+        if (!keys.includes(k))
+            keys.push(k);
+    }
+    keys.sort();
+    const latest = keys.slice(-24);
+    return latest.map((k) => {
+        const b = existing.get(k);
+        return b
+            ? { hour: k, call_count: b.callCount, error_count: b.errorCount }
+            : { hour: k, call_count: 0, error_count: 0 };
+    });
+}
+export class UsageSummaryModule {
+    description = 'All modules usage overview with trend detection';
+    annotations = { readonly: true, destructive: false, idempotent: true, requiresApproval: false, openWorld: false, streaming: false };
+    _collector;
+    constructor(collector) {
+        this._collector = collector;
+    }
+    execute(inputs, _context) {
+        const period = inputs['period'] ?? '24h';
+        const summaries = this._collector.getSummary(period);
+        const sorted = [...summaries].sort((a, b) => b.callCount - a.callCount);
+        const totalCalls = sorted.reduce((s, e) => s + e.callCount, 0);
+        const totalErrors = sorted.reduce((s, e) => s + e.errorCount, 0);
+        return {
+            period,
+            total_calls: totalCalls,
+            total_errors: totalErrors,
+            modules: sorted.map((e) => ({
+                module_id: e.moduleId,
+                call_count: e.callCount,
+                error_count: e.errorCount,
+                avg_latency_ms: e.avgLatencyMs,
+                unique_callers: e.uniqueCallers,
+                trend: e.trend,
+            })),
+        };
+    }
+}
+export class UsageModuleModule {
+    description = 'Detailed usage statistics for a single module';
+    annotations = { readonly: true, destructive: false, idempotent: true, requiresApproval: false, openWorld: false, streaming: false };
+    _registry;
+    _collector;
+    constructor(registry, usageCollector) {
+        this._registry = registry;
+        this._collector = usageCollector;
+    }
+    execute(inputs, _context) {
+        const moduleId = inputs['module_id'];
+        if (typeof moduleId !== 'string' || !moduleId) {
+            throw new InvalidInputError('module_id is required');
+        }
+        if (!this._registry.has(moduleId)) {
+            throw new ModuleNotFoundError(moduleId);
+        }
+        const period = inputs['period'] ?? '24h';
+        const detail = this._collector.getModule(moduleId, period);
+        const latencies = this._collector.getLatencies(moduleId, period);
+        const p99 = computeP99(latencies);
+        const callers = detail.callers.map((c) => ({
+            caller_id: c.callerId,
+            call_count: c.callCount,
+            error_count: c.errorCount,
+            avg_latency_ms: c.avgLatencyMs,
+        }));
+        const hourly = padHourlyDistribution(detail.hourlyDistribution);
+        return {
+            module_id: detail.moduleId,
+            period,
+            call_count: detail.callCount,
+            error_count: detail.errorCount,
+            avg_latency_ms: detail.avgLatencyMs,
+            p99_latency_ms: p99,
+            trend: detail.trend,
+            callers,
+            hourly_distribution: hourly,
+        };
+    }
+}
+//# sourceMappingURL=usage.js.map