Adds support for template variables in `messages.responsePrefix` that
resolve dynamically at runtime with the actual model used (including
after fallback).
Supported variables (case-insensitive):
- {model} - short model name (e.g., "claude-opus-4-5", "gpt-4o")
- {modelFull} - full model identifier (e.g., "anthropic/claude-opus-4-5")
- {provider} - provider name (e.g., "anthropic", "openai")
- {thinkingLevel} or {think} - thinking level ("high", "low", "off")
- {identity.name} or {identityName} - agent identity name
Example: "[{model} | think:{thinkingLevel}]" → "[claude-opus-4-5 | think:high]"
Variables show the actual model used after fallback, not the intended
model. Unresolved variables remain as literal text.
Implementation:
- New module: src/auto-reply/reply/response-prefix-template.ts
- Template interpolation in normalize-reply.ts via context provider
- onModelSelected callback in agent-runner-execution.ts
- Updated all 6 provider message handlers (web, signal, discord,
telegram, slack, imessage)
- 27 unit tests covering all variables and edge cases
- Documentation in docs/gateway/configuration.md and JSDoc
Fixes #923
86 lines
2.7 KiB
TypeScript
86 lines
2.7 KiB
TypeScript
import type { ClawdbotConfig, HumanDelayConfig, IdentityConfig } from "../config/config.js";
|
|
import { resolveAgentConfig } from "./agent-scope.js";
|
|
|
|
const DEFAULT_ACK_REACTION = "👀";
|
|
|
|
export function resolveAgentIdentity(
|
|
cfg: ClawdbotConfig,
|
|
agentId: string,
|
|
): IdentityConfig | undefined {
|
|
return resolveAgentConfig(cfg, agentId)?.identity;
|
|
}
|
|
|
|
export function resolveAckReaction(cfg: ClawdbotConfig, agentId: string): string {
|
|
const configured = cfg.messages?.ackReaction;
|
|
if (configured !== undefined) return configured.trim();
|
|
const emoji = resolveAgentIdentity(cfg, agentId)?.emoji?.trim();
|
|
return emoji || DEFAULT_ACK_REACTION;
|
|
}
|
|
|
|
export function resolveIdentityNamePrefix(
|
|
cfg: ClawdbotConfig,
|
|
agentId: string,
|
|
): string | undefined {
|
|
const name = resolveAgentIdentity(cfg, agentId)?.name?.trim();
|
|
if (!name) return undefined;
|
|
return `[${name}]`;
|
|
}
|
|
|
|
/** Returns just the identity name (without brackets) for template context. */
|
|
export function resolveIdentityName(cfg: ClawdbotConfig, agentId: string): string | undefined {
|
|
return resolveAgentIdentity(cfg, agentId)?.name?.trim() || undefined;
|
|
}
|
|
|
|
export function resolveMessagePrefix(
|
|
cfg: ClawdbotConfig,
|
|
agentId: string,
|
|
opts?: { configured?: string; hasAllowFrom?: boolean; fallback?: string },
|
|
): string {
|
|
const configured = opts?.configured ?? cfg.messages?.messagePrefix;
|
|
if (configured !== undefined) return configured;
|
|
|
|
const hasAllowFrom = opts?.hasAllowFrom === true;
|
|
if (hasAllowFrom) return "";
|
|
|
|
return resolveIdentityNamePrefix(cfg, agentId) ?? opts?.fallback ?? "[clawdbot]";
|
|
}
|
|
|
|
export function resolveResponsePrefix(cfg: ClawdbotConfig, agentId: string): string | undefined {
|
|
const configured = cfg.messages?.responsePrefix;
|
|
if (configured !== undefined) {
|
|
if (configured === "auto") {
|
|
return resolveIdentityNamePrefix(cfg, agentId);
|
|
}
|
|
return configured;
|
|
}
|
|
return undefined;
|
|
}
|
|
|
|
export function resolveEffectiveMessagesConfig(
|
|
cfg: ClawdbotConfig,
|
|
agentId: string,
|
|
opts?: { hasAllowFrom?: boolean; fallbackMessagePrefix?: string },
|
|
): { messagePrefix: string; responsePrefix?: string } {
|
|
return {
|
|
messagePrefix: resolveMessagePrefix(cfg, agentId, {
|
|
hasAllowFrom: opts?.hasAllowFrom,
|
|
fallback: opts?.fallbackMessagePrefix,
|
|
}),
|
|
responsePrefix: resolveResponsePrefix(cfg, agentId),
|
|
};
|
|
}
|
|
|
|
export function resolveHumanDelayConfig(
|
|
cfg: ClawdbotConfig,
|
|
agentId: string,
|
|
): HumanDelayConfig | undefined {
|
|
const defaults = cfg.agents?.defaults?.humanDelay;
|
|
const overrides = resolveAgentConfig(cfg, agentId)?.humanDelay;
|
|
if (!defaults && !overrides) return undefined;
|
|
return {
|
|
mode: overrides?.mode ?? defaults?.mode,
|
|
minMs: overrides?.minMs ?? defaults?.minMs,
|
|
maxMs: overrides?.maxMs ?? defaults?.maxMs,
|
|
};
|
|
}
|