pyre-agent-kit 10.0.1 → 10.1.0

package/dist/agent.js

@@ -171,40 +171,40 @@ REPLACE * with a ONE sentence RESPONSE, always in double quotes.
 (?) $ → borrow against position.
 (>) $ → liquidate bad loan.
 (<) $ → repay loan.
-(%) "..." → create new faction. "..." = creative name, in quotes.
+(%) "{" → create new faction. { = creative name, always in double quotes.
 (_) → skip turn.
 --- RULES:
 (&) and (/) increase MCAP. (-) decreases MCAP.
 (!) and (#) are your voice. (!) increases SENT. (#) decreases SENT.
-(/) FACTIONS where MBR=false.
-(-) or (#) FACTIONS where MBR=true.
 (^) FACTIONS where STATUS=RD.
 (~) FACTIONS where STATUS=ASN.
+(/) FACTIONS where MBR=false.
+(-) or (#) FACTIONS where MBR=true.
 (?) or (>) FACTIONS where STATUS=ASN and MBR=true.
 (<) FACTIONS where LOAN=true.
 (&) or (!) any FACTIONS.
 --- VOICE:
-your personality is your tone. first person only. do not reference your NAME in third person.
-talk TO or ABOUT agents from ALLIES, RIVALS, and LATEST, referencing the agent with @AP, inside RESPONSE.
-do NOT copy what other agents are saying in LATEST. be unique. do not sound like everyone else.
-what you say MUST match the intent of your action.
-under 80 chars, plain English, one sentence. no hashtags, no angle brackets.
-when called out or boasting, back up claims with real numbers from HLTH, VALUE, SENT. never generic.
-do NOT just talk numbers. build your faction community and culture. form collective identities.
+: your personality is your tone. first person only. do not reference your NAME in third person.
+: talk TO or ABOUT agents from ALLIES, RIVALS, and LATEST, referencing the agent using their @AP label, inside RESPONSE.
+: do NOT copy what other agents are saying in LATEST. be unique. do not sound like everyone else.
+: what you say MUST match the intent of your action.
+: under 80 chars, plain English, one sentence. no hashtags, no angle brackets.
+: when called out or boasting, back up claims with real numbers from HLTH, VALUE, SENT. never generic.
+: do NOT just talk numbers. build your faction community and culture. form collective identities.
 --- STRATEGIES:
-learn about FACTIONS and other agents in LATEST. HLTH is your performance. PNL and SENT are per-faction direction. use all three to decide.
-limit FACTIONS where MBR=true to AT MOST 5.${positionValues.length > 3 ? ` MBR at ${positionValues.length} — consider (-) from underperformers.` : ''}
-if MBR=false and FNR=true, consider (&). this is your faction, promote it with (!).
-FACTIONS where MBR=true and SENT is positive ARE your identity. promote what you hold.${factionCtx.all.length <= 2 ? '\n- no FACTIONS? (%) to create one.' : ''}
-FACTIONS where STATUS=RS and MBR=false and lower MCAP could turn more profit if you (&) the right one.
-(!) or (#) help you coordinate and talk with other agents.
-in FACTIONS where MBR=true, if MCAP increases, your PNL will increase.
-(&) or (!) strengthen FACTIONS where MBR=true and STATUS=RS and push towards STATUS=ASN.
-(/) to join a faction with intentions of (-) later. (/) when you are profit seeking or want to harm a rival faction.
-consider (-) to lock in profits on FACTIONS where MBR=true and PNL is positive.
-consider (-) FACTIONS where MBR=true and PNL is negative unless FNR=true or SENT is positive.
-when HLTH is negative, prefer (_) or (-) weakest FACTIONS where MBR=true. (&) ONLY if you see opportunity.
-(_) if you would prefer to hold and wait to take action.
+: learn about FACTIONS and other agents in LATEST. HLTH is your performance. PNL and SENT are per-faction direction. use all three to decide.
+: limit FACTIONS where MBR=true to AT MOST 5.${positionValues.length > 3 ? ` MBR at ${positionValues.length} — consider (-) from underperformers.` : ''}
+: if MBR=false and FNR=true, consider (&). this is your faction, promote it with (!).
+: FACTIONS where MBR=true and SENT is positive ARE your identity. promote what you hold.${factionCtx.all.length <= 2 ? '\n- no FACTIONS? (%) to create one.' : ''}
+: FACTIONS where STATUS=RS and MBR=false and lower MCAP could turn more profit if you (&) the right one.
+: (!) or (#) help you coordinate with other agents.
+: in FACTIONS where MBR=true, if MCAP increases, your PNL will increase.
+: (&) or (!) strengthen FACTIONS where MBR=true and STATUS=RS and push towards STATUS=ASN.
+: (/) to join a faction with intentions of (-) later. (/) when you are profit seeking or want to harm a rival faction.
+: consider (-) to lock in profits on FACTIONS where MBR=true and PNL is positive.
+: consider (-) FACTIONS where MBR=true and PNL is negative unless FNR=true or SENT is positive.
+: when HLTH is negative, prefer (_) or (-) weakest FACTIONS where MBR=true. (&) ONLY if you see opportunity.
+: (_) if you would prefer to hold and wait to take action.
 ---
 one move per turn. output EXACTLY one line.
 example format: ${(0, util_1.pick)([
@@ -363,7 +363,7 @@ REPLACE * with a ONE sentence RESPONSE, always in double quotes.
 (#) $ "*" → trash talk.
 (^) $ → ascend. unlock treasury.
 (~) $ → harvest fees.
-(%) "..." → create new faction. "..." = creative name, in quotes.
+(%) "{" → create new faction. { = creative name, always in double quotes.
 (_) → skip turn.
 --- RULES:
 (&) increases MCAP. (-) decreases MCAP.
@@ -373,18 +373,18 @@ REPLACE * with a ONE sentence RESPONSE, always in double quotes.
 (-) or (#) FACTIONS where MBR=true.
 (&) or (!) any FACTIONS.
 --- STRATEGIES:
-your personality is your tone.
-no FACTIONS? (%) to create one.
-learn about FACTIONS and other agents in INTEL. HLTH is performance. PNL and SENT are per-faction direction. use all three to decide.
-limit FACTIONS where MBR=true to AT MOST 5.${memberOf.length > 3 ? ` MBR=true on ${memberOf.length} FACTIONS — consider (-) from underperformers.` : ''}
-consider (&) FACTIONS where FNR=true. (!) to promote it.
-in FACTIONS where MBR=true, if MCAP increases, your PNL will increase.
-FACTIONS where STATUS=RS may have higher reward if you (&) the right one.
-(&) or (!) strengthen FACTIONS where STATUS=RS and push towards STATUS=ASN.
-consider (-) FACTIONS where MBR=true and PNL is positive to lock in profits.
-consider (-) FACTIONS where MBR=true and PNL is negative unless FNR=true or SENT is positive.
-when HLTH is negative, consider (_) or (-) weakest FACTIONS where MBR=true. (&) ONLY if you see opportunity.
-(_) if you would prefer to hold and wait to take action.
+: your personality is your tone.
+: no FACTIONS? (%) to create one.
+: learn about FACTIONS and other agents in INTEL. HLTH is performance. PNL and SENT are per-faction direction. use all three to decide.
+: limit FACTIONS where MBR=true to AT MOST 5.${memberOf.length > 3 ? ` MBR=true on ${memberOf.length} FACTIONS — consider (-) from underperformers.` : ''}
+: consider (&) FACTIONS where FNR=true. (!) to promote it.
+: in FACTIONS where MBR=true, if MCAP increases, your PNL will increase.
+: FACTIONS where STATUS=RS may have higher reward if you (&) the right one.
+: (&) or (!) strengthen FACTIONS where STATUS=RS and push towards STATUS=ASN.
+: consider (-) FACTIONS where MBR=true and PNL is positive to lock in profits.
+: consider (-) FACTIONS where MBR=true and PNL is negative unless FNR=true or SENT is positive.
+: when HLTH is negative, consider (_) or (-) weakest FACTIONS where MBR=true. (&) ONLY if you see opportunity.
+: (_) if you would prefer to hold and wait to take action.
 ---
 one move per turn. output EXACTLY one line.
 example format: ${(0, util_1.pick)([
@@ -541,7 +541,7 @@ REPLACE * with a ONE sentence RESPONSE, always in double quotes.
 (#) $ "*" → trash talk.
 (^) $ → ascend. unlock treasury.
 (~) $ → harvest fees.
-(%) "..." → create new faction. "..." = creative name, in quotes.
+(%) "{" → create new faction. { = creative name, always in double quotes.
 (_) → skip turn.
 --- RULES:
 (&) increases MCAP. (-) decreases MCAP.
@@ -551,18 +551,18 @@ REPLACE * with a ONE sentence RESPONSE, always in double quotes.
 (-) or (#) FACTIONS where MBR=true.
 (&) or (!) any FACTIONS.
 --- STRATEGIES:
-your personality is your tone.
-no FACTIONS? (%) to create one.
-learn about FACTIONS and other agents in INTEL. HLTH is performance. PNL and SENT are per-faction direction. use all three to decide.
-limit FACTIONS where MBR=true to AT MOST 3.${memberOf.length > 1 ? ` MBR=true on ${memberOf.length} FACTIONS — consider (-) from underperformers.` : ''}
-consider (&) FACTIONS where FNR=true. (!) to promote it.
-FACTIONS where STATUS=RS may have higher reward if you (&) the right one.
-in FACTIONS where MBR=true, if MCAP increases, your PNL will increase.
-(&) and (!) strengthen FACTIONS where STATUS=RS and push towards STATUS=ASN.
-consider (-) FACTIONS where MBR=true and PNL is positive to lock in profits.
-consider (-) FACTIONS where MBR=true and PNL is negative unless FNR=true or SENT is positive.
-when HLTH is negative, consider (_) or (-) weakest FACTIONS where MBR=true. (&) ONLY if you see opportunity.
-(_) if you would prefer to hold and wait to take action.
+: your personality is your tone.
+: no FACTIONS? (%) to create one.
+: learn about FACTIONS and other agents in INTEL. HLTH is performance. PNL and SENT are per-faction direction. use all three to decide.
+: limit FACTIONS where MBR=true to AT MOST 3.${memberOf.length > 1 ? ` MBR=true on ${memberOf.length} FACTIONS — consider (-) from underperformers.` : ''}
+: consider (&) FACTIONS where FNR=true. (!) to promote it.
+: FACTIONS where STATUS=RS may have higher reward if you (&) the right one.
+: in FACTIONS where MBR=true, if MCAP increases, your PNL will increase.
+: (&) and (!) strengthen FACTIONS where STATUS=RS and push towards STATUS=ASN.
+: consider (-) FACTIONS where MBR=true and PNL is positive to lock in profits.
+: consider (-) FACTIONS where MBR=true and PNL is negative unless FNR=true or SENT is positive.
+: when HLTH is negative, consider (_) or (-) weakest FACTIONS where MBR=true. (&) ONLY if you see opportunity.
+: (_) if you would prefer to hold and wait to take action.
 ---
 one move per turn. output EXACTLY one line.
 example format: ${(0, util_1.pick)([
@@ -677,7 +677,7 @@ function parseLLMDecision(raw, factions, kit, agent, holdings, solRange) {
             ? symbolActionMatch[1] + ' ' + symbolActionMatch[2]
             : line
                 .replace(/\*+/g, '')
-                .replace(/^[-•>#\d.)\s]+/, '')
+                .replace(/^[-•>\d.)\s]+/, '')
                 .replace(/^(?:WARNING|NOTE|RESPONSE|OUTPUT|ANSWER|RESULT|SCPRT|SCRIPT|YOUR MOVE|YOUR MOVE:|your move>?)\s*:?\s*/i, '')
                 .replace(/^ACTION\s+/i, '')
                 .replace(/^I\s+(?=JOIN|DEFECT|RALLY|LAUNCH|MESSAGE|FUD|REINFORCE|INFILTRATE|WAR_LOAN|REPAY_LOAN|SIEGE|ASCEND|RAZE|TITHE|SCOUT)/i, '')

package/dist/index.d.ts

@@ -6,4 +6,6 @@ export { classifyPersonality, weightsFromCounts, actionIndex } from './chain';
 export { generateFactionIdentity } from './faction';
 export { llmDecide, buildCompactModelPrompt };
 export type { FactionContext, LLMDecideOptions };
+export { getAvailableActions, getValidTargets, MESSAGE_ACTIONS, SOL_ACTIONS } from './validation';
+export type { ActionAvailability } from './validation';
 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.buildCompactModelPrompt = exports.llmDecide = exports.generateFactionIdentity = exports.actionIndex = exports.weightsFromCounts = exports.classifyPersonality = exports.personalityDesc = exports.PERSONALITY_WEIGHTS = exports.PERSONALITY_SOL = exports.assignPersonality = void 0;
+exports.SOL_ACTIONS = exports.MESSAGE_ACTIONS = exports.getValidTargets = exports.getAvailableActions = exports.buildCompactModelPrompt = exports.llmDecide = exports.generateFactionIdentity = exports.actionIndex = exports.weightsFromCounts = exports.classifyPersonality = exports.personalityDesc = exports.PERSONALITY_WEIGHTS = exports.PERSONALITY_SOL = exports.assignPersonality = void 0;
 exports.createPyreAgent = createPyreAgent;
 const defaults_1 = require("./defaults");
 const action_1 = require("./action");
@@ -21,6 +21,11 @@ Object.defineProperty(exports, "weightsFromCounts", { enumerable: true, get: fun
 Object.defineProperty(exports, "actionIndex", { enumerable: true, get: function () { return chain_2.actionIndex; } });
 var faction_1 = require("./faction");
 Object.defineProperty(exports, "generateFactionIdentity", { enumerable: true, get: function () { return faction_1.generateFactionIdentity; } });
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "getAvailableActions", { enumerable: true, get: function () { return validation_1.getAvailableActions; } });
+Object.defineProperty(exports, "getValidTargets", { enumerable: true, get: function () { return validation_1.getValidTargets; } });
+Object.defineProperty(exports, "MESSAGE_ACTIONS", { enumerable: true, get: function () { return validation_1.MESSAGE_ACTIONS; } });
+Object.defineProperty(exports, "SOL_ACTIONS", { enumerable: true, get: function () { return validation_1.SOL_ACTIONS; } });
 async function createPyreAgent(config) {
     const { kit, keypair, llm, maxFoundedFactions = 2 } = config;
     const publicKey = keypair.publicKey.toBase58();

package/dist/validation.d.ts

@@ -0,0 +1,17 @@
+import { Action, FactionInfo } from './types';
+export interface ActionAvailability {
+    enabled: boolean;
+    reason?: string;
+}
+/**
+ * Determine which actions are currently available given the player's state.
+ * Mirrors the validation logic in chooseAction() but returns structured results
+ * for UI consumption (lens page).
+ */
+export declare function getAvailableActions(holdings: Map<string, number>, factions: FactionInfo[], activeLoans: number): Map<Action, ActionAvailability>;
+/** Actions that require a message/memo */
+export declare const MESSAGE_ACTIONS: Set<Action>;
+/** Actions that require a SOL amount input */
+export declare const SOL_ACTIONS: Set<Action>;
+/** Filter factions to valid targets for a given action */
+export declare function getValidTargets(action: Action, factions: FactionInfo[], holdings: Map<string, number>): FactionInfo[];

package/dist/validation.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOL_ACTIONS = exports.MESSAGE_ACTIONS = void 0;
+exports.getAvailableActions = getAvailableActions;
+exports.getValidTargets = getValidTargets;
+/**
+ * Determine which actions are currently available given the player's state.
+ * Mirrors the validation logic in chooseAction() but returns structured results
+ * for UI consumption (lens page).
+ */
+function getAvailableActions(holdings, factions, activeLoans) {
+    const result = new Map();
+    const hasHoldings = holdings.size > 0;
+    const heldMints = [...holdings.keys()];
+    const ascendedFactions = factions.filter((f) => f.status === 'ascended');
+    const readyFactions = factions.filter((f) => f.status === 'ready');
+    const risingFactions = factions.filter((f) => f.status === 'rising');
+    const rivalFactions = factions.filter((f) => !heldMints.includes(f.mint));
+    const holdsAscended = ascendedFactions.some((f) => holdings.has(f.mint));
+    const nonRazed = factions.filter((f) => f.status !== 'razed');
+    // join — always available if factions exist
+    result.set('join', nonRazed.length > 0
+        ? { enabled: true }
+        : { enabled: false, reason: 'no factions' });
+    // defect — requires holdings
+    result.set('defect', hasHoldings
+        ? { enabled: true }
+        : { enabled: false, reason: 'no holdings' });
+    // rally — always available if factions exist (server validates duplicates)
+    result.set('rally', nonRazed.length > 0
+        ? { enabled: true }
+        : { enabled: false, reason: 'no factions' });
+    // launch — always available (server validates max)
+    result.set('launch', { enabled: true });
+    // message — always available if factions exist
+    result.set('message', nonRazed.length > 0
+        ? { enabled: true }
+        : { enabled: false, reason: 'no factions' });
+    // reinforce — requires holdings
+    result.set('reinforce', hasHoldings
+        ? { enabled: true }
+        : { enabled: false, reason: 'no holdings' });
+    // war_loan — requires holding an ascended faction
+    result.set('war_loan', holdsAscended
+        ? { enabled: true }
+        : { enabled: false, reason: 'no ascended holdings' });
+    // repay_loan — requires active loans
+    result.set('repay_loan', activeLoans > 0
+        ? { enabled: true }
+        : { enabled: false, reason: 'no active loans' });
+    // siege — requires ascended factions to exist
+    result.set('siege', ascendedFactions.length > 0
+        ? { enabled: true }
+        : { enabled: false, reason: 'no ascended factions' });
+    // ascend — requires ready factions
+    result.set('ascend', readyFactions.length > 0
+        ? { enabled: true }
+        : { enabled: false, reason: 'no ready factions' });
+    // raze — requires rising factions
+    result.set('raze', risingFactions.length > 0
+        ? { enabled: true }
+        : { enabled: false, reason: 'no rising factions' });
+    // tithe — requires ascended factions
+    result.set('tithe', ascendedFactions.length > 0
+        ? { enabled: true }
+        : { enabled: false, reason: 'no ascended factions' });
+    // infiltrate — requires factions not held
+    result.set('infiltrate', rivalFactions.length > 0
+        ? { enabled: true }
+        : { enabled: false, reason: 'no rival factions' });
+    // fud — requires holdings
+    result.set('fud', hasHoldings
+        ? { enabled: true }
+        : { enabled: false, reason: 'no holdings' });
+    // scout — always available if factions exist
+    result.set('scout', nonRazed.length > 0
+        ? { enabled: true }
+        : { enabled: false, reason: 'no factions' });
+    // hold — always available
+    result.set('hold', { enabled: true });
+    return result;
+}
+/** Actions that require a message/memo */
+exports.MESSAGE_ACTIONS = new Set([
+    'join', 'reinforce', 'defect', 'message', 'fud', 'infiltrate',
+]);
+/** Actions that require a SOL amount input */
+exports.SOL_ACTIONS = new Set([
+    'join', 'reinforce', 'infiltrate',
+]);
+/** Filter factions to valid targets for a given action */
+function getValidTargets(action, factions, holdings) {
+    const heldMints = [...holdings.keys()];
+    const nonRazed = factions.filter((f) => f.status !== 'razed');
+    switch (action) {
+        case 'defect':
+        case 'fud':
+        case 'reinforce':
+            return factions.filter((f) => holdings.has(f.mint));
+        case 'infiltrate':
+            return nonRazed.filter((f) => !heldMints.includes(f.mint));
+        case 'ascend':
+            return factions.filter((f) => f.status === 'ready');
+        case 'raze':
+            return factions.filter((f) => f.status === 'rising');
+        case 'siege':
+        case 'tithe':
+        case 'war_loan':
+            return factions.filter((f) => f.status === 'ascended');
+        case 'repay_loan':
+            return nonRazed; // server validates loan exists
+        case 'hold':
+        case 'launch':
+            return []; // no target needed
+        default:
+            return nonRazed;
+    }
+}

package/package.json

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