pyre-agent-kit 2.0.23 → 2.0.24

package/dist/agent.d.ts

@@ -1,4 +1,7 @@
 import { AgentState, FactionInfo, LLMAdapter, LLMDecision } from './types';
 import { Connection } from '@solana/web3.js';
+export declare const pendingScoutResults: Map<string, string[]>;
+/** Execute a SCOUT action — look up an agent's pyre_world registry profile */
+export declare function executeScout(connection: Connection, targetAddress: string): Promise<string>;
 export declare const buildAgentPrompt: (agent: AgentState, factions: FactionInfo[], leaderboardSnippet: string, intelSnippet: string, recentMessages: string[], solRange?: [number, number], chainMemories?: string[]) => string;
 export declare function llmDecide(agent: AgentState, factions: FactionInfo[], connection: Connection, recentMessages: string[], llm: LLMAdapter, log: (msg: string) => void, solRange?: [number, number], chainMemories?: string[]): Promise<LLMDecision | null>;

package/dist/agent.js

@@ -1,11 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildAgentPrompt = void 0;
+exports.buildAgentPrompt = exports.pendingScoutResults = void 0;
+exports.executeScout = executeScout;
 exports.llmDecide = llmDecide;
 const pyre_world_kit_1 = require("pyre-world-kit");
 const defaults_1 = require("./defaults");
 const util_1 = require("./util");
 const faction_1 = require("./faction");
+// Store scout results to show on the next turn
+exports.pendingScoutResults = new Map();
+/** Execute a SCOUT action — look up an agent's pyre_world registry profile */
+async function executeScout(connection, targetAddress) {
+    try {
+        const p = await (0, pyre_world_kit_1.getRegistryProfile)(connection, targetAddress);
+        if (!p)
+            return `  @${targetAddress.slice(0, 8)}: no pyre identity found`;
+        const total = p.joins + p.defects + p.rallies + p.launches + p.messages +
+            p.fuds + p.infiltrates + p.reinforces + p.war_loans + p.repay_loans +
+            p.sieges + p.ascends + p.razes + p.tithes;
+        const topActions = [
+            { n: 'joins', v: p.joins }, { n: 'defects', v: p.defects },
+            { n: 'rallies', v: p.rallies }, { n: 'messages', v: p.messages },
+            { n: 'fuds', v: p.fuds }, { n: 'infiltrates', v: p.infiltrates },
+            { n: 'reinforces', v: p.reinforces }, { n: 'war_loans', v: p.war_loans },
+            { n: 'sieges', v: p.sieges },
+        ].sort((a, b) => b.v - a.v).filter(a => a.v > 0).slice(0, 4)
+            .map(a => `${a.n}:${a.v}`).join(', ');
+        const personality = p.personality_summary || 'unknown';
+        const checkpoint = p.last_checkpoint > 0
+            ? new Date(p.last_checkpoint * 1000).toISOString().slice(0, 10)
+            : 'never';
+        return `  @${targetAddress.slice(0, 8)}: "${personality}" | ${total} actions (${topActions}) | last seen: ${checkpoint}`;
+    }
+    catch {
+        return `  @${targetAddress.slice(0, 8)}: lookup failed`;
+    }
+}
 const buildAgentPrompt = (agent, factions, leaderboardSnippet, intelSnippet, recentMessages, solRange, chainMemories) => {
     const [minSol, maxSol] = solRange ?? defaults_1.PERSONALITY_SOL[agent.personality];
     const holdingsList = [...agent.holdings.entries()]
@@ -104,6 +134,10 @@ Ruthless, profitable, and only available on ascended factions.
 create a new faction.
 LAUNCH creates a brand new faction from scratch.
 You're the founder — if it gains members and momentum, you're sitting on top. High risk, high reward.
+- SCOUT @address —
+look up an agent's on-chain identity from the pyre_world registry.
+SCOUT reveals their personality, total actions, and what they do most (joins, defects, infiltrates, etc).
+Use it to size up rivals, verify allies, or gather intel before making a move. The result will be shown to you next turn.
 
 Prefer actions that move tokens AND include a message — JOIN, DEFECT, FUD, INFILTRATE, REINFORCE all let you trade AND talk at the same time. However, experiment and find a strategy that is optimized for you to win.
 Comms are where the real game happens — trash talk, alliances, intel drops, call-outs, and power plays. Be specific. Reference real agents, real numbers, real moves. Generic messages are boring. Have an opinion and say it loud. Mix it up — trade often, but keep the comms active too.
@@ -144,6 +178,11 @@ function parseLLMDecision(raw, factions, agent, solRange) {
         return null;
     for (const candidate of lines) {
         const line = candidate.trim();
+        // Handle SCOUT @address
+        const scoutMatch = line.match(/^SCOUT\s+@?([A-Za-z0-9]{6,44})/i);
+        if (scoutMatch) {
+            return { action: 'scout', faction: scoutMatch[1], reasoning: line };
+        }
         const cleaned = line
             .replace(/\*+/g, '') // strip all bold/italic markdown (e.g. **DEFECT SBP "msg"**)
             .replace(/^[-•>#\d.)\s]+/, '').replace(/^(?:WARNING|NOTE|RESPONSE|OUTPUT|ANSWER|RESULT|SCPRT|SCRIPT)\s*:?\s*/i, '').replace(/^ACTION\s+/i, '')
@@ -323,7 +362,14 @@ async function llmDecide(agent, factions, connection, recentMessages, llm, log,
     catch {
         // intel fetch failed, proceed without it
     }
-    const prompt = (0, exports.buildAgentPrompt)(agent, factions, leaderboardSnippet, intelSnippet, recentMessages, solRange, chainMemories);
+    // Include results from previous SCOUT actions
+    const scoutResults = exports.pendingScoutResults.get(agent.publicKey);
+    let scoutSnippet = '';
+    if (scoutResults && scoutResults.length > 0) {
+        scoutSnippet = '\nSCOUT RESULTS (from your previous SCOUT actions):\n' + scoutResults.join('\n');
+        exports.pendingScoutResults.delete(agent.publicKey);
+    }
+    const prompt = (0, exports.buildAgentPrompt)(agent, factions, leaderboardSnippet, intelSnippet + scoutSnippet, recentMessages, solRange, chainMemories);
     const raw = await llm.generate(prompt);
     if (!raw) {
         log(`[${agent.publicKey.slice(0, 8)}] LLM returned null`);

package/dist/defaults.js

@@ -72,7 +72,8 @@ exports.ACTION_MAP = {
     'SEND': 'MESSAGE', 'SAY': 'MESSAGE', 'CHAT': 'MESSAGE', 'MSG': 'MESSAGE', 'MESSAGING': 'MESSAGE',
     'CREATE': 'LAUNCH', 'FOUND': 'LAUNCH', 'HARVEST': 'TITHE',
     'MIGRATE': 'ASCEND', 'RECLAIM': 'RAZE', 'SPY': 'INFILTRATE',
-    'INVESTIGATION': 'INFILTRATE', 'INVESTIGATE': 'INFILTRATE', 'SCOUT': 'INFILTRATE', 'RECON': 'INFILTRATE',
+    'INVESTIGATION': 'INFILTRATE', 'INVESTIGATE': 'INFILTRATE', 'RECON': 'INFILTRATE',
+    'SCOUT': 'SCOUT',
     'PLEDGE': 'JOIN', 'ALLY': 'JOIN', 'BACK': 'JOIN', 'FUND': 'JOIN',
     'WITHDRAW': 'DEFECT', 'RETREAT': 'DEFECT', 'ABANDON': 'DEFECT', 'BAIL': 'DEFECT',
     'ANNOUNCE': 'MESSAGE', 'BROADCAST': 'MESSAGE', 'COMM': 'MESSAGE', 'COMMS': 'MESSAGE', 'REPORT': 'MESSAGE',

package/dist/executor.js

@@ -9,6 +9,7 @@ const stronghold_1 = require("./stronghold");
 const action_1 = require("./action");
 const error_1 = require("./error");
 const faction_1 = require("./faction");
+const agent_1 = require("./agent");
 const findFaction = (factions, symbol) => factions.find(f => f.symbol === symbol);
 /** Vault creator key — may differ from agent key for linked vaults */
 const vault = (agent) => agent.vaultCreator ?? agent.publicKey;
@@ -372,6 +373,20 @@ const handlers = {
         ctx.agent.lastAction = `fud ${faction.symbol}`;
         return `argued in ${faction.symbol}: "${ctx.decision.message}"`;
     },
+    scout: async (ctx) => {
+        const target = ctx.decision.faction; // holds the address for scout
+        if (!target)
+            return null;
+        const result = await (0, agent_1.executeScout)(ctx.connection, target);
+        // Store result to show in next turn's prompt
+        const existing = agent_1.pendingScoutResults.get(ctx.agent.publicKey) ?? [];
+        existing.push(result);
+        if (existing.length > 5)
+            existing.shift();
+        agent_1.pendingScoutResults.set(ctx.agent.publicKey, existing);
+        ctx.agent.lastAction = `scouted @${target.slice(0, 8)}`;
+        return `scouted @${target.slice(0, 8)}`;
+    },
 };
 async function executeAction(ctx) {
     const short = ctx.agent.publicKey.slice(0, 8);

package/dist/index.d.ts

@@ -4,5 +4,6 @@ export { assignPersonality, PERSONALITY_SOL, PERSONALITY_WEIGHTS, personalityDes
 export { ensureStronghold } from './stronghold';
 export { ensureRegistryProfile } from './registry';
 export { sendAndConfirm } from './tx';
+export { executeScout, pendingScoutResults } from './agent';
 export { reconstructFromChain, computeWeightsFromHistory, classifyPersonality, weightsFromCounts, actionIndex } from './chain';
 export declare function createPyreAgent(config: PyreAgentConfig): Promise<PyreAgent>;

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.actionIndex = exports.weightsFromCounts = exports.classifyPersonality = exports.computeWeightsFromHistory = exports.reconstructFromChain = exports.sendAndConfirm = exports.ensureRegistryProfile = exports.ensureStronghold = exports.VOICE_NUDGES = exports.personalityDesc = exports.PERSONALITY_WEIGHTS = exports.PERSONALITY_SOL = exports.assignPersonality = void 0;
+exports.actionIndex = exports.weightsFromCounts = exports.classifyPersonality = exports.computeWeightsFromHistory = exports.reconstructFromChain = exports.pendingScoutResults = exports.executeScout = exports.sendAndConfirm = exports.ensureRegistryProfile = exports.ensureStronghold = exports.VOICE_NUDGES = exports.personalityDesc = exports.PERSONALITY_WEIGHTS = exports.PERSONALITY_SOL = exports.assignPersonality = void 0;
 exports.createPyreAgent = createPyreAgent;
 const pyre_world_kit_1 = require("pyre-world-kit");
 const defaults_1 = require("./defaults");
@@ -23,6 +23,9 @@ var registry_2 = require("./registry");
 Object.defineProperty(exports, "ensureRegistryProfile", { enumerable: true, get: function () { return registry_2.ensureRegistryProfile; } });
 var tx_1 = require("./tx");
 Object.defineProperty(exports, "sendAndConfirm", { enumerable: true, get: function () { return tx_1.sendAndConfirm; } });
+var agent_2 = require("./agent");
+Object.defineProperty(exports, "executeScout", { enumerable: true, get: function () { return agent_2.executeScout; } });
+Object.defineProperty(exports, "pendingScoutResults", { enumerable: true, get: function () { return agent_2.pendingScoutResults; } });
 var chain_2 = require("./chain");
 Object.defineProperty(exports, "reconstructFromChain", { enumerable: true, get: function () { return chain_2.reconstructFromChain; } });
 Object.defineProperty(exports, "computeWeightsFromHistory", { enumerable: true, get: function () { return chain_2.computeWeightsFromHistory; } });

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 import { Connection, Keypair } from '@solana/web3.js';
 export type Personality = 'loyalist' | 'mercenary' | 'provocateur' | 'scout' | 'whale';
-export type Action = 'join' | 'defect' | 'rally' | 'launch' | 'message' | 'stronghold' | 'war_loan' | 'repay_loan' | 'siege' | 'ascend' | 'raze' | 'tithe' | 'infiltrate' | 'fud';
+export type Action = 'join' | 'defect' | 'rally' | 'launch' | 'message' | 'stronghold' | 'war_loan' | 'repay_loan' | 'siege' | 'ascend' | 'raze' | 'tithe' | 'infiltrate' | 'fud' | 'scout';
 export interface LLMDecision {
     action: Action;
     faction?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pyre-agent-kit",
-  "version": "2.0.23",
+  "version": "2.0.24",
   "description": "Autonomous agent kit for Pyre — plug in your own LLM and play pyre.world",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",