@roj-ai/sdk 0.1.1 → 0.1.4

package/dist/plugins/limits-guard/limits-guard.integration.test.js

@@ -0,0 +1,378 @@
+import { describe, expect, it } from 'bun:test';
+import { AgentId } from '../../core/agents/schema.js';
+import { agentEvents } from '../../core/agents/state.js';
+import { MockLLMProvider } from '../../core/llm/mock.js';
+import { selectPluginState } from '../../core/sessions/reducer.js';
+import { ToolCallId } from '../../core/tools/schema.js';
+import { createMultiAgentPreset, createTestPreset, TestHarness } from '../../testing/index.js';
+import { limitsGuardPlugin } from './plugin.js';
+function createLimitsHarness(options) {
+    return new TestHarness({ ...options, systemPlugins: [limitsGuardPlugin] });
+}
+/**
+ * Wait for a specific agent to reach 'paused' status (or timeout).
+ * Polls the TestSession's state directly (live getter).
+ */
+async function waitForAgentPaused(session, agentId, timeoutMs = 10000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const agentState = session.state.agents.get(agentId);
+        if (agentState?.status === 'paused')
+            return;
+        await new Promise(r => setTimeout(r, 10));
+    }
+    throw new Error(`waitForAgentPaused timed out after ${timeoutMs}ms for agent ${agentId}`);
+}
+/**
+ * Wait for all agents to be either idle (pending with no work) or paused.
+ */
+async function waitForAllSettled(session, timeoutMs = 10000) {
+    const deadline = Date.now() + timeoutMs;
+    outer: while (Date.now() < deadline) {
+        for (const [, agentState] of session.state.agents) {
+            if (agentState.status === 'paused')
+                continue;
+            if (agentState.status === 'pending' && agentState.pendingToolCalls.length === 0 && agentState.pendingToolResults.length === 0) {
+                continue;
+            }
+            await new Promise(r => setTimeout(r, 10));
+            continue outer;
+        }
+        // Double-check after a brief delay
+        await new Promise(r => setTimeout(r, 10));
+        for (const [, agentState] of session.state.agents) {
+            if (agentState.status === 'paused')
+                continue;
+            if (agentState.status === 'pending' && agentState.pendingToolCalls.length === 0 && agentState.pendingToolResults.length === 0) {
+                continue;
+            }
+            continue outer;
+        }
+        return;
+    }
+    throw new Error(`waitForAllSettled timed out after ${timeoutMs}ms`);
+}
+describe('limits-guard plugin', () => {
+    // =========================================================================
+    // hard limits
+    // =========================================================================
+    describe('hard limits', () => {
+        it('agent exceeding inference hard limit → agent_paused event → agent stops', async () => {
+            let inferenceCount = 0;
+            const harness = createLimitsHarness({
+                presets: [createTestPreset({
+                        orchestratorSystem: 'Test agent.',
+                        orchestratorPlugins: [limitsGuardPlugin.configureAgent({ limits: { maxTurns: 3 } })],
+                    })],
+                mockHandler: () => {
+                    inferenceCount++;
+                    return {
+                        content: null,
+                        toolCalls: [{ id: ToolCallId(`tc${inferenceCount}`), name: 'tell_user', input: { message: `Turn ${inferenceCount}` } }],
+                        finishReason: 'stop',
+                        metrics: MockLLMProvider.defaultMetrics(),
+                    };
+                },
+            });
+            const session = await harness.createSession('test');
+            const entryAgentId = session.getEntryAgentId();
+            await session.sendMessage('Start');
+            await waitForAgentPaused(session, entryAgentId);
+            const entryAgent = session.state.agents.get(entryAgentId);
+            expect(entryAgent.status).toBe('paused');
+            const pausedEvents = await session.getEventsByType(agentEvents, 'agent_paused');
+            expect(pausedEvents.length).toBeGreaterThanOrEqual(1);
+            const pauseEvent = pausedEvents.find(e => e.agentId === entryAgentId);
+            expect(pauseEvent).toBeDefined();
+            expect(pauseEvent.reason).toBe('handler');
+            await harness.shutdown();
+        });
+        it('agent exceeding tool call hard limit → agent paused', async () => {
+            let callNum = 0;
+            const harness = createLimitsHarness({
+                presets: [createTestPreset({
+                        orchestratorSystem: 'Test agent.',
+                        orchestratorPlugins: [limitsGuardPlugin.configureAgent({ limits: { maxToolCalls: 3, maxTurns: 100 } })],
+                    })],
+                mockHandler: () => {
+                    callNum++;
+                    return {
+                        content: null,
+                        toolCalls: [
+                            { id: ToolCallId(`tc${callNum}a`), name: 'tell_user', input: { message: `A${callNum}` } },
+                            { id: ToolCallId(`tc${callNum}b`), name: 'tell_user', input: { message: `B${callNum}` } },
+                        ],
+                        finishReason: 'stop',
+                        metrics: MockLLMProvider.defaultMetrics(),
+                    };
+                },
+            });
+            const session = await harness.createSession('test');
+            const entryAgentId = session.getEntryAgentId();
+            await session.sendMessage('Start');
+            await waitForAgentPaused(session, entryAgentId);
+            const entryAgent = session.state.agents.get(entryAgentId);
+            expect(entryAgent.status).toBe('paused');
+            const counters = selectPluginState(session.state, 'agentLimits')?.get(entryAgentId);
+            expect(counters).toBeDefined();
+            expect(counters.toolCallCount).toBeGreaterThanOrEqual(3);
+            await harness.shutdown();
+        });
+        it('agent exceeding spawned agent limit → agent paused', async () => {
+            let orchestratorCalls = 0;
+            const harness = createLimitsHarness({
+                presets: [createMultiAgentPreset([
+                        { name: 'worker', system: 'Worker agent.', tools: [], agents: [] },
+                    ], { orchestratorSystem: 'Orchestrator agent.' })],
+                mockHandler: (request) => {
+                    if (request.systemPrompt.includes('Orchestrator')) {
+                        orchestratorCalls++;
+                        return {
+                            content: null,
+                            toolCalls: [
+                                { id: ToolCallId(`tc${orchestratorCalls}a`), name: 'start_worker', input: { message: `Task ${orchestratorCalls}a` } },
+                                { id: ToolCallId(`tc${orchestratorCalls}b`), name: 'start_worker', input: { message: `Task ${orchestratorCalls}b` } },
+                            ],
+                            finishReason: 'stop',
+                            metrics: MockLLMProvider.defaultMetrics(),
+                        };
+                    }
+                    return { content: 'Worker done', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                },
+            });
+            const session = await harness.createSession('test');
+            const orchestratorId = session.getEntryAgentId();
+            await session.sendMessage('Start');
+            await waitForAgentPaused(session, orchestratorId, 15000);
+            const orch = session.state.agents.get(orchestratorId);
+            expect(orch.status).toBe('paused');
+            const counters = selectPluginState(session.state, 'agentLimits')?.get(orchestratorId);
+            expect(counters).toBeDefined();
+            expect(counters.spawnedAgentCount).toBeGreaterThanOrEqual(10);
+            await harness.shutdown();
+        });
+    });
+    // =========================================================================
+    // soft limits (status display)
+    // =========================================================================
+    describe('soft limits (status display)', () => {
+        it('approaching limit (80%) → status contains warning message', async () => {
+            let inferenceCount = 0;
+            let sawWarning = false;
+            const harness = createLimitsHarness({
+                presets: [createTestPreset({
+                        orchestratorSystem: 'Test agent.',
+                        orchestratorPlugins: [limitsGuardPlugin.configureAgent({ limits: { maxTurns: 5 } })],
+                    })],
+                mockHandler: (request) => {
+                    inferenceCount++;
+                    const messagesStr = JSON.stringify(request.messages);
+                    if (messagesStr.includes('Approaching maxTurns limit')) {
+                        sawWarning = true;
+                    }
+                    if (inferenceCount < 5) {
+                        return {
+                            content: null,
+                            toolCalls: [{ id: ToolCallId(`tc${inferenceCount}`), name: 'tell_user', input: { message: `Turn ${inferenceCount}` } }],
+                            finishReason: 'stop',
+                            metrics: MockLLMProvider.defaultMetrics(),
+                        };
+                    }
+                    return { content: 'Done', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                },
+            });
+            const session = await harness.createSession('test');
+            const entryAgentId = session.getEntryAgentId();
+            await session.sendMessage('Start');
+            // Agent will be paused at turn 5 or finish at turn 5 if last response has no tools
+            await waitForAllSettled(session);
+            expect(sawWarning).toBe(true);
+            await harness.shutdown();
+        });
+    });
+    // =========================================================================
+    // counter tracking
+    // =========================================================================
+    describe('counter tracking', () => {
+        it('each inference increments inferenceCount', async () => {
+            let callCount = 0;
+            const harness = createLimitsHarness({
+                presets: [createTestPreset({
+                        orchestratorSystem: 'Test agent.',
+                        orchestratorPlugins: [limitsGuardPlugin.configureAgent({ limits: { maxTurns: 100 } })],
+                    })],
+                mockHandler: () => {
+                    callCount++;
+                    if (callCount <= 2) {
+                        return {
+                            content: null,
+                            toolCalls: [{ id: ToolCallId(`tc${callCount}`), name: 'tell_user', input: { message: `Msg ${callCount}` } }],
+                            finishReason: 'stop',
+                            metrics: MockLLMProvider.defaultMetrics(),
+                        };
+                    }
+                    return { content: 'Done', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                },
+            });
+            const session = await harness.createSession('test');
+            await session.sendAndWaitForIdle('Start');
+            const counters = selectPluginState(session.state, 'agentLimits')?.get(session.getEntryAgentId());
+            expect(counters).toBeDefined();
+            expect(counters.inferenceCount).toBe(3); // 2 with tools + 1 final
+            await harness.shutdown();
+        });
+        it('each tool call increments toolCallCount', async () => {
+            let callCount = 0;
+            const harness = createLimitsHarness({
+                presets: [createTestPreset({
+                        orchestratorSystem: 'Test agent.',
+                        orchestratorPlugins: [limitsGuardPlugin.configureAgent({ limits: { maxTurns: 100 } })],
+                    })],
+                mockHandler: () => {
+                    callCount++;
+                    if (callCount === 1) {
+                        return {
+                            content: null,
+                            toolCalls: [
+                                { id: ToolCallId('tc1'), name: 'tell_user', input: { message: 'A' } },
+                                { id: ToolCallId('tc2'), name: 'tell_user', input: { message: 'B' } },
+                            ],
+                            finishReason: 'stop',
+                            metrics: MockLLMProvider.defaultMetrics(),
+                        };
+                    }
+                    return { content: 'Done', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                },
+            });
+            const session = await harness.createSession('test');
+            await session.sendAndWaitForIdle('Start');
+            const counters = selectPluginState(session.state, 'agentLimits')?.get(session.getEntryAgentId());
+            expect(counters).toBeDefined();
+            expect(counters.toolCallCount).toBe(2);
+            await harness.shutdown();
+        });
+        it('each agent spawn increments parent spawnedAgentCount', async () => {
+            let orchestratorCalls = 0;
+            const harness = createLimitsHarness({
+                presets: [createMultiAgentPreset([
+                        { name: 'worker', system: 'Worker agent.', tools: [], agents: [] },
+                    ], { orchestratorSystem: 'Orchestrator agent.' })],
+                mockHandler: (request) => {
+                    if (request.systemPrompt.includes('Orchestrator')) {
+                        orchestratorCalls++;
+                        if (orchestratorCalls === 1) {
+                            return {
+                                content: null,
+                                toolCalls: [
+                                    { id: ToolCallId('tc1'), name: 'start_worker', input: { message: 'Task 1' } },
+                                    { id: ToolCallId('tc2'), name: 'start_worker', input: { message: 'Task 2' } },
+                                ],
+                                finishReason: 'stop',
+                                metrics: MockLLMProvider.defaultMetrics(),
+                            };
+                        }
+                        return { content: 'Done', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                    }
+                    return { content: 'Worker done', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                },
+            });
+            const session = await harness.createSession('test');
+            await session.sendAndWaitForIdle('Start', { timeoutMs: 10000 });
+            const orchestratorId = session.getEntryAgentId();
+            const counters = selectPluginState(session.state, 'agentLimits')?.get(orchestratorId);
+            expect(counters).toBeDefined();
+            expect(counters.spawnedAgentCount).toBe(2);
+            await harness.shutdown();
+        });
+        it('each mailbox message increments sender messagesSentCount', async () => {
+            let orchestratorCalls = 0;
+            let workerCalls = 0;
+            const harness = createLimitsHarness({
+                presets: [createMultiAgentPreset([
+                        { name: 'worker', system: 'Worker agent.', tools: [], agents: [] },
+                    ], { orchestratorSystem: 'Orchestrator agent.' })],
+                mockHandler: (request) => {
+                    if (request.systemPrompt.includes('Orchestrator')) {
+                        orchestratorCalls++;
+                        if (orchestratorCalls === 1) {
+                            return {
+                                content: null,
+                                toolCalls: [{ id: ToolCallId('tc1'), name: 'start_worker', input: { message: 'Task' } }],
+                                finishReason: 'stop',
+                                metrics: MockLLMProvider.defaultMetrics(),
+                            };
+                        }
+                        return { content: 'Done', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                    }
+                    workerCalls++;
+                    if (workerCalls === 1) {
+                        return {
+                            content: null,
+                            toolCalls: [{ id: ToolCallId('tc2'), name: 'send_message', input: { to: 'parent', message: 'Report' } }],
+                            finishReason: 'stop',
+                            metrics: MockLLMProvider.defaultMetrics(),
+                        };
+                    }
+                    return { content: 'Worker done', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                },
+            });
+            const session = await harness.createSession('test');
+            await session.sendAndWaitForIdle('Start', { timeoutMs: 10000 });
+            const workerCounters = selectPluginState(session.state, 'agentLimits')?.get(AgentId('worker_1'));
+            expect(workerCounters).toBeDefined();
+            expect(workerCounters.messagesSentCount).toBeGreaterThanOrEqual(1);
+            await harness.shutdown();
+        });
+    });
+    // =========================================================================
+    // resume resets
+    // =========================================================================
+    describe('resume resets', () => {
+        it('agent_resumed → pattern-based counters reset, cumulative counters preserved', async () => {
+            const harness = createLimitsHarness({
+                presets: [createTestPreset({
+                        orchestratorSystem: 'Test agent.',
+                        orchestratorPlugins: [limitsGuardPlugin.configureAgent({
+                                limits: { maxRepeatedResponses: 2, maxTurns: 100 },
+                            })],
+                    })],
+                // Always return the same text → triggers maxRepeatedResponses
+                mockHandler: () => ({
+                    content: 'I am stuck',
+                    toolCalls: [],
+                    finishReason: 'stop',
+                    metrics: MockLLMProvider.defaultMetrics(),
+                }),
+            });
+            const session = await harness.createSession('test');
+            const entryAgentId = session.getEntryAgentId();
+            // 1st identical response → ok → idle
+            await session.sendAndWaitForIdle('Message 1');
+            // 2nd identical response → maxRepeatedResponses = 2 → paused
+            await session.sendMessage('Message 2');
+            await waitForAgentPaused(session, entryAgentId);
+            expect(session.state.agents.get(entryAgentId).status).toBe('paused');
+            // Resume the agent
+            const resumeResult = await session.callPluginMethod('agents.resume', {
+                agentId: String(entryAgentId),
+            });
+            expect(resumeResult.ok).toBe(true);
+            // All counters should be reset after resume
+            const countersAfterResume = selectPluginState(session.state, 'agentLimits')?.get(entryAgentId);
+            expect(countersAfterResume).toBeDefined();
+            expect(countersAfterResume.inferenceCount).toBe(0);
+            expect(countersAfterResume.toolCallCount).toBe(0);
+            expect(countersAfterResume.recentResponseHashes).toEqual([]);
+            // Agent resumes with reset counters. Wait for it to settle (no work → idle).
+            await session.waitForIdle();
+            // Send 2 more messages to hit the limit again
+            await session.sendAndWaitForIdle('Message 3');
+            await session.sendMessage('Message 4');
+            await waitForAgentPaused(session, entryAgentId);
+            const resumedEvents = await session.getEventsByType(agentEvents, 'agent_resumed');
+            expect(resumedEvents.filter(e => e.agentId === entryAgentId)).toHaveLength(1);
+            await harness.shutdown();
+        });
+    });
+});
+//# sourceMappingURL=limits-guard.integration.test.js.map

package/dist/plugins/limits-guard/limits-guard.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits-guard.integration.test.js","sourceRoot":"","sources":["../../../src/plugins/limits-guard/limits-guard.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/plugins/limits-guard/plugin.js

@@ -0,0 +1,240 @@
+import { agentEvents } from '../../core/agents/state.js';
+import { llmEvents } from '../../core/llm/state.js';
+import { definePlugin } from '../../core/plugins/plugin-builder.js';
+import { selectPluginState } from '../../core/sessions/reducer.js';
+import { toolEvents } from '../../core/tools/state.js';
+import { responseFingerprint, toolCallFingerprint } from '../../lib/utils/hash.js';
+import { mailboxEvents } from '../../plugins/mailbox/state.js';
+import { checkLimits, countConsecutiveTailDuplicates, resolveAgentLimits } from './limit-guard.js';
+export const createAgentCounters = () => ({
+    inferenceCount: 0,
+    toolCallCount: 0,
+    spawnedAgentCount: 0,
+    messagesSentCount: 0,
+    consecutiveToolFailures: {},
+    recentToolCallHashes: [],
+    recentResponseHashes: [],
+});
+/**
+ * Extract agent counters from session state (for external consumers).
+ */
+export function selectAgentCounters(sessionState, agentId) {
+    return selectPluginState(sessionState, 'agentLimits')?.get(agentId) ?? createAgentCounters();
+}
+// ============================================================================
+// Limit warning event
+// ============================================================================
+import z from 'zod/v4';
+import { agentIdSchema } from '../../core/agents/schema.js';
+import { createEventsFactory } from '../../core/events/types.js';
+export const limitsEvents = createEventsFactory({
+    events: {
+        limit_warning: z.object({
+            agentId: agentIdSchema,
+            limitName: z.string(),
+            currentValue: z.number(),
+            hardLimit: z.number(),
+            message: z.string(),
+        }),
+    },
+});
+// ============================================================================
+// Helper
+// ============================================================================
+/**
+ * Resolve tool name from agent state for tool_completed/tool_failed events.
+ * Must run BEFORE core reducer (which clears executingToolCall).
+ */
+function resolveToolName(sessionState, agentId, toolCallId) {
+    const agent = sessionState.agents.get(agentId);
+    if (!agent)
+        return 'unknown';
+    return agent.executingToolCall?.toolName
+        ?? agent.pendingToolCalls.find((tc) => tc.id === toolCallId)?.name
+        ?? 'unknown';
+}
+export const limitsGuardPlugin = definePlugin('limits-guard')
+    .events([agentEvents, llmEvents, toolEvents, mailboxEvents])
+    .state({
+    key: 'agentLimits',
+    initial: () => new Map(),
+    reduce: (limits, event, sessionState) => {
+        switch (event.type) {
+            case 'agent_spawned': {
+                const newLimits = new Map(limits);
+                newLimits.set(event.agentId, createAgentCounters());
+                // Increment parent's spawnedAgentCount
+                if (event.parentId) {
+                    const parentCounters = newLimits.get(event.parentId);
+                    if (parentCounters) {
+                        newLimits.set(event.parentId, {
+                            ...parentCounters,
+                            spawnedAgentCount: parentCounters.spawnedAgentCount + 1,
+                        });
+                    }
+                }
+                return newLimits;
+            }
+            case 'mailbox_message': {
+                // Increment sender's messagesSentCount if sender is an agent
+                const senderAgentId = typeof event.message.from === 'string' && event.message.from !== 'user'
+                    ? event.message.from
+                    : null;
+                if (!senderAgentId)
+                    return limits;
+                const senderCounters = limits.get(senderAgentId);
+                if (!senderCounters)
+                    return limits;
+                const newLimits = new Map(limits);
+                newLimits.set(senderAgentId, {
+                    ...senderCounters,
+                    messagesSentCount: senderCounters.messagesSentCount + 1,
+                });
+                return newLimits;
+            }
+            case 'inference_completed': {
+                const counters = limits.get(event.agentId);
+                if (!counters)
+                    return limits;
+                const hasToolCalls = event.response.toolCalls.length > 0;
+                let newRecentResponseHashes = counters.recentResponseHashes;
+                if (!hasToolCalls) {
+                    const isWaiting = /^\s*WAITING\s*$/.test(event.response.content ?? '');
+                    if (!isWaiting) {
+                        const hash = responseFingerprint(event.response.content);
+                        newRecentResponseHashes = [...newRecentResponseHashes, hash].slice(-10);
+                    }
+                }
+                const newLimits = new Map(limits);
+                newLimits.set(event.agentId, {
+                    ...counters,
+                    inferenceCount: counters.inferenceCount + 1,
+                    recentResponseHashes: newRecentResponseHashes,
+                });
+                return newLimits;
+            }
+            case 'tool_started': {
+                const counters = limits.get(event.agentId);
+                if (!counters)
+                    return limits;
+                const fingerprint = toolCallFingerprint(event.toolName, event.input);
+                const newLimits = new Map(limits);
+                newLimits.set(event.agentId, {
+                    ...counters,
+                    toolCallCount: counters.toolCallCount + 1,
+                    recentToolCallHashes: [...counters.recentToolCallHashes, fingerprint].slice(-20),
+                });
+                return newLimits;
+            }
+            case 'tool_completed': {
+                const counters = limits.get(event.agentId);
+                if (!counters)
+                    return limits;
+                // Resolve tool name from agent state (must run before core clears executingToolCall)
+                const toolName = resolveToolName(sessionState, event.agentId, event.toolCallId);
+                const { [toolName]: _, ...restFailures } = counters.consecutiveToolFailures;
+                const newLimits = new Map(limits);
+                newLimits.set(event.agentId, {
+                    ...counters,
+                    consecutiveToolFailures: restFailures,
+                });
+                return newLimits;
+            }
+            case 'tool_failed': {
+                const counters = limits.get(event.agentId);
+                if (!counters)
+                    return limits;
+                // Resolve tool name from agent state (must run before core clears executingToolCall)
+                const toolName = resolveToolName(sessionState, event.agentId, event.toolCallId);
+                const currentEntry = counters.consecutiveToolFailures[toolName];
+                const newLimits = new Map(limits);
+                newLimits.set(event.agentId, {
+                    ...counters,
+                    consecutiveToolFailures: {
+                        ...counters.consecutiveToolFailures,
+                        [toolName]: { count: (currentEntry?.count ?? 0) + 1, lastError: event.error },
+                    },
+                });
+                return newLimits;
+            }
+            case 'agent_resumed': {
+                const counters = limits.get(event.agentId);
+                if (!counters)
+                    return limits;
+                const newLimits = new Map(limits);
+                newLimits.set(event.agentId, {
+                    ...counters,
+                    inferenceCount: 0,
+                    toolCallCount: 0,
+                    spawnedAgentCount: 0,
+                    messagesSentCount: 0,
+                    consecutiveToolFailures: {},
+                    recentToolCallHashes: [],
+                    recentResponseHashes: [],
+                });
+                return newLimits;
+            }
+            default:
+                return limits;
+        }
+    },
+})
+    .agentConfig()
+    .hook('afterInference', async (ctx) => {
+    const resolvedLimits = resolveAgentLimits(ctx.pluginAgentConfig?.limits);
+    const counters = ctx.pluginState.get(ctx.agentId);
+    if (!counters)
+        return null;
+    // The inference_completed event hasn't been emitted yet, so project
+    // what the counters will be after it's processed by the reducer.
+    const hasToolCalls = ctx.response.toolCalls.length > 0;
+    const projected = {
+        ...counters,
+        inferenceCount: counters.inferenceCount + 1,
+        recentResponseHashes: hasToolCalls
+            ? counters.recentResponseHashes
+            : [...counters.recentResponseHashes, responseFingerprint(ctx.response.content)].slice(-10),
+    };
+    const limitCheck = checkLimits(projected, resolvedLimits);
+    if (limitCheck.status === 'hard_limit') {
+        return { action: 'pause', reason: limitCheck.reason };
+    }
+    return null;
+})
+    .status((ctx) => {
+    const resolvedLimits = resolveAgentLimits(ctx.pluginAgentConfig?.limits);
+    const counters = ctx.pluginState.get(ctx.agentId);
+    if (!counters)
+        return null;
+    const parts = [];
+    // Consecutive failures of the same tool — surface from count=2, well before the
+    // hard limit. The agent sees what it tried, how many times, and with what error,
+    // so it can change strategy rather than blindly retry.
+    for (const [toolName, entry] of Object.entries(counters.consecutiveToolFailures)) {
+        if (entry.count >= 2) {
+            const lastError = entry.lastError.length > 600
+                ? entry.lastError.slice(0, 600) + '… [truncated]'
+                : entry.lastError;
+            parts.push(`⚠️ Tool "${toolName}" has failed ${entry.count} times in a row (hard limit: ${resolvedLimits.maxConsecutiveToolFailures}). `
+                + `Last error: ${lastError}\n`
+                + `Do NOT retry the same call again. Diagnose the root cause, change approach, or stop and report what you tried.`);
+        }
+    }
+    // Same tool call with identical arguments repeated — even successful calls
+    // that produce no new information are a waste. Warn from 2 repeats.
+    const repeatedCalls = countConsecutiveTailDuplicates(counters.recentToolCallHashes);
+    if (repeatedCalls >= 2) {
+        parts.push(`⚠️ You have called the same tool with identical arguments ${repeatedCalls} times in a row `
+            + `(hard limit: ${resolvedLimits.maxRepeatedToolCalls}). `
+            + `Either the call is idempotent (stop repeating it) or your approach isn't working (change strategy).`);
+    }
+    // Existing counter-based soft warnings (maxTurns, maxToolCalls, etc.)
+    const limitCheck = checkLimits(counters, resolvedLimits);
+    if (limitCheck.status === 'soft_warning') {
+        parts.push(`⚠️ Approaching ${limitCheck.limitName} limit: ${limitCheck.currentValue}/${limitCheck.hardLimit}. `
+            + `Wrap up your current task or you will be stopped.`);
+    }
+    return parts.length > 0 ? parts.join('\n\n') : null;
+})
+    .build();
+//# sourceMappingURL=plugin.js.map