7c240a2b58
* fix(discord): avoid unnecessary message fetches in reaction notifications * style(discord): format reaction listener for CI * feat(discord): add reaction status machine and fix tool/final wiring * fix(discord): harden reaction status transitions and cleanup * revert(discord): restore status-machine flow from 0a5a72204 * fix(auto-reply): restore lifecycle callback forwarding for channels * chore(ci): add daily upstream sync workflow for custom branch * fix(discord): non-blocking reactions and robust cleanup * chore: remove unrelated workflow from Discord-only PR * Discord: streamline reaction handling * Docs: add Discord reaction changelog --------- Co-authored-by: Shadow <hi@shadowing.dev>
72 lines
3.2 KiB
TypeScript
72 lines
3.2 KiB
TypeScript
import type { ImageContent } from "@mariozechner/pi-ai";
|
|
import type { TypingController } from "./reply/typing.js";
|
|
|
|
export type BlockReplyContext = {
|
|
abortSignal?: AbortSignal;
|
|
timeoutMs?: number;
|
|
};
|
|
|
|
/** Context passed to onModelSelected callback with actual model used. */
|
|
export type ModelSelectedContext = {
|
|
provider: string;
|
|
model: string;
|
|
thinkLevel: string | undefined;
|
|
};
|
|
|
|
export type GetReplyOptions = {
|
|
/** Override run id for agent events (defaults to random UUID). */
|
|
runId?: string;
|
|
/** Abort signal for the underlying agent run. */
|
|
abortSignal?: AbortSignal;
|
|
/** Optional inbound images (used for webchat attachments). */
|
|
images?: ImageContent[];
|
|
/** Notifies when an agent run actually starts (useful for webchat command handling). */
|
|
onAgentRunStart?: (runId: string) => void;
|
|
onReplyStart?: () => Promise<void> | void;
|
|
/** Called when the typing controller cleans up (e.g., run ended with NO_REPLY). */
|
|
onTypingCleanup?: () => void;
|
|
onTypingController?: (typing: TypingController) => void;
|
|
isHeartbeat?: boolean;
|
|
/** Resolved heartbeat model override (provider/model string from merged per-agent config). */
|
|
heartbeatModelOverride?: string;
|
|
/** If true, suppress tool error warning payloads for this run. */
|
|
suppressToolErrorWarnings?: boolean;
|
|
onPartialReply?: (payload: ReplyPayload) => Promise<void> | void;
|
|
onReasoningStream?: (payload: ReplyPayload) => Promise<void> | void;
|
|
/** Called when a thinking/reasoning block ends. */
|
|
onReasoningEnd?: () => Promise<void> | void;
|
|
/** Called when a new assistant message starts (e.g., after tool call or thinking block). */
|
|
onAssistantMessageStart?: () => Promise<void> | void;
|
|
onBlockReply?: (payload: ReplyPayload, context?: BlockReplyContext) => Promise<void> | void;
|
|
onToolResult?: (payload: ReplyPayload) => Promise<void> | void;
|
|
/** Called when a tool phase starts/updates, before summary payloads are emitted. */
|
|
onToolStart?: (payload: { name?: string; phase?: string }) => Promise<void> | void;
|
|
/** Called when the actual model is selected (including after fallback).
|
|
* Use this to get model/provider/thinkLevel for responsePrefix template interpolation. */
|
|
onModelSelected?: (ctx: ModelSelectedContext) => void;
|
|
disableBlockStreaming?: boolean;
|
|
/** Timeout for block reply delivery (ms). */
|
|
blockReplyTimeoutMs?: number;
|
|
/** If provided, only load these skills for this session (empty = no skills). */
|
|
skillFilter?: string[];
|
|
/** Mutable ref to track if a reply was sent (for Slack "first" threading mode). */
|
|
hasRepliedRef?: { value: boolean };
|
|
/** Override agent timeout in seconds (0 = no timeout). Threads through to resolveAgentTimeoutMs. */
|
|
timeoutOverrideSeconds?: number;
|
|
};
|
|
|
|
export type ReplyPayload = {
|
|
text?: string;
|
|
mediaUrl?: string;
|
|
mediaUrls?: string[];
|
|
replyToId?: string;
|
|
replyToTag?: boolean;
|
|
/** True when [[reply_to_current]] was present but not yet mapped to a message id. */
|
|
replyToCurrent?: boolean;
|
|
/** Send audio as voice message (bubble) instead of audio file. Defaults to false. */
|
|
audioAsVoice?: boolean;
|
|
isError?: boolean;
|
|
/** Channel-specific payload data (per-channel envelope). */
|
|
channelData?: Record<string, unknown>;
|
|
};
|