@gencode/agents 0.0.4 → 0.0.5

package/dist/plugins/hooks.d.ts

@@ -1,7 +1,7 @@
 import type { AssistantMessage } from "@mariozechner/pi-ai";
 import type { AgentRunParams } from "../types.js";
 import type { MemoryChangedEvent } from "../memory/provider.js";
-export type PluginHookName = "before_model_resolve" | "before_prompt_build" | "llm_input" | "llm_output" | "before_tool_call" | "after_tool_call" | "agent_end" | "before_compaction" | "after_compaction" | "session_start" | "session_end" | "session_reset" | "memory_changed";
+export type PluginHookName = "before_model_resolve" | "before_prompt_build" | "after_prompt_build" | "llm_input" | "assistant_message_end" | "llm_output" | "before_tool_call" | "after_tool_call" | "agent_end" | "before_compaction" | "after_compaction" | "session_start" | "session_end" | "session_reset" | "memory_changed";
 export type PluginHookAgentContext = {
     agentId?: string;
     sessionId?: string;
@@ -21,12 +21,29 @@ export type PluginHookBeforePromptBuildResult = {
     systemPrompt?: string;
     prependContext?: string;
 };
+export type PluginHookAfterPromptBuildEvent = {
+    prompt: string;
+    systemPrompt: string;
+};
 export type PluginHookLlmInputEvent = {
     sessionId: string;
     model: string;
     prompt: string;
     historyMessages: unknown[];
 };
+export type PluginHookAssistantMessageEndEvent = {
+    sessionId: string;
+    model: string;
+    assistantText: string;
+    assistantMessage: AssistantMessage;
+    hasToolCalls: boolean;
+    durationMs?: number;
+    usage?: {
+        input?: number;
+        output?: number;
+        total?: number;
+    };
+};
 export type PluginHookLlmOutputEvent = {
     sessionId: string;
     model: string;
@@ -85,7 +102,9 @@ export type PluginHookMemoryChangedEvent = MemoryChangedEvent;
 export type PluginHookHandlerMap = {
     before_model_resolve: (event: PluginHookBeforeModelResolveEvent, ctx: PluginHookAgentContext) => PluginHookBeforeModelResolveResult | void | Promise<PluginHookBeforeModelResolveResult | void>;
     before_prompt_build: (event: PluginHookBeforePromptBuildEvent, ctx: PluginHookAgentContext) => PluginHookBeforePromptBuildResult | void | Promise<PluginHookBeforePromptBuildResult | void>;
+    after_prompt_build: (event: PluginHookAfterPromptBuildEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
     llm_input: (event: PluginHookLlmInputEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
+    assistant_message_end: (event: PluginHookAssistantMessageEndEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
     llm_output: (event: PluginHookLlmOutputEvent, ctx: PluginHookAgentContext) => void | Promise<void>;
     before_tool_call: (event: PluginHookBeforeToolCallEvent, ctx: PluginHookAgentContext) => PluginHookBeforeToolCallResult | void | Promise<PluginHookBeforeToolCallResult | void>;
     after_tool_call: (event: PluginHookAfterToolCallEvent, ctx: PluginHookAgentContext) => void | Promise<void>;

package/dist/plugins/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/plugins/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,MAAM,cAAc,GACtB,sBAAsB,GACtB,qBAAqB,GACrB,WAAW,GACX,YAAY,GACZ,kBAAkB,GAClB,iBAAiB,GACjB,WAAW,GACX,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,GACf,aAAa,GACb,eAAe,GACf,gBAAgB,CAAC;AAErB,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,kBAAkB,CAAC;AAE9D,MAAM,MAAM,oBAAoB,GAAG;IACjC,oBAAoB,EAAE,CACpB,KAAK,EAAE,iCAAiC,EACxC,GAAG,EAAE,sBAAsB,KACxB,kCAAkC,GAAG,IAAI,GAAG,OAAO,CAAC,kCAAkC,GAAG,IAAI,CAAC,CAAC;IACpG,mBAAmB,EAAE,CACnB,KAAK,EAAE,gCAAgC,EACvC,GAAG,EAAE,sBAAsB,KACxB,iCAAiC,GAAG,IAAI,GAAG,OAAO,CAAC,iCAAiC,GAAG,IAAI,CAAC,CAAC;IAClG,SAAS,EAAE,CACT,KAAK,EAAE,uBAAuB,EAC9B,GAAG,EAAE,sBAAsB,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,UAAU,EAAE,CACV,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,sBAAsB,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,gBAAgB,EAAE,CAChB,KAAK,EAAE,6BAA6B,EACpC,GAAG,EAAE,sBAAsB,KACxB,8BAA8B,GAAG,IAAI,GAAG,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAAC;IAC5F,eAAe,EAAE,CACf,KAAK,EAAE,4BAA4B,EACnC,GAAG,EAAE,sBAAsB,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,SAAS,EAAE,CACT,KAAK,EAAE,uBAAuB,EAC9B,GAAG,EAAE,sBAAsB,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,iBAAiB,EAAE,CACjB,KAAK,EAAE,+BAA+B,EACtC,GAAG,EAAE,sBAAsB,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,gBAAgB,EAAE,CAChB,KAAK,EAAE,8BAA8B,EACrC,GAAG,EAAE,sBAAsB,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,aAAa,EAAE,CACb,KAAK,EAAE,2BAA2B,EAClC,GAAG,EAAE,sBAAsB,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,WAAW,EAAE,CACX,KAAK,EAAE,yBAAyB,EAChC,GAAG,EAAE,sBAAsB,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,aAAa,EAAE,CACb,KAAK,EAAE,2BAA2B,EAClC,GAAG,EAAE,sBAAsB,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,cAAc,EAAE,CACd,KAAK,EAAE,4BAA4B,EACnC,GAAG,EAAE,sBAAsB,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,CAAC;IACZ,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuD;IAE7E,QAAQ,CAAC,CAAC,SAAS,cAAc,EAAE,YAAY,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,IAAI;IAO3E,QAAQ,CAAC,CAAC,SAAS,cAAc,EACrC,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC7C,GAAG,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAShE"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/plugins/hooks.ts"],"names":[],"mappings":"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"}

package/dist/plugins/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/plugins/hooks.ts"],"names":[],"mappings":"AAmLA,MAAM,OAAO,kBAAkB;IACZ,KAAK,GAAG,IAAI,GAAG,EAA4C,CAAC;IAE7E,QAAQ,CAA2B,YAAuC;QACxE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,YAAsC,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,QAAW,EACX,KAA6C,EAC7C,GAA2C;QAE3C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAwD,EAAE,CAAC;QACxE,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAO,KAAK,CAAC,OAAe,CAAC,KAAK,EAAE,GAA6B,CAAC,CAAC;YAClF,OAAO,CAAC,IAAI,CAAC,MAAsD,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/plugins/hooks.ts"],"names":[],"mappings":"AAgNA,MAAM,OAAO,kBAAkB;IACZ,KAAK,GAAG,IAAI,GAAG,EAA4C,CAAC;IAE7E,QAAQ,CAA2B,YAAuC;QACxE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,YAAsC,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,QAAW,EACX,KAA6C,EAC7C,GAA2C;QAE3C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAwD,EAAE,CAAC;QACxE,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAO,KAAK,CAAC,OAAe,CAAC,KAAK,EAAE,GAA6B,CAAC,CAAC;YAClF,OAAO,CAAC,IAAI,CAAC,MAAsD,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/plugins/index.d.ts

@@ -11,7 +11,7 @@ export { initializePluginSystem } from "./manager.js";
 export type { PluginSystem, PluginSystemOptions } from "./manager.js";
 export type { PluginRuntimeContext } from "./runtime-context.js";
 export { PluginHookRegistry } from "./hooks.js";
-export type { PluginHookName, PluginHookHandlerMap, PluginHookAgentContext, PluginHookBeforeModelResolveEvent, PluginHookBeforeModelResolveResult, PluginHookBeforePromptBuildEvent, PluginHookBeforePromptBuildResult, PluginHookLlmInputEvent, PluginHookLlmOutputEvent, PluginHookBeforeToolCallEvent, PluginHookBeforeToolCallResult, PluginHookAfterToolCallEvent, PluginHookAgentEndEvent, PluginHookBeforeCompactionEvent, PluginHookAfterCompactionEvent, PluginHookSessionStartEvent, PluginHookSessionEndEvent, PluginHookSessionResetEvent, PluginHookMemoryChangedEvent, } from "./hooks.js";
+export type { PluginHookName, PluginHookHandlerMap, PluginHookAgentContext, PluginHookBeforeModelResolveEvent, PluginHookBeforeModelResolveResult, PluginHookBeforePromptBuildEvent, PluginHookBeforePromptBuildResult, PluginHookAfterPromptBuildEvent, PluginHookLlmInputEvent, PluginHookAssistantMessageEndEvent, PluginHookLlmOutputEvent, PluginHookBeforeToolCallEvent, PluginHookBeforeToolCallResult, PluginHookAfterToolCallEvent, PluginHookAgentEndEvent, PluginHookBeforeCompactionEvent, PluginHookAfterCompactionEvent, PluginHookSessionStartEvent, PluginHookSessionEndEvent, PluginHookSessionResetEvent, PluginHookMemoryChangedEvent, } from "./hooks.js";
 export { PluginToolRegistry } from "./tools.js";
 export type { PluginToolOptions, RegisteredPluginTool } from "./tools.js";
 export { createPluginRuntime } from "./runtime.js";

package/dist/plugins/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,iCAAiC,EACjC,kCAAkC,EAClC,gCAAgC,EAChC,iCAAiC,EACjC,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,uBAAuB,EACvB,+BAA+B,EAC/B,8BAA8B,EAC9B,2BAA2B,EAC3B,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,iCAAiC,EACjC,kCAAkC,EAClC,gCAAgC,EAChC,iCAAiC,EACjC,+BAA+B,EAC/B,uBAAuB,EACvB,kCAAkC,EAClC,wBAAwB,EACxB,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,uBAAuB,EACvB,+BAA+B,EAC/B,8BAA8B,EAC9B,2BAA2B,EAC3B,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/plugins/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,oBAAoB,GAErB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EACL,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAsBhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,oBAAoB,GAErB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EACL,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwBhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/runner/agent-runtime.d.ts

@@ -0,0 +1,62 @@
+import { Agent } from "@mariozechner/pi-agent-core";
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { manageHistory } from "../history/index.js";
+import { PluginHookRegistry, type PluginHookAgentContext } from "../plugins/hooks.js";
+import type { AgentRunParams } from "../types.js";
+import type { Skill } from "../skills/skills.js";
+import type { SubagentRegistry } from "../subagent/registry.js";
+import type { AgentRunContext } from "./run-context.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+type HistoryResult = Awaited<ReturnType<typeof manageHistory>> | {
+    messages: [];
+    priorSummary: undefined;
+    compactionEntry: undefined;
+    stats: {
+        originalCount: number;
+        keptCount: number;
+        estimatedTokens: number;
+        compacted: boolean;
+    };
+};
+export type AgentRuntime = {
+    agent: Agent;
+    resolvedModelId: string;
+    historyMessages: unknown[];
+    historyResult: HistoryResult;
+    workspaceDir: string;
+};
+export type AgentRuntimeSession = {
+    runParams: AgentRunParams;
+    sessionId: string;
+    hookRegistry: PluginHookRegistry;
+    hookContext: PluginHookAgentContext;
+    runContext: AgentRunContext;
+    eventDispatcher: RunEventDispatcher;
+};
+export type AgentRuntimeInputs = {
+    contextFiles: ReturnType<typeof import("../bootstrap/bootstrap.js").buildBootstrapContextFiles>;
+    bootstrapWarnings: string[];
+    skills: Skill[];
+    effectivePromptText: string;
+    pluginTools: AgentTool[];
+};
+export type AgentRuntimeDependencies = {
+    registry: SubagentRegistry;
+    spawnFn: (params: AgentRunParams) => Promise<import("../types.js").AgentRunResult>;
+    createModel: (params: AgentRunParams["llm"], sessionId: string) => import("@mariozechner/pi-ai").Model<"openai-completions">;
+    abortSignal: AbortSignal;
+};
+/**
+ * Builds the runtime state needed for model execution: history restoration,
+ * compaction decisions, tool assembly, prompt construction, hook-driven prompt
+ * and model adjustments, and the final Agent instance. Callers should treat
+ * the result as a ready-to-run turn environment rather than reapplying any of
+ * these policies themselves.
+ */
+export declare function createAgentRuntime(params: {
+    session: AgentRuntimeSession;
+    runtimeInputs: AgentRuntimeInputs;
+    dependencies: AgentRuntimeDependencies;
+}): Promise<AgentRuntime>;
+export {};
+//# sourceMappingURL=agent-runtime.d.ts.map

package/dist/runner/agent-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../../src/runner/agent-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAA2C,MAAM,qBAAqB,CAAC;AAG/H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,KAAK,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,GAAG;IAC/D,QAAQ,EAAE,EAAE,CAAC;IACb,YAAY,EAAE,SAAS,CAAC;IACxB,eAAe,EAAE,SAAS,CAAC;IAC3B,KAAK,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CAClG,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,kBAAkB,CAAC;IACjC,WAAW,EAAE,sBAAsB,CAAC;IACpC,UAAU,EAAE,eAAe,CAAC;IAC5B,eAAe,EAAE,kBAAkB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,UAAU,CAAC,cAAc,2BAA2B,EAAE,0BAA0B,CAAC,CAAC;IAChG,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,SAAS,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,aAAa,EAAE,cAAc,CAAC,CAAC;IACnF,WAAW,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,qBAAqB,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC7H,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,mBAAmB,CAAC;IAC7B,aAAa,EAAE,kBAAkB,CAAC;IAClC,YAAY,EAAE,wBAAwB,CAAC;CACxC,GAAG,OAAO,CAAC,YAAY,CAAC,CAmMxB"}

package/dist/runner/agent-runtime.js

@@ -0,0 +1,179 @@
+import { Agent } from "@mariozechner/pi-agent-core";
+import os from "node:os";
+import { loadTranscript } from "../session/session.js";
+import { manageHistory } from "../history/index.js";
+import { createAgentTools } from "../tools/index.js";
+import { buildSystemPrompt } from "../system-prompt/builder.js";
+import { wrapToolsWithHooks } from "../plugins/tool-hooks.js";
+import { PluginHookRegistry } from "../plugins/hooks.js";
+import { wrapToolsWithLoopDetection } from "../loop-detection/tool-loop-detection.js";
+import { getLoopDetectionState } from "../loop-detection/session-state.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+/**
+ * Builds the runtime state needed for model execution: history restoration,
+ * compaction decisions, tool assembly, prompt construction, hook-driven prompt
+ * and model adjustments, and the final Agent instance. Callers should treat
+ * the result as a ready-to-run turn environment rather than reapplying any of
+ * these policies themselves.
+ */
+export async function createAgentRuntime(params) {
+    const { session: { runParams, sessionId, hookRegistry, hookContext, runContext, eventDispatcher, }, runtimeInputs: { contextFiles, bootstrapWarnings, skills, effectivePromptText, pluginTools, }, dependencies: { registry, spawnFn, createModel, abortSignal, }, } = params;
+    // CRON runs are intentionally stateless from the model's perspective.
+    const skipHistory = runParams.channel === "CRON";
+    const rawHistory = skipHistory ? [] : await loadTranscript(runParams.dataDir, sessionId);
+    await hookRegistry.dispatch("before_compaction", { messageCount: rawHistory.length }, hookContext);
+    const modelInfo = { model: runParams.llm.model, api: "openai-completions" };
+    const historyResult = skipHistory
+        ? {
+            messages: [],
+            priorSummary: undefined,
+            compactionEntry: undefined,
+            stats: { originalCount: 0, keptCount: 0, estimatedTokens: 0, compacted: false },
+        }
+        : await manageHistory({
+            entries: rawHistory,
+            modelInfo,
+            contextWindowTokens: runParams.llm.contextWindow ?? 200_000,
+            llm: {
+                baseUrl: runParams.llm.baseUrl,
+                apiKey: runParams.llm.apiKey,
+                model: runParams.llm.model,
+            },
+            historyLimit: runParams.historyLimit,
+            compactionEnabled: true,
+            signal: abortSignal,
+            hooks: hookRegistry,
+            hookCtx: hookContext,
+        });
+    await applyCompactionResult({
+        sessionId,
+        historyResult,
+        runContext,
+        eventDispatcher,
+        hookRegistry,
+        hookContext,
+    });
+    // Tool and prompt policy both depend on whether this run is nested.
+    const depth = runParams.subagentContext?.depth ?? 0;
+    const baseTools = createAgentTools(runParams.dataDir, {
+        registry,
+        parentSessionId: sessionId,
+        depth,
+        channel: runParams.channel,
+        llm: runParams.llm,
+        loopDetection: runParams.loopDetection,
+        memoryOptions: {
+            providerId: runContext.memoryProviderId,
+            pluginId: runContext.memoryPluginId,
+            sessionId,
+            onMemoryChanged: async () => { },
+        },
+        spawnFn,
+    });
+    const rawTools = [...baseTools, ...pluginTools];
+    const toolNames = rawTools
+        .map((tool) => (typeof tool.name === "string" ? tool.name.trim() : ""))
+        .filter(Boolean);
+    const toolSummaries = {};
+    for (const tool of rawTools) {
+        const name = typeof tool.name === "string" ? tool.name.trim() : "";
+        const description = typeof tool.description === "string" ? tool.description.trim() : "";
+        if (!name || !description || toolSummaries[name])
+            continue;
+        toolSummaries[name] = description;
+    }
+    const messagingEnabled = runParams.messaging?.enabled ?? runParams.channel !== "CRON";
+    const messagingChannels = runParams.messaging?.channels && runParams.messaging.channels.length > 0
+        ? runParams.messaging.channels
+        : [runParams.channel];
+    let systemPrompt = buildSystemPrompt({
+        dataDir: runParams.dataDir,
+        skills,
+        contextFiles,
+        toolNames,
+        toolSummaries,
+        promptMode: depth > 0 ? "minimal" : "full",
+        bootstrapWarnings,
+        memoryCitationsMode: runParams.memory?.citationsMode ?? "off",
+        messaging: {
+            enabled: messagingEnabled,
+            channels: messagingChannels,
+        },
+        docs: {
+            localPath: runParams.docs?.localPath,
+            webUrl: runParams.docs?.webUrl,
+            sourceUrl: runParams.docs?.sourceUrl,
+        },
+        sandboxInfo: {
+            enabled: true,
+            hostWorkspaceDir: runContext.workspaceDir,
+            containerWorkspaceDir: runContext.workspaceDir,
+        },
+        runtimeInfo: {
+            os: process.platform,
+            node: process.version,
+            model: runParams.llm.model,
+            hostname: os.hostname(),
+        },
+        currentDate: new Date().toISOString().split("T")[0],
+        priorConversationSummary: historyResult.priorSummary,
+    });
+    // Prompt hooks can prepend context or fully replace the generated prompt.
+    const beforePromptResults = await hookRegistry.dispatch("before_prompt_build", { prompt: effectivePromptText }, hookContext);
+    for (const result of beforePromptResults) {
+        if (!result)
+            continue;
+        if (result.systemPrompt) {
+            systemPrompt = result.systemPrompt;
+        }
+        if (result.prependContext) {
+            systemPrompt = `${result.prependContext}\n\n${systemPrompt}`;
+        }
+    }
+    await hookRegistry.dispatch("after_prompt_build", { prompt: effectivePromptText, systemPrompt }, hookContext);
+    // Hook wrapping happens before loop detection so plugin hooks observe the
+    // same tool calls the runtime ultimately executes.
+    const toolsWithHooks = wrapToolsWithHooks(rawTools, hookRegistry, hookContext);
+    const tools = wrapToolsWithLoopDetection(toolsWithHooks, { sessionId, config: runParams.loopDetection }, getLoopDetectionState);
+    // Model selection is finalized after prompt construction so hooks can make
+    // prompt-aware routing decisions.
+    let resolvedModelId = runParams.llm.model;
+    const beforeModelResults = await hookRegistry.dispatch("before_model_resolve", { prompt: effectivePromptText }, hookContext);
+    for (const result of beforeModelResults) {
+        if (result && result.modelOverride) {
+            resolvedModelId = result.modelOverride;
+        }
+    }
+    const model = createModel({ ...runParams.llm, model: resolvedModelId }, sessionId);
+    const agent = new Agent({
+        initialState: { systemPrompt, model, tools, messages: [] },
+        getApiKey: (_provider) => runParams.llm.apiKey,
+    });
+    if (historyResult.messages.length > 0) {
+        agent.replaceMessages(historyResult.messages);
+    }
+    return {
+        agent,
+        resolvedModelId,
+        historyMessages: historyResult.messages,
+        historyResult,
+        workspaceDir: runContext.workspaceDir,
+    };
+}
+async function applyCompactionResult(params) {
+    const { sessionId, historyResult, runContext, eventDispatcher, hookRegistry, hookContext } = params;
+    if (!historyResult.compactionEntry) {
+        return;
+    }
+    const compactedCount = historyResult.stats.originalCount - historyResult.stats.keptCount;
+    await runContext.appendTranscriptEntry(historyResult.compactionEntry);
+    await eventDispatcher.dispatchProgress(sessionId, {
+        type: "compaction",
+        reason: `Summarised ${compactedCount} older entries`,
+    });
+    await hookRegistry.dispatch("after_compaction", {
+        messageCount: historyResult.stats.originalCount,
+        compactedCount,
+    }, hookContext);
+}
+//# sourceMappingURL=agent-runtime.js.map

package/dist/runner/agent-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime.js","sourceRoot":"","sources":["../../src/runner/agent-runtime.ts"],"names":[],"mappings":"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"}

package/dist/runner/announce-loop.d.ts

@@ -0,0 +1,41 @@
+import type { Agent } from "@mariozechner/pi-agent-core";
+import type { AgentRunParams, AssistantEntry, ToolResultEntry } from "../types.js";
+import type { PluginHookRegistry } from "../plugins/hooks.js";
+import type { SubagentRegistry } from "../subagent/registry.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+import { SkillUsageTracker } from "./skill-usage.js";
+/**
+ * Feeds completed subagent results back into the parent agent until no more
+ * announcements are pending or the safety cap is reached. This keeps the
+ * multi-agent follow-up protocol out of the main runner loop.
+ */
+export declare function runAnnounceLoop(params: {
+    agent: Agent;
+    registry: SubagentRegistry;
+    sessionId: string;
+    resolvedModelId: string;
+    eventDispatcher: RunEventDispatcher;
+    skillUsageTracker: SkillUsageTracker;
+    hookRegistry: PluginHookRegistry;
+    hookContext: {
+        sessionId?: string;
+        workspaceDir?: string;
+        channel?: AgentRunParams["channel"];
+    };
+    abortSignal?: AbortSignal;
+    appendEntry: (entry: AssistantEntry | ToolResultEntry | {
+        role: "assistant";
+        content: string;
+        timestamp: string;
+    } | {
+        role: "user";
+        content: string;
+        timestamp: string;
+    }) => Promise<void>;
+}): Promise<{
+    text: string;
+    inputTokens: number;
+    outputTokens: number;
+    error?: string;
+}>;
+//# sourceMappingURL=announce-loop.d.ts.map

package/dist/runner/announce-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announce-loop.d.ts","sourceRoot":"","sources":["../../src/runner/announce-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAKrD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,kBAAkB,CAAC;IACpC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,YAAY,EAAE,kBAAkB,CAAC;IACjC,WAAW,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;KAAE,CAAC;IAChG,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,EAAE,CACX,KAAK,EACD,cAAc,GACd,eAAe,GACf;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GACzD;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KACrD,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkFvF"}

package/dist/runner/announce-loop.js

@@ -0,0 +1,94 @@
+import { buildSubagentAnnounceMessage } from "../tools/subagent-spawn.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+import { SkillUsageTracker } from "./skill-usage.js";
+import { executeAgentTurn, persistTurnEntriesWithWriter } from "./turn-executor.js";
+const MAX_ANNOUNCE_ROUNDS = 10;
+/**
+ * Feeds completed subagent results back into the parent agent until no more
+ * announcements are pending or the safety cap is reached. This keeps the
+ * multi-agent follow-up protocol out of the main runner loop.
+ */
+export async function runAnnounceLoop(params) {
+    const { agent, registry, sessionId, resolvedModelId, eventDispatcher, skillUsageTracker, hookRegistry, hookContext, abortSignal, appendEntry, } = params;
+    let announceRound = 0;
+    let lastResponseText = "";
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let runError;
+    // Multiple child runs may complete between turns, so announce them in
+    // batches to minimize extra parent turns.
+    while (!abortSignal?.aborted &&
+        registry.needsAnnounce(sessionId) &&
+        announceRound < MAX_ANNOUNCE_ROUNDS) {
+        announceRound++;
+        await registry.waitForAll(sessionId);
+        const completed = registry.consumeCompleted(sessionId);
+        if (completed.length === 0) {
+            break;
+        }
+        for (const record of completed) {
+            await eventDispatcher.dispatchProgress(sessionId, {
+                type: "subagent_complete",
+                childSessionId: record.childSessionId,
+                task: record.task,
+                status: record.status,
+            });
+        }
+        const announceMsg = buildBatchAnnounceMessage(completed);
+        await appendEntry({
+            role: "user",
+            content: announceMsg,
+            timestamp: new Date().toISOString(),
+        });
+        const announceTurn = await executeAgentTurn({
+            agent,
+            message: announceMsg,
+            sessionId,
+            modelId: resolvedModelId,
+            historyMessages: [],
+            eventDispatcher,
+            skillUsageTracker,
+            hooks: hookRegistry,
+            hookCtx: hookContext,
+            abortSignal,
+        });
+        lastResponseText = announceTurn.text;
+        totalInputTokens += announceTurn.inputTokens;
+        totalOutputTokens += announceTurn.outputTokens;
+        if (announceTurn.error && !runError) {
+            runError = announceTurn.error;
+        }
+        await persistTurnEntriesWithWriter(appendEntry, announceTurn);
+    }
+    return {
+        text: lastResponseText,
+        inputTokens: totalInputTokens,
+        outputTokens: totalOutputTokens,
+        error: runError,
+    };
+}
+/**
+ * Preserves the single-subagent announce format while still supporting a
+ * batched representation when several children finish together.
+ */
+function buildBatchAnnounceMessage(completed) {
+    if (completed.length === 1) {
+        const r = completed[0];
+        return buildSubagentAnnounceMessage({
+            task: r.task,
+            label: r.label,
+            status: r.status,
+            result: r.result,
+            error: r.error,
+        });
+    }
+    const parts = completed.map((r) => buildSubagentAnnounceMessage({
+        task: r.task,
+        label: r.label,
+        status: r.status,
+        result: r.result,
+        error: r.error,
+    }));
+    return `[${completed.length} subagents completed]\n\n${parts.join("\n\n---\n\n")}`;
+}
+//# sourceMappingURL=announce-loop.js.map

package/dist/runner/announce-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announce-loop.js","sourceRoot":"","sources":["../../src/runner/announce-loop.ts"],"names":[],"mappings":"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"}

package/dist/runner/event-dispatcher.d.ts

@@ -0,0 +1,31 @@
+import type { AgentRunParams, AgentProgressEvent, CallbackPayload } from "../types.js";
+type EventDispatchParams = Pick<AgentRunParams, "onProgress" | "callbackUrl" | "messageId" | "channel">;
+type RunDoneResult = {
+    text: string;
+    usage: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    durationMs: number;
+};
+/**
+ * Emits runner events to in-process listeners and optional HTTP callbacks.
+ * Callback failures are intentionally ignored so they do not interrupt the run.
+ */
+export declare class RunEventDispatcher {
+    private readonly params;
+    constructor(params: EventDispatchParams);
+    sendCallback(url: string, payload: CallbackPayload): Promise<void>;
+    dispatchProgress(sessionId: string, event: AgentProgressEvent): Promise<void>;
+    dispatchStart(sessionId: string, message: string): Promise<void>;
+    dispatchDone(sessionId: string, result: RunDoneResult): Promise<void>;
+    dispatchError(sessionId: string, message: string): Promise<void>;
+    dispatchSessionReset(sessionId: string, payload: {
+        action: "new" | "reset";
+        previousSessionId?: string;
+        message: string;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=event-dispatcher.d.ts.map

package/dist/runner/event-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-dispatcher.d.ts","sourceRoot":"","sources":["../../src/runner/event-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvF,KAAK,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC,CAAC;AACxG,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnH;;;GAGG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,mBAAmB;IAElD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7E,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAchE,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC;IAcV,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAchE,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAChF,OAAO,CAAC,IAAI,CAAC;CAejB"}

package/dist/runner/event-dispatcher.js

@@ -0,0 +1,87 @@
+/**
+ * Emits runner events to in-process listeners and optional HTTP callbacks.
+ * Callback failures are intentionally ignored so they do not interrupt the run.
+ */
+export class RunEventDispatcher {
+    params;
+    constructor(params) {
+        this.params = params;
+    }
+    async sendCallback(url, payload) {
+        try {
+            await fetch(url, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(payload),
+            });
+        }
+        catch {
+            // Callback failures are non-fatal
+        }
+    }
+    async dispatchProgress(sessionId, event) {
+        const eventWithMessageId = this.params.messageId ? { ...event, messageId: this.params.messageId } : event;
+        await this.params.onProgress?.(eventWithMessageId);
+        if (!this.params.callbackUrl) {
+            return;
+        }
+        await this.sendCallback(this.params.callbackUrl, {
+            sessionId,
+            channel: this.params.channel,
+            messageId: this.params.messageId,
+            type: "progress",
+            event: eventWithMessageId,
+        });
+    }
+    async dispatchStart(sessionId, message) {
+        if (!this.params.callbackUrl) {
+            return;
+        }
+        await this.sendCallback(this.params.callbackUrl, {
+            sessionId,
+            channel: this.params.channel,
+            messageId: this.params.messageId,
+            type: "start",
+            message,
+        });
+    }
+    async dispatchDone(sessionId, result) {
+        if (!this.params.callbackUrl) {
+            return;
+        }
+        await this.sendCallback(this.params.callbackUrl, {
+            sessionId,
+            channel: this.params.channel,
+            messageId: this.params.messageId,
+            type: "done",
+            result,
+        });
+    }
+    async dispatchError(sessionId, message) {
+        if (!this.params.callbackUrl) {
+            return;
+        }
+        await this.sendCallback(this.params.callbackUrl, {
+            sessionId,
+            channel: this.params.channel,
+            messageId: this.params.messageId,
+            type: "error",
+            message,
+        });
+    }
+    async dispatchSessionReset(sessionId, payload) {
+        if (!this.params.callbackUrl) {
+            return;
+        }
+        await this.sendCallback(this.params.callbackUrl, {
+            sessionId,
+            channel: this.params.channel,
+            messageId: this.params.messageId,
+            type: "session_reset",
+            action: payload.action,
+            previousSessionId: payload.previousSessionId,
+            message: payload.message,
+        });
+    }
+}
+//# sourceMappingURL=event-dispatcher.js.map