@framers/agentos 0.1.162 → 0.1.163

package/dist/core/llm/routing/IModelRouter.d.ts

@@ -67,6 +67,17 @@ export interface ModelRouteParams {
     userApiKeys?: Record<string, string>;
     /** Additional custom parameters or context to aid routing decisions. */
     customContext?: Record<string, any>;
+    /**
+     * Content policy tier governing this request. Drives model selection:
+     * safe/standard use default censored models, mature/private-adult route
+     * to uncensored models via PolicyAwareRouter.
+     */
+    policyTier?: 'safe' | 'standard' | 'mature' | 'private-adult';
+    /**
+     * Finer-grained content intent hint. A mature session doing combat narration
+     * vs. romance has different model preferences.
+     */
+    contentIntent?: 'general' | 'romantic' | 'erotic' | 'violent' | 'horror';
 }
 /**
  * The result of a model routing decision.

package/dist/core/llm/routing/IModelRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IModelRouter.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/routing/IModelRouter.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0DAA0D,CAAC;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+GAA+G;IAC/G,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,iBAAiB,CAAC;IACzC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IACnE;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;OAEG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kGAAkG;IAClG,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,QAAQ,EAAE,SAAS,CAAC;IACpB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,SAAS,EAAE,SAAS,CAAC;IACrB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,4GAA4G;IAC5G,iBAAiB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACvD,8GAA8G;IAC9G,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;;;;;;;;OAWG;IACH,UAAU,CACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,eAAe,EAAE,GAAG,EAAE,mCAAmC;IACzD,YAAY,CAAC,EAAE,GAAG,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,WAAW,CACT,MAAM,EAAE,gBAAgB,EACxB,eAAe,CAAC,EAAE,SAAS,EAAE,GAC5B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACrC"}
+{"version":3,"file":"IModelRouter.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/routing/IModelRouter.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0DAA0D,CAAC;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+GAA+G;IAC/G,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,iBAAiB,CAAC;IACzC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IACnE;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;OAEG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kGAAkG;IAClG,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEpC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,eAAe,CAAC;IAE9D;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC1E;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,QAAQ,EAAE,SAAS,CAAC;IACpB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,SAAS,EAAE,SAAS,CAAC;IACrB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,4GAA4G;IAC5G,iBAAiB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACvD,8GAA8G;IAC9G,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;;;;;;;;OAWG;IACH,UAAU,CACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,eAAe,EAAE,GAAG,EAAE,mCAAmC;IACzD,YAAY,CAAC,EAAE,GAAG,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,WAAW,CACT,MAAM,EAAE,gBAAgB,EACxB,eAAe,CAAC,EAAE,SAAS,EAAE,GAC5B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACrC"}

package/dist/core/llm/routing/PolicyAwareRouter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Policy-aware model router that selects uncensored LLMs for
+ * mature/private-adult content policy tiers.
+ *
+ * For safe/standard tiers (or when no policy tier is specified), the router
+ * delegates to an optional base router or returns null, letting the caller
+ * fall back to its own default model. For mature/private-adult tiers, it
+ * consults the {@link UncensoredModelCatalog} and returns an OpenRouter model
+ * wrapped in a minimal {@link ModelRouteResult}.
+ *
+ * @module core/llm/routing/PolicyAwareRouter
+ */
+import type { IModelRouter, ModelRouteParams, ModelRouteResult } from './IModelRouter';
+import type { ModelInfo } from '../providers/IProvider';
+import type { UncensoredModelCatalog, PolicyTier } from './UncensoredModelCatalog';
+/**
+ * Manual override map: policyTier -> fixed modelId.
+ * When provided, bypasses catalog lookup for the specified tier.
+ */
+export type PolicyOverrides = Partial<Record<PolicyTier, string>>;
+/**
+ * Policy-aware router that wraps an optional base router and injects
+ * uncensored model selection for mature/private-adult policy tiers.
+ */
+export declare class PolicyAwareRouter implements IModelRouter {
+    readonly routerId = "policy_aware_router_v1";
+    private readonly catalog;
+    private readonly baseRouter;
+    private readonly overrides;
+    private readonly defaultPolicyTier;
+    /**
+     * @param catalog - Uncensored model catalog for mature/private-adult lookup.
+     * @param baseRouter - Optional delegate for safe/standard tiers.
+     * @param overrides - Per-tier model ID overrides that bypass catalog lookup.
+     * @param defaultPolicyTier - Fallback tier when params.policyTier is absent.
+     */
+    constructor(catalog: UncensoredModelCatalog, baseRouter?: IModelRouter | null, overrides?: PolicyOverrides, defaultPolicyTier?: PolicyTier);
+    /**
+     * No-op initialization. The PolicyAwareRouter is stateless beyond its
+     * constructor arguments; it does not require async setup.
+     */
+    initialize(_config: Record<string, any>, _providerManager: any, _promptEngine?: any): Promise<void>;
+    /**
+     * Select a model based on the request's policy tier.
+     *
+     * - safe / standard / absent (no default): delegate to baseRouter or return null.
+     * - mature / private-adult: check overrides, then catalog, return OpenRouter result.
+     */
+    selectModel(params: ModelRouteParams, availableModels?: ModelInfo[]): Promise<ModelRouteResult | null>;
+    /**
+     * Build a minimal {@link ModelRouteResult} with a stub provider.
+     * The provider stub satisfies the interface contract while signalling to
+     * upstream consumers that the actual provider instance must be resolved
+     * from the provider manager using the returned providerId.
+     */
+    private buildResult;
+}
+//# sourceMappingURL=PolicyAwareRouter.d.ts.map

package/dist/core/llm/routing/PolicyAwareRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolicyAwareRouter.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/routing/PolicyAwareRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EACV,sBAAsB,EACtB,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAElE;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,SAAgB,QAAQ,4BAA4B;IAEpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAE3D;;;;;OAKG;gBAED,OAAO,EAAE,sBAAsB,EAC/B,UAAU,CAAC,EAAE,YAAY,GAAG,IAAI,EAChC,SAAS,CAAC,EAAE,eAAe,EAC3B,iBAAiB,CAAC,EAAE,UAAU;IAQhC;;;OAGG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,gBAAgB,EAAE,GAAG,EACrB,aAAa,CAAC,EAAE,GAAG,GAClB,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;OAKG;IACG,WAAW,CACf,MAAM,EAAE,gBAAgB,EACxB,eAAe,CAAC,EAAE,SAAS,EAAE,GAC5B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA+BnC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAyCpB"}

package/dist/core/llm/routing/PolicyAwareRouter.js

@@ -0,0 +1,109 @@
+/**
+ * @fileoverview Policy-aware model router that selects uncensored LLMs for
+ * mature/private-adult content policy tiers.
+ *
+ * For safe/standard tiers (or when no policy tier is specified), the router
+ * delegates to an optional base router or returns null, letting the caller
+ * fall back to its own default model. For mature/private-adult tiers, it
+ * consults the {@link UncensoredModelCatalog} and returns an OpenRouter model
+ * wrapped in a minimal {@link ModelRouteResult}.
+ *
+ * @module core/llm/routing/PolicyAwareRouter
+ */
+/**
+ * Policy-aware router that wraps an optional base router and injects
+ * uncensored model selection for mature/private-adult policy tiers.
+ */
+export class PolicyAwareRouter {
+    /**
+     * @param catalog - Uncensored model catalog for mature/private-adult lookup.
+     * @param baseRouter - Optional delegate for safe/standard tiers.
+     * @param overrides - Per-tier model ID overrides that bypass catalog lookup.
+     * @param defaultPolicyTier - Fallback tier when params.policyTier is absent.
+     */
+    constructor(catalog, baseRouter, overrides, defaultPolicyTier) {
+        this.routerId = 'policy_aware_router_v1';
+        this.catalog = catalog;
+        this.baseRouter = baseRouter ?? null;
+        this.overrides = overrides ?? {};
+        this.defaultPolicyTier = defaultPolicyTier;
+    }
+    /**
+     * No-op initialization. The PolicyAwareRouter is stateless beyond its
+     * constructor arguments; it does not require async setup.
+     */
+    async initialize(_config, _providerManager, _promptEngine) {
+        // Intentionally empty: catalog is injected, no async work needed.
+    }
+    /**
+     * Select a model based on the request's policy tier.
+     *
+     * - safe / standard / absent (no default): delegate to baseRouter or return null.
+     * - mature / private-adult: check overrides, then catalog, return OpenRouter result.
+     */
+    async selectModel(params, availableModels) {
+        const tier = params.policyTier ?? this.defaultPolicyTier;
+        // Safe / standard / absent tier: delegate or return null
+        if (!tier || tier === 'safe' || tier === 'standard') {
+            if (this.baseRouter) {
+                return this.baseRouter.selectModel(params, availableModels);
+            }
+            return null;
+        }
+        // Check per-tier override first
+        const overrideModelId = this.overrides[tier];
+        if (overrideModelId) {
+            return this.buildResult(overrideModelId, 'openrouter', `Override for ${tier} tier`);
+        }
+        // Consult catalog
+        const entry = this.catalog.getPreferredTextModel(tier, params.contentIntent);
+        if (entry) {
+            return this.buildResult(entry.modelId, entry.providerId, `Catalog selection for ${tier} tier (${entry.displayName})`);
+        }
+        return null;
+    }
+    /**
+     * Build a minimal {@link ModelRouteResult} with a stub provider.
+     * The provider stub satisfies the interface contract while signalling to
+     * upstream consumers that the actual provider instance must be resolved
+     * from the provider manager using the returned providerId.
+     */
+    buildResult(modelId, providerId, reasoning) {
+        return {
+            provider: {
+                providerId,
+                isInitialized: false,
+                async initialize() { },
+                async generateCompletion() {
+                    throw new Error('Stub provider — resolve via AIModelProviderManager');
+                },
+                async *generateCompletionStream() {
+                    throw new Error('Stub provider — resolve via AIModelProviderManager');
+                },
+                async generateEmbeddings() {
+                    throw new Error('Stub provider — resolve via AIModelProviderManager');
+                },
+                async listAvailableModels() {
+                    return [];
+                },
+                async getModelInfo() {
+                    return undefined;
+                },
+                async checkHealth() {
+                    return { isHealthy: false };
+                },
+                async shutdown() { },
+            },
+            modelId,
+            modelInfo: {
+                modelId,
+                providerId,
+                capabilities: ['chat'],
+            },
+            reasoning,
+            confidence: 0.85,
+            metadata: { source: this.routerId, policyRouted: true },
+        };
+    }
+}
+//# sourceMappingURL=PolicyAwareRouter.js.map

package/dist/core/llm/routing/PolicyAwareRouter.js.map

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

package/dist/core/llm/routing/UncensoredModelCatalog.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Uncensored model catalog for policy-aware routing.
+ *
+ * Maps content policy tiers to curated lists of uncensored text and image
+ * models available through OpenRouter (text) and Replicate (image). The
+ * catalog is the single source of truth consumed by {@link PolicyAwareRouter}
+ * and {@link PolicyAwareImageRouter} to select models that honour the
+ * agent's content policy without imposing upstream safety filters.
+ *
+ * @module core/llm/routing/UncensoredModelCatalog
+ */
+/** Content policy tier governing model selection. */
+export type PolicyTier = 'safe' | 'standard' | 'mature' | 'private-adult';
+/** Finer-grained content intent hint within a policy tier. */
+export type ContentIntent = 'general' | 'romantic' | 'erotic' | 'violent' | 'horror';
+/** A single model entry in the uncensored catalog. */
+export interface CatalogEntry {
+    /** OpenRouter / Replicate model identifier. */
+    modelId: string;
+    /** Human-readable display name. */
+    displayName: string;
+    /** Provider that hosts this model (e.g. 'openrouter', 'replicate'). */
+    providerId: string;
+    /** Modality: 'text' for LLMs, 'image' for diffusion/GAN. */
+    modality: 'text' | 'image';
+    /** Quality tier used for preference ordering. */
+    quality: 'high' | 'medium' | 'low';
+    /** Content permission tags describing what the model allows. */
+    contentPermissions: ContentIntent[];
+    /** Provider-specific capability tags (e.g. 'face-consistency', 'video'). */
+    capabilities: string[];
+}
+/** Read-only catalog of uncensored models. */
+export interface UncensoredModelCatalog {
+    /**
+     * Return all text model entries, optionally filtered.
+     * @param filter - Optional quality or content permission filter.
+     */
+    getTextModels(filter?: {
+        quality?: CatalogEntry['quality'];
+        contentPermissions?: ContentIntent[];
+    }): CatalogEntry[];
+    /**
+     * Return all image model entries, optionally filtered.
+     * @param filter - Optional capability filter.
+     */
+    getImageModels(filter?: {
+        capabilities?: string[];
+    }): CatalogEntry[];
+    /**
+     * Return the preferred text model for a given policy tier.
+     * Returns null for safe/standard tiers (use default censored model).
+     * @param tier - Content policy tier.
+     * @param contentIntent - Optional content intent for finer selection.
+     */
+    getPreferredTextModel(tier: PolicyTier, contentIntent?: ContentIntent): CatalogEntry | null;
+    /**
+     * Return the preferred image model for a given policy tier.
+     * Returns null for safe/standard tiers.
+     * @param tier - Content policy tier.
+     * @param capabilities - Optional required capabilities.
+     */
+    getPreferredImageModel(tier: PolicyTier, capabilities?: string[]): CatalogEntry | null;
+}
+/**
+ * Create a default {@link UncensoredModelCatalog} populated with curated
+ * OpenRouter text models and Replicate image models.
+ */
+export declare function createUncensoredModelCatalog(): UncensoredModelCatalog;
+//# sourceMappingURL=UncensoredModelCatalog.d.ts.map

package/dist/core/llm/routing/UncensoredModelCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UncensoredModelCatalog.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/routing/UncensoredModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,eAAe,CAAC;AAE1E,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAMrF,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,iDAAiD;IACjD,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnC,gEAAgE;IAChE,kBAAkB,EAAE,aAAa,EAAE,CAAC;IACpC,4EAA4E;IAC5E,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,aAAa,CAAC,MAAM,CAAC,EAAE;QACrB,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QAClC,kBAAkB,CAAC,EAAE,aAAa,EAAE,CAAC;KACtC,GAAG,YAAY,EAAE,CAAC;IAEnB;;;OAGG;IACH,cAAc,CAAC,MAAM,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,YAAY,EAAE,CAAC;IAErE;;;;;OAKG;IACH,qBAAqB,CACnB,IAAI,EAAE,UAAU,EAChB,aAAa,CAAC,EAAE,aAAa,GAC5B,YAAY,GAAG,IAAI,CAAC;IAEvB;;;;;OAKG;IACH,sBAAsB,CACpB,IAAI,EAAE,UAAU,EAChB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,YAAY,GAAG,IAAI,CAAC;CACxB;AAqHD;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,sBAAsB,CAgFrE"}

package/dist/core/llm/routing/UncensoredModelCatalog.js

@@ -0,0 +1,183 @@
+/**
+ * @fileoverview Uncensored model catalog for policy-aware routing.
+ *
+ * Maps content policy tiers to curated lists of uncensored text and image
+ * models available through OpenRouter (text) and Replicate (image). The
+ * catalog is the single source of truth consumed by {@link PolicyAwareRouter}
+ * and {@link PolicyAwareImageRouter} to select models that honour the
+ * agent's content policy without imposing upstream safety filters.
+ *
+ * @module core/llm/routing/UncensoredModelCatalog
+ */
+// ---------------------------------------------------------------------------
+// Built-in catalog data
+// ---------------------------------------------------------------------------
+/** Curated text models available via OpenRouter. */
+const TEXT_MODELS = [
+    {
+        modelId: 'nousresearch/hermes-3-llama-3.1-405b',
+        displayName: 'Hermes 3 405B',
+        providerId: 'openrouter',
+        modality: 'text',
+        quality: 'high',
+        contentPermissions: ['general', 'romantic', 'erotic', 'violent', 'horror'],
+        capabilities: ['chat', 'tool_use', 'json_mode'],
+    },
+    {
+        modelId: 'cognitivecomputations/dolphin-mixtral-8x22b',
+        displayName: 'Dolphin Mixtral 8x22B',
+        providerId: 'openrouter',
+        modality: 'text',
+        quality: 'high',
+        contentPermissions: ['general', 'romantic', 'erotic', 'violent', 'horror'],
+        capabilities: ['chat', 'tool_use'],
+    },
+    {
+        modelId: 'nousresearch/hermes-3-llama-3.1-70b',
+        displayName: 'Hermes 3 70B',
+        providerId: 'openrouter',
+        modality: 'text',
+        quality: 'medium',
+        contentPermissions: ['general', 'romantic', 'erotic', 'violent', 'horror'],
+        capabilities: ['chat', 'tool_use', 'json_mode'],
+    },
+    {
+        modelId: 'undi95/toppy-m-7b',
+        displayName: 'Toppy M 7B',
+        providerId: 'openrouter',
+        modality: 'text',
+        quality: 'low',
+        contentPermissions: ['general', 'romantic', 'erotic'],
+        capabilities: ['chat'],
+    },
+    {
+        modelId: 'gryphe/mythomax-l2-13b',
+        displayName: 'MythoMax L2 13B',
+        providerId: 'openrouter',
+        modality: 'text',
+        quality: 'low',
+        contentPermissions: ['general', 'romantic', 'violent', 'horror'],
+        capabilities: ['chat'],
+    },
+];
+/** Curated image models available via Replicate. */
+const IMAGE_MODELS = [
+    {
+        modelId: 'lucataco/realvisxl-v4.0',
+        displayName: 'RealVisXL v4.0',
+        providerId: 'replicate',
+        modality: 'image',
+        quality: 'high',
+        contentPermissions: ['general', 'romantic', 'erotic'],
+        capabilities: ['txt2img', 'img2img', 'photorealistic'],
+    },
+    {
+        modelId: 'stability-ai/sdxl',
+        displayName: 'SDXL',
+        providerId: 'replicate',
+        modality: 'image',
+        quality: 'high',
+        contentPermissions: ['general', 'romantic', 'erotic', 'violent', 'horror'],
+        capabilities: ['txt2img', 'img2img'],
+    },
+    {
+        modelId: 'zsxkib/instant-id',
+        displayName: 'Instant ID',
+        providerId: 'replicate',
+        modality: 'image',
+        quality: 'medium',
+        contentPermissions: ['general', 'romantic'],
+        capabilities: ['txt2img', 'face-consistency'],
+    },
+    {
+        modelId: 'lucataco/ip-adapter-faceid-sdxl',
+        displayName: 'IP-Adapter FaceID SDXL',
+        providerId: 'replicate',
+        modality: 'image',
+        quality: 'medium',
+        contentPermissions: ['general', 'romantic', 'erotic'],
+        capabilities: ['txt2img', 'img2img', 'face-consistency'],
+    },
+    {
+        modelId: 'lucataco/animate-diff',
+        displayName: 'AnimateDiff',
+        providerId: 'replicate',
+        modality: 'image',
+        quality: 'medium',
+        contentPermissions: ['general', 'romantic', 'violent'],
+        capabilities: ['txt2img', 'video'],
+    },
+    {
+        modelId: 'stability-ai/stable-video-diffusion',
+        displayName: 'Stable Video Diffusion',
+        providerId: 'replicate',
+        modality: 'image',
+        quality: 'high',
+        contentPermissions: ['general', 'romantic'],
+        capabilities: ['img2video', 'video'],
+    },
+];
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a default {@link UncensoredModelCatalog} populated with curated
+ * OpenRouter text models and Replicate image models.
+ */
+export function createUncensoredModelCatalog() {
+    return {
+        getTextModels(filter) {
+            let results = [...TEXT_MODELS];
+            if (filter?.quality) {
+                results = results.filter((e) => e.quality === filter.quality);
+            }
+            if (filter?.contentPermissions?.length) {
+                results = results.filter((e) => filter.contentPermissions.every((p) => e.contentPermissions.includes(p)));
+            }
+            return results;
+        },
+        getImageModels(filter) {
+            let results = [...IMAGE_MODELS];
+            if (filter?.capabilities?.length) {
+                results = results.filter((e) => filter.capabilities.every((c) => e.capabilities.includes(c)));
+            }
+            return results;
+        },
+        getPreferredTextModel(tier, contentIntent) {
+            if (tier === 'safe' || tier === 'standard') {
+                return null;
+            }
+            let candidates = [...TEXT_MODELS];
+            // Filter by content intent when provided
+            if (contentIntent) {
+                candidates = candidates.filter((e) => e.contentPermissions.includes(contentIntent));
+            }
+            // Sort: high > medium > low
+            const qualityOrder = {
+                high: 0,
+                medium: 1,
+                low: 2,
+            };
+            candidates.sort((a, b) => qualityOrder[a.quality] - qualityOrder[b.quality]);
+            return candidates[0] ?? null;
+        },
+        getPreferredImageModel(tier, capabilities) {
+            if (tier === 'safe' || tier === 'standard') {
+                return null;
+            }
+            let candidates = [...IMAGE_MODELS];
+            if (capabilities?.length) {
+                candidates = candidates.filter((e) => capabilities.every((c) => e.capabilities.includes(c)));
+            }
+            // Sort: high > medium > low
+            const qualityOrder = {
+                high: 0,
+                medium: 1,
+                low: 2,
+            };
+            candidates.sort((a, b) => qualityOrder[a.quality] - qualityOrder[b.quality]);
+            return candidates[0] ?? null;
+        },
+    };
+}
+//# sourceMappingURL=UncensoredModelCatalog.js.map

package/dist/core/llm/routing/UncensoredModelCatalog.js.map

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

package/dist/media/images/PolicyAwareImageRouter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Policy-aware image provider router for selecting uncensored
+ * image generation backends based on content policy tier.
+ *
+ * Safe/standard tiers return null or the default provider chain, signalling
+ * the caller to use its normal image generation pipeline. Mature/private-adult
+ * tiers route through Replicate and other uncensored providers from the
+ * {@link UncensoredModelCatalog}.
+ *
+ * @module media/images/PolicyAwareImageRouter
+ */
+import type { UncensoredModelCatalog, PolicyTier } from '../../core/llm/routing/UncensoredModelCatalog';
+/** Preference result returned by the image router. */
+export interface ImageProviderPreference {
+    /** Recommended provider ID (e.g. 'replicate'). */
+    providerId: string;
+    /** Recommended model ID on that provider. */
+    modelId: string;
+    /** Human-readable display name of the model. */
+    displayName: string;
+}
+/**
+ * Policy-aware image provider router. Selects the preferred image generation
+ * provider and model based on the session's content policy tier.
+ */
+export declare class PolicyAwareImageRouter {
+    private readonly catalog;
+    /**
+     * @param catalog - Uncensored model catalog for mature/private-adult lookup.
+     */
+    constructor(catalog: UncensoredModelCatalog);
+    /**
+     * Get the preferred image provider and model for a given policy tier.
+     *
+     * @param policyTier - Content policy tier.
+     * @param capabilities - Optional required capabilities (e.g. ['face-consistency']).
+     * @returns Provider preference, or null for safe/standard tiers.
+     */
+    getPreferredProvider(policyTier: PolicyTier, capabilities?: string[]): ImageProviderPreference | null;
+    /**
+     * Get the ordered provider chain for a given policy tier.
+     *
+     * Safe/standard returns the default chain (OpenAI-first).
+     * Mature/private-adult returns the uncensored chain (Replicate-first).
+     *
+     * @param policyTier - Content policy tier.
+     * @returns Ordered array of provider IDs to try in sequence.
+     */
+    getProviderChain(policyTier: PolicyTier): string[];
+}
+//# sourceMappingURL=PolicyAwareImageRouter.d.ts.map

package/dist/media/images/PolicyAwareImageRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolicyAwareImageRouter.d.ts","sourceRoot":"","sources":["../../../src/media/images/PolicyAwareImageRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,UAAU,EACX,MAAM,+CAA+C,CAAC;AAMvD,sDAAsD;AACtD,MAAM,WAAW,uBAAuB;IACtC,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAyBD;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD;;OAEG;gBACS,OAAO,EAAE,sBAAsB;IAI3C;;;;;;OAMG;IACH,oBAAoB,CAClB,UAAU,EAAE,UAAU,EACtB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,uBAAuB,GAAG,IAAI;IAiBjC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE;CAMnD"}

package/dist/media/images/PolicyAwareImageRouter.js

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview Policy-aware image provider router for selecting uncensored
+ * image generation backends based on content policy tier.
+ *
+ * Safe/standard tiers return null or the default provider chain, signalling
+ * the caller to use its normal image generation pipeline. Mature/private-adult
+ * tiers route through Replicate and other uncensored providers from the
+ * {@link UncensoredModelCatalog}.
+ *
+ * @module media/images/PolicyAwareImageRouter
+ */
+// ---------------------------------------------------------------------------
+// Default provider chains
+// ---------------------------------------------------------------------------
+/** Default provider ordering for safe/standard content. */
+const DEFAULT_PROVIDER_CHAIN = [
+    'openai',
+    'stability',
+    'fal',
+    'replicate',
+];
+/** Provider ordering for mature/private-adult content (uncensored first). */
+const UNCENSORED_PROVIDER_CHAIN = [
+    'replicate',
+    'fal',
+    'stable-diffusion-local',
+];
+// ---------------------------------------------------------------------------
+// Router
+// ---------------------------------------------------------------------------
+/**
+ * Policy-aware image provider router. Selects the preferred image generation
+ * provider and model based on the session's content policy tier.
+ */
+export class PolicyAwareImageRouter {
+    /**
+     * @param catalog - Uncensored model catalog for mature/private-adult lookup.
+     */
+    constructor(catalog) {
+        this.catalog = catalog;
+    }
+    /**
+     * Get the preferred image provider and model for a given policy tier.
+     *
+     * @param policyTier - Content policy tier.
+     * @param capabilities - Optional required capabilities (e.g. ['face-consistency']).
+     * @returns Provider preference, or null for safe/standard tiers.
+     */
+    getPreferredProvider(policyTier, capabilities) {
+        if (policyTier === 'safe' || policyTier === 'standard') {
+            return null;
+        }
+        const entry = this.catalog.getPreferredImageModel(policyTier, capabilities);
+        if (!entry) {
+            return null;
+        }
+        return {
+            providerId: entry.providerId,
+            modelId: entry.modelId,
+            displayName: entry.displayName,
+        };
+    }
+    /**
+     * Get the ordered provider chain for a given policy tier.
+     *
+     * Safe/standard returns the default chain (OpenAI-first).
+     * Mature/private-adult returns the uncensored chain (Replicate-first).
+     *
+     * @param policyTier - Content policy tier.
+     * @returns Ordered array of provider IDs to try in sequence.
+     */
+    getProviderChain(policyTier) {
+        if (policyTier === 'safe' || policyTier === 'standard') {
+            return [...DEFAULT_PROVIDER_CHAIN];
+        }
+        return [...UNCENSORED_PROVIDER_CHAIN];
+    }
+}
+//# sourceMappingURL=PolicyAwareImageRouter.js.map

package/dist/media/images/PolicyAwareImageRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolicyAwareImageRouter.js","sourceRoot":"","sources":["../../../src/media/images/PolicyAwareImageRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,2DAA2D;AAC3D,MAAM,sBAAsB,GAAa;IACvC,QAAQ;IACR,WAAW;IACX,KAAK;IACL,WAAW;CACZ,CAAC;AAEF,6EAA6E;AAC7E,MAAM,yBAAyB,GAAa;IAC1C,WAAW;IACX,KAAK;IACL,wBAAwB;CACzB,CAAC;AAEF,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IAGjC;;OAEG;IACH,YAAY,OAA+B;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,oBAAoB,CAClB,UAAsB,EACtB,YAAuB;QAEvB,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,gBAAgB,CAAC,UAAsB;QACrC,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YACvD,OAAO,CAAC,GAAG,sBAAsB,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,CAAC,GAAG,yBAAyB,CAAC,CAAC;IACxC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.162",
+  "version": "0.1.163",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",