pyre-agent-kit 10.0.2 → 10.1.1

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 import { PyreAgentConfig, PyreAgent } from './types';
-import { llmDecide, buildCompactModelPrompt, FactionContext, LLMDecideOptions } from './agent';
+import { llmDecide, buildAgentPrompt, buildCompactModelPrompt, FactionContext, LLMDecideOptions } from './agent';
 export type { PyreAgentConfig, PyreAgent, AgentTickResult, SerializedAgentState, LLMAdapter, LLMDecision, FactionInfo, Personality, Action, AgentState, } from './types';
 export { assignPersonality, PERSONALITY_SOL, PERSONALITY_WEIGHTS, personalityDesc, } from './defaults';
 export { classifyPersonality, weightsFromCounts, actionIndex } from './chain';
 export { generateFactionIdentity } from './faction';
-export { llmDecide, buildCompactModelPrompt };
+export { llmDecide, buildAgentPrompt, 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,11 +1,12 @@
 "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.buildAgentPrompt = 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");
 const agent_1 = require("./agent");
 Object.defineProperty(exports, "llmDecide", { enumerable: true, get: function () { return agent_1.llmDecide; } });
+Object.defineProperty(exports, "buildAgentPrompt", { enumerable: true, get: function () { return agent_1.buildAgentPrompt; } });
 Object.defineProperty(exports, "buildCompactModelPrompt", { enumerable: true, get: function () { return agent_1.buildCompactModelPrompt; } });
 const executor_1 = require("./executor");
 const chain_1 = require("./chain");
@@ -21,6 +22,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.2",
+  "version": "10.1.1",
   "description": "Autonomous agent kit for Pyre — plug in your own LLM and play pyre.world",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",