mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-13 13:16:05 +00:00
111 lines
3.6 KiB
TypeScript
111 lines
3.6 KiB
TypeScript
// Lightweight ACP runtime backend helpers for startup-loaded plugins.
|
|
|
|
import { hasExplicitCommandContextText } from "../auto-reply/reply/context-text.js";
|
|
import type {
|
|
PluginHookReplyDispatchContext,
|
|
PluginHookReplyDispatchEvent,
|
|
PluginHookReplyDispatchResult,
|
|
} from "../plugins/types.js";
|
|
import { createLazyRuntimeModule } from "../shared/lazy-runtime.js";
|
|
|
|
export { AcpRuntimeError, isAcpRuntimeError } from "../acp/runtime/errors.js";
|
|
export type { AcpRuntimeErrorCode } from "../acp/runtime/errors.js";
|
|
export {
|
|
getAcpRuntimeBackend,
|
|
registerAcpRuntimeBackend,
|
|
requireAcpRuntimeBackend,
|
|
unregisterAcpRuntimeBackend,
|
|
} from "../acp/runtime/registry.js";
|
|
export type {
|
|
AcpRuntime,
|
|
AcpRuntimeCapabilities,
|
|
AcpRuntimeDoctorReport,
|
|
AcpRuntimeEnsureInput,
|
|
AcpRuntimeEvent,
|
|
AcpRuntimeHandle,
|
|
AcpRuntimeStatus,
|
|
AcpRuntimeTurn,
|
|
AcpRuntimeTurnAttachment,
|
|
AcpRuntimeTurnInput,
|
|
AcpRuntimeTurnResult,
|
|
AcpRuntimeTurnResultError,
|
|
AcpSessionUpdateTag,
|
|
} from "@openclaw/acp-core/runtime/types";
|
|
|
|
// ACP dispatch pulls in session/media/manager code; keep it lazy so
|
|
// startup-loaded plugin surfaces stay light and concurrent hooks share one load.
|
|
const loadDispatchAcpRuntime = createLazyRuntimeModule(
|
|
() => import("../auto-reply/reply/dispatch-acp.runtime.js"),
|
|
);
|
|
|
|
/**
|
|
* Dispatch a plugin reply hook through ACP when the event targets an ACP-bound session.
|
|
* Returns a handled result only when ACP consumes the reply; otherwise callers continue normal delivery.
|
|
*/
|
|
export async function tryDispatchAcpReplyHook(
|
|
event: PluginHookReplyDispatchEvent,
|
|
ctx: PluginHookReplyDispatchContext,
|
|
): Promise<PluginHookReplyDispatchResult | void> {
|
|
// Under sendPolicy: "deny", ACP-bound sessions still need their turns to flow
|
|
// through acpManager.runTurn so session state, tool calls, and memory stay
|
|
// consistent. Delivery suppression is handled by the ACP delivery path.
|
|
if (
|
|
event.sendPolicy === "deny" &&
|
|
!event.suppressUserDelivery &&
|
|
!hasExplicitCommandContextText(event.ctx) &&
|
|
!event.isTailDispatch
|
|
) {
|
|
return;
|
|
}
|
|
const runtime = await loadDispatchAcpRuntime();
|
|
const bypassForCommand = await runtime.shouldBypassAcpDispatchForCommand(event.ctx, ctx.cfg);
|
|
|
|
if (
|
|
event.sendPolicy === "deny" &&
|
|
!event.suppressUserDelivery &&
|
|
!bypassForCommand &&
|
|
!event.isTailDispatch
|
|
) {
|
|
return;
|
|
}
|
|
|
|
const result = await runtime.tryDispatchAcpReply({
|
|
ctx: event.ctx,
|
|
cfg: ctx.cfg,
|
|
dispatcher: ctx.dispatcher,
|
|
runId: event.runId,
|
|
sessionKey: event.sessionKey,
|
|
toolsAllow: event.toolsAllow,
|
|
images: event.images,
|
|
abortSignal: ctx.abortSignal,
|
|
inboundAudio: event.inboundAudio,
|
|
sessionTtsAuto: event.sessionTtsAuto,
|
|
ttsChannel: event.ttsChannel,
|
|
suppressUserDelivery: event.suppressUserDelivery,
|
|
suppressReplyLifecycle: event.suppressReplyLifecycle === true || event.sendPolicy === "deny",
|
|
sourceReplyDeliveryMode: event.sourceReplyDeliveryMode,
|
|
shouldRouteToOriginating: event.shouldRouteToOriginating,
|
|
originatingChannel: event.originatingChannel,
|
|
originatingTo: event.originatingTo,
|
|
originatingAccountId: event.originatingAccountId,
|
|
originatingThreadId: event.originatingThreadId,
|
|
originatingChatType: event.originatingChatType,
|
|
shouldSendToolSummaries: event.shouldSendToolSummaries,
|
|
shouldSendToolSummariesNow: () => event.shouldSendToolSummaries,
|
|
bypassForCommand,
|
|
onReplyStart: ctx.onReplyStart,
|
|
recordProcessed: ctx.recordProcessed,
|
|
markIdle: ctx.markIdle,
|
|
});
|
|
|
|
if (!result) {
|
|
return;
|
|
}
|
|
|
|
return {
|
|
handled: true,
|
|
queuedFinal: result.queuedFinal,
|
|
counts: result.counts,
|
|
};
|
|
}
|