@elizaos/plugin-tlon 2.0.0-alpha.1

package/dist/actions/sendMessage.d.ts

@@ -0,0 +1,7 @@
+import type { Action } from "@elizaos/core";
+export declare const SEND_MESSAGE_ACTION = "SEND_TLON_MESSAGE";
+/**
+ * Action for sending messages via Tlon/Urbit
+ */
+export declare const sendMessageAction: Action;
+//# sourceMappingURL=sendMessage.d.ts.map

package/dist/actions/sendMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendMessage.d.ts","sourceRoot":"","sources":["../../src/actions/sendMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAQP,MAAM,eAAe,CAAC;AAKvB,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAkI/B,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Logger interface for the SSE client
+ */
+export interface TlonClientLogger {
+    log?: (message: string) => void;
+    error?: (message: string) => void;
+}
+/**
+ * Options for creating a TlonClient
+ */
+export interface TlonClientOptions {
+    /** Ship name (without ~) */
+    ship?: string;
+    /** Callback when reconnection occurs */
+    onReconnect?: (client: TlonClient) => Promise<void> | void;
+    /** Enable auto-reconnection (default: true) */
+    autoReconnect?: boolean;
+    /** Max reconnection attempts (default: 10) */
+    maxReconnectAttempts?: number;
+    /** Initial reconnect delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Maximum reconnect delay in ms (default: 30000) */
+    maxReconnectDelay?: number;
+    /** Logger instance */
+    logger?: TlonClientLogger;
+}
+/**
+ * Subscription parameters
+ */
+export interface SubscribeParams {
+    app: string;
+    path: string;
+    event?: (data: unknown) => void;
+    err?: (error: unknown) => void;
+    quit?: () => void;
+}
+/**
+ * Poke parameters
+ */
+export interface PokeParams {
+    app: string;
+    mark: string;
+    json: unknown;
+}
+/**
+ * Authenticates with an Urbit ship and returns the session cookie
+ */
+export declare function authenticate(url: string, code: string): Promise<string>;
+/**
+ * Tlon/Urbit HTTP API client with SSE support
+ */
+export declare class TlonClient {
+    readonly url: string;
+    readonly cookie: string;
+    readonly ship: string;
+    private channelId;
+    private channelUrl;
+    private subscriptions;
+    private eventHandlers;
+    private aborted;
+    private onReconnect;
+    private autoReconnect;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    private reconnectDelay;
+    private maxReconnectDelay;
+    private _isConnected;
+    private clientLogger;
+    constructor(url: string, cookie: string, options?: TlonClientOptions);
+    /** Whether the client is currently connected */
+    get isConnected(): boolean;
+    private generateChannelId;
+    private resolveShipFromUrl;
+    /**
+     * Subscribe to an app's path for updates
+     */
+    subscribe(params: SubscribeParams): Promise<number>;
+    private sendSubscription;
+    /**
+     * Connect to the Urbit ship and start receiving events
+     */
+    connect(): Promise<void>;
+    private openStream;
+    private processStream;
+    private processEvent;
+    /**
+     * Send a poke to an app
+     */
+    poke(params: PokeParams): Promise<number>;
+    /**
+     * Perform a scry (read-only query)
+     */
+    scry<T = unknown>(path: string): Promise<T>;
+    private attemptReconnect;
+    /**
+     * Close the connection and cleanup
+     */
+    close(): Promise<void>;
+}
+/**
+ * Helper to create and authenticate a TlonClient
+ */
+export declare function createTlonClient(url: string, code: string, options?: TlonClientOptions): Promise<TlonClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/constants.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Service name for the Tlon plugin
+ */
+export declare const TLON_SERVICE_NAME = "tlon";
+/**
+ * Plugin name
+ */
+export declare const PLUGIN_NAME = "tlon";
+/**
+ * Plugin version
+ */
+export declare const PLUGIN_VERSION = "2.0.0-alpha.1";
+/**
+ * Plugin description
+ */
+export declare const PLUGIN_DESCRIPTION = "Tlon/Urbit integration for elizaOS agents";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,kBAAkB,8CAA8C,CAAC"}

package/dist/environment.d.ts

@@ -0,0 +1,79 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import { z } from "zod";
+/**
+ * Schema for validating Tlon environment configuration
+ */
+export declare const tlonEnvSchema: z.ZodObject<{
+    TLON_SHIP: z.ZodString;
+    TLON_URL: z.ZodString;
+    TLON_CODE: z.ZodString;
+    TLON_ENABLED: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    TLON_GROUP_CHANNELS: z.ZodOptional<z.ZodString>;
+    TLON_DM_ALLOWLIST: z.ZodOptional<z.ZodString>;
+    TLON_AUTO_DISCOVER_CHANNELS: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    TLON_SHIP: string;
+    TLON_URL: string;
+    TLON_CODE: string;
+    TLON_ENABLED: boolean;
+    TLON_AUTO_DISCOVER_CHANNELS: boolean;
+    TLON_GROUP_CHANNELS?: string | undefined;
+    TLON_DM_ALLOWLIST?: string | undefined;
+}, {
+    TLON_SHIP: string;
+    TLON_URL: string;
+    TLON_CODE: string;
+    TLON_ENABLED?: boolean | undefined;
+    TLON_GROUP_CHANNELS?: string | undefined;
+    TLON_DM_ALLOWLIST?: string | undefined;
+    TLON_AUTO_DISCOVER_CHANNELS?: boolean | undefined;
+}>;
+export type TlonEnvConfig = z.infer<typeof tlonEnvSchema>;
+/**
+ * Parsed and validated Tlon settings
+ */
+export interface TlonSettings {
+    /** Ship name (normalized without ~) */
+    ship: string;
+    /** Urbit HTTP API URL */
+    url: string;
+    /** Authentication code */
+    code: string;
+    /** Whether the plugin is enabled */
+    enabled: boolean;
+    /** Group channels to monitor */
+    groupChannels: string[];
+    /** Ships allowed to send DMs */
+    dmAllowlist: string[];
+    /** Auto-discover channels */
+    autoDiscoverChannels: boolean;
+}
+/**
+ * Normalizes a ship name by removing the ~ prefix if present
+ */
+export declare function normalizeShip(ship: string): string;
+/**
+ * Formats a ship name with the ~ prefix
+ */
+export declare function formatShip(ship: string): string;
+/**
+ * Validates and returns Tlon configuration from runtime settings
+ */
+export declare function validateTlonConfig(runtime: IAgentRuntime): Promise<TlonEnvConfig | null>;
+/**
+ * Builds TlonSettings from validated config
+ */
+export declare function buildTlonSettings(config: TlonEnvConfig): TlonSettings;
+/**
+ * Parses a channel nest string (e.g., "chat/~host/channel-name")
+ */
+export declare function parseChannelNest(nest: string): {
+    kind: string;
+    hostShip: string;
+    channelName: string;
+} | null;
+/**
+ * Builds a channel nest string from components
+ */
+export declare function buildChannelNest(kind: string, hostShip: string, channelName: string): string;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;EAQxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gCAAgC;IAChC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,6BAA6B;IAC7B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAeD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA6B/B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAUrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAYP;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import type { Plugin } from "@elizaos/core";
+import { SEND_MESSAGE_ACTION, sendMessageAction } from "./actions/sendMessage";
+import { TLON_SERVICE_NAME } from "./constants";
+import { CHAT_STATE_PROVIDER, chatStateProvider } from "./providers/chatState";
+import { TlonService } from "./service";
+/**
+ * Tlon/Urbit plugin for elizaOS
+ *
+ * Provides integration with Urbit ships via the Tlon messaging protocol.
+ * Supports:
+ * - Direct messages (DMs)
+ * - Group channels
+ * - Thread replies
+ * - Real-time SSE-based message streaming
+ * - Channel authorization
+ */
+declare const tlonPlugin: Plugin;
+export { TlonService, sendMessageAction, SEND_MESSAGE_ACTION, chatStateProvider, CHAT_STATE_PROVIDER, TLON_SERVICE_NAME, };
+export * from "./client";
+export * from "./environment";
+export * from "./types";
+export * from "./utils";
+export default tlonPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAGL,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC;;;;;;;;;;GAUG;AACH,QAAA,MAAM,UAAU,EAAE,MAOjB,CAAC;AAGF,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAClB,CAAC;AAEF,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAE9B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAExB,eAAe,UAAU,CAAC"}