@symerian/symi 2.5.8 → 2.6.1

package/dist/plugin-sdk/agents/unified-runner.d.ts

@@ -14,11 +14,16 @@
  * @module
  */
 import type { ImageContent } from "@mariozechner/pi-ai";
-import type { ReasoningLevel, ThinkLevel } from "../auto-reply/thinking.js";
+import type { ReasoningLevel, ThinkLevel, VerboseLevel } from "../auto-reply/thinking.js";
+import type { AgentStreamParams } from "../commands/agent/types.js";
 import type { SymiConfig } from "../config/config.js";
 import type { ModelProfile } from "../config/model-profiles.js";
+import type { ExecElevatedDefaults, ExecToolDefaults } from "./bash-tools.exec-types.js";
+import type { BlockReplyChunking } from "./pi-embedded-block-chunker.js";
+import type { BlockReplyPayload } from "./pi-embedded-payloads.js";
 import type { ClientToolDefinition } from "./pi-embedded-runner/run/params.js";
 import type { EmbeddedPiRunResult } from "./pi-embedded-runner/types.js";
+import type { ToolResultFormat } from "./pi-embedded-subscribe.types.js";
 import type { SkillSnapshot } from "./skills.js";
 export interface AgentTurnParams {
     sessionId: string;
@@ -42,6 +47,40 @@ export interface AgentTurnParams {
     reasoningLevel?: ReasoningLevel;
     timeoutMs: number;
     abortSignal?: AbortSignal;
+    /** Fallback models to try if primary fails. Runner handles rotation. */
+    fallbackModels?: string[];
+    /** Post-run hooks (verification, memory flush). Run after main turn completes. */
+    postRunHooks?: PostRunHook[];
+    /** Execution lane for concurrency control (e.g. "cron", "voice"). */
+    lane?: string;
+    /** Tool result format (markdown or plain, based on channel). */
+    toolResultFormat?: ToolResultFormat;
+    /** Verbose level for logging/diagnostics. */
+    verboseLevel?: VerboseLevel;
+    /** Owner phone numbers for owner-only tools. */
+    ownerNumbers?: string[];
+    /** Enforce final tag on reasoning output. */
+    enforceFinalTag?: boolean;
+    /** Exec tool overrides (host, security, ask, node). */
+    execOverrides?: Pick<ExecToolDefaults, "host" | "security" | "ask" | "node">;
+    /** Bash elevated mode defaults. */
+    bashElevated?: ExecElevatedDefaults;
+    /** Suppress tool error warning payloads. */
+    suppressToolErrorWarnings?: boolean;
+    /** Provider stream params override (temperature, maxTokens). */
+    streamParams?: AgentStreamParams;
+    /** Block reply break mode (text_end or message_end). */
+    blockReplyBreak?: "text_end" | "message_end";
+    /** Block reply chunking configuration. */
+    blockReplyChunking?: BlockReplyChunking;
+    /** Require explicit message tool targets (no implicit sends). */
+    requireExplicitMessageTarget?: boolean;
+    /** Omit the message tool from the tool list. */
+    disableMessageTool?: boolean;
+    /** Symipulse inactivity timeout in milliseconds. */
+    symipulseMs?: number;
+    /** Retry once on transient HTTP errors (502/521) with 2.5s delay. */
+    retryOnTransientError?: boolean;
     channel?: ChannelContext;
     callbacks?: AgentTurnCallbacks;
 }
@@ -87,6 +126,23 @@ export interface AgentTurnCallbacks {
         stream: string;
         data: Record<string, unknown>;
     }) => void;
+    /** Block streaming: called with chunk text when a block break is reached. */
+    onBlockReply?: (payload: BlockReplyPayload & {
+        isFinal: boolean;
+    }) => void | Promise<void>;
+    /** Block streaming: flush pending buffer (e.g. before tool execution). */
+    onBlockReplyFlush?: () => void | Promise<void>;
+    /** Typing: signal that the agent is actively working. */
+    onTypingStart?: () => void | Promise<void>;
+    /** Typing: signal that the agent has paused/completed. */
+    onTypingStop?: () => void | Promise<void>;
+    /** Compaction: context window was compressed. */
+    onCompaction?: (result: {
+        tokensBefore: number;
+        tokensAfter: number;
+    }) => void | Promise<void>;
+    /** Model fallback: primary model failed, trying fallback. */
+    onFallback?: (from: string, to: string, reason: string) => void | Promise<void>;
 }
 export interface ResponseMetadata {
     provider: string;
@@ -111,6 +167,18 @@ export interface AgentTurnResult {
     /** The raw result from the internal runner (for callers that need full detail). */
     rawResult: EmbeddedPiRunResult;
 }
+/**
+ * Post-run hook — runs after the main agent turn completes.
+ * Used for verification prompts, memory flush, and other post-processing.
+ */
+export interface PostRunHook {
+    /** Hook name for logging. */
+    name: string;
+    /** Whether this hook should run given the turn result. */
+    shouldRun: (result: AgentTurnResult) => boolean;
+    /** The hook body — receives the turn result and original params. */
+    execute: (result: AgentTurnResult, params: AgentTurnParams) => Promise<void>;
+}
 /**
  * Execute a single agent turn.  This is the unified entry point.
  *

package/dist/plugin-sdk/auto-reply/reply/agent-runner-execution.d.ts

@@ -1,4 +1,4 @@
-import { runEmbeddedPiAgent } from "../../agents/pi-embedded.js";
+import type { EmbeddedPiRunResult } from "../../agents/pi-embedded-runner/types.js";
 import { type SessionEntry } from "../../config/sessions.js";
 import type { TemplateContext } from "../templating.js";
 import type { VerboseLevel } from "../thinking.js";
@@ -17,7 +17,7 @@ export type RuntimeFallbackAttempt = {
 export type AgentRunLoopResult = {
     kind: "success";
     runId: string;
-    runResult: Awaited<ReturnType<typeof runEmbeddedPiAgent>>;
+    runResult: EmbeddedPiRunResult;
     fallbackProvider?: string;
     fallbackModel?: string;
     fallbackAttempts: RuntimeFallbackAttempt[];

package/dist/plugin-sdk/{channel-web-DKo2tOO-.js → channel-web-DPyyTvFo.js}

@@ -1,6 +1,6 @@
 import { a as buildGroupHistoryKey, n as DEFAULT_MAIN_KEY, r as buildAgentMainSessionKey, s as normalizeAgentId } from "./session-key-C_0eELjb.js";
 import { f as readWebSelfId, o as getWebAuthAgeMs, r as resolveWhatsAppAccount } from "./accounts-D9zGZU5t.js";
-import { E as enqueueSystemEvent, G as resolveMentionGating, W as shouldAckReactionForWhatsApp, X as buildHistoryContextFromEntries, Y as DEFAULT_GROUP_HISTORY_LIMIT, _ as resolveEnvelopeFormatOptions, c as computeBackoff, d as formatDurationPrecise, f as dispatchReplyWithBufferedBlockDispatcher, g as formatInboundEnvelope, h as resolveInboundDebounceMs, ht as createDedupeCache, l as sleepWithAbort, m as createInboundDebouncer, n as normalizeGroupActivation, nt as buildMentionRegexes, r as parseActivationCommand, rt as normalizeMentionText, t as getReplyFromConfig, tt as recordPendingHistoryEntryIfEnabled, u as buildPairingReply, v as hasControlCommand, y as shouldComputeCommandAuthorized } from "./reply-Ch4_18FZ.js";
+import { E as enqueueSystemEvent, G as resolveMentionGating, W as shouldAckReactionForWhatsApp, X as buildHistoryContextFromEntries, Y as DEFAULT_GROUP_HISTORY_LIMIT, _ as resolveEnvelopeFormatOptions, c as computeBackoff, d as formatDurationPrecise, f as dispatchReplyWithBufferedBlockDispatcher, g as formatInboundEnvelope, h as resolveInboundDebounceMs, ht as createDedupeCache, l as sleepWithAbort, m as createInboundDebouncer, n as normalizeGroupActivation, nt as buildMentionRegexes, r as parseActivationCommand, rt as normalizeMentionText, t as getReplyFromConfig, tt as recordPendingHistoryEntryIfEnabled, u as buildPairingReply, v as hasControlCommand, y as shouldComputeCommandAuthorized } from "./reply-QAcAd9ev.js";
 import { A as normalizeE164, B as toWhatsappJid, K as logVerbose, N as resolveJidToE164, O as isSelfChatMode, R as sleep, Y as shouldLogVerbose, k as jidToE164, s as normalizeChatChannelId, tt as getChildLogger, x as clamp } from "./registry--_pGht6S.js";
 import { n as loadConfig } from "./config-DDkdiUOR.js";
 import { i as defaultRuntime, t as createSubsystemLogger } from "./subsystem-Coz2AgU8.js";

package/dist/plugin-sdk/config/model-profiles.d.ts

@@ -22,6 +22,8 @@ export interface ModelProfileFilters {
     suppressMonologue: boolean;
     /** If true, the model produces structured thinking blocks (Claude-style). */
     hasStructuredThinking: boolean;
+    /** If true, validate tool arguments (exec commands) before execution. Default false. */
+    validateToolArgs?: boolean;
 }
 export interface ModelProfileUi {
     /** Badge text shown next to model name in Glass UI header. */

package/dist/plugin-sdk/index.js

@@ -1,6 +1,6 @@
 import { f as DEFAULT_ACCOUNT_ID, p as normalizeAccountId } from "./session-key-C_0eELjb.js";
 import { _ as createAccountListHelpers, i as resolveWhatsAppAuthDir, n as resolveDefaultWhatsAppAccountId, r as resolveWhatsAppAccount, t as listWhatsAppAccountIds } from "./accounts-D9zGZU5t.js";
-import { $ as clearHistoryEntriesIfEnabled, A as resolveDiscordUserAllowlist, B as logTypingFailure, C as stripMarkdown, Ct as unbindThreadBindingsBySessionKey, D as resolveSlackUserAllowlist, Dt as BLUEBUBBLES_ACTION_NAMES, Et as BLUEBUBBLES_ACTIONS, F as stringEnum, G as resolveMentionGating, H as removeAckReactionAfterReply, I as recordInboundSession, J as summarizeMapping, K as resolveMentionGatingWithBypass, L as resolveControlCommandGate, M as collectDiscordAuditChannelIds, N as formatDocsLink, O as resolveSlackChannelAllowlist, Ot as BLUEBUBBLES_GROUP_ACTIONS, P as optionalStringEnum, Q as clearHistoryEntries, R as logAckFailure, S as processLineMessage, St as listThreadBindingsBySessionKey, T as attachFooterText, Tt as resolveAllowlistMatchSimple, U as shouldAckReaction, V as createTypingCallbacks, W as shouldAckReactionForWhatsApp, Y as DEFAULT_GROUP_HISTORY_LIMIT, Z as buildPendingHistoryContextFromMap, _t as listDevicePairing, a as normalizeAccountId$1, at as isWSLEnv, bt as registerPluginHttpRoute, ct as DEFAULT_WEBHOOK_MAX_BODY_BYTES, dt as isRequestBodyLimitError, et as recordPendingHistoryEntry, ft as readJsonBodyWithLimit, gt as approveDevicePairing, ht as createDedupeCache, i as listLineAccountIds, it as isWSL2Sync, j as resolveDiscordChannelAllowlist, k as detectBinary, kt as CHANNEL_MESSAGE_ACTION_NAMES, lt as RequestBodyLimitError, mt as requestBodyErrorToText, o as resolveDefaultLineAccountId, ot as isWSLSync, pt as readRequestBodyWithLimit, q as mergeAllowlist, s as resolveLineAccount, st as DEFAULT_WEBHOOK_BODY_TIMEOUT_MS, tt as recordPendingHistoryEntryIfEnabled, ut as installRequestBodyLimitGuard, vt as rejectDevicePairing, w as createReceiptCard, wt as formatAllowlistMatchMeta, x as hasMarkdownToConvert, xt as autoBindSpawnedDiscordSubagent, yt as extractToolSend, z as logInboundDrop } from "./reply-Ch4_18FZ.js";
+import { $ as clearHistoryEntriesIfEnabled, A as resolveDiscordUserAllowlist, B as logTypingFailure, C as stripMarkdown, Ct as unbindThreadBindingsBySessionKey, D as resolveSlackUserAllowlist, Dt as BLUEBUBBLES_ACTION_NAMES, Et as BLUEBUBBLES_ACTIONS, F as stringEnum, G as resolveMentionGating, H as removeAckReactionAfterReply, I as recordInboundSession, J as summarizeMapping, K as resolveMentionGatingWithBypass, L as resolveControlCommandGate, M as collectDiscordAuditChannelIds, N as formatDocsLink, O as resolveSlackChannelAllowlist, Ot as BLUEBUBBLES_GROUP_ACTIONS, P as optionalStringEnum, Q as clearHistoryEntries, R as logAckFailure, S as processLineMessage, St as listThreadBindingsBySessionKey, T as attachFooterText, Tt as resolveAllowlistMatchSimple, U as shouldAckReaction, V as createTypingCallbacks, W as shouldAckReactionForWhatsApp, Y as DEFAULT_GROUP_HISTORY_LIMIT, Z as buildPendingHistoryContextFromMap, _t as listDevicePairing, a as normalizeAccountId$1, at as isWSLEnv, bt as registerPluginHttpRoute, ct as DEFAULT_WEBHOOK_MAX_BODY_BYTES, dt as isRequestBodyLimitError, et as recordPendingHistoryEntry, ft as readJsonBodyWithLimit, gt as approveDevicePairing, ht as createDedupeCache, i as listLineAccountIds, it as isWSL2Sync, j as resolveDiscordChannelAllowlist, k as detectBinary, kt as CHANNEL_MESSAGE_ACTION_NAMES, lt as RequestBodyLimitError, mt as requestBodyErrorToText, o as resolveDefaultLineAccountId, ot as isWSLSync, pt as readRequestBodyWithLimit, q as mergeAllowlist, s as resolveLineAccount, st as DEFAULT_WEBHOOK_BODY_TIMEOUT_MS, tt as recordPendingHistoryEntryIfEnabled, ut as installRequestBodyLimitGuard, vt as rejectDevicePairing, w as createReceiptCard, wt as formatAllowlistMatchMeta, x as hasMarkdownToConvert, xt as autoBindSpawnedDiscordSubagent, yt as extractToolSend, z as logInboundDrop } from "./reply-QAcAd9ev.js";
 import "./paths-DR2yt_mP.js";
 import "./github-copilot-token-D9X2phUj.js";
 import { D as resolveSlackAccount, E as resolveDefaultSlackAccountId, F as resolveDiscordAccount, M as listDiscordAccountIds, O as resolveSlackReplyToMode, P as resolveDefaultDiscordAccountId, S as resolveTelegramAccount, T as listSlackAccountIds, _ as normalizeWhatsAppTarget, a as listDiscordDirectoryPeersFromConfig, b as listTelegramAccountIds, c as listTelegramDirectoryGroupsFromConfig, d as listWhatsAppDirectoryPeersFromConfig, f as looksLikeSlackTargetId, g as isWhatsAppGroupJid, i as listDiscordDirectoryGroupsFromConfig, l as listTelegramDirectoryPeersFromConfig, o as listSlackDirectoryGroupsFromConfig, p as normalizeSlackMessagingTarget, s as listSlackDirectoryPeersFromConfig, u as listWhatsAppDirectoryGroupsFromConfig, w as listEnabledSlackAccounts, x as resolveDefaultTelegramAccountId } from "./plugins-BbAvhC25.js";
@@ -47,7 +47,7 @@ import "./paths-A0xdf3yk.js";
 import { h as onDiagnosticEvent, m as isDiagnosticsEnabled, p as emitDiagnosticEvent } from "./diagnostic-mFf4i4G9.js";
 import { n as extractOriginalFilename } from "./store-Do3t33-c.js";
 import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-BkCUbYGV.js";
-import { r as resolveWhatsAppHeartbeatRecipients } from "./channel-web-DKo2tOO-.js";
+import { r as resolveWhatsAppHeartbeatRecipients } from "./channel-web-DPyyTvFo.js";
 import "./image-BOYy0Ump.js";
 import "./pi-model-discovery-LbcEa65a.js";
 import "./api-key-rotation-CVBMpnPc.js";

package/dist/plugin-sdk/infra/diagnostic-events.d.ts

@@ -126,7 +126,7 @@ export type DiagnosticToolLoopEvent = DiagnosticBaseEvent & {
     toolName: string;
     level: "warning" | "critical";
     action: "warn" | "block";
-    detector: "generic_repeat" | "known_poll_no_progress" | "global_circuit_breaker" | "ping_pong";
+    detector: "generic_repeat" | "known_poll_no_progress" | "global_circuit_breaker" | "ping_pong" | "consecutive_failure";
     count: number;
     message: string;
     pairedToolName?: string;

package/dist/plugin-sdk/logging/diagnostic-session-state.d.ts

@@ -17,6 +17,8 @@ export type ToolCallRecord = {
     argsHash: string;
     toolCallId?: string;
     resultHash?: string;
+    /** Whether this tool call resulted in an error. Used by consecutive failure detection. */
+    isError?: boolean;
     timestamp: number;
 };
 export type SessionRef = {

package/dist/plugin-sdk/logging/diagnostic.d.ts

@@ -52,7 +52,7 @@ export declare function logToolLoopAction(params: SessionRef & {
     toolName: string;
     level: "warning" | "critical";
     action: "warn" | "block";
-    detector: "generic_repeat" | "known_poll_no_progress" | "global_circuit_breaker" | "ping_pong";
+    detector: "generic_repeat" | "known_poll_no_progress" | "global_circuit_breaker" | "ping_pong" | "consecutive_failure";
     count: number;
     message: string;
     pairedToolName?: string;