@xmtp/agent-sdk 1.2.4 → 1.2.5-rc2

package/dist/debug.d.ts

@@ -1 +1,141 @@
-export * from "./debug/index.js";
+import * as _xmtp_node_sdk from '@xmtp/node-sdk';
+import { Client, EncryptedAttachment as EncryptedAttachment$1, Conversation, Dm, Group, DecodedMessage, Reply, Reaction, ReadReceipt, RemoteAttachment, TransactionReference, WalletSendCalls, GroupUpdated, ClientOptions, StreamOptions, HexString, CreateDmOptions, CreateGroupOptions } from '@xmtp/node-sdk';
+import EventEmitter from 'node:events';
+import { ContentCodec } from '@xmtp/content-type-primitives';
+
+declare class ClientContext<ContentTypes = unknown> {
+    #private;
+    constructor({ client }: {
+        client: Client<ContentTypes>;
+    });
+    getClientAddress(): string | undefined;
+    get client(): Client<ContentTypes>;
+}
+
+type EncryptedAttachment = {
+    content: EncryptedAttachment$1;
+    mimeType: string;
+};
+type AttachmentUploadCallback = (attachment: EncryptedAttachment) => Promise<string>;
+
+declare class ConversationContext<ContentTypes = unknown, ConversationType extends Conversation = Conversation> extends ClientContext<ContentTypes> {
+    #private;
+    constructor({ conversation, client, }: {
+        conversation: ConversationType;
+        client: Client<ContentTypes>;
+    });
+    isDm(): this is ConversationContext<ContentTypes, Dm<ContentTypes>>;
+    isGroup(): this is ConversationContext<ContentTypes, Group<ContentTypes>>;
+    sendMarkdown(markdown: string): Promise<void>;
+    sendText(text: string): Promise<void>;
+    sendRemoteAttachment(unencryptedFile: File, uploadCallback: AttachmentUploadCallback): Promise<void>;
+    get conversation(): ConversationType;
+    get isAllowed(): boolean;
+    get isDenied(): boolean;
+    get isUnknown(): boolean;
+}
+
+type DecodedMessageWithContent<ContentTypes = unknown> = DecodedMessage<ContentTypes> & {
+    content: ContentTypes;
+};
+
+type MessageContextParams<MessageContentType = unknown, ContentTypes = unknown> = Omit<AgentBaseContext<ContentTypes>, "message"> & {
+    message: DecodedMessageWithContent<MessageContentType>;
+};
+declare class MessageContext<MessageContentType = unknown, ContentTypes = unknown> extends ConversationContext<ContentTypes> {
+    #private;
+    constructor({ message, conversation, client, }: MessageContextParams<MessageContentType, ContentTypes>);
+    usesCodec<T extends ContentCodec>(codecClass: new () => T): this is MessageContext<ReturnType<T["decode"]>>;
+    isMarkdown(): this is MessageContext<string>;
+    isText(): this is MessageContext<string>;
+    isReply(): this is MessageContext<Reply>;
+    isReaction(): this is MessageContext<Reaction>;
+    isReadReceipt(): this is MessageContext<ReadReceipt>;
+    isRemoteAttachment(): this is MessageContext<RemoteAttachment>;
+    isTransactionReference(): this is MessageContext<TransactionReference>;
+    isWalletSendCalls(): this is MessageContext<WalletSendCalls>;
+    sendReaction(content: string, schema?: Reaction["schema"]): Promise<void>;
+    sendMarkdownReply(markdown: string): Promise<void>;
+    sendTextReply(text: string): Promise<void>;
+    getSenderAddress(): Promise<string | undefined>;
+    get message(): DecodedMessageWithContent<MessageContentType>;
+}
+
+type EventHandlerMap<ContentTypes> = {
+    attachment: [ctx: MessageContext<RemoteAttachment, ContentTypes>];
+    conversation: [ctx: ConversationContext<ContentTypes>];
+    "group-update": [ctx: MessageContext<GroupUpdated, ContentTypes>];
+    dm: [ctx: ConversationContext<ContentTypes, Dm<ContentTypes>>];
+    group: [ctx: ConversationContext<ContentTypes, Group<ContentTypes>>];
+    markdown: [ctx: MessageContext<string, ContentTypes>];
+    message: [ctx: MessageContext<unknown, ContentTypes>];
+    reaction: [ctx: MessageContext<Reaction, ContentTypes>];
+    "read-receipt": [ctx: MessageContext<ReadReceipt, ContentTypes>];
+    reply: [ctx: MessageContext<Reply, ContentTypes>];
+    start: [ctx: ClientContext<ContentTypes>];
+    stop: [ctx: ClientContext<ContentTypes>];
+    text: [ctx: MessageContext<string, ContentTypes>];
+    "transaction-reference": [
+        ctx: MessageContext<TransactionReference, ContentTypes>
+    ];
+    unhandledError: [error: Error];
+    unknownMessage: [ctx: MessageContext<unknown, ContentTypes>];
+    "wallet-send-calls": [ctx: MessageContext<WalletSendCalls, ContentTypes>];
+};
+type EthAddress = HexString;
+type AgentBaseContext<ContentTypes = unknown> = {
+    client: Client<ContentTypes>;
+    conversation: Conversation;
+    message: DecodedMessage;
+};
+type AgentErrorContext<ContentTypes = unknown> = Partial<AgentBaseContext<ContentTypes>> & {
+    client: Client<ContentTypes>;
+};
+type AgentOptions<ContentTypes> = {
+    client: Client<ContentTypes>;
+};
+type AgentMiddleware<ContentTypes = unknown> = (ctx: MessageContext<unknown, ContentTypes>, next: () => Promise<void> | void) => Promise<void>;
+type AgentErrorMiddleware<ContentTypes = unknown> = (error: unknown, ctx: AgentErrorContext<ContentTypes>, next: (err?: unknown) => Promise<void> | void) => Promise<void> | void;
+type AgentStreamingOptions = Omit<StreamOptions, "onValue" | "onError">;
+type AgentErrorRegistrar<ContentTypes> = {
+    use(...errorMiddleware: Array<AgentErrorMiddleware<ContentTypes> | AgentErrorMiddleware<ContentTypes>[]>): AgentErrorRegistrar<ContentTypes>;
+};
+declare class Agent<ContentTypes = unknown> extends EventEmitter<EventHandlerMap<ContentTypes>> {
+    #private;
+    constructor({ client }: AgentOptions<ContentTypes>);
+    static create<ContentCodecs extends ContentCodec[] = []>(signer: Parameters<typeof Client.create>[0], options?: Omit<ClientOptions, "codecs"> & {
+        codecs?: ContentCodecs;
+    }): Promise<Agent<_xmtp_node_sdk.ExtractCodecContentTypes<ContentCodecs>>>;
+    static createFromEnv<ContentCodecs extends ContentCodec[] = []>(options?: Omit<ClientOptions, "codecs"> & {
+        codecs?: ContentCodecs;
+    }): Promise<Agent<_xmtp_node_sdk.ExtractCodecContentTypes<ContentCodecs>>>;
+    get libxmtpVersion(): string | undefined;
+    use(...middleware: Array<AgentMiddleware<ContentTypes> | AgentMiddleware<ContentTypes>[]>): this;
+    start(options?: AgentStreamingOptions): Promise<void>;
+    get client(): Client<ContentTypes>;
+    get errors(): AgentErrorRegistrar<ContentTypes>;
+    stop(): Promise<void>;
+    createDmWithAddress(address: EthAddress, options?: CreateDmOptions): Promise<Dm<ContentTypes>>;
+    createGroupWithAddresses(addresses: EthAddress[], options?: CreateGroupOptions): Promise<Group<ContentTypes>>;
+    addMembersWithAddresses<ContentTypes>(group: Group<ContentTypes>, addresses: EthAddress[]): Promise<void>;
+    getConversationContext(conversationId: string): Promise<ConversationContext<ContentTypes, Dm<ContentTypes> | Group<ContentTypes>> | undefined>;
+    get address(): string | undefined;
+}
+
+declare const logDetails: <ContentTypes>(agent: Agent<ContentTypes>) => Promise<void>;
+/**
+ * Returns a URL to test your agent on https://xmtp.chat/ (for development purposes only).
+ *
+ * @param client - Your XMTP client
+ * @returns The URL to test your agent with
+ */
+declare const getTestUrl: <ContentTypes>(client: Client<ContentTypes>) => string;
+type InstallationInfo = {
+    totalInstallations: number;
+    installationId: string;
+    mostRecentInstallationId: null | string;
+    isMostRecent: boolean;
+};
+declare const getInstallationInfo: <ContentTypes>(client: Client<ContentTypes>) => Promise<InstallationInfo>;
+
+export { getInstallationInfo, getTestUrl, logDetails };

package/dist/debug.js

@@ -1,2 +1,85 @@
-export * from "./debug/index.js";
-//# sourceMappingURL=debug.js.map
+import { Client } from '@xmtp/node-sdk';
+
+const logDetails = async (agent) => {
+    const xmtp = `\x1b[38;2;252;76;52m
+    ██╗  ██╗███╗   ███╗████████╗██████╗ 
+    ╚██╗██╔╝████╗ ████║╚══██╔══╝██╔══██╗
+     ╚███╔╝ ██╔████╔██║   ██║   ██████╔╝
+     ██╔██╗ ██║╚██╔╝██║   ██║   ██╔═══╝ 
+    ██╔╝ ██╗██║ ╚═╝ ██║   ██║   ██║     
+    ╚═╝  ╚═╝╚═╝     ╚═╝   ╚═╝   ╚═╝     
+  \x1b[0m`;
+    const client = agent.client;
+    const clientsByAddress = client.accountIdentifier?.identifier;
+    const inboxId = client.inboxId;
+    const installationId = client.installationId;
+    const env = client.options?.env ?? "dev";
+    const urls = [`http://xmtp.chat/${env}/dm/${clientsByAddress}`];
+    const conversations = await client.conversations.list();
+    const inboxState = await client.preferences.inboxState();
+    const keyPackageStatuses = await client.fetchKeyPackageStatuses([
+        installationId,
+    ]);
+    let createdDate = new Date();
+    let expiryDate = new Date();
+    // Extract key package status for the specific installation
+    const keyPackageStatus = keyPackageStatuses[installationId] ?? {};
+    if (keyPackageStatus.lifetime) {
+        createdDate = new Date(Number(keyPackageStatus.lifetime.notBefore) * 1000);
+        expiryDate = new Date(Number(keyPackageStatus.lifetime.notAfter) * 1000);
+    }
+    console.log(`
+    ${xmtp}
+    
+    ✓ XMTP Client:
+    • InboxId: ${inboxId}
+    • LibXMTP Version: ${agent.libxmtpVersion}
+    • Address: ${clientsByAddress}
+    • Conversations: ${conversations.length}
+    • Installations: ${inboxState.installations.length}
+    • InstallationId: ${installationId}
+    • Key Package created: ${createdDate.toLocaleString()}
+    • Key Package valid until: ${expiryDate.toLocaleString()}
+    • Networks: ${env}
+    ${urls.map((url) => `• URL: ${url}`).join("\n")}`);
+};
+/**
+ * Returns a URL to test your agent on https://xmtp.chat/ (for development purposes only).
+ *
+ * @param client - Your XMTP client
+ * @returns The URL to test your agent with
+ */
+const getTestUrl = (client) => {
+    const address = client.accountIdentifier?.identifier;
+    const env = client.options?.env ?? "dev";
+    return `http://xmtp.chat/${env}/dm/${address}`;
+};
+const getInstallationInfo = async (client) => {
+    const myInboxId = client.inboxId;
+    const myInstallationId = client.installationId;
+    const inboxStates = await Client.fetchInboxStates([myInboxId], client.options?.env);
+    const installations = inboxStates.find((state) => state.inboxId === myInboxId)?.installations ||
+        [];
+    const sortedInstallations = [...installations].sort((a, b) => {
+        const aTime = a.clientTimestampNs ?? 0n;
+        const bTime = b.clientTimestampNs ?? 0n;
+        return bTime > aTime ? 1 : bTime < aTime ? -1 : 0;
+    });
+    const mostRecentInstallation = sortedInstallations[0];
+    const myInstallationIdHex = Buffer.from(client.installationIdBytes).toString("hex");
+    const info = {
+        totalInstallations: installations.length,
+        installationId: myInstallationId,
+        mostRecentInstallationId: null,
+        isMostRecent: false,
+    };
+    if (mostRecentInstallation) {
+        const mostRecentIdHex = Buffer.from(mostRecentInstallation.bytes).toString("hex");
+        info.mostRecentInstallationId = mostRecentIdHex;
+        info.isMostRecent = myInstallationIdHex === mostRecentIdHex;
+    }
+    return info;
+};
+
+export { getInstallationInfo, getTestUrl, logDetails };
+//# sourceMappingURL=debug.js.map

package/dist/debug.js.map

@@ -1 +1 @@
-{"version":3,"file":"debug.js","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"debug.js","sources":["../src/debug/log.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,175 @@
-export { ConsentEntityType, ConsentState, ConversationType, DeliveryStatus, GroupMember, GroupMembershipState, GroupMessageKind, GroupMetadata, GroupPermissions, GroupPermissionsOptions, IdentifierKind, LogLevel, MetadataField, PermissionLevel, PermissionPolicy, PermissionUpdateType, SignatureRequestHandle, SortDirection, } from "@xmtp/node-sdk";
-export type * from "@xmtp/node-sdk";
-export { isHexString, validHex } from "@xmtp/node-sdk";
-export * from "./core/index.js";
+import * as _xmtp_node_sdk from '@xmtp/node-sdk';
+import { Client, EncryptedAttachment as EncryptedAttachment$1, Conversation, Dm, Group, DecodedMessage, GroupUpdated, Reaction, ReadReceipt, RemoteAttachment, Reply, TransactionReference, WalletSendCalls, StreamOptions, ClientOptions, HexString, CreateDmOptions, CreateGroupOptions } from '@xmtp/node-sdk';
+export * from '@xmtp/node-sdk';
+import EventEmitter from 'node:events';
+import { ContentCodec } from '@xmtp/content-type-primitives';
+
+declare class ClientContext<ContentTypes = unknown> {
+    #private;
+    constructor({ client }: {
+        client: Client<ContentTypes>;
+    });
+    getClientAddress(): string | undefined;
+    get client(): Client<ContentTypes>;
+}
+
+type EncryptedAttachment = {
+    content: EncryptedAttachment$1;
+    mimeType: string;
+};
+type AttachmentUploadCallback = (attachment: EncryptedAttachment) => Promise<string>;
+
+declare class ConversationContext<ContentTypes = unknown, ConversationType extends Conversation = Conversation> extends ClientContext<ContentTypes> {
+    #private;
+    constructor({ conversation, client, }: {
+        conversation: ConversationType;
+        client: Client<ContentTypes>;
+    });
+    isDm(): this is ConversationContext<ContentTypes, Dm<ContentTypes>>;
+    isGroup(): this is ConversationContext<ContentTypes, Group<ContentTypes>>;
+    sendMarkdown(markdown: string): Promise<void>;
+    sendText(text: string): Promise<void>;
+    sendRemoteAttachment(unencryptedFile: File, uploadCallback: AttachmentUploadCallback): Promise<void>;
+    get conversation(): ConversationType;
+    get isAllowed(): boolean;
+    get isDenied(): boolean;
+    get isUnknown(): boolean;
+}
+
+type DecodedMessageWithContent<ContentTypes = unknown> = DecodedMessage<ContentTypes> & {
+    content: ContentTypes;
+};
+declare const filter: {
+    fromSelf: <ContentTypes>(message: DecodedMessage<ContentTypes>, client: Client<ContentTypes>) => boolean;
+    hasContent: <ContentTypes>(message: DecodedMessage<ContentTypes>) => message is DecodedMessageWithContent<ContentTypes>;
+    isDM: (conversation: Conversation) => conversation is Dm;
+    isGroup: (conversation: Conversation) => conversation is Group;
+    isGroupAdmin: (conversation: Conversation, message: DecodedMessage) => boolean;
+    isGroupSuperAdmin: (conversation: Conversation, message: DecodedMessage) => boolean;
+    isGroupUpdate: (message: DecodedMessage) => message is DecodedMessageWithContent<GroupUpdated>;
+    isMarkdown: (message: DecodedMessage) => message is DecodedMessageWithContent<string>;
+    isReaction: (message: DecodedMessage) => message is DecodedMessageWithContent<Reaction>;
+    isReadReceipt: (message: DecodedMessage) => message is DecodedMessageWithContent<ReadReceipt>;
+    isRemoteAttachment: (message: DecodedMessage) => message is DecodedMessageWithContent<RemoteAttachment>;
+    isReply: (message: DecodedMessage) => message is DecodedMessageWithContent<Reply>;
+    isText: (message: DecodedMessage) => message is DecodedMessageWithContent<string>;
+    isTextReply: (message: DecodedMessage) => boolean;
+    isTransactionReference: (message: DecodedMessage) => message is DecodedMessageWithContent<TransactionReference>;
+    isWalletSendCalls: (message: DecodedMessage) => message is DecodedMessageWithContent<WalletSendCalls>;
+    usesCodec: <T extends ContentCodec>(message: DecodedMessage, codecClass: new () => T) => message is DecodedMessageWithContent<T>;
+};
+declare const f: {
+    fromSelf: <ContentTypes>(message: DecodedMessage<ContentTypes>, client: Client<ContentTypes>) => boolean;
+    hasContent: <ContentTypes>(message: DecodedMessage<ContentTypes>) => message is DecodedMessageWithContent<ContentTypes>;
+    isDM: (conversation: Conversation) => conversation is Dm;
+    isGroup: (conversation: Conversation) => conversation is Group;
+    isGroupAdmin: (conversation: Conversation, message: DecodedMessage) => boolean;
+    isGroupSuperAdmin: (conversation: Conversation, message: DecodedMessage) => boolean;
+    isGroupUpdate: (message: DecodedMessage) => message is DecodedMessageWithContent<GroupUpdated>;
+    isMarkdown: (message: DecodedMessage) => message is DecodedMessageWithContent<string>;
+    isReaction: (message: DecodedMessage) => message is DecodedMessageWithContent<Reaction>;
+    isReadReceipt: (message: DecodedMessage) => message is DecodedMessageWithContent<ReadReceipt>;
+    isRemoteAttachment: (message: DecodedMessage) => message is DecodedMessageWithContent<RemoteAttachment>;
+    isReply: (message: DecodedMessage) => message is DecodedMessageWithContent<Reply>;
+    isText: (message: DecodedMessage) => message is DecodedMessageWithContent<string>;
+    isTextReply: (message: DecodedMessage) => boolean;
+    isTransactionReference: (message: DecodedMessage) => message is DecodedMessageWithContent<TransactionReference>;
+    isWalletSendCalls: (message: DecodedMessage) => message is DecodedMessageWithContent<WalletSendCalls>;
+    usesCodec: <T extends ContentCodec>(message: DecodedMessage, codecClass: new () => T) => message is DecodedMessageWithContent<T>;
+};
+
+type MessageContextParams<MessageContentType = unknown, ContentTypes = unknown> = Omit<AgentBaseContext<ContentTypes>, "message"> & {
+    message: DecodedMessageWithContent<MessageContentType>;
+};
+declare class MessageContext<MessageContentType = unknown, ContentTypes = unknown> extends ConversationContext<ContentTypes> {
+    #private;
+    constructor({ message, conversation, client, }: MessageContextParams<MessageContentType, ContentTypes>);
+    usesCodec<T extends ContentCodec>(codecClass: new () => T): this is MessageContext<ReturnType<T["decode"]>>;
+    isMarkdown(): this is MessageContext<string>;
+    isText(): this is MessageContext<string>;
+    isReply(): this is MessageContext<Reply>;
+    isReaction(): this is MessageContext<Reaction>;
+    isReadReceipt(): this is MessageContext<ReadReceipt>;
+    isRemoteAttachment(): this is MessageContext<RemoteAttachment>;
+    isTransactionReference(): this is MessageContext<TransactionReference>;
+    isWalletSendCalls(): this is MessageContext<WalletSendCalls>;
+    sendReaction(content: string, schema?: Reaction["schema"]): Promise<void>;
+    sendMarkdownReply(markdown: string): Promise<void>;
+    sendTextReply(text: string): Promise<void>;
+    getSenderAddress(): Promise<string | undefined>;
+    get message(): DecodedMessageWithContent<MessageContentType>;
+}
+
+type EventHandlerMap<ContentTypes> = {
+    attachment: [ctx: MessageContext<RemoteAttachment, ContentTypes>];
+    conversation: [ctx: ConversationContext<ContentTypes>];
+    "group-update": [ctx: MessageContext<GroupUpdated, ContentTypes>];
+    dm: [ctx: ConversationContext<ContentTypes, Dm<ContentTypes>>];
+    group: [ctx: ConversationContext<ContentTypes, Group<ContentTypes>>];
+    markdown: [ctx: MessageContext<string, ContentTypes>];
+    message: [ctx: MessageContext<unknown, ContentTypes>];
+    reaction: [ctx: MessageContext<Reaction, ContentTypes>];
+    "read-receipt": [ctx: MessageContext<ReadReceipt, ContentTypes>];
+    reply: [ctx: MessageContext<Reply, ContentTypes>];
+    start: [ctx: ClientContext<ContentTypes>];
+    stop: [ctx: ClientContext<ContentTypes>];
+    text: [ctx: MessageContext<string, ContentTypes>];
+    "transaction-reference": [
+        ctx: MessageContext<TransactionReference, ContentTypes>
+    ];
+    unhandledError: [error: Error];
+    unknownMessage: [ctx: MessageContext<unknown, ContentTypes>];
+    "wallet-send-calls": [ctx: MessageContext<WalletSendCalls, ContentTypes>];
+};
+type EthAddress = HexString;
+type AgentBaseContext<ContentTypes = unknown> = {
+    client: Client<ContentTypes>;
+    conversation: Conversation;
+    message: DecodedMessage;
+};
+type AgentErrorContext<ContentTypes = unknown> = Partial<AgentBaseContext<ContentTypes>> & {
+    client: Client<ContentTypes>;
+};
+type AgentOptions<ContentTypes> = {
+    client: Client<ContentTypes>;
+};
+type AgentMessageHandler<ContentTypes = unknown> = (ctx: MessageContext<ContentTypes>) => Promise<void> | void;
+type AgentMiddleware<ContentTypes = unknown> = (ctx: MessageContext<unknown, ContentTypes>, next: () => Promise<void> | void) => Promise<void>;
+type AgentErrorMiddleware<ContentTypes = unknown> = (error: unknown, ctx: AgentErrorContext<ContentTypes>, next: (err?: unknown) => Promise<void> | void) => Promise<void> | void;
+type AgentStreamingOptions = Omit<StreamOptions, "onValue" | "onError">;
+type StreamAllMessagesOptions<ContentTypes> = Parameters<Client<ContentTypes>["conversations"]["streamAllMessages"]>[0];
+type AgentErrorRegistrar<ContentTypes> = {
+    use(...errorMiddleware: Array<AgentErrorMiddleware<ContentTypes> | AgentErrorMiddleware<ContentTypes>[]>): AgentErrorRegistrar<ContentTypes>;
+};
+declare class Agent<ContentTypes = unknown> extends EventEmitter<EventHandlerMap<ContentTypes>> {
+    #private;
+    constructor({ client }: AgentOptions<ContentTypes>);
+    static create<ContentCodecs extends ContentCodec[] = []>(signer: Parameters<typeof Client.create>[0], options?: Omit<ClientOptions, "codecs"> & {
+        codecs?: ContentCodecs;
+    }): Promise<Agent<_xmtp_node_sdk.ExtractCodecContentTypes<ContentCodecs>>>;
+    static createFromEnv<ContentCodecs extends ContentCodec[] = []>(options?: Omit<ClientOptions, "codecs"> & {
+        codecs?: ContentCodecs;
+    }): Promise<Agent<_xmtp_node_sdk.ExtractCodecContentTypes<ContentCodecs>>>;
+    get libxmtpVersion(): string | undefined;
+    use(...middleware: Array<AgentMiddleware<ContentTypes> | AgentMiddleware<ContentTypes>[]>): this;
+    start(options?: AgentStreamingOptions): Promise<void>;
+    get client(): Client<ContentTypes>;
+    get errors(): AgentErrorRegistrar<ContentTypes>;
+    stop(): Promise<void>;
+    createDmWithAddress(address: EthAddress, options?: CreateDmOptions): Promise<Dm<ContentTypes>>;
+    createGroupWithAddresses(addresses: EthAddress[], options?: CreateGroupOptions): Promise<Group<ContentTypes>>;
+    addMembersWithAddresses<ContentTypes>(group: Group<ContentTypes>, addresses: EthAddress[]): Promise<void>;
+    getConversationContext(conversationId: string): Promise<ConversationContext<ContentTypes, Dm<ContentTypes> | Group<ContentTypes>> | undefined>;
+    get address(): string | undefined;
+}
+
+declare class AgentError extends Error {
+    #private;
+    constructor(code: number, message: string, cause?: unknown);
+    get code(): number;
+}
+declare class AgentStreamingError extends AgentError {
+}
+
+export { Agent, AgentError, AgentStreamingError, ClientContext, ConversationContext, MessageContext, f, filter };
+export type { AgentBaseContext, AgentErrorContext, AgentErrorMiddleware, AgentErrorRegistrar, AgentMessageHandler, AgentMiddleware, AgentOptions, AgentStreamingOptions, DecodedMessageWithContent, MessageContextParams, StreamAllMessagesOptions };