@valoranchi/riot-client 0.6.1 → 0.7.0

package/README.md

@@ -232,6 +232,7 @@ riotclient missions
 riotclient penalties
 riotclient favourites
 riotclient session
+riotclient play-session
 riotclient config
 riotclient friends
 riotclient friend-requests

package/dist/analysis/session.d.ts

@@ -0,0 +1,10 @@
+import type { Catalogue } from "../catalogue/Catalogue.js";
+import type { Match, Session } from "../model/index.js";
+import type { RiotCompetitiveUpdate } from "../riot/types.js";
+export interface SessionSummaryOptions {
+    since?: string;
+    puuid?: string;
+    catalogue?: Catalogue;
+}
+export declare function sessionSummary(updates?: RiotCompetitiveUpdate[], matches?: Match[], now?: Date, options?: SessionSummaryOptions): Session;
+//# sourceMappingURL=session.d.ts.map

package/dist/analysis/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/analysis/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,KAAK,EACV,KAAK,EAIL,OAAO,EAER,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAI9D,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAmLD,wBAAgB,cAAc,CAC5B,OAAO,GAAE,qBAAqB,EAAO,EACrC,OAAO,GAAE,KAAK,EAAO,EACrB,GAAG,GAAE,IAAiB,EACtB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAuDT"}

package/dist/analysis/session.js

@@ -0,0 +1,209 @@
+import { RankResolver } from "../collection/RankResolver.js";
+const FOUR_HOURS_MS = 4 * 60 * 60 * 1000;
+function resolvePlayer(match, puuid) {
+    if (puuid) {
+        const byPuuid = match.players.find((p) => p.puuid === puuid);
+        if (byPuuid)
+            return byPuuid;
+    }
+    if (match.self?.team) {
+        const byTeam = match.players.find((p) => p.team === match.self?.team);
+        if (byTeam)
+            return byTeam;
+    }
+    return match.players[0];
+}
+function resolveMatchResult(match, puuid) {
+    if (match.self?.won === true)
+        return "win";
+    if (match.self?.won === false)
+        return "loss";
+    const allyTeam = match.self?.team
+        ? match.teams.find((t) => t.id === match.self?.team)
+        : undefined;
+    const enemyTeam = match.self?.team
+        ? match.teams.find((t) => t.id !== match.self?.team)
+        : undefined;
+    if (allyTeam && enemyTeam) {
+        if (allyTeam.roundsWon > enemyTeam.roundsWon)
+            return "win";
+        if (allyTeam.roundsWon < enemyTeam.roundsWon)
+            return "loss";
+        return "draw";
+    }
+    const player = resolvePlayer(match, puuid);
+    if (player) {
+        const team = match.teams.find((t) => t.id === player.team);
+        if (team?.won)
+            return "win";
+    }
+    if (match.teams.length >= 2) {
+        const [t1, t2] = match.teams;
+        if (t1 && t2) {
+            if (t1.roundsWon > t2.roundsWon)
+                return "win";
+            if (t1.roundsWon < t2.roundsWon)
+                return "loss";
+            return "draw";
+        }
+    }
+    return "draw";
+}
+function findMatchGapStart(matches) {
+    const sorted = [...matches].sort((a, b) => new Date(a.startedAt).getTime() - new Date(b.startedAt).getTime());
+    let lastGapStart = null;
+    for (let i = 1; i < sorted.length; i++) {
+        const prev = sorted[i - 1];
+        const curr = sorted[i];
+        const prevEnd = new Date(prev.startedAt).getTime() + (prev.lengthMs || 0);
+        const currStart = new Date(curr.startedAt).getTime();
+        if (currStart - prevEnd >= FOUR_HOURS_MS) {
+            lastGapStart = currStart;
+        }
+    }
+    return lastGapStart;
+}
+function findUpdateGapStart(updates) {
+    const sorted = [...updates].sort((a, b) => a.MatchStartTime - b.MatchStartTime);
+    let lastGapStart = null;
+    for (let i = 1; i < sorted.length; i++) {
+        const prev = sorted[i - 1];
+        const curr = sorted[i];
+        if (curr.MatchStartTime - prev.MatchStartTime >= FOUR_HOURS_MS) {
+            lastGapStart = curr.MatchStartTime;
+        }
+    }
+    return lastGapStart;
+}
+function resolveEffectiveSince(updates, matches, now, sinceOption) {
+    if (sinceOption) {
+        return new Date(sinceOption).getTime();
+    }
+    const today = new Date(now);
+    today.setHours(0, 0, 0, 0);
+    const todayMs = today.getTime();
+    const gapStart = findMatchGapStart(matches) ?? findUpdateGapStart(updates);
+    return gapStart !== null ? Math.max(todayMs, gapStart) : todayMs;
+}
+function calculateStreak(resultsReversed) {
+    if (resultsReversed.length === 0)
+        return { kind: null, length: 0 };
+    const first = resultsReversed[0];
+    if (!first || first === "draw")
+        return { kind: null, length: 0 };
+    const kind = first;
+    let length = 0;
+    for (const r of resultsReversed) {
+        if (r === kind) {
+            length++;
+        }
+        else {
+            break;
+        }
+    }
+    return { kind, length };
+}
+function calculateTilt(resultsChronological) {
+    const decided = resultsChronological.filter((r) => r === "win" || r === "loss");
+    if (decided.length < 3)
+        return false;
+    const last3 = decided.slice(-3);
+    return last3.every((r) => r === "loss");
+}
+function resolveMatchAcs(match, puuid) {
+    const player = resolvePlayer(match, puuid);
+    const stats = player?.stats;
+    const rounds = stats?.roundsPlayed && stats.roundsPlayed > 0 ? stats.roundsPlayed : 1;
+    const score = stats?.score ?? 0;
+    const acs = rounds > 0 ? Math.round(score / rounds) : score;
+    return {
+        id: match.id,
+        matchId: match.id,
+        acs,
+        map: match.map.name ?? match.map.uuid ?? null,
+        agent: player?.agent?.name ?? null,
+    };
+}
+function createFallbackRank(tier, rating) {
+    if (tier === 0) {
+        return { tier: 0, name: "Unranked", division: null, icon: null, rating };
+    }
+    return {
+        tier,
+        name: `Tier ${tier}`,
+        division: null,
+        icon: null,
+        rating,
+    };
+}
+function resolveRankObject(tier, rating, resolver) {
+    return resolver ? resolver.fromTier(tier, rating) : createFallbackRank(tier, rating);
+}
+function resolveSessionRanks(updates, allUpdates, catalogue) {
+    const resolver = catalogue ? new RankResolver(catalogue) : undefined;
+    if (updates.length > 0) {
+        const sorted = [...updates].sort((a, b) => a.MatchStartTime - b.MatchStartTime);
+        const oldest = sorted[0];
+        const newest = sorted[sorted.length - 1];
+        return {
+            rankStart: resolveRankObject(oldest.TierBeforeUpdate, oldest.RankedRatingBeforeUpdate, resolver),
+            rankNow: resolveRankObject(newest.TierAfterUpdate, newest.RankedRatingAfterUpdate, resolver),
+        };
+    }
+    if (allUpdates.length > 0) {
+        const sorted = [...allUpdates].sort((a, b) => a.MatchStartTime - b.MatchStartTime);
+        const latest = sorted[sorted.length - 1];
+        const rank = resolveRankObject(latest.TierAfterUpdate, latest.RankedRatingAfterUpdate, resolver);
+        return { rankStart: rank, rankNow: rank };
+    }
+    return { rankStart: null, rankNow: null };
+}
+export function sessionSummary(updates = [], matches = [], now = new Date(), options = {}) {
+    const effectiveSince = resolveEffectiveSince(updates, matches, now, options.since);
+    const sessionMatches = matches
+        .filter((m) => new Date(m.startedAt).getTime() >= effectiveSince)
+        .sort((a, b) => new Date(a.startedAt).getTime() - new Date(b.startedAt).getTime());
+    const matchIds = new Set(sessionMatches.map((m) => m.id));
+    const sessionUpdates = updates.filter((u) => matchIds.has(u.MatchID) || u.MatchStartTime >= effectiveSince);
+    let wins = 0;
+    let losses = 0;
+    let draws = 0;
+    const matchResults = [];
+    for (const m of sessionMatches) {
+        const result = resolveMatchResult(m, options.puuid);
+        matchResults.push(result);
+        if (result === "win")
+            wins++;
+        else if (result === "loss")
+            losses++;
+        else
+            draws++;
+    }
+    const rrNet = sessionUpdates.reduce((sum, u) => sum + u.RankedRatingEarned, 0);
+    const totalGames = sessionMatches.length;
+    const rrPerGame = totalGames > 0 ? Math.round((rrNet / totalGames) * 10) / 10 : 0;
+    const streak = calculateStreak([...matchResults].reverse());
+    const tilt = calculateTilt(matchResults);
+    const { rankStart, rankNow } = resolveSessionRanks(sessionUpdates, updates, options.catalogue);
+    const acsEntries = sessionMatches
+        .map((m) => resolveMatchAcs(m, options.puuid))
+        .sort((a, b) => b.acs - a.acs);
+    const bestMatch = acsEntries.length > 0 ? acsEntries[0] : null;
+    const worstMatch = acsEntries.length > 0 ? acsEntries[acsEntries.length - 1] : null;
+    return {
+        since: new Date(effectiveSince).toISOString(),
+        matches: totalGames,
+        wins,
+        losses,
+        draws,
+        rrNet,
+        rrPerGame,
+        streak,
+        rankStart,
+        rankNow,
+        bestMatch,
+        worstMatch,
+        tilt,
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/analysis/session.js.map

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

package/dist/cli.d.ts

@@ -1,8 +1,9 @@
 import { formatError } from "./formatError.js";
 import { RiotClient } from "./RiotClient.js";
+import type { InstalockOptions } from "./watch/index.js";
 import { isSea, openBrowser, printDashboardBanner, runDashboard, shouldLaunchDashboard, startDashboardServer } from "./dashboardLauncher.js";
 export { isSea, openBrowser, printDashboardBanner, runDashboard, shouldLaunchDashboard, startDashboardServer, };
-export declare const USAGE = "Usage: riotclient <command> [options]\n\nAccount:\n  whoami           Print signed-in player profile and region\n  owned-items      Print owned inventory items\n  collection-value Calculate estimated VP and Radianite value of owned collection\n  loadout          Print currently equipped loadout\n  wallet           Print VP, Radianite, and Kingdom Credits balances\n  xp               Print account level, XP progression and recent match XP history\n  contracts        Print progression across agent, battlepass and event contracts\n  missions         Print active daily and weekly missions and objectives\n  penalties        Print active penalties and restrictions\n  favourites       Print favorited weapon skins\n  session          Print current client session loop state and playtime\n  config           Print shared client configuration mapping\n  client           Print client identity, locale, region, and Valorant running state\n  settings         Print cloud player settings (--raw for unprocessed dump)\n  settings-save    Save player settings from JSON file (<file.json>, requires --yes --confirm)\n  equip            Equip skins, buddies, sprays, card, title, border, flex (dry-run, --yes to apply)\n  equip-collection Equip a collection of skins (<skinUuid,...>) (dry-run, --yes to apply)\n  loadout-export   Export current loadout as a preset JSON\n  loadout-diff     Compare current loadout against preset JSON file (<preset.json>)\n  loadout-apply    Apply loadout preset from JSON file (<preset.json>, dry-run, --yes to apply)\n  contract-activate Activate an agent contract (<uuid>) (dry-run, --yes to apply)\n  favourite-add    Add skin to favourites (<skin>) (dry-run, --yes to apply)\n  favourite-remove Remove skin from favourites (<skin>) (dry-run, --yes to apply)\n  privacy          Update account privacy toggles (--badge on|off, --leaderboard on|off)\n\nSocial:\n  friends          Print friends roster and presence\n  friend-requests  Print incoming and outgoing friend requests\n  blocked          Print blocked players\n  conversations    Print whisper and match chat conversations\n  messages         Print chat messages (filter with --cid <id>)\n  participants     Print chat participants (filter with --cid <id>)\n  send             Send chat message (--to <puuid|name#tag|cid> --text <msg>)\n  friend-request   Send friend request (<name#tag>)\n  friend-accept    Accept friend request (<puuid>)\n  friend-decline   Decline friend request (<puuid>)\n  friend-cancel    Cancel friend request (<puuid>)\n  friend-remove    Remove friend (<puuid>)\n  block            Block player (<puuid|name#tag>)\n  unblock          Unblock player (<puuid>)\n\nStore:\n  store            Print storefront (daily, night market, bundles, accessories)\n  store-history    Print recorded daily store rotations [--days <n>]\n  store-seen       Print when a skin was last seen in daily store (<skin>)\n  offers           Print full item offers catalog and pricing\n  order <id>       Print store order details\n  night-market-reveal Reveal night market offers (dry-run, --yes to apply)\n  buy              Purchase offer or bundle (--offer <id> | --bundle <id>, requires --yes --confirm)\n  wishlist         Print skin wishlist or manage items (add <skin>, remove <skin>, check)\n\nMatches:\n  matches          Print recent match history summaries\n  matches-sync     Synchronize match history to local cache [--pages <n>]\n  match <id>       Print full match details by ID\n  mmr              Print current rank, rating, and MMR breakdown\n  rank-history     Print competitive rating adjustments and tier changes\n  live             Print live pregame or in-game lobby status and loadouts\n  matches-for <puuid> Print recent match history summaries for player\n  mmr-for <puuid>  Print rank, rating, and MMR for player\n  rank-history-for <puuid> Print competitive updates for player\n  leaderboard      Print competitive leaderboard [--season] [--start] [--size] [--query]\n  content          Print active act, episode and live events\n  premier          Print premier eligibility, roster, and season info\n  trend            Print competitive rating streak, net RR gains, and climbing pace\n  summary          Print player performance summary across recent matches [--count n] [--queue q]\n  assess [puuid]   Assess player rank anomalies, streaks, and warning flags\n  agent-select     Select an agent in pregame (<uuid|name>) (dry-run, --yes to apply)\n  agent-lock       Lock in an agent in pregame (<uuid|name>) (dry-run, --yes to apply)\n  dodge            Dodge pregame agent select (requires --yes --confirm)\n  leave-match      Leave active in-game match (requires --yes --confirm)\n\nParty:\n  party            Print current party details and members\n  queues           Print matchmaking queue configurations\n  custom-game-configs Print custom game configuration options\n  party-invite     Invite player to party (<name#tag>)\n  party-kick       Kick member from party (<puuid>)\n  party-promote    Promote member to party owner (<puuid>)\n  party-code       Generate or revoke party invite code [--revoke]\n  party-join       Join party by invite code or party ID (<partyId|code>)\n  party-invites    Print incoming party invites\n  party-requests   Print incoming party join requests\n  party-decline-invite Decline party invite (<id>) (dry-run, --yes to apply)\n  party-request    Request to join party (<partyId>) (dry-run, --yes to apply)\n  party-decline-request Decline party join request (<id>) (dry-run, --yes to apply)\n  custom-game      Convert party into a custom game (dry-run, --yes to apply)\n  custom-game-settings Configure custom game (--map <name> --mode <name> [--server <id>] [--rule k=v...])\n  custom-game-team Set member custom game team (<puuid> <team>) (dry-run, --yes to apply)\n  custom-game-start Start custom game match (dry-run, --yes to apply)\n  custom-game-balance Balance custom game teams (dry-run, --yes to apply)\n  party-default    Set party default queue (<queue>) (dry-run, --yes to apply)\n  party-servers    Set preferred game servers (<id,...>) (dry-run, --yes to apply)\n  party-moderator  Set member moderator status (<puuid> on|off) (dry-run, --yes to apply)\n  party-refresh    Refresh party member pings and identity (dry-run, --yes to apply)\n  party-ready      Set party ready state (on|off)\n  party-queue      Change party queue (<queue>)\n  party-access     Set party accessibility (open|closed)\n  party-start      Start party matchmaking\n  party-stop       Stop party matchmaking\n  party-leave      Leave current party\n\nRaw (unsupported):\n  local            Send raw request to local Riot client API (<get|post|put|delete> <path> [--body json])\n  riot             Send raw request to remote Riot game servers (<get|post|put|delete> <url> [--body json])\n\nEvents:\n  watch            Stream real-time events as JSON lines until interrupted\n  watch store      Stream store wishlist rotation hits until interrupted [--webhook <url>] [--interval <min>]\n  watch-match      Stream match lifecycle events until interrupted\n  watch-friends    Stream friend activity and presence events until interrupted\n\nServer:\n  dashboard        Start local server and open interactive web dashboard\n  serve            Start local HTTP server with SSE events and OpenAPI docs [--port 47800] [--host 127.0.0.1] [--allow-remote]\n  mcp              Start Model Context Protocol (MCP) server over stdio for AI assistants\n\nOfficial:\n  official account <name#tag> Print player PUUID and active shard\n  official matches <name#tag> Print player match history [--queue <q>] [--count <n>]\n  official match <id> Print full match details (--shard <shard> [--self <puuid>])\n  official leaderboard Print competitive leaderboard (--shard <shard> [--act <id>] [--start <n>] [--size <n>])\n  official status Print platform status and maintenance alerts (--shard <shard>)\n  official summary <name#tag> Print player performance summary [--queue <q>] [--count <n>]\n  official profile <name#tag> Print player scouting profile [--count <n>]\n\nOptions:\n  --yes              Execute write command (default is dry-run)\n  --confirm          Confirm write action (required with buy, dodge, leave-match, settings-save)\n  --offer <id>       Store offer ID to purchase\n  --bundle <id>      Store bundle ID to purchase\n  --badge <on|off>   Hide or show act rank badge\n  --leaderboard <on|off> Anonymize or reveal leaderboard presence\n  --season <uuid>    Season ID for leaderboard\n  --start <n>        Leaderboard starting index\n  --size <n>         Leaderboard page size (max 510)\n  --query <text>     Leaderboard player search query\n  --revoke           Revoke party invite code (used with party-code)\n  --to <target>      Message recipient (puuid, name#tag, or cid)\n  --text <msg>       Message text\n  --gun <spec>       Gun to equip: <weapon>=<skin>[:level[:chroma]] (repeatable)\n  --buddy <spec>     Buddy to equip: <weapon>=<buddy|none> (repeatable)\n  --spray <spec>     Spray to equip: <slot>=<uuid|none> (repeatable)\n  --card <uuid>      Player card UUID\n  --title <uuid>     Player title UUID\n  --flex <uuid|none> Flex item UUID or none\n  --border <uuid>    Level border UUID\n  --incognito <on|off> Enable or disable incognito\n  --hide-level <on|off> Hide or show account level\n  --count <n>        Number of matches or rank history entries to fetch\n  --queue <queue>    Queue filter (e.g. competitive, unrated)\n  --ranks            Fetch MMR and rank for each player in live match\n  --no-loadouts      Skip fetching player loadouts in live match\n  --map <name>       Map name or path for custom game\n  --mode <name>      Game mode name or path for custom game\n  --server <id>      Server pod ID for custom game\n  --rule <spec>      Game rule override: <name>=<value> (repeatable)\n  --body <json>      JSON request body for local and riot raw commands\n  --only <events>    Comma-separated list of event names to print\n  --raw              Include raw client event frames or unformatted settings\n  --cid <id>         Conversation ID for filtering messages or participants\n  --api-key <key>    Riot Developer API key (or RIOT_API_KEY env)\n  --shard <shard>    Riot shard (na, latam, br, eu, ap, kr)\n  --self <puuid>     Player PUUID for self perspective in official match\n  --act <uuid>       Act or season UUID for official leaderboard\n  --language <lang>  Catalogue language (default: en-US)\n  --cache <seconds>  Reuse Riot responses younger than this many seconds\n  --no-official-cache Disable official match disk cache\n  --webhook <url>    Webhook URL for store alerts (Discord or generic)\n  --interval <min>   Check interval in minutes for store watcher\n  --port <n>         Port to bind HTTP server (default: 47800)\n  --host <ip>        Host address to bind HTTP server (default: 127.0.0.1)\n  --allow-remote     Allow binding HTTP server to non-loopback address\n  --pretty           Pretty-print JSON output\n  --help             Show usage instructions\n  --version          Show version number\n";
+export declare const USAGE = "Usage: riotclient <command> [options]\n\nAccount:\n  whoami           Print signed-in player profile and region\n  owned-items      Print owned inventory items\n  collection-value Calculate estimated VP and Radianite value of owned collection\n  loadout          Print currently equipped loadout\n  wallet           Print VP, Radianite, and Kingdom Credits balances\n  xp               Print account level, XP progression and recent match XP history\n  contracts        Print progression across agent, battlepass and event contracts\n  missions         Print active daily and weekly missions and objectives\n  penalties        Print active penalties and restrictions\n  favourites       Print favorited weapon skins\n  session          Print current client session loop state and playtime\n  config           Print shared client configuration mapping\n  client           Print client identity, locale, region, and Valorant running state\n  settings         Print cloud player settings (--raw for unprocessed dump)\n  settings-save    Save player settings from JSON file (<file.json>, requires --yes --confirm)\n  equip            Equip skins, buddies, sprays, card, title, border, flex (dry-run, --yes to apply)\n  equip-collection Equip a collection of skins (<skinUuid,...>) (dry-run, --yes to apply)\n  loadout-export   Export current loadout as a preset JSON\n  loadout-diff     Compare current loadout against preset JSON file (<preset.json>)\n  loadout-apply    Apply loadout preset from JSON file (<preset.json>, dry-run, --yes to apply)\n  contract-activate Activate an agent contract (<uuid>) (dry-run, --yes to apply)\n  favourite-add    Add skin to favourites (<skin>) (dry-run, --yes to apply)\n  favourite-remove Remove skin from favourites (<skin>) (dry-run, --yes to apply)\n  privacy          Update account privacy toggles (--badge on|off, --leaderboard on|off)\n\nSocial:\n  friends          Print friends roster and presence\n  friend-requests  Print incoming and outgoing friend requests\n  blocked          Print blocked players\n  conversations    Print whisper and match chat conversations\n  messages         Print chat messages (filter with --cid <id>)\n  participants     Print chat participants (filter with --cid <id>)\n  send             Send chat message (--to <puuid|name#tag|cid> --text <msg>)\n  friend-request   Send friend request (<name#tag>)\n  friend-accept    Accept friend request (<puuid>)\n  friend-decline   Decline friend request (<puuid>)\n  friend-cancel    Cancel friend request (<puuid>)\n  friend-remove    Remove friend (<puuid>)\n  block            Block player (<puuid|name#tag>)\n  unblock          Unblock player (<puuid>)\n\nStore:\n  store            Print storefront (daily, night market, bundles, accessories)\n  store-history    Print recorded daily store rotations [--days <n>]\n  store-seen       Print when a skin was last seen in daily store (<skin>)\n  offers           Print full item offers catalog and pricing\n  order <id>       Print store order details\n  night-market-reveal Reveal night market offers (dry-run, --yes to apply)\n  buy              Purchase offer or bundle (--offer <id> | --bundle <id>, requires --yes --confirm)\n  wishlist         Print skin wishlist or manage items (add <skin>, remove <skin>, check)\n\nMatches:\n  matches          Print recent match history summaries\n  matches-sync     Synchronize match history to local cache [--pages <n>]\n  match <id>       Print full match details by ID\n  mmr              Print current rank, rating, and MMR breakdown\n  rank-history     Print competitive rating adjustments and tier changes\n  live             Print live pregame or in-game lobby status and loadouts\n  matches-for <puuid> Print recent match history summaries for player\n  mmr-for <puuid>  Print rank, rating, and MMR for player\n  rank-history-for <puuid> Print competitive updates for player\n  leaderboard      Print competitive leaderboard [--season] [--start] [--size] [--query]\n  content          Print active act, episode and live events\n  premier          Print premier eligibility, roster, and season info\n  trend            Print competitive rating streak, net RR gains, and climbing pace\n  summary          Print player performance summary across recent matches [--count n] [--queue q]\n  play-session     Print today's play session summary [--since <iso>]\n  instalock <agent> Auto-lock an agent in pregame [--on-map Map=Agent...] [--fallback a...] [--delay n] [--select] [--once] [--yes]\n  assess [puuid]   Assess player rank anomalies, streaks, and warning flags\n  agent-select     Select an agent in pregame (<uuid|name>) (dry-run, --yes to apply)\n  agent-lock       Lock in an agent in pregame (<uuid|name>) (dry-run, --yes to apply)\n  dodge            Dodge pregame agent select (requires --yes --confirm)\n  leave-match      Leave active in-game match (requires --yes --confirm)\n\nParty:\n  party            Print current party details and members\n  queues           Print matchmaking queue configurations\n  custom-game-configs Print custom game configuration options\n  party-invite     Invite player to party (<name#tag>)\n  party-kick       Kick member from party (<puuid>)\n  party-promote    Promote member to party owner (<puuid>)\n  party-code       Generate or revoke party invite code [--revoke]\n  party-join       Join party by invite code or party ID (<partyId|code>)\n  party-invites    Print incoming party invites\n  party-requests   Print incoming party join requests\n  party-decline-invite Decline party invite (<id>) (dry-run, --yes to apply)\n  party-request    Request to join party (<partyId>) (dry-run, --yes to apply)\n  party-decline-request Decline party join request (<id>) (dry-run, --yes to apply)\n  custom-game      Convert party into a custom game (dry-run, --yes to apply)\n  custom-game-settings Configure custom game (--map <name> --mode <name> [--server <id>] [--rule k=v...])\n  custom-game-team Set member custom game team (<puuid> <team>) (dry-run, --yes to apply)\n  custom-game-start Start custom game match (dry-run, --yes to apply)\n  custom-game-balance Balance custom game teams (dry-run, --yes to apply)\n  party-default    Set party default queue (<queue>) (dry-run, --yes to apply)\n  party-servers    Set preferred game servers (<id,...>) (dry-run, --yes to apply)\n  party-moderator  Set member moderator status (<puuid> on|off) (dry-run, --yes to apply)\n  party-refresh    Refresh party member pings and identity (dry-run, --yes to apply)\n  party-ready      Set party ready state (on|off)\n  party-queue      Change party queue (<queue>)\n  party-access     Set party accessibility (open|closed)\n  party-start      Start party matchmaking\n  party-stop       Stop party matchmaking\n  party-leave      Leave current party\n\nRaw (unsupported):\n  local            Send raw request to local Riot client API (<get|post|put|delete> <path> [--body json])\n  riot             Send raw request to remote Riot game servers (<get|post|put|delete> <url> [--body json])\n\nEvents:\n  watch            Stream real-time events as JSON lines until interrupted\n  watch store      Stream store wishlist rotation hits until interrupted [--webhook <url>] [--interval <min>]\n  watch match      Stream match lifecycle events until interrupted [--webhook <url>]\n  watch-match      Stream match lifecycle events until interrupted [--webhook <url>]\n  watch-friends    Stream friend activity and presence events until interrupted\n\nServer:\n  dashboard        Start local server and open interactive web dashboard\n  serve            Start local HTTP server with SSE events and OpenAPI docs [--port 47800] [--host 127.0.0.1] [--allow-remote]\n  mcp              Start Model Context Protocol (MCP) server over stdio for AI assistants\n\nOfficial:\n  official account <name#tag> Print player PUUID and active shard\n  official matches <name#tag> Print player match history [--queue <q>] [--count <n>]\n  official match <id> Print full match details (--shard <shard> [--self <puuid>])\n  official leaderboard Print competitive leaderboard (--shard <shard> [--act <id>] [--start <n>] [--size <n>])\n  official status Print platform status and maintenance alerts (--shard <shard>)\n  official summary <name#tag> Print player performance summary [--queue <q>] [--count <n>]\n  official profile <name#tag> Print player scouting profile [--count <n>]\n\nOptions:\n  --yes              Execute write command (default is dry-run)\n  --confirm          Confirm write action (required with buy, dodge, leave-match, settings-save)\n  --offer <id>       Store offer ID to purchase\n  --bundle <id>      Store bundle ID to purchase\n  --badge <on|off>   Hide or show act rank badge\n  --leaderboard <on|off> Anonymize or reveal leaderboard presence\n  --season <uuid>    Season ID for leaderboard\n  --start <n>        Leaderboard starting index\n  --size <n>         Leaderboard page size (max 510)\n  --query <text>     Leaderboard player search query\n  --revoke           Revoke party invite code (used with party-code)\n  --to <target>      Message recipient (puuid, name#tag, or cid)\n  --text <msg>       Message text\n  --gun <spec>       Gun to equip: <weapon>=<skin>[:level[:chroma]] (repeatable)\n  --buddy <spec>     Buddy to equip: <weapon>=<buddy|none> (repeatable)\n  --spray <spec>     Spray to equip: <slot>=<uuid|none> (repeatable)\n  --card <uuid>      Player card UUID\n  --title <uuid>     Player title UUID\n  --flex <uuid|none> Flex item UUID or none\n  --border <uuid>    Level border UUID\n  --incognito <on|off> Enable or disable incognito\n  --hide-level <on|off> Hide or show account level\n  --count <n>        Number of matches or rank history entries to fetch\n  --queue <queue>    Queue filter (e.g. competitive, unrated)\n  --ranks            Fetch MMR and rank for each player in live match\n  --no-loadouts      Skip fetching player loadouts in live match\n  --map <name>       Map name or path for custom game\n  --mode <name>      Game mode name or path for custom game\n  --server <id>      Server pod ID for custom game\n  --rule <spec>      Game rule override: <name>=<value> (repeatable)\n  --body <json>      JSON request body for local and riot raw commands\n  --only <events>    Comma-separated list of event names to print\n  --raw              Include raw client event frames or unformatted settings\n  --cid <id>         Conversation ID for filtering messages or participants\n  --api-key <key>    Riot Developer API key (or RIOT_API_KEY env)\n  --shard <shard>    Riot shard (na, latam, br, eu, ap, kr)\n  --self <puuid>     Player PUUID for self perspective in official match\n  --act <uuid>       Act or season UUID for official leaderboard\n  --language <lang>  Catalogue language (default: en-US)\n  --cache <seconds>  Reuse Riot responses younger than this many seconds\n  --no-official-cache Disable official match disk cache\n  --webhook <url>    Webhook URL for store or match alerts (Discord or generic)\n  --interval <min>   Check interval in minutes for store watcher\n  --since <iso>      ISO timestamp cutoff for play session\n  --on-map <m=a>     Agent for a map in instalock, e.g. Haven=Omen (repeatable)\n  --fallback <agent> Fallback agent for instalock (repeatable)\n  --delay <ms>       Delay before selecting/locking in milliseconds (0-10000)\n  --select           Select agent without locking in instalock\n  --once             Stop instalock after first match\n  --port <n>         Port to bind HTTP server (default: 47800)\n  --host <ip>        Host address to bind HTTP server (default: 127.0.0.1)\n  --allow-remote     Allow binding HTTP server to non-loopback address\n  --pretty           Pretty-print JSON output\n  --help             Show usage instructions\n  --version          Show version number\n";
 export declare function exitCodeForError(error: unknown): number;
 export { formatError };
 export declare function formatWatchLine(event: string, data: unknown, at?: string): string;
@@ -10,7 +11,10 @@ export declare function runWatch(client: RiotClient, options?: {
     only?: string;
     raw?: boolean;
 }): Promise<number>;
-export declare function runWatchMatch(client: RiotClient): Promise<number>;
+export declare function runWatchMatch(client: RiotClient, options?: {
+    webhook?: string;
+}): Promise<number>;
+export declare function runInstalock(client: RiotClient, options: InstalockOptions): Promise<number>;
 export declare function runWatchFriends(client: RiotClient): Promise<number>;
 export declare function runWatchStore(client: RiotClient, options?: {
     webhook?: string;

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAA6C,MAAM,iBAAiB,CAAC;AACxF,OAAO,EACL,KAAK,EACL,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,KAAK,EACL,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,GACrB,CAAC;AAEF,eAAO,MAAM,KAAK,62VAmLjB,CAAC;AAWF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKvD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,EACb,EAAE,GAAE,MAAiC,GACpC,MAAM,CAMR;AAiBD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7C,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBvE;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBzE;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3D,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACpE,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAsB,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBhE;AAs5BD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyK5D"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAA6C,MAAM,iBAAiB,CAAC;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EACL,KAAK,EACL,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,KAAK,EACL,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,GACrB,CAAC;AAEF,eAAO,MAAM,KAAK,6jXA4LjB,CAAC;AAWF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKvD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,EACb,EAAE,GAAE,MAAiC,GACpC,MAAM,CAMR;AAiBD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7C,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjC,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAkCD,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBjG;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBzE;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3D,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACpE,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAsB,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBhE;AA05BD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsL5D"}

package/dist/cli.js

@@ -76,6 +76,8 @@ Matches:
   premier          Print premier eligibility, roster, and season info
   trend            Print competitive rating streak, net RR gains, and climbing pace
   summary          Print player performance summary across recent matches [--count n] [--queue q]
+  play-session     Print today's play session summary [--since <iso>]
+  instalock <agent> Auto-lock an agent in pregame [--on-map Map=Agent...] [--fallback a...] [--delay n] [--select] [--once] [--yes]
   assess [puuid]   Assess player rank anomalies, streaks, and warning flags
   agent-select     Select an agent in pregame (<uuid|name>) (dry-run, --yes to apply)
   agent-lock       Lock in an agent in pregame (<uuid|name>) (dry-run, --yes to apply)
@@ -119,7 +121,8 @@ Raw (unsupported):
 Events:
   watch            Stream real-time events as JSON lines until interrupted
   watch store      Stream store wishlist rotation hits until interrupted [--webhook <url>] [--interval <min>]
-  watch-match      Stream match lifecycle events until interrupted
+  watch match      Stream match lifecycle events until interrupted [--webhook <url>]
+  watch-match      Stream match lifecycle events until interrupted [--webhook <url>]
   watch-friends    Stream friend activity and presence events until interrupted
 
 Server:
@@ -178,8 +181,14 @@ Options:
   --language <lang>  Catalogue language (default: en-US)
   --cache <seconds>  Reuse Riot responses younger than this many seconds
   --no-official-cache Disable official match disk cache
-  --webhook <url>    Webhook URL for store alerts (Discord or generic)
+  --webhook <url>    Webhook URL for store or match alerts (Discord or generic)
   --interval <min>   Check interval in minutes for store watcher
+  --since <iso>      ISO timestamp cutoff for play session
+  --on-map <m=a>     Agent for a map in instalock, e.g. Haven=Omen (repeatable)
+  --fallback <agent> Fallback agent for instalock (repeatable)
+  --delay <ms>       Delay before selecting/locking in milliseconds (0-10000)
+  --select           Select agent without locking in instalock
+  --once             Stop instalock after first match
   --port <n>         Port to bind HTTP server (default: 47800)
   --host <ip>        Host address to bind HTTP server (default: 127.0.0.1)
   --allow-remote     Allow binding HTTP server to non-loopback address
@@ -257,8 +266,8 @@ export async function runWatch(client, options = {}) {
     await client.close();
     return 0;
 }
-export async function runWatchMatch(client) {
-    const watcher = client.watch.match();
+export async function runWatchMatch(client, options = {}) {
+    const watcher = client.watch.match({ webhook: options.webhook });
     const onSignal = () => {
         process.off("SIGINT", onSignal);
         process.off("SIGTERM", onSignal);
@@ -279,6 +288,47 @@ export async function runWatchMatch(client) {
     }
     return 0;
 }
+function instalockOptions(positionals, values) {
+    const agent = requirePositional(positionals, 1, "Usage: instalock <agent>");
+    const byMap = Object.fromEntries((values["on-map"] ?? []).map((entry) => {
+        const [map, mapAgent] = entry.split("=");
+        if (!map || !mapAgent) {
+            throw new ValidationError("invalid-argument", `--on-map expects Map=Agent, got "${entry}"`);
+        }
+        return [map.trim(), mapAgent.trim()];
+    }));
+    return {
+        agent,
+        byMap,
+        fallbacks: values.fallback ?? [],
+        delayMs: values.delay ? Number(values.delay) : undefined,
+        select: Boolean(values.select),
+        once: Boolean(values.once),
+        dryRun: !values.yes,
+    };
+}
+export async function runInstalock(client, options) {
+    const handle = client.matches.instalock(options);
+    const onSignal = () => {
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
+        handle.stop();
+    };
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    try {
+        for await (const item of handle) {
+            process.stdout.write(`${JSON.stringify(item)}\n`);
+        }
+    }
+    finally {
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
+        handle.stop();
+        await client.close();
+    }
+    return 0;
+}
 export async function runWatchFriends(client) {
     const watcher = client.watch.friends();
     const onSignal = () => {
@@ -487,6 +537,10 @@ async function executeStandardCommand(client, command, options) {
             return client.account.favourites();
         case "session":
             return client.account.session();
+        case "play-session":
+            return client.matches.session({
+                since: typeof options?.rawValues?.since === "string" ? options.rawValues.since : undefined,
+            });
         case "config":
             return client.account.config();
         case "friends":
@@ -1160,6 +1214,12 @@ export async function runCli(args) {
             "no-official-cache": { type: "boolean", default: false },
             webhook: { type: "string" },
             interval: { type: "string" },
+            since: { type: "string" },
+            "on-map": { type: "string", multiple: true },
+            fallback: { type: "string", multiple: true },
+            delay: { type: "string" },
+            select: { type: "boolean", default: false },
+            once: { type: "boolean", default: false },
         },
         allowPositionals: true,
     });
@@ -1185,6 +1245,9 @@ export async function runCli(args) {
     });
     try {
         if (command === "watch") {
+            if (parsed.positionals[1] === "match") {
+                return await runWatchMatch(client, { webhook: parsed.values.webhook });
+            }
             if (parsed.positionals[1] === "store") {
                 const intervalMinutes = parsed.values.interval ? Number(parsed.values.interval) : undefined;
                 const webhook = parsed.values.webhook ? String(parsed.values.webhook) : undefined;
@@ -1201,7 +1264,10 @@ export async function runCli(args) {
             return await runWatchStore(client, { webhook, intervalMinutes });
         }
         if (command === "watch-match") {
-            return await runWatchMatch(client);
+            return await runWatchMatch(client, { webhook: parsed.values.webhook });
+        }
+        if (command === "instalock") {
+            return await runInstalock(client, instalockOptions(parsed.positionals, parsed.values));
         }
         if (command === "watch-friends") {
             return await runWatchFriends(client);