@gracker/smartperfetto 1.0.13

package/dist/services/pipelineSkillLoader.js

@@ -0,0 +1,301 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pipelineSkillLoader = void 0;
+exports.ensurePipelineSkillsInitialized = ensurePipelineSkillsInitialized;
+exports.getPipelineSkillLoader = getPipelineSkillLoader;
+exports.getAutoPinInstructions = getAutoPinInstructions;
+exports.getTeachingContent = getTeachingContent;
+exports.getSmartFilterConfigs = getSmartFilterConfigs;
+/**
+ * Pipeline Skill Loader
+ *
+ * Loads and manages pipeline skill definitions from YAML files.
+ * Pipeline skills contain detection rules, teaching content, auto-pin
+ * instructions, and analysis recommendations for each rendering pipeline type.
+ *
+ * This replaces the hardcoded configurations in trackPinService.ts with
+ * a data-driven approach using YAML skill files.
+ */
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+// =============================================================================
+// Pipeline Skill Loader
+// =============================================================================
+class PipelineSkillLoaderClass {
+    constructor() {
+        this.pipelineCache = new Map();
+        this.initialized = false;
+        this.pipelinesDir = path_1.default.resolve(__dirname, '../../skills/pipelines');
+    }
+    validateDetection(pipeline, file) {
+        const pipelineId = pipeline?.meta?.pipeline_id || 'UNKNOWN';
+        const detection = pipeline.detection;
+        if (!detection)
+            return;
+        const selectorKeys = ['thread', 'thread_pattern', 'slice', 'slice_pattern'];
+        const countSelectors = (obj) => selectorKeys.filter((k) => obj[k] !== undefined && obj[k] !== null);
+        const validateMinCount = (v) => {
+            if (v === undefined || v === null)
+                return true;
+            const n = typeof v === 'number' ? v : parseInt(String(v), 10);
+            return Number.isFinite(n) && n > 0;
+        };
+        const warn = (msg) => {
+            console.warn(`[PipelineSkillLoader] Validation warning in ${file} (${pipelineId}): ${msg}`);
+        };
+        for (const [kind, items] of [
+            ['required_signals', detection.required_signals || []],
+            ['exclude_if', detection.exclude_if || []],
+        ]) {
+            for (const item of items) {
+                const keys = countSelectors(item);
+                if (keys.length !== 1)
+                    warn(`${kind} entry must have exactly one selector, got [${keys.join(', ')}]`);
+                if (!validateMinCount(item.min_count))
+                    warn(`${kind} entry has invalid min_count: ${item.min_count}`);
+            }
+        }
+        for (const item of detection.scoring_signals || []) {
+            const keys = countSelectors(item);
+            if (keys.length !== 1)
+                warn(`scoring_signals '${item.signal}' must have exactly one selector, got [${keys.join(', ')}]`);
+            const signal = item.signal;
+            if (!signal || typeof signal !== 'string')
+                warn(`scoring_signals entry missing 'signal' name`);
+            const weight = item.weight;
+            if (typeof weight !== 'number' || !Number.isFinite(weight) || weight < 0) {
+                warn(`scoring_signals '${signal || 'UNKNOWN'}' has invalid weight: ${weight}`);
+            }
+            if (!validateMinCount(item.min_count))
+                warn(`scoring_signals '${signal || 'UNKNOWN'}' has invalid min_count: ${item.min_count}`);
+        }
+        if (!Array.isArray(detection.scoring_signals) || detection.scoring_signals.length === 0) {
+            warn('detection.scoring_signals is empty; pipeline will never be selected by scoring');
+        }
+    }
+    /**
+     * Load all pipeline skills from the pipelines directory
+     */
+    async loadPipelines() {
+        if (this.initialized)
+            return;
+        console.log(`[PipelineSkillLoader] Loading pipelines from: ${this.pipelinesDir}`);
+        if (!fs_1.default.existsSync(this.pipelinesDir)) {
+            console.warn(`[PipelineSkillLoader] Pipelines directory not found: ${this.pipelinesDir}`);
+            this.initialized = true;
+            return;
+        }
+        const files = fs_1.default.readdirSync(this.pipelinesDir);
+        for (const file of files) {
+            // Skip non-skill files (index.yaml, _base.skill.yaml)
+            if (!file.endsWith('.skill.yaml') && !file.endsWith('.skill.yml'))
+                continue;
+            if (file.startsWith('_'))
+                continue;
+            const filePath = path_1.default.join(this.pipelinesDir, file);
+            try {
+                const content = fs_1.default.readFileSync(filePath, 'utf-8');
+                const pipeline = js_yaml_1.default.load(content);
+                if (pipeline && pipeline.meta?.pipeline_id) {
+                    this.validateDetection(pipeline, file);
+                    this.pipelineCache.set(pipeline.meta.pipeline_id, pipeline);
+                    console.log(`[PipelineSkillLoader] Loaded pipeline: ${pipeline.meta.pipeline_id} (${pipeline.meta.display_name})`);
+                }
+            }
+            catch (error) {
+                console.error(`[PipelineSkillLoader] Failed to load ${file}:`, error.message);
+            }
+        }
+        this.initialized = true;
+        console.log(`[PipelineSkillLoader] Loaded ${this.pipelineCache.size} pipeline definitions`);
+    }
+    /**
+     * Get a pipeline definition by ID
+     */
+    getPipeline(pipelineId) {
+        return this.pipelineCache.get(pipelineId) || null;
+    }
+    /**
+     * Get all loaded pipelines
+     */
+    getAllPipelines() {
+        return Array.from(this.pipelineCache.values());
+    }
+    /**
+     * Get all pipeline IDs
+     */
+    getAllPipelineIds() {
+        return Array.from(this.pipelineCache.keys());
+    }
+    /**
+     * Get auto-pin instructions for a pipeline
+     */
+    getAutoPinInstructions(pipelineId) {
+        const pipeline = this.getPipeline(pipelineId);
+        if (!pipeline) {
+            console.warn(`[PipelineSkillLoader] Pipeline not found: ${pipelineId}, using default`);
+            return this.getDefaultPinInstructions();
+        }
+        return pipeline.auto_pin?.instructions || this.getDefaultPinInstructions();
+    }
+    /**
+     * Get smart filter configurations for a pipeline
+     * Returns a map of pattern -> SmartFilterConfig
+     */
+    getSmartFilterConfigs(pipelineId) {
+        const configs = new Map();
+        const pipeline = this.getPipeline(pipelineId);
+        if (!pipeline)
+            return configs;
+        for (const inst of pipeline.auto_pin?.instructions || []) {
+            if (inst.smart_filter?.enabled) {
+                configs.set(inst.pattern, inst.smart_filter);
+            }
+        }
+        return configs;
+    }
+    /**
+     * Get teaching content for a pipeline
+     */
+    getTeachingContent(pipelineId) {
+        const pipeline = this.getPipeline(pipelineId);
+        return pipeline?.teaching || null;
+    }
+    /**
+     * Get pipeline meta information
+     */
+    getPipelineMeta(pipelineId) {
+        const pipeline = this.getPipeline(pipelineId);
+        return pipeline?.meta || null;
+    }
+    /**
+     * Get recommended skills for a pipeline
+     */
+    getRecommendedSkills(pipelineId) {
+        const pipeline = this.getPipeline(pipelineId);
+        return pipeline?.analysis?.recommended_skills || [];
+    }
+    /**
+     * Get common issues for a pipeline
+     */
+    getCommonIssues(pipelineId) {
+        const pipeline = this.getPipeline(pipelineId);
+        return pipeline?.analysis?.common_issues || [];
+    }
+    /**
+     * Check if loader is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Reload all pipeline skills
+     */
+    async reload() {
+        this.pipelineCache.clear();
+        this.initialized = false;
+        await this.loadPipelines();
+    }
+    /**
+     * Default pin instructions for fallback
+     */
+    getDefaultPinInstructions() {
+        return [
+            {
+                pattern: '^VSYNC-app$',
+                match_by: 'name',
+                priority: 1,
+                reason: 'VSync (App 开始生产帧)',
+            },
+            {
+                pattern: '^main(\\s+\\d+)?$',
+                match_by: 'name',
+                priority: 2,
+                reason: 'App 主线程',
+            },
+            {
+                pattern: '^RenderThread(\\s+\\d+)?$',
+                match_by: 'name',
+                priority: 3,
+                reason: 'App 渲染线程 (RenderThread)',
+            },
+            {
+                pattern: '^VSYNC-sf$',
+                match_by: 'name',
+                priority: 5.5,
+                reason: 'VSync (SurfaceFlinger 消费/合成)',
+            },
+            {
+                pattern: '^SurfaceFlinger$',
+                match_by: 'name',
+                priority: 7,
+                reason: 'SurfaceFlinger (最终合成/显示)',
+            },
+        ];
+    }
+}
+// =============================================================================
+// Singleton and Helper Functions
+// =============================================================================
+exports.pipelineSkillLoader = new PipelineSkillLoaderClass();
+// Promise-based lock to prevent concurrent initialization
+let initializationPromise = null;
+/**
+ * Ensure pipeline skill loader is initialized
+ * Safe to call concurrently - will only initialize once
+ */
+async function ensurePipelineSkillsInitialized() {
+    // Fast path: already initialized
+    if (exports.pipelineSkillLoader.isInitialized())
+        return;
+    // If initialization is in progress, wait for it
+    if (initializationPromise) {
+        await initializationPromise;
+        return;
+    }
+    // Start initialization
+    initializationPromise = exports.pipelineSkillLoader.loadPipelines();
+    try {
+        await initializationPromise;
+    }
+    finally {
+        if (!exports.pipelineSkillLoader.isInitialized()) {
+            initializationPromise = null;
+        }
+    }
+}
+/**
+ * Get pipeline skill loader instance
+ */
+function getPipelineSkillLoader() {
+    return exports.pipelineSkillLoader;
+}
+/**
+ * Convenience function to get auto-pin instructions
+ */
+async function getAutoPinInstructions(pipelineId) {
+    await ensurePipelineSkillsInitialized();
+    return exports.pipelineSkillLoader.getAutoPinInstructions(pipelineId);
+}
+/**
+ * Convenience function to get teaching content
+ */
+async function getTeachingContent(pipelineId) {
+    await ensurePipelineSkillsInitialized();
+    return exports.pipelineSkillLoader.getTeachingContent(pipelineId);
+}
+/**
+ * Convenience function to get smart filter configs
+ */
+async function getSmartFilterConfigs(pipelineId) {
+    await ensurePipelineSkillsInitialized();
+    return exports.pipelineSkillLoader.getSmartFilterConfigs(pipelineId);
+}
+//# sourceMappingURL=pipelineSkillLoader.js.map

package/dist/services/pipelineSkillLoader.js.map

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

package/dist/services/portPool.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Port Pool Manager
+ *
+ * Manages a pool of ports for trace_processor_shell HTTP servers.
+ * Ensures ports are properly allocated and released.
+ */
+import { EventEmitter } from 'events';
+export interface PortAllocation {
+    port: number;
+    traceId: string;
+    allocatedAt: Date;
+}
+export declare class PortPool extends EventEmitter {
+    private readonly minPort;
+    private readonly maxPort;
+    private availablePorts;
+    private blockedPorts;
+    private allocations;
+    private portToTraceId;
+    constructor(minPort?: number, maxPort?: number);
+    /**
+     * Allocate a port for a trace
+     * @param traceId The trace ID requesting a port
+     * @returns The allocated port number
+     * @throws Error if no ports are available
+     */
+    allocate(traceId: string): number;
+    /**
+     * Release a port back to the pool
+     * @param traceId The trace ID releasing the port
+     * @returns true if port was released, false if trace had no port
+     */
+    release(traceId: string): boolean;
+    /**
+     * Release a port by port number (useful when trace ID is unknown)
+     * @param port The port number to release
+     * @returns true if port was released
+     */
+    releaseByPort(port: number): boolean;
+    /**
+     * Mark a port as unusable for the remainder of this process.
+     * This is used when trace_processor_shell reports "Address already in use".
+     */
+    blockPort(port: number): void;
+    /**
+     * Get the port allocated to a trace
+     * @param traceId The trace ID
+     * @returns The port number or null if not allocated
+     */
+    getPort(traceId: string): number | null;
+    /**
+     * Check if a port is available
+     * @param port The port to check
+     * @returns true if the port is available
+     */
+    isAvailable(port: number): boolean;
+    /**
+     * Get the next available port
+     * @returns The next available port or null if none available
+     */
+    private getNextAvailablePort;
+    /**
+     * Get pool statistics
+     */
+    getStats(): {
+        total: number;
+        available: number;
+        allocated: number;
+        blocked: number;
+        allocations: PortAllocation[];
+    };
+    /**
+     * Release all ports (cleanup)
+     */
+    releaseAll(): void;
+    /**
+     * Force cleanup stale allocations (ports allocated more than maxAge ago)
+     * @param maxAgeMs Maximum age in milliseconds
+     * @returns Number of stale allocations cleaned
+     */
+    cleanupStale(maxAgeMs?: number): number;
+}
+export declare function getPortPool(): PortPool;
+export declare function resetPortPool(): void;
+//# sourceMappingURL=portPool.d.ts.map

package/dist/services/portPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portPool.d.ts","sourceRoot":"","sources":["../../src/services/portPool.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,qBAAa,QAAS,SAAQ,YAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,aAAa,CAAsB;gBAGzC,OAAO,GAAE,MAA2C,EACpD,OAAO,GAAE,MAA2C;IAoBtD;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAkCjC;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IA2BjC;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAgBpC;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAe7B;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKvC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,cAAc,EAAE,CAAC;KAC/B;IAUD;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;;;OAIG;IACH,YAAY,CAAC,QAAQ,GAAE,MAAqD,GAAG,MAAM;CAmBtF;AAKD,wBAAgB,WAAW,IAAI,QAAQ,CAKtC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}

package/dist/services/portPool.js

@@ -0,0 +1,221 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PortPool = void 0;
+exports.getPortPool = getPortPool;
+exports.resetPortPool = resetPortPool;
+/**
+ * Port Pool Manager
+ *
+ * Manages a pool of ports for trace_processor_shell HTTP servers.
+ * Ensures ports are properly allocated and released.
+ */
+const events_1 = require("events");
+const config_1 = require("../config");
+const IS_TEST_ENV = process.env.NODE_ENV === 'test' || process.env.JEST_WORKER_ID !== undefined;
+class PortPool extends events_1.EventEmitter {
+    constructor(minPort = config_1.traceProcessorConfig.portRange.min, maxPort = config_1.traceProcessorConfig.portRange.max) {
+        super();
+        this.minPort = minPort;
+        this.maxPort = maxPort;
+        this.availablePorts = new Set();
+        this.blockedPorts = new Set();
+        this.allocations = new Map();
+        this.portToTraceId = new Map();
+        // Initialize all ports as available
+        for (let port = minPort; port <= maxPort; port++) {
+            this.availablePorts.add(port);
+        }
+        if (!IS_TEST_ENV) {
+            console.log(`[PortPool] Initialized with ${this.availablePorts.size} ports (${minPort}-${maxPort})`);
+        }
+    }
+    /**
+     * Allocate a port for a trace
+     * @param traceId The trace ID requesting a port
+     * @returns The allocated port number
+     * @throws Error if no ports are available
+     */
+    allocate(traceId) {
+        // Check if this trace already has a port
+        const existing = this.allocations.get(traceId);
+        if (existing) {
+            if (!IS_TEST_ENV) {
+                console.log(`[PortPool] Trace ${traceId} already has port ${existing.port}`);
+            }
+            return existing.port;
+        }
+        // Get the first available port
+        const port = this.getNextAvailablePort();
+        if (port === null) {
+            throw new Error(`No available ports in pool (${this.minPort}-${this.maxPort}). Active allocations: ${this.allocations.size}`);
+        }
+        // Mark port as allocated
+        this.availablePorts.delete(port);
+        const allocation = {
+            port,
+            traceId,
+            allocatedAt: new Date(),
+        };
+        this.allocations.set(traceId, allocation);
+        this.portToTraceId.set(port, traceId);
+        if (!IS_TEST_ENV) {
+            console.log(`[PortPool] Allocated port ${port} to trace ${traceId} (${this.availablePorts.size} available)`);
+        }
+        this.emit('allocated', { port, traceId });
+        return port;
+    }
+    /**
+     * Release a port back to the pool
+     * @param traceId The trace ID releasing the port
+     * @returns true if port was released, false if trace had no port
+     */
+    release(traceId) {
+        const allocation = this.allocations.get(traceId);
+        if (!allocation) {
+            if (!IS_TEST_ENV) {
+                console.log(`[PortPool] Trace ${traceId} has no port to release`);
+            }
+            return false;
+        }
+        const port = allocation.port;
+        // Return port to available pool
+        this.allocations.delete(traceId);
+        this.portToTraceId.delete(port);
+        // If a port is known-bad, keep it blocked even after release.
+        if (!this.blockedPorts.has(port)) {
+            this.availablePorts.add(port);
+        }
+        if (!IS_TEST_ENV) {
+            console.log(`[PortPool] Released port ${port} from trace ${traceId} (${this.availablePorts.size} available)`);
+        }
+        this.emit('released', { port, traceId });
+        return true;
+    }
+    /**
+     * Release a port by port number (useful when trace ID is unknown)
+     * @param port The port number to release
+     * @returns true if port was released
+     */
+    releaseByPort(port) {
+        const traceId = this.portToTraceId.get(port);
+        if (!traceId) {
+            // Port might not be tracked, just add it back to available
+            if (port >= this.minPort && port <= this.maxPort && !this.availablePorts.has(port) && !this.blockedPorts.has(port)) {
+                this.availablePorts.add(port);
+                if (!IS_TEST_ENV) {
+                    console.log(`[PortPool] Force-released untracked port ${port}`);
+                }
+                return true;
+            }
+            return false;
+        }
+        return this.release(traceId);
+    }
+    /**
+     * Mark a port as unusable for the remainder of this process.
+     * This is used when trace_processor_shell reports "Address already in use".
+     */
+    blockPort(port) {
+        if (port < this.minPort || port > this.maxPort)
+            return;
+        // If the port is currently allocated, release it first (will try to add back, but we will keep it blocked).
+        const traceId = this.portToTraceId.get(port);
+        if (traceId) {
+            this.release(traceId);
+        }
+        this.availablePorts.delete(port);
+        this.blockedPorts.add(port);
+        console.log(`[PortPool] Blocked port ${port} (marked unusable)`);
+        this.emit('blocked', { port });
+    }
+    /**
+     * Get the port allocated to a trace
+     * @param traceId The trace ID
+     * @returns The port number or null if not allocated
+     */
+    getPort(traceId) {
+        const allocation = this.allocations.get(traceId);
+        return allocation ? allocation.port : null;
+    }
+    /**
+     * Check if a port is available
+     * @param port The port to check
+     * @returns true if the port is available
+     */
+    isAvailable(port) {
+        return this.availablePorts.has(port);
+    }
+    /**
+     * Get the next available port
+     * @returns The next available port or null if none available
+     */
+    getNextAvailablePort() {
+        if (this.availablePorts.size === 0) {
+            return null;
+        }
+        // Get the smallest available port for predictability
+        return Math.min(...this.availablePorts);
+    }
+    /**
+     * Get pool statistics
+     */
+    getStats() {
+        return {
+            total: this.maxPort - this.minPort + 1,
+            available: this.availablePorts.size,
+            allocated: this.allocations.size,
+            blocked: this.blockedPorts.size,
+            allocations: Array.from(this.allocations.values()),
+        };
+    }
+    /**
+     * Release all ports (cleanup)
+     */
+    releaseAll() {
+        const traceIds = Array.from(this.allocations.keys());
+        for (const traceId of traceIds) {
+            this.release(traceId);
+        }
+        console.log(`[PortPool] Released all ports`);
+    }
+    /**
+     * Force cleanup stale allocations (ports allocated more than maxAge ago)
+     * @param maxAgeMs Maximum age in milliseconds
+     * @returns Number of stale allocations cleaned
+     */
+    cleanupStale(maxAgeMs = config_1.traceProcessorConfig.staleAllocationMaxAgeMs) {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [traceId, allocation] of this.allocations) {
+            const age = now - allocation.allocatedAt.getTime();
+            if (age > maxAgeMs) {
+                console.log(`[PortPool] Cleaning stale allocation: port ${allocation.port} for trace ${traceId} (age: ${Math.round(age / 1000)}s)`);
+                this.release(traceId);
+                cleaned++;
+            }
+        }
+        if (cleaned > 0) {
+            console.log(`[PortPool] Cleaned ${cleaned} stale allocations`);
+        }
+        return cleaned;
+    }
+}
+exports.PortPool = PortPool;
+// Singleton instance
+let portPoolInstance = null;
+function getPortPool() {
+    if (!portPoolInstance) {
+        portPoolInstance = new PortPool();
+    }
+    return portPoolInstance;
+}
+function resetPortPool() {
+    if (portPoolInstance) {
+        portPoolInstance.releaseAll();
+    }
+    portPoolInstance = new PortPool();
+}
+//# sourceMappingURL=portPool.js.map

package/dist/services/portPool.js.map

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

package/dist/services/processIdentity/identityGate.d.ts

@@ -0,0 +1,27 @@
+import type { SkillDefinition } from '../skillEngine/types';
+import { type ProcessIdentityResolution, type ProcessIdentityTarget, type SkillIdentityConfig } from './types';
+export interface IdentityGateInput {
+    traceId: string;
+    skill: SkillDefinition;
+    params: Record<string, any>;
+    inherited?: Record<string, any>;
+    resolve: (target: ProcessIdentityTarget) => Promise<ProcessIdentityResolution>;
+}
+export interface IdentityGateResult {
+    allowed: boolean;
+    params: Record<string, any>;
+    inherited: Record<string, any>;
+    config: SkillIdentityConfig;
+    target?: ProcessIdentityTarget;
+    resolution?: ProcessIdentityResolution;
+    error?: string;
+}
+export declare function sqlUsesProcessNameFilter(sql: string): boolean;
+export declare function collectSkillSql(skill: SkillDefinition): string;
+export declare function skillUsesProcessNameFilter(skill: SkillDefinition): boolean;
+export declare function getEffectiveIdentityConfig(skill: SkillDefinition): SkillIdentityConfig;
+export declare function extractProcessIdentityTarget(params: Record<string, any>, inherited: Record<string, any>, config: SkillIdentityConfig): ProcessIdentityTarget;
+export declare class IdentityGate {
+    apply(input: IdentityGateInput): Promise<IdentityGateResult>;
+}
+//# sourceMappingURL=identityGate.d.ts.map

package/dist/services/processIdentity/identityGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identityGate.d.ts","sourceRoot":"","sources":["../../../src/services/processIdentity/identityGate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACzB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,OAAO,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyCD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAsB7D;AAuBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAO9D;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE1E;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,eAAe,GAAG,mBAAmB,CA2BtF;AAiBD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,MAAM,EAAE,mBAAmB,GAC1B,qBAAqB,CAiBvB;AAqED,qBAAa,YAAY;IACjB,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA0EnE"}