kill-switch-mcp 1.1.2 → 1.1.3

package/src/sdk/pathfinding.ts

@@ -1,57 +0,0 @@
-// Pathfinding stub for npm package
-// The full pathfinding module requires server-side collision data and rsmod WASM.
-// In the npm package, pathfinding is not available — bots use server-side routing.
-
-export interface DoorInfo {
-    level: number;
-    x: number;
-    z: number;
-    shape: number;
-    angle: number;
-    blockrange: boolean;
-}
-
-export function initPathfinding(): void {
-    // No-op in npm package
-}
-
-export function isZoneAllocated(_level: number, _x: number, _z: number): boolean {
-    return false;
-}
-
-export function findLongPath(
-    _level: number,
-    _srcX: number,
-    _srcZ: number,
-    _destX: number,
-    _destZ: number,
-    _maxWaypoints?: number
-): Array<{ x: number; z: number; level: number }> {
-    return [];
-}
-
-export function isTileWalkable(_level: number, _x: number, _z: number): boolean {
-    return true;
-}
-
-export function isFlagged(_x: number, _z: number, _level: number, _masks: number): boolean {
-    return false;
-}
-
-export function isZoneLikelyLand(_level: number, _x: number, _z: number): boolean {
-    return false;
-}
-
-export function findDoorsAlongPath(
-    _waypoints: Array<{ x: number; z: number; level: number }>
-): DoorInfo[] {
-    return [];
-}
-
-export function getDoorAt(_level: number, _x: number, _z: number): DoorInfo | undefined {
-    return undefined;
-}
-
-export function blockDoor(_level: number, _x: number, _z: number): boolean {
-    return false;
-}

package/src/sdk/types.ts

@@ -1,584 +0,0 @@
-// Re-export all types from the agent types module
-// This file provides the full type definitions for remote SDK users
-
-// ============ State Types ============
-
-/** Combat state tracking for player */
-export interface PlayerCombatState {
-    /** Currently engaged in combat (has a target) */
-    inCombat: boolean;
-    /** Index of NPC/player we're targeting (-1 if none) */
-    targetIndex: number;
-    /** Tick when we last took damage (-1 if never) */
-    lastDamageTick: number;
-}
-
-export interface PlayerState {
-    name: string;
-    combatLevel: number;
-    /** Current hitpoints level (boosted/drained) */
-    hp: number;
-    /** Base hitpoints level (max HP) */
-    maxHp: number;
-    x: number;
-    z: number;
-    worldX: number;
-    worldZ: number;
-    /** Map plane/floor: 0=ground, 1=first floor (upstairs), 2=second floor, 3=third floor */
-    level: number;
-    runEnergy: number;
-    runWeight: number;
-    /** Current animation ID (-1 = idle/none) */
-    animId: number;
-    /** Current spot animation ID (-1 = none) */
-    spotanimId: number;
-    /** Combat state tracking */
-    combat: PlayerCombatState;
-}
-
-export interface SkillState {
-    name: string;
-    level: number;
-    baseLevel: number;
-    experience: number;
-}
-
-export interface InventoryItemOption {
-    text: string;
-    opIndex: number;
-}
-
-export interface InventoryItem {
-    slot: number;
-    id: number;
-    name: string;
-    count: number;
-    optionsWithIndex: InventoryItemOption[];
-}
-
-export interface NpcOption {
-    text: string;
-    opIndex: number;
-}
-
-export interface NearbyNpc {
-    index: number;
-    name: string;
-    combatLevel: number;
-    x: number;
-    z: number;
-    distance: number;
-    hp: number;
-    maxHp: number;
-    healthPercent: number | null;
-    targetIndex: number;
-    inCombat: boolean;
-    combatCycle: number;
-    animId: number;
-    spotanimId: number;
-    optionsWithIndex: NpcOption[];
-    /** Convenience array of option text strings */
-    options: string[];
-}
-
-export interface NearbyPlayer {
-    index: number;
-    name: string;
-    combatLevel: number;
-    x: number;
-    z: number;
-    distance: number;
-}
-
-export interface GroundItem {
-    id: number;
-    name: string;
-    count: number;
-    x: number;
-    z: number;
-    distance: number;
-}
-
-export interface LocOption {
-    text: string;
-    opIndex: number;
-}
-
-export interface NearbyLoc {
-    id: number;
-    name: string;
-    x: number;
-    z: number;
-    distance: number;
-    optionsWithIndex: LocOption[];
-    /** Convenience array of option text strings */
-    options: string[];
-}
-
-export interface GameMessage {
-    type: number;
-    text: string;
-    sender: string;
-    tick: number;
-}
-
-export interface DialogEntry {
-    text: string[];      // Lines of text in the dialog
-    tick: number;        // Game tick when captured
-    interfaceId: number; // Interface ID of the dialog
-}
-
-export interface DialogOption {
-    index: number;
-    text: string;
-    componentId?: number;
-    buttonType?: number;
-}
-
-export interface DialogComponent {
-    id: number;
-    type: number;
-    buttonType: number;
-    option: string;
-    text: string;
-}
-
-export interface DialogState {
-    isOpen: boolean;
-    options: DialogOption[];
-    isWaiting: boolean;
-    text?: string;
-    allComponents?: DialogComponent[];
-}
-
-export interface InterfaceState {
-    isOpen: boolean;
-    interfaceId: number;
-    options: Array<{ index: number; text: string; componentId: number }>;
-}
-
-export interface ShopItem {
-    slot: number;
-    id: number;
-    name: string;
-    count: number;
-    baseCost: number;
-    buyPrice: number;
-    sellPrice: number;
-}
-
-export interface ShopConfig {
-    buyMultiplier: number;
-    sellMultiplier: number;
-    haggle: number;
-}
-
-export interface ShopState {
-    isOpen: boolean;
-    title: string;
-    shopItems: ShopItem[];
-    playerItems: ShopItem[];
-    shopConfig?: ShopConfig;
-}
-
-export interface BankItem {
-    slot: number;
-    id: number;
-    name: string;
-    count: number;
-}
-
-export interface BankState {
-    isOpen: boolean;
-    items: BankItem[];
-}
-
-export interface CombatStyleOption {
-    index: number;
-    name: string;
-    type: string;
-    trainedSkill: string;
-}
-
-export interface CombatStyleState {
-    currentStyle: number;
-    weaponName: string;
-    styles: CombatStyleOption[];
-}
-
-export interface CombatEvent {
-    tick: number;
-    type: 'damage_taken' | 'damage_dealt' | 'kill';
-    damage: number;
-    sourceType: 'player' | 'npc' | 'other_player';
-    sourceIndex: number;
-    targetType: 'player' | 'npc' | 'other_player';
-    targetIndex: number;
-}
-
-// ============ Prayer Types ============
-
-export type PrayerName =
-    | 'thick_skin' | 'burst_of_strength' | 'clarity_of_thought'
-    | 'rock_skin' | 'superhuman_strength' | 'improved_reflexes'
-    | 'rapid_restore' | 'rapid_heal' | 'protect_items'
-    | 'steel_skin' | 'ultimate_strength' | 'incredible_reflexes'
-    | 'protect_from_magic' | 'protect_from_missiles' | 'protect_from_melee';
-
-export const PRAYER_NAMES: PrayerName[] = [
-    'thick_skin', 'burst_of_strength', 'clarity_of_thought',
-    'rock_skin', 'superhuman_strength', 'improved_reflexes',
-    'rapid_restore', 'rapid_heal', 'protect_items',
-    'steel_skin', 'ultimate_strength', 'incredible_reflexes',
-    'protect_from_magic', 'protect_from_missiles', 'protect_from_melee',
-];
-
-export const PRAYER_INDICES: Record<PrayerName, number> = {
-    'thick_skin': 0, 'burst_of_strength': 1, 'clarity_of_thought': 2,
-    'rock_skin': 3, 'superhuman_strength': 4, 'improved_reflexes': 5,
-    'rapid_restore': 6, 'rapid_heal': 7, 'protect_items': 8,
-    'steel_skin': 9, 'ultimate_strength': 10, 'incredible_reflexes': 11,
-    'protect_from_magic': 12, 'protect_from_missiles': 13, 'protect_from_melee': 14,
-};
-
-/** Required prayer level for each prayer (indexed 0-14) */
-export const PRAYER_LEVELS: number[] = [
-    1, 4, 7,    // thick_skin, burst_of_strength, clarity_of_thought
-    10, 13, 16, // rock_skin, superhuman_strength, improved_reflexes
-    19, 22, 25, // rapid_restore, rapid_heal, protect_items
-    28, 31, 34, // steel_skin, ultimate_strength, incredible_reflexes
-    37, 40, 43, // protect_from_magic, protect_from_missiles, protect_from_melee
-];
-
-export interface PrayerState {
-    /** Active state of each prayer (indexed 0-14, matching PRAYER_NAMES order) */
-    activePrayers: boolean[];
-    /** Current prayer points (current skill level - drains while prayers active) */
-    prayerPoints: number;
-    /** Base prayer level */
-    prayerLevel: number;
-}
-
-export interface PrayerResult {
-    success: boolean;
-    message: string;
-    reason?: 'invalid_prayer' | 'no_prayer_points' | 'level_too_low' | 'already_active' | 'already_inactive' | 'timeout';
-}
-
-export interface BotWorldState {
-    tick: number;
-    inGame: boolean;
-    player: PlayerState | null;
-    skills: SkillState[];
-    inventory: InventoryItem[];
-    equipment: InventoryItem[];
-    nearbyNpcs: NearbyNpc[];
-    nearbyPlayers: NearbyPlayer[];
-    nearbyLocs: NearbyLoc[];
-    groundItems: GroundItem[];
-    gameMessages: GameMessage[];
-    recentDialogs: DialogEntry[];
-    dialog: DialogState;
-    interface: InterfaceState;
-    shop: ShopState;
-    bank: BankState;
-    modalOpen: boolean;
-    modalInterface: number;
-    combatStyle?: CombatStyleState;
-    combatEvents: CombatEvent[];
-    prayers: PrayerState;
-}
-
-// ============ Action Types ============
-
-export type BotAction =
-    | { type: 'none'; reason: string }
-    | { type: 'wait'; reason: string; ticks?: number }
-    | { type: 'talkToNpc'; npcIndex: number; reason: string }
-    | { type: 'interactNpc'; npcIndex: number; optionIndex: number; reason: string }
-    | { type: 'interactPlayer'; playerIndex: number; optionIndex: number; reason: string }
-    | { type: 'clickDialogOption'; optionIndex: number; reason: string }
-    // clickComponent: IF_BUTTON packet - for simple buttons, spellcasting, etc.
-    | { type: 'clickComponent'; componentId: number; reason: string }
-    // clickComponentWithOption: INV_BUTTON packet - for components with inventory operations (smithing, crafting, etc.)
-    | { type: 'clickComponentWithOption'; componentId: number; optionIndex: number; slot?: number; reason: string }
-    // TODO: acceptCharacterDesign should be parameterized as (gender, kits[7], colours[5])
-    // Currently uses hidden client state - the SDK cannot set design values before accepting.
-    // For now, bot client uses whatever design state exists (usually defaults or randomized).
-    | { type: 'acceptCharacterDesign'; reason: string }
-    // Randomize character appearance (gender, body parts, colors) with valid random values
-    | { type: 'randomizeCharacterDesign'; reason: string }
-    | { type: 'walkTo'; x: number; z: number; running?: boolean; reason: string }
-    | { type: 'useInventoryItem'; slot: number; optionIndex: number; reason: string }
-    | { type: 'useEquipmentItem'; slot: number; optionIndex: number; reason: string }
-    | { type: 'dropItem'; slot: number; reason: string }
-    | { type: 'pickupItem'; x: number; z: number; itemId: number; reason: string }
-    | { type: 'interactGroundItem'; x: number; z: number; itemId: number; optionIndex: number; reason: string }
-    | { type: 'interactLoc'; x: number; z: number; locId: number; optionIndex: number; reason: string }
-    | { type: 'shopBuy'; slot: number; amount: number; reason: string }
-    | { type: 'shopSell'; slot: number; amount: number; reason: string }
-    | { type: 'closeShop'; reason: string }
-    | { type: 'closeModal'; reason: string }
-    | { type: 'setCombatStyle'; style: number; reason: string }
-    | { type: 'useItemOnItem'; sourceSlot: number; targetSlot: number; reason: string }
-    | { type: 'useItemOnLoc'; itemSlot: number; x: number; z: number; locId: number; reason: string }
-    | { type: 'useItemOnNpc'; itemSlot: number; npcIndex: number; reason: string }
-    | { type: 'say'; message: string; reason: string }
-    | { type: 'spellOnNpc'; npcIndex: number; spellComponent: number; reason: string }
-    | { type: 'spellOnItem'; slot: number; spellComponent: number; reason: string }
-    | { type: 'setTab'; tabIndex: number; reason: string }
-    | { type: 'bankDeposit'; slot: number; amount: number; reason: string }
-    | { type: 'bankWithdraw'; slot: number; amount: number; reason: string }
-    | { type: 'scanNearbyLocs'; radius?: number; reason: string }
-    | { type: 'scanGroundItems'; radius?: number; reason: string }
-    | { type: 'togglePrayer'; prayerIndex: number; reason: string };
-
-export interface ActionResult {
-    success: boolean;
-    message: string;
-    /** Optional data payload (used by scan actions to return results) */
-    data?: any;
-}
-
-// ============ SDK Config ============
-
-/** Connection mode: 'control' can send actions, 'observe' is read-only */
-export type SDKConnectionMode = 'control' | 'observe';
-
-export interface SDKConfig {
-    botUsername: string;
-    /** Password for gateway authentication */
-    password?: string;
-    /** Full WebSocket URL (e.g. wss://server.com/gateway). Overrides host/port if set. */
-    gatewayUrl?: string;
-    /** Gateway hostname (default: localhost) */
-    host?: string;
-    /** Gateway port (default: 7780) */
-    port?: number;
-    /** Connection mode: 'control' (default) can send actions, 'observe' is read-only */
-    connectionMode?: SDKConnectionMode;
-    /**
-     * Auto-launch browser behavior:
-     * - 'auto' (default): Launch only if no active client with fresh state data
-     * - true: Always launch if bot not connected
-     * - false: Never auto-launch
-     */
-    autoLaunchBrowser?: boolean | 'auto';
-    /** How recent state data must be (ms) to be considered "fresh" in auto mode (default: 3000) */
-    freshDataThreshold?: number;
-    /** Override client URL for auto-launch (derived from gatewayUrl if not set) */
-    browserLaunchUrl?: string;
-    /** Timeout waiting for bot to connect after browser launch (default: 30000ms) */
-    browserLaunchTimeout?: number;
-    actionTimeout?: number;
-    autoReconnect?: boolean;
-    reconnectMaxRetries?: number;
-    reconnectBaseDelay?: number;
-    reconnectMaxDelay?: number;
-    /** Show other players' chat messages (default: false for safety) */
-    showChat?: boolean;
-}
-
-/** Session status from gateway diagnostics */
-export type SessionStatus = 'active' | 'dead';
-
-/** Bot status from gateway /status/:username endpoint */
-export interface BotStatus {
-    /** Session status: active (WebSocket connected), dead (disconnected) */
-    status: SessionStatus;
-    /** Whether bot is currently in-game */
-    inGame: boolean;
-    /** Milliseconds since last state was received (null if never) */
-    stateAge: number | null;
-    /** SDK clients controlling this bot */
-    controllers: string[];
-    /** SDK clients observing this bot */
-    observers: string[];
-    /** Basic player info (null if not in-game) */
-    player: {
-        name: string;
-        worldX: number;
-        worldZ: number;
-    } | null;
-}
-
-export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
-
-// ============ Result Types ============
-
-export interface ChopTreeResult {
-    success: boolean;
-    logs?: InventoryItem;
-    message: string;
-}
-
-export interface BurnLogsResult {
-    success: boolean;
-    xpGained: number;
-    message: string;
-}
-
-export interface PickupResult {
-    success: boolean;
-    item?: InventoryItem;
-    message: string;
-    reason?: 'item_not_found' | 'cant_reach' | 'inventory_full' | 'timeout';
-}
-
-export interface TalkResult {
-    success: boolean;
-    dialog?: DialogState;
-    message: string;
-}
-
-export interface ShopResult {
-    success: boolean;
-    item?: InventoryItem;
-    message: string;
-}
-
-export interface ShopSellResult {
-    success: boolean;
-    message: string;
-    amountSold?: number;
-    rejected?: boolean;
-}
-
-export type SellAmount = 1 | 5 | 10 | 'all';
-
-export interface EquipResult {
-    success: boolean;
-    message: string;
-}
-
-export interface UnequipResult {
-    success: boolean;
-    message: string;
-    item?: InventoryItem;
-}
-
-export interface EatResult {
-    success: boolean;
-    hpGained: number;
-    message: string;
-}
-
-export interface AttackResult {
-    success: boolean;
-    message: string;
-    reason?: 'npc_not_found' | 'player_not_found' | 'no_attack_option' | 'out_of_reach' | 'already_in_combat' | 'timeout';
-}
-
-export interface CastSpellResult {
-    success: boolean;
-    message: string;
-    hit?: boolean;
-    xpGained?: number;
-    reason?: 'npc_not_found' | 'out_of_reach' | 'no_runes' | 'timeout';
-}
-
-export interface OpenDoorResult {
-    success: boolean;
-    message: string;
-    reason?: 'door_not_found' | 'no_open_option' | 'already_open' | 'walk_failed' | 'open_failed' | 'timeout';
-    door?: NearbyLoc;
-}
-
-export interface FletchResult {
-    success: boolean;
-    message: string;
-    xpGained?: number;
-    product?: InventoryItem;
-}
-
-export interface CraftLeatherResult {
-    success: boolean;
-    message: string;
-    xpGained?: number;
-    itemsCrafted?: number;
-    reason?: 'no_needle' | 'no_leather' | 'no_thread' | 'interface_not_opened' | 'level_too_low' | 'timeout' | 'no_xp_gained';
-}
-
-export interface SmithResult {
-    success: boolean;
-    message: string;
-    xpGained?: number;
-    itemsSmithed?: number;
-    product?: InventoryItem;
-    reason?: 'no_hammer' | 'no_bars' | 'no_anvil' | 'interface_not_opened' | 'level_too_low' | 'timeout' | 'no_xp_gained';
-}
-
-export interface OpenBankResult {
-    success: boolean;
-    message: string;
-    reason?: 'no_bank_found' | 'no_bank_option' | 'timeout' | 'dialog_stuck' | 'cant_reach';
-}
-
-export interface BankDepositResult {
-    success: boolean;
-    message: string;
-    amountDeposited?: number;
-    reason?: 'bank_not_open' | 'item_not_found' | 'timeout';
-}
-
-export interface BankWithdrawResult {
-    success: boolean;
-    message: string;
-    item?: InventoryItem;
-    reason?: 'bank_not_open' | 'item_not_found' | 'timeout';
-}
-
-export interface UseItemOnLocResult {
-    success: boolean;
-    message: string;
-    reason?: 'item_not_found' | 'loc_not_found' | 'cant_reach' | 'timeout';
-}
-
-export interface UseItemOnNpcResult {
-    success: boolean;
-    message: string;
-    reason?: 'item_not_found' | 'npc_not_found' | 'cant_reach' | 'timeout';
-}
-
-export interface InteractLocResult {
-    success: boolean;
-    message: string;
-    reason?: 'loc_not_found' | 'no_matching_option' | 'cant_reach' | 'timeout';
-}
-
-export interface InteractNpcResult {
-    success: boolean;
-    message: string;
-    reason?: 'npc_not_found' | 'no_matching_option' | 'cant_reach' | 'timeout';
-}
-
-export interface PickpocketResult {
-    success: boolean;
-    message: string;
-    xpGained?: number;
-    reason?: 'npc_not_found' | 'no_pickpocket_option' | 'cant_reach' | 'stunned' | 'timeout';
-}
-
-export interface CraftJewelryResult {
-    success: boolean;
-    message: string;
-    xpGained?: number;
-    product?: InventoryItem;
-    reason?: 'no_bar' | 'no_mould' | 'no_furnace' | 'no_gem' | 'interface_not_opened' | 'level_too_low' | 'timeout';
-}
-
-export interface EnchantResult {
-    success: boolean;
-    message: string;
-    xpGained?: number;
-    product?: InventoryItem;
-    reason?: 'item_not_found' | 'no_runes' | 'level_too_low' | 'timeout';
-}
-
-export interface StringAmuletResult {
-    success: boolean;
-    message: string;
-    xpGained?: number;
-    product?: InventoryItem;
-    reason?: 'no_amulet' | 'no_string' | 'level_too_low' | 'timeout';
-}