@animalabs/agent-framework 0.1.0

package/dist/src/index.d.ts

@@ -0,0 +1,17 @@
+export * from './types/index.js';
+export { AgentFramework } from './framework.js';
+export { Agent } from './agent.js';
+export type { StartStreamResult } from './agent.js';
+export { ProcessQueueImpl } from './queue.js';
+export { ModuleRegistry } from './module-registry.js';
+export * from './modules/index.js';
+export { ApiServer } from './api/server.js';
+export { McpServer } from './api/mcp-server.js';
+export type { ApiServerConfig, ApiMessage, ApiRequest, ApiResponse, ApiEvent, ApiCommand, MessageSendParams, MessageListParams, InferenceRequestParams, InferenceAbortParams, BranchCreateParams, BranchSwitchParams, BranchDeleteParams, AgentContextParams, ModuleStateParams, StoreInspectParams, MessageInfo, BranchInfo, ModuleInfo, StateInfo, ApiEventType, InferenceStartEvent, InferenceCompleteEvent, InferenceAbortedEvent, InferenceErrorEvent, ToolStartEvent, ToolCompleteEvent, ToolErrorEvent, SpeechEvent, MessageAddedEvent, BranchSwitchedEvent, BranchCreatedEvent, BranchDeletedEvent, } from './api/types.js';
+export { EventGate } from './gate/index.js';
+export type { GateConfig, GateOptions, GatePolicy, GatePolicyMatch, GateBehavior } from './gate/index.js';
+export type { ContextManager, ContextStrategy, TokenBudget } from '@animalabs/context-manager';
+export { PassthroughStrategy, AutobiographicalStrategy, KnowledgeStrategy } from '@animalabs/context-manager';
+export type { KnowledgeConfig, PhaseType } from '@animalabs/context-manager';
+export type { Membrane, NormalizedMessage, NormalizedRequest, ContentBlock } from '@animalabs/membrane';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,YAAY,EACV,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG1G,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC9G,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC7E,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,18 @@
+// Types
+export * from './types/index.js';
+// Core classes
+export { AgentFramework } from './framework.js';
+export { Agent } from './agent.js';
+export { ProcessQueueImpl } from './queue.js';
+export { ModuleRegistry } from './module-registry.js';
+// Built-in modules
+export * from './modules/index.js';
+// API
+export { ApiServer } from './api/server.js';
+export { McpServer } from './api/mcp-server.js';
+// Note: AgentInfo, MessageEditedEvent, MessageRemovedEvent intentionally not re-exported
+// from api/types.js to avoid conflicts with ./types/index.js
+// EventGate
+export { EventGate } from './gate/index.js';
+export { PassthroughStrategy, AutobiographicalStrategy, KnowledgeStrategy } from '@animalabs/context-manager';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,mBAAmB;AACnB,cAAc,oBAAoB,CAAC;AAEnC,MAAM;AACN,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAoChD,yFAAyF;AACzF,6DAA6D;AAE7D,YAAY;AACZ,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK5C,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/mcpl/channel-registry.d.ts

@@ -0,0 +1,141 @@
+/**
+ * ChannelRegistry — manages MCPL channel lifecycle, incoming messages, and
+ * synthesized channel tools.
+ *
+ * Adapted from battle-tested patterns in Anarchid/agent-framework@mcpl-module-proto.
+ *
+ * Responsibilities:
+ * - Register/unregister channel descriptors from MCPL servers
+ * - Auto-open channels on registration
+ * - Route incoming messages to the processing queue
+ * - Manage typing indicator timers (7s interval for Discord compatibility)
+ * - Expose synthesized tools: channel_list, channel_open, channel_close, channel_publish
+ * - Build channel context for beforeInference params
+ */
+import type { ChannelDescriptor, ChannelContext, ChannelsRegisterParams, ChannelsChangedParams, ChannelsIncomingParams } from './types.js';
+import type { McplServerRegistry } from './server-registry.js';
+import type { FeatureSetManager } from './feature-set-manager.js';
+import type { ToolDefinition, ToolResult, ProcessEvent } from '../types/index.js';
+/** A registered channel entry, keyed by `{serverId}:{channelId}`. */
+interface ChannelEntry {
+    serverId: string;
+    descriptor: ChannelDescriptor;
+    open: boolean;
+}
+/** Minimal responder interface for sending JSON-RPC results back. */
+interface Responder {
+    respond(result: unknown): void;
+    respondError?(code: number, message: string, data?: unknown): void;
+}
+interface ChannelRegistryOptions {
+    /** Callback to determine whether an incoming message should trigger inference. */
+    shouldTriggerInference?: (content: string, metadata: Record<string, unknown>) => boolean;
+}
+export declare class ChannelRegistry {
+    private serverRegistry;
+    private featureSetManager;
+    private pushEventFn;
+    private emitTraceFn;
+    private sendTypingFn?;
+    private shouldTriggerInference?;
+    /** Registered channels, keyed by `{serverId}:{channelId}`. */
+    private channels;
+    /** Most recent incoming channel ID — used for speech routing / default publish. */
+    private defaultPublishChannel;
+    /** Most recent incoming message metadata, used for buildChannelContext. */
+    private defaultPublishMessageId;
+    private defaultPublishThreadId;
+    /** Per-channel typing indicator timers. */
+    private typingIntervals;
+    constructor(serverRegistry: McplServerRegistry, featureSetManager: FeatureSetManager, pushEventFn: (event: ProcessEvent) => void, emitTraceFn: (event: {
+        type: string;
+        [key: string]: unknown;
+    }) => void, options?: ChannelRegistryOptions & {
+        sendTypingFn?: (serverId: string, channelId: string) => void;
+    });
+    /**
+     * Handle `channels/register` from a server.
+     *
+     * Registers each channel descriptor in the map and auto-opens them.
+     */
+    handleRegister(serverId: string, params: ChannelsRegisterParams, responder?: Responder): Promise<void>;
+    /**
+     * Handle `channels/changed` notification from a server.
+     *
+     * Processes added (register + auto-open), removed (delete + stop typing),
+     * and updated (replace descriptor) channels.
+     */
+    handleChanged(serverId: string, params: ChannelsChangedParams): Promise<void>;
+    /**
+     * Handle `channels/incoming` from a server.
+     *
+     * Converts each message's content, pushes McplChannelIncomingEvent to the
+     * queue, and responds with per-message results.
+     */
+    handleIncoming(serverId: string, params: ChannelsIncomingParams, responder?: Responder): void;
+    /**
+     * Start sending typing indicators for a channel.
+     *
+     * Sends a typing notification immediately and every 7 seconds thereafter.
+     * Discord typing indicators last ~10s, so 7s keeps them alive.
+     *
+     * No-op if already typing on this channel.
+     */
+    startTyping(channelId: string): void;
+    /**
+     * Stop sending typing indicators.
+     *
+     * If channelId is specified, stops typing on that channel only.
+     * If no channelId, stops all typing indicators.
+     */
+    stopTyping(channelId?: string): void;
+    /**
+     * Get the default publish channel ID (most recent incoming channel).
+     */
+    getDefaultPublishChannel(): string | null;
+    /**
+     * Get all open channels.
+     */
+    getOpenChannels(): ChannelEntry[];
+    /**
+     * Get synthesized tool definitions for channel operations.
+     */
+    getChannelTools(): ToolDefinition[];
+    /**
+     * Handle a call to one of the synthesized channel tools.
+     */
+    handleChannelToolCall(toolName: string, input: unknown): Promise<ToolResult>;
+    /**
+     * Build channel context for inclusion in beforeInference params.
+     *
+     * Returns undefined if no channels are active.
+     */
+    buildChannelContext(): ChannelContext | undefined;
+    /**
+     * Stop all typing intervals and clear all channel registrations.
+     */
+    stopAll(): void;
+    private autoOpenChannels;
+    /**
+     * Send a typing notification for a channel.
+     *
+     * Uses the sendTypingFn callback if provided. If not, this is a no-op
+     * (typing timer lifecycle is still managed for when the callback is wired).
+     */
+    private sendTypingNotification;
+    /**
+     * Find a channel entry by channelId (searches across all servers).
+     * Returns the first match.
+     */
+    private findChannelEntry;
+    /**
+     * Find the composite key for a channel by its channelId.
+     */
+    private findChannelKey;
+    private handleToolList;
+    private handleToolOpen;
+    private handleToolClose;
+    private handleToolPublish;
+}
+export {};
+//# sourceMappingURL=channel-registry.d.ts.map

package/dist/src/mcpl/channel-registry.d.ts.map

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