@framers/agentos 0.1.126 → 0.1.127

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

@@ -1,252 +0,0 @@
-/**
- * @fileoverview Social Post Manager — post lifecycle engine.
- * @module @framers/agentos/social-posting/SocialPostManager
- *
- * Manages the full lifecycle of social media posts through a state machine:
- *
- *   DRAFT --> SCHEDULED --> PUBLISHING --> PUBLISHED
- *                              |
- *                            ERROR --> RETRY --> PUBLISHING
- *
- * Storage is in-memory (Map<string, SocialPost>). The backend module will
- * layer on DB persistence via IStorageAdapter when this is wired into
- * the NestJS service layer.
- *
- * @example
- * ```typescript
- * import { SocialPostManager } from '../social-posting';
- *
- * const manager = new SocialPostManager();
- *
- * const post = manager.createDraft({
- *   seedId: 'agent-alpha',
- *   content: 'Hello world!',
- *   platforms: ['twitter', 'bluesky'],
- * });
- *
- * manager.schedulePost(post.id, '2026-03-05T12:00:00Z');
- * ```
- */
-/**
- * State machine states for a social post.
- *
- * Valid transitions:
- * - draft      --> scheduled | publishing
- * - scheduled  --> publishing
- * - publishing --> published | error
- * - error      --> retry
- * - retry      --> publishing
- */
-export type SocialPostStatus = 'draft' | 'scheduled' | 'publishing' | 'published' | 'error' | 'retry';
-/**
- * Per-platform publishing result tracked on a SocialPost.
- */
-export interface SocialPostPlatformResult {
-    /** Target platform identifier (e.g. 'twitter', 'bluesky'). */
-    platform: string;
-    /** Platform-assigned post ID after successful publish. */
-    postId?: string;
-    /** Canonical URL of the published post. */
-    url?: string;
-    /** Current status for this platform leg. */
-    status: 'pending' | 'success' | 'error';
-    /** Error message if status is 'error'. */
-    error?: string;
-    /** ISO 8601 timestamp of successful publish. */
-    publishedAt?: string;
-}
-/**
- * A social post managed by the SocialPostManager.
- *
- * `adaptations` maps platform names to platform-specific content variants
- * produced by the ContentAdaptationEngine (or by the LLM skill layer).
- */
-export interface SocialPost {
-    /** Unique post identifier (UUID v4). */
-    id: string;
-    /** The agent seed this post belongs to. */
-    seedId: string;
-    /** The original, platform-agnostic content. */
-    baseContent: string;
-    /** Platform-specific content adaptations (platform --> adapted text). */
-    adaptations: Record<string, string>;
-    /** Target platforms for this post. */
-    platforms: string[];
-    /** Optional media attachment URLs. */
-    mediaUrls?: string[];
-    /** ISO 8601 timestamp when the post should be published. */
-    scheduledAt?: string;
-    /** Current lifecycle status. */
-    status: SocialPostStatus;
-    /** Per-platform publishing results. */
-    results: Record<string, SocialPostPlatformResult>;
-    /** Number of retry attempts so far. */
-    retryCount: number;
-    /** Maximum retry attempts before permanent failure. */
-    maxRetries: number;
-    /** ISO 8601 creation timestamp. */
-    createdAt: string;
-    /** ISO 8601 last-update timestamp. */
-    updatedAt: string;
-}
-/**
- * Input for creating a new draft post.
- */
-export interface CreateDraftInput {
-    /** The agent seed this post belongs to. */
-    seedId: string;
-    /** The base content for the post. */
-    content: string;
-    /** Target platforms (e.g. ['twitter', 'linkedin']). */
-    platforms: string[];
-    /** Optional media attachment URLs. */
-    mediaUrls?: string[];
-    /** Pre-computed platform adaptations (platform --> adapted text). */
-    adaptations?: Record<string, string>;
-    /** ISO 8601 scheduled publish time. If omitted, the post stays as a draft. */
-    schedule?: string;
-}
-/**
- * Manages the lifecycle of social media posts.
- *
- * Provides create, schedule, publish, retry, and query operations over an
- * in-memory store. Platform-specific publishing is delegated to callers
- * (typically the ToolExecutor / skill layer) via the `publishNow`
- * callback mechanism.
- *
- * @example
- * ```typescript
- * const manager = new SocialPostManager();
- * const draft = manager.createDraft({
- *   seedId: 'my-agent',
- *   content: 'Big announcement!',
- *   platforms: ['twitter', 'linkedin'],
- * });
- *
- * // Schedule for later
- * manager.schedulePost(draft.id, '2026-03-10T15:00:00Z');
- *
- * // Or publish immediately
- * await manager.publishNow(draft.id);
- * ```
- */
-export declare class SocialPostManager {
-    /** In-memory post store keyed by post ID. */
-    private readonly posts;
-    /**
-     * Optional publish handler injected by the consuming layer.
-     * Called for each platform when `publishNow` is invoked.
-     *
-     * When not provided, publishNow will mark all platforms as 'pending'
-     * and transition the post to 'publishing', leaving actual delivery
-     * to the caller.
-     */
-    private publishHandler?;
-    /**
-     * Register a platform publish handler.
-     *
-     * The handler receives the full post and a single platform string and must
-     * return a {@link SocialPostPlatformResult}. It is called once per platform
-     * during `publishNow`.
-     *
-     * @param handler - Async function that publishes content to a platform
-     */
-    setPublishHandler(handler: (post: SocialPost, platform: string) => Promise<SocialPostPlatformResult>): void;
-    /**
-     * Create a new draft post.
-     *
-     * If `input.schedule` is provided, the post is automatically transitioned
-     * to 'scheduled' status.
-     *
-     * @param input - Draft creation parameters
-     * @returns The newly created SocialPost in 'draft' (or 'scheduled') status
-     */
-    createDraft(input: CreateDraftInput): SocialPost;
-    /**
-     * Schedule a draft post for future publishing.
-     *
-     * @param postId    - ID of the post to schedule
-     * @param timestamp - ISO 8601 timestamp for desired publish time
-     * @returns The updated SocialPost in 'scheduled' status
-     * @throws {Error} If the post is not found or the transition is invalid
-     */
-    schedulePost(postId: string, timestamp: string): SocialPost;
-    /**
-     * Publish a post immediately.
-     *
-     * Transitions the post to 'publishing' and, if a publish handler is
-     * registered, invokes it for each target platform. After all platform
-     * results are collected, the post is transitioned to either 'published'
-     * (all succeeded) or 'error' (any failure).
-     *
-     * If no publish handler is registered, the post remains in 'publishing'
-     * status with all platform results set to 'pending'.
-     *
-     * @param postId - ID of the post to publish
-     * @returns The updated SocialPost after publish attempts
-     * @throws {Error} If the post is not found or the transition is invalid
-     */
-    publishNow(postId: string): Promise<SocialPost>;
-    /**
-     * Record a platform-specific publish result.
-     *
-     * Used by external publish handlers to report results asynchronously
-     * (e.g. webhook callbacks).
-     *
-     * @param postId   - ID of the post
-     * @param platform - Platform identifier
-     * @param result   - The platform result to record
-     * @returns The updated SocialPost
-     * @throws {Error} If the post is not found
-     */
-    markPlatformResult(postId: string, platform: string, result: SocialPostPlatformResult): SocialPost;
-    /**
-     * Retry a failed post.
-     *
-     * Transitions the post from 'error' to 'retry', increments the retry
-     * counter, and resets failed platform results to 'pending'.
-     *
-     * @param postId - ID of the post to retry
-     * @returns The updated SocialPost in 'retry' status
-     * @throws {Error} If the post is not found, the transition is invalid,
-     *                 or the maximum retry count has been reached
-     */
-    retryFailed(postId: string): SocialPost;
-    /**
-     * Retrieve a post by ID.
-     *
-     * @param postId - ID of the post to retrieve
-     * @returns The SocialPost if found, otherwise undefined
-     */
-    getPost(postId: string): SocialPost | undefined;
-    /**
-     * List posts with optional filtering by seed ID and/or status.
-     *
-     * @param seedId - Optional seed ID filter
-     * @param status - Optional status filter
-     * @returns Array of matching SocialPost objects
-     */
-    listPosts(seedId?: string, status?: SocialPostStatus): SocialPost[];
-    /**
-     * Get all scheduled posts whose scheduledAt timestamp has passed.
-     *
-     * Used by a polling loop or scheduler to find posts that are due for
-     * publishing.
-     *
-     * @returns Array of SocialPost objects that are due for publishing
-     */
-    getDuePosts(): SocialPost[];
-    /**
-     * Retrieve a post or throw if not found.
-     */
-    private requirePost;
-    /**
-     * Assert that a state transition is valid.
-     */
-    private assertTransition;
-    /**
-     * Initialize platform results with 'pending' status for each platform.
-     */
-    private initPlatformResults;
-}
-//# sourceMappingURL=SocialPostManager.d.ts.map

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

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

package/dist/social-posting/SocialPostManager.js

@@ -1,342 +0,0 @@
-/**
- * @fileoverview Social Post Manager — post lifecycle engine.
- * @module @framers/agentos/social-posting/SocialPostManager
- *
- * Manages the full lifecycle of social media posts through a state machine:
- *
- *   DRAFT --> SCHEDULED --> PUBLISHING --> PUBLISHED
- *                              |
- *                            ERROR --> RETRY --> PUBLISHING
- *
- * Storage is in-memory (Map<string, SocialPost>). The backend module will
- * layer on DB persistence via IStorageAdapter when this is wired into
- * the NestJS service layer.
- *
- * @example
- * ```typescript
- * import { SocialPostManager } from '../social-posting/index.js';
- *
- * const manager = new SocialPostManager();
- *
- * const post = manager.createDraft({
- *   seedId: 'agent-alpha',
- *   content: 'Hello world!',
- *   platforms: ['twitter', 'bluesky'],
- * });
- *
- * manager.schedulePost(post.id, '2026-03-05T12:00:00Z');
- * ```
- */
-import { generateUUID } from '../utils/uuid.js';
-// ============================================================================
-// Constants
-// ============================================================================
-/** Default maximum number of retry attempts before a post is permanently failed. */
-const DEFAULT_MAX_RETRIES = 3;
-// ============================================================================
-// Valid State Transitions
-// ============================================================================
-/**
- * Allowed state transitions for the post lifecycle state machine.
- * Each key maps to the set of states it may transition to.
- */
-const VALID_TRANSITIONS = {
-    draft: ['scheduled', 'publishing'],
-    scheduled: ['publishing'],
-    publishing: ['published', 'error'],
-    published: [],
-    error: ['retry'],
-    retry: ['publishing'],
-};
-// ============================================================================
-// SocialPostManager
-// ============================================================================
-/**
- * Manages the lifecycle of social media posts.
- *
- * Provides create, schedule, publish, retry, and query operations over an
- * in-memory store. Platform-specific publishing is delegated to callers
- * (typically the ToolExecutor / skill layer) via the `publishNow`
- * callback mechanism.
- *
- * @example
- * ```typescript
- * const manager = new SocialPostManager();
- * const draft = manager.createDraft({
- *   seedId: 'my-agent',
- *   content: 'Big announcement!',
- *   platforms: ['twitter', 'linkedin'],
- * });
- *
- * // Schedule for later
- * manager.schedulePost(draft.id, '2026-03-10T15:00:00Z');
- *
- * // Or publish immediately
- * await manager.publishNow(draft.id);
- * ```
- */
-export class SocialPostManager {
-    constructor() {
-        /** In-memory post store keyed by post ID. */
-        this.posts = new Map();
-    }
-    // --------------------------------------------------------------------------
-    // Configuration
-    // --------------------------------------------------------------------------
-    /**
-     * Register a platform publish handler.
-     *
-     * The handler receives the full post and a single platform string and must
-     * return a {@link SocialPostPlatformResult}. It is called once per platform
-     * during `publishNow`.
-     *
-     * @param handler - Async function that publishes content to a platform
-     */
-    setPublishHandler(handler) {
-        this.publishHandler = handler;
-    }
-    // --------------------------------------------------------------------------
-    // Lifecycle Operations
-    // --------------------------------------------------------------------------
-    /**
-     * Create a new draft post.
-     *
-     * If `input.schedule` is provided, the post is automatically transitioned
-     * to 'scheduled' status.
-     *
-     * @param input - Draft creation parameters
-     * @returns The newly created SocialPost in 'draft' (or 'scheduled') status
-     */
-    createDraft(input) {
-        const now = new Date().toISOString();
-        const post = {
-            id: generateUUID(),
-            seedId: input.seedId,
-            baseContent: input.content,
-            adaptations: input.adaptations ?? {},
-            platforms: [...input.platforms],
-            mediaUrls: input.mediaUrls ? [...input.mediaUrls] : undefined,
-            scheduledAt: input.schedule,
-            status: input.schedule ? 'scheduled' : 'draft',
-            results: this.initPlatformResults(input.platforms),
-            retryCount: 0,
-            maxRetries: DEFAULT_MAX_RETRIES,
-            createdAt: now,
-            updatedAt: now,
-        };
-        this.posts.set(post.id, post);
-        return { ...post };
-    }
-    /**
-     * Schedule a draft post for future publishing.
-     *
-     * @param postId    - ID of the post to schedule
-     * @param timestamp - ISO 8601 timestamp for desired publish time
-     * @returns The updated SocialPost in 'scheduled' status
-     * @throws {Error} If the post is not found or the transition is invalid
-     */
-    schedulePost(postId, timestamp) {
-        const post = this.requirePost(postId);
-        this.assertTransition(post.status, 'scheduled');
-        post.scheduledAt = timestamp;
-        post.status = 'scheduled';
-        post.updatedAt = new Date().toISOString();
-        return { ...post };
-    }
-    /**
-     * Publish a post immediately.
-     *
-     * Transitions the post to 'publishing' and, if a publish handler is
-     * registered, invokes it for each target platform. After all platform
-     * results are collected, the post is transitioned to either 'published'
-     * (all succeeded) or 'error' (any failure).
-     *
-     * If no publish handler is registered, the post remains in 'publishing'
-     * status with all platform results set to 'pending'.
-     *
-     * @param postId - ID of the post to publish
-     * @returns The updated SocialPost after publish attempts
-     * @throws {Error} If the post is not found or the transition is invalid
-     */
-    async publishNow(postId) {
-        const post = this.requirePost(postId);
-        this.assertTransition(post.status, 'publishing');
-        post.status = 'publishing';
-        post.updatedAt = new Date().toISOString();
-        if (!this.publishHandler) {
-            return { ...post };
-        }
-        // Publish to each platform concurrently
-        const platformResults = await Promise.allSettled(post.platforms.map(async (platform) => {
-            try {
-                const result = await this.publishHandler(post, platform);
-                post.results[platform] = result;
-                return result;
-            }
-            catch (err) {
-                const errorResult = {
-                    platform,
-                    status: 'error',
-                    error: err instanceof Error ? err.message : String(err),
-                };
-                post.results[platform] = errorResult;
-                return errorResult;
-            }
-        }));
-        // Determine aggregate status
-        const allResults = Object.values(post.results);
-        const hasError = allResults.some((r) => r.status === 'error');
-        const allSuccess = allResults.every((r) => r.status === 'success');
-        if (allSuccess) {
-            post.status = 'published';
-        }
-        else if (hasError) {
-            post.status = 'error';
-        }
-        post.updatedAt = new Date().toISOString();
-        return { ...post };
-    }
-    /**
-     * Record a platform-specific publish result.
-     *
-     * Used by external publish handlers to report results asynchronously
-     * (e.g. webhook callbacks).
-     *
-     * @param postId   - ID of the post
-     * @param platform - Platform identifier
-     * @param result   - The platform result to record
-     * @returns The updated SocialPost
-     * @throws {Error} If the post is not found
-     */
-    markPlatformResult(postId, platform, result) {
-        const post = this.requirePost(postId);
-        post.results[platform] = result;
-        // Auto-transition based on aggregate results
-        const allResults = Object.values(post.results);
-        const allSuccess = allResults.every((r) => r.status === 'success');
-        const hasError = allResults.some((r) => r.status === 'error');
-        const hasPending = allResults.some((r) => r.status === 'pending');
-        if (allSuccess && !hasPending) {
-            post.status = 'published';
-        }
-        else if (hasError && !hasPending) {
-            post.status = 'error';
-        }
-        post.updatedAt = new Date().toISOString();
-        return { ...post };
-    }
-    /**
-     * Retry a failed post.
-     *
-     * Transitions the post from 'error' to 'retry', increments the retry
-     * counter, and resets failed platform results to 'pending'.
-     *
-     * @param postId - ID of the post to retry
-     * @returns The updated SocialPost in 'retry' status
-     * @throws {Error} If the post is not found, the transition is invalid,
-     *                 or the maximum retry count has been reached
-     */
-    retryFailed(postId) {
-        const post = this.requirePost(postId);
-        this.assertTransition(post.status, 'retry');
-        if (post.retryCount >= post.maxRetries) {
-            throw new Error(`Post ${postId} has exceeded maximum retries (${post.maxRetries})`);
-        }
-        post.status = 'retry';
-        post.retryCount += 1;
-        post.updatedAt = new Date().toISOString();
-        // Reset failed platform results to pending for re-attempt
-        for (const platform of post.platforms) {
-            if (post.results[platform]?.status === 'error') {
-                post.results[platform] = {
-                    platform,
-                    status: 'pending',
-                };
-            }
-        }
-        return { ...post };
-    }
-    // --------------------------------------------------------------------------
-    // Query Operations
-    // --------------------------------------------------------------------------
-    /**
-     * Retrieve a post by ID.
-     *
-     * @param postId - ID of the post to retrieve
-     * @returns The SocialPost if found, otherwise undefined
-     */
-    getPost(postId) {
-        const post = this.posts.get(postId);
-        return post ? { ...post } : undefined;
-    }
-    /**
-     * List posts with optional filtering by seed ID and/or status.
-     *
-     * @param seedId - Optional seed ID filter
-     * @param status - Optional status filter
-     * @returns Array of matching SocialPost objects
-     */
-    listPosts(seedId, status) {
-        const results = [];
-        for (const post of this.posts.values()) {
-            if (seedId && post.seedId !== seedId)
-                continue;
-            if (status && post.status !== status)
-                continue;
-            results.push({ ...post });
-        }
-        return results;
-    }
-    /**
-     * Get all scheduled posts whose scheduledAt timestamp has passed.
-     *
-     * Used by a polling loop or scheduler to find posts that are due for
-     * publishing.
-     *
-     * @returns Array of SocialPost objects that are due for publishing
-     */
-    getDuePosts() {
-        const now = new Date();
-        const results = [];
-        for (const post of this.posts.values()) {
-            if (post.status === 'scheduled' && post.scheduledAt && new Date(post.scheduledAt) <= now) {
-                results.push({ ...post });
-            }
-        }
-        return results;
-    }
-    // --------------------------------------------------------------------------
-    // Internal Helpers
-    // --------------------------------------------------------------------------
-    /**
-     * Retrieve a post or throw if not found.
-     */
-    requirePost(postId) {
-        const post = this.posts.get(postId);
-        if (!post) {
-            throw new Error(`Social post not found: ${postId}`);
-        }
-        return post;
-    }
-    /**
-     * Assert that a state transition is valid.
-     */
-    assertTransition(current, target) {
-        const allowed = VALID_TRANSITIONS[current];
-        if (!allowed || !allowed.includes(target)) {
-            throw new Error(`Invalid state transition: '${current}' --> '${target}'. ` +
-                `Allowed transitions from '${current}': [${(allowed ?? []).join(', ')}]`);
-        }
-    }
-    /**
-     * Initialize platform results with 'pending' status for each platform.
-     */
-    initPlatformResults(platforms) {
-        const results = {};
-        for (const platform of platforms) {
-            results[platform] = { platform, status: 'pending' };
-        }
-        return results;
-    }
-}
-//# sourceMappingURL=SocialPostManager.js.map

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/social-posting/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/social-posting/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+BAA+B;AAC/B,OAAO,EACL,iBAAiB,GAKlB,MAAM,qBAAqB,CAAC;AAE7B,uCAAuC;AACvC,OAAO,EACL,uBAAuB,GAGxB,MAAM,2BAA2B,CAAC;AAEnC,6DAA6D;AAC7D,OAAO,EACL,qBAAqB,GAGtB,MAAM,yBAAyB,CAAC"}