@framers/agentos 0.1.6 → 0.1.8

package/dist/channels/types.d.ts

@@ -0,0 +1,257 @@
+/**
+ * @fileoverview Core types for the AgentOS Channel System.
+ *
+ * Channels represent external human-facing messaging platforms (Telegram,
+ * WhatsApp, Discord, Slack, etc.). This is distinct from the inter-agent
+ * {@link CommunicationChannelPayload} (`communication-channel` extension kind)
+ * which handles agent-to-agent messaging.
+ *
+ * @module @framers/agentos/channels/types
+ */
+/**
+ * Supported messaging platforms. Extensible via string literal union —
+ * concrete adapters can use any string, but well-known platforms get
+ * first-class type support.
+ */
+export type ChannelPlatform = 'telegram' | 'whatsapp' | 'discord' | 'slack' | 'webchat' | 'signal' | 'imessage' | 'google-chat' | 'teams' | 'matrix' | 'zalo' | 'email' | 'sms' | (string & {});
+/**
+ * Capabilities that a channel adapter can declare. Consumers can check
+ * capabilities before attempting actions that not all platforms support.
+ */
+export type ChannelCapability = 'text' | 'rich_text' | 'images' | 'video' | 'audio' | 'voice_notes' | 'documents' | 'stickers' | 'reactions' | 'threads' | 'typing_indicator' | 'read_receipts' | 'group_chat' | 'channels' | 'buttons' | 'inline_keyboard' | 'embeds' | 'mentions' | 'editing' | 'deletion' | (string & {});
+/** Connection health of a channel adapter. */
+export type ChannelConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'error';
+/** Detailed connection info returned by adapters. */
+export interface ChannelConnectionInfo {
+    status: ChannelConnectionStatus;
+    /** When the connection was last established. */
+    connectedSince?: string;
+    /** Human-readable error if status is 'error'. */
+    errorMessage?: string;
+    /** Platform-specific metadata (e.g., bot username, workspace name). */
+    platformInfo?: Record<string, unknown>;
+}
+/** Authentication configuration passed to an adapter during initialization. */
+export interface ChannelAuthConfig {
+    /** Platform this config targets. */
+    platform: ChannelPlatform;
+    /** Primary credential (bot token, API key, session data, etc.). */
+    credential: string;
+    /** Additional auth parameters (e.g., webhook URL, app secret). */
+    params?: Record<string, string>;
+}
+/** Conversation type within a channel. */
+export type ConversationType = 'direct' | 'group' | 'channel' | 'thread';
+/**
+ * Content block within a message. A single message can contain multiple
+ * content blocks (e.g., text + image attachment).
+ */
+export type MessageContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    url: string;
+    caption?: string;
+    mimeType?: string;
+} | {
+    type: 'video';
+    url: string;
+    caption?: string;
+    mimeType?: string;
+} | {
+    type: 'audio';
+    url: string;
+    duration?: number;
+    mimeType?: string;
+} | {
+    type: 'document';
+    url: string;
+    filename: string;
+    mimeType?: string;
+} | {
+    type: 'sticker';
+    stickerId: string;
+    url?: string;
+} | {
+    type: 'location';
+    latitude: number;
+    longitude: number;
+    name?: string;
+} | {
+    type: 'button_group';
+    buttons: MessageButton[];
+} | {
+    type: 'embed';
+    title: string;
+    description?: string;
+    url?: string;
+    color?: string;
+    fields?: {
+        name: string;
+        value: string;
+        inline?: boolean;
+    }[];
+};
+/** Interactive button in a message. */
+export interface MessageButton {
+    id: string;
+    label: string;
+    /** 'callback' triggers an event; 'url' opens a link. */
+    action: 'callback' | 'url';
+    value: string;
+}
+/**
+ * Outbound message content — what the agent wants to send.
+ */
+export interface MessageContent {
+    /** Content blocks to send. At minimum one 'text' block. */
+    blocks: MessageContentBlock[];
+    /** Reply to a specific message (platform threading). */
+    replyToMessageId?: string;
+    /** Platform-specific send options. */
+    platformOptions?: Record<string, unknown>;
+}
+/**
+ * Identity of a remote user on an external platform.
+ */
+export interface RemoteUser {
+    /** Platform-native user ID. */
+    id: string;
+    /** Display name (may change). */
+    displayName?: string;
+    /** Username/handle if available. */
+    username?: string;
+    /** Avatar URL if available. */
+    avatarUrl?: string;
+}
+/**
+ * Inbound message received from an external platform.
+ */
+export interface ChannelMessage {
+    /** Unique message ID assigned by the platform. */
+    messageId: string;
+    /** Platform this message came from. */
+    platform: ChannelPlatform;
+    /** Conversation/chat ID. */
+    conversationId: string;
+    /** Conversation type. */
+    conversationType: ConversationType;
+    /** Who sent the message. */
+    sender: RemoteUser;
+    /** Message content. */
+    content: MessageContentBlock[];
+    /** Raw text representation (convenience — extracted from content blocks). */
+    text: string;
+    /** ISO timestamp from the platform. */
+    timestamp: string;
+    /** Message being replied to, if this is a reply. */
+    replyToMessageId?: string;
+    /** Platform-specific raw data (for adapters that need pass-through). */
+    rawEvent?: unknown;
+}
+/** Send result from an adapter. */
+export interface ChannelSendResult {
+    /** Platform-assigned message ID for the sent message. */
+    messageId: string;
+    /** Timestamp of the sent message. */
+    timestamp?: string;
+}
+/** Events emitted by channel adapters. */
+export type ChannelEventType = 'message' | 'message_edited' | 'message_deleted' | 'reaction_added' | 'reaction_removed' | 'member_joined' | 'member_left' | 'typing' | 'button_callback' | 'error' | 'connection_change';
+/**
+ * Generic channel event wrapper. The `data` field varies by event type.
+ */
+export interface ChannelEvent<T = unknown> {
+    type: ChannelEventType;
+    platform: ChannelPlatform;
+    conversationId: string;
+    timestamp: string;
+    data: T;
+}
+/** Handler function for channel events. */
+export type ChannelEventHandler = (event: ChannelEvent) => void | Promise<void>;
+/** Message-specific event data. */
+export type MessageEvent = ChannelEvent<ChannelMessage> & {
+    type: 'message';
+};
+/** Button callback event data. */
+export interface ButtonCallbackData {
+    callbackId: string;
+    buttonId: string;
+    sender: RemoteUser;
+    messageId: string;
+}
+export type ButtonCallbackEvent = ChannelEvent<ButtonCallbackData> & {
+    type: 'button_callback';
+};
+/**
+ * Binding between an agent (seed) and a channel on an external platform.
+ * Extended from the original Wunderland `ChannelBinding` with additional fields
+ * for the full channel system.
+ */
+export interface ChannelBindingConfig {
+    /** Unique binding identifier. */
+    bindingId: string;
+    /** Agent seed ID. */
+    seedId: string;
+    /** Owner user ID (for permission checks). */
+    ownerUserId: string;
+    /** Target platform. */
+    platform: ChannelPlatform;
+    /** Platform-native channel/chat ID. */
+    channelId: string;
+    /** Type of conversation. */
+    conversationType: ConversationType;
+    /** Credential ID (references encrypted credential in vault). */
+    credentialId?: string;
+    /** Whether this binding is active. */
+    isActive: boolean;
+    /** Whether agent posts should auto-broadcast to this channel. */
+    autoBroadcast: boolean;
+    /** Platform-specific configuration. */
+    platformConfig?: Record<string, unknown>;
+}
+/**
+ * Active session between an agent and a remote conversation.
+ */
+export interface ChannelSession {
+    /** Unique session ID. */
+    sessionId: string;
+    /** Agent seed ID. */
+    seedId: string;
+    /** Platform. */
+    platform: ChannelPlatform;
+    /** Platform-native conversation ID. */
+    conversationId: string;
+    /** Conversation type. */
+    conversationType: ConversationType;
+    /** Remote user (for DMs). */
+    remoteUser?: RemoteUser;
+    /** Last message timestamp. */
+    lastMessageAt: string;
+    /** Total messages exchanged. */
+    messageCount: number;
+    /** Whether this session is active. */
+    isActive: boolean;
+    /** Session context data (for multi-turn state). */
+    context?: Record<string, unknown>;
+}
+/** Metadata about an available channel adapter. */
+export interface ChannelInfo {
+    /** Platform identifier. */
+    platform: ChannelPlatform;
+    /** Human-friendly display name (e.g., "WhatsApp Business"). */
+    displayName: string;
+    /** Description of the channel. */
+    description: string;
+    /** Capabilities this adapter supports. */
+    capabilities: ChannelCapability[];
+    /** Whether the adapter's dependencies are installed. */
+    available: boolean;
+    /** Required secret IDs for this channel. */
+    requiredSecrets: string[];
+    /** Icon identifier or URL. */
+    icon?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/channels/types.d.ts.map

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

package/dist/channels/types.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Core types for the AgentOS Channel System.
+ *
+ * Channels represent external human-facing messaging platforms (Telegram,
+ * WhatsApp, Discord, Slack, etc.). This is distinct from the inter-agent
+ * {@link CommunicationChannelPayload} (`communication-channel` extension kind)
+ * which handles agent-to-agent messaging.
+ *
+ * @module @framers/agentos/channels/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/channels/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/cognitive_substrate/GMI.d.ts

@@ -39,6 +39,9 @@ export declare class GMI implements IGMI {
     private conversationHistory;
     private selfReflectionIntervalTurns;
     private turnsSinceLastReflection;
+    private pendingGMIEvents;
+    private eventHistory;
+    private metaPromptTriggerCounters;
     /**
      * Constructs a GMI instance.
      * The GMI is not fully operational until `initialize` is called.
@@ -129,6 +132,142 @@ export declare class GMI implements IGMI {
      * @private
      */
     private performPostTurnIngestion;
+    /**
+     * Analyzes sentiment of user input and updates sentiment history.
+     * Triggers event detection based on sentiment patterns.
+     *
+     * @param turnId - Current turn identifier
+     * @param userInput - User's input text
+     * @private
+     */
+    private analyzeTurnSentiment;
+    /**
+     * Detects emotional patterns and emits appropriate GMI events.
+     *
+     * @param turnId - Current turn identifier
+     * @param userInput - User's input text
+     * @param sentimentResult - Sentiment analysis result
+     * @param sentimentHistory - Historical sentiment data
+     * @private
+     */
+    private detectAndEmitEvents;
+    /**
+     * Emits a GMI event and stores it in event history.
+     *
+     * @param event - The event to emit
+     * @private
+     */
+    private emitEvent;
+    /**
+     * Checks all metaprompt triggers (turn_interval, event_based, manual) and executes triggered ones.
+     *
+     * @param turnId - Current turn identifier
+     * @private
+     */
+    private checkAndTriggerMetaprompts;
+    /**
+     * Gets the turn counter for a specific metaprompt.
+     *
+     * @param metapromptId - Metaprompt identifier
+     * @returns Current counter value
+     * @private
+     */
+    private getMetapromptTurnCounter;
+    /**
+     * Increments the turn counter for a specific metaprompt.
+     *
+     * @param metapromptId - Metaprompt identifier
+     * @private
+     */
+    private incrementMetapromptTurnCounter;
+    /**
+     * Resets the turn counter for a specific metaprompt to zero.
+     *
+     * @param metapromptId - Metaprompt identifier
+     * @private
+     */
+    private resetMetapromptTurnCounter;
+    /**
+     * Executes multiple metaprompts in parallel or sequence.
+     * Replaces the single-metaprompt _triggerAndProcessSelfReflection().
+     *
+     * @param metaPrompts - Array of metaprompts to execute
+     * @private
+     */
+    private executeMetaprompts;
+    /**
+     * Routes a metaprompt to its appropriate handler based on ID.
+     *
+     * @param metaPrompt - Metaprompt definition to execute
+     * @private
+     */
+    private executeMetapromptHandler;
+    /**
+     * Handler for trait adjustment metaprompt (existing self-reflection logic).
+     *
+     * @param metaPrompt - Metaprompt definition
+     * @private
+     */
+    private handleTraitAdjustment;
+    /**
+     * Handler for frustration recovery metaprompt.
+     *
+     * @param metaPrompt - Metaprompt definition
+     * @private
+     */
+    private handleFrustrationRecovery;
+    /**
+     * Handler for confusion clarification metaprompt.
+     *
+     * @param metaPrompt - Metaprompt definition
+     * @private
+     */
+    private handleConfusionClarification;
+    /**
+     * Handler for satisfaction reinforcement metaprompt.
+     *
+     * @param metaPrompt - Metaprompt definition
+     * @private
+     */
+    private handleSatisfactionReinforcement;
+    /**
+     * Handler for error recovery metaprompt.
+     *
+     * @param metaPrompt - Metaprompt definition
+     * @private
+     */
+    private handleErrorRecovery;
+    /**
+     * Handler for engagement boost metaprompt.
+     *
+     * @param metaPrompt - Metaprompt definition
+     * @private
+     */
+    private handleEngagementBoost;
+    /**
+     * Generic handler for custom metaprompts not in the preset list.
+     *
+     * @param metaPrompt - Metaprompt definition
+     * @private
+     */
+    private handleGenericMetaprompt;
+    /**
+     * Executes a metaprompt with variable substitution.
+     *
+     * @param metaPrompt - Metaprompt definition
+     * @param variables - Variables to substitute in the template
+     * @returns Parsed JSON response from LLM
+     * @private
+     */
+    private executeMetapromptWithVariables;
+    /**
+     * Applies metaprompt updates to GMI state (mood, user skill, task complexity, memory).
+     *
+     * @param updates - Parsed updates from metaprompt response
+     * @param metapromptId - ID of the metaprompt that generated these updates
+     * @private
+     */
+    private applyMetapromptUpdates;
     /** @inheritdoc */
     _triggerAndProcessSelfReflection(): Promise<void>;
     /**

package/dist/cognitive_substrate/GMI.d.ts.map

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