@framers/agentos 0.1.52 → 0.1.53

package/dist/rag/reranking/providers/index.d.ts

@@ -1,6 +1,7 @@
 /**
- * @fileoverview Reranker provider implementations.
- * @module backend/agentos/rag/reranking/providers
+ * Reranker provider implementations.
+ *
+ * @module @framers/agentos/rag/reranking/providers
  */
 export { CohereReranker, type CohereRerankerConfig, COHERE_RERANKER_MODELS, type CohereRerankerModel } from './CohereReranker';
 export { LocalCrossEncoderReranker, type LocalCrossEncoderConfig, LOCAL_RERANKER_MODELS, type LocalRerankerModel } from './LocalCrossEncoderReranker';

package/dist/rag/reranking/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/rag/reranking/providers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC/H,OAAO,EAAE,yBAAyB,EAAE,KAAK,uBAAuB,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/rag/reranking/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC/H,OAAO,EAAE,yBAAyB,EAAE,KAAK,uBAAuB,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/rag/reranking/providers/index.js

@@ -1,6 +1,7 @@
 /**
- * @fileoverview Reranker provider implementations.
- * @module backend/agentos/rag/reranking/providers
+ * Reranker provider implementations.
+ *
+ * @module @framers/agentos/rag/reranking/providers
  */
 export { CohereReranker, COHERE_RERANKER_MODELS } from './CohereReranker.js';
 export { LocalCrossEncoderReranker, LOCAL_RERANKER_MODELS } from './LocalCrossEncoderReranker.js';

package/dist/rag/reranking/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/rag/reranking/providers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAA6B,sBAAsB,EAA4B,MAAM,kBAAkB,CAAC;AAC/H,OAAO,EAAE,yBAAyB,EAAgC,qBAAqB,EAA2B,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/rag/reranking/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAA6B,sBAAsB,EAA4B,MAAM,kBAAkB,CAAC;AAC/H,OAAO,EAAE,yBAAyB,EAAgC,qBAAqB,EAA2B,MAAM,6BAA6B,CAAC"}

package/dist/social-posting/ContentAdaptationEngine.d.ts

@@ -0,0 +1,148 @@
+/**
+ * @fileoverview Content Adaptation Engine — platform-specific content transformation.
+ * @module @framers/agentos/social-posting/ContentAdaptationEngine
+ *
+ * Applies static, deterministic rules to adapt a base content string for
+ * each target social media platform. The engine enforces character limits,
+ * hashtag placement, and generates platform-specific warnings.
+ *
+ * LLM-powered adaptation (tone rewriting, audience targeting, etc.) is
+ * intentionally left to the skill layer. This module provides the
+ * constraint-aware foundation that skills can build upon.
+ *
+ * @example
+ * ```typescript
+ * import { ContentAdaptationEngine } from '../social-posting';
+ *
+ * const engine = new ContentAdaptationEngine();
+ *
+ * const adapted = engine.adaptContent(
+ *   'Announcing our new feature! Check it out at https://example.com',
+ *   ['twitter', 'linkedin', 'instagram'],
+ *   ['announcement', 'product'],
+ * );
+ *
+ * console.log(adapted.twitter.text);     // Truncated to 280 chars if needed
+ * console.log(adapted.instagram.hashtags); // ['#announcement', '#product']
+ * ```
+ */
+/**
+ * Content constraints and capabilities for a social media platform.
+ */
+export interface PlatformConstraints {
+    /** Maximum character length for a post. */
+    maxLength: number;
+    /** How hashtags should be positioned in the content. */
+    hashtagStyle: 'inline' | 'footer' | 'none';
+    /** Maximum number of hashtags allowed. */
+    maxHashtags: number;
+    /** Whether the platform supports image/photo attachments. */
+    supportsMedia: boolean;
+    /** Whether the platform supports video attachments. */
+    supportsVideo: boolean;
+    /** Whether the platform supports multi-image carousel posts. */
+    supportsCarousel: boolean;
+    /** Whether the platform supports poll creation. */
+    supportsPoll: boolean;
+    /** Whether the platform supports threaded/chained posts. */
+    supportsThreading: boolean;
+    /** Brief guidance on the expected tone for this platform. */
+    toneGuidance: string;
+}
+/**
+ * The result of adapting content for a single platform.
+ */
+export interface AdaptedContent {
+    /** Target platform identifier. */
+    platform: string;
+    /** The adapted text content, truncated and formatted for the platform. */
+    text: string;
+    /** Extracted or generated hashtags (with '#' prefix). */
+    hashtags: string[];
+    /** Whether the text was truncated to fit the platform's maxLength. */
+    truncated: boolean;
+    /** Whether the platform supports media attachments. */
+    mediaSupported: boolean;
+    /** Platform-specific warnings (e.g. content too long, unsupported features). */
+    warnings: string[];
+}
+/**
+ * Adapts base content for multiple social media platforms using static rules.
+ *
+ * The engine applies character limits, hashtag formatting, and generates
+ * warnings when content exceeds platform constraints. It does **not** perform
+ * LLM-based rewriting — that responsibility belongs to the skill layer which
+ * can call the engine's constraint methods to inform its prompts.
+ *
+ * @example
+ * ```typescript
+ * const engine = new ContentAdaptationEngine();
+ * const results = engine.adaptContent(
+ *   'We just shipped dark mode! Try it out.',
+ *   ['twitter', 'linkedin'],
+ *   ['darkmode', 'shipping'],
+ * );
+ *
+ * // results.twitter.text  --> 'We just shipped dark mode! Try it out. #darkmode #shipping'
+ * // results.linkedin.text --> 'We just shipped dark mode! Try it out.\n\n#darkmode #shipping'
+ * ```
+ */
+export declare class ContentAdaptationEngine {
+    /**
+     * Adapt base content for one or more target platforms.
+     *
+     * For each platform, the engine:
+     * 1. Formats hashtags according to the platform's hashtagStyle
+     * 2. Truncates content if it exceeds the platform's maxLength
+     * 3. Generates warnings for any constraint violations
+     *
+     * @param baseContent - The original, platform-agnostic content
+     * @param platforms   - Target platform identifiers
+     * @param hashtags    - Optional hashtags (without '#' prefix)
+     * @returns A record mapping each platform to its adapted content
+     */
+    adaptContent(baseContent: string, platforms: string[], hashtags?: string[]): Record<string, AdaptedContent>;
+    /**
+     * Retrieve the constraint definition for a platform.
+     *
+     * Returns a default constraint set for unknown platforms (10000 chars,
+     * no hashtags, basic media support).
+     *
+     * @param platform - Platform identifier
+     * @returns The PlatformConstraints for the given platform
+     */
+    getConstraints(platform: string): PlatformConstraints;
+    /**
+     * Truncate text to a maximum length, appending an ellipsis if truncated.
+     *
+     * Attempts to break at a word boundary to avoid cutting words mid-token.
+     * If no word boundary is found within the last 30 characters, truncates
+     * at the hard limit.
+     *
+     * @param text      - The text to truncate
+     * @param maxLength - Maximum allowed length (including ellipsis)
+     * @returns The truncated text, or the original if within limits
+     */
+    truncateWithEllipsis(text: string, maxLength: number): string;
+    /**
+     * Adapt content for a single platform.
+     */
+    private adaptForPlatform;
+    /**
+     * Normalize hashtags: ensure '#' prefix, deduplicate, and limit count.
+     */
+    private normalizeHashtags;
+    /**
+     * Format content with hashtags according to the platform's style.
+     */
+    private formatWithHashtags;
+    /**
+     * Build a hashtag block string for footer-style placement.
+     */
+    private buildHashtagBlock;
+    /**
+     * Default constraints for unknown platforms.
+     */
+    private getDefaultConstraints;
+}
+//# sourceMappingURL=ContentAdaptationEngine.d.ts.map

package/dist/social-posting/ContentAdaptationEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentAdaptationEngine.d.ts","sourceRoot":"","sources":["../../src/social-posting/ContentAdaptationEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,YAAY,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,aAAa,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,gEAAgE;IAChE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,YAAY,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,iBAAiB,EAAE,OAAO,CAAC;IAC3B,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,cAAc,EAAE,OAAO,CAAC;IACxB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgOD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,uBAAuB;IAKlC;;;;;;;;;;;;OAYG;IACH,YAAY,CACV,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAUjC;;;;;;;;OAQG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IAIrD;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IA4B7D;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoFxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAa9B"}

package/dist/social-posting/ContentAdaptationEngine.js

@@ -0,0 +1,445 @@
+/**
+ * @fileoverview Content Adaptation Engine — platform-specific content transformation.
+ * @module @framers/agentos/social-posting/ContentAdaptationEngine
+ *
+ * Applies static, deterministic rules to adapt a base content string for
+ * each target social media platform. The engine enforces character limits,
+ * hashtag placement, and generates platform-specific warnings.
+ *
+ * LLM-powered adaptation (tone rewriting, audience targeting, etc.) is
+ * intentionally left to the skill layer. This module provides the
+ * constraint-aware foundation that skills can build upon.
+ *
+ * @example
+ * ```typescript
+ * import { ContentAdaptationEngine } from '../social-posting/index.js';
+ *
+ * const engine = new ContentAdaptationEngine();
+ *
+ * const adapted = engine.adaptContent(
+ *   'Announcing our new feature! Check it out at https://example.com',
+ *   ['twitter', 'linkedin', 'instagram'],
+ *   ['announcement', 'product'],
+ * );
+ *
+ * console.log(adapted.twitter.text);     // Truncated to 280 chars if needed
+ * console.log(adapted.instagram.hashtags); // ['#announcement', '#product']
+ * ```
+ */
+// ============================================================================
+// Platform Constraints Registry
+// ============================================================================
+/**
+ * Static constraint definitions for all supported social media platforms.
+ *
+ * Platforms are grouped by category:
+ * - Short-form: twitter, threads, bluesky, mastodon, farcaster
+ * - Visual-first: instagram, tiktok, pinterest, youtube
+ * - Professional/general: linkedin, facebook, reddit, lemmy
+ * - Long-form blogging: devto, hashnode, medium, wordpress
+ */
+const PLATFORM_CONSTRAINTS = {
+    // --------------------------------------------------------------------------
+    // Short-form Micro-blogging
+    // --------------------------------------------------------------------------
+    twitter: {
+        maxLength: 280,
+        hashtagStyle: 'inline',
+        maxHashtags: 5,
+        supportsMedia: true,
+        supportsVideo: true,
+        supportsCarousel: false,
+        supportsPoll: true,
+        supportsThreading: true,
+        toneGuidance: 'Concise, punchy, conversational. Use threads for longer content.',
+    },
+    threads: {
+        maxLength: 500,
+        hashtagStyle: 'inline',
+        maxHashtags: 5,
+        supportsMedia: true,
+        supportsVideo: true,
+        supportsCarousel: true,
+        supportsPoll: false,
+        supportsThreading: true,
+        toneGuidance: 'Conversational, casual, community-oriented.',
+    },
+    bluesky: {
+        maxLength: 300,
+        hashtagStyle: 'none',
+        maxHashtags: 0,
+        supportsMedia: true,
+        supportsVideo: true,
+        supportsCarousel: false,
+        supportsPoll: false,
+        supportsThreading: true,
+        toneGuidance: 'Authentic, concise. Hashtags use facets (rich text), not inline text.',
+    },
+    mastodon: {
+        maxLength: 500,
+        hashtagStyle: 'inline',
+        maxHashtags: 10,
+        supportsMedia: true,
+        supportsVideo: true,
+        supportsCarousel: false,
+        supportsPoll: true,
+        supportsThreading: true,
+        toneGuidance: 'Community-conscious, CW (content warning) support encouraged.',
+    },
+    farcaster: {
+        maxLength: 320,
+        hashtagStyle: 'none',
+        maxHashtags: 0,
+        supportsMedia: true,
+        supportsVideo: false,
+        supportsCarousel: false,
+        supportsPoll: false,
+        supportsThreading: true,
+        toneGuidance: 'Crypto/web3 native, concise, authentic.',
+    },
+    // --------------------------------------------------------------------------
+    // Visual-First Platforms
+    // --------------------------------------------------------------------------
+    instagram: {
+        maxLength: 2200,
+        hashtagStyle: 'footer',
+        maxHashtags: 30,
+        supportsMedia: true,
+        supportsVideo: true,
+        supportsCarousel: true,
+        supportsPoll: false,
+        supportsThreading: false,
+        toneGuidance: 'Visual-first, storytelling, hashtags in footer block.',
+    },
+    tiktok: {
+        maxLength: 2200,
+        hashtagStyle: 'inline',
+        maxHashtags: 10,
+        supportsMedia: false,
+        supportsVideo: true,
+        supportsCarousel: false,
+        supportsPoll: false,
+        supportsThreading: false,
+        toneGuidance: 'Trendy, authentic, short-form video focused.',
+    },
+    pinterest: {
+        maxLength: 500,
+        hashtagStyle: 'none',
+        maxHashtags: 0,
+        supportsMedia: true,
+        supportsVideo: true,
+        supportsCarousel: true,
+        supportsPoll: false,
+        supportsThreading: false,
+        toneGuidance: 'Keyword-rich, descriptive, aspirational. Focus on discoverability.',
+    },
+    youtube: {
+        maxLength: 5000,
+        hashtagStyle: 'inline',
+        maxHashtags: 15,
+        supportsMedia: false,
+        supportsVideo: true,
+        supportsCarousel: false,
+        supportsPoll: true,
+        supportsThreading: false,
+        toneGuidance: 'Descriptive, SEO-aware. This is the video description field.',
+    },
+    // --------------------------------------------------------------------------
+    // Professional & General Social
+    // --------------------------------------------------------------------------
+    linkedin: {
+        maxLength: 3000,
+        hashtagStyle: 'footer',
+        maxHashtags: 5,
+        supportsMedia: true,
+        supportsVideo: true,
+        supportsCarousel: true,
+        supportsPoll: true,
+        supportsThreading: false,
+        toneGuidance: 'Professional, thought-leadership, industry insights.',
+    },
+    facebook: {
+        maxLength: 63206,
+        hashtagStyle: 'inline',
+        maxHashtags: 10,
+        supportsMedia: true,
+        supportsVideo: true,
+        supportsCarousel: true,
+        supportsPoll: true,
+        supportsThreading: false,
+        toneGuidance: 'Casual, community-driven, longer-form acceptable.',
+    },
+    reddit: {
+        maxLength: 40000,
+        hashtagStyle: 'none',
+        maxHashtags: 0,
+        supportsMedia: true,
+        supportsVideo: true,
+        supportsCarousel: false,
+        supportsPoll: true,
+        supportsThreading: false,
+        toneGuidance: 'Community-specific, informative, no hashtags. Markdown supported.',
+    },
+    lemmy: {
+        maxLength: 10000,
+        hashtagStyle: 'none',
+        maxHashtags: 0,
+        supportsMedia: true,
+        supportsVideo: false,
+        supportsCarousel: false,
+        supportsPoll: false,
+        supportsThreading: false,
+        toneGuidance: 'Community-focused, federated. Markdown supported.',
+    },
+    // --------------------------------------------------------------------------
+    // Long-Form Blogging
+    // --------------------------------------------------------------------------
+    devto: {
+        maxLength: 100000,
+        hashtagStyle: 'none',
+        maxHashtags: 0,
+        supportsMedia: true,
+        supportsVideo: false,
+        supportsCarousel: false,
+        supportsPoll: false,
+        supportsThreading: false,
+        toneGuidance: 'Developer-focused, technical, tutorial-style. Markdown/front-matter.',
+    },
+    hashnode: {
+        maxLength: 100000,
+        hashtagStyle: 'none',
+        maxHashtags: 0,
+        supportsMedia: true,
+        supportsVideo: false,
+        supportsCarousel: false,
+        supportsPoll: false,
+        supportsThreading: false,
+        toneGuidance: 'Developer blogging, technical depth, markdown.',
+    },
+    medium: {
+        maxLength: 100000,
+        hashtagStyle: 'none',
+        maxHashtags: 0,
+        supportsMedia: true,
+        supportsVideo: false,
+        supportsCarousel: false,
+        supportsPoll: false,
+        supportsThreading: false,
+        toneGuidance: 'Narrative, polished, long-form essays and thought pieces.',
+    },
+    wordpress: {
+        maxLength: 100000,
+        hashtagStyle: 'none',
+        maxHashtags: 0,
+        supportsMedia: true,
+        supportsVideo: true,
+        supportsCarousel: false,
+        supportsPoll: false,
+        supportsThreading: false,
+        toneGuidance: 'Flexible — depends on blog style. HTML and shortcodes supported.',
+    },
+};
+// ============================================================================
+// ContentAdaptationEngine
+// ============================================================================
+/**
+ * Adapts base content for multiple social media platforms using static rules.
+ *
+ * The engine applies character limits, hashtag formatting, and generates
+ * warnings when content exceeds platform constraints. It does **not** perform
+ * LLM-based rewriting — that responsibility belongs to the skill layer which
+ * can call the engine's constraint methods to inform its prompts.
+ *
+ * @example
+ * ```typescript
+ * const engine = new ContentAdaptationEngine();
+ * const results = engine.adaptContent(
+ *   'We just shipped dark mode! Try it out.',
+ *   ['twitter', 'linkedin'],
+ *   ['darkmode', 'shipping'],
+ * );
+ *
+ * // results.twitter.text  --> 'We just shipped dark mode! Try it out. #darkmode #shipping'
+ * // results.linkedin.text --> 'We just shipped dark mode! Try it out.\n\n#darkmode #shipping'
+ * ```
+ */
+export class ContentAdaptationEngine {
+    // --------------------------------------------------------------------------
+    // Public API
+    // --------------------------------------------------------------------------
+    /**
+     * Adapt base content for one or more target platforms.
+     *
+     * For each platform, the engine:
+     * 1. Formats hashtags according to the platform's hashtagStyle
+     * 2. Truncates content if it exceeds the platform's maxLength
+     * 3. Generates warnings for any constraint violations
+     *
+     * @param baseContent - The original, platform-agnostic content
+     * @param platforms   - Target platform identifiers
+     * @param hashtags    - Optional hashtags (without '#' prefix)
+     * @returns A record mapping each platform to its adapted content
+     */
+    adaptContent(baseContent, platforms, hashtags) {
+        const results = {};
+        for (const platform of platforms) {
+            results[platform] = this.adaptForPlatform(baseContent, platform, hashtags);
+        }
+        return results;
+    }
+    /**
+     * Retrieve the constraint definition for a platform.
+     *
+     * Returns a default constraint set for unknown platforms (10000 chars,
+     * no hashtags, basic media support).
+     *
+     * @param platform - Platform identifier
+     * @returns The PlatformConstraints for the given platform
+     */
+    getConstraints(platform) {
+        return PLATFORM_CONSTRAINTS[platform] ?? this.getDefaultConstraints();
+    }
+    /**
+     * Truncate text to a maximum length, appending an ellipsis if truncated.
+     *
+     * Attempts to break at a word boundary to avoid cutting words mid-token.
+     * If no word boundary is found within the last 30 characters, truncates
+     * at the hard limit.
+     *
+     * @param text      - The text to truncate
+     * @param maxLength - Maximum allowed length (including ellipsis)
+     * @returns The truncated text, or the original if within limits
+     */
+    truncateWithEllipsis(text, maxLength) {
+        if (text.length <= maxLength) {
+            return text;
+        }
+        const ellipsis = '...';
+        const targetLength = maxLength - ellipsis.length;
+        if (targetLength <= 0) {
+            return text.slice(0, maxLength);
+        }
+        // Try to break at a word boundary
+        const truncated = text.slice(0, targetLength);
+        const lastSpace = truncated.lastIndexOf(' ');
+        // Only break at word boundary if it's within 30 chars of the target
+        if (lastSpace > 0 && targetLength - lastSpace < 30) {
+            return truncated.slice(0, lastSpace) + ellipsis;
+        }
+        return truncated + ellipsis;
+    }
+    // --------------------------------------------------------------------------
+    // Internal Helpers
+    // --------------------------------------------------------------------------
+    /**
+     * Adapt content for a single platform.
+     */
+    adaptForPlatform(baseContent, platform, hashtags) {
+        const constraints = this.getConstraints(platform);
+        const warnings = [];
+        // Normalize and limit hashtags
+        const normalizedHashtags = this.normalizeHashtags(hashtags ?? [], constraints.maxHashtags);
+        if (hashtags && hashtags.length > constraints.maxHashtags) {
+            warnings.push(`Hashtag count (${hashtags.length}) exceeds platform maximum (${constraints.maxHashtags}). ` +
+                `Truncated to ${constraints.maxHashtags}.`);
+        }
+        // Build the full text with hashtags placed according to platform style
+        let fullText = this.formatWithHashtags(baseContent, normalizedHashtags, constraints.hashtagStyle);
+        // Check for truncation
+        let truncated = false;
+        if (fullText.length > constraints.maxLength) {
+            // If hashtags are in footer, try truncating just the content
+            if (constraints.hashtagStyle === 'footer' &&
+                normalizedHashtags.length > 0) {
+                const hashtagBlock = this.buildHashtagBlock(normalizedHashtags);
+                const contentBudget = constraints.maxLength - hashtagBlock.length - 2; // 2 for '\n\n'
+                if (contentBudget > 0) {
+                    const truncatedContent = this.truncateWithEllipsis(baseContent, contentBudget);
+                    fullText = truncatedContent + '\n\n' + hashtagBlock;
+                    truncated = true;
+                }
+                else {
+                    fullText = this.truncateWithEllipsis(fullText, constraints.maxLength);
+                    truncated = true;
+                }
+            }
+            else {
+                fullText = this.truncateWithEllipsis(fullText, constraints.maxLength);
+                truncated = true;
+            }
+            warnings.push(`Content truncated from ${baseContent.length} to fit ${platform}'s ` +
+                `${constraints.maxLength} character limit.`);
+        }
+        // Platform-specific warnings
+        if (platform === 'bluesky' && hashtags && hashtags.length > 0) {
+            warnings.push('Bluesky uses facets (rich text) for hashtags, not inline text. ' +
+                'Hashtags have been omitted from the text. Apply them via the AT Protocol facets API.');
+        }
+        if (platform === 'mastodon') {
+            warnings.push('Consider adding a Content Warning (CW) if the content is sensitive.');
+        }
+        return {
+            platform,
+            text: fullText,
+            hashtags: normalizedHashtags,
+            truncated,
+            mediaSupported: constraints.supportsMedia,
+            warnings,
+        };
+    }
+    /**
+     * Normalize hashtags: ensure '#' prefix, deduplicate, and limit count.
+     */
+    normalizeHashtags(hashtags, maxCount) {
+        if (maxCount === 0)
+            return [];
+        const seen = new Set();
+        const normalized = [];
+        for (const tag of hashtags) {
+            const cleaned = tag.startsWith('#') ? tag : `#${tag}`;
+            const lower = cleaned.toLowerCase();
+            if (!seen.has(lower) && normalized.length < maxCount) {
+                seen.add(lower);
+                normalized.push(cleaned);
+            }
+        }
+        return normalized;
+    }
+    /**
+     * Format content with hashtags according to the platform's style.
+     */
+    formatWithHashtags(content, hashtags, style) {
+        if (hashtags.length === 0 || style === 'none') {
+            return content;
+        }
+        if (style === 'footer') {
+            const hashtagBlock = this.buildHashtagBlock(hashtags);
+            return content + '\n\n' + hashtagBlock;
+        }
+        // Inline: append hashtags after the content with a space
+        return content + ' ' + hashtags.join(' ');
+    }
+    /**
+     * Build a hashtag block string for footer-style placement.
+     */
+    buildHashtagBlock(hashtags) {
+        return hashtags.join(' ');
+    }
+    /**
+     * Default constraints for unknown platforms.
+     */
+    getDefaultConstraints() {
+        return {
+            maxLength: 10000,
+            hashtagStyle: 'inline',
+            maxHashtags: 10,
+            supportsMedia: true,
+            supportsVideo: true,
+            supportsCarousel: false,
+            supportsPoll: false,
+            supportsThreading: false,
+            toneGuidance: 'General purpose. Adapt to the specific platform context.',
+        };
+    }
+}
+//# sourceMappingURL=ContentAdaptationEngine.js.map

package/dist/social-posting/ContentAdaptationEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentAdaptationEngine.js","sourceRoot":"","sources":["../../src/social-posting/ContentAdaptationEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAgDH,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,oBAAoB,GAAwC;IAChE,6EAA6E;IAC7E,4BAA4B;IAC5B,6EAA6E;IAC7E,OAAO,EAAE;QACP,SAAS,EAAE,GAAG;QACd,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,IAAI;QAClB,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,kEAAkE;KACjF;IACD,OAAO,EAAE;QACP,SAAS,EAAE,GAAG;QACd,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;QACtB,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,6CAA6C;KAC5D;IACD,OAAO,EAAE;QACP,SAAS,EAAE,GAAG;QACd,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,uEAAuE;KACtF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,GAAG;QACd,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,IAAI;QAClB,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,+DAA+D;KAC9E;IACD,SAAS,EAAE;QACT,SAAS,EAAE,GAAG;QACd,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,KAAK;QACpB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,yCAAyC;KACxD;IAED,6EAA6E;IAC7E,yBAAyB;IACzB,6EAA6E;IAC7E,SAAS,EAAE;QACT,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;QACtB,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,uDAAuD;KACtE;IACD,MAAM,EAAE;QACN,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,KAAK;QACpB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,8CAA8C;KAC7D;IACD,SAAS,EAAE;QACT,SAAS,EAAE,GAAG;QACd,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;QACtB,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,oEAAoE;KACnF;IACD,OAAO,EAAE;QACP,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,KAAK;QACpB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,IAAI;QAClB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,8DAA8D;KAC7E;IAED,6EAA6E;IAC7E,gCAAgC;IAChC,6EAA6E;IAC7E,QAAQ,EAAE;QACR,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;QACtB,YAAY,EAAE,IAAI;QAClB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,sDAAsD;KACrE;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,KAAK;QAChB,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;QACtB,YAAY,EAAE,IAAI;QAClB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,mDAAmD;KAClE;IACD,MAAM,EAAE;QACN,SAAS,EAAE,KAAK;QAChB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,IAAI;QAClB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,mEAAmE;KAClF;IACD,KAAK,EAAE;QACL,SAAS,EAAE,KAAK;QAChB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,KAAK;QACpB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,mDAAmD;KAClE;IAED,6EAA6E;IAC7E,qBAAqB;IACrB,6EAA6E;IAC7E,KAAK,EAAE;QACL,SAAS,EAAE,MAAM;QACjB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,KAAK;QACpB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,sEAAsE;KACrF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM;QACjB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,KAAK;QACpB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,gDAAgD;KAC/D;IACD,MAAM,EAAE;QACN,SAAS,EAAE,MAAM;QACjB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,KAAK;QACpB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,2DAA2D;KAC1E;IACD,SAAS,EAAE;QACT,SAAS,EAAE,MAAM;QACjB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,kEAAkE;KACjF;CACF,CAAC;AAEF,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,uBAAuB;IAClC,6EAA6E;IAC7E,aAAa;IACb,6EAA6E;IAE7E;;;;;;;;;;;;OAYG;IACH,YAAY,CACV,WAAmB,EACnB,SAAmB,EACnB,QAAmB;QAEnB,MAAM,OAAO,GAAmC,EAAE,CAAC;QAEnD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC7E,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;;OAQG;IACH,cAAc,CAAC,QAAgB;QAC7B,OAAO,oBAAoB,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;IACxE,CAAC;IAED;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,IAAY,EAAE,SAAiB;QAClD,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC;QACvB,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC;QAEjD,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAClC,CAAC;QAED,kCAAkC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAE7C,oEAAoE;QACpE,IAAI,SAAS,GAAG,CAAC,IAAI,YAAY,GAAG,SAAS,GAAG,EAAE,EAAE,CAAC;YACnD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC;QAClD,CAAC;QAED,OAAO,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED,6EAA6E;IAC7E,mBAAmB;IACnB,6EAA6E;IAE7E;;OAEG;IACK,gBAAgB,CACtB,WAAmB,EACnB,QAAgB,EAChB,QAAmB;QAEnB,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,+BAA+B;QAC/B,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,CAC/C,QAAQ,IAAI,EAAE,EACd,WAAW,CAAC,WAAW,CACxB,CAAC;QAEF,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;YAC1D,QAAQ,CAAC,IAAI,CACX,kBAAkB,QAAQ,CAAC,MAAM,+BAA+B,WAAW,CAAC,WAAW,KAAK;gBAC1F,gBAAgB,WAAW,CAAC,WAAW,GAAG,CAC7C,CAAC;QACJ,CAAC;QAED,uEAAuE;QACvE,IAAI,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CACpC,WAAW,EACX,kBAAkB,EAClB,WAAW,CAAC,YAAY,CACzB,CAAC;QAEF,uBAAuB;QACvB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,QAAQ,CAAC,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;YAC5C,6DAA6D;YAC7D,IACE,WAAW,CAAC,YAAY,KAAK,QAAQ;gBACrC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAC7B,CAAC;gBACD,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;gBAChE,MAAM,aAAa,GAAG,WAAW,CAAC,SAAS,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,eAAe;gBACtF,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;oBACtB,MAAM,gBAAgB,GAAG,IAAI,CAAC,oBAAoB,CAChD,WAAW,EACX,aAAa,CACd,CAAC;oBACF,QAAQ,GAAG,gBAAgB,GAAG,MAAM,GAAG,YAAY,CAAC;oBACpD,SAAS,GAAG,IAAI,CAAC;gBACnB,CAAC;qBAAM,CAAC;oBACN,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;oBACtE,SAAS,GAAG,IAAI,CAAC;gBACnB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;gBACtE,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;YAED,QAAQ,CAAC,IAAI,CACX,0BAA0B,WAAW,CAAC,MAAM,WAAW,QAAQ,KAAK;gBAClE,GAAG,WAAW,CAAC,SAAS,mBAAmB,CAC9C,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,QAAQ,CAAC,IAAI,CACX,iEAAiE;gBAC/D,sFAAsF,CACzF,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CACX,qEAAqE,CACtE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,QAAQ;YACR,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;YAC5B,SAAS;YACT,cAAc,EAAE,WAAW,CAAC,aAAa;YACzC,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,iBAAiB,CACvB,QAAkB,EAClB,QAAgB;QAEhB,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAE9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAEpC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;gBACrD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAChB,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACK,kBAAkB,CACxB,OAAe,EACf,QAAkB,EAClB,KAAmC;QAEnC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACtD,OAAO,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;QACzC,CAAC;QAED,yDAAyD;QACzD,OAAO,OAAO,GAAG,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,QAAkB;QAC1C,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,qBAAqB;QAC3B,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,QAAQ;YACtB,WAAW,EAAE,EAAE;YACf,aAAa,EAAE,IAAI;YACnB,aAAa,EAAE,IAAI;YACnB,gBAAgB,EAAE,KAAK;YACvB,YAAY,EAAE,KAAK;YACnB,iBAAiB,EAAE,KAAK;YACxB,YAAY,EAAE,0DAA0D;SACzE,CAAC;IACJ,CAAC;CACF"}