@framers/agentos 0.1.51 → 0.1.53

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

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

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

@@ -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';