@friendlyrobot/discord-pi-agent 0.14.1 → 0.16.0

package/README.md

@@ -1,6 +1,6 @@
 # @friendlyrobot/discord-pi-agent
 
-Reusable Discord gateway bridge for persistent pi agent sessions — DM and forum channels.
+Reusable Discord gateway for persistent pi agent sessions — DM and forum channels.
 
 ## What it does
 

package/dist/agent-service.d.ts

@@ -1,6 +1,6 @@
 import { type AgentSession } from "@earendil-works/pi-coding-agent";
 import type { Model } from "@earendil-works/pi-ai";
-import type { AgentStatus, ResolvedDiscordPiBridgeConfig, ThinkingLevel } from "./types";
+import type { AgentStatus, ResolvedDiscordGatewayConfig, ThinkingLevel } from "./types";
 export declare class AgentService {
     private readonly config;
     private readonly authStorage;
@@ -8,7 +8,7 @@ export declare class AgentService {
     private readonly settingsManager;
     private readonly resourceLoader;
     private session;
-    constructor(config: ResolvedDiscordPiBridgeConfig);
+    constructor(config: ResolvedDiscordGatewayConfig);
     initialize(): Promise<void>;
     getSession(): AgentSession | null;
     getAgentDir(): string;

package/dist/commands.d.ts

@@ -12,4 +12,4 @@ export type CommandContext = {
     promptQueue: PromptQueue;
     session?: AgentSession;
 };
-export declare function handleCommand(input: string, ctx: CommandContext): Promise<CommandResult>;
+export declare function executeCommand(input: string, context: CommandContext): Promise<CommandResult>;

package/dist/commands.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/config.d.ts

@@ -1,10 +1,3 @@
-import type { DiscordGatewayConfig, DiscordPiBridgeConfig, ResolvedDiscordGatewayConfig, ResolvedDiscordPiBridgeConfig } from "./types";
-export declare function resolveConfig(config: DiscordPiBridgeConfig): ResolvedDiscordPiBridgeConfig;
-export declare function loadDiscordPiBridgeConfigFromEnv(overrides?: Partial<DiscordPiBridgeConfig>): ResolvedDiscordPiBridgeConfig;
-/**
- * Load gateway config from env vars + overrides.
- * Preserves gateway-specific fields (forum channels, etc.) that
- * loadDiscordPiBridgeConfigFromEnv would drop.
- */
+import type { DiscordGatewayConfig, ResolvedDiscordGatewayConfig } from "./types";
+export declare function resolveConfig(config: DiscordGatewayConfig): ResolvedDiscordGatewayConfig;
 export declare function loadDiscordGatewayConfigFromEnv(overrides?: Partial<DiscordGatewayConfig>): ResolvedDiscordGatewayConfig;
-export declare function resolveGatewayConfig(config: DiscordGatewayConfig): ResolvedDiscordGatewayConfig;

package/dist/discord-attachments.d.ts

@@ -0,0 +1,19 @@
+import type { Message } from "discord.js";
+export type TextAttachmentContent = {
+    filename: string;
+    content: string;
+};
+export type MediaAttachmentContent = {
+    filename: string;
+    data: string;
+    mimeType: string;
+};
+export declare function isSupportedTextAttachment(attachment: {
+    name: string | null;
+}): boolean;
+export declare function isSupportedMediaAttachment(attachment: {
+    name: string | null;
+    contentType: string | null;
+}): boolean;
+export declare function readTextAttachments(message: Message): Promise<TextAttachmentContent[]>;
+export declare function readMediaAttachments(message: Message): Promise<MediaAttachmentContent[]>;

package/dist/discord-attachments.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/discord-auth.d.ts

@@ -0,0 +1,9 @@
+import { type Message } from "discord.js";
+import type { GatewayAuthConfig } from "./discord-gateway-client";
+export declare function getAuthorDisplayName(message: Message): string;
+/**
+ * Determine the session scope from an incoming message.
+ * Returns null for unsupported channel types (silently ignored).
+ */
+export declare function resolveMessageScope(message: Message): string | null;
+export declare function isAuthorizedMessage(message: Message, scope: string, authConfig: GatewayAuthConfig): boolean;

package/dist/discord-auth.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/discord-gateway-client.d.ts

@@ -1,11 +1,11 @@
 import { Client } from "discord.js";
 import type { AgentService } from "./agent-service";
 import type { SessionRegistry } from "./session-registry";
-import type { ResolvedDiscordPiBridgeConfig } from "./types";
+import type { ResolvedDiscordGatewayConfig } from "./types";
 export type GatewayAuthConfig = {
     discordAllowedUserId: string;
     discordAllowedForumChannelIds: string[];
     discordAllowedUserIds: string[];
     startupMessage: string | false;
 };
-export declare function startGatewayClient(config: ResolvedDiscordPiBridgeConfig, agentService: AgentService, sessionRegistry: SessionRegistry, authConfig: GatewayAuthConfig): Promise<Client>;
+export declare function startGatewayClient(config: ResolvedDiscordGatewayConfig, agentService: AgentService, sessionRegistry: SessionRegistry, authConfig: GatewayAuthConfig): Promise<Client>;

package/dist/discord-media-resolution.d.ts

@@ -0,0 +1,17 @@
+import type { ImageContent, Model } from "@earendil-works/pi-ai";
+import type { AgentService } from "./agent-service";
+import type { MediaAttachmentContent } from "./discord-attachments";
+import type { ResolvedDiscordGatewayConfig } from "./types";
+export type ResolvedPromptMedia = {
+    content: string;
+    images: ImageContent[];
+};
+/**
+ * Parse a "provider/modelId" string, handling model IDs that contain slashes.
+ */
+export declare function parseProviderModelId(value: string): {
+    provider: string;
+    modelId: string;
+} | null;
+export declare function getMediaAttachmentLabel(filename: string, mimeType: string): string;
+export declare function resolveMediaAttachmentsForPrompt(mediaAttachments: MediaAttachmentContent[], content: string, currentModel: Model<any> | undefined, config: ResolvedDiscordGatewayConfig, agentService: AgentService): Promise<ResolvedPromptMedia>;

package/dist/discord-media-resolution.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/discord-message-handler.d.ts

@@ -0,0 +1,6 @@
+import type { Message } from "discord.js";
+import type { AgentService } from "./agent-service";
+import type { SessionRegistry } from "./session-registry";
+import type { ResolvedDiscordGatewayConfig } from "./types";
+import type { GatewayAuthConfig } from "./discord-gateway-client";
+export declare function handleDiscordMessage(message: Message, config: ResolvedDiscordGatewayConfig, agentService: AgentService, sessionRegistry: SessionRegistry, authConfig: GatewayAuthConfig): Promise<void>;

package/dist/discord-replies.d.ts

@@ -0,0 +1,4 @@
+import type { Message } from "discord.js";
+export declare function addWorkingReaction(message: Message): Promise<void>;
+export declare function removeWorkingReaction(message: Message): Promise<void>;
+export declare function sendReply(message: Message, text: string): Promise<void>;

package/dist/discord-typing.d.ts

@@ -0,0 +1,4 @@
+import type { SendableChannels } from "discord.js";
+export declare function sendTypingSafe(channel: SendableChannels, channelKey: string): Promise<void>;
+export declare function startTypingForChannel(channel: SendableChannels, channelKey: string): void;
+export declare function stopTypingForChannel(channelKey: string): void;

package/dist/image-description.d.ts

@@ -8,4 +8,4 @@ import type { AgentService } from "./agent-service";
  * Creates a temporary in-memory session, sends the media, extracts the
  * assistant's text reply, then disposes the session.
  */
-export declare function describeImage(agentService: AgentService, imageData: string, mimeType: string, userText: string, visionModel: Model<any>): Promise<string>;
+export declare function describeMediaAttachment(agentService: AgentService, imageData: string, mimeType: string, userText: string, visionModel: Model<any>): Promise<string>;

package/dist/index.d.ts

@@ -1,13 +1,9 @@
-import type { DiscordGateway, DiscordGatewayConfig, DiscordPiBridge, DiscordPiBridgeConfig } from "./types";
+import type { DiscordGateway, DiscordGatewayConfig } from "./types";
 export { buildDiscordMessageContextPrompt, formatDiscordPromptTime, type DiscordMessageContextPromptOptions, type DiscordPromptScope, type DiscordPromptTimeFormatOptions, } from "./prompt-context";
-export { loadDiscordPiBridgeConfigFromEnv, loadDiscordGatewayConfigFromEnv, resolveConfig, } from "./config";
-export type { AgentStatus, DiscordGateway, DiscordGatewayConfig, DiscordPiBridge, DiscordPiBridgeConfig, PromptTransform, ResolvedDiscordPiBridgeConfig, } from "./types";
+export { loadDiscordGatewayConfigFromEnv, resolveConfig } from "./config";
+export type { AgentStatus, DiscordGateway, DiscordGatewayConfig, PromptTransform, ResolvedDiscordGatewayConfig, } from "./types";
 /**
  * Start the unified Discord gateway. Supports DM and forum thread sessions
  * out of the box. Set discordAllowedForumChannelIds to enable forum support.
  */
 export declare function startDiscordGateway(config: DiscordGatewayConfig): Promise<DiscordGateway>;
-/**
- * Legacy DM-only entry point. Now a thin wrapper over startDiscordGateway.
- */
-export declare function startDiscordPiBridge(config: DiscordPiBridgeConfig): Promise<DiscordPiBridge>;