@framers/agentos 0.1.52 → 0.1.53

package/dist/social-posting/SocialPostManager.js

@@ -0,0 +1,344 @@
+/**
+ * @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 {@link 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 {@link 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,12 @@
+/**
+ * Social Posting module barrel exports.
+ *
+ * @module @framers/agentos/social-posting
+ *
+ * Provides the post lifecycle engine ({@link SocialPostManager}) and
+ * platform-aware content adaptation ({@link ContentAdaptationEngine}).
+ */
+export { SocialPostManager, type SocialPost, type SocialPostStatus, type SocialPostPlatformResult, type CreateDraftInput, } from './SocialPostManager';
+export { ContentAdaptationEngine, type PlatformConstraints, type AdaptedContent, } from './ContentAdaptationEngine';
+export { SocialAbstractService, type SocialRequestOptions, type SocialServiceConfig, } from './SocialAbstractService';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,15 @@
+/**
+ * Social Posting module barrel exports.
+ *
+ * @module @framers/agentos/social-posting
+ *
+ * Provides the post lifecycle engine ({@link SocialPostManager}) and
+ * platform-aware content adaptation ({@link ContentAdaptationEngine}).
+ */
+// Post lifecycle state machine
+export { SocialPostManager, } from './SocialPostManager.js';
+// Platform-specific content adaptation
+export { ContentAdaptationEngine, } from './ContentAdaptationEngine.js';
+// Shared HTTP base class for channel service implementations
+export { SocialAbstractService, } from './SocialAbstractService.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"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"}

package/dist/voice/index.d.ts

@@ -1,5 +1,6 @@
 /**
- * @fileoverview Barrel exports for the AgentOS Voice Call System.
+ * Barrel exports for the AgentOS voice call system.
+ *
  * @module @framers/agentos/voice
  */
 export * from './types.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,YAAY,GACb,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,YAAY,GACb,MAAM,sBAAsB,CAAC"}

package/dist/voice/index.js

@@ -1,5 +1,6 @@
 /**
- * @fileoverview Barrel exports for the AgentOS Voice Call System.
+ * Barrel exports for the AgentOS voice call system.
+ *
  * @module @framers/agentos/voice
  */
 export * from './types.js';

package/dist/voice/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAU3B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,YAAY,GACb,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAU3B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,YAAY,GACb,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.52",
+  "version": "0.1.53",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",
@@ -154,8 +154,11 @@
     "test": "vitest run",
     "dev:test": "vitest",
     "docs:clean": "rimraf docs/api ../../docs-generated/library ../../docs-generated/api",
-    "docs": "npm run docs:clean && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json && pnpm --dir ../../ exec typedoc --options typedoc.json && pnpm --dir ../../ exec node scripts/generate-api-docs.js && pnpm --dir ../../ exec node apps/agentos.sh/scripts/copy-docs.js",
-    "docs:watch": "npm run docs:clean && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json && pnpm --dir ../../ exec typedoc --options typedoc.json && pnpm --dir ../../ exec node scripts/generate-api-docs.js && concurrently \"pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json --watch\" \"pnpm --dir ../../ exec typedoc --options typedoc.json --watch\" \"pnpm --dir ../../ exec node apps/agentos.sh/scripts/copy-docs.js --watch\""
+    "docs:library": "npm run docs:clean && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.modules.json && node scripts/generate-doc-search-index.mjs && pnpm --dir ../../ exec node apps/agentos.sh/scripts/copy-docs.js",
+    "docs:site-api": "pnpm --dir ../../ exec typedoc --options typedoc.json && pnpm --dir ../../ exec node scripts/generate-api-docs.js",
+    "docs": "npm run docs:library",
+    "docs:full": "npm run docs:library && npm run docs:site-api",
+    "docs:watch": "npm run docs:clean && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.modules.json && node scripts/generate-doc-search-index.mjs && pnpm --dir ../../ exec node apps/agentos.sh/scripts/copy-docs.js && concurrently \"pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json --watch\" \"pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.modules.json --watch\" \"node scripts/generate-doc-search-index.mjs --watch\" \"pnpm --dir ../../ exec node apps/agentos.sh/scripts/copy-docs.js --watch\""
   },
   "keywords": [
     "agentos",