root/fusion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(agents): decouple heartbeat from task state, add allowParallelExecution

Browse Source 
Permanent agents now run heartbeats regardless of bound-task block state.
The prior queued+blockedBy early-exit and its state-tracking machinery are
removed; HEARTBEAT_SYSTEM_PROMPT is rewritten to scope heartbeats to
ambient coordination (messaging, memory, finding work, delegation,
surfacing/chasing blockers, status). Task body work continues via the
executor path. Ephemeral agents are unchanged.

New allowParallelExecution flag (default true, permanent agents only) on
AgentHeartbeatConfig. When false, heartbeat and executor paths serialize
symmetrically: a heartbeat will not start while the agent's bound task
has an active executor session, and an executor session will not start
while the agent has an active heartbeat run. Either side re-dispatches
the other's deferred work on completion. UI toggle surfaces in the
agent's Heartbeat Settings tab.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
gsxdsm
2026-05-05 22:04:06 -07:00
parent bb32765438
commit b4b7a8a212
16 changed files with 255 additions and 313 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
packages/core/src/__tests__/agent-store.test.ts
View File

@@ -22,7 +22,7 @@ import {
CheckoutConflictError,
getCanonicalAgentAssetDirectoryName,
type AgentCapability,
type AgentState,
type AgentRating,
} from "../types.js";
function makeTmpDir(): string {
@@ -1225,29 +1225,29 @@ describe("AgentStore", () => {
// Create a normal agent
const normal = await store.createAgent({ name: "Normal Agent", role: "executor" });
// Create a task-worker agent
const taskWorker = await store.createAgent({
// Create a task-worker agent (return value not needed — just populate the DB)
await store.createAgent({
name: "executor-FN-TEST",
role: "executor",
metadata: { agentKind: "task-worker" },
});
// Create a spawned child agent
const spawned = await store.createAgent({
await store.createAgent({
name: "spawned-agent",
role: "executor",
metadata: { type: "spawned" },
});
// Create an agent with taskWorker metadata
const withTaskWorker = await store.createAgent({
await store.createAgent({
name: "task-worker-agent",
role: "executor",
metadata: { taskWorker: true },
});
// Create an agent with managedBy metadata
const managedBy = await store.createAgent({
await store.createAgent({
name: "managed-agent",
role: "executor",
metadata: { managedBy: "task-executor" },
@@ -1264,8 +1264,8 @@ describe("AgentStore", () => {
});
it("includeEphemeral filter works with state filter", async () => {
// Create a normal agent
const normal = await store.createAgent({ name: "Normal Agent", role: "executor" });
// Create a normal agent (return value not needed — just to ensure it exists in DB)
await store.createAgent({ name: "Normal Agent", role: "executor" });
// Create a task-worker agent
const taskWorker = await store.createAgent({
@@ -2297,7 +2297,7 @@ describe("AgentStore", () => {
const base = new Date("2026-01-01T00:00:00.000Z").getTime();
try {
const ratings = [];
const ratings: AgentRating[] = [];
for (let i = 0; i < scores.length; i++) {
vi.setSystemTime(new Date(base + i * 1000));
ratings.push(

9
packages/core/src/types.ts
View File

@@ -3646,6 +3646,15 @@ export interface AgentHeartbeatConfig {
* down across a scheduled tick. Default: false.
*/
runMissedHeartbeatOnStartup?: boolean;
/**
* When true (default), an agent's heartbeat runs and its task execution session can run
* concurrently. When false, the two paths serialize: a heartbeat will not start while the
* agent's bound task has an active executor session, and an executor session will not start
* while the agent has an active heartbeat run.
*
* Permanent agents only — ignored for ephemeral agents. Default: true when unset.
*/
allowParallelExecution?: boolean;
}
/** Per-agent budget configuration, stored in agent.runtimeConfig.budgetConfig */