@allternit/ix 0.1.0

package/dist/runtime/capsule-runtime.d.ts

@@ -0,0 +1,227 @@
+/**
+ * IX Capsule Runtime
+ *
+ * Integration with P3.9 MCP Apps capsule infrastructure for sandboxed
+ * execution of A2R-IX UI capsules.
+ */
+import type { UIRoot } from '../types';
+import type { StateStore } from '../state/store';
+import type { JSONPatch } from '../state/patch';
+import type { PolicyGate } from './policy-gates';
+export interface IXCapsuleConfig {
+    /** Capsule ID */
+    id: string;
+    /** UI definition */
+    ui: UIRoot;
+    /** Policy gates for security */
+    policyGates?: PolicyGate[];
+    /** State store (isolated per capsule) */
+    stateStore: StateStore;
+    /** Event handler for capsule events */
+    onEvent?: (event: IXCapsuleEvent) => void;
+    /** State change handler */
+    onStateChange?: (path: string, value: unknown) => void;
+    /** Destroy handler */
+    onDestroy?: () => void;
+}
+export interface IXCapsuleEvent {
+    type: 'action' | 'state-change' | 'error' | 'lifecycle';
+    capsuleId: string;
+    action?: string;
+    params?: Record<string, unknown>;
+    path?: string;
+    value?: unknown;
+    error?: Error;
+    lifecycle?: 'mount' | 'unmount' | 'update';
+}
+export interface IXCapsule {
+    /** Capsule ID */
+    id: string;
+    /** Get current UI definition */
+    getUI: () => UIRoot;
+    /** Update UI with new definition */
+    updateUI: (ui: UIRoot) => void;
+    /** Apply state patch */
+    applyPatch: (patch: JSONPatch) => void;
+    /** Get state value */
+    getState: (path: string) => unknown;
+    /** Set state value */
+    setState: (path: string, value: unknown) => void;
+    /** Dispatch action */
+    dispatch: (actionId: string, params?: Record<string, unknown>) => Promise<boolean>;
+    /** Subscribe to capsule events */
+    subscribe: (callback: (event: IXCapsuleEvent) => void) => () => void;
+    /** Destroy capsule */
+    destroy: () => void;
+    /** Check if capsule is active */
+    isActive: () => boolean;
+    /** GAP-62: Get capsule metrics */
+    getMetrics: () => IXCapsuleMetrics;
+}
+/**
+ * GAP-62: Extended capsule metrics
+ */
+export interface IXCapsuleMetrics {
+    /** Number of renders */
+    renderCount: number;
+    /** Number of actions dispatched */
+    actionCount: number;
+    /** Number of state updates */
+    stateUpdateCount: number;
+    /** Number of errors */
+    errorCount: number;
+    /** Capsule start time (ms timestamp) */
+    startTime: number;
+    /** Last activity time (ms timestamp) */
+    lastActivity: number;
+    /** GAP-63: CPU usage metrics */
+    cpu?: {
+        /** User CPU time used (milliseconds) */
+        userTime: number;
+        /** System CPU time used (milliseconds) */
+        systemTime: number;
+        /** Total CPU time (user + system) */
+        totalTime: number;
+        /** CPU usage percentage (approximate) */
+        usagePercent: number;
+    };
+    /** GAP-63: Memory usage metrics */
+    memory?: {
+        /** Heap used in bytes */
+        heapUsed: number;
+        /** Heap total in bytes */
+        heapTotal: number;
+        /** External memory in bytes */
+        external: number;
+        /** RSS (Resident Set Size) in bytes */
+        rss: number;
+        /** Array buffer memory in bytes */
+        arrayBuffers: number;
+    };
+    /** GAP-63: Network metrics (for capsules making network requests) */
+    network?: {
+        /** Number of requests made */
+        requestCount: number;
+        /** Number of successful responses */
+        successCount: number;
+        /** Number of failed requests */
+        errorCount: number;
+        /** Total bytes sent */
+        bytesSent: number;
+        /** Total bytes received */
+        bytesReceived: number;
+        /** Average response time (ms) */
+        avgResponseTime: number;
+    };
+    /** Uptime in milliseconds */
+    uptime: number;
+}
+/**
+ * Create IX Capsule
+ */
+export declare function createIXCapsule(config: IXCapsuleConfig): IXCapsule;
+/**
+ * IX Capsule Registry
+ */
+export declare class IXCapsuleRegistry {
+    private capsules;
+    private defaultPolicyGates;
+    /**
+     * Set default policy gates for all capsules
+     */
+    setDefaultPolicyGates(gates: PolicyGate[]): void;
+    /**
+     * Create and register capsule
+     */
+    create(config: Omit<IXCapsuleConfig, 'policyGates'> & {
+        policyGates?: PolicyGate[];
+    }): IXCapsule;
+    /**
+     * Get capsule by ID
+     */
+    get(id: string): IXCapsule | undefined;
+    /**
+     * Check if capsule exists
+     */
+    has(id: string): boolean;
+    /**
+     * Remove capsule
+     */
+    remove(id: string): boolean;
+    /**
+     * List all capsules
+     */
+    list(): IXCapsule[];
+    /**
+     * Get active capsules
+     */
+    getActive(): IXCapsule[];
+    /**
+     * Broadcast patch to all capsules
+     */
+    broadcastPatch(patch: JSONPatch): void;
+    /**
+     * Destroy all capsules
+     */
+    clear(): void;
+    /**
+     * GAP-62/64: Get metrics for all capsules
+     * Returns aggregated metrics for all registered capsules
+     */
+    getMetrics(): Record<string, IXCapsuleMetrics>;
+    /**
+     * GAP-64: Get aggregated metrics across all capsules
+     * Returns summary statistics for the entire registry
+     */
+    getAggregatedMetrics(): IXAggregatedMetrics;
+    /**
+     * GAP-64: Export metrics for external monitoring systems
+     * Returns metrics in a format suitable for Prometheus, DataDog, etc.
+     */
+    exportMetrics(): IXMetricsExport;
+    /**
+     * Convert metrics to Prometheus format
+     */
+    private toPrometheusFormat;
+}
+/**
+ * GAP-64: Aggregated metrics interface
+ */
+export interface IXAggregatedMetrics {
+    /** Total number of capsules in registry */
+    totalCapsules: number;
+    /** Number of currently active capsules */
+    activeCapsules: number;
+    /** Total renders across all capsules */
+    totalRenders: number;
+    /** Total actions across all capsules */
+    totalActions: number;
+    /** Total state updates across all capsules */
+    totalStateUpdates: number;
+    /** Total errors across all capsules */
+    totalErrors: number;
+    /** Average uptime in milliseconds */
+    avgUptime: number;
+    /** Total memory used in bytes */
+    totalMemoryUsed: number;
+    /** Average CPU usage percentage */
+    avgCpuUsage: number;
+}
+/**
+ * GAP-64: Metrics export format
+ */
+export interface IXMetricsExport {
+    /** Export timestamp */
+    timestamp: number;
+    /** Summary statistics */
+    summary: IXAggregatedMetrics;
+    /** Individual capsule metrics */
+    capsules: Record<string, IXCapsuleMetrics>;
+    /** Prometheus-formatted metrics */
+    prometheus: string;
+}
+/**
+ * Global capsule registry
+ */
+export declare const globalCapsuleRegistry: IXCapsuleRegistry;
+//# sourceMappingURL=capsule-runtime.d.ts.map

package/dist/runtime/capsule-runtime.d.ts.bak

@@ -0,0 +1,227 @@
+/**
+ * IX Capsule Runtime
+ *
+ * Integration with P3.9 MCP Apps capsule infrastructure for sandboxed
+ * execution of A2R-IX UI capsules.
+ */
+import type { UIRoot } from '../types';
+import type { StateStore } from '../state/store';
+import type { JSONPatch } from '../state/patch';
+import type { PolicyGate } from './policy-gates';
+export interface IXCapsuleConfig {
+    /** Capsule ID */
+    id: string;
+    /** UI definition */
+    ui: UIRoot;
+    /** Policy gates for security */
+    policyGates?: PolicyGate[];
+    /** State store (isolated per capsule) */
+    stateStore: StateStore;
+    /** Event handler for capsule events */
+    onEvent?: (event: IXCapsuleEvent) => void;
+    /** State change handler */
+    onStateChange?: (path: string, value: unknown) => void;
+    /** Destroy handler */
+    onDestroy?: () => void;
+}
+export interface IXCapsuleEvent {
+    type: 'action' | 'state-change' | 'error' | 'lifecycle';
+    capsuleId: string;
+    action?: string;
+    params?: Record<string, unknown>;
+    path?: string;
+    value?: unknown;
+    error?: Error;
+    lifecycle?: 'mount' | 'unmount' | 'update';
+}
+export interface IXCapsule {
+    /** Capsule ID */
+    id: string;
+    /** Get current UI definition */
+    getUI: () => UIRoot;
+    /** Update UI with new definition */
+    updateUI: (ui: UIRoot) => void;
+    /** Apply state patch */
+    applyPatch: (patch: JSONPatch) => void;
+    /** Get state value */
+    getState: (path: string) => unknown;
+    /** Set state value */
+    setState: (path: string, value: unknown) => void;
+    /** Dispatch action */
+    dispatch: (actionId: string, params?: Record<string, unknown>) => Promise<boolean>;
+    /** Subscribe to capsule events */
+    subscribe: (callback: (event: IXCapsuleEvent) => void) => () => void;
+    /** Destroy capsule */
+    destroy: () => void;
+    /** Check if capsule is active */
+    isActive: () => boolean;
+    /** GAP-62: Get capsule metrics */
+    getMetrics: () => IXCapsuleMetrics;
+}
+/**
+ * GAP-62: Extended capsule metrics
+ */
+export interface IXCapsuleMetrics {
+    /** Number of renders */
+    renderCount: number;
+    /** Number of actions dispatched */
+    actionCount: number;
+    /** Number of state updates */
+    stateUpdateCount: number;
+    /** Number of errors */
+    errorCount: number;
+    /** Capsule start time (ms timestamp) */
+    startTime: number;
+    /** Last activity time (ms timestamp) */
+    lastActivity: number;
+    /** GAP-63: CPU usage metrics */
+    cpu?: {
+        /** User CPU time used (milliseconds) */
+        userTime: number;
+        /** System CPU time used (milliseconds) */
+        systemTime: number;
+        /** Total CPU time (user + system) */
+        totalTime: number;
+        /** CPU usage percentage (approximate) */
+        usagePercent: number;
+    };
+    /** GAP-63: Memory usage metrics */
+    memory?: {
+        /** Heap used in bytes */
+        heapUsed: number;
+        /** Heap total in bytes */
+        heapTotal: number;
+        /** External memory in bytes */
+        external: number;
+        /** RSS (Resident Set Size) in bytes */
+        rss: number;
+        /** Array buffer memory in bytes */
+        arrayBuffers: number;
+    };
+    /** GAP-63: Network metrics (for capsules making network requests) */
+    network?: {
+        /** Number of requests made */
+        requestCount: number;
+        /** Number of successful responses */
+        successCount: number;
+        /** Number of failed requests */
+        errorCount: number;
+        /** Total bytes sent */
+        bytesSent: number;
+        /** Total bytes received */
+        bytesReceived: number;
+        /** Average response time (ms) */
+        avgResponseTime: number;
+    };
+    /** Uptime in milliseconds */
+    uptime: number;
+}
+/**
+ * Create IX Capsule
+ */
+export declare function createIXCapsule(config: IXCapsuleConfig): IXCapsule;
+/**
+ * IX Capsule Registry
+ */
+export declare class IXCapsuleRegistry {
+    private capsules;
+    private defaultPolicyGates;
+    /**
+     * Set default policy gates for all capsules
+     */
+    setDefaultPolicyGates(gates: PolicyGate[]): void;
+    /**
+     * Create and register capsule
+     */
+    create(config: Omit<IXCapsuleConfig, 'policyGates'> & {
+        policyGates?: PolicyGate[];
+    }): IXCapsule;
+    /**
+     * Get capsule by ID
+     */
+    get(id: string): IXCapsule | undefined;
+    /**
+     * Check if capsule exists
+     */
+    has(id: string): boolean;
+    /**
+     * Remove capsule
+     */
+    remove(id: string): boolean;
+    /**
+     * List all capsules
+     */
+    list(): IXCapsule[];
+    /**
+     * Get active capsules
+     */
+    getActive(): IXCapsule[];
+    /**
+     * Broadcast patch to all capsules
+     */
+    broadcastPatch(patch: JSONPatch): void;
+    /**
+     * Destroy all capsules
+     */
+    clear(): void;
+    /**
+     * GAP-62/64: Get metrics for all capsules
+     * Returns aggregated metrics for all registered capsules
+     */
+    getMetrics(): Record<string, IXCapsuleMetrics>;
+    /**
+     * GAP-64: Get aggregated metrics across all capsules
+     * Returns summary statistics for the entire registry
+     */
+    getAggregatedMetrics(): IXAggregatedMetrics;
+    /**
+     * GAP-64: Export metrics for external monitoring systems
+     * Returns metrics in a format suitable for Prometheus, DataDog, etc.
+     */
+    exportMetrics(): IXMetricsExport;
+    /**
+     * Convert metrics to Prometheus format
+     */
+    private toPrometheusFormat;
+}
+/**
+ * GAP-64: Aggregated metrics interface
+ */
+export interface IXAggregatedMetrics {
+    /** Total number of capsules in registry */
+    totalCapsules: number;
+    /** Number of currently active capsules */
+    activeCapsules: number;
+    /** Total renders across all capsules */
+    totalRenders: number;
+    /** Total actions across all capsules */
+    totalActions: number;
+    /** Total state updates across all capsules */
+    totalStateUpdates: number;
+    /** Total errors across all capsules */
+    totalErrors: number;
+    /** Average uptime in milliseconds */
+    avgUptime: number;
+    /** Total memory used in bytes */
+    totalMemoryUsed: number;
+    /** Average CPU usage percentage */
+    avgCpuUsage: number;
+}
+/**
+ * GAP-64: Metrics export format
+ */
+export interface IXMetricsExport {
+    /** Export timestamp */
+    timestamp: number;
+    /** Summary statistics */
+    summary: IXAggregatedMetrics;
+    /** Individual capsule metrics */
+    capsules: Record<string, IXCapsuleMetrics>;
+    /** Prometheus-formatted metrics */
+    prometheus: string;
+}
+/**
+ * Global capsule registry
+ */
+export declare const globalCapsuleRegistry: IXCapsuleRegistry;
+//# sourceMappingURL=capsule-runtime.d.ts.map

package/dist/runtime/capsule-runtime.d.ts.map

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