@relayplane/proxy 1.9.20 → 1.9.21

package/dist/agent-policy.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Agent-Aware Routing Policy
+ *
+ * Manages loading, caching, and resolving routing policies from ~/.relayplane/policy.yaml.
+ * Policies allow per-agent and per-task model overrides.
+ */
+export interface TaskPolicy {
+    preferred: string;
+    neverDowngrade?: boolean;
+    escalateTo?: string;
+    escalateOn?: Array<'complexity_high' | 'rate_limit' | 'error'>;
+}
+export interface AgentPolicy {
+    fingerprint?: string;
+    preferred: string;
+    escalateTo?: string;
+    escalateOn?: Array<'complexity_high' | 'rate_limit' | 'error'>;
+    fallback?: string;
+    neverDowngrade?: boolean;
+    budgetPerDay?: number;
+    tasks?: Record<string, TaskPolicy>;
+}
+export interface RoutingPolicy {
+    version: number;
+    agents?: Record<string, AgentPolicy>;
+    tasks?: Record<string, TaskPolicy>;
+}
+export type ResolvedBy = 'agent_task_override' | 'task_rule' | 'agent_rule' | 'complexity_routing' | 'default_routing' | 'passthrough';
+export interface PolicyResolution {
+    model: string;
+    resolvedBy: ResolvedBy;
+    neverDowngrade: boolean;
+    reason: string;
+    candidateModel?: string;
+}
+export declare const POLICY_FILE: string;
+/** Reset cache — for testing only */
+export declare function _resetPolicyCache(): void;
+/**
+ * Load routing policy from ~/.relayplane/policy.yaml with 5-second TTL cache.
+ * Returns empty policy { version: 1 } if file is missing or invalid.
+ */
+export declare function loadPolicy(): RoutingPolicy;
+/**
+ * Resolve which model to use for a request, given the loaded policy.
+ *
+ * Resolution priority:
+ * 1. agent.tasks[taskType] override (agent_task_override)
+ * 2. policy.tasks[taskType] rule (task_rule)
+ * 3. agent-level rule (agent_rule)
+ * 4. pass-through: use candidateModel (complexity_routing)
+ */
+export declare function resolvePolicy(policy: RoutingPolicy, agentFingerprint: string | undefined, agentName: string | undefined, taskType: string, complexity: 'simple' | 'moderate' | 'complex', candidateModel: string): PolicyResolution;
+//# sourceMappingURL=agent-policy.d.ts.map

package/dist/agent-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-policy.d.ts","sourceRoot":"","sources":["../src/agent-policy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,UAAU,GAClB,qBAAqB,GACrB,WAAW,GACX,YAAY,GACZ,oBAAoB,GACpB,iBAAiB,GACjB,aAAa,CAAC;AAElB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAKD,eAAO,MAAM,WAAW,QAAuC,CAAC;AAUhE,qCAAqC;AACrC,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,aAAa,CA6B1C;AAID;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,EAC7C,cAAc,EAAE,MAAM,GACrB,gBAAgB,CAoElB"}

package/dist/agent-policy.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Agent-Aware Routing Policy
+ *
+ * Manages loading, caching, and resolving routing policies from ~/.relayplane/policy.yaml.
+ * Policies allow per-agent and per-task model overrides.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POLICY_FILE = void 0;
+exports._resetPolicyCache = _resetPolicyCache;
+exports.loadPolicy = loadPolicy;
+exports.resolvePolicy = resolvePolicy;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const js_yaml_1 = require("js-yaml");
+// ─── File Loading ─────────────────────────────────────────────────────────────
+const POLICY_DIR = path.join(os.homedir(), '.relayplane');
+exports.POLICY_FILE = path.join(POLICY_DIR, 'policy.yaml');
+const CACHE_TTL_MS = 5000;
+let _cache = null;
+/** Reset cache — for testing only */
+function _resetPolicyCache() {
+    _cache = null;
+}
+/**
+ * Load routing policy from ~/.relayplane/policy.yaml with 5-second TTL cache.
+ * Returns empty policy { version: 1 } if file is missing or invalid.
+ */
+function loadPolicy() {
+    const now = Date.now();
+    if (_cache && now - _cache.loadedAt < CACHE_TTL_MS) {
+        return _cache.policy;
+    }
+    if (!fs.existsSync(exports.POLICY_FILE)) {
+        _cache = { policy: { version: 1 }, loadedAt: now };
+        return _cache.policy;
+    }
+    try {
+        const raw = fs.readFileSync(exports.POLICY_FILE, 'utf-8');
+        const parsed = (0, js_yaml_1.load)(raw);
+        if (!parsed || typeof parsed !== 'object' || parsed.version !== 1) {
+            if (parsed && typeof parsed === 'object' && parsed.version !== 1) {
+                console.warn(`[RelayPlane] policy.yaml: unsupported version ${parsed.version}, expected 1`);
+            }
+            _cache = { policy: { version: 1 }, loadedAt: now };
+            return _cache.policy;
+        }
+        _cache = { policy: parsed, loadedAt: now };
+        return parsed;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.warn(`[RelayPlane] policy.yaml parse error: ${msg}`);
+        _cache = { policy: { version: 1 }, loadedAt: now };
+        return { version: 1 };
+    }
+}
+// ─── Resolution ───────────────────────────────────────────────────────────────
+/**
+ * Resolve which model to use for a request, given the loaded policy.
+ *
+ * Resolution priority:
+ * 1. agent.tasks[taskType] override (agent_task_override)
+ * 2. policy.tasks[taskType] rule (task_rule)
+ * 3. agent-level rule (agent_rule)
+ * 4. pass-through: use candidateModel (complexity_routing)
+ */
+function resolvePolicy(policy, agentFingerprint, agentName, taskType, complexity, candidateModel) {
+    const emptyPolicy = !policy.agents && !policy.tasks;
+    // Find matching agent entry
+    let matchedAgentName = null;
+    let matchedAgent = null;
+    if (policy.agents) {
+        for (const [name, agent] of Object.entries(policy.agents)) {
+            if (agent.fingerprint && agentFingerprint && agent.fingerprint === agentFingerprint) {
+                matchedAgentName = name;
+                matchedAgent = agent;
+                break;
+            }
+        }
+        // Match by name if fingerprint didn't match
+        if (!matchedAgent && agentName && policy.agents[agentName]) {
+            matchedAgentName = agentName;
+            matchedAgent = policy.agents[agentName];
+        }
+    }
+    // 1. Agent task override
+    if (matchedAgent && matchedAgent.tasks && matchedAgent.tasks[taskType]) {
+        const rule = matchedAgent.tasks[taskType];
+        const model = resolveEscalation(rule, complexity) ?? rule.preferred;
+        return {
+            model,
+            resolvedBy: 'agent_task_override',
+            neverDowngrade: rule.neverDowngrade === true,
+            reason: `Agent "${matchedAgentName}" task override for "${taskType}": ${model}`,
+            candidateModel,
+        };
+    }
+    // 2. Global task rule
+    if (policy.tasks && policy.tasks[taskType]) {
+        const rule = policy.tasks[taskType];
+        const model = resolveEscalation(rule, complexity) ?? rule.preferred;
+        return {
+            model,
+            resolvedBy: 'task_rule',
+            neverDowngrade: rule.neverDowngrade === true,
+            reason: `Task rule for "${taskType}": ${model}`,
+            candidateModel,
+        };
+    }
+    // 3. Agent-level rule
+    if (matchedAgent) {
+        const model = resolveAgentEscalation(matchedAgent, complexity) ?? matchedAgent.preferred;
+        return {
+            model,
+            resolvedBy: 'agent_rule',
+            neverDowngrade: matchedAgent.neverDowngrade === true,
+            reason: `Agent rule for "${matchedAgentName}": ${model}`,
+            candidateModel,
+        };
+    }
+    // 4. Pass-through
+    return {
+        model: candidateModel,
+        resolvedBy: emptyPolicy ? 'default_routing' : 'complexity_routing',
+        neverDowngrade: false,
+        reason: 'No policy rule matched; using complexity routing',
+        candidateModel,
+    };
+}
+function resolveEscalation(rule, complexity) {
+    if (rule.escalateTo &&
+        rule.escalateOn &&
+        rule.escalateOn.includes('complexity_high') &&
+        complexity === 'complex') {
+        return rule.escalateTo;
+    }
+    return null;
+}
+function resolveAgentEscalation(agent, complexity) {
+    if (agent.escalateTo &&
+        agent.escalateOn &&
+        agent.escalateOn.includes('complexity_high') &&
+        complexity === 'complex') {
+        return agent.escalateTo;
+    }
+    return null;
+}
+//# sourceMappingURL=agent-policy.js.map

package/dist/agent-policy.js.map

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