@nex-ai/nex 0.1.22 → 0.1.23

package/README.md

@@ -1,9 +1,16 @@
-# @nex-ai/nex
+# Nex: Organizational Context & Memory Layer for AI agents
 
 [![npm version](https://img.shields.io/npm/v/@nex-ai/nex)](https://www.npmjs.com/package/@nex-ai/nex)
 [![GitHub](https://img.shields.io/badge/github-nex--crm%2Fnex--as--a--skill-blue)](https://github.com/nex-crm/nex-as-a-skill)
+[![Discord](https://img.shields.io/discord/1234567890?logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/gjSySC3PzV)
 
-Nex CLI provides organizational context & memory to AI agents across 12 platforms.
+Give any AI agent persistent memory & organizational context. One knowledge graph, every agent.
+
+Tell something to OpenClaw. Ask about it in Claude Code. Reference it from Cursor. Context follows you across tools — no copy-pasting, no re-explaining, no lost context.
+
+<a href="https://discord.gg/gjSySC3PzV"><img src="https://img.shields.io/badge/Join%20our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join our Discord" /></a>
+
+Talk to the team, share feedback, and connect with other developers building AI agents with Nex.
 
 **GitHub**: [github.com/nex-crm/nex-as-a-skill](https://github.com/nex-crm/nex-as-a-skill)
 

package/dist/agent/adoption.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Selective insight adoption scoring and credibility tracking.
+ * Determines whether an agent should adopt, test, or reject a gossip insight.
+ */
+import type { GossipInsight } from './gossip.js';
+export interface AdoptionScore {
+    sourceCredibility: number;
+    semanticRelevance: number;
+    temporalFreshness: number;
+    total: number;
+    decision: 'adopt' | 'test' | 'reject';
+}
+export declare function scoreInsight(insight: GossipInsight, _currentContext: string, sourceCredibility?: number): AdoptionScore;
+export declare class CredibilityTracker {
+    private baseDir;
+    private filePath;
+    private data;
+    constructor(baseDir?: string);
+    private load;
+    private save;
+    getCredibility(agentSlug: string): number;
+    recordOutcome(agentSlug: string, success: boolean): void;
+}

package/dist/agent/adoption.js

@@ -0,0 +1,87 @@
+/**
+ * Selective insight adoption scoring and credibility tracking.
+ * Determines whether an agent should adopt, test, or reject a gossip insight.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const CREDIBILITY_WEIGHT = 0.4;
+const RELEVANCE_WEIGHT = 0.4;
+const FRESHNESS_WEIGHT = 0.2;
+const ADOPT_THRESHOLD = 0.7;
+const TEST_THRESHOLD = 0.4;
+// Insights older than 7 days start losing freshness
+const FRESHNESS_HALF_LIFE_MS = 7 * 24 * 60 * 60 * 1000;
+export function scoreInsight(insight, _currentContext, sourceCredibility) {
+    const credibility = sourceCredibility ?? 0.5;
+    const semanticRelevance = Math.max(0, Math.min(1, insight.relevance));
+    const age = Date.now() - insight.timestamp;
+    const temporalFreshness = Math.max(0, Math.exp(-age / FRESHNESS_HALF_LIFE_MS));
+    const total = credibility * CREDIBILITY_WEIGHT +
+        semanticRelevance * RELEVANCE_WEIGHT +
+        temporalFreshness * FRESHNESS_WEIGHT;
+    let decision;
+    if (total >= ADOPT_THRESHOLD) {
+        decision = 'adopt';
+    }
+    else if (total >= TEST_THRESHOLD) {
+        decision = 'test';
+    }
+    else {
+        decision = 'reject';
+    }
+    return {
+        sourceCredibility: credibility,
+        semanticRelevance,
+        temporalFreshness,
+        total,
+        decision,
+    };
+}
+export class CredibilityTracker {
+    baseDir;
+    filePath;
+    data;
+    constructor(baseDir) {
+        this.baseDir = baseDir ?? join(homedir(), '.nex-cli', 'credibility');
+        this.filePath = join(this.baseDir, 'scores.json');
+        this.data = this.load();
+    }
+    load() {
+        try {
+            if (!existsSync(this.filePath))
+                return {};
+            const raw = readFileSync(this.filePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return {};
+        }
+    }
+    save() {
+        mkdirSync(this.baseDir, { recursive: true });
+        writeFileSync(this.filePath, JSON.stringify(this.data, null, 2) + '\n', 'utf-8');
+    }
+    getCredibility(agentSlug) {
+        const record = this.data[agentSlug];
+        if (!record)
+            return 0.5;
+        const total = record.successes + record.failures;
+        if (total === 0)
+            return 0.5;
+        return record.successes / total;
+    }
+    recordOutcome(agentSlug, success) {
+        if (!this.data[agentSlug]) {
+            this.data[agentSlug] = { successes: 0, failures: 0 };
+        }
+        if (success) {
+            this.data[agentSlug].successes++;
+        }
+        else {
+            this.data[agentSlug].failures++;
+        }
+        this.save();
+    }
+}
+//# sourceMappingURL=adoption.js.map

package/dist/agent/adoption.js.map

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

package/dist/agent/gossip.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Gossip layer for knowledge propagation between agents.
+ * Uses Nex Ask/Remember APIs to publish and query insights.
+ */
+import type { NexClient } from '../lib/client.js';
+export interface GossipInsight {
+    content: string;
+    source: string;
+    timestamp: number;
+    relevance: number;
+}
+export declare class GossipLayer {
+    private client;
+    constructor(client: NexClient);
+    publish(agentSlug: string, insight: string, context?: string): Promise<string>;
+    query(agentSlug: string, topic: string): Promise<GossipInsight[]>;
+}

package/dist/agent/gossip.js

@@ -0,0 +1,48 @@
+/**
+ * Gossip layer for knowledge propagation between agents.
+ * Uses Nex Ask/Remember APIs to publish and query insights.
+ */
+export class GossipLayer {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async publish(agentSlug, insight, context) {
+        const taggedContent = `[agent:${agentSlug}] ${insight}`;
+        const tags = ['gossip', `agent:${agentSlug}`];
+        if (context)
+            tags.push(`ctx:${context}`);
+        const result = await this.client.post('/remember', {
+            content: taggedContent,
+            tags,
+        });
+        return result.id ?? 'stored';
+    }
+    async query(agentSlug, topic) {
+        const result = await this.client.post('/search', {
+            query: `[gossip] ${topic}`,
+            limit: 10,
+        });
+        if (!result.results || !Array.isArray(result.results))
+            return [];
+        return result.results
+            .filter(r => {
+            // Exclude the querying agent's own insights
+            const content = r.content ?? '';
+            return !content.startsWith(`[agent:${agentSlug}]`);
+        })
+            .map(r => {
+            const content = r.content ?? '';
+            const sourceMatch = content.match(/^\[agent:([^\]]+)\]/);
+            const source = sourceMatch ? sourceMatch[1] : 'unknown';
+            const cleanContent = content.replace(/^\[agent:[^\]]+\]\s*/, '');
+            return {
+                content: cleanContent,
+                source,
+                timestamp: Date.now(),
+                relevance: r.score ?? 0,
+            };
+        });
+    }
+}
+//# sourceMappingURL=gossip.js.map

package/dist/agent/gossip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gossip.js","sourceRoot":"","sources":["../../src/agent/gossip.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,OAAO,WAAW;IACd,MAAM,CAAY;IAE1B,YAAY,MAAiB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,OAAe,EAAE,OAAgB;QAChE,MAAM,aAAa,GAAG,UAAU,SAAS,KAAK,OAAO,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC,CAAC;QAC9C,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAkB,WAAW,EAAE;YAClE,OAAO,EAAE,aAAa;YACtB,IAAI;SACL,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,EAAE,IAAI,QAAQ,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,KAAa;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAMlC,SAAS,EAAE;YACZ,KAAK,EAAE,YAAY,KAAK,EAAE;YAC1B,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,CAAC;QAEjE,OAAO,MAAM,CAAC,OAAO;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE;YACV,4CAA4C;YAC5C,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;YAChC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,SAAS,GAAG,CAAC,CAAC;QACrD,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,CAAC,EAAE;YACP,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;YAChC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACxD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;YAEjE,OAAO;gBACL,OAAO,EAAE,YAAY;gBACrB,MAAM;gBACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,SAAS,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;aACxB,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;CACF"}

package/dist/agent/loop.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Pi-style state machine agent loop.
+ * Runs idle -> build_context -> stream_llm -> execute_tool -> done cycle.
+ * Mock streamFn used until real LLM integration.
+ */
+import type { AgentConfig, AgentState, StreamFn } from './types.js';
+import type { ToolRegistry } from './tools.js';
+import type { AgentSessionStore } from './session-store.js';
+import type { MessageQueues } from './queues.js';
+import type { GossipLayer } from './gossip.js';
+import type { CredibilityTracker } from './adoption.js';
+type EventName = 'phase_change' | 'tool_call' | 'message' | 'error' | 'done';
+type EventHandler = (...args: unknown[]) => void;
+/**
+ * Mock streamFn that simulates LLM responses.
+ * Returns a text response, optionally followed by a tool call if tools are available.
+ */
+export declare function createMockStreamFn(): StreamFn;
+export declare class AgentLoop {
+    private state;
+    private tools;
+    private sessions;
+    private queues;
+    private streamFn;
+    private gossipLayer;
+    private credibilityTracker;
+    private running;
+    private paused;
+    private eventHandlers;
+    private pendingToolCall;
+    private abortController;
+    /** Tracks whether the current task had any errors (tool failures, LLM errors). */
+    private taskHadError;
+    /** Insights collected during this execution cycle (from tool results, gossip publish calls). */
+    private collectedInsights;
+    constructor(config: AgentConfig, tools: ToolRegistry, sessions: AgentSessionStore, queues: MessageQueues, streamFn?: StreamFn, gossipLayer?: GossipLayer, credibilityTracker?: CredibilityTracker);
+    private setPhase;
+    private emit;
+    on(event: EventName, handler: EventHandler): void;
+    off(event: string, handler: EventHandler): void;
+    getState(): AgentState;
+    tick(): Promise<void>;
+    private buildContext;
+    /**
+     * Query the gossip layer, score each insight, and inject adopted/test insights
+     * into the session as system messages.
+     */
+    private injectGossipInsights;
+    private streamLlm;
+    private executeTool;
+    private handleDone;
+    start(): void;
+    stop(): void;
+    pause(): void;
+    resume(): void;
+    /** Allow external code or tools to push insights for gossip publishing at done phase. */
+    addInsight(insight: string): void;
+}
+export {};

package/dist/agent/loop.js

@@ -0,0 +1,389 @@
+/**
+ * Pi-style state machine agent loop.
+ * Runs idle -> build_context -> stream_llm -> execute_tool -> done cycle.
+ * Mock streamFn used until real LLM integration.
+ */
+import { scoreInsight } from './adoption.js';
+/**
+ * Mock streamFn that simulates LLM responses.
+ * Returns a text response, optionally followed by a tool call if tools are available.
+ */
+export function createMockStreamFn() {
+    return async function* mockStream(messages, tools) {
+        const lastMsg = messages[messages.length - 1];
+        const content = lastMsg?.content ?? '';
+        // If tools available, simulate a tool call for search-like queries
+        if (tools.length > 0 && content.toLowerCase().includes('search')) {
+            const searchTool = tools.find(t => t.name.includes('search'));
+            if (searchTool) {
+                yield {
+                    type: 'tool_call',
+                    toolName: searchTool.name,
+                    toolParams: { query: content },
+                };
+                return;
+            }
+        }
+        yield {
+            type: 'text',
+            content: `Processed: ${content}`,
+        };
+    };
+}
+export class AgentLoop {
+    state;
+    tools;
+    sessions;
+    queues;
+    streamFn;
+    gossipLayer;
+    credibilityTracker;
+    running = false;
+    paused = false;
+    eventHandlers = new Map();
+    pendingToolCall = null;
+    abortController = null;
+    /** Tracks whether the current task had any errors (tool failures, LLM errors). */
+    taskHadError = false;
+    /** Insights collected during this execution cycle (from tool results, gossip publish calls). */
+    collectedInsights = [];
+    constructor(config, tools, sessions, queues, streamFn, gossipLayer, credibilityTracker) {
+        this.tools = tools;
+        this.sessions = sessions;
+        this.queues = queues;
+        this.streamFn = streamFn ?? createMockStreamFn();
+        this.gossipLayer = gossipLayer ?? null;
+        this.credibilityTracker = credibilityTracker ?? null;
+        this.state = {
+            phase: 'idle',
+            config,
+            tokensUsed: 0,
+            costUsd: 0,
+        };
+    }
+    setPhase(phase) {
+        const prev = this.state.phase;
+        this.state.phase = phase;
+        this.emit('phase_change', prev, phase);
+    }
+    emit(event, ...args) {
+        const handlers = this.eventHandlers.get(event);
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    handler(...args);
+                }
+                catch {
+                    // swallow handler errors
+                }
+            }
+        }
+    }
+    on(event, handler) {
+        let set = this.eventHandlers.get(event);
+        if (!set) {
+            set = new Set();
+            this.eventHandlers.set(event, set);
+        }
+        set.add(handler);
+    }
+    off(event, handler) {
+        const set = this.eventHandlers.get(event);
+        if (set) {
+            set.delete(handler);
+        }
+    }
+    getState() {
+        return { ...this.state };
+    }
+    async tick() {
+        if (this.paused)
+            return;
+        // Check for steer interrupts
+        const steerMsg = this.queues.drainSteer(this.state.config.slug);
+        if (steerMsg) {
+            if (this.state.sessionId) {
+                this.sessions.append(this.state.sessionId, {
+                    type: 'system',
+                    content: `[STEER] ${steerMsg}`,
+                });
+            }
+        }
+        switch (this.state.phase) {
+            case 'idle':
+                await this.buildContext();
+                break;
+            case 'build_context':
+                await this.streamLlm();
+                break;
+            case 'stream_llm':
+                if (this.pendingToolCall) {
+                    await this.executeTool();
+                }
+                else {
+                    await this.handleDone();
+                }
+                break;
+            case 'execute_tool':
+                await this.streamLlm();
+                break;
+            case 'done':
+                await this.handleDone();
+                break;
+            case 'error':
+                // Stay in error until reset
+                break;
+        }
+    }
+    async buildContext() {
+        this.setPhase('build_context');
+        this.taskHadError = false;
+        this.collectedInsights = [];
+        if (!this.state.sessionId) {
+            this.state.sessionId = this.sessions.create(this.state.config.slug);
+        }
+        // Inject follow-up messages as context
+        const followUp = this.queues.drainFollowUp(this.state.config.slug);
+        if (followUp) {
+            this.sessions.append(this.state.sessionId, {
+                type: 'user',
+                content: followUp,
+            });
+        }
+        // Query gossip layer for relevant insights from other agents
+        if (this.gossipLayer) {
+            await this.injectGossipInsights();
+        }
+        this.setPhase('build_context');
+    }
+    /**
+     * Query the gossip layer, score each insight, and inject adopted/test insights
+     * into the session as system messages.
+     */
+    async injectGossipInsights() {
+        if (!this.gossipLayer || !this.state.sessionId)
+            return;
+        const topic = this.state.config.expertise.join(', ');
+        let insights;
+        try {
+            insights = await this.gossipLayer.query(this.state.config.slug, topic);
+        }
+        catch {
+            // Gossip query failure is non-fatal; continue without insights
+            return;
+        }
+        if (insights.length === 0)
+            return;
+        const adopted = [];
+        const experimental = [];
+        for (const insight of insights) {
+            const sourceCredibility = this.credibilityTracker
+                ? this.credibilityTracker.getCredibility(insight.source)
+                : undefined;
+            const score = scoreInsight(insight, topic, sourceCredibility);
+            if (score.decision === 'adopt') {
+                adopted.push({ insight, score: score.total });
+            }
+            else if (score.decision === 'test') {
+                experimental.push({ insight, score: score.total });
+            }
+            // 'reject' insights are silently dropped
+        }
+        if (adopted.length > 0) {
+            const lines = adopted.map(a => `- [${a.insight.source}] (score ${a.score.toFixed(2)}): ${a.insight.content}`);
+            this.sessions.append(this.state.sessionId, {
+                type: 'system',
+                content: `[GOSSIP:ADOPTED] Trusted insights from other agents:\n${lines.join('\n')}`,
+            });
+        }
+        if (experimental.length > 0) {
+            const lines = experimental.map(e => `- [${e.insight.source}] (score ${e.score.toFixed(2)}): ${e.insight.content}`);
+            this.sessions.append(this.state.sessionId, {
+                type: 'system',
+                content: `[GOSSIP:TEST] Consider verifying these insights experimentally:\n${lines.join('\n')}`,
+            });
+        }
+    }
+    async streamLlm() {
+        this.setPhase('stream_llm');
+        const history = this.state.sessionId
+            ? this.sessions.getHistory(this.state.sessionId)
+            : [];
+        const messages = history.map(e => ({
+            role: e.type === 'user' ? 'user' : 'assistant',
+            content: e.content,
+        }));
+        if (messages.length === 0) {
+            messages.push({
+                role: 'system',
+                content: `You are ${this.state.config.name}. Expertise: ${this.state.config.expertise.join(', ')}.${this.state.config.personality ? ' ' + this.state.config.personality : ''}`,
+            });
+        }
+        this.abortController = new AbortController();
+        const availableTools = this.tools.list().filter(t => !this.state.config.tools || this.state.config.tools.includes(t.name));
+        let fullText = '';
+        this.pendingToolCall = null;
+        try {
+            for await (const chunk of this.streamFn(messages, availableTools)) {
+                if (this.abortController.signal.aborted)
+                    break;
+                if (chunk.type === 'text' && chunk.content) {
+                    fullText += chunk.content;
+                    this.emit('message', chunk.content);
+                }
+                else if (chunk.type === 'tool_call' && chunk.toolName) {
+                    this.pendingToolCall = {
+                        toolName: chunk.toolName,
+                        params: chunk.toolParams ?? {},
+                        startedAt: Date.now(),
+                    };
+                    break;
+                }
+            }
+        }
+        catch (err) {
+            this.state.error = err instanceof Error ? err.message : String(err);
+            this.setPhase('error');
+            this.emit('error', this.state.error);
+            return;
+        }
+        if (fullText && this.state.sessionId) {
+            this.sessions.append(this.state.sessionId, {
+                type: 'assistant',
+                content: fullText,
+            });
+        }
+    }
+    async executeTool() {
+        if (!this.pendingToolCall) {
+            this.setPhase('stream_llm');
+            return;
+        }
+        this.setPhase('execute_tool');
+        const call = this.pendingToolCall;
+        this.emit('tool_call', call.toolName, call.params);
+        const tool = this.tools.get(call.toolName);
+        if (!tool) {
+            call.error = `Unknown tool: ${call.toolName}`;
+            call.completedAt = Date.now();
+            this.taskHadError = true;
+            if (this.state.sessionId) {
+                this.sessions.append(this.state.sessionId, {
+                    type: 'tool_result',
+                    content: call.error,
+                    metadata: { toolName: call.toolName, error: true },
+                });
+            }
+            this.pendingToolCall = null;
+            return;
+        }
+        const validation = this.tools.validate(call.toolName, call.params);
+        if (!validation.valid) {
+            call.error = `Validation failed: ${validation.errors?.join(', ')}`;
+            call.completedAt = Date.now();
+            this.taskHadError = true;
+            if (this.state.sessionId) {
+                this.sessions.append(this.state.sessionId, {
+                    type: 'tool_result',
+                    content: call.error,
+                    metadata: { toolName: call.toolName, error: true },
+                });
+            }
+            this.pendingToolCall = null;
+            return;
+        }
+        if (this.state.sessionId) {
+            this.sessions.append(this.state.sessionId, {
+                type: 'tool_call',
+                content: JSON.stringify({ tool: call.toolName, params: call.params }),
+                metadata: { toolName: call.toolName },
+            });
+        }
+        const controller = this.abortController ?? new AbortController();
+        try {
+            call.result = await tool.execute(call.params, controller.signal, (partial) => {
+                this.emit('message', partial);
+            });
+            call.completedAt = Date.now();
+            if (this.state.sessionId) {
+                this.sessions.append(this.state.sessionId, {
+                    type: 'tool_result',
+                    content: call.result,
+                    metadata: { toolName: call.toolName },
+                });
+            }
+        }
+        catch (err) {
+            call.error = err instanceof Error ? err.message : String(err);
+            call.completedAt = Date.now();
+            this.taskHadError = true;
+            if (this.state.sessionId) {
+                this.sessions.append(this.state.sessionId, {
+                    type: 'tool_result',
+                    content: call.error,
+                    metadata: { toolName: call.toolName, error: true },
+                });
+            }
+        }
+        // Collect insight from gossip_publish tool calls
+        if (call.toolName === 'nex_gossip_publish' && call.result && !call.error) {
+            const insight = call.params.insight;
+            if (typeof insight === 'string') {
+                this.collectedInsights.push(insight);
+            }
+        }
+        this.pendingToolCall = null;
+    }
+    async handleDone() {
+        // Check if there's more work from queues
+        if (this.queues.hasSteer(this.state.config.slug) || this.queues.hasFollowUp(this.state.config.slug)) {
+            this.setPhase('idle');
+            return;
+        }
+        // Publish any collected insights via gossip layer
+        if (this.gossipLayer && this.collectedInsights.length > 0) {
+            for (const insight of this.collectedInsights) {
+                try {
+                    await this.gossipLayer.publish(this.state.config.slug, insight);
+                }
+                catch {
+                    // Gossip publish failure is non-fatal
+                }
+            }
+            this.collectedInsights = [];
+        }
+        // Update credibility based on task outcome
+        if (this.credibilityTracker) {
+            this.credibilityTracker.recordOutcome(this.state.config.slug, !this.taskHadError);
+        }
+        this.setPhase('done');
+        this.state.lastHeartbeat = Date.now();
+        this.emit('done');
+    }
+    start() {
+        this.running = true;
+        this.paused = false;
+        if (this.state.phase === 'done' || this.state.phase === 'error') {
+            this.setPhase('idle');
+        }
+    }
+    stop() {
+        this.running = false;
+        this.paused = false;
+        if (this.abortController) {
+            this.abortController.abort();
+        }
+        this.setPhase('done');
+    }
+    pause() {
+        this.paused = true;
+    }
+    resume() {
+        this.paused = false;
+    }
+    /** Allow external code or tools to push insights for gossip publishing at done phase. */
+    addInsight(insight) {
+        this.collectedInsights.push(insight);
+    }
+}
+//# sourceMappingURL=loop.js.map