@a5c-ai/agent-platform 5.0.1-staging.016f0b0e8119

package/dist/plugins/sandbox.d.ts

@@ -0,0 +1,38 @@
+/**
+ * PluginSandbox — permission tracking and policy enforcement for loaded plugins.
+ *
+ * Each plugin is assigned a set of permissions drawn from its manifest.
+ * Runtime checks gate access to resources (file paths, network, shell, etc.)
+ * by combining the granted permissions with an optional PluginSandboxConfig.
+ */
+import type { PluginPermission, PluginSandboxConfig } from './types';
+export declare class PluginSandbox {
+    private permissions;
+    private configs;
+    /** Grant a single permission to a plugin. */
+    grantPermission(pluginId: string, permission: PluginPermission): void;
+    /** Revoke a single permission from a plugin. */
+    revokePermission(pluginId: string, permission: PluginPermission): void;
+    /** Check whether a plugin currently holds a given permission. */
+    checkPermission(pluginId: string, permission: PluginPermission): boolean;
+    /** Return the full list of permissions granted to a plugin. */
+    getPermissions(pluginId: string): PluginPermission[];
+    /** Attach a sandbox configuration (memory / timeout / allowed paths) for a plugin. */
+    setConfig(pluginId: string, config: PluginSandboxConfig): void;
+    /** Retrieve the sandbox configuration for a plugin, if any. */
+    getConfig(pluginId: string): PluginSandboxConfig | undefined;
+    /**
+     * Determine whether a plugin is allowed to perform `action` on `resource`.
+     *
+     * The check works in two stages:
+     * 1. The action is mapped to a required permission. If the plugin does not
+     *    hold that permission the call is denied.
+     * 2. For file-system actions the optional `allowedPaths` list in the sandbox
+     *    config is consulted. If the list exists and the resource does not start
+     *    with any allowed prefix the call is denied.
+     */
+    isAllowed(pluginId: string, action: string, resource?: string): boolean;
+    /** Remove all permission and config state for a plugin. */
+    clear(pluginId: string): void;
+}
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/plugins/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/plugins/sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAarE,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,OAAO,CAA0C;IAMzD,6CAA6C;IAC7C,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI;IASrE,gDAAgD;IAChD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAOtE,iEAAiE;IACjE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO;IAIxE,+DAA+D;IAC/D,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE;IASpD,sFAAsF;IACtF,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAI9D,+DAA+D;IAC/D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAQ5D;;;;;;;;;OASG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAoCvE,2DAA2D;IAC3D,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAI9B"}

package/dist/plugins/sandbox.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * PluginSandbox — permission tracking and policy enforcement for loaded plugins.
+ *
+ * Each plugin is assigned a set of permissions drawn from its manifest.
+ * Runtime checks gate access to resources (file paths, network, shell, etc.)
+ * by combining the granted permissions with an optional PluginSandboxConfig.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginSandbox = void 0;
+/** Map from a high-level action verb to the permission(s) it requires. */
+const ACTION_PERMISSION_MAP = {
+    read: 'fs:read',
+    write: 'fs:write',
+    fetch: 'net:outbound',
+    spawn: 'process:spawn',
+    env: 'env:read',
+    mcp: 'mcp:connect',
+    shell: 'shell:execute',
+};
+class PluginSandbox {
+    permissions = new Map();
+    configs = new Map();
+    // ---------------------------------------------------------------------------
+    // Permission CRUD
+    // ---------------------------------------------------------------------------
+    /** Grant a single permission to a plugin. */
+    grantPermission(pluginId, permission) {
+        let perms = this.permissions.get(pluginId);
+        if (!perms) {
+            perms = new Set();
+            this.permissions.set(pluginId, perms);
+        }
+        perms.add(permission);
+    }
+    /** Revoke a single permission from a plugin. */
+    revokePermission(pluginId, permission) {
+        const perms = this.permissions.get(pluginId);
+        if (perms) {
+            perms.delete(permission);
+        }
+    }
+    /** Check whether a plugin currently holds a given permission. */
+    checkPermission(pluginId, permission) {
+        return this.permissions.get(pluginId)?.has(permission) ?? false;
+    }
+    /** Return the full list of permissions granted to a plugin. */
+    getPermissions(pluginId) {
+        const perms = this.permissions.get(pluginId);
+        return perms ? [...perms] : [];
+    }
+    // ---------------------------------------------------------------------------
+    // Configuration
+    // ---------------------------------------------------------------------------
+    /** Attach a sandbox configuration (memory / timeout / allowed paths) for a plugin. */
+    setConfig(pluginId, config) {
+        this.configs.set(pluginId, config);
+    }
+    /** Retrieve the sandbox configuration for a plugin, if any. */
+    getConfig(pluginId) {
+        return this.configs.get(pluginId);
+    }
+    // ---------------------------------------------------------------------------
+    // Policy check
+    // ---------------------------------------------------------------------------
+    /**
+     * Determine whether a plugin is allowed to perform `action` on `resource`.
+     *
+     * The check works in two stages:
+     * 1. The action is mapped to a required permission. If the plugin does not
+     *    hold that permission the call is denied.
+     * 2. For file-system actions the optional `allowedPaths` list in the sandbox
+     *    config is consulted. If the list exists and the resource does not start
+     *    with any allowed prefix the call is denied.
+     */
+    isAllowed(pluginId, action, resource) {
+        // Resolve the permission required for this action
+        const requiredPermission = ACTION_PERMISSION_MAP[action];
+        if (!requiredPermission) {
+            // Unknown action — deny by default
+            return false;
+        }
+        if (!this.checkPermission(pluginId, requiredPermission)) {
+            return false;
+        }
+        // For filesystem operations, enforce allowedPaths when configured
+        if (resource &&
+            (requiredPermission === 'fs:read' || requiredPermission === 'fs:write')) {
+            const config = this.configs.get(pluginId);
+            if (config?.allowedPaths && config.allowedPaths.length > 0) {
+                const normalised = resource.replace(/\\/g, '/');
+                const allowed = config.allowedPaths.some((p) => normalised.startsWith(p.replace(/\\/g, '/')));
+                if (!allowed) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    // ---------------------------------------------------------------------------
+    // Cleanup
+    // ---------------------------------------------------------------------------
+    /** Remove all permission and config state for a plugin. */
+    clear(pluginId) {
+        this.permissions.delete(pluginId);
+        this.configs.delete(pluginId);
+    }
+}
+exports.PluginSandbox = PluginSandbox;

package/dist/plugins/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Plugin sandboxing types for L6 Agent-Platform.
+ * Defines the permission model, manifest schema, instance lifecycle,
+ * and sandbox configuration for loaded plugins.
+ */
+export type PluginPermission = 'fs:read' | 'fs:write' | 'net:outbound' | 'process:spawn' | 'env:read' | 'mcp:connect' | 'shell:execute';
+export interface PluginManifest {
+    id: string;
+    name: string;
+    version: string;
+    permissions: PluginPermission[];
+    entrypoint: string;
+    minPlatformVersion?: string;
+}
+export type PluginStatus = 'loaded' | 'unloaded' | 'error' | 'loading';
+export interface PluginInstance {
+    manifest: PluginManifest;
+    status: PluginStatus;
+    loadedAt?: number;
+    error?: string;
+}
+export interface PluginSandboxConfig {
+    maxMemoryMb?: number;
+    timeoutMs?: number;
+    allowedPaths?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,UAAU,GACV,cAAc,GACd,eAAe,GACf,UAAU,GACV,aAAa,GACb,eAAe,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/dist/plugins/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Plugin sandboxing types for L6 Agent-Platform.
+ * Defines the permission model, manifest schema, instance lifecycle,
+ * and sandbox configuration for loaded plugins.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/plugins/version-check.d.ts

@@ -0,0 +1,23 @@
+/**
+ * PluginVersionChecker — simple semver compatibility checks for plugins.
+ *
+ * Compares a plugin manifest's `minPlatformVersion` against the current
+ * platform version to determine whether the plugin is compatible.
+ */
+import type { PluginManifest } from './types';
+export interface VersionCheckResult {
+    compatible: boolean;
+    issues: string[];
+}
+export declare class PluginVersionChecker {
+    /**
+     * Check whether a plugin manifest is compatible with the given platform
+     * version.
+     *
+     * When `minPlatformVersion` is not specified in the manifest the plugin
+     * is assumed compatible. Invalid version strings produce an issue but
+     * are treated as incompatible.
+     */
+    checkCompatibility(manifest: PluginManifest, platformVersion: string): VersionCheckResult;
+}
+//# sourceMappingURL=version-check.d.ts.map

package/dist/plugins/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/plugins/version-check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAmCD,qBAAa,oBAAoB;IAC/B;;;;;;;OAOG;IACH,kBAAkB,CAChB,QAAQ,EAAE,cAAc,EACxB,eAAe,EAAE,MAAM,GACtB,kBAAkB;CAkCtB"}

package/dist/plugins/version-check.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * PluginVersionChecker — simple semver compatibility checks for plugins.
+ *
+ * Compares a plugin manifest's `minPlatformVersion` against the current
+ * platform version to determine whether the plugin is compatible.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginVersionChecker = void 0;
+/**
+ * Parse a version string in `major.minor.patch` format.
+ * Returns `undefined` if the string is not a valid semver triple.
+ */
+function parseSemVer(version) {
+    const cleaned = version.replace(/^v/, '');
+    const parts = cleaned.split('.');
+    if (parts.length < 3)
+        return undefined;
+    const major = parseInt(parts[0], 10);
+    const minor = parseInt(parts[1], 10);
+    // Strip pre-release / build metadata for comparison
+    const patch = parseInt(parts[2].split('-')[0], 10);
+    if (isNaN(major) || isNaN(minor) || isNaN(patch))
+        return undefined;
+    return { major, minor, patch };
+}
+/**
+ * Return `true` if `actual >= required` using standard semver ordering.
+ */
+function semverGte(actual, required) {
+    if (actual.major !== required.major)
+        return actual.major > required.major;
+    if (actual.minor !== required.minor)
+        return actual.minor > required.minor;
+    return actual.patch >= required.patch;
+}
+class PluginVersionChecker {
+    /**
+     * Check whether a plugin manifest is compatible with the given platform
+     * version.
+     *
+     * When `minPlatformVersion` is not specified in the manifest the plugin
+     * is assumed compatible. Invalid version strings produce an issue but
+     * are treated as incompatible.
+     */
+    checkCompatibility(manifest, platformVersion) {
+        const issues = [];
+        // If the manifest does not specify a minimum, it is compatible with any version
+        if (!manifest.minPlatformVersion) {
+            return { compatible: true, issues };
+        }
+        const required = parseSemVer(manifest.minPlatformVersion);
+        if (!required) {
+            issues.push(`Invalid minPlatformVersion "${manifest.minPlatformVersion}" in manifest for plugin "${manifest.id}"`);
+            return { compatible: false, issues };
+        }
+        const actual = parseSemVer(platformVersion);
+        if (!actual) {
+            issues.push(`Invalid platform version "${platformVersion}" — cannot verify compatibility`);
+            return { compatible: false, issues };
+        }
+        if (!semverGte(actual, required)) {
+            issues.push(`Plugin "${manifest.id}" requires platform >= ${manifest.minPlatformVersion}, ` +
+                `but current platform is ${platformVersion}`);
+            return { compatible: false, issues };
+        }
+        return { compatible: true, issues };
+    }
+}
+exports.PluginVersionChecker = PluginVersionChecker;

package/dist/processes/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Process recommender module for L6 Agent-Platform.
+ *
+ * Provides process registration, criteria-based scoring, and
+ * recommendation of the most relevant processes for a given task.
+ */
+export type { ProcessDescriptor, RecommendationCriteria, ProcessRecommendation, } from './types';
+export { ProcessScorer } from './scorer';
+export type { ScoringResult } from './scorer';
+export { ProcessRecommender } from './recommender';
+export type { ProcessFilter } from './recommender';
+//# sourceMappingURL=index.d.ts.map

package/dist/processes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/processes/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/processes/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Process recommender module for L6 Agent-Platform.
+ *
+ * Provides process registration, criteria-based scoring, and
+ * recommendation of the most relevant processes for a given task.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessRecommender = exports.ProcessScorer = void 0;
+// Scorer
+var scorer_1 = require("./scorer");
+Object.defineProperty(exports, "ProcessScorer", { enumerable: true, get: function () { return scorer_1.ProcessScorer; } });
+// Recommender
+var recommender_1 = require("./recommender");
+Object.defineProperty(exports, "ProcessRecommender", { enumerable: true, get: function () { return recommender_1.ProcessRecommender; } });

package/dist/processes/recommender.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ProcessRecommender — registers process descriptors and recommends
+ * the most relevant ones for a given set of criteria.
+ *
+ * Delegates scoring to {@link ProcessScorer} and exposes a simple
+ * registry + query API analogous to the sibling SkillRouter.
+ */
+import type { ProcessDescriptor, ProcessRecommendation, RecommendationCriteria } from './types';
+export interface ProcessFilter {
+    category?: string;
+    domain?: string;
+}
+export declare class ProcessRecommender {
+    private readonly registry;
+    private readonly scorer;
+    /** Register a single process descriptor. Replaces any existing entry with the same id. */
+    register(descriptor: ProcessDescriptor): void;
+    /** Register multiple descriptors at once. */
+    registerBatch(descriptors: ProcessDescriptor[]): void;
+    /**
+     * Score all registered processes against the given criteria and return
+     * the top results sorted by descending score. Processes that score 0
+     * are excluded.
+     */
+    recommend(criteria: RecommendationCriteria): ProcessRecommendation[];
+    /** Look up a process descriptor by its id. */
+    getById(id: string): ProcessDescriptor | undefined;
+    /**
+     * List all registered descriptors, optionally filtered by category
+     * and/or domain.
+     */
+    list(filter?: ProcessFilter): ProcessDescriptor[];
+    /** Return the number of registered process descriptors. */
+    get size(): number;
+}
+//# sourceMappingURL=recommender.d.ts.map

package/dist/processes/recommender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommender.d.ts","sourceRoot":"","sources":["../../src/processes/recommender.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAKjB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAI9C,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAI7C,6CAA6C;IAC7C,aAAa,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAQrD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,sBAAsB,GAAG,qBAAqB,EAAE;IAepE,8CAA8C;IAC9C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIlD;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,iBAAiB,EAAE;IAgBjD,2DAA2D;IAC3D,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/processes/recommender.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * ProcessRecommender — registers process descriptors and recommends
+ * the most relevant ones for a given set of criteria.
+ *
+ * Delegates scoring to {@link ProcessScorer} and exposes a simple
+ * registry + query API analogous to the sibling SkillRouter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessRecommender = void 0;
+const scorer_1 = require("./scorer");
+const DEFAULT_MAX_RESULTS = 5;
+class ProcessRecommender {
+    registry = new Map();
+    scorer = new scorer_1.ProcessScorer();
+    // ── registration ─────────────────────────────────────────────────────────
+    /** Register a single process descriptor. Replaces any existing entry with the same id. */
+    register(descriptor) {
+        this.registry.set(descriptor.id, descriptor);
+    }
+    /** Register multiple descriptors at once. */
+    registerBatch(descriptors) {
+        for (const descriptor of descriptors) {
+            this.register(descriptor);
+        }
+    }
+    // ── queries ──────────────────────────────────────────────────────────────
+    /**
+     * Score all registered processes against the given criteria and return
+     * the top results sorted by descending score. Processes that score 0
+     * are excluded.
+     */
+    recommend(criteria) {
+        const maxResults = criteria.maxResults ?? DEFAULT_MAX_RESULTS;
+        const results = [];
+        for (const process of this.registry.values()) {
+            const { score, reasons } = this.scorer.score(process, criteria);
+            if (score > 0) {
+                results.push({ process, score, reasons });
+            }
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, maxResults);
+    }
+    /** Look up a process descriptor by its id. */
+    getById(id) {
+        return this.registry.get(id);
+    }
+    /**
+     * List all registered descriptors, optionally filtered by category
+     * and/or domain.
+     */
+    list(filter) {
+        const all = Array.from(this.registry.values());
+        if (!filter) {
+            return all;
+        }
+        return all.filter((process) => {
+            if (filter.category && process.category !== filter.category) {
+                return false;
+            }
+            if (filter.domain && process.domain !== filter.domain) {
+                return false;
+            }
+            return true;
+        });
+    }
+    /** Return the number of registered process descriptors. */
+    get size() {
+        return this.registry.size;
+    }
+}
+exports.ProcessRecommender = ProcessRecommender;

package/dist/processes/scorer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ProcessScorer — computes a relevance score for a ProcessDescriptor
+ * against a set of RecommendationCriteria.
+ *
+ * Scoring factors:
+ *   1. Keyword overlap between criteria text and the process description,
+ *      task ids, inputs, and outputs.
+ *   2. Category bonus when the process category appears in the criteria text.
+ *   3. Domain bonus when criteria.domain matches process.domain.
+ *   4. Quality score multiplier (boosts/dampens the raw score).
+ */
+import type { ProcessDescriptor, RecommendationCriteria } from './types';
+export interface ScoringResult {
+    score: number;
+    reasons: string[];
+}
+export declare class ProcessScorer {
+    /**
+     * Score a single process against the given criteria.
+     *
+     * Returns a composite score >= 0 and an array of human-readable
+     * reason strings explaining what contributed to the score.
+     */
+    score(process: ProcessDescriptor, criteria: RecommendationCriteria): ScoringResult;
+}
+//# sourceMappingURL=scorer.d.ts.map

package/dist/processes/scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../../src/processes/scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAoCzE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,sBAAsB,GAAG,aAAa;CA6DnF"}

package/dist/processes/scorer.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * ProcessScorer — computes a relevance score for a ProcessDescriptor
+ * against a set of RecommendationCriteria.
+ *
+ * Scoring factors:
+ *   1. Keyword overlap between criteria text and the process description,
+ *      task ids, inputs, and outputs.
+ *   2. Category bonus when the process category appears in the criteria text.
+ *   3. Domain bonus when criteria.domain matches process.domain.
+ *   4. Quality score multiplier (boosts/dampens the raw score).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessScorer = void 0;
+// ── helpers ──────────────────────────────────────────────────────────────────
+/** Normalize text to a set of lowercase tokens for overlap scoring. */
+function tokenize(text) {
+    return new Set(text
+        .toLowerCase()
+        .split(/[\s,.\-_/|:;]+/)
+        .filter((token) => token.length > 1));
+}
+/** Count how many tokens from `query` appear in `corpus`. */
+function tokenOverlap(query, corpus) {
+    let count = 0;
+    for (const token of query) {
+        if (corpus.has(token)) {
+            count += 1;
+        }
+    }
+    return count;
+}
+// ── constants ────────────────────────────────────────────────────────────────
+const CATEGORY_BONUS = 10;
+const DOMAIN_BONUS = 15;
+/** Range for the quality multiplier: [MIN, MAX]. */
+const QUALITY_MULTIPLIER_MIN = 0.5;
+const QUALITY_MULTIPLIER_MAX = 1.5;
+class ProcessScorer {
+    /**
+     * Score a single process against the given criteria.
+     *
+     * Returns a composite score >= 0 and an array of human-readable
+     * reason strings explaining what contributed to the score.
+     */
+    score(process, criteria) {
+        let rawScore = 0;
+        const reasons = [];
+        // ── 1. Build query tokens from criteria ────────────────────────────
+        const queryParts = [criteria.taskDescription];
+        if (criteria.repoContext)
+            queryParts.push(criteria.repoContext);
+        if (criteria.capabilities)
+            queryParts.push(...criteria.capabilities);
+        const queryTokens = tokenize(queryParts.join(' '));
+        // ── 2. Build corpus tokens from process ────────────────────────────
+        const corpusParts = [process.name, process.description];
+        if (process.category)
+            corpusParts.push(process.category);
+        if (process.tasks)
+            corpusParts.push(...process.tasks);
+        if (process.inputs)
+            corpusParts.push(...process.inputs);
+        if (process.outputs)
+            corpusParts.push(...process.outputs);
+        const corpusTokens = tokenize(corpusParts.join(' '));
+        // ── 3. Keyword overlap ─────────────────────────────────────────────
+        if (queryTokens.size > 0 && corpusTokens.size > 0) {
+            const overlap = tokenOverlap(queryTokens, corpusTokens);
+            if (overlap > 0) {
+                const ratio = overlap / queryTokens.size;
+                const keywordScore = ratio * 100;
+                rawScore += keywordScore;
+                reasons.push(`keyword overlap ${overlap}/${queryTokens.size} (${Math.round(ratio * 100)}%)`);
+            }
+        }
+        // ── 4. Category bonus ──────────────────────────────────────────────
+        if (process.category) {
+            const categoryLower = process.category.toLowerCase();
+            const rawQuery = queryParts.join(' ').toLowerCase();
+            if (rawQuery.includes(categoryLower)) {
+                rawScore += CATEGORY_BONUS;
+                reasons.push(`category match "${process.category}"`);
+            }
+        }
+        // ── 5. Domain bonus ────────────────────────────────────────────────
+        if (criteria.domain &&
+            process.domain &&
+            criteria.domain.toLowerCase() === process.domain.toLowerCase()) {
+            rawScore += DOMAIN_BONUS;
+            reasons.push('domain match');
+        }
+        // ── 6. Quality multiplier ──────────────────────────────────────────
+        if (typeof process.qualityScore === 'number' && rawScore > 0) {
+            const clamped = Math.max(0, Math.min(1, process.qualityScore));
+            const multiplier = QUALITY_MULTIPLIER_MIN +
+                clamped * (QUALITY_MULTIPLIER_MAX - QUALITY_MULTIPLIER_MIN);
+            rawScore *= multiplier;
+            reasons.push(`quality multiplier x${multiplier.toFixed(2)}`);
+        }
+        return { score: Math.round(rawScore * 100) / 100, reasons };
+    }
+}
+exports.ProcessScorer = ProcessScorer;

package/dist/processes/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Process recommender types for the L6 Agent-Platform.
+ *
+ * Mirrors the catalog's CatalogDiscoveryProcess shape in a
+ * platform-level descriptor that is registry-friendly and
+ * scoring-friendly, without coupling to the catalog layer.
+ */
+export interface ProcessDescriptor {
+    /** Unique identifier for the process (e.g. "dev/code-review"). */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** Free-text description of what the process does. */
+    description: string;
+    /** Optional category grouping (e.g. "dev", "ops"). */
+    category?: string;
+    /** Optional domain the process belongs to (e.g. "frontend", "security"). */
+    domain?: string;
+    /** Task identifiers contained in the process. */
+    tasks?: string[];
+    /** Named inputs the process expects. */
+    inputs?: string[];
+    /** Named outputs the process produces. */
+    outputs?: string[];
+    /** Optional 0-1 quality score assigned by external evaluators. */
+    qualityScore?: number;
+}
+export interface RecommendationCriteria {
+    /** Natural-language description of the task the user wants to accomplish. */
+    taskDescription: string;
+    /** Optional repo or project context string for additional relevance signals. */
+    repoContext?: string;
+    /** Optional domain to boost matching processes. */
+    domain?: string;
+    /** Optional capability keywords the process should cover. */
+    capabilities?: string[];
+    /** Maximum number of results to return (default: 5). */
+    maxResults?: number;
+}
+export interface ProcessRecommendation {
+    /** The matched process descriptor. */
+    process: ProcessDescriptor;
+    /** Computed relevance score (higher is better). */
+    score: number;
+    /** Human-readable reasons that contributed to the score. */
+    reasons: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/processes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/processes/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,eAAe,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/processes/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Process recommender types for the L6 Agent-Platform.
+ *
+ * Mirrors the catalog's CatalogDiscoveryProcess shape in a
+ * platform-level descriptor that is registry-friendly and
+ * scoring-friendly, without coupling to the catalog layer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/index.d.ts

@@ -0,0 +1,3 @@
+export { createRun, orchestrateIteration, commitEffectResult, commitEffectCancellation, createReplayEngine, createProcessContext, withProcessContext, getActiveProcessContext, requireProcessContext, STATE_CACHE_SCHEMA_VERSION, createStateCacheSnapshot, journalHeadsEqual, normalizeJournalHead, normalizeSnapshot, readStateCache, rebuildStateCache, writeStateCache, hashInvocationKey, EffectRequestedError, EffectPendingError, EffectCancelledError, ParallelPendingError, RunFailedError, replaySchemaVersion, } from "@a5c-ai/babysitter-sdk";
+export type { OrchestrateOptions, IterationResult, EffectAction, CommitEffectResultOptions, CommitEffectResultArtifacts, ProcessContext, DefinedTask, CreateRunOptions, CreateRunResult, ReplayEngine, CreateReplayEngineOptions, StateCacheSnapshot, StateCacheJournalHead, DerivedEffectSummary, } from "@a5c-ai/babysitter-sdk";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,2BAA2B,EAC3B,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC"}