{
"schemaVersion": 1,
"taskId": "yambda-discovery-ranking-two-tower-case-1",
"attemptId": "gemini-3-8-flash-high-case1-r05-b9049e57",
"taskChecksum": "8404d794ce8e18d154cd225cfe6b12bf6b4ee02aaefba1d315aa215c1175a013",
"agentVersion": "0.61.0",
"model": "gemini-3.8-flash",
"sessionId": "0aad8420-cbfb-4325-b1b4-2d368ce6c0fc",
"steps": [
{
"id": 1,
"role": "user",
"timestamp": "2026-09-29T02:04:46.547Z",
"blocks": [
{
"kind": "message",
"timestamp": "2026-09-29T02:04:46.547Z",
"text": "\nThis is the Gemini CLI. We are setting up the context for our chat.\nToday's date is Tuesday, September 29, 2026 (formatted according to the user's locale).\nMy operating system is: linux\nThe project's temporary directory is: /home/agent/.gemini/tmp/app\n- **Workspace Directories:**\n - /app\n- **Directory Structure:**\n\nShowing up to 200 items (files + folders).\n\n/app/\n└───solution/\n\n\n"
}
]
},
{
"id": 2,
"role": "user",
"timestamp": "2026-09-29T02:04:46.589Z",
"blocks": [
{
"kind": "message",
"timestamp": "2026-09-29T02:04:46.589Z",
"text": "# Improve a production music-discovery two-tower\n\nYou have joined the recommendations team for a music streaming service. The\n\"Made for You\" shelf is served by a mature production two-tower model. Its\nchronological data protocol and indexed serving path are sound, but its offline\nretrieval quality no longer clears the team's next launch gate.\n\nYour job is to investigate the production model, improve its retrieval quality,\nand ship a better ranking artifact. Use the implementation and public validation\ndata to form and test your own diagnosis.\n\nThe source used to reproduce the production model is included under\n`/task/current_model/`. You may copy it into `/app/solution/`, edit it, add\ntests, and improve its training objective, but keep the data protocol,\ntwo-tower serving contract, and evaluation boundary intact.\n\n## Production Context\n\nThe model must satisfy a strict request-time latency budget. Item vectors are\nprecomputed offline. At request time, one user vector is computed from observed\ninteraction history and compared with candidate item vectors by a batchable\ntwo-tower score. Do not introduce a cross-encoder, per-candidate sequence model,\nor user-ID lookup table.\n\nThe current trainer is a mature baseline with chronological internal\nvalidation. Focus your investigation on how its training objective selects and\nuses negative examples. Diagnose limitations in the current negative-sampling\nstrategy and improve it under the fixed CPU budget. Validate changes with the\npublic backtest. The final approach must still train and rank within the supplied\nCPU environment while preserving the serving and data boundaries above.\n\n## What You Have\n\nAll public inputs are under `/task/data/`. A stage cutoff is the timestamp at\nwhich observed history and candidate eligibility are frozen for a ranking. The\npublic validation stage cutoff is `24786800`, when `train_*` ends. A 30-minute\ngap precedes the seven-day `val_*` window. For the final submission, that\nvalidation window becomes observed history, and another 30-minute gap precedes\nthe hidden seven-day outcome window.\n\nThe package includes:\n\n- `/task/current_model/train_current_model.py`: the production training and\n ranking script. It can reproduce the public validation ranking and produce a\n hidden-test submission after refitting.\n- `/task/current_model/two_tower_model.py`: model primitives used by the\n production script.\n- `/task/evaluate_public.py`: the public validation evaluator for development.\n- `/task/data/validation_eligible_candidates.npz` and\n `/task/data/test_eligible_candidates.npz`: platform-owned candidate sets for\n the validation and hidden-test cutoffs.\n- `/task/data/validation_preference_state.parquet` and\n `/task/data/test_preference_state.parquet`: active explicit preference state\n at the corresponding cutoffs.\n- `/task/requirements.txt`: the exact offline Python distribution inventory.\n\nYou can reproduce the production public backtest with:\n\n```sh\npython /task/current_model/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --output /app/solution/production_validation.parquet\npython /task/evaluate_public.py /app/solution/production_validation.parquet\n```\n\n## Data\n\nFor each event family there is a `train_*.parquet` and `val_*.parquet` file:\n\n| Family | Meaning | Columns |\n| --- | --- | --- |\n| `listens` | Playback events | `uid`, `timestamp`, `item_id`, `is_organic`, `played_ratio_pct`, `track_length_seconds` |\n| `likes` | Explicit positive actions | `uid`, `timestamp`, `item_id`, `is_organic` |\n| `dislikes` | Explicit negative actions | `uid`, `timestamp`, `item_id`, `is_organic` |\n| `unlikes` | Reversal of a prior like | `uid`, `timestamp`, `item_id`, `is_organic` |\n| `undislikes` | Reversal of a prior dislike | `uid`, `timestamp`, `item_id`, `is_organic` |\n\n`is_organic=1` means the listener sought out the track; `0` means the action came\nthrough a recommendation surface. A listen is a conventional positive at 50%\ncompletion. The discovery-quality objective below uses the stronger 80%\nthreshold.\n\nThe two public windows have different roles:\n\n1. For model development and selection, train only from `train_*` and score the\n subsequent `val_*` outcomes.\n2. After selecting an improvement, refit it on `train_* + val_*`. At hidden-test\n time the validation events are observed history, not recommendable outcomes.\n\nDo not use `val_*` events as features when measuring a validation ranking. They\nmay and should be used when refitting the final hidden-test ranker.\n\nAdditional files under `/task/data/`:\n\n- `candidate_catalog.parquet`: the 30,000 retrieval-catalog tracks, ordered by\n training positive-listen popularity.\n- `target_users.parquet`: users with at least 20 positive listens in the 90 days\n before the training cutoff, selected without future labels.\n- `validation_preference_state.parquet`: active explicit state at the training\n cutoff, for validation ranking.\n- `test_preference_state.parquet`: active explicit state after validation, for\n the final hidden-test ranking. State is `liked` or `disliked`; a pair may have\n both active channels.\n- `validation_eligible_candidates.npz` and `test_eligible_candidates.npz`:\n cutoff-correct candidate sets for every target user. Each contains aligned\n arrays `uids`, `item_ids`, and `packed_eligible`. For user row `r`, recover\n the Boolean item mask with `np.unpackbits(packed_eligible[r],\n count=len(item_ids), bitorder=\"little\")`.\n\nValidation candidates exclude all `train_*` encounters. Test candidates exclude\nall `train_*` and `val_*` encounters. Future test interactions are hidden and\nused only by the separate Harbor verifier.\n\n## Discovery Objective\n\nRank only the candidates returned for the relevant cutoff. Relevance is based\non organic behavior in the immediately following window:\n\n- grade 3: the user organically likes the track;\n- grade 1: the user organically listens to at least 80% of the track;\n- grade 0: otherwise.\n\nIf both positive events occur, grade 3 wins. Ranking quality is measured with\ngraded NDCG@10. DCG uses gain `2^grade - 1` and discount\n`1/log2(rank + 1)`, then averages per-user NDCG over users with at least one\nrelevant item.\n\nThe public evaluator reports this same objective for development, but its score\nis not a separate acceptance stage. Final acceptance is determined on the\nhidden test using the same objective. The Yambda logs contain interactions, not\nimpression propensities; treat the organic objective as a robust offline target,\nnot as a causal estimate of online lift.\n\n## Deliverable\n\nSubmit one final ranking as `/app/solution/submission.parquet` or\n`/app/solution/submission.csv`. It must be a regular file, not a symbolic link.\nIf both files exist, the verifier evaluates `submission.parquet` and ignores\n`submission.csv`.\n\nThe ranking must:\n\n- include the columns `uid`, `item_id`, and `rank`; only these columns are\n evaluated;\n- use finite, integer-valued entries in all three required columns;\n- cover exactly the users in `target_users.parquet`, with no missing or extra\n users;\n- contain exactly 100 rows and 100 distinct items for every target user;\n- contain every integer rank from 1 through 100 exactly once per user; and\n- use only items present in that user's `test_eligible_candidates.npz`\n candidate set.\n\nAlso leave the improved implementation used to build the artifact at\n`/app/solution/train_current_model.py`, along with any local modules it imports.\nA concise `/app/solution/README.md` with the diagnosis, before-and-after public\nscore, model change, and submission command is useful for the experiment record,\nbut it is not an automated acceptance gate.\n\n## Constraints\n\n- Write deliverables and intermediate artifacts only under `/app/solution/`.\n- Treat `/task/` and the installed Python environment as read-only.\n- Do not invoke nested agents or attempt to access verifier files, credentials,\n other trials, or host paths.\n- Do not install packages or use network access except for the model-provider\n connection managed by Harbor.\n- Do not alter cutoff definitions, target users, candidate eligibility, or\n relevance labels.\n- Improve the production pipeline in place. Do not substitute an unrelated\n model family or evade the indexed two-tower serving constraint.\n- The environment includes CPU PyTorch 2.8.0. No accelerator is available.\n- You have up to 60 minutes. Prioritize measured validation improvements, a\n correct final refit, and a valid submission over broad architecture search.\n- Keep the best valid submission saved throughout the attempt so it survives\n the deadline.\n"
}
]
},
{
"id": 3,
"role": "agent",
"timestamp": "2026-09-29T02:04:50.875Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:04:50.875Z",
"text": "Processing Task Parameters\n\nI am carefully reviewing the task details to grasp the environment, requirements, and constraints fully. My immediate next step is to initiate the narrative flow by calling `update_topic`."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:04:50.875Z",
"text": "Defining Task Scope\n\nI've analyzed the core deliverables: a submission file, the training script with its dependencies, and a README detailing changes and performance. My current focus is on understanding the production pipeline's constraints, particularly the two-tower serving and read-only environment, before proceeding to strategy."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:04:50.875Z",
"callId": "update_topic__call_4358889",
"name": "update_topic",
"input": {
"title": "Research and Baseline Reproduction",
"strategic_intent": "Investigate the codebase, explore files under /task, reproduce the baseline public backtest, and understand the model architecture and negative sampling.",
"summary": "Starting research phase. We will inspect /task/current_model/train_current_model.py, two_tower_model.py, evaluate_public.py, and related data files. We will also run the baseline reproduction to get the baseline validation score and check runtime."
},
"recorded": {
"id": "update_topic__call_4358889",
"name": "update_topic",
"args": {
"title": "Research and Baseline Reproduction",
"strategic_intent": "Investigate the codebase, explore files under /task, reproduce the baseline public backtest, and understand the model architecture and negative sampling.",
"summary": "Starting research phase. We will inspect /task/current_model/train_current_model.py, two_tower_model.py, evaluate_public.py, and related data files. We will also run the baseline reproduction to get the baseline validation score and check runtime."
},
"result": [
{
"functionResponse": {
"id": "update_topic__call_4358889",
"name": "update_topic",
"response": {
"output": "Current topic: \"Research and Baseline Reproduction\"\nTopic summary: Starting research phase. We will inspect /task/current_model/train_current_model.py, two_tower_model.py, evaluate_public.py, and related data files. We will also run the baseline reproduction to get the baseline validation score and check runtime.\n\nStrategic Intent: Investigate the codebase, explore files under /task, reproduce the baseline public backtest, and understand the model architecture and negative sampling."
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:04:50.883Z",
"resultDisplay": "## 📂 Topic: **Research and Baseline Reproduction**\n\n**Summary:**\nStarting research phase. We will inspect /task/current_model/train_current_model.py, two_tower_model.py, evaluate_public.py, and related data files. We will also run the baseline reproduction to get the baseline validation score and check runtime.\n\n> [!STRATEGY]\n> **Intent:** Investigate the codebase, explore files under /task, reproduce the baseline public backtest, and understand the model architecture and negative sampling.",
"description": "Update topic to: \"Research and Baseline Reproduction\"",
"displayName": "Update Topic Context",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:04:50.884Z",
"content": "Current topic: \"Research and Baseline Reproduction\"\nTopic summary: Starting research phase. We will inspect /task/current_model/train_current_model.py, two_tower_model.py, evaluate_public.py, and related data files. We will also run the baseline reproduction to get the baseline validation score and check runtime.\n\nStrategic Intent: Investigate the codebase, explore files under /task, reproduce the baseline public backtest, and understand the model architecture and negative sampling.",
"isError": false
},
"responseMessageId": "4d0f3c1f-f1c9-4d3c-be65-2eae2053b5ed"
}
]
},
{
"id": 4,
"role": "agent",
"timestamp": "2026-09-29T02:04:52.573Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:04:52.573Z",
"callId": "list_directory__call_26972",
"name": "list_directory",
"input": {
"dir_path": "/task"
},
"recorded": {
"id": "list_directory__call_26972",
"name": "list_directory",
"args": {
"dir_path": "/task"
},
"result": [
{
"functionResponse": {
"id": "list_directory__call_26972",
"name": "list_directory",
"response": {
"error": "Path not in workspace: Attempted path \"/task\" resolves outside the allowed workspace directories: /app or the project temp directory: /home/agent/.gemini/tmp/app"
}
}
}
],
"status": "error",
"timestamp": "2026-09-29T02:04:52.575Z",
"resultDisplay": "Path not in workspace: Attempted path \"/task\" resolves outside the allowed workspace directories: /app or the project temp directory: /home/agent/.gemini/tmp/app",
"description": "Lists the names of files and subdirectories directly within a specified directory path. Can optionally ignore entries matching provided glob patterns.",
"displayName": "ReadFolder",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:04:52.576Z",
"content": "Path not in workspace: Attempted path \"/task\" resolves outside the allowed workspace directories: /app or the project temp directory: /home/agent/.gemini/tmp/app",
"isError": true
},
"responseMessageId": "0235a697-8d9a-40a4-9a28-e3552489151a"
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:04:52.573Z",
"callId": "list_directory__call_26975",
"name": "list_directory",
"input": {
"dir_path": "/task/current_model"
},
"recorded": {
"id": "list_directory__call_26975",
"name": "list_directory",
"args": {
"dir_path": "/task/current_model"
},
"result": [
{
"functionResponse": {
"id": "list_directory__call_26975",
"name": "list_directory",
"response": {
"error": "Path not in workspace: Attempted path \"/task/current_model\" resolves outside the allowed workspace directories: /app or the project temp directory: /home/agent/.gemini/tmp/app"
}
}
}
],
"status": "error",
"timestamp": "2026-09-29T02:04:52.575Z",
"resultDisplay": "Path not in workspace: Attempted path \"/task/current_model\" resolves outside the allowed workspace directories: /app or the project temp directory: /home/agent/.gemini/tmp/app",
"description": "Lists the names of files and subdirectories directly within a specified directory path. Can optionally ignore entries matching provided glob patterns.",
"displayName": "ReadFolder",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:04:52.576Z",
"content": "Path not in workspace: Attempted path \"/task/current_model\" resolves outside the allowed workspace directories: /app or the project temp directory: /home/agent/.gemini/tmp/app",
"isError": true
},
"responseMessageId": "0235a697-8d9a-40a4-9a28-e3552489151a"
}
]
},
{
"id": 5,
"role": "agent",
"timestamp": "2026-09-29T02:04:55.189Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:04:55.189Z",
"text": "Exploring Task Directory\n\nI'm investigating the reach of `list_directory`, specifically its constraints to `/app` or `/home/agent/.gemini/tmp/app`. My current focus is on testing whether `run_shell_command` can access the `/task` directory. To do this, I've initiated a `ls -la /task` command."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:04:55.189Z",
"callId": "run_shell_command__call_621956",
"name": "run_shell_command",
"input": {
"command": "ls -la /task",
"description": "List files in /task directory"
},
"recorded": {
"id": "run_shell_command__call_621956",
"name": "run_shell_command",
"args": {
"command": "ls -la /task",
"description": "List files in /task directory"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_621956",
"name": "run_shell_command",
"response": {
"output": "\nOutput: total 40\ndr-xr-xr-x 1 root root 4096 Sep 29 02:01 .\ndrwxr-xr-x 1 root root 4096 Sep 29 02:04 ..\n-r--r--r-- 1 root root 0 Sep 29 01:59 .keep\ndr-xr-xr-x 1 root root 4096 Sep 29 01:59 current_model\ndr-xr-xr-x 1 root root 4096 Sep 29 02:00 data\n-r--r--r-- 1 root root 5774 Sep 29 01:59 evaluate_public.py\n-r--r--r-- 1 root root 8265 Sep 29 01:59 ranking_evaluation.py\n-r--r--r-- 1 root root 1295 Sep 29 01:59 requirements.txt\nProcess Group PGID: 1612\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:04:55.217Z",
"resultDisplay": "total 40\ndr-xr-xr-x 1 root root 4096 Sep 29 02:01 .\ndrwxr-xr-x 1 root root 4096 Sep 29 02:04 ..\n-r--r--r-- 1 root root 0 Sep 29 01:59 .keep\ndr-xr-xr-x 1 root root 4096 Sep 29 01:59 current_model\ndr-xr-xr-x 1 root root 4096 Sep 29 02:00 data\n-r--r--r-- 1 root root 5774 Sep 29 01:59 evaluate_public.py\n-r--r--r-- 1 root root 8265 Sep 29 01:59 ranking_evaluation.py\n-r--r--r-- 1 root root 1295 Sep 29 01:59 requirements.txt",
"description": "ls -la /task",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:04:55.217Z",
"content": "\nOutput: total 40\ndr-xr-xr-x 1 root root 4096 Sep 29 02:01 .\ndrwxr-xr-x 1 root root 4096 Sep 29 02:04 ..\n-r--r--r-- 1 root root 0 Sep 29 01:59 .keep\ndr-xr-xr-x 1 root root 4096 Sep 29 01:59 current_model\ndr-xr-xr-x 1 root root 4096 Sep 29 02:00 data\n-r--r--r-- 1 root root 5774 Sep 29 01:59 evaluate_public.py\n-r--r--r-- 1 root root 8265 Sep 29 01:59 ranking_evaluation.py\n-r--r--r-- 1 root root 1295 Sep 29 01:59 requirements.txt\nProcess Group PGID: 1612\n",
"isError": false
},
"responseMessageId": "c0bfe879-17aa-41db-8b67-45244f461f0c"
}
]
},
{
"id": 6,
"role": "agent",
"timestamp": "2026-09-29T02:04:56.985Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:04:56.985Z",
"callId": "read_file__call_2806631",
"name": "read_file",
"input": {
"file_path": "/task/evaluate_public.py",
"start_line": 1,
"end_line": 50
},
"recorded": {
"id": "read_file__call_2806631",
"name": "read_file",
"args": {
"file_path": "/task/evaluate_public.py",
"start_line": 1,
"end_line": 50
},
"result": [
{
"functionResponse": {
"id": "read_file__call_2806631",
"name": "read_file",
"response": {
"error": "Path not in workspace: Attempted path \"/task/evaluate_public.py\" resolves outside the allowed workspace directories: /app or the project temp directory: /home/agent/.gemini/tmp/app"
}
}
}
],
"status": "error",
"timestamp": "2026-09-29T02:04:56.986Z",
"resultDisplay": "Path not in workspace: Attempted path \"/task/evaluate_public.py\" resolves outside the allowed workspace directories: /app or the project temp directory: /home/agent/.gemini/tmp/app",
"description": "Reads and returns the content of a specified file. If the file is large, the content will be truncated. The tool's response will clearly indicate if truncation has occurred and will provide details on how to read more of the file using the 'start_line' and 'end_line' parameters. Handles text, images (PNG, JPG, GIF, WEBP, SVG, BMP), audio files (MP3, WAV, AIFF, AAC, OGG, FLAC), and PDF files. For text files, it can read specific line ranges.",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:04:56.987Z",
"content": "Path not in workspace: Attempted path \"/task/evaluate_public.py\" resolves outside the allowed workspace directories: /app or the project temp directory: /home/agent/.gemini/tmp/app",
"isError": true
},
"responseMessageId": "6fb46c77-b809-4fa4-9749-adfd0e4db86e"
}
]
},
{
"id": 7,
"role": "agent",
"timestamp": "2026-09-29T02:05:05.559Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:05:05.558Z",
"text": "Analyzing Task Data\n\nI'm reviewing the provided task data, specifically the `/task` directory. It appears I can only access files within the `/app` or `/home/agent/.gemini/tmp/app` workspaces. Therefore, I need to copy any necessary files from `/task` into one of these designated locations to proceed with analysis."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:05:05.559Z",
"callId": "run_shell_command__call_5342646",
"name": "run_shell_command",
"input": {
"command": "ls -la /task/current_model && ls -lh /task/data",
"description": "Inspect contents of /task/current_model and /task/data"
},
"recorded": {
"id": "run_shell_command__call_5342646",
"name": "run_shell_command",
"args": {
"command": "ls -la /task/current_model && ls -lh /task/data",
"description": "Inspect contents of /task/current_model and /task/data"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5342646",
"name": "run_shell_command",
"response": {
"output": "\nOutput: total 104\ndr-xr-xr-x 1 root root 4096 Sep 29 01:59 .\ndr-xr-xr-x 1 root root 4096 Sep 29 02:01 ..\n-r--r--r-- 1 root root 80058 Sep 29 01:59 train_current_model.py\n-r--r--r-- 1 root root 15985 Sep 29 01:59 two_tower_model.py\ntotal 340M\n-r--r--r-- 1 root root 342K Sep 29 01:59 candidate_catalog.parquet\n-r--r--r-- 1 root root 83K Sep 29 01:59 target_users.parquet\n-r--r--r-- 1 root root 7.4M Sep 29 01:59 test_eligible_candidates.npz\n-r--r--r-- 1 root root 1.1M Sep 29 02:00 test_preference_state.parquet\n-r--r--r-- 1 root root 838K Sep 29 01:59 train_dislikes.parquet\n-r--r--r-- 1 root root 5.2M Sep 29 01:59 train_likes.parquet\n-r--r--r-- 1 root root 305M Sep 29 01:59 train_listens.parquet\n-r--r--r-- 1 root root 153K Sep 29 01:59 train_undislikes.parquet\n-r--r--r-- 1 root root 1.8M Sep 29 01:59 train_unlikes.parquet\n-r--r--r-- 1 root root 36K Sep 29 01:59 val_dislikes.parquet\n-r--r--r-- 1 root root 292K Sep 29 01:59 val_likes.parquet\n-r--r--r-- 1 root root 9.5M Sep 29 01:59 val_listens.parquet\n-r--r--r-- 1 root root 7.7K Sep 29 01:59 val_undislikes.parquet\n-r--r--r-- 1 root root 71K Sep 29 01:59 val_unlikes.parquet\n-r--r--r-- 1 root root 7.3M Sep 29 01:59 validation_eligible_candidates.npz\n-r--r--r-- 1 root root 1.1M Sep 29 02:00 validation_preference_state.parquet\nProcess Group PGID: 1615\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:05:05.577Z",
"resultDisplay": "total 104\ndr-xr-xr-x 1 root root 4096 Sep 29 01:59 .\ndr-xr-xr-x 1 root root 4096 Sep 29 02:01 ..\n-r--r--r-- 1 root root 80058 Sep 29 01:59 train_current_model.py\n-r--r--r-- 1 root root 15985 Sep 29 01:59 two_tower_model.py\ntotal 340M\n-r--r--r-- 1 root root 342K Sep 29 01:59 candidate_catalog.parquet\n-r--r--r-- 1 root root 83K Sep 29 01:59 target_users.parquet\n-r--r--r-- 1 root root 7.4M Sep 29 01:59 test_eligible_candidates.npz\n-r--r--r-- 1 root root 1.1M Sep 29 02:00 test_preference_state.parquet\n-r--r--r-- 1 root root 838K Sep 29 01:59 train_dislikes.parquet\n-r--r--r-- 1 root root 5.2M Sep 29 01:59 train_likes.parquet\n-r--r--r-- 1 root root 305M Sep 29 01:59 train_listens.parquet\n-r--r--r-- 1 root root 153K Sep 29 01:59 train_undislikes.parquet\n-r--r--r-- 1 root root 1.8M Sep 29 01:59 train_unlikes.parquet\n-r--r--r-- 1 root root 36K Sep 29 01:59 val_dislikes.parquet\n-r--r--r-- 1 root root 292K Sep 29 01:59 val_likes.parquet\n-r--r--r-- 1 root root 9.5M Sep 29 01:59 val_listens.parquet\n-r--r--r-- 1 root root 7.7K Sep 29 01:59 val_undislikes.parquet\n-r--r--r-- 1 root root 71K Sep 29 01:59 val_unlikes.parquet\n-r--r--r-- 1 root root 7.3M Sep 29 01:59 validation_eligible_candidates.npz\n-r--r--r-- 1 root root 1.1M Sep 29 02:00 validation_preference_state.parquet",
"description": "ls -la /task/current_model && ls -lh /task/data",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:05:05.578Z",
"content": "\nOutput: total 104\ndr-xr-xr-x 1 root root 4096 Sep 29 01:59 .\ndr-xr-xr-x 1 root root 4096 Sep 29 02:01 ..\n-r--r--r-- 1 root root 80058 Sep 29 01:59 train_current_model.py\n-r--r--r-- 1 root root 15985 Sep 29 01:59 two_tower_model.py\ntotal 340M\n-r--r--r-- 1 root root 342K Sep 29 01:59 candidate_catalog.parquet\n-r--r--r-- 1 root root 83K Sep 29 01:59 target_users.parquet\n-r--r--r-- 1 root root 7.4M Sep 29 01:59 test_eligible_candidates.npz\n-r--r--r-- 1 root root 1.1M Sep 29 02:00 test_preference_state.parquet\n-r--r--r-- 1 root root 838K Sep 29 01:59 train_dislikes.parquet\n-r--r--r-- 1 root root 5.2M Sep 29 01:59 train_likes.parquet\n-r--r--r-- 1 root root 305M Sep 29 01:59 train_listens.parquet\n-r--r--r-- 1 root root 153K Sep 29 01:59 train_undislikes.parquet\n-r--r--r-- 1 root root 1.8M Sep 29 01:59 train_unlikes.parquet\n-r--r--r-- 1 root root 36K Sep 29 01:59 val_dislikes.parquet\n-r--r--r-- 1 root root 292K Sep 29 01:59 val_likes.parquet\n-r--r--r-- 1 root root 9.5M Sep 29 01:59 val_listens.parquet\n-r--r--r-- 1 root root 7.7K Sep 29 01:59 val_undislikes.parquet\n-r--r--r-- 1 root root 71K Sep 29 01:59 val_unlikes.parquet\n-r--r--r-- 1 root root 7.3M Sep 29 01:59 validation_eligible_candidates.npz\n-r--r--r-- 1 root root 1.1M Sep 29 02:00 validation_preference_state.parquet\nProcess Group PGID: 1615\n",
"isError": false
},
"responseMessageId": "0f8ec4a7-69c2-4204-8bc6-ecd93cff86c9"
}
]
},
{
"id": 8,
"role": "agent",
"timestamp": "2026-09-29T02:05:26.198Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:05:26.198Z",
"text": "Examining Scripts\n\nI am currently reviewing the contents of `evaluate_public.py` and `ranking_evaluation.py`. My next step involves copying `train_current_model.py` and `two_tower_model.py` from `/task/current_model/` to `/app/solution/`."
},
{
"kind": "message",
"timestamp": "2026-09-29T02:05:26.198Z",
"text": "I will copy the production model source files from `/task/current_model/` into `/app/solution/` so that we can inspect, edit, and run them within the workspace."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:05:26.198Z",
"callId": "run_shell_command__call_4119122",
"name": "run_shell_command",
"input": {
"description": "Copy current_model files to /app/solution/",
"command": "cp /task/current_model/* /app/solution/"
},
"recorded": {
"id": "run_shell_command__call_4119122",
"name": "run_shell_command",
"args": {
"description": "Copy current_model files to /app/solution/",
"command": "cp /task/current_model/* /app/solution/"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_4119122",
"name": "run_shell_command",
"response": {
"output": "\nOutput: (empty)\nProcess Group PGID: 1619\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:05:26.211Z",
"resultDisplay": "",
"description": "cp /task/current_model/* /app/solution/",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:05:26.211Z",
"content": "\nOutput: (empty)\nProcess Group PGID: 1619\n",
"isError": false
},
"responseMessageId": "2673db41-1cf9-464d-bdb9-294f4e589b23"
}
]
},
{
"id": 9,
"role": "agent",
"timestamp": "2026-09-29T02:05:28.620Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:05:28.620Z",
"callId": "run_shell_command__call_37411",
"name": "run_shell_command",
"input": {
"description": "Check evaluate_public.py contents",
"command": "head -n 50 /task/evaluate_public.py"
},
"recorded": {
"id": "run_shell_command__call_37411",
"name": "run_shell_command",
"args": {
"description": "Check evaluate_public.py contents",
"command": "head -n 50 /task/evaluate_public.py"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_37411",
"name": "run_shell_command",
"response": {
"output": "\nOutput: #!/usr/bin/env python3\n\"\"\"Score a validation-stage ranking against public discovery labels.\n\n``build_task.py`` publishes this module with the solver-visible task files. It\nloads target users, validation eligibility, and validation-window events from\nthe adjacent ``data`` directory, then evaluates one ranking supplied on the\ncommand line. Stage-independent mechanics come from the adjacent public\n``ranking_evaluation.py`` module. The builder installs the same checked-in\nmodule in the private judge, so public and private scoring mechanics cannot\ndrift. A relevant candidate receives grade 3 for an organic like or grade 1 for\nan organic listen with at least 80 percent completion; a like takes precedence\nwhen both events exist.\n\nBefore scoring, the ranking must contain exactly 100 distinct eligible items\nfor every target user, with integer-valued ``uid``, ``item_id``, and ``rank``\ncolumns and ranks 1 through 100 exactly once per user. Extra columns are\nignored. Quality is graded NDCG@10, averaged only over users who have at least\none eligible relevant item in the validation window.\n\nThe evaluator prints a JSON object containing the model path and scores. It\ndoes not apply the task's pass threshold; its purpose is model development and\nselection. The private judge applies the threshold to the final submission.\n\nUsage::\n\n python evaluate_public.py \n\"\"\"\nfrom __future__ import annotations\n\nimport json\nimport sys\nfrom pathlib import Path\n\nimport pandas as pd\n\nfrom ranking_evaluation import (\n CandidateSet,\n RankingValidationError,\n ranked_items,\n read_ranking,\n score_rankings,\n validate_ranking,\n)\n\n\nHERE = Path(__file__).resolve().parent\nDATA = HERE / \"data\"\nLISTEN_STRONG = 80\nProcess Group PGID: 1622\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:05:28.631Z",
"resultDisplay": "#!/usr/bin/env python3\n\"\"\"Score a validation-stage ranking against public discovery labels.\n\n``build_task.py`` publishes this module with the solver-visible task files. It\nloads target users, validation eligibility, and validation-window events from\nthe adjacent ``data`` directory, then evaluates one ranking supplied on the\ncommand line. Stage-independent mechanics come from the adjacent public\n``ranking_evaluation.py`` module. The builder installs the same checked-in\nmodule in the private judge, so public and private scoring mechanics cannot\ndrift. A relevant candidate receives grade 3 for an organic like or grade 1 for\nan organic listen with at least 80 percent completion; a like takes precedence\nwhen both events exist.\n\nBefore scoring, the ranking must contain exactly 100 distinct eligible items\nfor every target user, with integer-valued ``uid``, ``item_id``, and ``rank``\ncolumns and ranks 1 through 100 exactly once per user. Extra columns are\nignored. Quality is graded NDCG@10, averaged only over users who have at least\none eligible relevant item in the validation window.\n\nThe evaluator prints a JSON object containing the model path and scores. It\ndoes not apply the task's pass threshold; its purpose is model development and\nselection. The private judge applies the threshold to the final submission.\n\nUsage::\n\n python evaluate_public.py \n\"\"\"\nfrom __future__ import annotations\n\nimport json\nimport sys\nfrom pathlib import Path\n\nimport pandas as pd\n\nfrom ranking_evaluation import (\n CandidateSet,\n RankingValidationError,\n ranked_items,\n read_ranking,\n score_rankings,\n validate_ranking,\n)\n\n\nHERE = Path(__file__).resolve().parent\nDATA = HERE / \"data\"\nLISTEN_STRONG = 80",
"description": "head -n 50 /task/evaluate_public.py",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:05:28.631Z",
"content": "\nOutput: #!/usr/bin/env python3\n\"\"\"Score a validation-stage ranking against public discovery labels.\n\n``build_task.py`` publishes this module with the solver-visible task files. It\nloads target users, validation eligibility, and validation-window events from\nthe adjacent ``data`` directory, then evaluates one ranking supplied on the\ncommand line. Stage-independent mechanics come from the adjacent public\n``ranking_evaluation.py`` module. The builder installs the same checked-in\nmodule in the private judge, so public and private scoring mechanics cannot\ndrift. A relevant candidate receives grade 3 for an organic like or grade 1 for\nan organic listen with at least 80 percent completion; a like takes precedence\nwhen both events exist.\n\nBefore scoring, the ranking must contain exactly 100 distinct eligible items\nfor every target user, with integer-valued ``uid``, ``item_id``, and ``rank``\ncolumns and ranks 1 through 100 exactly once per user. Extra columns are\nignored. Quality is graded NDCG@10, averaged only over users who have at least\none eligible relevant item in the validation window.\n\nThe evaluator prints a JSON object containing the model path and scores. It\ndoes not apply the task's pass threshold; its purpose is model development and\nselection. The private judge applies the threshold to the final submission.\n\nUsage::\n\n python evaluate_public.py \n\"\"\"\nfrom __future__ import annotations\n\nimport json\nimport sys\nfrom pathlib import Path\n\nimport pandas as pd\n\nfrom ranking_evaluation import (\n CandidateSet,\n RankingValidationError,\n ranked_items,\n read_ranking,\n score_rankings,\n validate_ranking,\n)\n\n\nHERE = Path(__file__).resolve().parent\nDATA = HERE / \"data\"\nLISTEN_STRONG = 80\nProcess Group PGID: 1622\n",
"isError": false
},
"responseMessageId": "fb7f738e-2ffd-4501-b1f7-2b9b0a809d09"
}
]
},
{
"id": 10,
"role": "agent",
"timestamp": "2026-09-29T02:05:31.126Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:05:31.126Z",
"callId": "run_shell_command__call_45857",
"name": "run_shell_command",
"input": {
"description": "Check CPU count, available RAM, and Python version",
"command": "nproc && free -h && python3 --version"
},
"recorded": {
"id": "run_shell_command__call_45857",
"name": "run_shell_command",
"args": {
"description": "Check CPU count, available RAM, and Python version",
"command": "nproc && free -h && python3 --version"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_45857",
"name": "run_shell_command",
"response": {
"output": "\nOutput: 8\n/usr/bin/bash: line 4: free: command not found\nExit Code: 127\nProcess Group PGID: 1625\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:05:31.139Z",
"resultDisplay": "8\n/usr/bin/bash: line 4: free: command not found",
"description": "nproc && free -h && python3 --version",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:05:31.139Z",
"content": "\nOutput: 8\n/usr/bin/bash: line 4: free: command not found\nExit Code: 127\nProcess Group PGID: 1625\n",
"isError": false
},
"responseMessageId": "3ca97570-24d4-464d-ab45-e022a41089a7"
}
]
},
{
"id": 11,
"role": "agent",
"timestamp": "2026-09-29T02:05:37.722Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:05:37.722Z",
"callId": "run_shell_command__call_20072",
"name": "run_shell_command",
"input": {
"description": "Check total memory and python version",
"command": "cat /proc/meminfo | grep MemTotal && python3 --version"
},
"recorded": {
"id": "run_shell_command__call_20072",
"name": "run_shell_command",
"args": {
"description": "Check total memory and python version",
"command": "cat /proc/meminfo | grep MemTotal && python3 --version"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_20072",
"name": "run_shell_command",
"response": {
"output": "\nOutput: MemTotal: 15988968 kB\nPython 3.12.13\nProcess Group PGID: 1629\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:05:37.737Z",
"resultDisplay": "MemTotal: 15988968 kB\nPython 3.12.13",
"description": "cat /proc/meminfo | grep MemTotal && python3 --version",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:05:37.738Z",
"content": "\nOutput: MemTotal: 15988968 kB\nPython 3.12.13\nProcess Group PGID: 1629\n",
"isError": false
},
"responseMessageId": "ae5f40e2-a934-4446-81a9-978d22c09f7c"
}
]
},
{
"id": 12,
"role": "agent",
"timestamp": "2026-09-29T02:05:40.665Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:05:40.665Z",
"text": "Running Baseline Reproduction\n\nI am currently executing the baseline reproduction command as outlined. The system has 8 CPU cores and approximately 16 GB of RAM available for this process. I will report back once this initial step is complete."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:05:40.665Z",
"callId": "run_shell_command__call_129467",
"name": "run_shell_command",
"input": {
"description": "Count lines in model files",
"command": "wc -l /app/solution/train_current_model.py /app/solution/two_tower_model.py"
},
"recorded": {
"id": "run_shell_command__call_129467",
"name": "run_shell_command",
"args": {
"description": "Count lines in model files",
"command": "wc -l /app/solution/train_current_model.py /app/solution/two_tower_model.py"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_129467",
"name": "run_shell_command",
"response": {
"output": "\nOutput: 2164 /app/solution/train_current_model.py\n 433 /app/solution/two_tower_model.py\n 2597 total\nProcess Group PGID: 1634\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:05:40.676Z",
"resultDisplay": "2164 /app/solution/train_current_model.py\n 433 /app/solution/two_tower_model.py\n 2597 total",
"description": "wc -l /app/solution/train_current_model.py /app/solution/two_tower_model.py",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:05:40.677Z",
"content": "\nOutput: 2164 /app/solution/train_current_model.py\n 433 /app/solution/two_tower_model.py\n 2597 total\nProcess Group PGID: 1634\n",
"isError": false
},
"responseMessageId": "159452af-822b-4545-b750-9c7077d92eab"
}
]
},
{
"id": 13,
"role": "agent",
"timestamp": "2026-09-29T02:05:42.587Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:05:42.587Z",
"callId": "read_file__call_1750409",
"name": "read_file",
"input": {
"end_line": 150,
"start_line": 1,
"file_path": "/app/solution/two_tower_model.py"
},
"recorded": {
"id": "read_file__call_1750409",
"name": "read_file",
"args": {
"end_line": 150,
"start_line": 1,
"file_path": "/app/solution/two_tower_model.py"
},
"result": [
{
"functionResponse": {
"id": "read_file__call_1750409",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1-150 of 434 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 151.\n\n--- FILE CONTENT (truncated) ---\n\"\"\"Shared public-data primitives for the Yambda two-tower baseline.\"\"\"\nfrom __future__ import annotations\n\nimport sys\nfrom dataclasses import dataclass\nfrom pathlib import Path\nfrom typing import Iterator\n\nimport numpy as np\nimport pandas as pd\nimport pyarrow.parquet as pq\nimport torch\nfrom torch import nn\n\n\nDAY = 86_400\nTRAIN_END = 24_786_800\nVALIDATION_END = 25_393_400\nLISTEN_POSITIVE_THRESHOLD = 50\nPROFILE_LOOKBACK_DAYS = 120\nLIKE_ITEMS = 48\nDISLIKE_ITEMS = 24\nTOP_N = 100\n\n\n@dataclass(frozen=True)\nclass TowerConfig:\n sequence_length: int = 100\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass ListenEvents:\n timestamps: np.ndarray\n items: np.ndarray\n organic: np.ndarray\n completion_pct: np.ndarray\n\n\n@dataclass(frozen=True)\nclass ExplicitEvents:\n timestamps: np.ndarray\n items: np.ndarray\n channel: np.ndarray\n active: np.ndarray\n organic_like: np.ndarray\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef build_item_features(catalog: pd.DataFrame) -> np.ndarray:\n \"\"\"Return four standardized features built only from the public catalog.\"\"\"\n positives = catalog.positive_listens.to_numpy(dtype=np.float64, copy=False)\n organic = catalog.organic_positive_listens.to_numpy(dtype=np.float64, copy=False)\n popularity_rank = catalog.popularity_rank.to_numpy(dtype=np.float64, copy=False)\n features = np.column_stack(\n [\n np.log1p(positives),\n np.log1p(organic),\n organic / np.maximum(positives, 1.0),\n 1.0 - (popularity_rank - 1.0) / max(len(catalog) - 1, 1),\n ]\n )\n means = features.mean(axis=0, keepdims=True)\n scales = np.maximum(features.std(axis=0, keepdims=True), 1.0e-6)\n standardized = ((features - means) / scales).astype(np.float32)\n if not np.isfinite(standardized).all():\n raise RuntimeError(\"catalog features contain non-finite values\")\n return standardized\n\n\ndef _combine_listen_chunks(parts: list[ListenEvents]) -> ListenEvents:\n if len(parts) == 1:\n return parts[0]\n timestamps = np.concatenate([part.timestamps for part in parts])\n items = np.concatenate([part.items for part in parts])\n organic = np.concatenate([part.organic for part in parts])\n completion = np.concatenate([part.completion_pct for part in parts])\n order = np.argsort(timestamps, kind=\"stable\")\n return ListenEvents(\n timestamps=timestamps[order],\n items=items[order],\n organic=organic[order],\n completion_pct=completion[order],\n )\n\n\ndef iter_listen_users(\n path: Path, item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Stream one uid-sorted public listen file one user at a time.\"\"\"\n parquet = pq.ParquetFile(path)\n pending_uid: int | None = None\n pending: list[ListenEvents] = []\n previous_uid = -1\n for batch in parquet.iter_batches(\n batch_size=750_000,\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\", \"played_ratio_pct\"],\n ):\n frame = batch.to_pandas()\n mapped = item_index.get_indexer(frame.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n if not np.any(keep):\n continue\n uids = frame.uid.to_numpy(dtype=np.int64, copy=False)[keep]\n timestamps = frame.timestamp.to_numpy(dtype=np.int64, copy=False)[keep]\n items = mapped[keep].astype(np.int32, copy=False)\n organic = frame.is_organic.to_numpy(dtype=np.uint8, copy=False)[keep]\n completion = frame.played_ratio_pct.to_numpy(dtype=np.uint16, copy=False)[keep]\n if np.any(uids[1:] < uids[:-1]):\n raise RuntimeError(f\"{path.name} is not sorted by uid\")\n boundaries = np.r_[\n 0,\n np.flatnonzero(uids[1:] != uids[:-1]) + 1,\n len(uids),\n ]\n for start, end in zip(boundaries[:-1], boundaries[1:]):\n uid = int(uids[start])\n part = ListenEvents(\n timestamps[start:end].copy(),\n items[start:end].copy(),\n organic[start:end].copy(),\n completion[start:end].copy(),\n )\n if pending_uid is None:\n pending_uid = uid\n elif uid != pending_uid:\n if pending_uid < previous_uid:\n raise RuntimeError(f\"{path.name} user order regressed\")\n yield pending_uid, _combine_listen_chunks(pending)\n previous_uid = pending_uid\n pending_uid = uid"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:05:42.593Z",
"resultDisplay": "Read lines 1-150 of 434 from solution/two_tower_model.py",
"description": "solution/two_tower_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:05:42.593Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1-150 of 434 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 151.\n\n--- FILE CONTENT (truncated) ---\n\"\"\"Shared public-data primitives for the Yambda two-tower baseline.\"\"\"\nfrom __future__ import annotations\n\nimport sys\nfrom dataclasses import dataclass\nfrom pathlib import Path\nfrom typing import Iterator\n\nimport numpy as np\nimport pandas as pd\nimport pyarrow.parquet as pq\nimport torch\nfrom torch import nn\n\n\nDAY = 86_400\nTRAIN_END = 24_786_800\nVALIDATION_END = 25_393_400\nLISTEN_POSITIVE_THRESHOLD = 50\nPROFILE_LOOKBACK_DAYS = 120\nLIKE_ITEMS = 48\nDISLIKE_ITEMS = 24\nTOP_N = 100\n\n\n@dataclass(frozen=True)\nclass TowerConfig:\n sequence_length: int = 100\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass ListenEvents:\n timestamps: np.ndarray\n items: np.ndarray\n organic: np.ndarray\n completion_pct: np.ndarray\n\n\n@dataclass(frozen=True)\nclass ExplicitEvents:\n timestamps: np.ndarray\n items: np.ndarray\n channel: np.ndarray\n active: np.ndarray\n organic_like: np.ndarray\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef build_item_features(catalog: pd.DataFrame) -> np.ndarray:\n \"\"\"Return four standardized features built only from the public catalog.\"\"\"\n positives = catalog.positive_listens.to_numpy(dtype=np.float64, copy=False)\n organic = catalog.organic_positive_listens.to_numpy(dtype=np.float64, copy=False)\n popularity_rank = catalog.popularity_rank.to_numpy(dtype=np.float64, copy=False)\n features = np.column_stack(\n [\n np.log1p(positives),\n np.log1p(organic),\n organic / np.maximum(positives, 1.0),\n 1.0 - (popularity_rank - 1.0) / max(len(catalog) - 1, 1),\n ]\n )\n means = features.mean(axis=0, keepdims=True)\n scales = np.maximum(features.std(axis=0, keepdims=True), 1.0e-6)\n standardized = ((features - means) / scales).astype(np.float32)\n if not np.isfinite(standardized).all():\n raise RuntimeError(\"catalog features contain non-finite values\")\n return standardized\n\n\ndef _combine_listen_chunks(parts: list[ListenEvents]) -> ListenEvents:\n if len(parts) == 1:\n return parts[0]\n timestamps = np.concatenate([part.timestamps for part in parts])\n items = np.concatenate([part.items for part in parts])\n organic = np.concatenate([part.organic for part in parts])\n completion = np.concatenate([part.completion_pct for part in parts])\n order = np.argsort(timestamps, kind=\"stable\")\n return ListenEvents(\n timestamps=timestamps[order],\n items=items[order],\n organic=organic[order],\n completion_pct=completion[order],\n )\n\n\ndef iter_listen_users(\n path: Path, item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Stream one uid-sorted public listen file one user at a time.\"\"\"\n parquet = pq.ParquetFile(path)\n pending_uid: int | None = None\n pending: list[ListenEvents] = []\n previous_uid = -1\n for batch in parquet.iter_batches(\n batch_size=750_000,\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\", \"played_ratio_pct\"],\n ):\n frame = batch.to_pandas()\n mapped = item_index.get_indexer(frame.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n if not np.any(keep):\n continue\n uids = frame.uid.to_numpy(dtype=np.int64, copy=False)[keep]\n timestamps = frame.timestamp.to_numpy(dtype=np.int64, copy=False)[keep]\n items = mapped[keep].astype(np.int32, copy=False)\n organic = frame.is_organic.to_numpy(dtype=np.uint8, copy=False)[keep]\n completion = frame.played_ratio_pct.to_numpy(dtype=np.uint16, copy=False)[keep]\n if np.any(uids[1:] < uids[:-1]):\n raise RuntimeError(f\"{path.name} is not sorted by uid\")\n boundaries = np.r_[\n 0,\n np.flatnonzero(uids[1:] != uids[:-1]) + 1,\n len(uids),\n ]\n for start, end in zip(boundaries[:-1], boundaries[1:]):\n uid = int(uids[start])\n part = ListenEvents(\n timestamps[start:end].copy(),\n items[start:end].copy(),\n organic[start:end].copy(),\n completion[start:end].copy(),\n )\n if pending_uid is None:\n pending_uid = uid\n elif uid != pending_uid:\n if pending_uid < previous_uid:\n raise RuntimeError(f\"{path.name} user order regressed\")\n yield pending_uid, _combine_listen_chunks(pending)\n previous_uid = pending_uid\n pending_uid = uid",
"isError": false
},
"responseMessageId": "03250089-c65c-43a7-8c85-ca6e11cf6fef"
}
]
},
{
"id": 14,
"role": "agent",
"timestamp": "2026-09-29T02:05:44.225Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:05:44.225Z",
"callId": "read_file__call_5218690",
"name": "read_file",
"input": {
"start_line": 151,
"end_line": 300,
"file_path": "/app/solution/two_tower_model.py"
},
"recorded": {
"id": "read_file__call_5218690",
"name": "read_file",
"args": {
"start_line": 151,
"end_line": 300,
"file_path": "/app/solution/two_tower_model.py"
},
"result": [
{
"functionResponse": {
"id": "read_file__call_5218690",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 151-300 of 434 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 301.\n\n--- FILE CONTENT (truncated) ---\n pending = []\n pending.append(part)\n if pending_uid is not None:\n yield pending_uid, _combine_listen_chunks(pending)\n\n\ndef merge_listen_streams(\n paths: list[Path], item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Merge uid-sorted public listen files without materializing them.\"\"\"\n streams = [iter(iter_listen_users(path, item_index)) for path in paths]\n heads: list[tuple[int, ListenEvents] | None] = [\n next(stream, None) for stream in streams\n ]\n while any(head is not None for head in heads):\n uid = min(head[0] for head in heads if head is not None)\n parts: list[ListenEvents] = []\n for position, head in enumerate(heads):\n if head is not None and head[0] == uid:\n parts.append(head[1])\n heads[position] = next(streams[position], None)\n yield uid, _combine_listen_chunks(parts)\n\n\ndef load_explicit_events(\n data: Path,\n prefixes: tuple[str, ...],\n item_index: pd.Index,\n) -> dict[int, ExplicitEvents]:\n \"\"\"Load public explicit actions as chronological state changes.\"\"\"\n specifications = (\n (\"likes\", 0, 1, 0),\n (\"unlikes\", 0, 0, 1),\n (\"dislikes\", 1, 1, 0),\n (\"undislikes\", 1, 0, 1),\n )\n parts: list[pd.DataFrame] = []\n for family, channel, active, tie_priority in specifications:\n for prefix in prefixes:\n frame = pd.read_parquet(\n data / f\"{prefix}_{family}.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n mapped = item_index.get_indexer(\n frame.item_id.to_numpy(dtype=np.int64, copy=False)\n )\n keep = mapped >= 0\n if not np.any(keep):\n continue\n retained = frame.loc[keep, [\"uid\", \"timestamp\", \"is_organic\"]].copy()\n retained[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n retained[\"channel\"] = np.int8(channel)\n retained[\"active\"] = np.int8(active)\n retained[\"tie_priority\"] = np.int8(tie_priority)\n retained[\"organic_like\"] = np.int8(\n family == \"likes\"\n ) * retained.is_organic.astype(np.int8)\n parts.append(retained.drop(columns=\"is_organic\"))\n if not parts:\n return {}\n events = pd.concat(parts, ignore_index=True)\n events = events.sort_values(\n [\"uid\", \"timestamp\", \"tie_priority\"], kind=\"mergesort\"\n ).reset_index(drop=True)\n result: dict[int, ExplicitEvents] = {}\n for uid, rows in events.groupby(\"uid\", sort=False):\n result[int(uid)] = ExplicitEvents(\n timestamps=rows.timestamp.to_numpy(dtype=np.int64, copy=True),\n items=rows.item.to_numpy(dtype=np.int32, copy=True),\n channel=rows.channel.to_numpy(dtype=np.int8, copy=True),\n active=rows.active.to_numpy(dtype=np.int8, copy=True),\n organic_like=rows.organic_like.to_numpy(dtype=np.int8, copy=True),\n )\n log(f\"loaded explicit events: rows={len(events):,} users={len(result):,}\")\n return result\n\n\ndef empty_explicit_events() -> ExplicitEvents:\n return ExplicitEvents(\n timestamps=np.empty(0, dtype=np.int64),\n items=np.empty(0, dtype=np.int32),\n channel=np.empty(0, dtype=np.int8),\n active=np.empty(0, dtype=np.int8),\n organic_like=np.empty(0, dtype=np.int8),\n )\n\n\ndef pack_active_items(\n active: dict[int, int], width: int, padding_item: int\n) -> np.ndarray:\n packed = np.full(width, padding_item, dtype=np.uint16)\n if not active:\n return packed\n ordered = sorted(active.items(), key=lambda pair: (-pair[1], pair[0]))[:width]\n packed[: len(ordered)] = np.fromiter(\n (item for item, _ in ordered), dtype=np.uint16, count=len(ordered)\n )\n return packed\n\n\ndef load_inference_state(\n path: Path,\n item_index: pd.Index,\n uids: np.ndarray,\n n_items: int,\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray]:\n \"\"\"Pack the task-provided active explicit state.\"\"\"\n state = pd.read_parquet(path, columns=[\"uid\", \"item_id\", \"state\"])\n mapped = item_index.get_indexer(state.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n state = state.loc[keep, [\"uid\", \"state\"]].copy()\n state[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n user_rows = pd.Index(uids)\n liked = np.full((len(uids), LIKE_ITEMS), n_items, dtype=np.uint16)\n disliked = np.full((len(uids), DISLIKE_ITEMS), n_items, dtype=np.uint16)\n like_counts = np.zeros(len(uids), dtype=np.int32)\n dislike_counts = np.zeros(len(uids), dtype=np.int32)\n for value, width, destination, counts in (\n (\"liked\", LIKE_ITEMS, liked, like_counts),\n (\"disliked\", DISLIKE_ITEMS, disliked, dislike_counts),\n ):\n selected = state[state.state == value]\n for uid, rows in selected.groupby(\"uid\", sort=False):\n row = int(user_rows.get_indexer([int(uid)])[0])\n if row < 0:\n continue\n items = np.sort(rows.item.unique())\n counts[row] = len(items)\n retained = items[:width]\n destination[row, : len(retained)] = retained.astype(np.uint16)\n return liked, disliked, like_counts, dislike_counts\n\n\nclass SequentialTwoTower(nn.Module):\n \"\"\"Order-sensitive user tower and independent catalog-aware item tower.\"\"\"\n\n def __init__(self, item_features: np.ndarray, config: TowerConfig) -> None:\n super().__init__()\n n_items, n_item_features = item_features.shape\n dim = config.embedding_dim\n self.n_items = n_items\n self.context_embedding = nn.Embedding(\n n_items + 1, dim, padding_idx=n_items\n )\n self.event_projection = nn.Sequential(\n nn.Linear(dim + 3, config.hidden_dim),\n nn.GELU(),\n )\n self.sequence_encoder = nn.GRU(\n input_size=config.hidden_dim,"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:05:44.228Z",
"resultDisplay": "Read lines 151-300 of 434 from solution/two_tower_model.py",
"description": "solution/two_tower_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:05:44.229Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 151-300 of 434 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 301.\n\n--- FILE CONTENT (truncated) ---\n pending = []\n pending.append(part)\n if pending_uid is not None:\n yield pending_uid, _combine_listen_chunks(pending)\n\n\ndef merge_listen_streams(\n paths: list[Path], item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Merge uid-sorted public listen files without materializing them.\"\"\"\n streams = [iter(iter_listen_users(path, item_index)) for path in paths]\n heads: list[tuple[int, ListenEvents] | None] = [\n next(stream, None) for stream in streams\n ]\n while any(head is not None for head in heads):\n uid = min(head[0] for head in heads if head is not None)\n parts: list[ListenEvents] = []\n for position, head in enumerate(heads):\n if head is not None and head[0] == uid:\n parts.append(head[1])\n heads[position] = next(streams[position], None)\n yield uid, _combine_listen_chunks(parts)\n\n\ndef load_explicit_events(\n data: Path,\n prefixes: tuple[str, ...],\n item_index: pd.Index,\n) -> dict[int, ExplicitEvents]:\n \"\"\"Load public explicit actions as chronological state changes.\"\"\"\n specifications = (\n (\"likes\", 0, 1, 0),\n (\"unlikes\", 0, 0, 1),\n (\"dislikes\", 1, 1, 0),\n (\"undislikes\", 1, 0, 1),\n )\n parts: list[pd.DataFrame] = []\n for family, channel, active, tie_priority in specifications:\n for prefix in prefixes:\n frame = pd.read_parquet(\n data / f\"{prefix}_{family}.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n mapped = item_index.get_indexer(\n frame.item_id.to_numpy(dtype=np.int64, copy=False)\n )\n keep = mapped >= 0\n if not np.any(keep):\n continue\n retained = frame.loc[keep, [\"uid\", \"timestamp\", \"is_organic\"]].copy()\n retained[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n retained[\"channel\"] = np.int8(channel)\n retained[\"active\"] = np.int8(active)\n retained[\"tie_priority\"] = np.int8(tie_priority)\n retained[\"organic_like\"] = np.int8(\n family == \"likes\"\n ) * retained.is_organic.astype(np.int8)\n parts.append(retained.drop(columns=\"is_organic\"))\n if not parts:\n return {}\n events = pd.concat(parts, ignore_index=True)\n events = events.sort_values(\n [\"uid\", \"timestamp\", \"tie_priority\"], kind=\"mergesort\"\n ).reset_index(drop=True)\n result: dict[int, ExplicitEvents] = {}\n for uid, rows in events.groupby(\"uid\", sort=False):\n result[int(uid)] = ExplicitEvents(\n timestamps=rows.timestamp.to_numpy(dtype=np.int64, copy=True),\n items=rows.item.to_numpy(dtype=np.int32, copy=True),\n channel=rows.channel.to_numpy(dtype=np.int8, copy=True),\n active=rows.active.to_numpy(dtype=np.int8, copy=True),\n organic_like=rows.organic_like.to_numpy(dtype=np.int8, copy=True),\n )\n log(f\"loaded explicit events: rows={len(events):,} users={len(result):,}\")\n return result\n\n\ndef empty_explicit_events() -> ExplicitEvents:\n return ExplicitEvents(\n timestamps=np.empty(0, dtype=np.int64),\n items=np.empty(0, dtype=np.int32),\n channel=np.empty(0, dtype=np.int8),\n active=np.empty(0, dtype=np.int8),\n organic_like=np.empty(0, dtype=np.int8),\n )\n\n\ndef pack_active_items(\n active: dict[int, int], width: int, padding_item: int\n) -> np.ndarray:\n packed = np.full(width, padding_item, dtype=np.uint16)\n if not active:\n return packed\n ordered = sorted(active.items(), key=lambda pair: (-pair[1], pair[0]))[:width]\n packed[: len(ordered)] = np.fromiter(\n (item for item, _ in ordered), dtype=np.uint16, count=len(ordered)\n )\n return packed\n\n\ndef load_inference_state(\n path: Path,\n item_index: pd.Index,\n uids: np.ndarray,\n n_items: int,\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray]:\n \"\"\"Pack the task-provided active explicit state.\"\"\"\n state = pd.read_parquet(path, columns=[\"uid\", \"item_id\", \"state\"])\n mapped = item_index.get_indexer(state.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n state = state.loc[keep, [\"uid\", \"state\"]].copy()\n state[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n user_rows = pd.Index(uids)\n liked = np.full((len(uids), LIKE_ITEMS), n_items, dtype=np.uint16)\n disliked = np.full((len(uids), DISLIKE_ITEMS), n_items, dtype=np.uint16)\n like_counts = np.zeros(len(uids), dtype=np.int32)\n dislike_counts = np.zeros(len(uids), dtype=np.int32)\n for value, width, destination, counts in (\n (\"liked\", LIKE_ITEMS, liked, like_counts),\n (\"disliked\", DISLIKE_ITEMS, disliked, dislike_counts),\n ):\n selected = state[state.state == value]\n for uid, rows in selected.groupby(\"uid\", sort=False):\n row = int(user_rows.get_indexer([int(uid)])[0])\n if row < 0:\n continue\n items = np.sort(rows.item.unique())\n counts[row] = len(items)\n retained = items[:width]\n destination[row, : len(retained)] = retained.astype(np.uint16)\n return liked, disliked, like_counts, dislike_counts\n\n\nclass SequentialTwoTower(nn.Module):\n \"\"\"Order-sensitive user tower and independent catalog-aware item tower.\"\"\"\n\n def __init__(self, item_features: np.ndarray, config: TowerConfig) -> None:\n super().__init__()\n n_items, n_item_features = item_features.shape\n dim = config.embedding_dim\n self.n_items = n_items\n self.context_embedding = nn.Embedding(\n n_items + 1, dim, padding_idx=n_items\n )\n self.event_projection = nn.Sequential(\n nn.Linear(dim + 3, config.hidden_dim),\n nn.GELU(),\n )\n self.sequence_encoder = nn.GRU(\n input_size=config.hidden_dim,",
"isError": false
},
"responseMessageId": "a48df2d5-89a5-458f-9987-c982a0462cd8"
}
]
},
{
"id": 15,
"role": "agent",
"timestamp": "2026-09-29T02:05:45.775Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:05:45.775Z",
"callId": "read_file__call_1188801",
"name": "read_file",
"input": {
"start_line": 301,
"end_line": 434,
"file_path": "/app/solution/two_tower_model.py"
},
"recorded": {
"id": "read_file__call_1188801",
"name": "read_file",
"args": {
"start_line": 301,
"end_line": 434,
"file_path": "/app/solution/two_tower_model.py"
},
"result": [
{
"functionResponse": {
"id": "read_file__call_1188801",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 301-434 of 434 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 435.\n\n--- FILE CONTENT (truncated) ---\n hidden_size=dim,\n num_layers=1,\n batch_first=True,\n )\n self.user_tower = nn.Sequential(\n nn.Linear(dim * 3 + 6, config.user_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_1, config.user_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_2, dim),\n )\n self.candidate_embedding = nn.Embedding(n_items, dim)\n self.register_buffer(\n \"item_features\", torch.from_numpy(item_features), persistent=True\n )\n self.item_tower = nn.Sequential(\n nn.Linear(dim + n_item_features, config.item_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_1, config.item_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_2, dim),\n )\n nn.init.normal_(self.context_embedding.weight, std=0.02)\n nn.init.normal_(self.candidate_embedding.weight, std=0.02)\n with torch.no_grad():\n self.context_embedding.weight[n_items].zero_()\n\n def _mean_context_channel(self, items: torch.Tensor) -> torch.Tensor:\n mask = items.ne(self.n_items)\n vectors = self.context_embedding(items)\n return (vectors * mask.unsqueeze(-1)).sum(dim=1) / mask.sum(\n dim=1, keepdim=True\n ).clamp_min(1)\n\n def encode_items(self, items: torch.Tensor) -> torch.Tensor:\n inputs = torch.cat(\n [self.candidate_embedding(items), self.item_features[items]], dim=1\n )\n return self.item_tower(inputs)\n\n\ndef invalid_negative_mask(\n negatives: torch.Tensor,\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n) -> torch.Tensor:\n \"\"\"Identify targets, known positives, active likes, and row duplicates.\"\"\"\n invalid = negatives.eq(targets[:, None])\n invalid |= negatives[:, :, None].eq(context_items[:, None, :]).any(dim=2)\n invalid |= negatives[:, :, None].eq(liked_items[:, None, :]).any(dim=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= negatives[:, column, None].eq(\n negatives[:, :column]\n ).any(dim=1)\n return invalid\n\n\ndef draw_filtered_mixed_negatives(\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n n_items: int,\n uniform_count: int,\n inbatch_count: int,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw uniform and unique-target in-batch negatives.\"\"\"\n batch_size = len(targets)\n uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n :, uniform_count : uniform_count + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]]\n negatives = negatives_cpu.to(device)\n correction = correction_cpu.to(device)\n for _ in range(32):\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if not bool(invalid.any()):\n return negatives, correction\n replacements = torch.randint(\n n_items,\n (int(invalid.sum().detach().cpu()),),\n generator=generator,\n device=\"cpu\",\n ).to(device)\n negatives[invalid] = replacements\n correction[invalid] = 1.0\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if bool(invalid.any()):\n raise RuntimeError(\"mixed negative resampling failed false-negative filter\")\n return negatives, correction\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:05:45.778Z",
"resultDisplay": "Read lines 301-434 of 434 from solution/two_tower_model.py",
"description": "solution/two_tower_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:05:45.778Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 301-434 of 434 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 435.\n\n--- FILE CONTENT (truncated) ---\n hidden_size=dim,\n num_layers=1,\n batch_first=True,\n )\n self.user_tower = nn.Sequential(\n nn.Linear(dim * 3 + 6, config.user_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_1, config.user_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_2, dim),\n )\n self.candidate_embedding = nn.Embedding(n_items, dim)\n self.register_buffer(\n \"item_features\", torch.from_numpy(item_features), persistent=True\n )\n self.item_tower = nn.Sequential(\n nn.Linear(dim + n_item_features, config.item_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_1, config.item_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_2, dim),\n )\n nn.init.normal_(self.context_embedding.weight, std=0.02)\n nn.init.normal_(self.candidate_embedding.weight, std=0.02)\n with torch.no_grad():\n self.context_embedding.weight[n_items].zero_()\n\n def _mean_context_channel(self, items: torch.Tensor) -> torch.Tensor:\n mask = items.ne(self.n_items)\n vectors = self.context_embedding(items)\n return (vectors * mask.unsqueeze(-1)).sum(dim=1) / mask.sum(\n dim=1, keepdim=True\n ).clamp_min(1)\n\n def encode_items(self, items: torch.Tensor) -> torch.Tensor:\n inputs = torch.cat(\n [self.candidate_embedding(items), self.item_features[items]], dim=1\n )\n return self.item_tower(inputs)\n\n\ndef invalid_negative_mask(\n negatives: torch.Tensor,\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n) -> torch.Tensor:\n \"\"\"Identify targets, known positives, active likes, and row duplicates.\"\"\"\n invalid = negatives.eq(targets[:, None])\n invalid |= negatives[:, :, None].eq(context_items[:, None, :]).any(dim=2)\n invalid |= negatives[:, :, None].eq(liked_items[:, None, :]).any(dim=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= negatives[:, column, None].eq(\n negatives[:, :column]\n ).any(dim=1)\n return invalid\n\n\ndef draw_filtered_mixed_negatives(\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n n_items: int,\n uniform_count: int,\n inbatch_count: int,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw uniform and unique-target in-batch negatives.\"\"\"\n batch_size = len(targets)\n uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n :, uniform_count : uniform_count + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]]\n negatives = negatives_cpu.to(device)\n correction = correction_cpu.to(device)\n for _ in range(32):\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if not bool(invalid.any()):\n return negatives, correction\n replacements = torch.randint(\n n_items,\n (int(invalid.sum().detach().cpu()),),\n generator=generator,\n device=\"cpu\",\n ).to(device)\n negatives[invalid] = replacements\n correction[invalid] = 1.0\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if bool(invalid.any()):\n raise RuntimeError(\"mixed negative resampling failed false-negative filter\")\n return negatives, correction\n",
"isError": false
},
"responseMessageId": "6cacd318-e047-43c1-a23e-b9b024997d48"
}
]
},
{
"id": 16,
"role": "agent",
"timestamp": "2026-09-29T02:05:47.852Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:05:47.852Z",
"callId": "grep_search__call_97833",
"name": "grep_search",
"input": {
"dir_path": "/app/solution",
"pattern": "^(def |class )"
},
"recorded": {
"id": "grep_search__call_97833",
"name": "grep_search",
"args": {
"dir_path": "/app/solution",
"pattern": "^(def |class )"
},
"result": [
{
"functionResponse": {
"id": "grep_search__call_97833",
"name": "grep_search",
"response": {
"output": "Found 58 matches for pattern \"^(def |class )\" in path \"/app/solution\":\n---\nFile: train_current_model.py\nL41: class Config:\nL76: class CandidateSet:\nL99: class SequenceData:\nL127: class TargetPartition:\nL140: def log(message: str) -> None:\nL144: def seed_everything(seed: int) -> None:\nL150: def model_config(config: Config) -> base.TowerConfig:\nL174: def append_state_snapshot(\nL190: def causal_activity_features(\nL247: def build_sequence_parts(\nL314: def final_user_features(\nL341: def prepare_data(\nL471: def cache_metadata(stage: str, config: Config) -> dict[str, object]:\nL481: def save_cache(\nL493: def load_cache(path: Path, stage: str, config: Config) -> SequenceData:\nL511: def load_or_prepare(\nL534: def build_item_correction(\nL578: def build_known_positive_filter(\nL609: def invalid_full_history_negatives(\nL630: def draw_full_history_filtered_negatives(\nL724: def draw_training_negatives(\nL763: def event_sequence(\nL774: def pool_explicit_states(\nL798: def user_queries(\nL813: def candidate_vectors(\nL828: def history_windows(\nL845: def corrected_negative_loss(\nL867: def retained_target_window_starts(\nL888: def chronological_target_partition(\nL914: def load_organic_like_outcomes(\nL955: def build_target_weights(\nL1035: def build_dense_block(\nL1111: def score_target_microbatches(\nL1198: def release_accelerator_cache(device: torch.device) -> None:\nL1203: def run_training_epoch(\nL1364: def evaluate_validation_bce(\nL1488: def snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\nL1495: def save_epoch_checkpoint(\nL1521: def train_model(\nL1782: def inference_queries(\nL1861: def rank_candidates(\nL1912: def write_ranking(frame: pd.DataFrame, output: Path) -> None:\nL1922: def main() -> int:\n---\nFile: two_tower_model.py\nL27: class TowerConfig:\nL49: class ListenEvents:\nL57: class ExplicitEvents:\nL65: def log(message: str) -> None:\nL69: def build_item_features(catalog: pd.DataFrame) -> np.ndarray:\nL90: def _combine_listen_chunks(parts: list[ListenEvents]) -> ListenEvents:\nL106: def iter_listen_users(\nL157: def merge_listen_streams(\nL175: def load_explicit_events(\nL228: def empty_explicit_events() -> ExplicitEvents:\nL238: def pack_active_items(\nL251: def load_inference_state(\nL284: class SequentialTwoTower(nn.Module):\nL346: def invalid_negative_mask(\nL363: def draw_filtered_mixed_negatives(\n---"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:05:47.867Z",
"resultDisplay": {
"summary": "Found 58 matches",
"matches": [
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 41,
"line": "class Config:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 76,
"line": "class CandidateSet:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 99,
"line": "class SequenceData:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 127,
"line": "class TargetPartition:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 140,
"line": "def log(message: str) -> None:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 144,
"line": "def seed_everything(seed: int) -> None:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 150,
"line": "def model_config(config: Config) -> base.TowerConfig:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 174,
"line": "def append_state_snapshot("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 190,
"line": "def causal_activity_features("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 247,
"line": "def build_sequence_parts("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 314,
"line": "def final_user_features("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 341,
"line": "def prepare_data("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 471,
"line": "def cache_metadata(stage: str, config: Config) -> dict[str, object]:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 481,
"line": "def save_cache("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 493,
"line": "def load_cache(path: Path, stage: str, config: Config) -> SequenceData:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 511,
"line": "def load_or_prepare("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 534,
"line": "def build_item_correction("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 578,
"line": "def build_known_positive_filter("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 609,
"line": "def invalid_full_history_negatives("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 630,
"line": "def draw_full_history_filtered_negatives("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 724,
"line": "def draw_training_negatives("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 763,
"line": "def event_sequence("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 774,
"line": "def pool_explicit_states("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 798,
"line": "def user_queries("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 813,
"line": "def candidate_vectors("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 828,
"line": "def history_windows("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 845,
"line": "def corrected_negative_loss("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 867,
"line": "def retained_target_window_starts("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 888,
"line": "def chronological_target_partition("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 914,
"line": "def load_organic_like_outcomes("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 955,
"line": "def build_target_weights("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1035,
"line": "def build_dense_block("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1111,
"line": "def score_target_microbatches("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1198,
"line": "def release_accelerator_cache(device: torch.device) -> None:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1203,
"line": "def run_training_epoch("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1364,
"line": "def evaluate_validation_bce("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1488,
"line": "def snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1495,
"line": "def save_epoch_checkpoint("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1521,
"line": "def train_model("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1782,
"line": "def inference_queries("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1861,
"line": "def rank_candidates("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1912,
"line": "def write_ranking(frame: pd.DataFrame, output: Path) -> None:"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1922,
"line": "def main() -> int:"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 27,
"line": "class TowerConfig:"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 49,
"line": "class ListenEvents:"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 57,
"line": "class ExplicitEvents:"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 65,
"line": "def log(message: str) -> None:"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 69,
"line": "def build_item_features(catalog: pd.DataFrame) -> np.ndarray:"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 90,
"line": "def _combine_listen_chunks(parts: list[ListenEvents]) -> ListenEvents:"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 106,
"line": "def iter_listen_users("
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 157,
"line": "def merge_listen_streams("
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 175,
"line": "def load_explicit_events("
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 228,
"line": "def empty_explicit_events() -> ExplicitEvents:"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 238,
"line": "def pack_active_items("
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 251,
"line": "def load_inference_state("
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 284,
"line": "class SequentialTwoTower(nn.Module):"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 346,
"line": "def invalid_negative_mask("
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 363,
"line": "def draw_filtered_mixed_negatives("
}
]
},
"description": "'^(def |class )' within solution",
"displayName": "SearchText",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:05:47.869Z",
"content": "Found 58 matches for pattern \"^(def |class )\" in path \"/app/solution\":\n---\nFile: train_current_model.py\nL41: class Config:\nL76: class CandidateSet:\nL99: class SequenceData:\nL127: class TargetPartition:\nL140: def log(message: str) -> None:\nL144: def seed_everything(seed: int) -> None:\nL150: def model_config(config: Config) -> base.TowerConfig:\nL174: def append_state_snapshot(\nL190: def causal_activity_features(\nL247: def build_sequence_parts(\nL314: def final_user_features(\nL341: def prepare_data(\nL471: def cache_metadata(stage: str, config: Config) -> dict[str, object]:\nL481: def save_cache(\nL493: def load_cache(path: Path, stage: str, config: Config) -> SequenceData:\nL511: def load_or_prepare(\nL534: def build_item_correction(\nL578: def build_known_positive_filter(\nL609: def invalid_full_history_negatives(\nL630: def draw_full_history_filtered_negatives(\nL724: def draw_training_negatives(\nL763: def event_sequence(\nL774: def pool_explicit_states(\nL798: def user_queries(\nL813: def candidate_vectors(\nL828: def history_windows(\nL845: def corrected_negative_loss(\nL867: def retained_target_window_starts(\nL888: def chronological_target_partition(\nL914: def load_organic_like_outcomes(\nL955: def build_target_weights(\nL1035: def build_dense_block(\nL1111: def score_target_microbatches(\nL1198: def release_accelerator_cache(device: torch.device) -> None:\nL1203: def run_training_epoch(\nL1364: def evaluate_validation_bce(\nL1488: def snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\nL1495: def save_epoch_checkpoint(\nL1521: def train_model(\nL1782: def inference_queries(\nL1861: def rank_candidates(\nL1912: def write_ranking(frame: pd.DataFrame, output: Path) -> None:\nL1922: def main() -> int:\n---\nFile: two_tower_model.py\nL27: class TowerConfig:\nL49: class ListenEvents:\nL57: class ExplicitEvents:\nL65: def log(message: str) -> None:\nL69: def build_item_features(catalog: pd.DataFrame) -> np.ndarray:\nL90: def _combine_listen_chunks(parts: list[ListenEvents]) -> ListenEvents:\nL106: def iter_listen_users(\nL157: def merge_listen_streams(\nL175: def load_explicit_events(\nL228: def empty_explicit_events() -> ExplicitEvents:\nL238: def pack_active_items(\nL251: def load_inference_state(\nL284: class SequentialTwoTower(nn.Module):\nL346: def invalid_negative_mask(\nL363: def draw_filtered_mixed_negatives(\n---",
"isError": false
},
"responseMessageId": "e1cfd19e-dc0f-4613-b7c8-56c5cb1ac52d"
}
]
},
{
"id": 17,
"role": "agent",
"timestamp": "2026-09-29T02:05:52.165Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:05:52.165Z",
"text": "Exploring Model Training Logic\n\nI'm currently examining the functions within `train_current_model.py`, specifically focusing on `build_item_correction`, `build_known_positive_filter`, `invalid_full_history_negatives`, `draw_full_history_filtered_negatives`, and `draw_training_negatives`. My aim is to understand their roles in the model's training pipeline."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:05:52.165Z",
"text": "Testing Baseline Execution\n\nI'm initiating a run of the baseline model to confirm its operational integrity, benchmark its execution duration, and establish a baseline NDCG@10 score. This initial test will inform subsequent investigations into negative sampling strategies."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:05:52.165Z",
"callId": "run_shell_command__call_5786694",
"name": "run_shell_command",
"input": {
"description": "Run baseline model training on validation stage",
"command": "python3 /task/current_model/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --output /app/solution/production_validation.parquet"
},
"recorded": {
"id": "run_shell_command__call_5786694",
"name": "run_shell_command",
"args": {
"description": "Run baseline model training on validation stage",
"command": "python3 /task/current_model/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --output /app/solution/production_validation.parquet"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5786694",
"name": "run_shell_command",
"response": {
"output": "\nOutput: loaded explicit events: rows=720,270 users=8,220\nprepared users=1,000 tokens=2,090,746 states=35,727 elapsed=4.9s\nprepared users=2,000 tokens=4,301,266 states=71,242 elapsed=9.9s\nprepared users=3,000 tokens=6,486,146 states=109,471 elapsed=15.1s\nprepared users=4,000 tokens=8,793,043 states=148,210 elapsed=20.5s\nprepared users=5,000 tokens=10,992,205 states=182,596 elapsed=25.3s\nprepared users=6,000 tokens=13,061,727 states=217,148 elapsed=30.1s\nprepared users=7,000 tokens=15,334,418 states=256,914 elapsed=35.6s\nprepared users=8,000 tokens=17,462,672 states=296,703 elapsed=41.0s\nprepared users=9,000 tokens=19,568,405 states=331,551 elapsed=45.7s\ntarget users without qualifying catalog sequence=7\nprepared stage=validation sequence_users=9,135 tokens=20,056,329 next_item_targets=20,047,194 states=339,133\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\ntarget weighting=organic-strong min=0.250 mean=0.575 max=1.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.547529 running_bce=0.541614 elapsed=197.4s\nepoch=1/1 train_loss=0.53984 validation_loss=0.49664 pair_accuracy=0.755 train_targets=1,052,953 validation_targets=130,103 train_seconds=210.3 validation_seconds=15.4\nrestored best validation-BCE checkpoint: epoch=1 loss=0.496636\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/production_validation.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 359.426,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5398380485827885,\n \"positive_logit\": 0.7427799622103317,\n \"negative_logit\": -0.622224706198751,\n \"pair_accuracy\": 0.754773301847281,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 632551.0,\n \"batches\": 266.0,\n \"seconds\": 210.331716518,\n \"validation_loss\": 0.4966362168774782,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 78769.25,\n \"validation_seconds\": 15.366156885999999\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.603016972541809,\n \"query_norm_std\": 0.7697498202323914,\n \"item_norm_mean\": 1.7570279836654663,\n \"item_norm_std\": 0.8279486298561096\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 1639\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:11:55.974Z",
"resultDisplay": "loaded explicit events: rows=720,270 users=8,220\nprepared users=1,000 tokens=2,090,746 states=35,727 elapsed=4.9s\nprepared users=2,000 tokens=4,301,266 states=71,242 elapsed=9.9s\nprepared users=3,000 tokens=6,486,146 states=109,471 elapsed=15.1s\nprepared users=4,000 tokens=8,793,043 states=148,210 elapsed=20.5s\nprepared users=5,000 tokens=10,992,205 states=182,596 elapsed=25.3s\nprepared users=6,000 tokens=13,061,727 states=217,148 elapsed=30.1s\nprepared users=7,000 tokens=15,334,418 states=256,914 elapsed=35.6s\nprepared users=8,000 tokens=17,462,672 states=296,703 elapsed=41.0s\nprepared users=9,000 tokens=19,568,405 states=331,551 elapsed=45.7s\ntarget users without qualifying catalog sequence=7\nprepared stage=validation sequence_users=9,135 tokens=20,056,329 next_item_targets=20,047,194 states=339,133\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\ntarget weighting=organic-strong min=0.250 mean=0.575 max=1.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.547529 running_bce=0.541614 elapsed=197.4s\nepoch=1/1 train_loss=0.53984 validation_loss=0.49664 pair_accuracy=0.755 train_targets=1,052,953 validation_targets=130,103 train_seconds=210.3 validation_seconds=15.4\nrestored best validation-BCE checkpoint: epoch=1 loss=0.496636\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/production_validation.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 359.426,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5398380485827885,\n \"positive_logit\": 0.7427799622103317,\n \"negative_logit\": -0.622224706198751,\n \"pair_accuracy\": 0.754773301847281,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 632551.0,\n \"batches\": 266.0,\n \"seconds\": 210.331716518,\n \"validation_loss\": 0.4966362168774782,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 78769.25,\n \"validation_seconds\": 15.366156885999999\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.603016972541809,\n \"query_norm_std\": 0.7697498202323914,\n \"item_norm_mean\": 1.7570279836654663,\n \"item_norm_std\": 0.8279486298561096\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}",
"description": "Run baseline model training on validation stage",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:11:55.975Z",
"content": "\nOutput: loaded explicit events: rows=720,270 users=8,220\nprepared users=1,000 tokens=2,090,746 states=35,727 elapsed=4.9s\nprepared users=2,000 tokens=4,301,266 states=71,242 elapsed=9.9s\nprepared users=3,000 tokens=6,486,146 states=109,471 elapsed=15.1s\nprepared users=4,000 tokens=8,793,043 states=148,210 elapsed=20.5s\nprepared users=5,000 tokens=10,992,205 states=182,596 elapsed=25.3s\nprepared users=6,000 tokens=13,061,727 states=217,148 elapsed=30.1s\nprepared users=7,000 tokens=15,334,418 states=256,914 elapsed=35.6s\nprepared users=8,000 tokens=17,462,672 states=296,703 elapsed=41.0s\nprepared users=9,000 tokens=19,568,405 states=331,551 elapsed=45.7s\ntarget users without qualifying catalog sequence=7\nprepared stage=validation sequence_users=9,135 tokens=20,056,329 next_item_targets=20,047,194 states=339,133\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\ntarget weighting=organic-strong min=0.250 mean=0.575 max=1.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.547529 running_bce=0.541614 elapsed=197.4s\nepoch=1/1 train_loss=0.53984 validation_loss=0.49664 pair_accuracy=0.755 train_targets=1,052,953 validation_targets=130,103 train_seconds=210.3 validation_seconds=15.4\nrestored best validation-BCE checkpoint: epoch=1 loss=0.496636\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/production_validation.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 359.426,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5398380485827885,\n \"positive_logit\": 0.7427799622103317,\n \"negative_logit\": -0.622224706198751,\n \"pair_accuracy\": 0.754773301847281,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 632551.0,\n \"batches\": 266.0,\n \"seconds\": 210.331716518,\n \"validation_loss\": 0.4966362168774782,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 78769.25,\n \"validation_seconds\": 15.366156885999999\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.603016972541809,\n \"query_norm_std\": 0.7697498202323914,\n \"item_norm_mean\": 1.7570279836654663,\n \"item_norm_std\": 0.8279486298561096\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 1639\n",
"isError": false
},
"responseMessageId": "794107c0-0ad1-4f5b-830c-40c63444a5e6"
}
]
},
{
"id": 18,
"role": "agent",
"timestamp": "2026-09-29T02:12:16.408Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:16.408Z",
"callId": "run_shell_command__call_2812286",
"name": "run_shell_command",
"input": {
"description": "Evaluate baseline validation ranking",
"command": "python3 /task/evaluate_public.py /app/solution/production_validation.parquet"
},
"recorded": {
"id": "run_shell_command__call_2812286",
"name": "run_shell_command",
"args": {
"description": "Evaluate baseline validation ranking",
"command": "python3 /task/evaluate_public.py /app/solution/production_validation.parquet"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_2812286",
"name": "run_shell_command",
"response": {
"output": "\nOutput: {\n \"model\": \"/app/solution/production_validation.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.02128,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 1671\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:19.781Z",
"resultDisplay": "{\n \"model\": \"/app/solution/production_validation.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.02128,\n \"quality_users\": 4263\n }\n}",
"description": "python3 /task/evaluate_public.py /app/solution/production_validation.parquet",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:12:19.782Z",
"content": "\nOutput: {\n \"model\": \"/app/solution/production_validation.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.02128,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 1671\n",
"isError": false
},
"responseMessageId": "f5dd0023-3507-409c-bcc9-e7d49cfd7f2e"
}
]
},
{
"id": 19,
"role": "agent",
"timestamp": "2026-09-29T02:12:25.371Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:12:25.371Z",
"text": "Analyzing Performance Data\n\nMy current focus is on understanding the initial performance benchmark. I've noted the baseline quality score and the number of users evaluated. My next step is to integrate the time budget constraints into my planning to ensure efficient validation and a proper final refit."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:12:25.371Z",
"text": "Investigating Current Score\n\nI'm prioritizing understanding why the current score is 0.02128 by re-reading the problem description carefully. My immediate goal is to determine if a baseline test submission can be generated to ensure a valid submission is always on hand. I will also investigate the duration of the test stage."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:12:25.371Z",
"text": "Refining Negative Sampling\n\nI'm now digging into how negative examples are selected and utilized within the existing training objective. My aim is to pinpoint limitations in the current sampling strategy and enhance it while remaining within the CPU budget. I'll validate any changes using the public backtest."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:25.371Z",
"callId": "read_file__call_1692031",
"name": "read_file",
"input": {
"start_line": 530,
"end_line": 600,
"file_path": "/app/solution/train_current_model.py"
},
"recorded": {
"id": "read_file__call_1692031",
"name": "read_file",
"args": {
"start_line": 530,
"end_line": 600,
"file_path": "/app/solution/train_current_model.py"
},
"result": [
{
"functionResponse": {
"id": "read_file__call_1692031",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 530-600 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 601.\n\n--- FILE CONTENT (truncated) ---\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:25.375Z",
"resultDisplay": "Read lines 530-600 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:12:25.376Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 530-600 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 601.\n\n--- FILE CONTENT (truncated) ---\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)",
"isError": false
},
"responseMessageId": "c7b1c108-057c-4751-b4eb-ad54ecde8d8e"
}
]
},
{
"id": 20,
"role": "agent",
"timestamp": "2026-09-29T02:12:29.441Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:12:29.441Z",
"text": "Analyzing Code Block\n\nI'm currently examining line 590, specifically the `build_known_positive_filter` function. I'm focused on its role in packing a user's complete public-training positive-item set and how it utilizes `prepared` and `training_counts`."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:29.441Z",
"callId": "read_file__call_5206129",
"name": "read_file",
"input": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 750,
"start_line": 601
},
"recorded": {
"id": "read_file__call_5206129",
"name": "read_file",
"args": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 750,
"start_line": 601
},
"result": [
{
"functionResponse": {
"id": "read_file__call_5206129",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 601-750 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 751.\n\n--- FILE CONTENT (truncated) ---\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives("
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:29.447Z",
"resultDisplay": "Read lines 601-750 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:12:29.448Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 601-750 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 751.\n\n--- FILE CONTENT (truncated) ---\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(",
"isError": false
},
"responseMessageId": "4a873cc3-aec8-425e-a277-6a26e4ace127"
}
]
},
{
"id": 21,
"role": "agent",
"timestamp": "2026-09-29T02:12:34.621Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:12:34.621Z",
"text": "Analyzing Code Snippets\n\nI'm currently scrutinizing lines 587-596. My focus is on understanding the `build_known_positive_filter` function and its role in packing each user's public-training positive-item set. This involves a close examination of the `prepared` sequence data and `training_counts` array."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:34.621Z",
"callId": "read_file__call_101772",
"name": "read_file",
"input": {
"start_line": 820,
"file_path": "/app/solution/train_current_model.py",
"end_line": 950
},
"recorded": {
"id": "read_file__call_101772",
"name": "read_file",
"args": {
"start_line": 820,
"file_path": "/app/solution/train_current_model.py",
"end_line": 950
},
"result": [
{
"functionResponse": {
"id": "read_file__call_101772",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 820-950 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 951.\n\n--- FILE CONTENT (truncated) ---\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\""
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:34.626Z",
"resultDisplay": "Read lines 820-950 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:12:34.627Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 820-950 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 951.\n\n--- FILE CONTENT (truncated) ---\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"",
"isError": false
},
"responseMessageId": "057542d5-ae15-4e58-9781-cc1bd12c0ee5"
}
]
},
{
"id": 22,
"role": "agent",
"timestamp": "2026-09-29T02:12:36.361Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:36.361Z",
"callId": "read_file__call_41256",
"name": "read_file",
"input": {
"end_line": 1150,
"file_path": "/app/solution/train_current_model.py",
"start_line": 951
},
"recorded": {
"id": "read_file__call_41256",
"name": "read_file",
"args": {
"end_line": 1150,
"file_path": "/app/solution/train_current_model.py",
"start_line": 951
},
"result": [
{
"functionResponse": {
"id": "read_file__call_41256",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 951-1150 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1151.\n\n--- FILE CONTENT (truncated) ---\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:36.367Z",
"resultDisplay": "Read lines 951-1150 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:12:36.367Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 951-1150 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1151.\n\n--- FILE CONTENT (truncated) ---\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]",
"isError": false
},
"responseMessageId": "049ecf47-5221-47c2-8f8b-153761062406"
}
]
},
{
"id": 23,
"role": "agent",
"timestamp": "2026-09-29T02:12:40.454Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:40.454Z",
"callId": "read_file__call_3841117",
"name": "read_file",
"input": {
"file_path": "/app/solution/train_current_model.py",
"start_line": 1151,
"end_line": 1350
},
"recorded": {
"id": "read_file__call_3841117",
"name": "read_file",
"args": {
"file_path": "/app/solution/train_current_model.py",
"start_line": 1151,
"end_line": 1350
},
"result": [
{
"functionResponse": {
"id": "read_file__call_3841117",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1151-1350 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1351.\n\n--- FILE CONTENT (truncated) ---\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:40.461Z",
"resultDisplay": "Read lines 1151-1350 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:12:40.462Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1151-1350 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1351.\n\n--- FILE CONTENT (truncated) ---\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),",
"isError": false
},
"responseMessageId": "2a6fe1ba-5bf9-48ef-b1b9-2ace4156cb1c"
}
]
},
{
"id": 24,
"role": "agent",
"timestamp": "2026-09-29T02:12:42.254Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:42.254Z",
"callId": "read_file__call_2207407",
"name": "read_file",
"input": {
"end_line": 80,
"file_path": "/app/solution/train_current_model.py",
"start_line": 40
},
"recorded": {
"id": "read_file__call_2207407",
"name": "read_file",
"args": {
"end_line": 80,
"file_path": "/app/solution/train_current_model.py",
"start_line": 40
},
"result": [
{
"functionResponse": {
"id": "read_file__call_2207407",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 40-80 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 81.\n\n--- FILE CONTENT (truncated) ---\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"organic-strong\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:42.260Z",
"resultDisplay": "Read lines 40-80 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:12:42.261Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 40-80 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 81.\n\n--- FILE CONTENT (truncated) ---\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"organic-strong\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n",
"isError": false
},
"responseMessageId": "225eaef2-772b-46bd-8d41-46c152d0c094"
}
]
},
{
"id": 25,
"role": "agent",
"timestamp": "2026-09-29T02:12:44.286Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:44.286Z",
"callId": "read_file__call_11589",
"name": "read_file",
"input": {
"end_line": 2050,
"start_line": 1920,
"file_path": "/app/solution/train_current_model.py"
},
"recorded": {
"id": "read_file__call_11589",
"name": "read_file",
"args": {
"end_line": 2050,
"start_line": 1920,
"file_path": "/app/solution/train_current_model.py"
},
"result": [
{
"functionResponse": {
"id": "read_file__call_11589",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1920-2050 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 2051.\n\n--- FILE CONTENT (truncated) ---\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:44.291Z",
"resultDisplay": "Read lines 1920-2050 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:12:44.291Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1920-2050 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 2051.\n\n--- FILE CONTENT (truncated) ---\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)",
"isError": false
},
"responseMessageId": "5199c718-a087-4f24-94ff-debaf680a7fa"
}
]
},
{
"id": 26,
"role": "agent",
"timestamp": "2026-09-29T02:12:46.098Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:46.098Z",
"callId": "read_file__call_83304",
"name": "read_file",
"input": {
"end_line": 2165,
"file_path": "/app/solution/train_current_model.py",
"start_line": 2051
},
"recorded": {
"id": "read_file__call_83304",
"name": "read_file",
"args": {
"end_line": 2165,
"file_path": "/app/solution/train_current_model.py",
"start_line": 2051
},
"result": [
{
"functionResponse": {
"id": "read_file__call_83304",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 2051-2165 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 2166.\n\n--- FILE CONTENT (truncated) ---\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:46.102Z",
"resultDisplay": "Read lines 2051-2165 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:12:46.103Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 2051-2165 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 2166.\n\n--- FILE CONTENT (truncated) ---\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"isError": false
},
"responseMessageId": "c46144e4-48bf-45ed-a3da-7317cda1e9eb"
}
]
},
{
"id": 27,
"role": "agent",
"timestamp": "2026-09-29T02:12:48.167Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:48.167Z",
"callId": "read_file__call_127261",
"name": "read_file",
"input": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 535,
"start_line": 470
},
"recorded": {
"id": "read_file__call_127261",
"name": "read_file",
"args": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 535,
"start_line": 470
},
"result": [
{
"functionResponse": {
"id": "read_file__call_127261",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 470-535 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 536.\n\n--- FILE CONTENT (truncated) ---\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:48.172Z",
"resultDisplay": "Read lines 470-535 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:12:48.173Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 470-535 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 536.\n\n--- FILE CONTENT (truncated) ---\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,",
"isError": false
},
"responseMessageId": "49599f24-46cc-4bb3-b922-2b6f5d6d0b83"
}
]
},
{
"id": 28,
"role": "agent",
"timestamp": "2026-09-29T02:12:51.556Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:12:51.556Z",
"text": "Optimizing Data Preparation\n\nI've observed that the data preparation step, specifically `prepare_data`, is consuming around 45 seconds during the validation phase. My current thinking is to leverage a `--prepared-cache` to store this prepared data, thereby significantly reducing subsequent run times. I'm also considering the implications of this caching for the submission stage where both training and validation data are combined."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:51.556Z",
"callId": "read_file__call_2081385",
"name": "read_file",
"input": {
"end_line": 470,
"start_line": 340,
"file_path": "/app/solution/train_current_model.py"
},
"recorded": {
"id": "read_file__call_2081385",
"name": "read_file",
"args": {
"end_line": 470,
"start_line": 340,
"file_path": "/app/solution/train_current_model.py"
},
"result": [
{
"functionResponse": {
"id": "read_file__call_2081385",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 340-470 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 471.\n\n--- FILE CONTENT (truncated) ---\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:51.561Z",
"resultDisplay": "Read lines 340-470 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:12:51.562Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 340-470 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 471.\n\n--- FILE CONTENT (truncated) ---\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n",
"isError": false
},
"responseMessageId": "f349c9fc-d2f7-4cd1-ba91-3976fe4ce5b5"
}
]
},
{
"id": 29,
"role": "agent",
"timestamp": "2026-09-29T02:12:53.874Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:12:53.874Z",
"text": "Preparing Data Efficiently\n\nI'm focusing on optimizing data preparation by leveraging a deterministic cache. This should significantly speed up validation experiments by avoiding repeated parsing of parquet files, allowing for near-instantaneous loading from the cache."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:53.874Z",
"callId": "run_shell_command__call_5755490",
"name": "run_shell_command",
"input": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --prepare-only",
"description": "Generate validation sequence data cache"
},
"recorded": {
"id": "run_shell_command__call_5755490",
"name": "run_shell_command",
"args": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --prepare-only",
"description": "Generate validation sequence data cache"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5755490",
"name": "run_shell_command",
"response": {
"output": "\nOutput: usage: train_current_model.py [-h] [--stage {validation,submission}] --output\n OUTPUT --public-dir PUBLIC_DIR\n [--prepared-cache PREPARED_CACHE]\n [--device {cpu,mps}] [--threads THREADS]\n [--bptt-steps BPTT_STEPS]\n [--user-batch-size USER_BATCH_SIZE]\n [--epochs EPOCHS]\n [--learning-rate LEARNING_RATE]\n [--loss-microbatch-size LOSS_MICROBATCH_SIZE]\n [--negative-filter-scope {full-training-history,last-100}]\n [--target-weighting {discovery-graded,organic-strong,uniform}]\n [--ordinary-target-weight ORDINARY_TARGET_WEIGHT]\n [--organic-strong-target-weight ORGANIC_STRONG_TARGET_WEIGHT]\n [--organic-like-target-weight ORGANIC_LIKE_TARGET_WEIGHT]\n [--discovery-horizon-days DISCOVERY_HORIZON_DAYS]\n [--validation-fraction VALIDATION_FRACTION]\n [--max-train-targets-per-user MAX_TRAIN_TARGETS_PER_USER]\n [--max-validation-targets-per-user MAX_VALIDATION_TARGETS_PER_USER]\n [--early-stopping-patience EARLY_STOPPING_PATIENCE]\n [--early-stopping-min-delta EARLY_STOPPING_MIN_DELTA]\n [--checkpoint-dir CHECKPOINT_DIR]\n [--resume-checkpoint RESUME_CHECKPOINT]\n [--seed SEED]\n [--ranking-batch-size RANKING_BATCH_SIZE]\n [--prepare-only]\ntrain_current_model.py: error: the following arguments are required: --output\nExit Code: 2\nProcess Group PGID: 1691\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:12:57.819Z",
"resultDisplay": "usage: train_current_model.py [-h] [--stage {validation,submission}] --output\n OUTPUT --public-dir PUBLIC_DIR\n [--prepared-cache PREPARED_CACHE]\n [--device {cpu,mps}] [--threads THREADS]\n [--bptt-steps BPTT_STEPS]\n [--user-batch-size USER_BATCH_SIZE]\n [--epochs EPOCHS]\n [--learning-rate LEARNING_RATE]\n [--loss-microbatch-size LOSS_MICROBATCH_SIZE]\n [--negative-filter-scope {full-training-history,last-100}]\n [--target-weighting {discovery-graded,organic-strong,uniform}]\n [--ordinary-target-weight ORDINARY_TARGET_WEIGHT]\n [--organic-strong-target-weight ORGANIC_STRONG_TARGET_WEIGHT]\n [--organic-like-target-weight ORGANIC_LIKE_TARGET_WEIGHT]\n [--discovery-horizon-days DISCOVERY_HORIZON_DAYS]\n [--validation-fraction VALIDATION_FRACTION]\n [--max-train-targets-per-user MAX_TRAIN_TARGETS_PER_USER]\n [--max-validation-targets-per-user MAX_VALIDATION_TARGETS_PER_USER]\n [--early-stopping-patience EARLY_STOPPING_PATIENCE]\n [--early-stopping-min-delta EARLY_STOPPING_MIN_DELTA]\n [--checkpoint-dir CHECKPOINT_DIR]\n [--resume-checkpoint RESUME_CHECKPOINT]\n [--seed SEED]\n [--ranking-batch-size RANKING_BATCH_SIZE]\n [--prepare-only]\ntrain_current_model.py: error: the following arguments are required: --output",
"description": "Generate validation sequence data cache",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:12:57.820Z",
"content": "\nOutput: usage: train_current_model.py [-h] [--stage {validation,submission}] --output\n OUTPUT --public-dir PUBLIC_DIR\n [--prepared-cache PREPARED_CACHE]\n [--device {cpu,mps}] [--threads THREADS]\n [--bptt-steps BPTT_STEPS]\n [--user-batch-size USER_BATCH_SIZE]\n [--epochs EPOCHS]\n [--learning-rate LEARNING_RATE]\n [--loss-microbatch-size LOSS_MICROBATCH_SIZE]\n [--negative-filter-scope {full-training-history,last-100}]\n [--target-weighting {discovery-graded,organic-strong,uniform}]\n [--ordinary-target-weight ORDINARY_TARGET_WEIGHT]\n [--organic-strong-target-weight ORGANIC_STRONG_TARGET_WEIGHT]\n [--organic-like-target-weight ORGANIC_LIKE_TARGET_WEIGHT]\n [--discovery-horizon-days DISCOVERY_HORIZON_DAYS]\n [--validation-fraction VALIDATION_FRACTION]\n [--max-train-targets-per-user MAX_TRAIN_TARGETS_PER_USER]\n [--max-validation-targets-per-user MAX_VALIDATION_TARGETS_PER_USER]\n [--early-stopping-patience EARLY_STOPPING_PATIENCE]\n [--early-stopping-min-delta EARLY_STOPPING_MIN_DELTA]\n [--checkpoint-dir CHECKPOINT_DIR]\n [--resume-checkpoint RESUME_CHECKPOINT]\n [--seed SEED]\n [--ranking-batch-size RANKING_BATCH_SIZE]\n [--prepare-only]\ntrain_current_model.py: error: the following arguments are required: --output\nExit Code: 2\nProcess Group PGID: 1691\n",
"isError": false
},
"responseMessageId": "b557af82-9c80-4a72-8a97-f0d7492b9a59"
}
]
},
{
"id": 30,
"role": "agent",
"timestamp": "2026-09-29T02:12:59.921Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:12:59.921Z",
"callId": "run_shell_command__call_5880451",
"name": "run_shell_command",
"input": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --output /app/solution/dummy.parquet \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --prepare-only",
"description": "Build validation cache"
},
"recorded": {
"id": "run_shell_command__call_5880451",
"name": "run_shell_command",
"args": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --output /app/solution/dummy.parquet \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --prepare-only",
"description": "Build validation cache"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5880451",
"name": "run_shell_command",
"response": {
"output": "\nOutput: loaded explicit events: rows=720,270 users=8,220\nprepared users=1,000 tokens=2,090,746 states=35,727 elapsed=4.8s\nprepared users=2,000 tokens=4,301,266 states=71,242 elapsed=9.9s\nprepared users=3,000 tokens=6,486,146 states=109,471 elapsed=15.1s\nprepared users=4,000 tokens=8,793,043 states=148,210 elapsed=20.5s\nprepared users=5,000 tokens=10,992,205 states=182,596 elapsed=25.4s\nprepared users=6,000 tokens=13,061,727 states=217,148 elapsed=30.2s\nprepared users=7,000 tokens=15,334,418 states=256,914 elapsed=35.7s\nprepared users=8,000 tokens=17,462,672 states=296,703 elapsed=41.0s\nprepared users=9,000 tokens=19,568,405 states=331,551 elapsed=45.7s\ntarget users without qualifying catalog sequence=7\nprepared stage=validation sequence_users=9,135 tokens=20,056,329 next_item_targets=20,047,194 states=339,133\nsaved public-derived full-sequence cache: /app/solution/validation_cache.npz\n{\n \"stage\": \"validation\",\n \"sequence_users\": 9135,\n \"sequence_tokens\": 20056329,\n \"next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"target_users\": 8456,\n \"runtime_seconds\": 50.886,\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n }\n}\nProcess Group PGID: 1702\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:13:54.852Z",
"resultDisplay": "loaded explicit events: rows=720,270 users=8,220\nprepared users=1,000 tokens=2,090,746 states=35,727 elapsed=4.8s\nprepared users=2,000 tokens=4,301,266 states=71,242 elapsed=9.9s\nprepared users=3,000 tokens=6,486,146 states=109,471 elapsed=15.1s\nprepared users=4,000 tokens=8,793,043 states=148,210 elapsed=20.5s\nprepared users=5,000 tokens=10,992,205 states=182,596 elapsed=25.4s\nprepared users=6,000 tokens=13,061,727 states=217,148 elapsed=30.2s\nprepared users=7,000 tokens=15,334,418 states=256,914 elapsed=35.7s\nprepared users=8,000 tokens=17,462,672 states=296,703 elapsed=41.0s\nprepared users=9,000 tokens=19,568,405 states=331,551 elapsed=45.7s\ntarget users without qualifying catalog sequence=7\nprepared stage=validation sequence_users=9,135 tokens=20,056,329 next_item_targets=20,047,194 states=339,133\nsaved public-derived full-sequence cache: /app/solution/validation_cache.npz\n{\n \"stage\": \"validation\",\n \"sequence_users\": 9135,\n \"sequence_tokens\": 20056329,\n \"next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"target_users\": 8456,\n \"runtime_seconds\": 50.886,\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n }\n}",
"description": "Build validation cache",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:13:54.853Z",
"content": "\nOutput: loaded explicit events: rows=720,270 users=8,220\nprepared users=1,000 tokens=2,090,746 states=35,727 elapsed=4.8s\nprepared users=2,000 tokens=4,301,266 states=71,242 elapsed=9.9s\nprepared users=3,000 tokens=6,486,146 states=109,471 elapsed=15.1s\nprepared users=4,000 tokens=8,793,043 states=148,210 elapsed=20.5s\nprepared users=5,000 tokens=10,992,205 states=182,596 elapsed=25.4s\nprepared users=6,000 tokens=13,061,727 states=217,148 elapsed=30.2s\nprepared users=7,000 tokens=15,334,418 states=256,914 elapsed=35.7s\nprepared users=8,000 tokens=17,462,672 states=296,703 elapsed=41.0s\nprepared users=9,000 tokens=19,568,405 states=331,551 elapsed=45.7s\ntarget users without qualifying catalog sequence=7\nprepared stage=validation sequence_users=9,135 tokens=20,056,329 next_item_targets=20,047,194 states=339,133\nsaved public-derived full-sequence cache: /app/solution/validation_cache.npz\n{\n \"stage\": \"validation\",\n \"sequence_users\": 9135,\n \"sequence_tokens\": 20056329,\n \"next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"target_users\": 8456,\n \"runtime_seconds\": 50.886,\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n }\n}\nProcess Group PGID: 1702\n",
"isError": false
},
"responseMessageId": "baf5a533-0cb3-4258-828f-7f6815113fdb"
}
]
},
{
"id": 31,
"role": "agent",
"timestamp": "2026-09-29T02:13:59.362Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:13:59.362Z",
"text": "Investigating Optimization Strategy\n\nMy focus has shifted to optimizing our approach. With efficient data loading now secured via the validation cache, I'm eager to delve into the intricacies of negative sampling and the loss function. This next phase is critical for refining our strategic intent."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:13:59.362Z",
"callId": "update_topic__call_5226464",
"name": "update_topic",
"input": {
"strategic_intent": "Analyze the negative sampling strategy, loss function, and objective alignment to diagnose the retrieval quality bottleneck.",
"summary": "We verified the baseline score (NDCG@10 = 0.02128) and created a prepared sequence cache for fast iteration. Now we will analyze the current training objective, negative sampling strategy, and evaluation metric alignment.",
"title": "Diagnosing Negative Sampling and Training Objective"
},
"recorded": {
"id": "update_topic__call_5226464",
"name": "update_topic",
"args": {
"strategic_intent": "Analyze the negative sampling strategy, loss function, and objective alignment to diagnose the retrieval quality bottleneck.",
"summary": "We verified the baseline score (NDCG@10 = 0.02128) and created a prepared sequence cache for fast iteration. Now we will analyze the current training objective, negative sampling strategy, and evaluation metric alignment.",
"title": "Diagnosing Negative Sampling and Training Objective"
},
"result": [
{
"functionResponse": {
"id": "update_topic__call_5226464",
"name": "update_topic",
"response": {
"output": "Current topic: \"Diagnosing Negative Sampling and Training Objective\"\nTopic summary: We verified the baseline score (NDCG@10 = 0.02128) and created a prepared sequence cache for fast iteration. Now we will analyze the current training objective, negative sampling strategy, and evaluation metric alignment.\n\nStrategic Intent: Analyze the negative sampling strategy, loss function, and objective alignment to diagnose the retrieval quality bottleneck."
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:13:59.364Z",
"resultDisplay": "## 📂 Topic: **Diagnosing Negative Sampling and Training Objective**\n\n**Summary:**\nWe verified the baseline score (NDCG@10 = 0.02128) and created a prepared sequence cache for fast iteration. Now we will analyze the current training objective, negative sampling strategy, and evaluation metric alignment.\n\n> [!STRATEGY]\n> **Intent:** Analyze the negative sampling strategy, loss function, and objective alignment to diagnose the retrieval quality bottleneck.",
"description": "Update topic to: \"Diagnosing Negative Sampling and Training Objective\"",
"displayName": "Update Topic Context",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:14:01.676Z",
"content": "Current topic: \"Diagnosing Negative Sampling and Training Objective\"\nTopic summary: We verified the baseline score (NDCG@10 = 0.02128) and created a prepared sequence cache for fast iteration. Now we will analyze the current training objective, negative sampling strategy, and evaluation metric alignment.\n\nStrategic Intent: Analyze the negative sampling strategy, loss function, and objective alignment to diagnose the retrieval quality bottleneck.",
"isError": false
},
"responseMessageId": "e13664a3-6e23-4271-8585-bcae52fee12c"
}
]
},
{
"id": 32,
"role": "agent",
"timestamp": "2026-09-29T02:14:07.305Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:07.305Z",
"text": "Investigating Sampling Strategies\n\nMy focus is now on dissecting how this mature baseline trainer, with its inherent internal validation, selects and utilizes negative examples. I aim to pinpoint any limitations within its current negative-sampling methodology to improve its effectiveness."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:14:07.305Z",
"callId": "run_shell_command__call_5881307",
"name": "run_shell_command",
"input": {
"command": "head -n 80 /task/ranking_evaluation.py",
"description": "Inspect ranking_evaluation.py"
},
"recorded": {
"id": "run_shell_command__call_5881307",
"name": "run_shell_command",
"args": {
"command": "head -n 80 /task/ranking_evaluation.py",
"description": "Inspect ranking_evaluation.py"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5881307",
"name": "run_shell_command",
"response": {
"output": "\nOutput: \"\"\"Shared public primitives for Yambda discovery-ranking evaluation.\n\nBoth the solver-visible validation evaluator and the private submission judge\nimport this module from the generated task's ``public`` directory. It owns the\nstage-independent contract: reading a ranking, validating its shape, converting\nit to per-user rank order, looking up packed candidate eligibility, and\ncomputing graded NDCG@10.\n\nThe module deliberately contains no event-derived labels, private artifact\npaths, or pass thresholds. Each evaluator supplies its own relevance data and\nper-cutoff eligibility checks around these common operations.\n\"\"\"\nfrom __future__ import annotations\n\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\n\n\n__all__ = [\n \"CandidateSet\",\n \"QUALITY_K\",\n \"RankingValidationError\",\n \"REQUIRED_COLUMNS\",\n \"TOP_N\",\n \"ndcg_at_k\",\n \"ranked_items\",\n \"read_ranking\",\n \"score_rankings\",\n \"validate_ranking\",\n]\n\nTOP_N = 100\nQUALITY_K = 10\nREQUIRED_COLUMNS = (\"uid\", \"item_id\", \"rank\")\n\n\nclass RankingValidationError(ValueError):\n \"\"\"Report a ranking-schema or structural-contract violation.\"\"\"\n\n\nclass CandidateSet:\n \"\"\"Provide membership lookups over one packed candidate-set archive.\n\n The archive contains aligned ``uids``, ``item_ids``, and\n ``packed_eligible`` arrays. Candidate column ``c`` is represented by bit\n ``c % 8`` of byte ``c // 8`` using little-endian bit order. Arrays are\n copied into memory so they remain valid after the archive is closed.\n \"\"\"\n\n def __init__(self, path: Path):\n \"\"\"Load an eligibility archive and build ID-to-position indexes.\n\n Args:\n path: Path to a ``.npz`` archive with the candidate-set schema.\n \"\"\"\n with np.load(path, allow_pickle=False) as artifact:\n self.uids = artifact[\"uids\"].astype(np.int64, copy=True)\n self.item_ids = artifact[\"item_ids\"].astype(np.int64, copy=True)\n self.packed = artifact[\"packed_eligible\"].astype(np.uint8, copy=True)\n self.uid_row = {int(uid): row for row, uid in enumerate(self.uids)}\n self.item_column = {\n int(item): column for column, item in enumerate(self.item_ids)\n }\n\n def is_eligible(self, uid: int, item_id: int) -> bool:\n \"\"\"Return whether ``item_id`` is eligible for ``uid``.\n\n IDs absent from the target-user or candidate-item arrays are treated as\n ineligible rather than raising an exception.\n\n Args:\n uid: Target user ID to query.\n item_id: Candidate item ID to query.\n\n Returns:\n ``True`` only when the corresponding packed eligibility bit is set.\n \"\"\"\n row = self.uid_row.get(int(uid))\nProcess Group PGID: 1726\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:14:07.319Z",
"resultDisplay": "\"\"\"Shared public primitives for Yambda discovery-ranking evaluation.\n\nBoth the solver-visible validation evaluator and the private submission judge\nimport this module from the generated task's ``public`` directory. It owns the\nstage-independent contract: reading a ranking, validating its shape, converting\nit to per-user rank order, looking up packed candidate eligibility, and\ncomputing graded NDCG@10.\n\nThe module deliberately contains no event-derived labels, private artifact\npaths, or pass thresholds. Each evaluator supplies its own relevance data and\nper-cutoff eligibility checks around these common operations.\n\"\"\"\nfrom __future__ import annotations\n\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\n\n\n__all__ = [\n \"CandidateSet\",\n \"QUALITY_K\",\n \"RankingValidationError\",\n \"REQUIRED_COLUMNS\",\n \"TOP_N\",\n \"ndcg_at_k\",\n \"ranked_items\",\n \"read_ranking\",\n \"score_rankings\",\n \"validate_ranking\",\n]\n\nTOP_N = 100\nQUALITY_K = 10\nREQUIRED_COLUMNS = (\"uid\", \"item_id\", \"rank\")\n\n\nclass RankingValidationError(ValueError):\n \"\"\"Report a ranking-schema or structural-contract violation.\"\"\"\n\n\nclass CandidateSet:\n \"\"\"Provide membership lookups over one packed candidate-set archive.\n\n The archive contains aligned ``uids``, ``item_ids``, and\n ``packed_eligible`` arrays. Candidate column ``c`` is represented by bit\n ``c % 8`` of byte ``c // 8`` using little-endian bit order. Arrays are\n copied into memory so they remain valid after the archive is closed.\n \"\"\"\n\n def __init__(self, path: Path):\n \"\"\"Load an eligibility archive and build ID-to-position indexes.\n\n Args:\n path: Path to a ``.npz`` archive with the candidate-set schema.\n \"\"\"\n with np.load(path, allow_pickle=False) as artifact:\n self.uids = artifact[\"uids\"].astype(np.int64, copy=True)\n self.item_ids = artifact[\"item_ids\"].astype(np.int64, copy=True)\n self.packed = artifact[\"packed_eligible\"].astype(np.uint8, copy=True)\n self.uid_row = {int(uid): row for row, uid in enumerate(self.uids)}\n self.item_column = {\n int(item): column for column, item in enumerate(self.item_ids)\n }\n\n def is_eligible(self, uid: int, item_id: int) -> bool:\n \"\"\"Return whether ``item_id`` is eligible for ``uid``.\n\n IDs absent from the target-user or candidate-item arrays are treated as\n ineligible rather than raising an exception.\n\n Args:\n uid: Target user ID to query.\n item_id: Candidate item ID to query.\n\n Returns:\n ``True`` only when the corresponding packed eligibility bit is set.\n \"\"\"\n row = self.uid_row.get(int(uid))",
"description": "head -n 80 /task/ranking_evaluation.py",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:14:07.320Z",
"content": "\nOutput: \"\"\"Shared public primitives for Yambda discovery-ranking evaluation.\n\nBoth the solver-visible validation evaluator and the private submission judge\nimport this module from the generated task's ``public`` directory. It owns the\nstage-independent contract: reading a ranking, validating its shape, converting\nit to per-user rank order, looking up packed candidate eligibility, and\ncomputing graded NDCG@10.\n\nThe module deliberately contains no event-derived labels, private artifact\npaths, or pass thresholds. Each evaluator supplies its own relevance data and\nper-cutoff eligibility checks around these common operations.\n\"\"\"\nfrom __future__ import annotations\n\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\n\n\n__all__ = [\n \"CandidateSet\",\n \"QUALITY_K\",\n \"RankingValidationError\",\n \"REQUIRED_COLUMNS\",\n \"TOP_N\",\n \"ndcg_at_k\",\n \"ranked_items\",\n \"read_ranking\",\n \"score_rankings\",\n \"validate_ranking\",\n]\n\nTOP_N = 100\nQUALITY_K = 10\nREQUIRED_COLUMNS = (\"uid\", \"item_id\", \"rank\")\n\n\nclass RankingValidationError(ValueError):\n \"\"\"Report a ranking-schema or structural-contract violation.\"\"\"\n\n\nclass CandidateSet:\n \"\"\"Provide membership lookups over one packed candidate-set archive.\n\n The archive contains aligned ``uids``, ``item_ids``, and\n ``packed_eligible`` arrays. Candidate column ``c`` is represented by bit\n ``c % 8`` of byte ``c // 8`` using little-endian bit order. Arrays are\n copied into memory so they remain valid after the archive is closed.\n \"\"\"\n\n def __init__(self, path: Path):\n \"\"\"Load an eligibility archive and build ID-to-position indexes.\n\n Args:\n path: Path to a ``.npz`` archive with the candidate-set schema.\n \"\"\"\n with np.load(path, allow_pickle=False) as artifact:\n self.uids = artifact[\"uids\"].astype(np.int64, copy=True)\n self.item_ids = artifact[\"item_ids\"].astype(np.int64, copy=True)\n self.packed = artifact[\"packed_eligible\"].astype(np.uint8, copy=True)\n self.uid_row = {int(uid): row for row, uid in enumerate(self.uids)}\n self.item_column = {\n int(item): column for column, item in enumerate(self.item_ids)\n }\n\n def is_eligible(self, uid: int, item_id: int) -> bool:\n \"\"\"Return whether ``item_id`` is eligible for ``uid``.\n\n IDs absent from the target-user or candidate-item arrays are treated as\n ineligible rather than raising an exception.\n\n Args:\n uid: Target user ID to query.\n item_id: Candidate item ID to query.\n\n Returns:\n ``True`` only when the corresponding packed eligibility bit is set.\n \"\"\"\n row = self.uid_row.get(int(uid))\nProcess Group PGID: 1726\n",
"isError": false
},
"responseMessageId": "c667d677-4c45-4978-a135-cb1bef3beb26"
}
]
},
{
"id": 33,
"role": "agent",
"timestamp": "2026-09-29T02:14:09.488Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:14:09.488Z",
"callId": "run_shell_command__call_3543138",
"name": "run_shell_command",
"input": {
"description": "Inspect evaluate_public.py scoring details",
"command": "tail -n 80 /task/evaluate_public.py"
},
"recorded": {
"id": "run_shell_command__call_3543138",
"name": "run_shell_command",
"args": {
"description": "Inspect evaluate_public.py scoring details",
"command": "tail -n 80 /task/evaluate_public.py"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_3543138",
"name": "run_shell_command",
"response": {
"output": "\nOutput: ][[\"uid\", \"item_id\"]].drop_duplicates()\n\n graded: dict[int, dict[int, int]] = {}\n for raw_uid, raw_item in strong.itertuples(index=False, name=None):\n uid, item = int(raw_uid), int(raw_item)\n if eligibility.is_eligible(uid, item):\n graded.setdefault(uid, {})[item] = 1\n for raw_uid, raw_item in organic_likes.itertuples(index=False, name=None):\n uid, item = int(raw_uid), int(raw_item)\n if eligibility.is_eligible(uid, item):\n graded.setdefault(uid, {})[item] = 3\n return graded\n\n\ndef load_submission(\n path: Path, eligibility: CandidateSet, targets: set[int]\n) -> dict[int, list[int]]:\n \"\"\"Load and validate a public validation ranking.\n\n Files ending in ``.parquet`` are read as parquet; every other suffix is\n read as CSV. The required columns must be integer-valued, cover exactly the\n target-user set, contain 100 rows and ranks 1 through 100 per user, avoid\n duplicate user-item pairs, and contain only cutoff-eligible items.\n\n Args:\n path: Ranking file to read.\n eligibility: Validation-cutoff candidate membership service.\n targets: Exact set of users the ranking must cover.\n\n Returns:\n A ``uid -> ranked item IDs`` mapping ordered by ascending rank.\n\n Raises:\n ValueError: If the ranking violates the required schema or invariants.\n \"\"\"\n frame = validate_ranking(read_ranking(path), targets)\n if not all(\n eligibility.is_eligible(uid, item)\n for uid, item in frame[[\"uid\", \"item_id\"]].itertuples(index=False, name=None)\n ):\n raise RankingValidationError(\n \"submission contains an item rejected by eligibility service\"\n )\n return ranked_items(frame)\n\n\ndef score(\n ranked: dict[int, list[int]],\n graded: dict[int, dict[int, int]],\n) -> dict[str, float | int]:\n \"\"\"Aggregate per-user NDCG@10 over users with public relevance labels.\n\n Args:\n ranked: Ranked item IDs for every target user.\n graded: Eligible validation relevance keyed by user and item.\n\n Returns:\n The six-decimal ``quality_ndcg@10`` value and number of scored users.\n \"\"\"\n return score_rankings(ranked, graded)\n\n\ndef main() -> None:\n \"\"\"Run the public evaluator CLI and print its JSON score report.\"\"\"\n targets_frame = pd.read_parquet(DATA / \"target_users.parquet\")\n targets = set(targets_frame.uid.astype(int))\n eligibility = CandidateSet(DATA / \"validation_eligible_candidates.npz\")\n graded = validation_truth(eligibility, targets)\n\n if len(sys.argv) != 2:\n raise SystemExit(\n \"usage: evaluate_public.py \"\n )\n path = Path(sys.argv[1])\n ranked = load_submission(path, eligibility, targets)\n print(json.dumps({\"model\": str(path), \"scores\": score(ranked, graded)}, indent=2))\n\n\nif __name__ == \"__main__\":\n main()\nProcess Group PGID: 1729\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:14:09.501Z",
"resultDisplay": "][[\"uid\", \"item_id\"]].drop_duplicates()\n\n graded: dict[int, dict[int, int]] = {}\n for raw_uid, raw_item in strong.itertuples(index=False, name=None):\n uid, item = int(raw_uid), int(raw_item)\n if eligibility.is_eligible(uid, item):\n graded.setdefault(uid, {})[item] = 1\n for raw_uid, raw_item in organic_likes.itertuples(index=False, name=None):\n uid, item = int(raw_uid), int(raw_item)\n if eligibility.is_eligible(uid, item):\n graded.setdefault(uid, {})[item] = 3\n return graded\n\n\ndef load_submission(\n path: Path, eligibility: CandidateSet, targets: set[int]\n) -> dict[int, list[int]]:\n \"\"\"Load and validate a public validation ranking.\n\n Files ending in ``.parquet`` are read as parquet; every other suffix is\n read as CSV. The required columns must be integer-valued, cover exactly the\n target-user set, contain 100 rows and ranks 1 through 100 per user, avoid\n duplicate user-item pairs, and contain only cutoff-eligible items.\n\n Args:\n path: Ranking file to read.\n eligibility: Validation-cutoff candidate membership service.\n targets: Exact set of users the ranking must cover.\n\n Returns:\n A ``uid -> ranked item IDs`` mapping ordered by ascending rank.\n\n Raises:\n ValueError: If the ranking violates the required schema or invariants.\n \"\"\"\n frame = validate_ranking(read_ranking(path), targets)\n if not all(\n eligibility.is_eligible(uid, item)\n for uid, item in frame[[\"uid\", \"item_id\"]].itertuples(index=False, name=None)\n ):\n raise RankingValidationError(\n \"submission contains an item rejected by eligibility service\"\n )\n return ranked_items(frame)\n\n\ndef score(\n ranked: dict[int, list[int]],\n graded: dict[int, dict[int, int]],\n) -> dict[str, float | int]:\n \"\"\"Aggregate per-user NDCG@10 over users with public relevance labels.\n\n Args:\n ranked: Ranked item IDs for every target user.\n graded: Eligible validation relevance keyed by user and item.\n\n Returns:\n The six-decimal ``quality_ndcg@10`` value and number of scored users.\n \"\"\"\n return score_rankings(ranked, graded)\n\n\ndef main() -> None:\n \"\"\"Run the public evaluator CLI and print its JSON score report.\"\"\"\n targets_frame = pd.read_parquet(DATA / \"target_users.parquet\")\n targets = set(targets_frame.uid.astype(int))\n eligibility = CandidateSet(DATA / \"validation_eligible_candidates.npz\")\n graded = validation_truth(eligibility, targets)\n\n if len(sys.argv) != 2:\n raise SystemExit(\n \"usage: evaluate_public.py \"\n )\n path = Path(sys.argv[1])\n ranked = load_submission(path, eligibility, targets)\n print(json.dumps({\"model\": str(path), \"scores\": score(ranked, graded)}, indent=2))\n\n\nif __name__ == \"__main__\":\n main()",
"description": "tail -n 80 /task/evaluate_public.py",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:14:09.503Z",
"content": "\nOutput: ][[\"uid\", \"item_id\"]].drop_duplicates()\n\n graded: dict[int, dict[int, int]] = {}\n for raw_uid, raw_item in strong.itertuples(index=False, name=None):\n uid, item = int(raw_uid), int(raw_item)\n if eligibility.is_eligible(uid, item):\n graded.setdefault(uid, {})[item] = 1\n for raw_uid, raw_item in organic_likes.itertuples(index=False, name=None):\n uid, item = int(raw_uid), int(raw_item)\n if eligibility.is_eligible(uid, item):\n graded.setdefault(uid, {})[item] = 3\n return graded\n\n\ndef load_submission(\n path: Path, eligibility: CandidateSet, targets: set[int]\n) -> dict[int, list[int]]:\n \"\"\"Load and validate a public validation ranking.\n\n Files ending in ``.parquet`` are read as parquet; every other suffix is\n read as CSV. The required columns must be integer-valued, cover exactly the\n target-user set, contain 100 rows and ranks 1 through 100 per user, avoid\n duplicate user-item pairs, and contain only cutoff-eligible items.\n\n Args:\n path: Ranking file to read.\n eligibility: Validation-cutoff candidate membership service.\n targets: Exact set of users the ranking must cover.\n\n Returns:\n A ``uid -> ranked item IDs`` mapping ordered by ascending rank.\n\n Raises:\n ValueError: If the ranking violates the required schema or invariants.\n \"\"\"\n frame = validate_ranking(read_ranking(path), targets)\n if not all(\n eligibility.is_eligible(uid, item)\n for uid, item in frame[[\"uid\", \"item_id\"]].itertuples(index=False, name=None)\n ):\n raise RankingValidationError(\n \"submission contains an item rejected by eligibility service\"\n )\n return ranked_items(frame)\n\n\ndef score(\n ranked: dict[int, list[int]],\n graded: dict[int, dict[int, int]],\n) -> dict[str, float | int]:\n \"\"\"Aggregate per-user NDCG@10 over users with public relevance labels.\n\n Args:\n ranked: Ranked item IDs for every target user.\n graded: Eligible validation relevance keyed by user and item.\n\n Returns:\n The six-decimal ``quality_ndcg@10`` value and number of scored users.\n \"\"\"\n return score_rankings(ranked, graded)\n\n\ndef main() -> None:\n \"\"\"Run the public evaluator CLI and print its JSON score report.\"\"\"\n targets_frame = pd.read_parquet(DATA / \"target_users.parquet\")\n targets = set(targets_frame.uid.astype(int))\n eligibility = CandidateSet(DATA / \"validation_eligible_candidates.npz\")\n graded = validation_truth(eligibility, targets)\n\n if len(sys.argv) != 2:\n raise SystemExit(\n \"usage: evaluate_public.py \"\n )\n path = Path(sys.argv[1])\n ranked = load_submission(path, eligibility, targets)\n print(json.dumps({\"model\": str(path), \"scores\": score(ranked, graded)}, indent=2))\n\n\nif __name__ == \"__main__\":\n main()\nProcess Group PGID: 1729\n",
"isError": false
},
"responseMessageId": "dca586c7-fd74-4c61-acff-42da03d5409b"
}
]
},
{
"id": 34,
"role": "agent",
"timestamp": "2026-09-29T02:14:11.980Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:14:11.980Z",
"callId": "read_file__call_2815258",
"name": "read_file",
"input": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 1920,
"start_line": 1780
},
"recorded": {
"id": "read_file__call_2815258",
"name": "read_file",
"args": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 1920,
"start_line": 1780
},
"result": [
{
"functionResponse": {
"id": "read_file__call_2815258",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1780-1920 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1921.\n\n--- FILE CONTENT (truncated) ---\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:14:11.988Z",
"resultDisplay": "Read lines 1780-1920 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:14:11.989Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1780-1920 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1921.\n\n--- FILE CONTENT (truncated) ---\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n",
"isError": false
},
"responseMessageId": "98b02a58-e355-481f-83a0-a3411519ecc3"
}
]
},
{
"id": 35,
"role": "agent",
"timestamp": "2026-09-29T02:14:38.124Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Calculating Scores\n\nI've been focusing on the inference step, specifically how scores are computed. The process involves a matrix multiplication of queries and items, followed by masking out ineligible items with negative infinity. Finally, I extract the top-k indices from the resulting scores."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Verifying Score Calculations\n\nI've confirmed that raw dot products are indeed utilized for score calculations, aligning with both training and inference processes. My next step involves a deep dive into the training objective, negative sampling, loss function, and the intricacies of false-negative filtering.\n\n**Analyzing Loss Function**\n\nI am currently scrutinizing the `corrected_negative_loss` function. My focus is on understanding how it handles both uniform and in-batch negatives, particularly how the `correction` tensor is applied to adjust the logits."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Investigating Loss Formulation\n\nI'm re-examining the Binary Cross-Entropy loss formulation. It appears the implementation uses `softplus` for both positive and negative terms, and I'm digging into how it handles multiple negative samples, particularly with the `corrected_negative_loss` function."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Revising Loss Calculation\n\nI've discovered an averaging issue within the negative loss calculation. It appears the mean is being taken over negative samples rather than a sum, significantly impacting gradient ratios. This deviates from standard BCE and prompts further investigation into optimal loss functions for retrieval."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Questioning Loss Choice\n\nI'm questioning whether Binary Cross-Entropy is indeed the standard for modern two-tower retrieval models, considering alternatives like InfoNCE. I need to re-evaluate the prompt's constraints on the training objective to confirm flexibility."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Exploring Negative Sampling\n\nI am now focusing on the core of the problem: the training objective and its negative sampling strategy. My goal is to identify limitations within the current approach and devise improvements that fit within the CPU budget. I'll be validating these changes against the public backtest."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Investigating Negative Selection\n\nI'm now scrutinizing how negative examples are selected, specifically within `draw_full_history_filtered_neg`. My aim is to pinpoint any limitations in the current strategy and explore improvements that respect the CPU budget, keeping the upcoming public backtest validation in mind."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Refining Negative Sampling\n\nI'm now examining the specific implementations of negative sampling, focusing on `draw_full_history_filtered_negatives`. My goal is to analyze its current strategies and identify potential optimizations that align with CPU constraints for the upcoming backtest validation."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Revising Negative Sampling\n\nI'm now re-examining the negative sampling logic. I noticed an issue where `unique_targets` are filtered incorrectly. My focus is on ensuring all target IDs are properly accounted for and that the negative sampling strategy aligns with the overall objective."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Revising Filter Logic\n\nI'm now revisiting the `build_known_positive_filter` function to fully grasp its positive item filtering mechanism. My goal is to ensure its accuracy and completeness for subsequent negative sampling considerations."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Revising Target Partitioning\n\nI'm delving into the `chronological_target_partition` function. I've noted comments suggesting the absence of a chronological BCE suffix, which contradicts my understanding of the partitioning logic. I need to reconcile these observations and understand the implications for training data."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Clarifying Chronological Partitioning\n\nI'm analyzing the `chronological_target_partition` function, specifically the interaction between `totals`, `validation`, and `training` counts. I'm also looking into `build_dense_block` to understand how these counts translate to actual `positions` and `target_positions`."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Clarifying Filtering Logic\n\nI'm re-examining the `build_known_positive_filter` function. It appears to be filtering based on offset and counts, potentially including older, discarded sequence items rather than the actual positive targets from the current training window. This needs immediate correction to ensure accurate training data."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:38.124Z",
"text": "Correcting Filtering Logic\n\nI've identified a critical flaw in `build_known_positive_filter`. The current logic incorrectly assumes the training sequence spans `0` to `target_count + 1`, neglecting the actual sequence length. This is misinterpreting positive items, and I need to align it with the true user history range."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:14:38.124Z",
"callId": "read_file__call_599691",
"name": "read_file",
"input": {
"file_path": "/app/solution/train_current_model.py",
"start_line": 240,
"end_line": 320
},
"recorded": {
"id": "read_file__call_599691",
"name": "read_file",
"args": {
"file_path": "/app/solution/train_current_model.py",
"start_line": 240,
"end_line": 320
},
"result": [
{
"functionResponse": {
"id": "read_file__call_599691",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 240-320 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 321.\n\n--- FILE CONTENT (truncated) ---\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:14:38.129Z",
"resultDisplay": "Read lines 240-320 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:14:38.131Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 240-320 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 321.\n\n--- FILE CONTENT (truncated) ---\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,",
"isError": false
},
"responseMessageId": "e4616893-95cd-4372-8864-a1d297fff0f4"
}
]
},
{
"id": 36,
"role": "agent",
"timestamp": "2026-09-29T02:14:50.187Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:50.187Z",
"text": "Refining Sequence Generation\n\nI'm focusing on refining the sequence generation logic within `build_sequence_parts`. Specifically, I'm ensuring that the `qualifying` boolean mask correctly isolates all positive listens, identified by `completion_pct` meeting or exceeding `base.LISTEN_POSITIVE_THRESHOLD`. This filtered subset of listens will form the basis of our user sequences."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:50.187Z",
"text": "Analyzing Partitioning Strategy\n\nI'm currently examining the `target_partition` function and its impact on data splitting. The logic for calculating `validation` and `training` portions, especially with large `items` lengths and the `max_train_targets_per_user` constraint, is a key focus. I'm also reviewing how `build_dense_block` uses these calculated windows and offsets for feature extraction."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:50.187Z",
"text": "Confirming Training Data Boundaries\n\nI've confirmed that the model is trained on the last `max_train_targets_per_user` targets immediately preceding the validation set. This is achieved by calculating the training data range from `offset + window_start + 1` up to `offset + window_start + count + 1`, where `window_start` is derived from `training_region_ends - training`."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:50.187Z",
"text": "Revising Negative Sampling Logic\n\nI'm thoroughly re-examining the negative sampling process, particularly how it interacts with the training and validation boundaries. It appears the current filtering logic for known positives is only considering a very limited initial segment of user history, potentially missing crucial interactions that should be excluded from negative sampling in later parts of the sequence. This needs immediate correction to ensure accurate model training."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:14:50.187Z",
"text": "Fixing Negative Sampling Flaws\n\nI'm correcting a critical flaw where negative sampling was improperly excluding recently interacted items as potential negatives. This oversight was incorrectly penalizing the model for items the user actually liked. I'm now ensuring that all known positives, both historical and recent, are accurately excluded from negative candidate pools."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:14:50.187Z",
"callId": "grep_search__call_535894",
"name": "grep_search",
"input": {
"pattern": "build_known_positive_filter",
"dir_path": "/app/solution"
},
"recorded": {
"id": "grep_search__call_535894",
"name": "grep_search",
"args": {
"pattern": "build_known_positive_filter",
"dir_path": "/app/solution"
},
"result": [
{
"functionResponse": {
"id": "grep_search__call_535894",
"name": "grep_search",
"response": {
"output": "Found 2 matches for pattern \"build_known_positive_filter\" in path \"/app/solution\":\n---\nFile: train_current_model.py\nL563- )\nL564- normalization = float(np.sum(counts * raw) / max(total, 1.0))\nL565- correction = np.clip(\nL566- raw / max(normalization, 1.0e-12),\nL567- config.inbatch_correction_min,\nL568- config.inbatch_correction_max,\nL569- ).astype(np.float32)\nL570- mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\nL571- log(\nL572- f\"inbatch correction: min={correction.min():.3f} \"\nL573- f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\nL574- )\nL575- return torch.from_numpy(correction)\nL576- \nL577- \nL578: def build_known_positive_filter(\nL579- prepared: SequenceData, training_counts: np.ndarray\nL580- ) -> np.ndarray:\nL581- \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\nL582- width = (len(prepared.item_ids) + 7) // 8\nL583- packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\nL584- retained = 0\nL585- for user_row, target_count in enumerate(training_counts):\nL586- if not target_count:\nL587- continue\nL588- offset = int(prepared.offsets[user_row])\nL589- # T adjacent targets consume sequence positions 0 through T. The\nL590- # chronological BCE suffix starts at T + 1 and is intentionally absent.\nL591- items = np.unique(\nL592- prepared.sequence_items[\nL593- offset : offset + int(target_count) + 1\nL1551- generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\nL1552- item_correction = build_item_correction(\nL1553- prepared,\nL1554- config,\nL1555- partition.window_starts,\nL1556- training_counts,\nL1557- )\nL1558- target_weights = build_target_weights(\nL1559- public,\nL1560- stage,\nL1561- prepared,\nL1562- partition.history_training_counts,\nL1563- config,\nL1564- )\nL1565- known_positive_packed = (\nL1566: build_known_positive_filter(prepared, partition.history_training_counts)\nL1567- if config.negative_filter_scope == \"full-training-history\"\nL1568- else None\nL1569- )\nL1570- history: list[dict[str, float]] = []\nL1571- best_loss = float(\"inf\")\nL1572- best_epoch = 0\nL1573- best_state: dict[str, torch.Tensor] | None = None\nL1574- epochs_without_improvement = 0\nL1575- start_epoch = 0\nL1576- \nL1577- if resume_checkpoint is not None:\nL1578- payload = torch.load(\nL1579- resume_checkpoint, map_location=device, weights_only=False\nL1580- )\nL1581- stored_config = payload.get(\"config\", {})\n---"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:14:50.202Z",
"resultDisplay": {
"summary": "Found 2 matches",
"matches": [
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 578,
"line": "def build_known_positive_filter("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1566,
"line": " build_known_positive_filter(prepared, partition.history_training_counts)"
}
]
},
"description": "'build_known_positive_filter' within solution",
"displayName": "SearchText",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:14:50.203Z",
"content": "Found 2 matches for pattern \"build_known_positive_filter\" in path \"/app/solution\":\n---\nFile: train_current_model.py\nL563- )\nL564- normalization = float(np.sum(counts * raw) / max(total, 1.0))\nL565- correction = np.clip(\nL566- raw / max(normalization, 1.0e-12),\nL567- config.inbatch_correction_min,\nL568- config.inbatch_correction_max,\nL569- ).astype(np.float32)\nL570- mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\nL571- log(\nL572- f\"inbatch correction: min={correction.min():.3f} \"\nL573- f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\nL574- )\nL575- return torch.from_numpy(correction)\nL576- \nL577- \nL578: def build_known_positive_filter(\nL579- prepared: SequenceData, training_counts: np.ndarray\nL580- ) -> np.ndarray:\nL581- \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\nL582- width = (len(prepared.item_ids) + 7) // 8\nL583- packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\nL584- retained = 0\nL585- for user_row, target_count in enumerate(training_counts):\nL586- if not target_count:\nL587- continue\nL588- offset = int(prepared.offsets[user_row])\nL589- # T adjacent targets consume sequence positions 0 through T. The\nL590- # chronological BCE suffix starts at T + 1 and is intentionally absent.\nL591- items = np.unique(\nL592- prepared.sequence_items[\nL593- offset : offset + int(target_count) + 1\nL1551- generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\nL1552- item_correction = build_item_correction(\nL1553- prepared,\nL1554- config,\nL1555- partition.window_starts,\nL1556- training_counts,\nL1557- )\nL1558- target_weights = build_target_weights(\nL1559- public,\nL1560- stage,\nL1561- prepared,\nL1562- partition.history_training_counts,\nL1563- config,\nL1564- )\nL1565- known_positive_packed = (\nL1566: build_known_positive_filter(prepared, partition.history_training_counts)\nL1567- if config.negative_filter_scope == \"full-training-history\"\nL1568- else None\nL1569- )\nL1570- history: list[dict[str, float]] = []\nL1571- best_loss = float(\"inf\")\nL1572- best_epoch = 0\nL1573- best_state: dict[str, torch.Tensor] | None = None\nL1574- epochs_without_improvement = 0\nL1575- start_epoch = 0\nL1576- \nL1577- if resume_checkpoint is not None:\nL1578- payload = torch.load(\nL1579- resume_checkpoint, map_location=device, weights_only=False\nL1580- )\nL1581- stored_config = payload.get(\"config\", {})\n---",
"isError": false
},
"responseMessageId": "50b8d58d-aed3-49ab-a3a5-d9ff831fe77d"
}
]
},
{
"id": 37,
"role": "agent",
"timestamp": "2026-09-29T02:15:03.701Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:03.701Z",
"text": "Processing Partition Data\n\nI've confirmed that `partition.history_training_counts`, derived from `totals - validation`, was successfully passed into the `build_known_positive_filter` function. This indicates progress in how we're handling the historical training counts for partition analysis."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:15:03.701Z",
"callId": "read_file__call_2816158",
"name": "read_file",
"input": {
"start_line": 1364,
"end_line": 1480,
"file_path": "/app/solution/train_current_model.py"
},
"recorded": {
"id": "read_file__call_2816158",
"name": "read_file",
"args": {
"start_line": 1364,
"end_line": 1480,
"file_path": "/app/solution/train_current_model.py"
},
"result": [
{
"functionResponse": {
"id": "read_file__call_2816158",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1364-1480 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1481.\n\n--- FILE CONTENT (truncated) ---\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:15:03.706Z",
"resultDisplay": "Read lines 1364-1480 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:15:03.707Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1364-1480 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1481.\n\n--- FILE CONTENT (truncated) ---\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {",
"isError": false
},
"responseMessageId": "88438677-6a7f-4fa6-aa09-5c6dc23f3b02"
}
]
},
{
"id": 38,
"role": "agent",
"timestamp": "2026-09-29T02:15:07.619Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:15:07.619Z",
"callId": "read_file__call_54360",
"name": "read_file",
"input": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 1700,
"start_line": 1520
},
"recorded": {
"id": "read_file__call_54360",
"name": "read_file",
"args": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 1700,
"start_line": 1520
},
"result": [
{
"functionResponse": {
"id": "read_file__call_54360",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1520-1700 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1701.\n\n--- FILE CONTENT (truncated) ---\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:15:07.624Z",
"resultDisplay": "Read lines 1520-1700 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:15:07.626Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1520-1700 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1701.\n\n--- FILE CONTENT (truncated) ---\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,",
"isError": false
},
"responseMessageId": "58ee083a-4d94-4e70-b869-fe46efc9e978"
}
]
},
{
"id": 39,
"role": "agent",
"timestamp": "2026-09-29T02:15:09.481Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:15:09.481Z",
"callId": "read_file__call_4722138",
"name": "read_file",
"input": {
"start_line": 1700,
"end_line": 1780,
"file_path": "/app/solution/train_current_model.py"
},
"recorded": {
"id": "read_file__call_4722138",
"name": "read_file",
"args": {
"start_line": 1700,
"end_line": 1780,
"file_path": "/app/solution/train_current_model.py"
},
"result": [
{
"functionResponse": {
"id": "read_file__call_4722138",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1700-1780 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1781.\n\n--- FILE CONTENT (truncated) ---\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:15:09.486Z",
"resultDisplay": "Read lines 1700-1780 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:15:09.487Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1700-1780 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1781.\n\n--- FILE CONTENT (truncated) ---\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n",
"isError": false
},
"responseMessageId": "0bf980b1-c306-49b6-a3a4-0f4634afe947"
}
]
},
{
"id": 40,
"role": "agent",
"timestamp": "2026-09-29T02:15:24.815Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:24.815Z",
"text": "Exploring Epoch Defaults\n\nI'm investigating the default setting of `config.epochs` to 1. My initial hypothesis is that this is a performance optimization, as a single epoch currently consumes approximately 210 seconds, and with early stopping set at a patience of 1, the process would terminate after this initial evaluation."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:24.815Z",
"text": "Analyzing Negative Sampling\n\nI'm now delving into the specifics of how negative examples are selected within `train_current_model.py`. My current focus is on dissecting the `draw_full_history_filtered_negatives` function to understand the exact mechanisms for both uniform and in-batch negative sampling."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:24.815Z",
"text": "Refining Negative Sampling\n\nI'm examining the `inbatch_negatives` logic. I've identified that `targets` originates from `positive_items`, which are derived from the BPTT steps within a user's training block, specifically the positive item IDs. This clarification is crucial for understanding the context of in-batch negative selection."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:24.815Z",
"text": "Clarifying In-Batch Negatives\n\nI've confirmed that `targets` contains up to 6,400 items per BPTT block. Importantly, the system samples 8 items from `unique_targets` for in-batch negatives. I'm now investigating how this differs from standard in-batch negative sampling in recommender systems, specifically focusing on the correction mechanism applied by `build_item_correction`."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:24.815Z",
"text": "Adjusting Loss Calculations\n\nI'm currently investigating the `inbatch_correction_power` parameter, noting its default value of 0.5. My focus is on how this value, along with the `raw` and `correction` tensors derived from item probabilities and counts, impacts the `corrected_negative_loss` calculation. This appears to be a key area influencing the model's learning from negative samples."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:24.815Z",
"text": "Investigating Loss Weights\n\nI'm now examining how the `raw` and `correction` tensors are used in the loss calculation. It appears `raw`, representing the BCE loss for negative items, is multiplied by `correction` weights. I'm digging into the origin of these `correction` weights to understand their impact on the `corrected_negative_loss`."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:24.815Z",
"text": "Correcting Loss Weighting\n\nI'm realizing my previous assumption about inverse propensity weighting was incomplete. The correction logic seems to be inversely related to item popularity for in-batch negatives. High probability items, sampled more frequently, get smaller weights, and low probability items, sampled less often, receive larger weights. This aligns more with bias correction than simple inverse propensity."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:15:24.815Z",
"callId": "run_shell_command__call_51357",
"name": "run_shell_command",
"input": {
"description": "Check candidate counts",
"command": "python3 -c \"\nimport numpy as np\nwith np.load('/task/data/validation_eligible_candidates.npz') as f:\n uids = f['uids']\n item_ids = f['item_ids']\n packed = f['packed_eligible']\n print(f'users: {len(uids)}, items: {len(item_ids)}')\n # count eligible per user\n sample_mask = np.unpackbits(packed[0], count=len(item_ids), bitorder='little')\n print('User 0 eligible items:', sample_mask.sum())\n\""
},
"recorded": {
"id": "run_shell_command__call_51357",
"name": "run_shell_command",
"args": {
"description": "Check candidate counts",
"command": "python3 -c \"\nimport numpy as np\nwith np.load('/task/data/validation_eligible_candidates.npz') as f:\n uids = f['uids']\n item_ids = f['item_ids']\n packed = f['packed_eligible']\n print(f'users: {len(uids)}, items: {len(item_ids)}')\n # count eligible per user\n sample_mask = np.unpackbits(packed[0], count=len(item_ids), bitorder='little')\n print('User 0 eligible items:', sample_mask.sum())\n\""
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_51357",
"name": "run_shell_command",
"response": {
"output": "\nOutput: users: 8456, items: 30000\nUser 0 eligible items: 29318\nProcess Group PGID: 1734\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:15:25.315Z",
"resultDisplay": "users: 8456, items: 30000\nUser 0 eligible items: 29318",
"description": "Check candidate counts",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:15:25.316Z",
"content": "\nOutput: users: 8456, items: 30000\nUser 0 eligible items: 29318\nProcess Group PGID: 1734\n",
"isError": false
},
"responseMessageId": "604f10dc-83fa-43e6-9e5b-cd30c05f79b9"
}
]
},
{
"id": 41,
"role": "agent",
"timestamp": "2026-09-29T02:15:28.477Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:28.477Z",
"text": "Reviewing Catalog Data\n\nI'm analyzing the vast catalog size, noting approximately 30,000 items. My focus is on determining eligible items per user, which appears to be around 29,318, excluding those already interacted with. Next, I need to pinpoint the true positive items within the validation window for each user."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:15:28.477Z",
"callId": "run_shell_command__call_3373288",
"name": "run_shell_command",
"input": {
"description": "Inspect validation positive distribution",
"command": "python3 -c \"\nimport pandas as pd, numpy as np\nfrom pathlib import Path\nfrom ranking_evaluation import CandidateSet\nimport evaluate_public\n\neligibility = CandidateSet(Path('/task/data/validation_eligible_candidates.npz'))\ntargets = set(pd.read_parquet('/task/data/target_users.parquet').uid.astype(int))\ngraded = evaluate_public.validation_truth(eligibility, targets)\nprint('Number of users with at least 1 positive:', len(graded))\npos_counts = [len(v) for v in graded.values()]\nprint('Average positives per positive user:', np.mean(pos_counts), 'median:', np.median(pos_counts), 'max:', np.max(pos_counts))\ngrade3_counts = [sum(1 for g in v.values() if g == 3) for v in graded.values()]\nprint('Average grade 3 per user:', np.mean(grade3_counts))\n\""
},
"recorded": {
"id": "run_shell_command__call_3373288",
"name": "run_shell_command",
"args": {
"description": "Inspect validation positive distribution",
"command": "python3 -c \"\nimport pandas as pd, numpy as np\nfrom pathlib import Path\nfrom ranking_evaluation import CandidateSet\nimport evaluate_public\n\neligibility = CandidateSet(Path('/task/data/validation_eligible_candidates.npz'))\ntargets = set(pd.read_parquet('/task/data/target_users.parquet').uid.astype(int))\ngraded = evaluate_public.validation_truth(eligibility, targets)\nprint('Number of users with at least 1 positive:', len(graded))\npos_counts = [len(v) for v in graded.values()]\nprint('Average positives per positive user:', np.mean(pos_counts), 'median:', np.median(pos_counts), 'max:', np.max(pos_counts))\ngrade3_counts = [sum(1 for g in v.values() if g == 3) for v in graded.values()]\nprint('Average grade 3 per user:', np.mean(grade3_counts))\n\""
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_3373288",
"name": "run_shell_command",
"response": {
"output": "\nOutput: Traceback (most recent call last):\n File \"\", line 4, in \nModuleNotFoundError: No module named 'ranking_evaluation'\nExit Code: 1\nProcess Group PGID: 1744\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:15:29.969Z",
"resultDisplay": "Traceback (most recent call last):\n File \"\", line 4, in \nModuleNotFoundError: No module named 'ranking_evaluation'",
"description": "Inspect validation positive distribution",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:15:29.970Z",
"content": "\nOutput: Traceback (most recent call last):\n File \"\", line 4, in \nModuleNotFoundError: No module named 'ranking_evaluation'\nExit Code: 1\nProcess Group PGID: 1744\n",
"isError": false
},
"responseMessageId": "8aa36b10-bd12-4eed-b2eb-1897cef2b979"
}
]
},
{
"id": 42,
"role": "agent",
"timestamp": "2026-09-29T02:15:42.950Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:15:42.950Z",
"callId": "run_shell_command__call_5369987",
"name": "run_shell_command",
"input": {
"command": "PYTHONPATH=/task python3 -c \"\nimport pandas as pd, numpy as np\nfrom pathlib import Path\nfrom ranking_evaluation import CandidateSet\nimport evaluate_public\n\neligibility = CandidateSet(Path('/task/data/validation_eligible_candidates.npz'))\ntargets = set(pd.read_parquet('/task/data/target_users.parquet').uid.astype(int))\ngraded = evaluate_public.validation_truth(eligibility, targets)\nprint('Number of users with at least 1 positive:', len(graded))\npos_counts = [len(v) for v in graded.values()]\nprint('Average positives per positive user:', np.mean(pos_counts), 'median:', np.median(pos_counts), 'max:', np.max(pos_counts))\ngrade3_counts = [sum(1 for g in v.values() if g == 3) for v in graded.values()]\nprint('Average grade 3 per user:', np.mean(grade3_counts))\n\"",
"description": "Inspect validation positive distribution"
},
"recorded": {
"id": "run_shell_command__call_5369987",
"name": "run_shell_command",
"args": {
"command": "PYTHONPATH=/task python3 -c \"\nimport pandas as pd, numpy as np\nfrom pathlib import Path\nfrom ranking_evaluation import CandidateSet\nimport evaluate_public\n\neligibility = CandidateSet(Path('/task/data/validation_eligible_candidates.npz'))\ntargets = set(pd.read_parquet('/task/data/target_users.parquet').uid.astype(int))\ngraded = evaluate_public.validation_truth(eligibility, targets)\nprint('Number of users with at least 1 positive:', len(graded))\npos_counts = [len(v) for v in graded.values()]\nprint('Average positives per positive user:', np.mean(pos_counts), 'median:', np.median(pos_counts), 'max:', np.max(pos_counts))\ngrade3_counts = [sum(1 for g in v.values() if g == 3) for v in graded.values()]\nprint('Average grade 3 per user:', np.mean(grade3_counts))\n\"",
"description": "Inspect validation positive distribution"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5369987",
"name": "run_shell_command",
"response": {
"output": "\nOutput: Number of users with at least 1 positive: 4263\nAverage positives per positive user: 8.859723199624677 median: 4.0 max: 442\nAverage grade 3 per user: 1.0361247947454844\nProcess Group PGID: 1755\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:15:45.007Z",
"resultDisplay": "Number of users with at least 1 positive: 4263\nAverage positives per positive user: 8.859723199624677 median: 4.0 max: 442\nAverage grade 3 per user: 1.0361247947454844",
"description": "Inspect validation positive distribution",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:15:45.009Z",
"content": "\nOutput: Number of users with at least 1 positive: 4263\nAverage positives per positive user: 8.859723199624677 median: 4.0 max: 442\nAverage grade 3 per user: 1.0361247947454844\nProcess Group PGID: 1755\n",
"isError": false
},
"responseMessageId": "fad46970-8c03-485a-abd2-254702ac5af5"
}
]
},
{
"id": 43,
"role": "agent",
"timestamp": "2026-09-29T02:15:48.185Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:48.185Z",
"text": "Analyzing Baseline Predictions\n\nI'm currently examining the baseline model's top 10 predictions from `/app/solution/production_validation.parquet`. My focus is on understanding the characteristics of these predicted items – their popularity, any repetition, and how they align with the 4263 users who have at least one positive."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:15:48.185Z",
"callId": "run_shell_command__call_5803735",
"name": "run_shell_command",
"input": {
"description": "Check item distribution in baseline predictions",
"command": "python3 -c \"\nimport pandas as pd\ndf = pd.read_parquet('/app/solution/production_validation.parquet')\nprint('Total rows:', len(df))\nprint('Unique items recommended:', df.item_id.nunique())\ntop_recs = df[df['rank'] <= 10].item_id.value_counts()\nprint('Top 10 recommended items (frequency across users in top 10):')\nprint(top_recs.head(15))\nprint('Number of unique items in top 10:', df[df['rank'] <= 10].item_id.nunique())\n\""
},
"recorded": {
"id": "run_shell_command__call_5803735",
"name": "run_shell_command",
"args": {
"description": "Check item distribution in baseline predictions",
"command": "python3 -c \"\nimport pandas as pd\ndf = pd.read_parquet('/app/solution/production_validation.parquet')\nprint('Total rows:', len(df))\nprint('Unique items recommended:', df.item_id.nunique())\ntop_recs = df[df['rank'] <= 10].item_id.value_counts()\nprint('Top 10 recommended items (frequency across users in top 10):')\nprint(top_recs.head(15))\nprint('Number of unique items in top 10:', df[df['rank'] <= 10].item_id.nunique())\n\""
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5803735",
"name": "run_shell_command",
"response": {
"output": "\nOutput: Total rows: 845600\nUnique items recommended: 2575\nTop 10 recommended items (frequency across users in top 10):\nitem_id\n6006390 2917\n8213481 2800\n6896222 2712\n8743390 2653\n5436843 2587\n2651314 2580\n8722394 2542\n3542184 2427\n5862961 2292\n906358 2066\n5927996 1872\n9378983 1537\n2185191 1522\n6901374 1463\n3033749 1333\nName: count, dtype: int64\nNumber of unique items in top 10: 592\nProcess Group PGID: 1775\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:15:49.764Z",
"resultDisplay": "Total rows: 845600\nUnique items recommended: 2575\nTop 10 recommended items (frequency across users in top 10):\nitem_id\n6006390 2917\n8213481 2800\n6896222 2712\n8743390 2653\n5436843 2587\n2651314 2580\n8722394 2542\n3542184 2427\n5862961 2292\n906358 2066\n5927996 1872\n9378983 1537\n2185191 1522\n6901374 1463\n3033749 1333\nName: count, dtype: int64\nNumber of unique items in top 10: 592",
"description": "Check item distribution in baseline predictions",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:15:49.765Z",
"content": "\nOutput: Total rows: 845600\nUnique items recommended: 2575\nTop 10 recommended items (frequency across users in top 10):\nitem_id\n6006390 2917\n8213481 2800\n6896222 2712\n8743390 2653\n5436843 2587\n2651314 2580\n8722394 2542\n3542184 2427\n5862961 2292\n906358 2066\n5927996 1872\n9378983 1537\n2185191 1522\n6901374 1463\n3033749 1333\nName: count, dtype: int64\nNumber of unique items in top 10: 592\nProcess Group PGID: 1775\n",
"isError": false
},
"responseMessageId": "6a4c52d2-2b77-4782-96ba-1cdcc613062e"
}
]
},
{
"id": 44,
"role": "agent",
"timestamp": "2026-09-29T02:15:53.659Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:53.659Z",
"text": "Analyzing User Recommendations\n\nI'm focusing on the recommendation performance of specific items. Item 6006390 is standing out significantly, appearing in the top 10 for a substantial portion of users. It's interesting to see how few unique items actually make it into these top recommendations overall."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:15:53.659Z",
"callId": "run_shell_command__call_4432898",
"name": "run_shell_command",
"input": {
"command": "python3 -c \"\nimport pandas as pd\ncat = pd.read_parquet('/task/data/candidate_catalog.parquet')\ntop_items = [6006390, 8213481, 6896222, 8743390, 5436843, 2651314, 8722394, 3542184]\nprint(cat[cat.item_id.isin(top_items)][['item_id', 'popularity_rank', 'positive_listens', 'organic_positive_listens']])\n\"",
"description": "Check popularity of baseline top recommendations"
},
"recorded": {
"id": "run_shell_command__call_4432898",
"name": "run_shell_command",
"args": {
"command": "python3 -c \"\nimport pandas as pd\ncat = pd.read_parquet('/task/data/candidate_catalog.parquet')\ntop_items = [6006390, 8213481, 6896222, 8743390, 5436843, 2651314, 8722394, 3542184]\nprint(cat[cat.item_id.isin(top_items)][['item_id', 'popularity_rank', 'positive_listens', 'organic_positive_listens']])\n\"",
"description": "Check popularity of baseline top recommendations"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_4432898",
"name": "run_shell_command",
"response": {
"output": "\nOutput: item_id popularity_rank positive_listens organic_positive_listens\n3 3542184 4 24075 17699\n6 8213481 7 22505 17071\n10 2651314 11 16286 11801\n13 5436843 14 14897 12127\n21 8743390 22 13518 8480\n74 6006390 75 8970 6813\n633 8722394 634 3464 1695\n817 6896222 818 3020 2017\nProcess Group PGID: 1793\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:15:55.210Z",
"resultDisplay": "item_id popularity_rank positive_listens organic_positive_listens\n3 3542184 4 24075 17699\n6 8213481 7 22505 17071\n10 2651314 11 16286 11801\n13 5436843 14 14897 12127\n21 8743390 22 13518 8480\n74 6006390 75 8970 6813\n633 8722394 634 3464 1695\n817 6896222 818 3020 2017",
"description": "Check popularity of baseline top recommendations",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:15:55.212Z",
"content": "\nOutput: item_id popularity_rank positive_listens organic_positive_listens\n3 3542184 4 24075 17699\n6 8213481 7 22505 17071\n10 2651314 11 16286 11801\n13 5436843 14 14897 12127\n21 8743390 22 13518 8480\n74 6006390 75 8970 6813\n633 8722394 634 3464 1695\n817 6896222 818 3020 2017\nProcess Group PGID: 1793\n",
"isError": false
},
"responseMessageId": "301c0d84-277b-4213-98a6-d2535c78eb8f"
}
]
},
{
"id": 45,
"role": "agent",
"timestamp": "2026-09-29T02:15:58.322Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:15:58.322Z",
"text": "Analyzing Popularity Dynamics\n\nI'm currently investigating the popularity of top recommended items, comparing them against items explicitly identified as true positives within the `graded` set. My focus is on discerning whether these true positives lean towards general popularity or represent more personalized, niche preferences, and crucially, whether this popularity bias is negatively impacting NDCG@10 scores."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:15:58.322Z",
"callId": "run_shell_command__call_3292143",
"name": "run_shell_command",
"input": {
"command": "PYTHONPATH=/task python3 -c \"\nimport pandas as pd, numpy as np\nfrom pathlib import Path\nfrom ranking_evaluation import CandidateSet\nimport evaluate_public\n\ncat = pd.read_parquet('/task/data/candidate_catalog.parquet').set_index('item_id')\neligibility = CandidateSet(Path('/task/data/validation_eligible_candidates.npz'))\ntargets = set(pd.read_parquet('/task/data/target_users.parquet').uid.astype(int))\ngraded = evaluate_public.validation_truth(eligibility, targets)\n\nranks = []\nfor uid, items in graded.items():\n for item in items:\n if item in cat.index:\n ranks.append(cat.loc[item, 'popularity_rank'])\n\nprint('True positives popularity rank:')\nprint(pd.Series(ranks).describe(percentiles=[0.1, 0.25, 0.5, 0.75, 0.9]))\n\"",
"description": "Check popularity of true validation positive items"
},
"recorded": {
"id": "run_shell_command__call_3292143",
"name": "run_shell_command",
"args": {
"command": "PYTHONPATH=/task python3 -c \"\nimport pandas as pd, numpy as np\nfrom pathlib import Path\nfrom ranking_evaluation import CandidateSet\nimport evaluate_public\n\ncat = pd.read_parquet('/task/data/candidate_catalog.parquet').set_index('item_id')\neligibility = CandidateSet(Path('/task/data/validation_eligible_candidates.npz'))\ntargets = set(pd.read_parquet('/task/data/target_users.parquet').uid.astype(int))\ngraded = evaluate_public.validation_truth(eligibility, targets)\n\nranks = []\nfor uid, items in graded.items():\n for item in items:\n if item in cat.index:\n ranks.append(cat.loc[item, 'popularity_rank'])\n\nprint('True positives popularity rank:')\nprint(pd.Series(ranks).describe(percentiles=[0.1, 0.25, 0.5, 0.75, 0.9]))\n\"",
"description": "Check popularity of true validation positive items"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_3292143",
"name": "run_shell_command",
"response": {
"output": "\nOutput: True positives popularity rank:\ncount 37769.000000\nmean 8463.087744\nstd 8117.953262\nmin 1.000000\n10% 428.000000\n25% 1733.000000\n50% 5622.000000\n75% 13374.000000\n90% 21680.200000\nmax 30000.000000\ndtype: float64\nProcess Group PGID: 1810\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:16:00.642Z",
"resultDisplay": "True positives popularity rank:\ncount 37769.000000\nmean 8463.087744\nstd 8117.953262\nmin 1.000000\n10% 428.000000\n25% 1733.000000\n50% 5622.000000\n75% 13374.000000\n90% 21680.200000\nmax 30000.000000\ndtype: float64",
"description": "Check popularity of true validation positive items",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:16:00.643Z",
"content": "\nOutput: True positives popularity rank:\ncount 37769.000000\nmean 8463.087744\nstd 8117.953262\nmin 1.000000\n10% 428.000000\n25% 1733.000000\n50% 5622.000000\n75% 13374.000000\n90% 21680.200000\nmax 30000.000000\ndtype: float64\nProcess Group PGID: 1810\n",
"isError": false
},
"responseMessageId": "b44fb107-6a06-4d81-9fa7-fe1a164f5d63"
}
]
},
{
"id": 46,
"role": "agent",
"timestamp": "2026-09-29T02:16:42.530Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Analyzing Discovery Data\n\nMy current focus is on the \"Made for You\" music discovery surface. I'm observing that true discovery positives have a median popularity rank of 5,622, with the 75th percentile at 13,374. Users are exploring a wide range of tracks here."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Investigating Recommendation Logic\n\nI'm digging into why the current model is universally recommending highly popular tracks despite the observed distribution of user discovery. My next step is to meticulously examine the training objective and negative sampling mechanics to pinpoint the root cause of this behavior."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Refining Loss Function\n\nI'm currently examining the `corrected_negative_loss` function, specifically how `uniform_negatives` and `inbatch_negatives` are weighted and combined. My goal is to understand how this impacts the overall loss calculation and the model's tendency to favor popular tracks."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Re-evaluating Negative Sampling\n\nI'm scrutinizing the `corrected_negative_loss` implementation, particularly the sampling of `uniform_negatives`. It appears this method, by drawing from obscure tracks, isn't effectively teaching the model to differentiate relevant from popular items. My next step is to deeply investigate how in-batch negatives are being sampled to understand their contribution."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Adjusting In-Batch Sampling\n\nI've identified a potential issue in how `unique_targets` are being processed for in-batch negatives. The current method might be inadvertently including some popular items and not effectively distinguishing them from truly relevant ones. I'm investigating the `torch.unique` and subsequent sampling logic."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Fixing In-Batch Logic\n\nI've discovered the core issue: `torch.unique` is applied before sampling in-batch negatives, destroying frequency weighting. This means popular items aren't being sampled proportionally, undermining the intended effect. I'm now investigating how to correct this to ensure proper in-batch negative sampling."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Correcting Loss Weighting\n\nI've uncovered a significant issue where the `corrected_negative_loss` incorrectly downweights popular items sampled as in-batch negatives. This is due to the `weights` calculation multiplying their loss by 0.25, while rare items get amplified. This, combined with the previous `unique_targets` flattening, severely distorts the learning signal."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Verifying Theory\n\nI'm now cross-referencing my findings with established research, specifically \"Sampling-bias-corrected neural modeling for large-scale recommendation.\" My goal is to ensure my understanding of the theoretical underpinnings of negative sampling and bias correction aligns precisely with the implementation."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Validating Training Objectives\n\nI'm now comparing the theoretical advantages of logit correction, as found in research, against the current implementation's use of Binary Cross-Entropy (BCE) loss. My next step is to determine if the codebase supports alternative objectives like Softmax or InfoNCE, which might better handle popularity bias."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Revising Loss Formulation\n\nI'm now exploring how to revise the loss formulation. My current thinking is to remove the erroneous weight calculation and ensure that positive items are not inadvertently treated as negatives within the in-batch sampling. I'm also considering how to better implement logit correction."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Testing New Recommendations\n\nI'm now validating the corrected loss formulation against the public backtest to ensure it trains and ranks efficiently within the CPU environment while respecting serving and data boundaries. This step is crucial for confirming the practical impact of the changes."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Replacing Invalid Negatives\n\nI'm now actively replacing invalid in-batch negatives. The code iterates, identifies problematic samples, and replaces them with new random draws from the item pool. This process ensures we're always learning from genuinely distinct negative examples, refining the model’s understanding."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Replacing Invalid Negatives\n\nI'm actively replacing invalid in-batch negatives by iterating and drawing new random samples from the item pool. This ensures the model learns from genuinely distinct negative examples. I'm also re-evaluating the number of uniform negatives sampled, as the current count seems excessively high given the catalog size."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Investigating Batch Size\n\nI'm questioning the fixed number of 8 in-batch negatives. Given the potential for 500-1000 unique targets and a much larger overall item pool, this feels overly restrictive and likely insufficient for robust learning. I'm also questioning the fixed 24 uniform negatives."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Evaluating Unique Item Encoding\n\nI'm re-examining the `candidate_vectors` function. I've realized that `torch.unique` is applied before encoding, meaning I might be encoding the same item multiple times if it appears in both positives and negatives, or across different batch examples. This is inefficient and could lead to inconsistent vector representations."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Implementing In-Batch Negatives\n\nI'm realizing the potential of true in-batch negatives. Instead of fixed uniform or in-batch samples, I can leverage all other items within a microbatch as negatives for a given query. This simplifies computation, reduces the need for explicit sampling, and increases the number of effective negatives per query, leading to a more robust training signal."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Processing User Data\n\nI'm now observing how user data is batched and processed. For each group of 64 users, up to 100 BPTT steps occur, resulting in a large number of positive targets. I'm examining the `target_weighting` configuration, specifically the default `\"organic-strong\"`, and its impact on the weights assigned to different types of targets."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Analyzing Target Weights\n\nI'm focusing on how organic listen percentages and likes are weighted within the loss function. My current analysis reveals that organic likes, representing grade 3 relevance, have a significantly higher gain (7x) in the graded NDCG@10 metric compared to 80% organic listens (grade 1). This disparity needs careful consideration in my formulation."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Revising Target Weighting\n\nI'm now examining the impact of different `target_weighting` configurations on the loss. My analysis suggests that the default `\"organic-strong\"` is not optimal for discovery and that moving towards a `\"discovery-graded\"` approach is necessary to improve performance. I'm also re-evaluating the weight assigned to organic likes versus organic listens."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:42.530Z",
"text": "Refining Negative Sampling Strategy\n\nI'm now focusing on the `_sample_negatives` function, specifically how `uniform` and `inbatch` negatives are drawn. My initial analysis suggests the current approach to `inbatch` sampling might not be optimal given the number of `unique_targets` and the overall `n_items`. I'm investigating the logic for `corrected_count` and `priorities` to ensure we're effectively sampling relevant negatives."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:16:42.530Z",
"callId": "grep_search__call_5209995",
"name": "grep_search",
"input": {
"dir_path": "/app/solution",
"pattern": "dislike"
},
"recorded": {
"id": "grep_search__call_5209995",
"name": "grep_search",
"args": {
"dir_path": "/app/solution",
"pattern": "dislike"
},
"result": [
{
"functionResponse": {
"id": "grep_search__call_5209995",
"name": "grep_search",
"response": {
"output": "Found 40 matches for pattern \"dislike\" in path \"/app/solution\":\n---\nFile: train_current_model.py\nL110: disliked_states: np.ndarray\nL114: inference_disliked_items: np.ndarray\nL176: active_dislikes: dict[int, int],\nL179: disliked_states: list[np.ndarray],\nL183: disliked_states.append(\nL184: base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\nL186: state_counts.append((len(active_likes), len(active_dislikes)))\nL252: disliked_states: list[np.ndarray],\nL279: active_dislikes: dict[int, int] = {}\nL293: else active_dislikes\nL304: active_dislikes,\nL307: disliked_states,\nL320: dislike_count: int,\nL337: result[5] = np.log1p(dislike_count) / 4.0\nL369: inference_likes, inference_dislikes, like_counts, dislike_counts = (\nL383: disliked_states = [\nL384: np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\nL405: disliked_states,\nL427: int(dislike_counts[inference_row]),\nL440: np.log1p(dislike_counts[missing]) / 4.0\nL455: disliked_states=np.stack(disliked_states),\nL459: inference_disliked_items=inference_dislikes,\nL784: disliked_items = torch.from_numpy(\nL785: prepared.disliked_states[unique_states].astype(np.int64)\nL788: disliked_vectors = model._mean_context_channel(disliked_items)\nL793: disliked_vectors[inverse_rows],\nL802: disliked_vectors: torch.Tensor,\nL807: [sequence_vectors, liked_vectors, disliked_vectors, user_features],\nL1147: liked_vectors, disliked_vectors, _ = pool_explicit_states(\nL1159: disliked_vectors,\nL1844: disliked_items = torch.from_numpy(\nL1845: prepared.inference_disliked_items[output_rows].astype(np.int64)\nL1851: model._mean_context_channel(disliked_items),\n---\nFile: two_tower_model.py\nL22: DISLIKE_ITEMS = 24\nL184: (\"dislikes\", 1, 1, 0),\nL185: (\"undislikes\", 1, 0, 1),\nL265: disliked = np.full((len(uids), DISLIKE_ITEMS), n_items, dtype=np.uint16)\nL267: dislike_counts = np.zeros(len(uids), dtype=np.int32)\nL270: (\"disliked\", DISLIKE_ITEMS, disliked, dislike_counts),\nL281: return liked, disliked, like_counts, dislike_counts\n---"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:16:42.544Z",
"resultDisplay": {
"summary": "Found 40 matches",
"matches": [
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 110,
"line": " disliked_states: np.ndarray"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 114,
"line": " inference_disliked_items: np.ndarray"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 176,
"line": " active_dislikes: dict[int, int],"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 179,
"line": " disliked_states: list[np.ndarray],"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 183,
"line": " disliked_states.append("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 184,
"line": " base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 186,
"line": " state_counts.append((len(active_likes), len(active_dislikes)))"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 252,
"line": " disliked_states: list[np.ndarray],"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 279,
"line": " active_dislikes: dict[int, int] = {}"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 293,
"line": " else active_dislikes"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 304,
"line": " active_dislikes,"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 307,
"line": " disliked_states,"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 320,
"line": " dislike_count: int,"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 337,
"line": " result[5] = np.log1p(dislike_count) / 4.0"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 369,
"line": " inference_likes, inference_dislikes, like_counts, dislike_counts = ("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 383,
"line": " disliked_states = ["
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 384,
"line": " np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 405,
"line": " disliked_states,"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 427,
"line": " int(dislike_counts[inference_row]),"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 440,
"line": " np.log1p(dislike_counts[missing]) / 4.0"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 455,
"line": " disliked_states=np.stack(disliked_states),"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 459,
"line": " inference_disliked_items=inference_dislikes,"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 784,
"line": " disliked_items = torch.from_numpy("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 785,
"line": " prepared.disliked_states[unique_states].astype(np.int64)"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 788,
"line": " disliked_vectors = model._mean_context_channel(disliked_items)"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 793,
"line": " disliked_vectors[inverse_rows],"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 802,
"line": " disliked_vectors: torch.Tensor,"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 807,
"line": " [sequence_vectors, liked_vectors, disliked_vectors, user_features],"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1147,
"line": " liked_vectors, disliked_vectors, _ = pool_explicit_states("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1159,
"line": " disliked_vectors,"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1844,
"line": " disliked_items = torch.from_numpy("
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1845,
"line": " prepared.inference_disliked_items[output_rows].astype(np.int64)"
},
{
"filePath": "train_current_model.py",
"absolutePath": "/app/solution/train_current_model.py",
"lineNumber": 1851,
"line": " model._mean_context_channel(disliked_items),"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 22,
"line": "DISLIKE_ITEMS = 24"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 184,
"line": " (\"dislikes\", 1, 1, 0),"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 185,
"line": " (\"undislikes\", 1, 0, 1),"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 265,
"line": " disliked = np.full((len(uids), DISLIKE_ITEMS), n_items, dtype=np.uint16)"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 267,
"line": " dislike_counts = np.zeros(len(uids), dtype=np.int32)"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 270,
"line": " (\"disliked\", DISLIKE_ITEMS, disliked, dislike_counts),"
},
{
"filePath": "two_tower_model.py",
"absolutePath": "/app/solution/two_tower_model.py",
"lineNumber": 281,
"line": " return liked, disliked, like_counts, dislike_counts"
}
]
},
"description": "'dislike' within solution",
"displayName": "SearchText",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:16:44.950Z",
"content": "Found 40 matches for pattern \"dislike\" in path \"/app/solution\":\n---\nFile: train_current_model.py\nL110: disliked_states: np.ndarray\nL114: inference_disliked_items: np.ndarray\nL176: active_dislikes: dict[int, int],\nL179: disliked_states: list[np.ndarray],\nL183: disliked_states.append(\nL184: base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\nL186: state_counts.append((len(active_likes), len(active_dislikes)))\nL252: disliked_states: list[np.ndarray],\nL279: active_dislikes: dict[int, int] = {}\nL293: else active_dislikes\nL304: active_dislikes,\nL307: disliked_states,\nL320: dislike_count: int,\nL337: result[5] = np.log1p(dislike_count) / 4.0\nL369: inference_likes, inference_dislikes, like_counts, dislike_counts = (\nL383: disliked_states = [\nL384: np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\nL405: disliked_states,\nL427: int(dislike_counts[inference_row]),\nL440: np.log1p(dislike_counts[missing]) / 4.0\nL455: disliked_states=np.stack(disliked_states),\nL459: inference_disliked_items=inference_dislikes,\nL784: disliked_items = torch.from_numpy(\nL785: prepared.disliked_states[unique_states].astype(np.int64)\nL788: disliked_vectors = model._mean_context_channel(disliked_items)\nL793: disliked_vectors[inverse_rows],\nL802: disliked_vectors: torch.Tensor,\nL807: [sequence_vectors, liked_vectors, disliked_vectors, user_features],\nL1147: liked_vectors, disliked_vectors, _ = pool_explicit_states(\nL1159: disliked_vectors,\nL1844: disliked_items = torch.from_numpy(\nL1845: prepared.inference_disliked_items[output_rows].astype(np.int64)\nL1851: model._mean_context_channel(disliked_items),\n---\nFile: two_tower_model.py\nL22: DISLIKE_ITEMS = 24\nL184: (\"dislikes\", 1, 1, 0),\nL185: (\"undislikes\", 1, 0, 1),\nL265: disliked = np.full((len(uids), DISLIKE_ITEMS), n_items, dtype=np.uint16)\nL267: dislike_counts = np.zeros(len(uids), dtype=np.int32)\nL270: (\"disliked\", DISLIKE_ITEMS, disliked, dislike_counts),\nL281: return liked, disliked, like_counts, dislike_counts\n---",
"isError": false
},
"responseMessageId": "895a03e2-1af9-418c-97cd-93c08a64549c"
}
]
},
{
"id": 47,
"role": "agent",
"timestamp": "2026-09-29T02:16:48.935Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:16:48.935Z",
"text": "Analyzing Input Features\n\nI'm currently examining how dislikes are handled within the user tower. My current understanding is that they're solely an input feature, never treated as hard negatives. I'm now shifting focus to the `listens` data to see its role."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:16:48.935Z",
"callId": "run_shell_command__call_43457",
"name": "run_shell_command",
"input": {
"description": "Inspect train_listens stats",
"command": "python3 -c \"\nimport pyarrow.parquet as pq\ntable = pq.read_table('/task/data/train_listens.parquet')\nprint('Schema:', table.schema)\nprint('Total rows:', table.num_rows)\n# sample played_ratio_pct\nratios = table['played_ratio_pct'].slice(0, 1000000).to_numpy()\nprint('played_ratio_pct < 20%:', (ratios < 20).mean())\nprint('played_ratio_pct < 50%:', (ratios < 50).mean())\nprint('played_ratio_pct >= 80%:', (ratios >= 80).mean())\n\""
},
"recorded": {
"id": "run_shell_command__call_43457",
"name": "run_shell_command",
"args": {
"description": "Inspect train_listens stats",
"command": "python3 -c \"\nimport pyarrow.parquet as pq\ntable = pq.read_table('/task/data/train_listens.parquet')\nprint('Schema:', table.schema)\nprint('Total rows:', table.num_rows)\n# sample played_ratio_pct\nratios = table['played_ratio_pct'].slice(0, 1000000).to_numpy()\nprint('played_ratio_pct < 20%:', (ratios < 20).mean())\nprint('played_ratio_pct < 50%:', (ratios < 50).mean())\nprint('played_ratio_pct >= 80%:', (ratios >= 80).mean())\n\""
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_43457",
"name": "run_shell_command",
"response": {
"output": "\nOutput: Schema: uid: uint32\ntimestamp: uint32\nitem_id: uint32\nis_organic: uint8\nplayed_ratio_pct: uint16\ntrack_length_seconds: uint32\n-- schema metadata --\npandas: '{\"index_columns\": [], \"column_indexes\": [], \"columns\": [{\"name\":' + 797\nTotal rows: 43484159\nplayed_ratio_pct < 20%: 0.313242\nplayed_ratio_pct < 50%: 0.375987\nplayed_ratio_pct >= 80%: 0.585347\nProcess Group PGID: 1832\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:16:51.019Z",
"resultDisplay": "Schema: uid: uint32\ntimestamp: uint32\nitem_id: uint32\nis_organic: uint8\nplayed_ratio_pct: uint16\ntrack_length_seconds: uint32\n-- schema metadata --\npandas: '{\"index_columns\": [], \"column_indexes\": [], \"columns\": [{\"name\":' + 797\nTotal rows: 43484159\nplayed_ratio_pct < 20%: 0.313242\nplayed_ratio_pct < 50%: 0.375987\nplayed_ratio_pct >= 80%: 0.585347",
"description": "Inspect train_listens stats",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:16:51.021Z",
"content": "\nOutput: Schema: uid: uint32\ntimestamp: uint32\nitem_id: uint32\nis_organic: uint8\nplayed_ratio_pct: uint16\ntrack_length_seconds: uint32\n-- schema metadata --\npandas: '{\"index_columns\": [], \"column_indexes\": [], \"columns\": [{\"name\":' + 797\nTotal rows: 43484159\nplayed_ratio_pct < 20%: 0.313242\nplayed_ratio_pct < 50%: 0.375987\nplayed_ratio_pct >= 80%: 0.585347\nProcess Group PGID: 1832\n",
"isError": false
},
"responseMessageId": "9730d266-c89d-4fe0-bf41-c4ed5b3f5a1c"
}
]
},
{
"id": 48,
"role": "agent",
"timestamp": "2026-09-29T02:17:31.538Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Analyzing Skip Patterns\n\nI'm diving deeper into the skip data, specifically the 37.6% of listens that are under 50%. I'm re-examining `invalid_negative_mask` and `invalid_full_history_negatives` for any insights into these rapid disengagements."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Refining Negative Filtering\n\nI've identified a potential issue with how `liked_items` is utilized within `invalid_full_history_negatives`. It seems the current implementation, with `LIKE_ITEMS` set to 48, might be implicitly considering a broader set of \"liked\" items than intended, potentially impacting the accuracy of my negative sample filtering, especially for those short listens."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Investigating Item Inclusion\n\nI'm realizing `liked_states` isn't in `invalid_negative_mask`, which is logical as disliked items are indeed negatives. However, I'm now questioning the role of `known_positive_packed` within `build_known_positive_filter`, as its interaction with user and item data requires further scrutiny."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Re-evaluating Positive Data\n\nI'm scrutinizing `build_known_positive_filter` and its inclusion of `prepared.sequence_items`. This now appears to encompass all positive listens, prompting me to consider how items present in `train_likes` but absent from `listens` are being handled."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Examining Candidate Exclusion\n\nI'm realizing that at test and validation time, all \"train\\_\\*\" encounters, including listens, likes, and dislikes, are excluded from candidate eligibility. This is a significant constraint."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Analyzing Negative Sampling\n\nI'm finding the current negative sampling strategy flawed. The uniform negatives are too easy, and the in-batch negatives aren't sampled by popularity as I'd assumed, meaning every unique item in the batch has an equal chance of being picked."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Revising Sampling Methods\n\nI'm realizing my current negative sampling strategy is fundamentally flawed. Uniform negatives are too simplistic, and in-batch negatives aren't sampled by popularity as anticipated, leading to a model that fails to suppress popular, irrelevant items."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Adjusting Loss Weighting\n\nI'm recalibrating the in-batch negative sampling. The current approach over-penalizes rare items and under-penalizes popular ones by clipping their correction factors. I'm refining the `correction` calculation to better reflect item popularity, aiming for a more balanced loss."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Correcting Loss Application\n\nI've discovered a critical flaw in how in-batch negatives are weighted within the loss calculation. Popular items are being excessively down-weighted when they appear as negatives, effectively reducing their penalty and hindering model performance. This needs immediate correction."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Correcting Gradient Impact\n\nI'm realizing that by heavily penalizing popular items less when they act as negatives, the model learns to universally favor popular items due to their near immunity to negative gradients. This is a significant issue for personalized recommendations."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Correcting Popularity Bias\n\nI'm realizing my previous adjustments still allow popular items, even as negatives, to dominate the loss too much. I need to implement true logit correction for sampled softmax to ensure popular and unpopular items are treated fairly, preventing the model from universally favoring popular candidates."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Correcting Logit Scale\n\nI'm revising the logit scaling for in-batch negatives. Instead of simply subtracting the log probability, I'm implementing a correction that subtracts $\\log(p_i)$ for both positive and negative items to properly account for popularity bias in the sampled softmax."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Revising Negative Sampling Logic\n\nI'm exploring how negative items are sampled, considering if popularity-based sampling proportional to frequency, like $(\\text{frequency}_i)^\\alpha$, might improve the model's ability to distinguish specific user preferences from general popularity. I am now inspecting `train_current_model.py` to understand the intended configuration options for this sampling strategy."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Exploring Sampling Weights\n\nI am now investigating the `inbatch_correction_power` and `inbatch_correction_min/max` parameters within `TrainConfig`, as these seem directly related to how popularity influences negative sampling. I am also looking at `ordinary_target_weight`, `organic_strong_target_weight`, and `organic_like_target_weight` to understand how different types of positive interactions are weighted."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Adjusting Sampling Parameters\n\nI am now examining the `inbatch_correction_power`, `inbatch_correction_min`, and `inbatch_correction_max` parameters to fine-tune the influence of item popularity on negative sampling. Additionally, I am assessing `ordinary_target_weight`, `organic_strong_target_weight`, and `organic_like_target_weight` to understand how various positive interactions are weighted."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Investigating Parameter Sources\n\nI'm realizing that several key negative sampling parameters like `inbatch_correction_power` are hardcoded within the `Config` class rather than being exposed as CLI arguments. This limits direct control over their tuning during experimentation, prompting a closer look at how they are intended to be configured in the production environment."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Analyzing Selection Strategy\n\nI am now intently focused on *how* negative examples are selected. My recent investigations into sampling parameters and their hardcoded nature within the `Config` class have highlighted this as a critical area needing scrutiny."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Refining Selection Strategy\n\nMy focus is now on the selection mechanisms within `draw_training_negatives`. I'm scrutinizing the overwhelming proportion of uniform negatives and how the in-batch sampling is flattened by `torch.unique`, thus losing the intended popularity weighting critical for effective negative example generation."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Revising Negative Sampling Logic\n\nI'm exploring how negative items are sampled, considering if popularity-based sampling proportional to frequency, like $(\\text{frequency}_i)^\\alpha$, might improve the model's ability to distinguish specific user preferences from general popularity. I am now inspecting `train_current_model.py` to understand the intended configuration options for this sampling strategy."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:17:31.538Z",
"text": "Analyzing Sequence Inclusion\n\nI'm realizing the `prepared.sequence_items` slice includes `target_count + 1` items, not just the targets. This means the filter is built using an extra item that might not be a true positive. I'm going to check `target_count`'s definition."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:17:31.538Z",
"callId": "run_shell_command__call_5210443",
"name": "run_shell_command",
"input": {
"description": "Check lengths vs history_training",
"command": "python3 -c \"\nimport numpy as np\ncache = np.load('/app/solution/validation_cache.npz')\nlengths = cache['lengths']\nprint('lengths min, mean, max:', lengths.min(), lengths.mean(), lengths.max())\ntotals = np.maximum(lengths - 1, 0)\nval_fraction = 0.10\nvalidation = np.floor(totals * val_fraction).astype(np.int64)\nvalidation[(totals >= 2) & (validation == 0)] = 1\nvalidation = np.minimum(validation, 16)\nhistory_training = totals - validation\nprint('history_training min, mean, max:', history_training.min(), history_training.mean(), history_training.max())\nprint('Difference lengths - history_training:', (lengths - history_training).min(), (lengths - history_training).max())\n\""
},
"recorded": {
"id": "run_shell_command__call_5210443",
"name": "run_shell_command",
"args": {
"description": "Check lengths vs history_training",
"command": "python3 -c \"\nimport numpy as np\ncache = np.load('/app/solution/validation_cache.npz')\nlengths = cache['lengths']\nprint('lengths min, mean, max:', lengths.min(), lengths.mean(), lengths.max())\ntotals = np.maximum(lengths - 1, 0)\nval_fraction = 0.10\nvalidation = np.floor(totals * val_fraction).astype(np.int64)\nvalidation[(totals >= 2) & (validation == 0)] = 1\nvalidation = np.minimum(validation, 16)\nhistory_training = totals - validation\nprint('history_training min, mean, max:', history_training.min(), history_training.mean(), history_training.max())\nprint('Difference lengths - history_training:', (lengths - history_training).min(), (lengths - history_training).max())\n\""
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5210443",
"name": "run_shell_command",
"response": {
"output": "\nOutput: Traceback (most recent call last):\n File \"\", line 4, in \n File \"/opt/task-venv/lib/python3.12/site-packages/numpy/lib/_npyio_impl.py\", line 261, in __getitem__\n raise KeyError(f\"{key} is not a file in the archive\")\nKeyError: 'lengths is not a file in the archive'\nExit Code: 1\nProcess Group PGID: 1853\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:17:31.928Z",
"resultDisplay": "Traceback (most recent call last):\n File \"\", line 4, in \n File \"/opt/task-venv/lib/python3.12/site-packages/numpy/lib/_npyio_impl.py\", line 261, in __getitem__\n raise KeyError(f\"{key} is not a file in the archive\")\nKeyError: 'lengths is not a file in the archive'",
"description": "Check lengths vs history_training",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:17:31.930Z",
"content": "\nOutput: Traceback (most recent call last):\n File \"\", line 4, in \n File \"/opt/task-venv/lib/python3.12/site-packages/numpy/lib/_npyio_impl.py\", line 261, in __getitem__\n raise KeyError(f\"{key} is not a file in the archive\")\nKeyError: 'lengths is not a file in the archive'\nExit Code: 1\nProcess Group PGID: 1853\n",
"isError": false
},
"responseMessageId": "8b434179-f31c-49c0-a573-edca1f05ad35"
}
]
},
{
"id": 49,
"role": "agent",
"timestamp": "2026-09-29T02:17:37.233Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:17:37.233Z",
"callId": "run_shell_command__call_4367317",
"name": "run_shell_command",
"input": {
"description": "Check keys in validation_cache.npz",
"command": "python3 -c \"\nimport numpy as np\ncache = np.load('/app/solution/validation_cache.npz')\nprint(cache.files)\n\""
},
"recorded": {
"id": "run_shell_command__call_4367317",
"name": "run_shell_command",
"args": {
"description": "Check keys in validation_cache.npz",
"command": "python3 -c \"\nimport numpy as np\ncache = np.load('/app/solution/validation_cache.npz')\nprint(cache.files)\n\""
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_4367317",
"name": "run_shell_command",
"response": {
"output": "\nOutput: ['metadata', 'item_ids', 'item_features', 'user_ids', 'offsets', 'sequence_timestamps', 'sequence_items', 'event_features', 'activity_features', 'state_ids', 'liked_states', 'disliked_states', 'state_counts', 'inference_user_rows', 'inference_liked_items', 'inference_disliked_items', 'inference_user_features']\nProcess Group PGID: 1863\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:17:37.626Z",
"resultDisplay": "['metadata', 'item_ids', 'item_features', 'user_ids', 'offsets', 'sequence_timestamps', 'sequence_items', 'event_features', 'activity_features', 'state_ids', 'liked_states', 'disliked_states', 'state_counts', 'inference_user_rows', 'inference_liked_items', 'inference_disliked_items', 'inference_user_features']",
"description": "python3 -c \"\nimport numpy as np\ncache = np.load('/app/solution/validation_cache.npz')\nprint(cache.files)\n\"",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:17:37.628Z",
"content": "\nOutput: ['metadata', 'item_ids', 'item_features', 'user_ids', 'offsets', 'sequence_timestamps', 'sequence_items', 'event_features', 'activity_features', 'state_ids', 'liked_states', 'disliked_states', 'state_counts', 'inference_user_rows', 'inference_liked_items', 'inference_disliked_items', 'inference_user_features']\nProcess Group PGID: 1863\n",
"isError": false
},
"responseMessageId": "9b0ccf17-e9ad-4516-afd6-356f1f169a29"
}
]
},
{
"id": 50,
"role": "agent",
"timestamp": "2026-09-29T02:17:40.915Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:17:40.915Z",
"callId": "run_shell_command__call_5230190",
"name": "run_shell_command",
"input": {
"description": "Check lengths vs history_training using offsets",
"command": "python3 -c \"\nimport numpy as np\ncache = np.load('/app/solution/validation_cache.npz')\noffsets = cache['offsets']\nlengths = offsets[1:] - offsets[:-1]\nprint('lengths min, mean, max:', lengths.min(), lengths.mean(), lengths.max())\ntotals = np.maximum(lengths - 1, 0)\nval_fraction = 0.10\nvalidation = np.floor(totals * val_fraction).astype(np.int64)\nvalidation[(totals >= 2) & (validation == 0)] = 1\nvalidation = np.minimum(validation, 16)\nhistory_training = totals - validation\nprint('history_training min, mean, max:', history_training.min(), history_training.mean(), history_training.max())\nprint('Difference lengths - history_training:', (lengths - history_training).min(), (lengths - history_training).max())\n\""
},
"recorded": {
"id": "run_shell_command__call_5230190",
"name": "run_shell_command",
"args": {
"description": "Check lengths vs history_training using offsets",
"command": "python3 -c \"\nimport numpy as np\ncache = np.load('/app/solution/validation_cache.npz')\noffsets = cache['offsets']\nlengths = offsets[1:] - offsets[:-1]\nprint('lengths min, mean, max:', lengths.min(), lengths.mean(), lengths.max())\ntotals = np.maximum(lengths - 1, 0)\nval_fraction = 0.10\nvalidation = np.floor(totals * val_fraction).astype(np.int64)\nvalidation[(totals >= 2) & (validation == 0)] = 1\nvalidation = np.minimum(validation, 16)\nhistory_training = totals - validation\nprint('history_training min, mean, max:', history_training.min(), history_training.mean(), history_training.max())\nprint('Difference lengths - history_training:', (lengths - history_training).min(), (lengths - history_training).max())\n\""
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5230190",
"name": "run_shell_command",
"response": {
"output": "\nOutput: lengths min, mean, max: 1 2195.5477832512315 25779\nhistory_training min, mean, max: 0 2180.3055281882866 25762\nDifference lengths - history_training: 1 17\nProcess Group PGID: 1873\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:17:41.304Z",
"resultDisplay": "lengths min, mean, max: 1 2195.5477832512315 25779\nhistory_training min, mean, max: 0 2180.3055281882866 25762\nDifference lengths - history_training: 1 17",
"description": "Check lengths vs history_training using offsets",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:17:41.306Z",
"content": "\nOutput: lengths min, mean, max: 1 2195.5477832512315 25779\nhistory_training min, mean, max: 0 2180.3055281882866 25762\nDifference lengths - history_training: 1 17\nProcess Group PGID: 1873\n",
"isError": false
},
"responseMessageId": "3506ecea-c4d9-4dbf-bd99-32ab6286eb0e"
}
]
},
{
"id": 51,
"role": "agent",
"timestamp": "2026-09-29T02:18:45.976Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.975Z",
"text": "Refining Sequence Logic\n\nI'm currently focused on the exact indexing for sequence lengths, ensuring they align correctly with validation counts and the chronological BCE suffix. This involves a precise mapping of T adjacent targets to sequence positions."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.975Z",
"text": "Revising Validation Logic\n\nI'm re-evaluating how validation data is excluded. It seems my previous indexing might be too broad, potentially filtering out necessary training targets. I'm now scrutinizing the offset and count logic to ensure only truly historical data is disregarded."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.975Z",
"text": "Clarifying Negative Sample Logic\n\nI'm analyzing how `known` and `invalid` flags interact to define negative samples. Specifically, I'm verifying that items encountered in `train_*` sequences are correctly excluded as candidates during inference, and how this impacts the training objective by ensuring past positive interactions aren't mistakenly penalized."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.975Z",
"text": "Analyzing Loss Function\n\nI'm dissecting the `corrected_negative_loss` function line by line. My focus is on how `logits` are transformed by `softplus` and how `uniform_negatives` and `inbatch_negatives` contribute to the final loss calculation, particularly the weighting and averaging mechanisms."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.975Z",
"text": "Analyzing Loss Contribution\n\nI'm detailing how uniform and in-batch negatives are aggregated. Specifically, I've noted how the `mean` for uniform negatives becomes a sum, and the in-batch negatives are a weighted average, both then scaled by their respective configuration weights before final averaging."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Adjusting Loss Gradients\n\nI've identified a critical discrepancy: the gradient for positive logits is 32 times larger than for any individual uniform negative logit. This imbalance likely stems from the division by two before averaging positive and negative losses. I'm considering adjustments to the loss calculation to rectify this."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Correcting Loss Scaling\n\nI'm realizing the negative loss is being averaged over 32 negatives, effectively giving each negative sample only 1/32nd of the weight of a single negative observation. This drastically imbalances gradients, pushing positive embeddings too hard while barely nudging negatives. I'm re-evaluating this scaling."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Investigating Popular Item Bias\n\nI'm hypothesizing that popular items are over-attracting positive embeddings and under-repelling negative ones due to gradient scaling. To test this, I'll analyze dot products of popular items with random queries and examine baseline model outputs for evidence of this drift."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Investigating Popular Item Bias\n\nMy analysis confirms a severe bias towards a small set of highly popular items, dominating top-10 slots and pushing truly personalized discoveries down the ranking. This directly undermines NDCG@10 by preventing relevant items from appearing within the scored range."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Addressing Popularity Bias\n\nI'm now analyzing how sampling and loss calculation contribute to popularity bias. My current focus is on the `corrected_negative_loss`, where popular items are significantly downweighted as negatives, receiving a much smaller penalty. Additionally, uniform negatives are not frequency-aware, and the overall negative loss scaling seems to amplify this issue."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Evaluating Sampling Strategies\n\nI am exploring different negative sampling techniques to mitigate popularity bias. My current focus is on whether to employ popularity-aware sampling, BPR, or a modified BCE loss, and I am verifying if architectural constraints permit these changes."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Refining Sampling Techniques\n\nI am currently evaluating popularity-aware sampling strategies and modified BCE loss functions to counteract the observed popularity bias. My primary concern is ensuring these adjustments are feasible within the existing CPU budget and architectural constraints, while also verifying their efficacy through the public backtest."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Analyzing Training Time\n\nI'm investigating the training epoch's duration, specifically the bottlenecks within `run_training_epoch`. I've identified the batch processing and the sheer volume of `max_train_targets_per_user` as significant contributors to the observed 210-second runtime."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Analyzing InfoNCE Gradient\n\nI'm examining the gradients derived from the InfoNCE loss. Specifically, I'm focused on how the probability distribution over positive and negative items, influenced by temperature scaling, dictates the magnitude and direction of gradient updates for item logits."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Testing Logit Correction\n\nI'm exploring the application of logit correction to InfoNCE, inspired by Google's Sampling-Bias-Corrected Two-Tower model. This involves adjusting negative logits based on their sampling distribution, aiming to refine gradient updates and potentially optimize NDCG@10. I'm reviewing the baseline's approach to in-batch negative correction for comparison."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Fixing Correction Logic\n\nI've identified a critical conceptual error in the implementation of propensity correction. It appears the correction was inverted, leading to rare items being overly penalized and popular items being immune to negative feedback. I'm now focused on rectifying this and exploring InfoNCE as an alternative."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Revising Correction Logic\n\nI've discovered my propensity correction was inverted, penalizing rare items too much and making popular items immune to negative feedback. I'm fixing this and now considering InfoNCE as a superior alternative."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Analyzing Loss Aggregation\n\nI'm reviewing how losses are aggregated and weighted. It appears positive and negative losses are averaged, then scaled by weights. I'm also examining how statistics like `pair_correct` are calculated and how `target_weighting` options might influence overall outcomes."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Analyzing Sequence Data\n\nI'm examining how sequence data is processed, specifically focusing on the `discovery_horizon_days` and `base.DAY` multiplication. I'm also scrutinizing how repeated items within a sequence are handled and weighted, ensuring they don't receive undue influence as novel discoveries."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Adjusting Target Weights\n\nI'm re-examining the target weighting system, noticing that \"grade-3\" novel organic likes within 7 days are assigned a weight of 3.0, while ordinary targets get 0.25. This strong weighting reflects the discovery objective, but I'm questioning why \"organic-strong\" was the default. I am now scrutinizing the negative sampling strategy as described."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Refining Sampling Logic\n\nI'm now scrutinizing the exact logic for drawing negatives, particularly `draw_full_history_filtered_negatives`. My focus is on how in-batch negatives are selected from unique targets, ensuring the count is correctly bounded and sampled efficiently."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Fixing In-Batch Negatives\n\nI've discovered that my implementation of in-batch negative sampling was fundamentally flawed. By taking unique targets and sampling uniformly from them, I wasn't actually performing in-batch negative sampling as intended. I am now correcting this logic."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Correcting In-Batch Sampling\n\nI've uncovered that my previous in-batch negative sampling logic was flawed. Sampling uniformly from unique targets meant popular items weren't favored, unlike the true popularity distribution. I am now correcting this to accurately reflect item frequencies within the batch."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Investigating Correction Inversion\n\nI'm questioning whether my prior implementation of inverse propensity weighting for in-batch negatives was inverted. It seems popular items are receiving significantly reduced negative loss, while rare items are penalized disproportionately, suggesting a potential inversion in my correction logic."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Understanding Correction Rationale\n\nI'm realizing that inverse propensity weighting for in-batch negatives is crucial to avoid learning lift instead of true probability. My prior correction logic was inverted, making popular items immune to negative penalties and penalizing rare items excessively. The goal is to learn $P(\\text{user likes item } i)$, not its lift over popularity."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Adjusting Popularity Correction\n\nI'm realizing my previous inverse propensity weighting for in-batch negatives was inverted, severely downweighting popular items. By setting `inbatch_correction_power` to 0.0, I'm effectively disabling this correction, allowing popular items to receive their appropriate negative penalty."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Revising Sampling Strategy\n\nI'm now examining the precise popularity distribution of the entire catalog, as items are pre-sorted by rank. This offers an opportunity to explore mixed negative sampling techniques, combining uniform and popularity-biased negatives, and to compare InfoNCE/Sampled Softmax against BCE within `score_target_microbatches`."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Analyzing Cross-Entropy Implementation\n\nI'm analyzing the `F.cross_entropy` function's application, noting that the positive item is implicitly treated as the target class at index 0. I'm examining how temperature scaling and selected weights then influence the final summed loss for optimization."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Analyzing Gradient Impact\n\nI'm examining how the scores of negative items influence gradient updates. High-scoring negatives receive substantial downward pushes, while low-scoring ones are largely ignored, meaning only \"hard\" negatives drive learning. Pair accuracy calculation remains consistent with previous methods."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:18:45.976Z",
"text": "Adjusting Logit Penalties\n\nI'm realizing that subtracting $\\log q$ from logits, as suggested by research, penalizes popular items more during training. This forces the model to learn exceptional affinity for these items. Interestingly, this correction is removed at serving time, eliminating popularity bias then.\n\n**Evaluating Loss Functions**\n\nI'm questioning if the evaluator's validation loss, specifically `evaluate_validation_bce`, is only used for early stopping. This would mean its specific implementation might not directly impact the final model's learned behavior beyond convergence criteria."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:18:45.976Z",
"callId": "run_shell_command__call_44924",
"name": "run_shell_command",
"input": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --output /app/solution/baseline_cached.parquet",
"description": "Test runtime with cached prepared data"
},
"recorded": {
"id": "run_shell_command__call_44924",
"name": "run_shell_command",
"args": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --output /app/solution/baseline_cached.parquet",
"description": "Test runtime with cached prepared data"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_44924",
"name": "run_shell_command",
"response": {
"output": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\ntarget weighting=organic-strong min=0.250 mean=0.575 max=1.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.547529 running_bce=0.541614 elapsed=195.6s\nepoch=1/1 train_loss=0.53984 validation_loss=0.49664 pair_accuracy=0.755 train_targets=1,052,953 validation_targets=130,103 train_seconds=208.6 validation_seconds=15.1\nrestored best validation-BCE checkpoint: epoch=1 loss=0.496636\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/baseline_cached.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 306.783,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5398380471836763,\n \"positive_logit\": 0.7427799628950514,\n \"negative_logit\": -0.6222247051825398,\n \"pair_accuracy\": 0.7547733612041563,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 632551.0,\n \"batches\": 266.0,\n \"seconds\": 208.59694292999984,\n \"validation_loss\": 0.49663621881443953,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 78769.25,\n \"validation_seconds\": 15.099420767000083\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.603016972541809,\n \"query_norm_std\": 0.7697497606277466,\n \"item_norm_mean\": 1.7570279836654663,\n \"item_norm_std\": 0.8279485702514648\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 1883\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:23:57.123Z",
"resultDisplay": "loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\ntarget weighting=organic-strong min=0.250 mean=0.575 max=1.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.547529 running_bce=0.541614 elapsed=195.6s\nepoch=1/1 train_loss=0.53984 validation_loss=0.49664 pair_accuracy=0.755 train_targets=1,052,953 validation_targets=130,103 train_seconds=208.6 validation_seconds=15.1\nrestored best validation-BCE checkpoint: epoch=1 loss=0.496636\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/baseline_cached.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 306.783,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5398380471836763,\n \"positive_logit\": 0.7427799628950514,\n \"negative_logit\": -0.6222247051825398,\n \"pair_accuracy\": 0.7547733612041563,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 632551.0,\n \"batches\": 266.0,\n \"seconds\": 208.59694292999984,\n \"validation_loss\": 0.49663621881443953,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 78769.25,\n \"validation_seconds\": 15.099420767000083\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.603016972541809,\n \"query_norm_std\": 0.7697497606277466,\n \"item_norm_mean\": 1.7570279836654663,\n \"item_norm_std\": 0.8279485702514648\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}",
"description": "Test runtime with cached prepared data",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:23:57.125Z",
"content": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\ntarget weighting=organic-strong min=0.250 mean=0.575 max=1.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.547529 running_bce=0.541614 elapsed=195.6s\nepoch=1/1 train_loss=0.53984 validation_loss=0.49664 pair_accuracy=0.755 train_targets=1,052,953 validation_targets=130,103 train_seconds=208.6 validation_seconds=15.1\nrestored best validation-BCE checkpoint: epoch=1 loss=0.496636\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/baseline_cached.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 306.783,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"organic-strong\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5398380471836763,\n \"positive_logit\": 0.7427799628950514,\n \"negative_logit\": -0.6222247051825398,\n \"pair_accuracy\": 0.7547733612041563,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 632551.0,\n \"batches\": 266.0,\n \"seconds\": 208.59694292999984,\n \"validation_loss\": 0.49663621881443953,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 78769.25,\n \"validation_seconds\": 15.099420767000083\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.603016972541809,\n \"query_norm_std\": 0.7697497606277466,\n \"item_norm_mean\": 1.7570279836654663,\n \"item_norm_std\": 0.8279485702514648\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 1883\n",
"isError": false
},
"responseMessageId": "9e04dbb4-af89-45ea-95f4-7e3a224ee9c1"
}
]
},
{
"id": 52,
"role": "agent",
"timestamp": "2026-09-29T02:24:28.764Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Evaluating Training Strategies\n\nMy focus has shifted to optimizing training time. I'm now assessing whether using a subset or the full dataset is more feasible within our remaining 45 minutes, considering each full run takes approximately five minutes."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Investigating Negatives\n\nI'm now delving into the specifics of negative sampling and loss functions. My current thoughts are centered on understanding the implications of `--target-weighting discovery-graded` and how negative sampling strategies impact performance."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Exploring Positives' Impact\n\nI'm now examining how positive training examples influence the model. Specifically, I'm analyzing the creation of `uniform` and `inbatch` negatives to understand their role in the overall training process and optimize their generation."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Refining In-Batch Negatives\n\nI've identified a crucial detail regarding `inbatch` negative sampling. It seems I was incorrectly using `torch.unique(targets)` instead of drawing from the actual targets present in the batch, excluding the user's own. This distinction is critical for accurate popularity-based negative sampling."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Correcting In-Batch Sampling\n\nI've realized my `inbatch` negative sampling isn't popularity-based as intended. The current method assigns equal probability to all unique targets in the batch, negating popularity bias. I'm now reviewing the `item_correction` function and related logic to implement the correct approach."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Adjusting Popularity Weights\n\nI've discovered how popularity weighting actually functions within `inbatch` negative sampling. It appears popular items receive lower correction weights (around 0.25) while rare items get much higher ones (up to 4.0), the opposite of my initial assumption. This significantly impacts how these negatives are utilized."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Revising Popularity Weights\n\nI'm reassessing the impact of item correction weights on gradients, specifically how low weights for popular items drastically diminish their influence. This seems counterintuitive and requires a deeper understanding of the original intent behind this weighting scheme."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Challenging Weighting Logic\n\nI'm questioning the core assumption behind weighting popular negative samples. It appears downweighting them by their inverse popularity cancels the very signal we aim to exploit—that popularity doesn't equate to user preference. This leads to popular items being incorrectly pulled towards user embeddings."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Investigating Ranking Anomalies\n\nI'm finding that highly popular items consistently score highest for all users during inference, regardless of individual preference. I’m now proposing to modify the negative sampling in `draw_full_history_filtered_negatives` to sample directly from targets, making it popularity-proportional, and to increase the sampling of in-batch or popularity-biased negatives."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Exploring Catalog Popularity\n\nI'm now considering sampling negatives directly from the catalog based on `positive_listens`, potentially using exponents like 0.5 or 0.75. This approach aims to select \"hard negatives\" by sampling items with high listen counts that the specific user hasn't interacted with."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Revising Loss Function\n\nI'm realizing InfoNCE is better suited for top-k retrieval than BCE, especially with averaged negatives. My current focus is understanding how `--target-weighting discovery-graded` might interact with this and if it offers a better approach for optimizing rankings."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:24:28.764Z",
"text": "Testing Discovery Grades\n\nI am now preparing to validate the impact of aligning target weights with discovery grades and adjusting negative sampling strategies. My plan involves testing `discovery-graded` weighting against current methods, evaluating different in-batch and popularity-based negative sampling ratios, and removing the inverted downweighting of popular negatives."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:24:28.764Z",
"callId": "run_shell_command__call_5767310",
"name": "run_shell_command",
"input": {
"description": "Train model with discovery-graded target weighting",
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --target-weighting discovery-graded \\\n --output /app/solution/exp1_discovery_graded.parquet"
},
"recorded": {
"id": "run_shell_command__call_5767310",
"name": "run_shell_command",
"args": {
"description": "Train model with discovery-graded target weighting",
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --target-weighting discovery-graded \\\n --output /app/solution/exp1_discovery_graded.parquet"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5767310",
"name": "run_shell_command",
"response": {
"output": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.551810 running_bce=0.544138 elapsed=196.4s\nepoch=1/1 train_loss=0.54212 validation_loss=0.50483 pair_accuracy=0.760 train_targets=1,052,953 validation_targets=130,103 train_seconds=209.5 validation_seconds=15.9\nrestored best validation-BCE checkpoint: epoch=1 loss=0.504831\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp1_discovery_graded.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 318.235,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5421154207001792,\n \"positive_logit\": 0.7774311408769176,\n \"negative_logit\": -0.6407561994245686,\n \"pair_accuracy\": 0.7602795720701684,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 209.5214277829998,\n \"validation_loss\": 0.5048305738154627,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 15.933567852999886\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.7521849870681763,\n \"query_norm_std\": 0.8638167977333069,\n \"item_norm_mean\": 1.8543914556503296,\n \"item_norm_std\": 0.8459439277648926\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 1908\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:29:51.373Z",
"resultDisplay": "loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.551810 running_bce=0.544138 elapsed=196.4s\nepoch=1/1 train_loss=0.54212 validation_loss=0.50483 pair_accuracy=0.760 train_targets=1,052,953 validation_targets=130,103 train_seconds=209.5 validation_seconds=15.9\nrestored best validation-BCE checkpoint: epoch=1 loss=0.504831\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp1_discovery_graded.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 318.235,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5421154207001792,\n \"positive_logit\": 0.7774311408769176,\n \"negative_logit\": -0.6407561994245686,\n \"pair_accuracy\": 0.7602795720701684,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 209.5214277829998,\n \"validation_loss\": 0.5048305738154627,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 15.933567852999886\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.7521849870681763,\n \"query_norm_std\": 0.8638167977333069,\n \"item_norm_mean\": 1.8543914556503296,\n \"item_norm_std\": 0.8459439277648926\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}",
"description": "Train model with discovery-graded target weighting",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:29:51.375Z",
"content": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.551810 running_bce=0.544138 elapsed=196.4s\nepoch=1/1 train_loss=0.54212 validation_loss=0.50483 pair_accuracy=0.760 train_targets=1,052,953 validation_targets=130,103 train_seconds=209.5 validation_seconds=15.9\nrestored best validation-BCE checkpoint: epoch=1 loss=0.504831\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp1_discovery_graded.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 318.235,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5421154207001792,\n \"positive_logit\": 0.7774311408769176,\n \"negative_logit\": -0.6407561994245686,\n \"pair_accuracy\": 0.7602795720701684,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 209.5214277829998,\n \"validation_loss\": 0.5048305738154627,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 15.933567852999886\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.7521849870681763,\n \"query_norm_std\": 0.8638167977333069,\n \"item_norm_mean\": 1.8543914556503296,\n \"item_norm_std\": 0.8459439277648926\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 1908\n",
"isError": false
},
"responseMessageId": "117bd72e-2df9-4590-bba4-531d75df4952"
}
]
},
{
"id": 53,
"role": "agent",
"timestamp": "2026-09-29T02:29:56.146Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:29:56.146Z",
"callId": "run_shell_command__call_5909624",
"name": "run_shell_command",
"input": {
"description": "Evaluate discovery-graded validation ranking",
"command": "python3 /task/evaluate_public.py /app/solution/exp1_discovery_graded.parquet"
},
"recorded": {
"id": "run_shell_command__call_5909624",
"name": "run_shell_command",
"args": {
"description": "Evaluate discovery-graded validation ranking",
"command": "python3 /task/evaluate_public.py /app/solution/exp1_discovery_graded.parquet"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5909624",
"name": "run_shell_command",
"response": {
"output": "\nOutput: {\n \"model\": \"/app/solution/exp1_discovery_graded.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.023522,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 1939\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:29:59.491Z",
"resultDisplay": "{\n \"model\": \"/app/solution/exp1_discovery_graded.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.023522,\n \"quality_users\": 4263\n }\n}",
"description": "python3 /task/evaluate_public.py /app/solution/exp1_discovery_graded.parquet",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:29:59.493Z",
"content": "\nOutput: {\n \"model\": \"/app/solution/exp1_discovery_graded.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.023522,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 1939\n",
"isError": false
},
"responseMessageId": "fc729150-900e-4032-9f90-d8a9f8a2078d"
}
]
},
{
"id": 54,
"role": "agent",
"timestamp": "2026-09-29T02:30:02.202Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:30:02.202Z",
"text": "Investigating Recommendation Impact\n\nMy latest findings show a promising 10.5% gain in quality_ndcg@10 after implementing `--target-weighting discovery-graded`. I'm now analyzing the actual recommendations to assess if this improvement came at the cost of increased popularity bias."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:30:02.202Z",
"callId": "run_shell_command__call_2234",
"name": "run_shell_command",
"input": {
"description": "Check recommended item frequency",
"command": "python3 -c \"\nimport pandas as pd\ndf = pd.read_parquet('/app/solution/exp1_discovery_graded.parquet')\nprint('Top 10 recommended items frequency:')\nprint(df[df['rank'] <= 10].item_id.value_counts().head(10))\nprint('Unique items in top 10:', df[df['rank'] <= 10].item_id.nunique())\n\""
},
"recorded": {
"id": "run_shell_command__call_2234",
"name": "run_shell_command",
"args": {
"description": "Check recommended item frequency",
"command": "python3 -c \"\nimport pandas as pd\ndf = pd.read_parquet('/app/solution/exp1_discovery_graded.parquet')\nprint('Top 10 recommended items frequency:')\nprint(df[df['rank'] <= 10].item_id.value_counts().head(10))\nprint('Unique items in top 10:', df[df['rank'] <= 10].item_id.nunique())\n\""
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_2234",
"name": "run_shell_command",
"response": {
"output": "\nOutput: Top 10 recommended items frequency:\nitem_id\n8722394 2676\n5436843 2651\n6006390 2590\n8743390 2280\n8213481 2245\n6896222 2056\n3542184 2046\n5862961 1996\n2651314 1909\n2185191 1808\nName: count, dtype: int64\nUnique items in top 10: 632\nProcess Group PGID: 1959\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:30:03.770Z",
"resultDisplay": "Top 10 recommended items frequency:\nitem_id\n8722394 2676\n5436843 2651\n6006390 2590\n8743390 2280\n8213481 2245\n6896222 2056\n3542184 2046\n5862961 1996\n2651314 1909\n2185191 1808\nName: count, dtype: int64\nUnique items in top 10: 632",
"description": "Check recommended item frequency",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:30:03.772Z",
"content": "\nOutput: Top 10 recommended items frequency:\nitem_id\n8722394 2676\n5436843 2651\n6006390 2590\n8743390 2280\n8213481 2245\n6896222 2056\n3542184 2046\n5862961 1996\n2651314 1909\n2185191 1808\nName: count, dtype: int64\nUnique items in top 10: 632\nProcess Group PGID: 1959\n",
"isError": false
},
"responseMessageId": "ead58e64-2b28-4cc8-b37f-60ffdce31617"
}
]
},
{
"id": 55,
"role": "agent",
"timestamp": "2026-09-29T02:30:22.738Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:30:22.738Z",
"text": "Addressing Popularity Bias\n\nMy current focus is on eradicating the persistent popularity bias, as the same few items continue to dominate recommendations across a vast user base. My next step involves a thorough investigation into the negative sampling strategies and the associated loss objective function."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:30:22.738Z",
"text": "Investigating Negative Sampling\n\nI'm exploring how sampling negative items might be contributing to popularity bias. Specifically, I'm considering whether sampling directly from the batch's positive targets, which are inherently skewed towards popular items, exacerbates the problem, and I'm examining the implications of incorporating overall catalog popularity into this process."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:30:22.738Z",
"text": "Exploring Catalog Popularity Sampling\n\nI'm now considering sampling negatives proportionally to catalog popularity, potentially using $P(i) \\propto (\\text{positive\\_listens}_i)^\\alpha$ with $\\alpha$ between 0.5 and 1.0. This approach could ensure popular items are evaluated against all users, driving more accurate recommendations by penalizing non-interactions with top tracks."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:30:22.738Z",
"text": "Revising Negative Sampling\n\nI'm now scrutinizing the loss function's impact, specifically questioning the downweighting of popular negative items and the division by 32. My next steps involve testing modifications like setting weights to 1.0 and exploring alternative loss formulations such as InfoNCE."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:30:22.738Z",
"text": "Refining Loss Formulation\n\nI'm now diving into the specifics of InfoNCE loss, particularly the crucial temperature parameter ($\\tau$). The baseline's small logit difference suggests saturation with BCE, and I'm exploring how $\\tau=1.0$ might behave in this new loss context."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:30:22.738Z",
"text": "Adjusting Temperature Parameter\n\nI'm now focusing on the temperature parameter ($\\tau$) within the InfoNCE loss. Exploring values like $0.1$ or $0.2$ seems crucial for managing the softmax distribution and potentially overcoming the saturation observed with BCE loss, especially given typical values in similar models."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:30:22.738Z",
"text": "Testing Negative Sampling Variations\n\nI'm now planning several experiments to isolate the impact of negative sampling strategies. This includes varying the proportion of in-batch versus uniformly sampled negatives, exploring direct sampling from `targets`, and testing the effect of setting `inbatch_correction_power` to zero to equalize weights."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:30:22.738Z",
"callId": "read_file__call_3476",
"name": "read_file",
"input": {
"file_path": "/app/solution/train_current_model.py",
"start_line": 630,
"end_line": 720
},
"recorded": {
"id": "read_file__call_3476",
"name": "read_file",
"args": {
"file_path": "/app/solution/train_current_model.py",
"start_line": 630,
"end_line": 720
},
"result": [
{
"functionResponse": {
"id": "read_file__call_3476",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 630-720 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 721.\n\n--- FILE CONTENT (truncated) ---\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:30:22.744Z",
"resultDisplay": "Read lines 630-720 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:30:22.746Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 630-720 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 721.\n\n--- FILE CONTENT (truncated) ---\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),",
"isError": false
},
"responseMessageId": "cbf03754-b731-49dc-9753-c761e5293900"
}
]
},
{
"id": 56,
"role": "agent",
"timestamp": "2026-09-29T02:31:00.212Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Refining negative sampling\n\nI'm currently examining lines 645-667, specifically how unique targets are identified and the subsequent correction of negative sample counts. This adjustment appears crucial for maintaining a balanced training set."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Optimizing sampling logic\n\nI'm re-evaluating the efficiency of sampling, particularly concerning large matrices. My focus is now on directly sampling from `targets_cpu` rather than generating and then selecting from a massive `priorities` tensor."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Exploring catalog popularity\n\nI'm now considering supplementing in-batch negative sampling by drawing from overall catalog popularity. This involves precomputing a multinomial distribution based on listen counts, potentially weighted by $\\alpha$, to introduce diverse negatives even when popular items aren't present in the current batch. This approach offers significant speedups and flexibility."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Integrating catalog popularity\n\nI'm now exploring how to incorporate catalog popularity into negative sampling. The key insight is that in-batch negatives already reflect empirical data popularity. I'm investigating whether adding catalog popularity on top is beneficial or redundant."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Analyzing correction weighting\n\nI'm scrutinizing the `corrected_negative_loss` function. I've realized the denominator `weights.sum(dim=1)` simplifies to the in-batch negative count when the correction is uniform. This implies that when `inbatch_correction_power` is zero, the term becomes a simple mean of raw logits.\n\n**Investigating loss calculation**\n\nI'm now questioning the calculation of the negative loss term. Specifically, I'm examining the division by `weights.sum(dim=1)`. If `weights` are uniform, this results in the mean of the raw logits for the selected in-batch negatives.\n\n**Probing loss formulation**\n\nI'm deeply analyzing the negative loss formulation. My current focus is on the impact of `weights.sum(dim=1)` in the denominator. It appears that when weights are uniform, this simplifies to the count of in-batch negatives, leading to an average rather than a sum.\n\n**Evaluating loss averaging**\n\nI'm now considering the implications of averaging the negative loss. The current implementation, with `weights.sum(dim=1)` in the denominator, suggests an average is being calculated when weights are uniform, not a sum.\n\n**Testing alternative loss metrics**\n\nI'm actively exploring alternative loss metrics, specifically InfoNCE and Sampled Softmax, as potential replacements or improvements to the current negative sampling strategy."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Testing InfoNCE Loss\n\nI'm now investigating the potential integration of the InfoNCE loss function. My current focus is on how this would affect the gradient calculations within `score_target_microbatches` and whether it offers a viable alternative to the existing BCE-based approach."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Confirming gradient flow\n\nI've confirmed that `query_vectors` and `all_logits` are differentiable via `F.cross_entropy`. Item vectors are also differentiable. Statistics aggregation appears to be correctly implemented using `.detach().cpu()`. I'm investigating the implications of `backward=False` in `evaluate_validation_bce` when using InfoNCE."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Adjusting InfoNCE Correction\n\nI'm now reconsidering how sampling bias correction impacts InfoNCE. Subtracting $\\log Q(i)$ effectively boosts logits for rarer items more than popular ones, potentially forcing the model to produce higher raw scores for less frequent items."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Revising correction logic\n\nI'm revisiting the impact of $\\log Q(i)$ subtraction for InfoNCE. It seems my previous reasoning was inverted; this correction actually boosts logits for less frequent items, potentially requiring higher raw scores for them, which needs careful verification against retrieval logic."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Analyzing InfoNCE bias\n\nI'm scrutinizing how popular items impact InfoNCE. The current understanding is that even with popular negatives present, the model is *forced* to score the positive item higher than these negatives, not just assign high scores universally, which is a critical distinction I need to test."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Revising InfoNCE Bias\n\nI'm now deeply examining how the $\\log Q(i)$ bias correction affects InfoNCE. My current hypothesis is that this correction actually elevates scores for less frequent items, a detail I need to rigorously validate against retrieval principles."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Refining sampling approach\n\nI'm now directly sampling in-batch negatives from `targets_cpu` for improved efficiency, noting its elegant simplicity. I've also identified a critical edge case where a sampled negative could be the positive target itself, and confirmed that subsequent filtering logic correctly handles these invalid samples."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Sampling efficiently\n\nI'm now directly sampling in-batch negatives from `targets_cpu`, bypassing inefficient matrix operations. I've also confirmed that the logic correctly filters out invalid negatives, such as the target itself or duplicates, and efficiently replaces them. This approach runs exceptionally fast, achieving sub-millisecond execution times."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Testing InfoNCE Implementation\n\nI'm now focused on the InfoNCE loss implementation, specifically how it interacts with temperature scaling and the `F.cross_entropy` function. I've also confirmed that the `sample_weights` are correctly applied to the calculated `sample_loss` before summing."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Analyzing InfoNCE Dominance\n\nI'm delving into why InfoNCE excels in recommendation retrieval compared to BCE. It appears InfoNCE naturally optimizes for the relative ordering of scores, crucial for top-k ranking, whereas BCE focuses on independent probabilities and doesn't inherently enforce score margins."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Testing InfoNCE parameters\n\nI'm now exploring optimal parameters for InfoNCE, specifically temperature and the number of in-batch versus uniform negatives. The goal is to leverage InfoNCE's strength in relative score ordering, and I'm investigating how different negative sampling configurations impact its performance and stability."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:00.212Z",
"text": "Evaluating sampling distribution\n\nI am reassessing the distribution of negatives. I now realize that `targets_cpu` inherently reflects empirical popularity due to user listening habits. Therefore, sampling from `targets_cpu` is effectively empirical popularity sampling. I am now questioning the necessity of additional popularity-based negatives."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:31:00.212Z",
"callId": "update_topic__call_132616",
"name": "update_topic",
"input": {
"summary": "In our diagnosis, we identified three fatal flaws in the baseline: 1) in-batch negatives were flattened via torch.unique destroying popularity frequency; 2) item_correction multiplied the negative BCE loss of popular items by 0.25 while scaling rare items to 4.0, making popular tracks immune to negative feedback; 3) BCE with averaged negative loss failed to penalize hard negatives, causing extreme popularity bias. We also verified that discovery-graded target weighting gave an initial boost to 0.0235. Now we will implement true in-batch sampling, unweighted negatives, and InfoNCE loss in train_current_model.py.",
"strategic_intent": "Implement true in-batch negative sampling, remove negative downweighting, add InfoNCE loss, and validate retrieval quality.",
"title": "Implementing Negative Sampling and InfoNCE Improvements"
},
"recorded": {
"id": "update_topic__call_132616",
"name": "update_topic",
"args": {
"summary": "In our diagnosis, we identified three fatal flaws in the baseline: 1) in-batch negatives were flattened via torch.unique destroying popularity frequency; 2) item_correction multiplied the negative BCE loss of popular items by 0.25 while scaling rare items to 4.0, making popular tracks immune to negative feedback; 3) BCE with averaged negative loss failed to penalize hard negatives, causing extreme popularity bias. We also verified that discovery-graded target weighting gave an initial boost to 0.0235. Now we will implement true in-batch sampling, unweighted negatives, and InfoNCE loss in train_current_model.py.",
"strategic_intent": "Implement true in-batch negative sampling, remove negative downweighting, add InfoNCE loss, and validate retrieval quality.",
"title": "Implementing Negative Sampling and InfoNCE Improvements"
},
"result": [
{
"functionResponse": {
"id": "update_topic__call_132616",
"name": "update_topic",
"response": {
"output": "Current topic: \"Implementing Negative Sampling and InfoNCE Improvements\"\nTopic summary: In our diagnosis, we identified three fatal flaws in the baseline: 1) in-batch negatives were flattened via torch.unique destroying popularity frequency; 2) item_correction multiplied the negative BCE loss of popular items by 0.25 while scaling rare items to 4.0, making popular tracks immune to negative feedback; 3) BCE with averaged negative loss failed to penalize hard negatives, causing extreme popularity bias. We also verified that discovery-graded target weighting gave an initial boost to 0.0235. Now we will implement true in-batch sampling, unweighted negatives, and InfoNCE loss in train_current_model.py.\n\nStrategic Intent: Implement true in-batch negative sampling, remove negative downweighting, add InfoNCE loss, and validate retrieval quality."
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:31:00.214Z",
"resultDisplay": "## 📂 Topic: **Implementing Negative Sampling and InfoNCE Improvements**\n\n**Summary:**\nIn our diagnosis, we identified three fatal flaws in the baseline: 1) in-batch negatives were flattened via torch.unique destroying popularity frequency; 2) item_correction multiplied the negative BCE loss of popular items by 0.25 while scaling rare items to 4.0, making popular tracks immune to negative feedback; 3) BCE with averaged negative loss failed to penalize hard negatives, causing extreme popularity bias. We also verified that discovery-graded target weighting gave an initial boost to 0.0235. Now we will implement true in-batch sampling, unweighted negatives, and InfoNCE loss in train_current_model.py.\n\n> [!STRATEGY]\n> **Intent:** Implement true in-batch negative sampling, remove negative downweighting, add InfoNCE loss, and validate retrieval quality.",
"description": "Update topic to: \"Implementing Negative Sampling and InfoNCE Improvements\"",
"displayName": "Update Topic Context",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:31:00.216Z",
"content": "Current topic: \"Implementing Negative Sampling and InfoNCE Improvements\"\nTopic summary: In our diagnosis, we identified three fatal flaws in the baseline: 1) in-batch negatives were flattened via torch.unique destroying popularity frequency; 2) item_correction multiplied the negative BCE loss of popular items by 0.25 while scaling rare items to 4.0, making popular tracks immune to negative feedback; 3) BCE with averaged negative loss failed to penalize hard negatives, causing extreme popularity bias. We also verified that discovery-graded target weighting gave an initial boost to 0.0235. Now we will implement true in-batch sampling, unweighted negatives, and InfoNCE loss in train_current_model.py.\n\nStrategic Intent: Implement true in-batch negative sampling, remove negative downweighting, add InfoNCE loss, and validate retrieval quality.",
"isError": false
},
"responseMessageId": "b88fea37-6beb-4e96-b8ee-d94a447e1b3a"
}
]
},
{
"id": 57,
"role": "agent",
"timestamp": "2026-09-29T02:31:19.010Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:19.010Z",
"text": "Investigating Training Configuration\n\nI'm currently examining the `Config` class within `train_current_model.py`. My focus is on understanding the available fields, particularly `bptt_steps` and `user_batch_size`, to better grasp the training setup."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:19.010Z",
"text": "Analyzing Model Parameters\n\nI'm now reviewing the specific numerical parameters within the configuration, such as `embedding_dim`, `hidden_dim`, and various `_hidden` sizes. I'm also noting the values for `epochs`, `learning_rate`, and gradient-related settings."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:19.010Z",
"text": "Configuring Loss Parameters\n\nI'm now extending the `Config` class with `loss_type` and `temperature` fields. I'll then integrate these, along with `uniform_negatives`, `inbatch_negatives`, and `inbatch_correction_power`, as configurable CLI flags within `argparse`. I'm also cross-referencing existing default values and their implications."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:19.010Z",
"text": "Exploring Negative Sampling\n\nI am currently investigating the `draw_full_history_filtered_negatives` function. My focus is on understanding its implementation and how it interacts with configurable flags to generate negative samples for training, specifically examining lines 630-715."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:19.010Z",
"text": "Refining Negative Sampling Logic\n\nI'm now focused on refining the `inbatch_negatives` logic. Specifically, I'm analyzing how `corrected_count` is determined and how `torch.topk` is used to select negative samples when `inbatch_negatives` is enabled, ensuring proper generation of both corrected and filler negatives."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:19.010Z",
"text": "Adjusting Negative Sampling\n\nI'm now re-evaluating the `inbatch` negative sampling when the `batch_size` is 1. I'm considering how to handle `targets_cpu` with only a single element to avoid issues with `torch.randint` when generating random indices for negative samples."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:19.010Z",
"text": "Validating Correction Logic\n\nI'm confirming that picking index 0, the target itself, gets correctly flagged as invalid and replaced with a uniform random item. I'm also verifying the behavior when `inbatch_correction_power` is 0.0 or greater, ensuring the `item_correction` logic handles all cases."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:19.010Z",
"text": "Verifying Loss Computation\n\nI am now scrutinizing the `loss_sum` calculation, ensuring its numerical stability and verifying the gradient propagation. I'm also checking the aggregation of statistics for positive, negative, and overall loss, as well as the pair correctness metric."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:19.010Z",
"text": "Calculating Loss Values\n\nI am now verifying the loss calculations based on the provided code snippets. I'm specifically examining the `infonce` loss computation using `F.cross_entropy` and the alternative loss calculation involving `F.softplus` and `corrected_negative_loss`, ensuring the correct application of weights and scaling."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:19.010Z",
"text": "Reviewing Two-Tower Model\n\nI'm now examining the `two_tower_model.py` file. My focus is on identifying any dependencies or definitions it provides that are utilized by the current training logic, particularly concerning negative sampling strategies beyond the default."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:31:19.010Z",
"callId": "read_file__call_68806",
"name": "read_file",
"input": {
"start_line": 40,
"file_path": "/app/solution/train_current_model.py",
"end_line": 75
},
"recorded": {
"id": "read_file__call_68806",
"name": "read_file",
"args": {
"start_line": 40,
"file_path": "/app/solution/train_current_model.py",
"end_line": 75
},
"result": [
{
"functionResponse": {
"id": "read_file__call_68806",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 40-75 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 76.\n\n--- FILE CONTENT (truncated) ---\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"organic-strong\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n seed: int = 29\n\n\n@dataclass(frozen=True)"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:31:19.015Z",
"resultDisplay": "Read lines 40-75 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:31:19.017Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 40-75 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 76.\n\n--- FILE CONTENT (truncated) ---\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"organic-strong\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n seed: int = 29\n\n\n@dataclass(frozen=True)",
"isError": false
},
"responseMessageId": "de161787-ecac-43a1-9179-94ad59486e54"
}
]
},
{
"id": 58,
"role": "agent",
"timestamp": "2026-09-29T02:31:21.874Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:21.874Z",
"text": "Exploring Configuration Options\n\nI'm currently examining the `Config` section, specifically looking at `loss_type` and `temperature`, and comparing them against default settings for `target_weighting`, `uniform_negatives`, `inbatch_negatives`, and `inbatch_correction_power`."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:31:21.874Z",
"callId": "read_file__call_3195302",
"name": "read_file",
"input": {
"end_line": 680,
"start_line": 630,
"file_path": "/app/solution/train_current_model.py"
},
"recorded": {
"id": "read_file__call_3195302",
"name": "read_file",
"args": {
"end_line": 680,
"start_line": 630,
"file_path": "/app/solution/train_current_model.py"
},
"result": [
{
"functionResponse": {
"id": "read_file__call_3195302",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 630-680 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 681.\n\n--- FILE CONTENT (truncated) ---\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:31:21.879Z",
"resultDisplay": "Read lines 630-680 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:31:21.881Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 630-680 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 681.\n\n--- FILE CONTENT (truncated) ---\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n",
"isError": false
},
"responseMessageId": "6bb33b18-09a1-4d6c-aa9f-ac6a49cdfb8b"
}
]
},
{
"id": 59,
"role": "agent",
"timestamp": "2026-09-29T02:31:27.860Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:27.860Z",
"text": "Refining Negative Sampling\n\nI'm currently focused on optimizing the in-batch negative sampling strategy within `draw_full_history_filtered_negatives`. My aim is to efficiently generate `batch_size` random indices for each of the `config.inbatch_negatives` samples, ensuring we leverage the full batch for contrastive learning."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:27.860Z",
"text": "Improving Negative Sampling Logic\n\nI'm reviewing the generation of in-batch negatives. It appears `targets_cpu` should indeed be indexed by randomly generated indices to form `inbatch`, which then gets concatenated with uniform negatives. I'm checking if `correction` is applied correctly to these in-batch negatives based on `item_correction`."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:31:27.860Z",
"callId": "read_file__call_44786",
"name": "read_file",
"input": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 1195,
"start_line": 1160
},
"recorded": {
"id": "read_file__call_44786",
"name": "read_file",
"args": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 1195,
"start_line": 1160
},
"result": [
{
"functionResponse": {
"id": "read_file__call_44786",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1160-1195 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1196.\n\n--- FILE CONTENT (truncated) ---\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:31:27.865Z",
"resultDisplay": "Read lines 1160-1195 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:31:27.866Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1160-1195 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1196.\n\n--- FILE CONTENT (truncated) ---\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient",
"isError": false
},
"responseMessageId": "5757113c-1c06-4d0d-8a32-b4f878e4e0c8"
}
]
},
{
"id": 60,
"role": "agent",
"timestamp": "2026-09-29T02:31:33.038Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:33.038Z",
"text": "Refining Logit Calculation\n\nI'm currently examining the `score_target_microbatches` function, specifically how the positive and negative logits are being computed. My focus is on the `torch.einsum` operation for the negative logits to ensure its efficiency and correctness in handling the batch and dimension interactions."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:33.038Z",
"text": "Analyzing Loss Calculations\n\nI've been digging into the `infonce` and other `loss_type` calculations within `score_target_microbatches`. My current focus is on ensuring the `torch.einsum` for negative logits and the subsequent `F.cross_entropy` and `F.softplus` operations are correctly implemented and efficient. I'll now transition to reviewing `argparse` in `main()` to confirm our configuration parameters are being handled as expected."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:31:33.038Z",
"callId": "read_file__call_37729",
"name": "read_file",
"input": {
"start_line": 1940,
"end_line": 2010,
"file_path": "/app/solution/train_current_model.py"
},
"recorded": {
"id": "read_file__call_37729",
"name": "read_file",
"args": {
"start_line": 1940,
"end_line": 2010,
"file_path": "/app/solution/train_current_model.py"
},
"result": [
{
"functionResponse": {
"id": "read_file__call_37729",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1940-2010 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 2011.\n\n--- FILE CONTENT (truncated) ---\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:31:33.043Z",
"resultDisplay": "Read lines 1940-2010 of 2165 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:31:33.045Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1940-2010 of 2165 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 2011.\n\n--- FILE CONTENT (truncated) ---\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1",
"isError": false
},
"responseMessageId": "19f8495f-22bc-4315-8629-147626d9c528"
}
]
},
{
"id": 61,
"role": "agent",
"timestamp": "2026-09-29T02:31:44.830Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:44.830Z",
"text": "Implementing Argument Addition\n\nI'm currently focused on integrating new parser arguments into the `main()` function. My latest work involves adding the `--uniform-negatives` argument, specifying its type as `int` and setting its default value."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:44.830Z",
"text": "Adding More Arguments\n\nI've now incorporated `--inbatch-negatives`, `--loss-type`, `--temperature`, and `--inbatch-correction-power` into the parser. Additionally, I've implemented validation logic within `main()` for these and other related arguments, ensuring the `Config` object is populated correctly. I'm also reviewing how checkpoint resumption handles configuration comparison."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:44.830Z",
"text": "Verifying Argument Impact\n\nI'm reviewing how my recently added parser arguments, specifically those related to negative sampling and model architecture, actually influence the `train_model` function. My current focus is on ensuring that changes in `architecture_fields` correctly update the `TowerConfig` object when `model_config` is called."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:44.830Z",
"text": "Updating Sampling Logic\n\nI'm ensuring consistency by updating the in-batch sampling logic in `two_tower_model.py` to align with recent additions. I'll then apply this change using the `replace` tool across relevant files, carefully avoiding duplicate edits to any single file as per the tool's rules."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:31:44.830Z",
"callId": "replace__call_56570",
"name": "replace",
"input": {
"old_string": " uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)",
"allow_multiple": false,
"new_string": " uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count",
"file_path": "/app/solution/two_tower_model.py",
"instruction": "Update inbatch negative sampling in draw_filtered_mixed_negatives to sample directly from batch targets instead of uniform sampling from unique targets"
},
"recorded": {
"id": "replace__call_56570",
"name": "replace",
"args": {
"old_string": " uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)",
"allow_multiple": false,
"new_string": " uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count",
"file_path": "/app/solution/two_tower_model.py",
"instruction": "Update inbatch negative sampling in draw_filtered_mixed_negatives to sample directly from batch targets instead of uniform sampling from unique targets"
},
"result": [
{
"functionResponse": {
"id": "replace__call_56570",
"name": "replace",
"response": {
"error": "EACCES: permission denied, open '/app/solution/two_tower_model.py'"
}
}
}
],
"status": "error",
"timestamp": "2026-09-29T02:31:44.837Z",
"resultDisplay": "Error writing file: EACCES: permission denied, open '/app/solution/two_tower_model.py'",
"description": "Replaces text within a file. By default, the tool expects to find and replace exactly ONE occurrence of `old_string`. If you want to replace multiple occurrences of the exact same string, set `allow_multiple` to true. This tool requires providing significant context around the change to ensure precise targeting. Always use the read_file tool to examine the file's current content before attempting a text replacement.\n \n The user has the ability to modify the `new_string` content. If modified, this will be stated in the response.\n \n Expectation for required parameters:\n 1. `old_string` MUST be the exact literal text to replace (including all whitespace, indentation, newlines, and surrounding code etc.).\n 2. `new_string` MUST be the exact literal text to replace `old_string` with (also including all whitespace, indentation, newlines, and surrounding code etc.). Ensure the resulting code is correct and idiomatic and that `old_string` and `new_string` are different.\n 3. `instruction` is the detailed instruction of what needs to be changed. It is important to Make it specific and detailed so developers or large language models can understand what needs to be changed and perform the changes on their own if necessary. \n 4. NEVER escape `old_string` or `new_string`, that would break the exact literal text requirement.\n **Important:** If ANY of the above are not satisfied, the tool will fail. CRITICAL for `old_string`: Must uniquely identify the instance(s) to change. Include at least 3 lines of context BEFORE and AFTER the target text, matching whitespace and indentation precisely. If this string matches multiple locations and `allow_multiple` is not true, the tool will fail.\n 5. Prefer to break down complex and long changes into multiple smaller atomic calls to this tool. Always check the content of the file after changes or not finding a string to match.\n **Multiple replacements:** Set `allow_multiple` to true if you want to replace ALL occurrences that match `old_string` exactly.",
"displayName": "Edit",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:31:47.110Z",
"content": "EACCES: permission denied, open '/app/solution/two_tower_model.py'",
"isError": true
},
"responseMessageId": "1fbfa6af-190b-4288-92e4-9b75e114b736"
}
]
},
{
"id": 62,
"role": "agent",
"timestamp": "2026-09-29T02:31:50.264Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:31:50.264Z",
"text": "Investigating Permissions\n\nIt appears I'm encountering a permission issue with `two_tower_model.py`. I need to investigate the file's current permissions to understand why access is being denied, especially considering the recent copy operation from `/task/current_model/`."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:31:50.264Z",
"callId": "run_shell_command__call_1445791",
"name": "run_shell_command",
"input": {
"command": "ls -la /app/solution/",
"description": "Check permissions in /app/solution"
},
"recorded": {
"id": "run_shell_command__call_1445791",
"name": "run_shell_command",
"args": {
"command": "ls -la /app/solution/",
"description": "Check permissions in /app/solution"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_1445791",
"name": "run_shell_command",
"response": {
"output": "\nOutput: total 526448\ndrwxr-xr-x 1 agent agent 4096 Sep 29 02:29 .\ndrwxr-xr-x 1 agent agent 4096 Sep 29 02:01 ..\n-rw-r--r-- 1 agent agent 1244227 Sep 29 02:23 baseline_cached.parquet\n-rw-r--r-- 1 agent agent 1249069 Sep 29 02:29 exp1_discovery_graded.parquet\n-rw-r--r-- 1 agent agent 1244230 Sep 29 02:11 production_validation.parquet\n-r--r--r-- 1 agent agent 80058 Sep 29 02:05 train_current_model.py\n-r--r--r-- 1 agent agent 15985 Sep 29 02:05 two_tower_model.py\n-rw-r--r-- 1 agent agent 535225808 Sep 29 02:13 validation_cache.npz\nProcess Group PGID: 1978\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:31:50.279Z",
"resultDisplay": "total 526448\ndrwxr-xr-x 1 agent agent 4096 Sep 29 02:29 .\ndrwxr-xr-x 1 agent agent 4096 Sep 29 02:01 ..\n-rw-r--r-- 1 agent agent 1244227 Sep 29 02:23 baseline_cached.parquet\n-rw-r--r-- 1 agent agent 1249069 Sep 29 02:29 exp1_discovery_graded.parquet\n-rw-r--r-- 1 agent agent 1244230 Sep 29 02:11 production_validation.parquet\n-r--r--r-- 1 agent agent 80058 Sep 29 02:05 train_current_model.py\n-r--r--r-- 1 agent agent 15985 Sep 29 02:05 two_tower_model.py\n-rw-r--r-- 1 agent agent 535225808 Sep 29 02:13 validation_cache.npz",
"description": "ls -la /app/solution/",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:31:50.281Z",
"content": "\nOutput: total 526448\ndrwxr-xr-x 1 agent agent 4096 Sep 29 02:29 .\ndrwxr-xr-x 1 agent agent 4096 Sep 29 02:01 ..\n-rw-r--r-- 1 agent agent 1244227 Sep 29 02:23 baseline_cached.parquet\n-rw-r--r-- 1 agent agent 1249069 Sep 29 02:29 exp1_discovery_graded.parquet\n-rw-r--r-- 1 agent agent 1244230 Sep 29 02:11 production_validation.parquet\n-r--r--r-- 1 agent agent 80058 Sep 29 02:05 train_current_model.py\n-r--r--r-- 1 agent agent 15985 Sep 29 02:05 two_tower_model.py\n-rw-r--r-- 1 agent agent 535225808 Sep 29 02:13 validation_cache.npz\nProcess Group PGID: 1978\n",
"isError": false
},
"responseMessageId": "47777600-4b7d-41dd-92c4-2d15d96ca6b2"
}
]
},
{
"id": 63,
"role": "agent",
"timestamp": "2026-09-29T02:31:53.994Z",
"blocks": [
{
"kind": "message",
"timestamp": "2026-09-29T02:31:53.994Z",
"text": "I will add write permissions to `train_current_model.py` and `two_tower_model.py` in `/app/solution/` so they can be modified."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:31:53.994Z",
"callId": "run_shell_command__call_69196",
"name": "run_shell_command",
"input": {
"description": "Add write permissions to python files in /app/solution",
"command": "chmod +w /app/solution/*.py"
},
"recorded": {
"id": "run_shell_command__call_69196",
"name": "run_shell_command",
"args": {
"description": "Add write permissions to python files in /app/solution",
"command": "chmod +w /app/solution/*.py"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_69196",
"name": "run_shell_command",
"response": {
"output": "\nOutput: (empty)\nProcess Group PGID: 1981\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:31:54.008Z",
"resultDisplay": "",
"description": "chmod +w /app/solution/*.py",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:31:54.009Z",
"content": "\nOutput: (empty)\nProcess Group PGID: 1981\n",
"isError": false
},
"responseMessageId": "915f61cb-94a4-461b-8897-1a010fe4d60b"
}
]
},
{
"id": 64,
"role": "agent",
"timestamp": "2026-09-29T02:31:58.703Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:31:58.703Z",
"callId": "replace__call_3556494",
"name": "replace",
"input": {
"old_string": " uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)",
"allow_multiple": false,
"instruction": "Update inbatch negative sampling in draw_filtered_mixed_negatives to sample directly from batch targets instead of uniform sampling from unique targets",
"file_path": "/app/solution/two_tower_model.py",
"new_string": " uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count"
},
"recorded": {
"id": "replace__call_3556494",
"name": "replace",
"args": {
"old_string": " uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)",
"allow_multiple": false,
"instruction": "Update inbatch negative sampling in draw_filtered_mixed_negatives to sample directly from batch targets instead of uniform sampling from unique targets",
"file_path": "/app/solution/two_tower_model.py",
"new_string": " uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count"
},
"result": [
{
"functionResponse": {
"id": "replace__call_3556494",
"name": "replace",
"response": {
"output": "Successfully modified file: /app/solution/two_tower_model.py (1 replacements). Here is the updated code:\n...\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n..."
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:31:58.718Z",
"resultDisplay": {
"fileDiff": "Index: two_tower_model.py\n===================================================================\n--- two_tower_model.py\tCurrent\n+++ two_tower_model.py\tProposed\n@@ -381,27 +381,15 @@\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n- if inbatch_count:\n- unique_targets = torch.unique(targets.detach().cpu())\n- corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n- if corrected_count:\n- priorities = torch.rand(\n- (batch_size, len(unique_targets)), generator=generator\n- )\n- priorities.masked_fill_(\n- unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n- -1.0,\n- )\n- columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n- inbatch = unique_targets[columns]\n- if corrected_count < inbatch_count:\n- filler = torch.randint(\n- n_items,\n- (batch_size, inbatch_count - corrected_count),\n- generator=generator,\n- device=\"cpu\",\n- )\n- inbatch = torch.cat([inbatch, filler], dim=1)\n+ if inbatch_count and batch_size > 0:\n+ rand_indices = torch.randint(\n+ batch_size,\n+ (batch_size, inbatch_count),\n+ generator=generator,\n+ device=\"cpu\",\n+ )\n+ inbatch = targets.detach().cpu()[rand_indices]\n+ corrected_count = inbatch_count\n \n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n",
"fileName": "two_tower_model.py",
"filePath": "/app/solution/two_tower_model.py",
"originalContent": "\"\"\"Shared public-data primitives for the Yambda two-tower baseline.\"\"\"\nfrom __future__ import annotations\n\nimport sys\nfrom dataclasses import dataclass\nfrom pathlib import Path\nfrom typing import Iterator\n\nimport numpy as np\nimport pandas as pd\nimport pyarrow.parquet as pq\nimport torch\nfrom torch import nn\n\n\nDAY = 86_400\nTRAIN_END = 24_786_800\nVALIDATION_END = 25_393_400\nLISTEN_POSITIVE_THRESHOLD = 50\nPROFILE_LOOKBACK_DAYS = 120\nLIKE_ITEMS = 48\nDISLIKE_ITEMS = 24\nTOP_N = 100\n\n\n@dataclass(frozen=True)\nclass TowerConfig:\n sequence_length: int = 100\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass ListenEvents:\n timestamps: np.ndarray\n items: np.ndarray\n organic: np.ndarray\n completion_pct: np.ndarray\n\n\n@dataclass(frozen=True)\nclass ExplicitEvents:\n timestamps: np.ndarray\n items: np.ndarray\n channel: np.ndarray\n active: np.ndarray\n organic_like: np.ndarray\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef build_item_features(catalog: pd.DataFrame) -> np.ndarray:\n \"\"\"Return four standardized features built only from the public catalog.\"\"\"\n positives = catalog.positive_listens.to_numpy(dtype=np.float64, copy=False)\n organic = catalog.organic_positive_listens.to_numpy(dtype=np.float64, copy=False)\n popularity_rank = catalog.popularity_rank.to_numpy(dtype=np.float64, copy=False)\n features = np.column_stack(\n [\n np.log1p(positives),\n np.log1p(organic),\n organic / np.maximum(positives, 1.0),\n 1.0 - (popularity_rank - 1.0) / max(len(catalog) - 1, 1),\n ]\n )\n means = features.mean(axis=0, keepdims=True)\n scales = np.maximum(features.std(axis=0, keepdims=True), 1.0e-6)\n standardized = ((features - means) / scales).astype(np.float32)\n if not np.isfinite(standardized).all():\n raise RuntimeError(\"catalog features contain non-finite values\")\n return standardized\n\n\ndef _combine_listen_chunks(parts: list[ListenEvents]) -> ListenEvents:\n if len(parts) == 1:\n return parts[0]\n timestamps = np.concatenate([part.timestamps for part in parts])\n items = np.concatenate([part.items for part in parts])\n organic = np.concatenate([part.organic for part in parts])\n completion = np.concatenate([part.completion_pct for part in parts])\n order = np.argsort(timestamps, kind=\"stable\")\n return ListenEvents(\n timestamps=timestamps[order],\n items=items[order],\n organic=organic[order],\n completion_pct=completion[order],\n )\n\n\ndef iter_listen_users(\n path: Path, item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Stream one uid-sorted public listen file one user at a time.\"\"\"\n parquet = pq.ParquetFile(path)\n pending_uid: int | None = None\n pending: list[ListenEvents] = []\n previous_uid = -1\n for batch in parquet.iter_batches(\n batch_size=750_000,\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\", \"played_ratio_pct\"],\n ):\n frame = batch.to_pandas()\n mapped = item_index.get_indexer(frame.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n if not np.any(keep):\n continue\n uids = frame.uid.to_numpy(dtype=np.int64, copy=False)[keep]\n timestamps = frame.timestamp.to_numpy(dtype=np.int64, copy=False)[keep]\n items = mapped[keep].astype(np.int32, copy=False)\n organic = frame.is_organic.to_numpy(dtype=np.uint8, copy=False)[keep]\n completion = frame.played_ratio_pct.to_numpy(dtype=np.uint16, copy=False)[keep]\n if np.any(uids[1:] < uids[:-1]):\n raise RuntimeError(f\"{path.name} is not sorted by uid\")\n boundaries = np.r_[\n 0,\n np.flatnonzero(uids[1:] != uids[:-1]) + 1,\n len(uids),\n ]\n for start, end in zip(boundaries[:-1], boundaries[1:]):\n uid = int(uids[start])\n part = ListenEvents(\n timestamps[start:end].copy(),\n items[start:end].copy(),\n organic[start:end].copy(),\n completion[start:end].copy(),\n )\n if pending_uid is None:\n pending_uid = uid\n elif uid != pending_uid:\n if pending_uid < previous_uid:\n raise RuntimeError(f\"{path.name} user order regressed\")\n yield pending_uid, _combine_listen_chunks(pending)\n previous_uid = pending_uid\n pending_uid = uid\n pending = []\n pending.append(part)\n if pending_uid is not None:\n yield pending_uid, _combine_listen_chunks(pending)\n\n\ndef merge_listen_streams(\n paths: list[Path], item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Merge uid-sorted public listen files without materializing them.\"\"\"\n streams = [iter(iter_listen_users(path, item_index)) for path in paths]\n heads: list[tuple[int, ListenEvents] | None] = [\n next(stream, None) for stream in streams\n ]\n while any(head is not None for head in heads):\n uid = min(head[0] for head in heads if head is not None)\n parts: list[ListenEvents] = []\n for position, head in enumerate(heads):\n if head is not None and head[0] == uid:\n parts.append(head[1])\n heads[position] = next(streams[position], None)\n yield uid, _combine_listen_chunks(parts)\n\n\ndef load_explicit_events(\n data: Path,\n prefixes: tuple[str, ...],\n item_index: pd.Index,\n) -> dict[int, ExplicitEvents]:\n \"\"\"Load public explicit actions as chronological state changes.\"\"\"\n specifications = (\n (\"likes\", 0, 1, 0),\n (\"unlikes\", 0, 0, 1),\n (\"dislikes\", 1, 1, 0),\n (\"undislikes\", 1, 0, 1),\n )\n parts: list[pd.DataFrame] = []\n for family, channel, active, tie_priority in specifications:\n for prefix in prefixes:\n frame = pd.read_parquet(\n data / f\"{prefix}_{family}.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n mapped = item_index.get_indexer(\n frame.item_id.to_numpy(dtype=np.int64, copy=False)\n )\n keep = mapped >= 0\n if not np.any(keep):\n continue\n retained = frame.loc[keep, [\"uid\", \"timestamp\", \"is_organic\"]].copy()\n retained[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n retained[\"channel\"] = np.int8(channel)\n retained[\"active\"] = np.int8(active)\n retained[\"tie_priority\"] = np.int8(tie_priority)\n retained[\"organic_like\"] = np.int8(\n family == \"likes\"\n ) * retained.is_organic.astype(np.int8)\n parts.append(retained.drop(columns=\"is_organic\"))\n if not parts:\n return {}\n events = pd.concat(parts, ignore_index=True)\n events = events.sort_values(\n [\"uid\", \"timestamp\", \"tie_priority\"], kind=\"mergesort\"\n ).reset_index(drop=True)\n result: dict[int, ExplicitEvents] = {}\n for uid, rows in events.groupby(\"uid\", sort=False):\n result[int(uid)] = ExplicitEvents(\n timestamps=rows.timestamp.to_numpy(dtype=np.int64, copy=True),\n items=rows.item.to_numpy(dtype=np.int32, copy=True),\n channel=rows.channel.to_numpy(dtype=np.int8, copy=True),\n active=rows.active.to_numpy(dtype=np.int8, copy=True),\n organic_like=rows.organic_like.to_numpy(dtype=np.int8, copy=True),\n )\n log(f\"loaded explicit events: rows={len(events):,} users={len(result):,}\")\n return result\n\n\ndef empty_explicit_events() -> ExplicitEvents:\n return ExplicitEvents(\n timestamps=np.empty(0, dtype=np.int64),\n items=np.empty(0, dtype=np.int32),\n channel=np.empty(0, dtype=np.int8),\n active=np.empty(0, dtype=np.int8),\n organic_like=np.empty(0, dtype=np.int8),\n )\n\n\ndef pack_active_items(\n active: dict[int, int], width: int, padding_item: int\n) -> np.ndarray:\n packed = np.full(width, padding_item, dtype=np.uint16)\n if not active:\n return packed\n ordered = sorted(active.items(), key=lambda pair: (-pair[1], pair[0]))[:width]\n packed[: len(ordered)] = np.fromiter(\n (item for item, _ in ordered), dtype=np.uint16, count=len(ordered)\n )\n return packed\n\n\ndef load_inference_state(\n path: Path,\n item_index: pd.Index,\n uids: np.ndarray,\n n_items: int,\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray]:\n \"\"\"Pack the task-provided active explicit state.\"\"\"\n state = pd.read_parquet(path, columns=[\"uid\", \"item_id\", \"state\"])\n mapped = item_index.get_indexer(state.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n state = state.loc[keep, [\"uid\", \"state\"]].copy()\n state[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n user_rows = pd.Index(uids)\n liked = np.full((len(uids), LIKE_ITEMS), n_items, dtype=np.uint16)\n disliked = np.full((len(uids), DISLIKE_ITEMS), n_items, dtype=np.uint16)\n like_counts = np.zeros(len(uids), dtype=np.int32)\n dislike_counts = np.zeros(len(uids), dtype=np.int32)\n for value, width, destination, counts in (\n (\"liked\", LIKE_ITEMS, liked, like_counts),\n (\"disliked\", DISLIKE_ITEMS, disliked, dislike_counts),\n ):\n selected = state[state.state == value]\n for uid, rows in selected.groupby(\"uid\", sort=False):\n row = int(user_rows.get_indexer([int(uid)])[0])\n if row < 0:\n continue\n items = np.sort(rows.item.unique())\n counts[row] = len(items)\n retained = items[:width]\n destination[row, : len(retained)] = retained.astype(np.uint16)\n return liked, disliked, like_counts, dislike_counts\n\n\nclass SequentialTwoTower(nn.Module):\n \"\"\"Order-sensitive user tower and independent catalog-aware item tower.\"\"\"\n\n def __init__(self, item_features: np.ndarray, config: TowerConfig) -> None:\n super().__init__()\n n_items, n_item_features = item_features.shape\n dim = config.embedding_dim\n self.n_items = n_items\n self.context_embedding = nn.Embedding(\n n_items + 1, dim, padding_idx=n_items\n )\n self.event_projection = nn.Sequential(\n nn.Linear(dim + 3, config.hidden_dim),\n nn.GELU(),\n )\n self.sequence_encoder = nn.GRU(\n input_size=config.hidden_dim,\n hidden_size=dim,\n num_layers=1,\n batch_first=True,\n )\n self.user_tower = nn.Sequential(\n nn.Linear(dim * 3 + 6, config.user_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_1, config.user_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_2, dim),\n )\n self.candidate_embedding = nn.Embedding(n_items, dim)\n self.register_buffer(\n \"item_features\", torch.from_numpy(item_features), persistent=True\n )\n self.item_tower = nn.Sequential(\n nn.Linear(dim + n_item_features, config.item_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_1, config.item_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_2, dim),\n )\n nn.init.normal_(self.context_embedding.weight, std=0.02)\n nn.init.normal_(self.candidate_embedding.weight, std=0.02)\n with torch.no_grad():\n self.context_embedding.weight[n_items].zero_()\n\n def _mean_context_channel(self, items: torch.Tensor) -> torch.Tensor:\n mask = items.ne(self.n_items)\n vectors = self.context_embedding(items)\n return (vectors * mask.unsqueeze(-1)).sum(dim=1) / mask.sum(\n dim=1, keepdim=True\n ).clamp_min(1)\n\n def encode_items(self, items: torch.Tensor) -> torch.Tensor:\n inputs = torch.cat(\n [self.candidate_embedding(items), self.item_features[items]], dim=1\n )\n return self.item_tower(inputs)\n\n\ndef invalid_negative_mask(\n negatives: torch.Tensor,\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n) -> torch.Tensor:\n \"\"\"Identify targets, known positives, active likes, and row duplicates.\"\"\"\n invalid = negatives.eq(targets[:, None])\n invalid |= negatives[:, :, None].eq(context_items[:, None, :]).any(dim=2)\n invalid |= negatives[:, :, None].eq(liked_items[:, None, :]).any(dim=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= negatives[:, column, None].eq(\n negatives[:, :column]\n ).any(dim=1)\n return invalid\n\n\ndef draw_filtered_mixed_negatives(\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n n_items: int,\n uniform_count: int,\n inbatch_count: int,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw uniform and unique-target in-batch negatives.\"\"\"\n batch_size = len(targets)\n uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n :, uniform_count : uniform_count + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]]\n negatives = negatives_cpu.to(device)\n correction = correction_cpu.to(device)\n for _ in range(32):\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if not bool(invalid.any()):\n return negatives, correction\n replacements = torch.randint(\n n_items,\n (int(invalid.sum().detach().cpu()),),\n generator=generator,\n device=\"cpu\",\n ).to(device)\n negatives[invalid] = replacements\n correction[invalid] = 1.0\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if bool(invalid.any()):\n raise RuntimeError(\"mixed negative resampling failed false-negative filter\")\n return negatives, correction\n",
"newContent": "\"\"\"Shared public-data primitives for the Yambda two-tower baseline.\"\"\"\nfrom __future__ import annotations\n\nimport sys\nfrom dataclasses import dataclass\nfrom pathlib import Path\nfrom typing import Iterator\n\nimport numpy as np\nimport pandas as pd\nimport pyarrow.parquet as pq\nimport torch\nfrom torch import nn\n\n\nDAY = 86_400\nTRAIN_END = 24_786_800\nVALIDATION_END = 25_393_400\nLISTEN_POSITIVE_THRESHOLD = 50\nPROFILE_LOOKBACK_DAYS = 120\nLIKE_ITEMS = 48\nDISLIKE_ITEMS = 24\nTOP_N = 100\n\n\n@dataclass(frozen=True)\nclass TowerConfig:\n sequence_length: int = 100\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass ListenEvents:\n timestamps: np.ndarray\n items: np.ndarray\n organic: np.ndarray\n completion_pct: np.ndarray\n\n\n@dataclass(frozen=True)\nclass ExplicitEvents:\n timestamps: np.ndarray\n items: np.ndarray\n channel: np.ndarray\n active: np.ndarray\n organic_like: np.ndarray\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef build_item_features(catalog: pd.DataFrame) -> np.ndarray:\n \"\"\"Return four standardized features built only from the public catalog.\"\"\"\n positives = catalog.positive_listens.to_numpy(dtype=np.float64, copy=False)\n organic = catalog.organic_positive_listens.to_numpy(dtype=np.float64, copy=False)\n popularity_rank = catalog.popularity_rank.to_numpy(dtype=np.float64, copy=False)\n features = np.column_stack(\n [\n np.log1p(positives),\n np.log1p(organic),\n organic / np.maximum(positives, 1.0),\n 1.0 - (popularity_rank - 1.0) / max(len(catalog) - 1, 1),\n ]\n )\n means = features.mean(axis=0, keepdims=True)\n scales = np.maximum(features.std(axis=0, keepdims=True), 1.0e-6)\n standardized = ((features - means) / scales).astype(np.float32)\n if not np.isfinite(standardized).all():\n raise RuntimeError(\"catalog features contain non-finite values\")\n return standardized\n\n\ndef _combine_listen_chunks(parts: list[ListenEvents]) -> ListenEvents:\n if len(parts) == 1:\n return parts[0]\n timestamps = np.concatenate([part.timestamps for part in parts])\n items = np.concatenate([part.items for part in parts])\n organic = np.concatenate([part.organic for part in parts])\n completion = np.concatenate([part.completion_pct for part in parts])\n order = np.argsort(timestamps, kind=\"stable\")\n return ListenEvents(\n timestamps=timestamps[order],\n items=items[order],\n organic=organic[order],\n completion_pct=completion[order],\n )\n\n\ndef iter_listen_users(\n path: Path, item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Stream one uid-sorted public listen file one user at a time.\"\"\"\n parquet = pq.ParquetFile(path)\n pending_uid: int | None = None\n pending: list[ListenEvents] = []\n previous_uid = -1\n for batch in parquet.iter_batches(\n batch_size=750_000,\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\", \"played_ratio_pct\"],\n ):\n frame = batch.to_pandas()\n mapped = item_index.get_indexer(frame.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n if not np.any(keep):\n continue\n uids = frame.uid.to_numpy(dtype=np.int64, copy=False)[keep]\n timestamps = frame.timestamp.to_numpy(dtype=np.int64, copy=False)[keep]\n items = mapped[keep].astype(np.int32, copy=False)\n organic = frame.is_organic.to_numpy(dtype=np.uint8, copy=False)[keep]\n completion = frame.played_ratio_pct.to_numpy(dtype=np.uint16, copy=False)[keep]\n if np.any(uids[1:] < uids[:-1]):\n raise RuntimeError(f\"{path.name} is not sorted by uid\")\n boundaries = np.r_[\n 0,\n np.flatnonzero(uids[1:] != uids[:-1]) + 1,\n len(uids),\n ]\n for start, end in zip(boundaries[:-1], boundaries[1:]):\n uid = int(uids[start])\n part = ListenEvents(\n timestamps[start:end].copy(),\n items[start:end].copy(),\n organic[start:end].copy(),\n completion[start:end].copy(),\n )\n if pending_uid is None:\n pending_uid = uid\n elif uid != pending_uid:\n if pending_uid < previous_uid:\n raise RuntimeError(f\"{path.name} user order regressed\")\n yield pending_uid, _combine_listen_chunks(pending)\n previous_uid = pending_uid\n pending_uid = uid\n pending = []\n pending.append(part)\n if pending_uid is not None:\n yield pending_uid, _combine_listen_chunks(pending)\n\n\ndef merge_listen_streams(\n paths: list[Path], item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Merge uid-sorted public listen files without materializing them.\"\"\"\n streams = [iter(iter_listen_users(path, item_index)) for path in paths]\n heads: list[tuple[int, ListenEvents] | None] = [\n next(stream, None) for stream in streams\n ]\n while any(head is not None for head in heads):\n uid = min(head[0] for head in heads if head is not None)\n parts: list[ListenEvents] = []\n for position, head in enumerate(heads):\n if head is not None and head[0] == uid:\n parts.append(head[1])\n heads[position] = next(streams[position], None)\n yield uid, _combine_listen_chunks(parts)\n\n\ndef load_explicit_events(\n data: Path,\n prefixes: tuple[str, ...],\n item_index: pd.Index,\n) -> dict[int, ExplicitEvents]:\n \"\"\"Load public explicit actions as chronological state changes.\"\"\"\n specifications = (\n (\"likes\", 0, 1, 0),\n (\"unlikes\", 0, 0, 1),\n (\"dislikes\", 1, 1, 0),\n (\"undislikes\", 1, 0, 1),\n )\n parts: list[pd.DataFrame] = []\n for family, channel, active, tie_priority in specifications:\n for prefix in prefixes:\n frame = pd.read_parquet(\n data / f\"{prefix}_{family}.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n mapped = item_index.get_indexer(\n frame.item_id.to_numpy(dtype=np.int64, copy=False)\n )\n keep = mapped >= 0\n if not np.any(keep):\n continue\n retained = frame.loc[keep, [\"uid\", \"timestamp\", \"is_organic\"]].copy()\n retained[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n retained[\"channel\"] = np.int8(channel)\n retained[\"active\"] = np.int8(active)\n retained[\"tie_priority\"] = np.int8(tie_priority)\n retained[\"organic_like\"] = np.int8(\n family == \"likes\"\n ) * retained.is_organic.astype(np.int8)\n parts.append(retained.drop(columns=\"is_organic\"))\n if not parts:\n return {}\n events = pd.concat(parts, ignore_index=True)\n events = events.sort_values(\n [\"uid\", \"timestamp\", \"tie_priority\"], kind=\"mergesort\"\n ).reset_index(drop=True)\n result: dict[int, ExplicitEvents] = {}\n for uid, rows in events.groupby(\"uid\", sort=False):\n result[int(uid)] = ExplicitEvents(\n timestamps=rows.timestamp.to_numpy(dtype=np.int64, copy=True),\n items=rows.item.to_numpy(dtype=np.int32, copy=True),\n channel=rows.channel.to_numpy(dtype=np.int8, copy=True),\n active=rows.active.to_numpy(dtype=np.int8, copy=True),\n organic_like=rows.organic_like.to_numpy(dtype=np.int8, copy=True),\n )\n log(f\"loaded explicit events: rows={len(events):,} users={len(result):,}\")\n return result\n\n\ndef empty_explicit_events() -> ExplicitEvents:\n return ExplicitEvents(\n timestamps=np.empty(0, dtype=np.int64),\n items=np.empty(0, dtype=np.int32),\n channel=np.empty(0, dtype=np.int8),\n active=np.empty(0, dtype=np.int8),\n organic_like=np.empty(0, dtype=np.int8),\n )\n\n\ndef pack_active_items(\n active: dict[int, int], width: int, padding_item: int\n) -> np.ndarray:\n packed = np.full(width, padding_item, dtype=np.uint16)\n if not active:\n return packed\n ordered = sorted(active.items(), key=lambda pair: (-pair[1], pair[0]))[:width]\n packed[: len(ordered)] = np.fromiter(\n (item for item, _ in ordered), dtype=np.uint16, count=len(ordered)\n )\n return packed\n\n\ndef load_inference_state(\n path: Path,\n item_index: pd.Index,\n uids: np.ndarray,\n n_items: int,\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray]:\n \"\"\"Pack the task-provided active explicit state.\"\"\"\n state = pd.read_parquet(path, columns=[\"uid\", \"item_id\", \"state\"])\n mapped = item_index.get_indexer(state.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n state = state.loc[keep, [\"uid\", \"state\"]].copy()\n state[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n user_rows = pd.Index(uids)\n liked = np.full((len(uids), LIKE_ITEMS), n_items, dtype=np.uint16)\n disliked = np.full((len(uids), DISLIKE_ITEMS), n_items, dtype=np.uint16)\n like_counts = np.zeros(len(uids), dtype=np.int32)\n dislike_counts = np.zeros(len(uids), dtype=np.int32)\n for value, width, destination, counts in (\n (\"liked\", LIKE_ITEMS, liked, like_counts),\n (\"disliked\", DISLIKE_ITEMS, disliked, dislike_counts),\n ):\n selected = state[state.state == value]\n for uid, rows in selected.groupby(\"uid\", sort=False):\n row = int(user_rows.get_indexer([int(uid)])[0])\n if row < 0:\n continue\n items = np.sort(rows.item.unique())\n counts[row] = len(items)\n retained = items[:width]\n destination[row, : len(retained)] = retained.astype(np.uint16)\n return liked, disliked, like_counts, dislike_counts\n\n\nclass SequentialTwoTower(nn.Module):\n \"\"\"Order-sensitive user tower and independent catalog-aware item tower.\"\"\"\n\n def __init__(self, item_features: np.ndarray, config: TowerConfig) -> None:\n super().__init__()\n n_items, n_item_features = item_features.shape\n dim = config.embedding_dim\n self.n_items = n_items\n self.context_embedding = nn.Embedding(\n n_items + 1, dim, padding_idx=n_items\n )\n self.event_projection = nn.Sequential(\n nn.Linear(dim + 3, config.hidden_dim),\n nn.GELU(),\n )\n self.sequence_encoder = nn.GRU(\n input_size=config.hidden_dim,\n hidden_size=dim,\n num_layers=1,\n batch_first=True,\n )\n self.user_tower = nn.Sequential(\n nn.Linear(dim * 3 + 6, config.user_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_1, config.user_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_2, dim),\n )\n self.candidate_embedding = nn.Embedding(n_items, dim)\n self.register_buffer(\n \"item_features\", torch.from_numpy(item_features), persistent=True\n )\n self.item_tower = nn.Sequential(\n nn.Linear(dim + n_item_features, config.item_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_1, config.item_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_2, dim),\n )\n nn.init.normal_(self.context_embedding.weight, std=0.02)\n nn.init.normal_(self.candidate_embedding.weight, std=0.02)\n with torch.no_grad():\n self.context_embedding.weight[n_items].zero_()\n\n def _mean_context_channel(self, items: torch.Tensor) -> torch.Tensor:\n mask = items.ne(self.n_items)\n vectors = self.context_embedding(items)\n return (vectors * mask.unsqueeze(-1)).sum(dim=1) / mask.sum(\n dim=1, keepdim=True\n ).clamp_min(1)\n\n def encode_items(self, items: torch.Tensor) -> torch.Tensor:\n inputs = torch.cat(\n [self.candidate_embedding(items), self.item_features[items]], dim=1\n )\n return self.item_tower(inputs)\n\n\ndef invalid_negative_mask(\n negatives: torch.Tensor,\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n) -> torch.Tensor:\n \"\"\"Identify targets, known positives, active likes, and row duplicates.\"\"\"\n invalid = negatives.eq(targets[:, None])\n invalid |= negatives[:, :, None].eq(context_items[:, None, :]).any(dim=2)\n invalid |= negatives[:, :, None].eq(liked_items[:, None, :]).any(dim=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= negatives[:, column, None].eq(\n negatives[:, :column]\n ).any(dim=1)\n return invalid\n\n\ndef draw_filtered_mixed_negatives(\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n n_items: int,\n uniform_count: int,\n inbatch_count: int,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw uniform and unique-target in-batch negatives.\"\"\"\n batch_size = len(targets)\n uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n :, uniform_count : uniform_count + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]]\n negatives = negatives_cpu.to(device)\n correction = correction_cpu.to(device)\n for _ in range(32):\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if not bool(invalid.any()):\n return negatives, correction\n replacements = torch.randint(\n n_items,\n (int(invalid.sum().detach().cpu()),),\n generator=generator,\n device=\"cpu\",\n ).to(device)\n negatives[invalid] = replacements\n correction[invalid] = 1.0\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if bool(invalid.any()):\n raise RuntimeError(\"mixed negative resampling failed false-negative filter\")\n return negatives, correction\n",
"diffStat": {
"model_added_lines": 9,
"model_removed_lines": 21,
"model_added_chars": 299,
"model_removed_chars": 873,
"user_added_lines": 0,
"user_removed_lines": 0,
"user_added_chars": 0,
"user_removed_chars": 0
},
"isNewFile": false,
"isBuildFile": false
},
"description": "solution/two_tower_model.py: uniform = torch.randint(... => uniform = torch.randint(...",
"displayName": "Edit",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:31:58.720Z",
"content": "Successfully modified file: /app/solution/two_tower_model.py (1 replacements). Here is the updated code:\n...\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n...",
"isError": false
},
"responseMessageId": "53685944-2fb8-43f2-8454-57a20da87900"
}
]
},
{
"id": 65,
"role": "agent",
"timestamp": "2026-09-29T02:32:13.796Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:32:13.796Z",
"text": "Refining two_tower_model.py\n\nI've just updated the `two_tower_model.py` file. My next step is to clearly outline the changes made and detail my verification plan or the subsequent actions I intend to take."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:32:13.796Z",
"text": "Updating train_current_model.py\n\nI've incorporated updates into `train_current_model.py`. The `Config` dataclass now includes parameters for `loss_type`, `temperature`, `target_weighting`, `uniform_negatives`, `inbatch_negatives`, and `inbatch_correction_power`. Additionally, I've adjusted the `draw_full_history_filtered_negatives` function to directly sample `inbatch` from `targets_cpu`."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:32:13.796Z",
"text": "Implementing infonce loss\n\nI've implemented support for `loss_type == \"infonce\"` within the `_target_microbatches` function. This involves calculating scaled logits and using `F.cross_entropy` for the loss computation, leveraging `sample_weights` for weighted loss summation."
},
{
"kind": "message",
"timestamp": "2026-09-29T02:32:13.796Z",
"text": "In `two_tower_model.py`, I updated `draw_filtered_mixed_negatives` so that in-batch negative candidates are sampled directly from the batch targets rather than flattened via unique items.\n\nNext, I will update `Config`, `draw_full_history_filtered_negatives`, `score_target_microbatches`, and CLI parsing in `train_current_model.py`."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:32:13.796Z",
"callId": "replace__call_92730",
"name": "replace",
"input": {
"old_string": " loss_microbatch_size: int = 65_536\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"organic-strong\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n seed: int = 29",
"file_path": "/app/solution/train_current_model.py",
"allow_multiple": false,
"instruction": "Add loss_type and temperature to Config, update default negative sampling counts and target weighting",
"new_string": " loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29"
},
"recorded": {
"id": "replace__call_92730",
"name": "replace",
"args": {
"old_string": " loss_microbatch_size: int = 65_536\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"organic-strong\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n seed: int = 29",
"file_path": "/app/solution/train_current_model.py",
"allow_multiple": false,
"instruction": "Add loss_type and temperature to Config, update default negative sampling counts and target weighting",
"new_string": " loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29"
},
"result": [
{
"functionResponse": {
"id": "replace__call_92730",
"name": "replace",
"response": {
"output": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n..."
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:32:13.810Z",
"resultDisplay": {
"fileDiff": "Index: train_current_model.py\n===================================================================\n--- train_current_model.py\tCurrent\n+++ train_current_model.py\tProposed\n@@ -53,13 +53,13 @@\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n- uniform_negatives: int = 24\n- inbatch_negatives: int = 8\n- inbatch_correction_power: float = 0.5\n+ uniform_negatives: int = 16\n+ inbatch_negatives: int = 16\n+ inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n- target_weighting: str = \"organic-strong\"\n+ target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n@@ -69,6 +69,8 @@\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n+ loss_type: str = \"infonce\"\n+ temperature: float = 0.10\n seed: int = 29\n \n \n",
"fileName": "train_current_model.py",
"filePath": "/app/solution/train_current_model.py",
"originalContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"organic-strong\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"newContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"diffStat": {
"model_added_lines": 6,
"model_removed_lines": 4,
"model_added_chars": 208,
"model_removed_chars": 146,
"user_added_lines": 0,
"user_removed_lines": 0,
"user_added_chars": 0,
"user_removed_chars": 0
},
"isNewFile": false,
"isBuildFile": false
},
"description": "solution/train_current_model.py: loss_microbatch_size: int ... => loss_microbatch_size: int ...",
"displayName": "Edit",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:32:13.812Z",
"content": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n...",
"isError": false
},
"responseMessageId": "5dd92e5c-8e79-48ef-bd18-1315fd151a18"
}
]
},
{
"id": 66,
"role": "agent",
"timestamp": "2026-09-29T02:32:18.333Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:32:18.333Z",
"callId": "read_file__call_51779",
"name": "read_file",
"input": {
"end_line": 685,
"file_path": "/app/solution/train_current_model.py",
"start_line": 640
},
"recorded": {
"id": "read_file__call_51779",
"name": "read_file",
"args": {
"end_line": 685,
"file_path": "/app/solution/train_current_model.py",
"start_line": 640
},
"result": [
{
"functionResponse": {
"id": "read_file__call_51779",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 640-685 of 2167 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 686.\n\n--- FILE CONTENT (truncated) ---\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:32:18.338Z",
"resultDisplay": "Read lines 640-685 of 2167 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:32:18.340Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 640-685 of 2167 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 686.\n\n--- FILE CONTENT (truncated) ---\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:",
"isError": false
},
"responseMessageId": "dd245627-af89-4e33-a2a3-8a7242daed4f"
}
]
},
{
"id": 67,
"role": "agent",
"timestamp": "2026-09-29T02:32:23.157Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:32:23.157Z",
"callId": "replace__call_53593",
"name": "replace",
"input": {
"allow_multiple": false,
"old_string": " uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)",
"new_string": " uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives",
"file_path": "/app/solution/train_current_model.py",
"instruction": "Sample in-batch negatives directly from targets_cpu proportional to frequency"
},
"recorded": {
"id": "replace__call_53593",
"name": "replace",
"args": {
"allow_multiple": false,
"old_string": " uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)",
"new_string": " uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives",
"file_path": "/app/solution/train_current_model.py",
"instruction": "Sample in-batch negatives directly from targets_cpu proportional to frequency"
},
"result": [
{
"functionResponse": {
"id": "replace__call_53593",
"name": "replace",
"response": {
"output": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n..."
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:32:23.173Z",
"resultDisplay": {
"fileDiff": "Index: train_current_model.py\n===================================================================\n--- train_current_model.py\tCurrent\n+++ train_current_model.py\tProposed\n@@ -652,33 +652,15 @@\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n- if config.inbatch_negatives:\n- unique_targets = torch.unique(targets.detach().cpu())\n- corrected_count = min(\n- config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n- )\n- if corrected_count:\n- priorities = torch.rand(\n- (batch_size, len(unique_targets)), generator=generator\n- )\n- priorities.masked_fill_(\n- unique_targets[None, :].eq(\n- torch.from_numpy(targets_cpu)[:, None]\n- ),\n- -1.0,\n- )\n- columns = torch.topk(\n- priorities, k=corrected_count, dim=1\n- ).indices\n- inbatch = unique_targets[columns]\n- if corrected_count < config.inbatch_negatives:\n- filler = torch.randint(\n- n_items,\n- (batch_size, config.inbatch_negatives - corrected_count),\n- generator=generator,\n- device=\"cpu\",\n- )\n- inbatch = torch.cat([inbatch, filler], dim=1)\n+ if config.inbatch_negatives and batch_size > 0:\n+ rand_indices = torch.randint(\n+ batch_size,\n+ (batch_size, config.inbatch_negatives),\n+ generator=generator,\n+ device=\"cpu\",\n+ ).numpy()\n+ inbatch = torch.from_numpy(targets_cpu[rand_indices])\n+ corrected_count = config.inbatch_negatives\n \n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n",
"fileName": "train_current_model.py",
"filePath": "/app/solution/train_current_model.py",
"originalContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"newContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"diffStat": {
"model_added_lines": 9,
"model_removed_lines": 27,
"model_added_chars": 347,
"model_removed_chars": 1008,
"user_added_lines": 0,
"user_removed_lines": 0,
"user_added_chars": 0,
"user_removed_chars": 0
},
"isNewFile": false,
"isBuildFile": false
},
"description": "solution/train_current_model.py: uniform = torch.randint(... => uniform = torch.randint(...",
"displayName": "Edit",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:32:23.175Z",
"content": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n...",
"isError": false
},
"responseMessageId": "6dd4fb91-dfee-411a-ae47-ab15ebe0466c"
}
]
},
{
"id": 68,
"role": "agent",
"timestamp": "2026-09-29T02:32:26.080Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:32:26.080Z",
"callId": "read_file__call_112259",
"name": "read_file",
"input": {
"end_line": 1185,
"file_path": "/app/solution/train_current_model.py",
"start_line": 1145
},
"recorded": {
"id": "read_file__call_112259",
"name": "read_file",
"args": {
"end_line": 1185,
"file_path": "/app/solution/train_current_model.py",
"start_line": 1145
},
"result": [
{
"functionResponse": {
"id": "read_file__call_112259",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1145-1185 of 2149 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1186.\n\n--- FILE CONTENT (truncated) ---\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:32:26.085Z",
"resultDisplay": "Read lines 1145-1185 of 2149 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:32:26.087Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1145-1185 of 2149 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 1186.\n\n--- FILE CONTENT (truncated) ---\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n",
"isError": false
},
"responseMessageId": "026191d8-5425-4c93-b929-d5372f379a7e"
}
]
},
{
"id": 69,
"role": "agent",
"timestamp": "2026-09-29T02:32:30.302Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:32:30.302Z",
"callId": "replace__call_1374251",
"name": "replace",
"input": {
"new_string": " selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n if config.loss_type == \"infonce\":\n all_logits = torch.cat(\n [positive_logits.unsqueeze(1), negative_logits], dim=1\n )\n scaled_logits = all_logits / config.temperature\n target_zeros = torch.zeros(\n len(all_logits), dtype=torch.long, device=device\n )\n row_losses = F.cross_entropy(\n scaled_logits, target_zeros, reduction=\"none\"\n )\n loss_sum = (selected_weights * row_losses).sum()\n else:\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()",
"instruction": "Support InfoNCE loss in score_target_microbatches",
"allow_multiple": false,
"old_string": " positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()",
"file_path": "/app/solution/train_current_model.py"
},
"recorded": {
"id": "replace__call_1374251",
"name": "replace",
"args": {
"new_string": " selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n if config.loss_type == \"infonce\":\n all_logits = torch.cat(\n [positive_logits.unsqueeze(1), negative_logits], dim=1\n )\n scaled_logits = all_logits / config.temperature\n target_zeros = torch.zeros(\n len(all_logits), dtype=torch.long, device=device\n )\n row_losses = F.cross_entropy(\n scaled_logits, target_zeros, reduction=\"none\"\n )\n loss_sum = (selected_weights * row_losses).sum()\n else:\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()",
"instruction": "Support InfoNCE loss in score_target_microbatches",
"allow_multiple": false,
"old_string": " positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()",
"file_path": "/app/solution/train_current_model.py"
},
"result": [
{
"functionResponse": {
"id": "replace__call_1374251",
"name": "replace",
"response": {
"output": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n if config.loss_type == \"infonce\":\n all_logits = torch.cat(\n [positive_logits.unsqueeze(1), negative_logits], dim=1\n )\n scaled_logits = all_logits / config.temperature\n target_zeros = torch.zeros(\n len(all_logits), dtype=torch.long, device=device\n )\n row_losses = F.cross_entropy(\n scaled_logits, target_zeros, reduction=\"none\"\n )\n loss_sum = (selected_weights * row_losses).sum()\n else:\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n..."
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:32:30.316Z",
"resultDisplay": {
"fileDiff": "Index: train_current_model.py\n===================================================================\n--- train_current_model.py\tCurrent\n+++ train_current_model.py\tProposed\n@@ -1152,16 +1152,29 @@\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n- positive_loss = F.softplus(-positive_logits)\n- negative_loss = corrected_negative_loss(\n- negative_logits, negative_weights[begin:end], config\n- )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n- loss_sum = (\n- selected_weights * (positive_loss + negative_loss) / 2.0\n- ).sum()\n+ if config.loss_type == \"infonce\":\n+ all_logits = torch.cat(\n+ [positive_logits.unsqueeze(1), negative_logits], dim=1\n+ )\n+ scaled_logits = all_logits / config.temperature\n+ target_zeros = torch.zeros(\n+ len(all_logits), dtype=torch.long, device=device\n+ )\n+ row_losses = F.cross_entropy(\n+ scaled_logits, target_zeros, reduction=\"none\"\n+ )\n+ loss_sum = (selected_weights * row_losses).sum()\n+ else:\n+ positive_loss = F.softplus(-positive_logits)\n+ negative_loss = corrected_negative_loss(\n+ negative_logits, negative_weights[begin:end], config\n+ )\n+ loss_sum = (\n+ selected_weights * (positive_loss + negative_loss) / 2.0\n+ ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n",
"fileName": "train_current_model.py",
"filePath": "/app/solution/train_current_model.py",
"originalContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"newContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n if config.loss_type == \"infonce\":\n all_logits = torch.cat(\n [positive_logits.unsqueeze(1), negative_logits], dim=1\n )\n scaled_logits = all_logits / config.temperature\n target_zeros = torch.zeros(\n len(all_logits), dtype=torch.long, device=device\n )\n row_losses = F.cross_entropy(\n scaled_logits, target_zeros, reduction=\"none\"\n )\n loss_sum = (selected_weights * row_losses).sum()\n else:\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"diffStat": {
"model_added_lines": 20,
"model_removed_lines": 7,
"model_added_chars": 826,
"model_removed_chars": 276,
"user_added_lines": 0,
"user_removed_lines": 0,
"user_added_chars": 0,
"user_removed_chars": 0
},
"isNewFile": false,
"isBuildFile": false
},
"description": "solution/train_current_model.py: positive_loss = F.soft... => selected_weights = tor...",
"displayName": "Edit",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:32:30.319Z",
"content": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n if config.loss_type == \"infonce\":\n all_logits = torch.cat(\n [positive_logits.unsqueeze(1), negative_logits], dim=1\n )\n scaled_logits = all_logits / config.temperature\n target_zeros = torch.zeros(\n len(all_logits), dtype=torch.long, device=device\n )\n row_losses = F.cross_entropy(\n scaled_logits, target_zeros, reduction=\"none\"\n )\n loss_sum = (selected_weights * row_losses).sum()\n else:\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n...",
"isError": false
},
"responseMessageId": "8ba45f38-11c9-4a70-aff1-c34b7116d42a"
}
]
},
{
"id": 70,
"role": "agent",
"timestamp": "2026-09-29T02:32:32.952Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:32:32.952Z",
"callId": "read_file__call_144590",
"name": "read_file",
"input": {
"file_path": "/app/solution/train_current_model.py",
"start_line": 1920,
"end_line": 2040
},
"recorded": {
"id": "read_file__call_144590",
"name": "read_file",
"args": {
"file_path": "/app/solution/train_current_model.py",
"start_line": 1920,
"end_line": 2040
},
"result": [
{
"functionResponse": {
"id": "read_file__call_144590",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1920-2040 of 2162 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 2041.\n\n--- FILE CONTENT (truncated) ---\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:32:32.957Z",
"resultDisplay": "Read lines 1920-2040 of 2162 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:32:32.958Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 1920-2040 of 2162 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 2041.\n\n--- FILE CONTENT (truncated) ---\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,",
"isError": false
},
"responseMessageId": "719e8aeb-aff6-4142-abe3-7280242a333d"
}
]
},
{
"id": 71,
"role": "agent",
"timestamp": "2026-09-29T02:32:36.650Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:32:36.650Z",
"callId": "read_file__call_10251",
"name": "read_file",
"input": {
"end_line": 2070,
"file_path": "/app/solution/train_current_model.py",
"start_line": 2035
},
"recorded": {
"id": "read_file__call_10251",
"name": "read_file",
"args": {
"end_line": 2070,
"file_path": "/app/solution/train_current_model.py",
"start_line": 2035
},
"result": [
{
"functionResponse": {
"id": "read_file__call_10251",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 2035-2070 of 2162 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 2071.\n\n--- FILE CONTENT (truncated) ---\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:32:36.655Z",
"resultDisplay": "Read lines 2035-2070 of 2162 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:32:36.656Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 2035-2070 of 2162 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 2071.\n\n--- FILE CONTENT (truncated) ---\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),",
"isError": false
},
"responseMessageId": "61b95298-757e-455f-8de0-c2497d51ff79"
}
]
},
{
"id": 72,
"role": "agent",
"timestamp": "2026-09-29T02:32:47.528Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:32:47.528Z",
"callId": "replace__call_67372",
"name": "replace",
"input": {
"new_string": " parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n parser.add_argument(\n \"--uniform-negatives\",\n type=int,\n default=Config.uniform_negatives,\n )\n parser.add_argument(\n \"--inbatch-negatives\",\n type=int,\n default=Config.inbatch_negatives,\n )\n parser.add_argument(\n \"--loss-type\",\n choices=(\"infonce\", \"bce\"),\n default=Config.loss_type,\n )\n parser.add_argument(\n \"--temperature\",\n type=float,\n default=Config.temperature,\n )\n parser.add_argument(\n \"--inbatch-correction-power\",\n type=float,\n default=Config.inbatch_correction_power,\n )\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n or args.temperature <= 0\n or args.uniform_negatives < 0\n or args.inbatch_negatives < 0\n ):\n parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n if args.uniform_negatives + args.inbatch_negatives < 1:\n parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n uniform_negatives=args.uniform_negatives,\n inbatch_negatives=args.inbatch_negatives,\n inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n loss_type=args.loss_type,\n temperature=args.temperature,\n seed=args.seed,\n )",
"allow_multiple": false,
"file_path": "/app/solution/train_current_model.py",
"old_string": " parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )",
"instruction": "Add loss-type, temperature, inbatch-negatives, uniform-negatives, and inbatch-correction-power CLI arguments"
},
"recorded": {
"id": "replace__call_67372",
"name": "replace",
"args": {
"new_string": " parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n parser.add_argument(\n \"--uniform-negatives\",\n type=int,\n default=Config.uniform_negatives,\n )\n parser.add_argument(\n \"--inbatch-negatives\",\n type=int,\n default=Config.inbatch_negatives,\n )\n parser.add_argument(\n \"--loss-type\",\n choices=(\"infonce\", \"bce\"),\n default=Config.loss_type,\n )\n parser.add_argument(\n \"--temperature\",\n type=float,\n default=Config.temperature,\n )\n parser.add_argument(\n \"--inbatch-correction-power\",\n type=float,\n default=Config.inbatch_correction_power,\n )\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n or args.temperature <= 0\n or args.uniform_negatives < 0\n or args.inbatch_negatives < 0\n ):\n parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n if args.uniform_negatives + args.inbatch_negatives < 1:\n parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n uniform_negatives=args.uniform_negatives,\n inbatch_negatives=args.inbatch_negatives,\n inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n loss_type=args.loss_type,\n temperature=args.temperature,\n seed=args.seed,\n )",
"allow_multiple": false,
"file_path": "/app/solution/train_current_model.py",
"old_string": " parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )",
"instruction": "Add loss-type, temperature, inbatch-negatives, uniform-negatives, and inbatch-correction-power CLI arguments"
},
"result": [
{
"functionResponse": {
"id": "replace__call_67372",
"name": "replace",
"response": {
"output": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n parser.add_argument(\n \"--uniform-negatives\",\n type=int,\n default=Config.uniform_negatives,\n )\n parser.add_argument(\n \"--inbatch-negatives\",\n type=int,\n default=Config.inbatch_negatives,\n )\n parser.add_argument(\n \"--loss-type\",\n choices=(\"infonce\", \"bce\"),\n default=Config.loss_type,\n )\n parser.add_argument(\n \"--temperature\",\n type=float,\n default=Config.temperature,\n )\n parser.add_argument(\n \"--inbatch-correction-power\",\n type=float,\n default=Config.inbatch_correction_power,\n )\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n...\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n or args.temperature <= 0\n or args.uniform_negatives < 0\n or args.inbatch_negatives < 0\n ):\n parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n if args.uniform_negatives + args.inbatch_negatives < 1:\n parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n...\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n uniform_negatives=args.uniform_negatives,\n inbatch_negatives=args.inbatch_negatives,\n inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n...\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n loss_type=args.loss_type,\n temperature=args.temperature,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n..."
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:32:47.545Z",
"resultDisplay": {
"fileDiff": "Index: train_current_model.py\n===================================================================\n--- train_current_model.py\tCurrent\n+++ train_current_model.py\tProposed\n@@ -1999,6 +1999,31 @@\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n+ parser.add_argument(\n+ \"--uniform-negatives\",\n+ type=int,\n+ default=Config.uniform_negatives,\n+ )\n+ parser.add_argument(\n+ \"--inbatch-negatives\",\n+ type=int,\n+ default=Config.inbatch_negatives,\n+ )\n+ parser.add_argument(\n+ \"--loss-type\",\n+ choices=(\"infonce\", \"bce\"),\n+ default=Config.loss_type,\n+ )\n+ parser.add_argument(\n+ \"--temperature\",\n+ type=float,\n+ default=Config.temperature,\n+ )\n+ parser.add_argument(\n+ \"--inbatch-correction-power\",\n+ type=float,\n+ default=Config.inbatch_correction_power,\n+ )\n args = parser.parse_args()\n \n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n@@ -2015,8 +2040,13 @@\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n+ or args.temperature <= 0\n+ or args.uniform_negatives < 0\n+ or args.inbatch_negatives < 0\n ):\n- parser.error(\"training counts, learning rate, and patience are invalid\")\n+ parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n+ if args.uniform_negatives + args.inbatch_negatives < 1:\n+ parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n@@ -2028,6 +2058,9 @@\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n+ uniform_negatives=args.uniform_negatives,\n+ inbatch_negatives=args.inbatch_negatives,\n+ inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n@@ -2039,6 +2072,8 @@\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n+ loss_type=args.loss_type,\n+ temperature=args.temperature,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n",
"fileName": "train_current_model.py",
"filePath": "/app/solution/train_current_model.py",
"originalContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n if config.loss_type == \"infonce\":\n all_logits = torch.cat(\n [positive_logits.unsqueeze(1), negative_logits], dim=1\n )\n scaled_logits = all_logits / config.temperature\n target_zeros = torch.zeros(\n len(all_logits), dtype=torch.long, device=device\n )\n row_losses = F.cross_entropy(\n scaled_logits, target_zeros, reduction=\"none\"\n )\n loss_sum = (selected_weights * row_losses).sum()\n else:\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n ):\n parser.error(\"training counts, learning rate, and patience are invalid\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"newContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n if config.loss_type == \"infonce\":\n all_logits = torch.cat(\n [positive_logits.unsqueeze(1), negative_logits], dim=1\n )\n scaled_logits = all_logits / config.temperature\n target_zeros = torch.zeros(\n len(all_logits), dtype=torch.long, device=device\n )\n row_losses = F.cross_entropy(\n scaled_logits, target_zeros, reduction=\"none\"\n )\n loss_sum = (selected_weights * row_losses).sum()\n else:\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n parser.add_argument(\n \"--uniform-negatives\",\n type=int,\n default=Config.uniform_negatives,\n )\n parser.add_argument(\n \"--inbatch-negatives\",\n type=int,\n default=Config.inbatch_negatives,\n )\n parser.add_argument(\n \"--loss-type\",\n choices=(\"infonce\", \"bce\"),\n default=Config.loss_type,\n )\n parser.add_argument(\n \"--temperature\",\n type=float,\n default=Config.temperature,\n )\n parser.add_argument(\n \"--inbatch-correction-power\",\n type=float,\n default=Config.inbatch_correction_power,\n )\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n or args.temperature <= 0\n or args.uniform_negatives < 0\n or args.inbatch_negatives < 0\n ):\n parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n if args.uniform_negatives + args.inbatch_negatives < 1:\n parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n uniform_negatives=args.uniform_negatives,\n inbatch_negatives=args.inbatch_negatives,\n inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n loss_type=args.loss_type,\n temperature=args.temperature,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"diffStat": {
"model_added_lines": 36,
"model_removed_lines": 1,
"model_added_chars": 1144,
"model_removed_chars": 80,
"user_added_lines": 0,
"user_removed_lines": 0,
"user_added_chars": 0,
"user_removed_chars": 0
},
"isNewFile": false,
"isBuildFile": false
},
"description": "solution/train_current_model.py: parser.add_argument(\"--che... => parser.add_argument(\"--che...",
"displayName": "Edit",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:32:47.547Z",
"content": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n parser.add_argument(\n \"--uniform-negatives\",\n type=int,\n default=Config.uniform_negatives,\n )\n parser.add_argument(\n \"--inbatch-negatives\",\n type=int,\n default=Config.inbatch_negatives,\n )\n parser.add_argument(\n \"--loss-type\",\n choices=(\"infonce\", \"bce\"),\n default=Config.loss_type,\n )\n parser.add_argument(\n \"--temperature\",\n type=float,\n default=Config.temperature,\n )\n parser.add_argument(\n \"--inbatch-correction-power\",\n type=float,\n default=Config.inbatch_correction_power,\n )\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n...\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n or args.temperature <= 0\n or args.uniform_negatives < 0\n or args.inbatch_negatives < 0\n ):\n parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n if args.uniform_negatives + args.inbatch_negatives < 1:\n parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n...\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n uniform_negatives=args.uniform_negatives,\n inbatch_negatives=args.inbatch_negatives,\n inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n...\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n loss_type=args.loss_type,\n temperature=args.temperature,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n...",
"isError": false
},
"responseMessageId": "85f6ffe3-f6b4-438c-8dfa-bb8162e24dc2"
}
]
},
{
"id": 73,
"role": "agent",
"timestamp": "2026-09-29T02:32:52.837Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:32:52.837Z",
"callId": "run_shell_command__call_42459",
"name": "run_shell_command",
"input": {
"command": "python3 -m py_compile /app/solution/train_current_model.py /app/solution/two_tower_model.py",
"description": "Check syntax of modified files"
},
"recorded": {
"id": "run_shell_command__call_42459",
"name": "run_shell_command",
"args": {
"command": "python3 -m py_compile /app/solution/train_current_model.py /app/solution/two_tower_model.py",
"description": "Check syntax of modified files"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_42459",
"name": "run_shell_command",
"response": {
"output": "\nOutput: (empty)\nProcess Group PGID: 1984\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:32:52.986Z",
"resultDisplay": "",
"description": "python3 -m py_compile /app/solution/train_current_model.py /app/solution/two_tower_model.py",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:32:52.988Z",
"content": "\nOutput: (empty)\nProcess Group PGID: 1984\n",
"isError": false
},
"responseMessageId": "9870942b-1a2c-45da-9cad-d83d9c29c96d"
}
]
},
{
"id": 74,
"role": "agent",
"timestamp": "2026-09-29T02:32:57.820Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:32:57.820Z",
"text": "Testing Validation Parameters\n\nI'm currently running a validation test using `--prepared-cache /app/solution/validation_cache.npz`, `--loss-type infonce`, `--temperature 0.1`, `--inbatch-negatives 16`, `--uniform-negatives 16`, and `--target-weighting discovery-graded`. This should confirm proper syntax and initial performance."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:32:57.820Z",
"callId": "run_shell_command__call_2223503",
"name": "run_shell_command",
"input": {
"description": "Train model with InfoNCE loss (tau=0.1) and balanced mixed negatives",
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --loss-type infonce \\\n --temperature 0.1 \\\n --inbatch-negatives 16 \\\n --uniform-negatives 16 \\\n --target-weighting discovery-graded \\\n --output /app/solution/exp2_infonce_temp01.parquet"
},
"recorded": {
"id": "run_shell_command__call_2223503",
"name": "run_shell_command",
"args": {
"description": "Train model with InfoNCE loss (tau=0.1) and balanced mixed negatives",
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --loss-type infonce \\\n --temperature 0.1 \\\n --inbatch-negatives 16 \\\n --uniform-negatives 16 \\\n --target-weighting discovery-graded \\\n --output /app/solution/exp2_infonce_temp01.parquet"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_2223503",
"name": "run_shell_command",
"response": {
"output": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=1.000 mean_on_targets=1.000 max=1.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=2.870373 running_bce=3.030580 elapsed=168.5s\nepoch=1/1 train_loss=3.01451 validation_loss=2.72296 pair_accuracy=0.749 train_targets=1,052,953 validation_targets=130,103 train_seconds=179.7 validation_seconds=12.9\nrestored best validation-BCE checkpoint: epoch=1 loss=2.722959\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp2_infonce_temp01.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 283.192,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 16,\n \"inbatch_negatives\": 16,\n \"inbatch_correction_power\": 0.0,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"infonce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 3.01451297931506,\n \"positive_logit\": 0.030721335030194117,\n \"negative_logit\": -0.0895066697864918,\n \"pair_accuracy\": 0.7490015283208272,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 179.73861006900006,\n \"validation_loss\": 2.722958876426524,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 12.901669591999962\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 0.662067174911499,\n \"query_norm_std\": 0.17041468620300293,\n \"item_norm_mean\": 0.8260043859481812,\n \"item_norm_std\": 0.1920192688703537\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 1987\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:37:45.401Z",
"resultDisplay": "loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=1.000 mean_on_targets=1.000 max=1.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=2.870373 running_bce=3.030580 elapsed=168.5s\nepoch=1/1 train_loss=3.01451 validation_loss=2.72296 pair_accuracy=0.749 train_targets=1,052,953 validation_targets=130,103 train_seconds=179.7 validation_seconds=12.9\nrestored best validation-BCE checkpoint: epoch=1 loss=2.722959\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp2_infonce_temp01.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 283.192,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 16,\n \"inbatch_negatives\": 16,\n \"inbatch_correction_power\": 0.0,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"infonce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 3.01451297931506,\n \"positive_logit\": 0.030721335030194117,\n \"negative_logit\": -0.0895066697864918,\n \"pair_accuracy\": 0.7490015283208272,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 179.73861006900006,\n \"validation_loss\": 2.722958876426524,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 12.901669591999962\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 0.662067174911499,\n \"query_norm_std\": 0.17041468620300293,\n \"item_norm_mean\": 0.8260043859481812,\n \"item_norm_std\": 0.1920192688703537\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}",
"description": "Train model with InfoNCE loss (tau=0.1) and balanced mixed negatives",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:37:45.403Z",
"content": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=1.000 mean_on_targets=1.000 max=1.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=2.870373 running_bce=3.030580 elapsed=168.5s\nepoch=1/1 train_loss=3.01451 validation_loss=2.72296 pair_accuracy=0.749 train_targets=1,052,953 validation_targets=130,103 train_seconds=179.7 validation_seconds=12.9\nrestored best validation-BCE checkpoint: epoch=1 loss=2.722959\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp2_infonce_temp01.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 283.192,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 16,\n \"inbatch_negatives\": 16,\n \"inbatch_correction_power\": 0.0,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"infonce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 3.01451297931506,\n \"positive_logit\": 0.030721335030194117,\n \"negative_logit\": -0.0895066697864918,\n \"pair_accuracy\": 0.7490015283208272,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 179.73861006900006,\n \"validation_loss\": 2.722958876426524,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 12.901669591999962\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 0.662067174911499,\n \"query_norm_std\": 0.17041468620300293,\n \"item_norm_mean\": 0.8260043859481812,\n \"item_norm_std\": 0.1920192688703537\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 1987\n",
"isError": false
},
"responseMessageId": "a150d80c-584a-4469-828d-2a938b8b7ed7"
}
]
},
{
"id": 75,
"role": "agent",
"timestamp": "2026-09-29T02:37:51.014Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:37:51.014Z",
"callId": "run_shell_command__call_5882596",
"name": "run_shell_command",
"input": {
"description": "Evaluate InfoNCE ranking on validation public backtest",
"command": "python3 /task/evaluate_public.py /app/solution/exp2_infonce_temp01.parquet"
},
"recorded": {
"id": "run_shell_command__call_5882596",
"name": "run_shell_command",
"args": {
"description": "Evaluate InfoNCE ranking on validation public backtest",
"command": "python3 /task/evaluate_public.py /app/solution/exp2_infonce_temp01.parquet"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5882596",
"name": "run_shell_command",
"response": {
"output": "\nOutput: {\n \"model\": \"/app/solution/exp2_infonce_temp01.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.009139,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 2018\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:37:54.426Z",
"resultDisplay": "{\n \"model\": \"/app/solution/exp2_infonce_temp01.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.009139,\n \"quality_users\": 4263\n }\n}",
"description": "python3 /task/evaluate_public.py /app/solution/exp2_infonce_temp01.parquet",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:37:54.428Z",
"content": "\nOutput: {\n \"model\": \"/app/solution/exp2_infonce_temp01.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.009139,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 2018\n",
"isError": false
},
"responseMessageId": "2f7ca7dd-3c70-480e-ac8a-da96f717c95f"
}
]
},
{
"id": 76,
"role": "agent",
"timestamp": "2026-09-29T02:38:00.571Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:38:00.571Z",
"text": "Analyzing InfoNCE Output\n\nMy focus is on understanding this seemingly low InfoNCE score of 0.009139, especially given $\\tau = 0.1$. I'm digging into the diagnostics to pinpoint the cause, specifically the relationship between the positive and negative logits."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:38:00.571Z",
"callId": "run_shell_command__call_3392420",
"name": "run_shell_command",
"input": {
"command": "python3 -c \"\nimport pandas as pd\ndf = pd.read_parquet('/app/solution/exp2_infonce_temp01.parquet')\nprint('Unique items in top 10:', df[df['rank'] <= 10].item_id.nunique())\nprint('Top 10 items frequency:')\nprint(df[df['rank'] <= 10].item_id.value_counts().head(10))\n\"",
"description": "Inspect InfoNCE recommendations"
},
"recorded": {
"id": "run_shell_command__call_3392420",
"name": "run_shell_command",
"args": {
"command": "python3 -c \"\nimport pandas as pd\ndf = pd.read_parquet('/app/solution/exp2_infonce_temp01.parquet')\nprint('Unique items in top 10:', df[df['rank'] <= 10].item_id.nunique())\nprint('Top 10 items frequency:')\nprint(df[df['rank'] <= 10].item_id.value_counts().head(10))\n\"",
"description": "Inspect InfoNCE recommendations"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_3392420",
"name": "run_shell_command",
"response": {
"output": "\nOutput: Unique items in top 10: 1784\nTop 10 items frequency:\nitem_id\n507106 1262\n1027979 723\n4986107 637\n2746728 632\n3541844 611\n8800739 605\n3221901 568\n8410352 568\n8410563 566\n2317630 560\nName: count, dtype: int64\nProcess Group PGID: 2038\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:38:02.146Z",
"resultDisplay": "Unique items in top 10: 1784\nTop 10 items frequency:\nitem_id\n507106 1262\n1027979 723\n4986107 637\n2746728 632\n3541844 611\n8800739 605\n3221901 568\n8410352 568\n8410563 566\n2317630 560\nName: count, dtype: int64",
"description": "Inspect InfoNCE recommendations",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:38:04.084Z",
"content": "\nOutput: Unique items in top 10: 1784\nTop 10 items frequency:\nitem_id\n507106 1262\n1027979 723\n4986107 637\n2746728 632\n3541844 611\n8800739 605\n3221901 568\n8410352 568\n8410563 566\n2317630 560\nName: count, dtype: int64\nProcess Group PGID: 2038\n",
"isError": false
},
"responseMessageId": "67392750-d310-4684-b368-a9bddc6c0c61"
}
]
},
{
"id": 77,
"role": "agent",
"timestamp": "2026-09-29T02:38:08.008Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:38:08.008Z",
"text": "Testing BCE Approach\n\nI'm now focusing on Binary Cross-Entropy (BCE) to address the signal collapse observed with InfoNCE. My current thinking is to integrate BCE with the newly implemented in-batch sampling, hoping this combination will yield a more robust outcome."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:38:08.008Z",
"callId": "run_shell_command__call_72481",
"name": "run_shell_command",
"input": {
"description": "Train model with BCE loss and true in-batch sampling",
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --loss-type bce \\\n --inbatch-negatives 16 \\\n --uniform-negatives 16 \\\n --inbatch-correction-power 0.0 \\\n --target-weighting discovery-graded \\\n --output /app/solution/exp3_bce_inbatch16.parquet"
},
"recorded": {
"id": "run_shell_command__call_72481",
"name": "run_shell_command",
"args": {
"description": "Train model with BCE loss and true in-batch sampling",
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --loss-type bce \\\n --inbatch-negatives 16 \\\n --uniform-negatives 16 \\\n --inbatch-correction-power 0.0 \\\n --target-weighting discovery-graded \\\n --output /app/solution/exp3_bce_inbatch16.parquet"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_72481",
"name": "run_shell_command",
"response": {
"output": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=1.000 mean_on_targets=1.000 max=1.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.554008 running_bce=0.591378 elapsed=168.7s\nepoch=1/1 train_loss=0.58790 validation_loss=0.52305 pair_accuracy=0.737 train_targets=1,052,953 validation_targets=130,103 train_seconds=180.1 validation_seconds=13.0\nrestored best validation-BCE checkpoint: epoch=1 loss=0.523049\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp3_bce_inbatch16.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 283.411,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 16,\n \"inbatch_negatives\": 16,\n \"inbatch_correction_power\": 0.0,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5878969085176191,\n \"positive_logit\": 0.4752256236032197,\n \"negative_logit\": -0.5672485375640002,\n \"pair_accuracy\": 0.7371169166619973,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 180.1402166779999,\n \"validation_loss\": 0.5230490383229901,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 12.996861134000028\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.6657280921936035,\n \"query_norm_std\": 0.7470276951789856,\n \"item_norm_mean\": 2.005955457687378,\n \"item_norm_std\": 0.7420915365219116\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 2056\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:42:55.807Z",
"resultDisplay": "loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=1.000 mean_on_targets=1.000 max=1.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.554008 running_bce=0.591378 elapsed=168.7s\nepoch=1/1 train_loss=0.58790 validation_loss=0.52305 pair_accuracy=0.737 train_targets=1,052,953 validation_targets=130,103 train_seconds=180.1 validation_seconds=13.0\nrestored best validation-BCE checkpoint: epoch=1 loss=0.523049\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp3_bce_inbatch16.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 283.411,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 16,\n \"inbatch_negatives\": 16,\n \"inbatch_correction_power\": 0.0,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5878969085176191,\n \"positive_logit\": 0.4752256236032197,\n \"negative_logit\": -0.5672485375640002,\n \"pair_accuracy\": 0.7371169166619973,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 180.1402166779999,\n \"validation_loss\": 0.5230490383229901,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 12.996861134000028\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.6657280921936035,\n \"query_norm_std\": 0.7470276951789856,\n \"item_norm_mean\": 2.005955457687378,\n \"item_norm_std\": 0.7420915365219116\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}",
"description": "Train model with BCE loss and true in-batch sampling",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:42:55.810Z",
"content": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=1.000 mean_on_targets=1.000 max=1.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.554008 running_bce=0.591378 elapsed=168.7s\nepoch=1/1 train_loss=0.58790 validation_loss=0.52305 pair_accuracy=0.737 train_targets=1,052,953 validation_targets=130,103 train_seconds=180.1 validation_seconds=13.0\nrestored best validation-BCE checkpoint: epoch=1 loss=0.523049\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp3_bce_inbatch16.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 283.411,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 16,\n \"inbatch_negatives\": 16,\n \"inbatch_correction_power\": 0.0,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5878969085176191,\n \"positive_logit\": 0.4752256236032197,\n \"negative_logit\": -0.5672485375640002,\n \"pair_accuracy\": 0.7371169166619973,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 180.1402166779999,\n \"validation_loss\": 0.5230490383229901,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 12.996861134000028\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.6657280921936035,\n \"query_norm_std\": 0.7470276951789856,\n \"item_norm_mean\": 2.005955457687378,\n \"item_norm_std\": 0.7420915365219116\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 2056\n",
"isError": false
},
"responseMessageId": "43707542-2d54-4b76-a152-7c2405c28d95"
}
]
},
{
"id": 78,
"role": "agent",
"timestamp": "2026-09-29T02:43:01.668Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:43:01.668Z",
"callId": "run_shell_command__call_179778",
"name": "run_shell_command",
"input": {
"description": "Evaluate exp3 ranking",
"command": "python3 /task/evaluate_public.py /app/solution/exp3_bce_inbatch16.parquet"
},
"recorded": {
"id": "run_shell_command__call_179778",
"name": "run_shell_command",
"args": {
"description": "Evaluate exp3 ranking",
"command": "python3 /task/evaluate_public.py /app/solution/exp3_bce_inbatch16.parquet"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_179778",
"name": "run_shell_command",
"response": {
"output": "\nOutput: {\n \"model\": \"/app/solution/exp3_bce_inbatch16.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.011252,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 2087\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:43:05.035Z",
"resultDisplay": "{\n \"model\": \"/app/solution/exp3_bce_inbatch16.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.011252,\n \"quality_users\": 4263\n }\n}",
"description": "python3 /task/evaluate_public.py /app/solution/exp3_bce_inbatch16.parquet",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:43:05.037Z",
"content": "\nOutput: {\n \"model\": \"/app/solution/exp3_bce_inbatch16.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.011252,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 2087\n",
"isError": false
},
"responseMessageId": "c19655ee-d6cd-4c87-9fe0-0012689daf3c"
}
]
},
{
"id": 79,
"role": "agent",
"timestamp": "2026-09-29T02:43:11.271Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:43:11.271Z",
"callId": "run_shell_command__call_68346",
"name": "run_shell_command",
"input": {
"description": "Check exp3 item frequencies",
"command": "python3 -c \"\nimport pandas as pd\ndf = pd.read_parquet('/app/solution/exp3_bce_inbatch16.parquet')\nprint('Unique items in top 10:', df[df['rank'] <= 10].item_id.nunique())\nprint('Top 10 items frequency:')\nprint(df[df['rank'] <= 10].item_id.value_counts().head(10))\n\""
},
"recorded": {
"id": "run_shell_command__call_68346",
"name": "run_shell_command",
"args": {
"description": "Check exp3 item frequencies",
"command": "python3 -c \"\nimport pandas as pd\ndf = pd.read_parquet('/app/solution/exp3_bce_inbatch16.parquet')\nprint('Unique items in top 10:', df[df['rank'] <= 10].item_id.nunique())\nprint('Top 10 items frequency:')\nprint(df[df['rank'] <= 10].item_id.value_counts().head(10))\n\""
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_68346",
"name": "run_shell_command",
"response": {
"output": "\nOutput: Unique items in top 10: 1154\nTop 10 items frequency:\nitem_id\n8722394 765\n5436843 659\n5927996 653\n2317630 646\n5252571 612\n3970945 597\n5615742 588\n6896222 588\n2746728 577\n175065 565\nName: count, dtype: int64\nProcess Group PGID: 2107\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:43:12.860Z",
"resultDisplay": "Unique items in top 10: 1154\nTop 10 items frequency:\nitem_id\n8722394 765\n5436843 659\n5927996 653\n2317630 646\n5252571 612\n3970945 597\n5615742 588\n6896222 588\n2746728 577\n175065 565\nName: count, dtype: int64",
"description": "Check exp3 item frequencies",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:43:12.863Z",
"content": "\nOutput: Unique items in top 10: 1154\nTop 10 items frequency:\nitem_id\n8722394 765\n5436843 659\n5927996 653\n2317630 646\n5252571 612\n3970945 597\n5615742 588\n6896222 588\n2746728 577\n175065 565\nName: count, dtype: int64\nProcess Group PGID: 2107\n",
"isError": false
},
"responseMessageId": "28de6ded-ff62-49b7-93ad-9992821b5196"
}
]
},
{
"id": 80,
"role": "agent",
"timestamp": "2026-09-29T02:43:31.459Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:43:31.459Z",
"text": "Analyzing Recommendation Performance\n\nMy recent focus has been on evaluating the impact of different recommendation strategies. Experiment 1 showed a slight improvement in NDCG@10 and fewer top recommendations, while Experiment 2 yielded a significant drop in performance. I'm still digging into why Experiment 2 underperformed so drastically."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:43:31.459Z",
"text": "Investigating NDCG Drop\n\nI'm currently perplexed by Experiment 3, where sampling in-batch negatives directly from targets led to a drastic NDCG@10 drop. My initial hypothesis is that this popular item sampling suppressed the embeddings of frequently occurring items, hindering their recommendation. I need to verify this."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:43:31.459Z",
"text": "Revising Negative Sampling Strategy\n\nI've uncovered a significant NDCG@10 drop to 0.0112, a stark contrast to the 0.0235 baseline. It appears my previous approach of sampling in-batch negatives without propensity correction excessively penalized moderately popular tracks, which users actually engage with. I'm revisiting the baseline's `inbatch_correction` logic."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:43:31.459Z",
"text": "Refining Negative Sampling\n\nI'm scrutinizing the baseline trainer's negative sampling, particularly its use of `inbatch_negatives=8` with `unique_targets`. The parameters `inbatch_correction_power`, `min`, and `max` suggest a sophisticated correction mechanism I need to fully grasp and leverage for improved performance."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:43:31.459Z",
"text": "Understanding Baseline Correction\n\nI'm dissecting the baseline's `corrected_negative_loss` function. My current focus is on how it calculates and applies corrections for in-batch negatives. The logic involving `corrected_count` and the sampling of `priorities` seems crucial to the performance I'm trying to replicate."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:43:31.459Z",
"text": "Decoding Correction Factors\n\nI'm currently analyzing the `correction` matrix within the `corrected_negative_loss` function. My current focus is to understand its origin and how it's being applied to adjust the raw negative sampling. This seems to be the key to replicating the baseline's performance."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:43:31.459Z",
"text": "Re-evaluating Correction Logic\n\nI'm scrutinizing the baseline's handling of invalid in-batch negatives. It appears rejected items are simply replaced with uniform random draws, and their correction factor is reset to 1.0. This might be a crucial oversight contributing to performance issues I'm observing."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:43:31.459Z",
"text": "Exploring Negative Sampling Options\n\nI'm now considering other limitations in how negative examples are chosen and used for training. I'm particularly interested in whether explicit dislikes, short listens, skips, or even popularity rank play a role, and how varying the number of uniform versus in-batch negatives might affect outcomes."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:43:31.459Z",
"text": "Testing Negative Filter Scope\n\nI'm investigating the impact of `context_items` within `invalid_negative_mask`. My suspicion is that it's being limited to the last 100 items, and I want to test if setting `--negative-filter-scope last-100` directly addresses this limitation."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:43:31.459Z",
"text": "Adjusting Target Weights\n\nI've identified a significant improvement by using `discovery-graded` target weighting, boosting scores. I'm now exploring whether adjusting the weights for different grades, especially `organic_like_target_weight`, and potentially reducing `ordinary_target_weight`, can further enhance performance."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:43:31.459Z",
"callId": "run_shell_command__call_599893",
"name": "run_shell_command",
"input": {
"description": "Diff our changes against current_model",
"command": "diff -u /task/current_model/train_current_model.py /app/solution/train_current_model.py"
},
"recorded": {
"id": "run_shell_command__call_599893",
"name": "run_shell_command",
"args": {
"description": "Diff our changes against current_model",
"command": "diff -u /task/current_model/train_current_model.py /app/solution/train_current_model.py"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_599893",
"name": "run_shell_command",
"response": {
"output": "\nOutput: --- /task/current_model/train_current_model.py\t2026-09-29 01:59:28.000000000 +0000\n+++ /app/solution/train_current_model.py\t2026-09-29 02:32:47.532785741 +0000\n@@ -53,13 +53,13 @@\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n- uniform_negatives: int = 24\n- inbatch_negatives: int = 8\n- inbatch_correction_power: float = 0.5\n+ uniform_negatives: int = 16\n+ inbatch_negatives: int = 16\n+ inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n- target_weighting: str = \"organic-strong\"\n+ target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n@@ -69,6 +69,8 @@\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n+ loss_type: str = \"infonce\"\n+ temperature: float = 0.10\n seed: int = 29\n \n \n@@ -650,33 +652,15 @@\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n- if config.inbatch_negatives:\n- unique_targets = torch.unique(targets.detach().cpu())\n- corrected_count = min(\n- config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n- )\n- if corrected_count:\n- priorities = torch.rand(\n- (batch_size, len(unique_targets)), generator=generator\n- )\n- priorities.masked_fill_(\n- unique_targets[None, :].eq(\n- torch.from_numpy(targets_cpu)[:, None]\n- ),\n- -1.0,\n- )\n- columns = torch.topk(\n- priorities, k=corrected_count, dim=1\n- ).indices\n- inbatch = unique_targets[columns]\n- if corrected_count < config.inbatch_negatives:\n- filler = torch.randint(\n- n_items,\n- (batch_size, config.inbatch_negatives - corrected_count),\n- generator=generator,\n- device=\"cpu\",\n- )\n- inbatch = torch.cat([inbatch, filler], dim=1)\n+ if config.inbatch_negatives and batch_size > 0:\n+ rand_indices = torch.randint(\n+ batch_size,\n+ (batch_size, config.inbatch_negatives),\n+ generator=generator,\n+ device=\"cpu\",\n+ ).numpy()\n+ inbatch = torch.from_numpy(targets_cpu[rand_indices])\n+ corrected_count = config.inbatch_negatives\n \n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n@@ -1168,16 +1152,29 @@\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n- positive_loss = F.softplus(-positive_logits)\n- negative_loss = corrected_negative_loss(\n- negative_logits, negative_weights[begin:end], config\n- )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n- loss_sum = (\n- selected_weights * (positive_loss + negative_loss) / 2.0\n- ).sum()\n+ if config.loss_type == \"infonce\":\n+ all_logits = torch.cat(\n+ [positive_logits.unsqueeze(1), negative_logits], dim=1\n+ )\n+ scaled_logits = all_logits / config.temperature\n+ target_zeros = torch.zeros(\n+ len(all_logits), dtype=torch.long, device=device\n+ )\n+ row_losses = F.cross_entropy(\n+ scaled_logits, target_zeros, reduction=\"none\"\n+ )\n+ loss_sum = (selected_weights * row_losses).sum()\n+ else:\n+ positive_loss = F.softplus(-positive_logits)\n+ negative_loss = corrected_negative_loss(\n+ negative_logits, negative_weights[begin:end], config\n+ )\n+ loss_sum = (\n+ selected_weights * (positive_loss + negative_loss) / 2.0\n+ ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n@@ -2002,6 +1999,31 @@\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n+ parser.add_argument(\n+ \"--uniform-negatives\",\n+ type=int,\n+ default=Config.uniform_negatives,\n+ )\n+ parser.add_argument(\n+ \"--inbatch-negatives\",\n+ type=int,\n+ default=Config.inbatch_negatives,\n+ )\n+ parser.add_argument(\n+ \"--loss-type\",\n+ choices=(\"infonce\", \"bce\"),\n+ default=Config.loss_type,\n+ )\n+ parser.add_argument(\n+ \"--temperature\",\n+ type=float,\n+ default=Config.temperature,\n+ )\n+ parser.add_argument(\n+ \"--inbatch-correction-power\",\n+ type=float,\n+ default=Config.inbatch_correction_power,\n+ )\n args = parser.parse_args()\n \n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n@@ -2018,8 +2040,13 @@\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n+ or args.temperature <= 0\n+ or args.uniform_negatives < 0\n+ or args.inbatch_negatives < 0\n ):\n- parser.error(\"training counts, learning rate, and patience are invalid\")\n+ parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n+ if args.uniform_negatives + args.inbatch_negatives < 1:\n+ parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n@@ -2031,6 +2058,9 @@\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n+ uniform_negatives=args.uniform_negatives,\n+ inbatch_negatives=args.inbatch_negatives,\n+ inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n@@ -2042,6 +2072,8 @@\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n+ loss_type=args.loss_type,\n+ temperature=args.temperature,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\nExit Code: 1\nProcess Group PGID: 2126\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:43:31.475Z",
"resultDisplay": "--- /task/current_model/train_current_model.py\t2026-09-29 01:59:28.000000000 +0000\n+++ /app/solution/train_current_model.py\t2026-09-29 02:32:47.532785741 +0000\n@@ -53,13 +53,13 @@\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n- uniform_negatives: int = 24\n- inbatch_negatives: int = 8\n- inbatch_correction_power: float = 0.5\n+ uniform_negatives: int = 16\n+ inbatch_negatives: int = 16\n+ inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n- target_weighting: str = \"organic-strong\"\n+ target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n@@ -69,6 +69,8 @@\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n+ loss_type: str = \"infonce\"\n+ temperature: float = 0.10\n seed: int = 29\n \n \n@@ -650,33 +652,15 @@\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n- if config.inbatch_negatives:\n- unique_targets = torch.unique(targets.detach().cpu())\n- corrected_count = min(\n- config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n- )\n- if corrected_count:\n- priorities = torch.rand(\n- (batch_size, len(unique_targets)), generator=generator\n- )\n- priorities.masked_fill_(\n- unique_targets[None, :].eq(\n- torch.from_numpy(targets_cpu)[:, None]\n- ),\n- -1.0,\n- )\n- columns = torch.topk(\n- priorities, k=corrected_count, dim=1\n- ).indices\n- inbatch = unique_targets[columns]\n- if corrected_count < config.inbatch_negatives:\n- filler = torch.randint(\n- n_items,\n- (batch_size, config.inbatch_negatives - corrected_count),\n- generator=generator,\n- device=\"cpu\",\n- )\n- inbatch = torch.cat([inbatch, filler], dim=1)\n+ if config.inbatch_negatives and batch_size > 0:\n+ rand_indices = torch.randint(\n+ batch_size,\n+ (batch_size, config.inbatch_negatives),\n+ generator=generator,\n+ device=\"cpu\",\n+ ).numpy()\n+ inbatch = torch.from_numpy(targets_cpu[rand_indices])\n+ corrected_count = config.inbatch_negatives\n \n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n@@ -1168,16 +1152,29 @@\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n- positive_loss = F.softplus(-positive_logits)\n- negative_loss = corrected_negative_loss(\n- negative_logits, negative_weights[begin:end], config\n- )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n- loss_sum = (\n- selected_weights * (positive_loss + negative_loss) / 2.0\n- ).sum()\n+ if config.loss_type == \"infonce\":\n+ all_logits = torch.cat(\n+ [positive_logits.unsqueeze(1), negative_logits], dim=1\n+ )\n+ scaled_logits = all_logits / config.temperature\n+ target_zeros = torch.zeros(\n+ len(all_logits), dtype=torch.long, device=device\n+ )\n+ row_losses = F.cross_entropy(\n+ scaled_logits, target_zeros, reduction=\"none\"\n+ )\n+ loss_sum = (selected_weights * row_losses).sum()\n+ else:\n+ positive_loss = F.softplus(-positive_logits)\n+ negative_loss = corrected_negative_loss(\n+ negative_logits, negative_weights[begin:end], config\n+ )\n+ loss_sum = (\n+ selected_weights * (positive_loss + negative_loss) / 2.0\n+ ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n@@ -2002,6 +1999,31 @@\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n+ parser.add_argument(\n+ \"--uniform-negatives\",\n+ type=int,\n+ default=Config.uniform_negatives,\n+ )\n+ parser.add_argument(\n+ \"--inbatch-negatives\",\n+ type=int,\n+ default=Config.inbatch_negatives,\n+ )\n+ parser.add_argument(\n+ \"--loss-type\",\n+ choices=(\"infonce\", \"bce\"),\n+ default=Config.loss_type,\n+ )\n+ parser.add_argument(\n+ \"--temperature\",\n+ type=float,\n+ default=Config.temperature,\n+ )\n+ parser.add_argument(\n+ \"--inbatch-correction-power\",\n+ type=float,\n+ default=Config.inbatch_correction_power,\n+ )\n args = parser.parse_args()\n \n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n@@ -2018,8 +2040,13 @@\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n+ or args.temperature <= 0\n+ or args.uniform_negatives < 0\n+ or args.inbatch_negatives < 0\n ):\n- parser.error(\"training counts, learning rate, and patience are invalid\")\n+ parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n+ if args.uniform_negatives + args.inbatch_negatives < 1:\n+ parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n@@ -2031,6 +2058,9 @@\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n+ uniform_negatives=args.uniform_negatives,\n+ inbatch_negatives=args.inbatch_negatives,\n+ inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n@@ -2042,6 +2072,8 @@\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n+ loss_type=args.loss_type,\n+ temperature=args.temperature,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)",
"description": "diff -u /task/current_model/train_current_model.py /app/solution/train_current_model.py",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:43:31.477Z",
"content": "\nOutput: --- /task/current_model/train_current_model.py\t2026-09-29 01:59:28.000000000 +0000\n+++ /app/solution/train_current_model.py\t2026-09-29 02:32:47.532785741 +0000\n@@ -53,13 +53,13 @@\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n- uniform_negatives: int = 24\n- inbatch_negatives: int = 8\n- inbatch_correction_power: float = 0.5\n+ uniform_negatives: int = 16\n+ inbatch_negatives: int = 16\n+ inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n- target_weighting: str = \"organic-strong\"\n+ target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n@@ -69,6 +69,8 @@\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n+ loss_type: str = \"infonce\"\n+ temperature: float = 0.10\n seed: int = 29\n \n \n@@ -650,33 +652,15 @@\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n- if config.inbatch_negatives:\n- unique_targets = torch.unique(targets.detach().cpu())\n- corrected_count = min(\n- config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n- )\n- if corrected_count:\n- priorities = torch.rand(\n- (batch_size, len(unique_targets)), generator=generator\n- )\n- priorities.masked_fill_(\n- unique_targets[None, :].eq(\n- torch.from_numpy(targets_cpu)[:, None]\n- ),\n- -1.0,\n- )\n- columns = torch.topk(\n- priorities, k=corrected_count, dim=1\n- ).indices\n- inbatch = unique_targets[columns]\n- if corrected_count < config.inbatch_negatives:\n- filler = torch.randint(\n- n_items,\n- (batch_size, config.inbatch_negatives - corrected_count),\n- generator=generator,\n- device=\"cpu\",\n- )\n- inbatch = torch.cat([inbatch, filler], dim=1)\n+ if config.inbatch_negatives and batch_size > 0:\n+ rand_indices = torch.randint(\n+ batch_size,\n+ (batch_size, config.inbatch_negatives),\n+ generator=generator,\n+ device=\"cpu\",\n+ ).numpy()\n+ inbatch = torch.from_numpy(targets_cpu[rand_indices])\n+ corrected_count = config.inbatch_negatives\n \n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n@@ -1168,16 +1152,29 @@\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n- positive_loss = F.softplus(-positive_logits)\n- negative_loss = corrected_negative_loss(\n- negative_logits, negative_weights[begin:end], config\n- )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n- loss_sum = (\n- selected_weights * (positive_loss + negative_loss) / 2.0\n- ).sum()\n+ if config.loss_type == \"infonce\":\n+ all_logits = torch.cat(\n+ [positive_logits.unsqueeze(1), negative_logits], dim=1\n+ )\n+ scaled_logits = all_logits / config.temperature\n+ target_zeros = torch.zeros(\n+ len(all_logits), dtype=torch.long, device=device\n+ )\n+ row_losses = F.cross_entropy(\n+ scaled_logits, target_zeros, reduction=\"none\"\n+ )\n+ loss_sum = (selected_weights * row_losses).sum()\n+ else:\n+ positive_loss = F.softplus(-positive_logits)\n+ negative_loss = corrected_negative_loss(\n+ negative_logits, negative_weights[begin:end], config\n+ )\n+ loss_sum = (\n+ selected_weights * (positive_loss + negative_loss) / 2.0\n+ ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n@@ -2002,6 +1999,31 @@\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n+ parser.add_argument(\n+ \"--uniform-negatives\",\n+ type=int,\n+ default=Config.uniform_negatives,\n+ )\n+ parser.add_argument(\n+ \"--inbatch-negatives\",\n+ type=int,\n+ default=Config.inbatch_negatives,\n+ )\n+ parser.add_argument(\n+ \"--loss-type\",\n+ choices=(\"infonce\", \"bce\"),\n+ default=Config.loss_type,\n+ )\n+ parser.add_argument(\n+ \"--temperature\",\n+ type=float,\n+ default=Config.temperature,\n+ )\n+ parser.add_argument(\n+ \"--inbatch-correction-power\",\n+ type=float,\n+ default=Config.inbatch_correction_power,\n+ )\n args = parser.parse_args()\n \n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n@@ -2018,8 +2040,13 @@\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n+ or args.temperature <= 0\n+ or args.uniform_negatives < 0\n+ or args.inbatch_negatives < 0\n ):\n- parser.error(\"training counts, learning rate, and patience are invalid\")\n+ parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n+ if args.uniform_negatives + args.inbatch_negatives < 1:\n+ parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n@@ -2031,6 +2058,9 @@\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n+ uniform_negatives=args.uniform_negatives,\n+ inbatch_negatives=args.inbatch_negatives,\n+ inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n@@ -2042,6 +2072,8 @@\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n+ loss_type=args.loss_type,\n+ temperature=args.temperature,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\nExit Code: 1\nProcess Group PGID: 2126\n",
"isError": false
},
"responseMessageId": "ceee0ebd-9526-4b13-a054-0fae61df9686"
}
]
},
{
"id": 81,
"role": "agent",
"timestamp": "2026-09-29T02:44:06.406Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Analyzing draw_full_history_filtered_negatives\n\nMy focus has been on understanding the surprisingly low NDCG (0.011252) observed in Experiment 3 of `draw_full_history_filtered_negatives` with `inbatch_negatives = 16` and `uniform_negatives = 16`, specifically questioning the impact of `inbatch_correction_power = 0.0`."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Investigating In-Batch Correction Power\n\nI'm analyzing the low NDCG in Experiment 3 and questioning the `inbatch_correction_power = 0.0` setting, especially given the high `inbatch_negatives`. I plan to re-examine the baseline's `inbatch_correction_power = 0.5` with `unique_targets` and explore variations in `inbatch_negatives` and `uniform_negatives`, including setting `inbatch_negatives = 0`."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Revisiting Baseline Scores\n\nI'm re-evaluating Experiment 3's low NDCG, noting the baseline's original score was higher. I'll restore the baseline's `draw_full_history_filtered_negatives` and test parameter variations."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Exploring In-Batch Negative Sampling\n\nI'm diving deeper into the `draw_full_history_filtered_negatives` function, focusing on how in-batch negatives are sampled. I'm particularly interested in the `corrected_count` logic and how it interacts with `unique_targets` to potentially influence sampling."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Testing In-Batch Negative Logic\n\nI'm examining the code for `draw_full_history_filtered_negatives`. My focus is on the section that determines `inbatch` negatives, particularly how `unique_targets` and `corrected_count` are used to select and fill the negative samples."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Refining Negative Sampling Loop\n\nI'm optimizing the loop for `invalid_full_history_negatives`. The current approach retries up to 32 times, replacing invalid negatives with uniform samples and adjusting their `correction` value. I'm assessing if further refinement or adjustments to this resampling process are necessary."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Refining Negative Sampling Logic\n\nI'm closely examining the code, specifically lines 698-701, where rejected in-batch items are replaced with uniform draws and their correction value is set to 1.0. I am also reviewing `build_known_positive_filter` and lines 578-605 of `train_current_model.py` for context."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Reviewing Filter Construction\n\nI'm scrutinizing the `build_known_positive_filter` function, particularly the `training_counts` argument. I need to understand its origin and how it directly influences the preparation of sequence items within the filter's construction process."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Considering Actual Negative Examples\n\nI'm questioning if skipped or disliked items are truly used as negatives. Currently, only uniform and in-batch draws seem to be employed, and I need to confirm if explicit user actions like skips or dislikes are ever incorporated as negative examples in the training process."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Analyzing Negative Sampling Logic\n\nI'm examining the training objective's approach to negative examples. I'm currently focused on the `draw_full_history_filtered_negatives` function and how `inbatch_correction_power` might impact performance, particularly when `inbatch_negatives` is high."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Analyzing In-Batch Correction\n\nI'm examining how the in-batch correction is calculated. My focus is on the `counts`, `probabilities`, and the application of `inbatch_correction_power` to `raw` values before normalization and clipping."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Analyzing Correction Power Calculation\n\nI'm examining the `build_item_correction` function and have traced `target_counts` back to a bincount of target items. I now understand the `raw` value is the ratio of uniform to in-batch probability, raised to the power of `inbatch_correction_power`."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Calculating Weighted Average\n\nI've identified that the in-batch loss calculation involves a weighted average, specifically `((raw[:, selected] * weights).sum(dim=1) / weights.sum(dim=1))`. This highlights how the `correction` values directly influence the average loss for in-batch negatives."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Understanding Importance Sampling Cancellation\n\nI've realized the in-batch loss calculation uses self-normalized importance sampling. This means the in-batch samples are weighted to estimate the uniform negative loss, effectively canceling out the in-batch sampling's intended purpose and making them approximate uniform negatives."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Correcting Loss Calculation\n\nI've realized my previous understanding of in-batch loss calculation was flawed. The importance sampling weights are indeed used, but they don't necessarily convert in-batch negatives into uniform ones. Instead, they aim to correct for the popularity bias inherent in in-batch sampling, allowing the model to still learn from these harder, more relevant negative examples."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Analyzing Yi et al. Correction\n\nI'm reviewing Yi et al. (2019) and their derivation of sampled softmax. The key insight is subtracting $\\log p_i$ from the model logit during training. I need to verify if this implies ranking by the raw dot product at serving time, or if the correction inherently alters the objective."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:06.406Z",
"text": "Testing Parameter Isolation\n\nI am systematically isolating the variables that led to Experiment 3's poor performance. My current focus is on reinstating the baseline's `draw_full_history_filtered_negatives` method to understand the specific impact of changing `inbatch_correction_power` and negative sampling configurations individually."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:44:06.406Z",
"callId": "run_shell_command__call_60910",
"name": "run_shell_command",
"input": {
"description": "Inspect original draw_full_history_filtered_negatives",
"command": "sed -n '645,675p' /task/current_model/train_current_model.py"
},
"recorded": {
"id": "run_shell_command__call_60910",
"name": "run_shell_command",
"args": {
"description": "Inspect original draw_full_history_filtered_negatives",
"command": "sed -n '645,675p' /task/current_model/train_current_model.py"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_60910",
"name": "run_shell_command",
"response": {
"output": "\nOutput: uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\nProcess Group PGID: 2129\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:44:06.423Z",
"resultDisplay": "uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),",
"description": "sed -n '645,675p' /task/current_model/train_current_model.py",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:44:06.425Z",
"content": "\nOutput: uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\nProcess Group PGID: 2129\n",
"isError": false
},
"responseMessageId": "8619ac01-9562-4e75-acc3-bf5e4ebbeb97"
}
]
},
{
"id": 82,
"role": "agent",
"timestamp": "2026-09-29T02:44:09.485Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:09.485Z",
"text": "Restoring Model Logic\n\nI'm focusing on restoring a specific line of code in `train_current_model.py`. The change involves bringing back the `torch.unique` function call that was previously used on `targets.detach().cpu()`."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:44:09.485Z",
"callId": "read_file__call_3124091",
"name": "read_file",
"input": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 675,
"start_line": 645
},
"recorded": {
"id": "read_file__call_3124091",
"name": "read_file",
"args": {
"file_path": "/app/solution/train_current_model.py",
"end_line": 675,
"start_line": 645
},
"result": [
{
"functionResponse": {
"id": "read_file__call_3124091",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 645-675 of 2197 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 676.\n\n--- FILE CONTENT (truncated) ---\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:44:09.492Z",
"resultDisplay": "Read lines 645-675 of 2197 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:44:09.494Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 645-675 of 2197 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 676.\n\n--- FILE CONTENT (truncated) ---\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,",
"isError": false
},
"responseMessageId": "ae2c4911-59ef-4f44-bb99-4dd8c5e4bc57"
}
]
},
{
"id": 83,
"role": "agent",
"timestamp": "2026-09-29T02:44:13.952Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:44:13.952Z",
"callId": "replace__call_147348",
"name": "replace",
"input": {
"old_string": " inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives",
"file_path": "/app/solution/train_current_model.py",
"allow_multiple": false,
"new_string": " inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)",
"instruction": "Restore unique_targets inbatch negative selection in draw_full_history_filtered_negatives"
},
"recorded": {
"id": "replace__call_147348",
"name": "replace",
"args": {
"old_string": " inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives",
"file_path": "/app/solution/train_current_model.py",
"allow_multiple": false,
"new_string": " inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)",
"instruction": "Restore unique_targets inbatch negative selection in draw_full_history_filtered_negatives"
},
"result": [
{
"functionResponse": {
"id": "replace__call_147348",
"name": "replace",
"response": {
"output": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n..."
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:44:13.968Z",
"resultDisplay": {
"fileDiff": "Index: train_current_model.py\n===================================================================\n--- train_current_model.py\tCurrent\n+++ train_current_model.py\tProposed\n@@ -652,15 +652,33 @@\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n- if config.inbatch_negatives and batch_size > 0:\n- rand_indices = torch.randint(\n- batch_size,\n- (batch_size, config.inbatch_negatives),\n- generator=generator,\n- device=\"cpu\",\n- ).numpy()\n- inbatch = torch.from_numpy(targets_cpu[rand_indices])\n- corrected_count = config.inbatch_negatives\n+ if config.inbatch_negatives:\n+ unique_targets = torch.unique(targets.detach().cpu())\n+ corrected_count = min(\n+ config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n+ )\n+ if corrected_count:\n+ priorities = torch.rand(\n+ (batch_size, len(unique_targets)), generator=generator\n+ )\n+ priorities.masked_fill_(\n+ unique_targets[None, :].eq(\n+ torch.from_numpy(targets_cpu)[:, None]\n+ ),\n+ -1.0,\n+ )\n+ columns = torch.topk(\n+ priorities, k=corrected_count, dim=1\n+ ).indices\n+ inbatch = unique_targets[columns]\n+ if corrected_count < config.inbatch_negatives:\n+ filler = torch.randint(\n+ n_items,\n+ (batch_size, config.inbatch_negatives - corrected_count),\n+ generator=generator,\n+ device=\"cpu\",\n+ )\n+ inbatch = torch.cat([inbatch, filler], dim=1)\n \n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n",
"fileName": "train_current_model.py",
"filePath": "/app/solution/train_current_model.py",
"originalContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, config.inbatch_negatives),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n inbatch = torch.from_numpy(targets_cpu[rand_indices])\n corrected_count = config.inbatch_negatives\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n if config.loss_type == \"infonce\":\n all_logits = torch.cat(\n [positive_logits.unsqueeze(1), negative_logits], dim=1\n )\n scaled_logits = all_logits / config.temperature\n target_zeros = torch.zeros(\n len(all_logits), dtype=torch.long, device=device\n )\n row_losses = F.cross_entropy(\n scaled_logits, target_zeros, reduction=\"none\"\n )\n loss_sum = (selected_weights * row_losses).sum()\n else:\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n parser.add_argument(\n \"--uniform-negatives\",\n type=int,\n default=Config.uniform_negatives,\n )\n parser.add_argument(\n \"--inbatch-negatives\",\n type=int,\n default=Config.inbatch_negatives,\n )\n parser.add_argument(\n \"--loss-type\",\n choices=(\"infonce\", \"bce\"),\n default=Config.loss_type,\n )\n parser.add_argument(\n \"--temperature\",\n type=float,\n default=Config.temperature,\n )\n parser.add_argument(\n \"--inbatch-correction-power\",\n type=float,\n default=Config.inbatch_correction_power,\n )\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n or args.temperature <= 0\n or args.uniform_negatives < 0\n or args.inbatch_negatives < 0\n ):\n parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n if args.uniform_negatives + args.inbatch_negatives < 1:\n parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n uniform_negatives=args.uniform_negatives,\n inbatch_negatives=args.inbatch_negatives,\n inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n loss_type=args.loss_type,\n temperature=args.temperature,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"newContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n if config.loss_type == \"infonce\":\n all_logits = torch.cat(\n [positive_logits.unsqueeze(1), negative_logits], dim=1\n )\n scaled_logits = all_logits / config.temperature\n target_zeros = torch.zeros(\n len(all_logits), dtype=torch.long, device=device\n )\n row_losses = F.cross_entropy(\n scaled_logits, target_zeros, reduction=\"none\"\n )\n loss_sum = (selected_weights * row_losses).sum()\n else:\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n parser.add_argument(\n \"--uniform-negatives\",\n type=int,\n default=Config.uniform_negatives,\n )\n parser.add_argument(\n \"--inbatch-negatives\",\n type=int,\n default=Config.inbatch_negatives,\n )\n parser.add_argument(\n \"--loss-type\",\n choices=(\"infonce\", \"bce\"),\n default=Config.loss_type,\n )\n parser.add_argument(\n \"--temperature\",\n type=float,\n default=Config.temperature,\n )\n parser.add_argument(\n \"--inbatch-correction-power\",\n type=float,\n default=Config.inbatch_correction_power,\n )\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n or args.temperature <= 0\n or args.uniform_negatives < 0\n or args.inbatch_negatives < 0\n ):\n parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n if args.uniform_negatives + args.inbatch_negatives < 1:\n parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n uniform_negatives=args.uniform_negatives,\n inbatch_negatives=args.inbatch_negatives,\n inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n loss_type=args.loss_type,\n temperature=args.temperature,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"diffStat": {
"model_added_lines": 27,
"model_removed_lines": 9,
"model_added_chars": 1008,
"model_removed_chars": 347,
"user_added_lines": 0,
"user_removed_lines": 0,
"user_added_chars": 0,
"user_removed_chars": 0
},
"isNewFile": false,
"isBuildFile": false
},
"description": "solution/train_current_model.py: inbatch = torch.empty((bat... => inbatch = torch.empty((bat...",
"displayName": "Edit",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:44:13.970Z",
"content": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n...",
"isError": false
},
"responseMessageId": "f5044d5a-6a5a-428b-9ec7-37f8287877fc"
}
]
},
{
"id": 84,
"role": "agent",
"timestamp": "2026-09-29T02:44:23.571Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:44:23.571Z",
"callId": "read_file__call_2101345",
"name": "read_file",
"input": {
"file_path": "/app/solution/two_tower_model.py",
"start_line": 365,
"end_line": 400
},
"recorded": {
"id": "read_file__call_2101345",
"name": "read_file",
"args": {
"file_path": "/app/solution/two_tower_model.py",
"start_line": 365,
"end_line": 400
},
"result": [
{
"functionResponse": {
"id": "read_file__call_2101345",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 365-400 of 422 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 401.\n\n--- FILE CONTENT (truncated) ---\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n n_items: int,\n uniform_count: int,\n inbatch_count: int,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw uniform and unique-target in-batch negatives.\"\"\"\n batch_size = len(targets)\n uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n :, uniform_count : uniform_count + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]]\n negatives = negatives_cpu.to(device)"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:44:23.577Z",
"resultDisplay": "Read lines 365-400 of 422 from solution/two_tower_model.py",
"description": "solution/two_tower_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:44:23.578Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 365-400 of 422 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 401.\n\n--- FILE CONTENT (truncated) ---\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n n_items: int,\n uniform_count: int,\n inbatch_count: int,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw uniform and unique-target in-batch negatives.\"\"\"\n batch_size = len(targets)\n uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n :, uniform_count : uniform_count + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]]\n negatives = negatives_cpu.to(device)",
"isError": false
},
"responseMessageId": "ec052e4f-2838-44c7-a891-02d4812838b2"
}
]
},
{
"id": 85,
"role": "agent",
"timestamp": "2026-09-29T02:44:28.225Z",
"blocks": [
{
"kind": "message",
"timestamp": "2026-09-29T02:44:28.225Z",
"text": "In `train_current_model.py`, I restored `unique_targets` in-batch negative sampling. Next, I will restore `unique_targets` in `two_tower_model.py`."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:44:28.225Z",
"callId": "replace__call_75759",
"name": "replace",
"input": {
"new_string": " inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)",
"allow_multiple": false,
"file_path": "/app/solution/two_tower_model.py",
"old_string": " inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count",
"instruction": "Restore unique_targets in draw_filtered_mixed_negatives"
},
"recorded": {
"id": "replace__call_75759",
"name": "replace",
"args": {
"new_string": " inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)",
"allow_multiple": false,
"file_path": "/app/solution/two_tower_model.py",
"old_string": " inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count",
"instruction": "Restore unique_targets in draw_filtered_mixed_negatives"
},
"result": [
{
"functionResponse": {
"id": "replace__call_75759",
"name": "replace",
"response": {
"output": "Successfully modified file: /app/solution/two_tower_model.py (1 replacements). Here is the updated code:\n...\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n..."
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:44:28.235Z",
"resultDisplay": {
"fileDiff": "Index: two_tower_model.py\n===================================================================\n--- two_tower_model.py\tCurrent\n+++ two_tower_model.py\tProposed\n@@ -381,15 +381,27 @@\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n- if inbatch_count and batch_size > 0:\n- rand_indices = torch.randint(\n- batch_size,\n- (batch_size, inbatch_count),\n- generator=generator,\n- device=\"cpu\",\n- )\n- inbatch = targets.detach().cpu()[rand_indices]\n- corrected_count = inbatch_count\n+ if inbatch_count:\n+ unique_targets = torch.unique(targets.detach().cpu())\n+ corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n+ if corrected_count:\n+ priorities = torch.rand(\n+ (batch_size, len(unique_targets)), generator=generator\n+ )\n+ priorities.masked_fill_(\n+ unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n+ -1.0,\n+ )\n+ columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n+ inbatch = unique_targets[columns]\n+ if corrected_count < inbatch_count:\n+ filler = torch.randint(\n+ n_items,\n+ (batch_size, inbatch_count - corrected_count),\n+ generator=generator,\n+ device=\"cpu\",\n+ )\n+ inbatch = torch.cat([inbatch, filler], dim=1)\n \n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n",
"fileName": "two_tower_model.py",
"filePath": "/app/solution/two_tower_model.py",
"originalContent": "\"\"\"Shared public-data primitives for the Yambda two-tower baseline.\"\"\"\nfrom __future__ import annotations\n\nimport sys\nfrom dataclasses import dataclass\nfrom pathlib import Path\nfrom typing import Iterator\n\nimport numpy as np\nimport pandas as pd\nimport pyarrow.parquet as pq\nimport torch\nfrom torch import nn\n\n\nDAY = 86_400\nTRAIN_END = 24_786_800\nVALIDATION_END = 25_393_400\nLISTEN_POSITIVE_THRESHOLD = 50\nPROFILE_LOOKBACK_DAYS = 120\nLIKE_ITEMS = 48\nDISLIKE_ITEMS = 24\nTOP_N = 100\n\n\n@dataclass(frozen=True)\nclass TowerConfig:\n sequence_length: int = 100\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass ListenEvents:\n timestamps: np.ndarray\n items: np.ndarray\n organic: np.ndarray\n completion_pct: np.ndarray\n\n\n@dataclass(frozen=True)\nclass ExplicitEvents:\n timestamps: np.ndarray\n items: np.ndarray\n channel: np.ndarray\n active: np.ndarray\n organic_like: np.ndarray\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef build_item_features(catalog: pd.DataFrame) -> np.ndarray:\n \"\"\"Return four standardized features built only from the public catalog.\"\"\"\n positives = catalog.positive_listens.to_numpy(dtype=np.float64, copy=False)\n organic = catalog.organic_positive_listens.to_numpy(dtype=np.float64, copy=False)\n popularity_rank = catalog.popularity_rank.to_numpy(dtype=np.float64, copy=False)\n features = np.column_stack(\n [\n np.log1p(positives),\n np.log1p(organic),\n organic / np.maximum(positives, 1.0),\n 1.0 - (popularity_rank - 1.0) / max(len(catalog) - 1, 1),\n ]\n )\n means = features.mean(axis=0, keepdims=True)\n scales = np.maximum(features.std(axis=0, keepdims=True), 1.0e-6)\n standardized = ((features - means) / scales).astype(np.float32)\n if not np.isfinite(standardized).all():\n raise RuntimeError(\"catalog features contain non-finite values\")\n return standardized\n\n\ndef _combine_listen_chunks(parts: list[ListenEvents]) -> ListenEvents:\n if len(parts) == 1:\n return parts[0]\n timestamps = np.concatenate([part.timestamps for part in parts])\n items = np.concatenate([part.items for part in parts])\n organic = np.concatenate([part.organic for part in parts])\n completion = np.concatenate([part.completion_pct for part in parts])\n order = np.argsort(timestamps, kind=\"stable\")\n return ListenEvents(\n timestamps=timestamps[order],\n items=items[order],\n organic=organic[order],\n completion_pct=completion[order],\n )\n\n\ndef iter_listen_users(\n path: Path, item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Stream one uid-sorted public listen file one user at a time.\"\"\"\n parquet = pq.ParquetFile(path)\n pending_uid: int | None = None\n pending: list[ListenEvents] = []\n previous_uid = -1\n for batch in parquet.iter_batches(\n batch_size=750_000,\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\", \"played_ratio_pct\"],\n ):\n frame = batch.to_pandas()\n mapped = item_index.get_indexer(frame.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n if not np.any(keep):\n continue\n uids = frame.uid.to_numpy(dtype=np.int64, copy=False)[keep]\n timestamps = frame.timestamp.to_numpy(dtype=np.int64, copy=False)[keep]\n items = mapped[keep].astype(np.int32, copy=False)\n organic = frame.is_organic.to_numpy(dtype=np.uint8, copy=False)[keep]\n completion = frame.played_ratio_pct.to_numpy(dtype=np.uint16, copy=False)[keep]\n if np.any(uids[1:] < uids[:-1]):\n raise RuntimeError(f\"{path.name} is not sorted by uid\")\n boundaries = np.r_[\n 0,\n np.flatnonzero(uids[1:] != uids[:-1]) + 1,\n len(uids),\n ]\n for start, end in zip(boundaries[:-1], boundaries[1:]):\n uid = int(uids[start])\n part = ListenEvents(\n timestamps[start:end].copy(),\n items[start:end].copy(),\n organic[start:end].copy(),\n completion[start:end].copy(),\n )\n if pending_uid is None:\n pending_uid = uid\n elif uid != pending_uid:\n if pending_uid < previous_uid:\n raise RuntimeError(f\"{path.name} user order regressed\")\n yield pending_uid, _combine_listen_chunks(pending)\n previous_uid = pending_uid\n pending_uid = uid\n pending = []\n pending.append(part)\n if pending_uid is not None:\n yield pending_uid, _combine_listen_chunks(pending)\n\n\ndef merge_listen_streams(\n paths: list[Path], item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Merge uid-sorted public listen files without materializing them.\"\"\"\n streams = [iter(iter_listen_users(path, item_index)) for path in paths]\n heads: list[tuple[int, ListenEvents] | None] = [\n next(stream, None) for stream in streams\n ]\n while any(head is not None for head in heads):\n uid = min(head[0] for head in heads if head is not None)\n parts: list[ListenEvents] = []\n for position, head in enumerate(heads):\n if head is not None and head[0] == uid:\n parts.append(head[1])\n heads[position] = next(streams[position], None)\n yield uid, _combine_listen_chunks(parts)\n\n\ndef load_explicit_events(\n data: Path,\n prefixes: tuple[str, ...],\n item_index: pd.Index,\n) -> dict[int, ExplicitEvents]:\n \"\"\"Load public explicit actions as chronological state changes.\"\"\"\n specifications = (\n (\"likes\", 0, 1, 0),\n (\"unlikes\", 0, 0, 1),\n (\"dislikes\", 1, 1, 0),\n (\"undislikes\", 1, 0, 1),\n )\n parts: list[pd.DataFrame] = []\n for family, channel, active, tie_priority in specifications:\n for prefix in prefixes:\n frame = pd.read_parquet(\n data / f\"{prefix}_{family}.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n mapped = item_index.get_indexer(\n frame.item_id.to_numpy(dtype=np.int64, copy=False)\n )\n keep = mapped >= 0\n if not np.any(keep):\n continue\n retained = frame.loc[keep, [\"uid\", \"timestamp\", \"is_organic\"]].copy()\n retained[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n retained[\"channel\"] = np.int8(channel)\n retained[\"active\"] = np.int8(active)\n retained[\"tie_priority\"] = np.int8(tie_priority)\n retained[\"organic_like\"] = np.int8(\n family == \"likes\"\n ) * retained.is_organic.astype(np.int8)\n parts.append(retained.drop(columns=\"is_organic\"))\n if not parts:\n return {}\n events = pd.concat(parts, ignore_index=True)\n events = events.sort_values(\n [\"uid\", \"timestamp\", \"tie_priority\"], kind=\"mergesort\"\n ).reset_index(drop=True)\n result: dict[int, ExplicitEvents] = {}\n for uid, rows in events.groupby(\"uid\", sort=False):\n result[int(uid)] = ExplicitEvents(\n timestamps=rows.timestamp.to_numpy(dtype=np.int64, copy=True),\n items=rows.item.to_numpy(dtype=np.int32, copy=True),\n channel=rows.channel.to_numpy(dtype=np.int8, copy=True),\n active=rows.active.to_numpy(dtype=np.int8, copy=True),\n organic_like=rows.organic_like.to_numpy(dtype=np.int8, copy=True),\n )\n log(f\"loaded explicit events: rows={len(events):,} users={len(result):,}\")\n return result\n\n\ndef empty_explicit_events() -> ExplicitEvents:\n return ExplicitEvents(\n timestamps=np.empty(0, dtype=np.int64),\n items=np.empty(0, dtype=np.int32),\n channel=np.empty(0, dtype=np.int8),\n active=np.empty(0, dtype=np.int8),\n organic_like=np.empty(0, dtype=np.int8),\n )\n\n\ndef pack_active_items(\n active: dict[int, int], width: int, padding_item: int\n) -> np.ndarray:\n packed = np.full(width, padding_item, dtype=np.uint16)\n if not active:\n return packed\n ordered = sorted(active.items(), key=lambda pair: (-pair[1], pair[0]))[:width]\n packed[: len(ordered)] = np.fromiter(\n (item for item, _ in ordered), dtype=np.uint16, count=len(ordered)\n )\n return packed\n\n\ndef load_inference_state(\n path: Path,\n item_index: pd.Index,\n uids: np.ndarray,\n n_items: int,\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray]:\n \"\"\"Pack the task-provided active explicit state.\"\"\"\n state = pd.read_parquet(path, columns=[\"uid\", \"item_id\", \"state\"])\n mapped = item_index.get_indexer(state.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n state = state.loc[keep, [\"uid\", \"state\"]].copy()\n state[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n user_rows = pd.Index(uids)\n liked = np.full((len(uids), LIKE_ITEMS), n_items, dtype=np.uint16)\n disliked = np.full((len(uids), DISLIKE_ITEMS), n_items, dtype=np.uint16)\n like_counts = np.zeros(len(uids), dtype=np.int32)\n dislike_counts = np.zeros(len(uids), dtype=np.int32)\n for value, width, destination, counts in (\n (\"liked\", LIKE_ITEMS, liked, like_counts),\n (\"disliked\", DISLIKE_ITEMS, disliked, dislike_counts),\n ):\n selected = state[state.state == value]\n for uid, rows in selected.groupby(\"uid\", sort=False):\n row = int(user_rows.get_indexer([int(uid)])[0])\n if row < 0:\n continue\n items = np.sort(rows.item.unique())\n counts[row] = len(items)\n retained = items[:width]\n destination[row, : len(retained)] = retained.astype(np.uint16)\n return liked, disliked, like_counts, dislike_counts\n\n\nclass SequentialTwoTower(nn.Module):\n \"\"\"Order-sensitive user tower and independent catalog-aware item tower.\"\"\"\n\n def __init__(self, item_features: np.ndarray, config: TowerConfig) -> None:\n super().__init__()\n n_items, n_item_features = item_features.shape\n dim = config.embedding_dim\n self.n_items = n_items\n self.context_embedding = nn.Embedding(\n n_items + 1, dim, padding_idx=n_items\n )\n self.event_projection = nn.Sequential(\n nn.Linear(dim + 3, config.hidden_dim),\n nn.GELU(),\n )\n self.sequence_encoder = nn.GRU(\n input_size=config.hidden_dim,\n hidden_size=dim,\n num_layers=1,\n batch_first=True,\n )\n self.user_tower = nn.Sequential(\n nn.Linear(dim * 3 + 6, config.user_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_1, config.user_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_2, dim),\n )\n self.candidate_embedding = nn.Embedding(n_items, dim)\n self.register_buffer(\n \"item_features\", torch.from_numpy(item_features), persistent=True\n )\n self.item_tower = nn.Sequential(\n nn.Linear(dim + n_item_features, config.item_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_1, config.item_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_2, dim),\n )\n nn.init.normal_(self.context_embedding.weight, std=0.02)\n nn.init.normal_(self.candidate_embedding.weight, std=0.02)\n with torch.no_grad():\n self.context_embedding.weight[n_items].zero_()\n\n def _mean_context_channel(self, items: torch.Tensor) -> torch.Tensor:\n mask = items.ne(self.n_items)\n vectors = self.context_embedding(items)\n return (vectors * mask.unsqueeze(-1)).sum(dim=1) / mask.sum(\n dim=1, keepdim=True\n ).clamp_min(1)\n\n def encode_items(self, items: torch.Tensor) -> torch.Tensor:\n inputs = torch.cat(\n [self.candidate_embedding(items), self.item_features[items]], dim=1\n )\n return self.item_tower(inputs)\n\n\ndef invalid_negative_mask(\n negatives: torch.Tensor,\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n) -> torch.Tensor:\n \"\"\"Identify targets, known positives, active likes, and row duplicates.\"\"\"\n invalid = negatives.eq(targets[:, None])\n invalid |= negatives[:, :, None].eq(context_items[:, None, :]).any(dim=2)\n invalid |= negatives[:, :, None].eq(liked_items[:, None, :]).any(dim=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= negatives[:, column, None].eq(\n negatives[:, :column]\n ).any(dim=1)\n return invalid\n\n\ndef draw_filtered_mixed_negatives(\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n n_items: int,\n uniform_count: int,\n inbatch_count: int,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw uniform and unique-target in-batch negatives.\"\"\"\n batch_size = len(targets)\n uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count and batch_size > 0:\n rand_indices = torch.randint(\n batch_size,\n (batch_size, inbatch_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = targets.detach().cpu()[rand_indices]\n corrected_count = inbatch_count\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n :, uniform_count : uniform_count + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]]\n negatives = negatives_cpu.to(device)\n correction = correction_cpu.to(device)\n for _ in range(32):\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if not bool(invalid.any()):\n return negatives, correction\n replacements = torch.randint(\n n_items,\n (int(invalid.sum().detach().cpu()),),\n generator=generator,\n device=\"cpu\",\n ).to(device)\n negatives[invalid] = replacements\n correction[invalid] = 1.0\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if bool(invalid.any()):\n raise RuntimeError(\"mixed negative resampling failed false-negative filter\")\n return negatives, correction\n",
"newContent": "\"\"\"Shared public-data primitives for the Yambda two-tower baseline.\"\"\"\nfrom __future__ import annotations\n\nimport sys\nfrom dataclasses import dataclass\nfrom pathlib import Path\nfrom typing import Iterator\n\nimport numpy as np\nimport pandas as pd\nimport pyarrow.parquet as pq\nimport torch\nfrom torch import nn\n\n\nDAY = 86_400\nTRAIN_END = 24_786_800\nVALIDATION_END = 25_393_400\nLISTEN_POSITIVE_THRESHOLD = 50\nPROFILE_LOOKBACK_DAYS = 120\nLIKE_ITEMS = 48\nDISLIKE_ITEMS = 24\nTOP_N = 100\n\n\n@dataclass(frozen=True)\nclass TowerConfig:\n sequence_length: int = 100\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n uniform_negatives: int = 24\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass ListenEvents:\n timestamps: np.ndarray\n items: np.ndarray\n organic: np.ndarray\n completion_pct: np.ndarray\n\n\n@dataclass(frozen=True)\nclass ExplicitEvents:\n timestamps: np.ndarray\n items: np.ndarray\n channel: np.ndarray\n active: np.ndarray\n organic_like: np.ndarray\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef build_item_features(catalog: pd.DataFrame) -> np.ndarray:\n \"\"\"Return four standardized features built only from the public catalog.\"\"\"\n positives = catalog.positive_listens.to_numpy(dtype=np.float64, copy=False)\n organic = catalog.organic_positive_listens.to_numpy(dtype=np.float64, copy=False)\n popularity_rank = catalog.popularity_rank.to_numpy(dtype=np.float64, copy=False)\n features = np.column_stack(\n [\n np.log1p(positives),\n np.log1p(organic),\n organic / np.maximum(positives, 1.0),\n 1.0 - (popularity_rank - 1.0) / max(len(catalog) - 1, 1),\n ]\n )\n means = features.mean(axis=0, keepdims=True)\n scales = np.maximum(features.std(axis=0, keepdims=True), 1.0e-6)\n standardized = ((features - means) / scales).astype(np.float32)\n if not np.isfinite(standardized).all():\n raise RuntimeError(\"catalog features contain non-finite values\")\n return standardized\n\n\ndef _combine_listen_chunks(parts: list[ListenEvents]) -> ListenEvents:\n if len(parts) == 1:\n return parts[0]\n timestamps = np.concatenate([part.timestamps for part in parts])\n items = np.concatenate([part.items for part in parts])\n organic = np.concatenate([part.organic for part in parts])\n completion = np.concatenate([part.completion_pct for part in parts])\n order = np.argsort(timestamps, kind=\"stable\")\n return ListenEvents(\n timestamps=timestamps[order],\n items=items[order],\n organic=organic[order],\n completion_pct=completion[order],\n )\n\n\ndef iter_listen_users(\n path: Path, item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Stream one uid-sorted public listen file one user at a time.\"\"\"\n parquet = pq.ParquetFile(path)\n pending_uid: int | None = None\n pending: list[ListenEvents] = []\n previous_uid = -1\n for batch in parquet.iter_batches(\n batch_size=750_000,\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\", \"played_ratio_pct\"],\n ):\n frame = batch.to_pandas()\n mapped = item_index.get_indexer(frame.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n if not np.any(keep):\n continue\n uids = frame.uid.to_numpy(dtype=np.int64, copy=False)[keep]\n timestamps = frame.timestamp.to_numpy(dtype=np.int64, copy=False)[keep]\n items = mapped[keep].astype(np.int32, copy=False)\n organic = frame.is_organic.to_numpy(dtype=np.uint8, copy=False)[keep]\n completion = frame.played_ratio_pct.to_numpy(dtype=np.uint16, copy=False)[keep]\n if np.any(uids[1:] < uids[:-1]):\n raise RuntimeError(f\"{path.name} is not sorted by uid\")\n boundaries = np.r_[\n 0,\n np.flatnonzero(uids[1:] != uids[:-1]) + 1,\n len(uids),\n ]\n for start, end in zip(boundaries[:-1], boundaries[1:]):\n uid = int(uids[start])\n part = ListenEvents(\n timestamps[start:end].copy(),\n items[start:end].copy(),\n organic[start:end].copy(),\n completion[start:end].copy(),\n )\n if pending_uid is None:\n pending_uid = uid\n elif uid != pending_uid:\n if pending_uid < previous_uid:\n raise RuntimeError(f\"{path.name} user order regressed\")\n yield pending_uid, _combine_listen_chunks(pending)\n previous_uid = pending_uid\n pending_uid = uid\n pending = []\n pending.append(part)\n if pending_uid is not None:\n yield pending_uid, _combine_listen_chunks(pending)\n\n\ndef merge_listen_streams(\n paths: list[Path], item_index: pd.Index\n) -> Iterator[tuple[int, ListenEvents]]:\n \"\"\"Merge uid-sorted public listen files without materializing them.\"\"\"\n streams = [iter(iter_listen_users(path, item_index)) for path in paths]\n heads: list[tuple[int, ListenEvents] | None] = [\n next(stream, None) for stream in streams\n ]\n while any(head is not None for head in heads):\n uid = min(head[0] for head in heads if head is not None)\n parts: list[ListenEvents] = []\n for position, head in enumerate(heads):\n if head is not None and head[0] == uid:\n parts.append(head[1])\n heads[position] = next(streams[position], None)\n yield uid, _combine_listen_chunks(parts)\n\n\ndef load_explicit_events(\n data: Path,\n prefixes: tuple[str, ...],\n item_index: pd.Index,\n) -> dict[int, ExplicitEvents]:\n \"\"\"Load public explicit actions as chronological state changes.\"\"\"\n specifications = (\n (\"likes\", 0, 1, 0),\n (\"unlikes\", 0, 0, 1),\n (\"dislikes\", 1, 1, 0),\n (\"undislikes\", 1, 0, 1),\n )\n parts: list[pd.DataFrame] = []\n for family, channel, active, tie_priority in specifications:\n for prefix in prefixes:\n frame = pd.read_parquet(\n data / f\"{prefix}_{family}.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n mapped = item_index.get_indexer(\n frame.item_id.to_numpy(dtype=np.int64, copy=False)\n )\n keep = mapped >= 0\n if not np.any(keep):\n continue\n retained = frame.loc[keep, [\"uid\", \"timestamp\", \"is_organic\"]].copy()\n retained[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n retained[\"channel\"] = np.int8(channel)\n retained[\"active\"] = np.int8(active)\n retained[\"tie_priority\"] = np.int8(tie_priority)\n retained[\"organic_like\"] = np.int8(\n family == \"likes\"\n ) * retained.is_organic.astype(np.int8)\n parts.append(retained.drop(columns=\"is_organic\"))\n if not parts:\n return {}\n events = pd.concat(parts, ignore_index=True)\n events = events.sort_values(\n [\"uid\", \"timestamp\", \"tie_priority\"], kind=\"mergesort\"\n ).reset_index(drop=True)\n result: dict[int, ExplicitEvents] = {}\n for uid, rows in events.groupby(\"uid\", sort=False):\n result[int(uid)] = ExplicitEvents(\n timestamps=rows.timestamp.to_numpy(dtype=np.int64, copy=True),\n items=rows.item.to_numpy(dtype=np.int32, copy=True),\n channel=rows.channel.to_numpy(dtype=np.int8, copy=True),\n active=rows.active.to_numpy(dtype=np.int8, copy=True),\n organic_like=rows.organic_like.to_numpy(dtype=np.int8, copy=True),\n )\n log(f\"loaded explicit events: rows={len(events):,} users={len(result):,}\")\n return result\n\n\ndef empty_explicit_events() -> ExplicitEvents:\n return ExplicitEvents(\n timestamps=np.empty(0, dtype=np.int64),\n items=np.empty(0, dtype=np.int32),\n channel=np.empty(0, dtype=np.int8),\n active=np.empty(0, dtype=np.int8),\n organic_like=np.empty(0, dtype=np.int8),\n )\n\n\ndef pack_active_items(\n active: dict[int, int], width: int, padding_item: int\n) -> np.ndarray:\n packed = np.full(width, padding_item, dtype=np.uint16)\n if not active:\n return packed\n ordered = sorted(active.items(), key=lambda pair: (-pair[1], pair[0]))[:width]\n packed[: len(ordered)] = np.fromiter(\n (item for item, _ in ordered), dtype=np.uint16, count=len(ordered)\n )\n return packed\n\n\ndef load_inference_state(\n path: Path,\n item_index: pd.Index,\n uids: np.ndarray,\n n_items: int,\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray]:\n \"\"\"Pack the task-provided active explicit state.\"\"\"\n state = pd.read_parquet(path, columns=[\"uid\", \"item_id\", \"state\"])\n mapped = item_index.get_indexer(state.item_id.to_numpy(dtype=np.int64))\n keep = mapped >= 0\n state = state.loc[keep, [\"uid\", \"state\"]].copy()\n state[\"item\"] = mapped[keep].astype(np.int32, copy=False)\n user_rows = pd.Index(uids)\n liked = np.full((len(uids), LIKE_ITEMS), n_items, dtype=np.uint16)\n disliked = np.full((len(uids), DISLIKE_ITEMS), n_items, dtype=np.uint16)\n like_counts = np.zeros(len(uids), dtype=np.int32)\n dislike_counts = np.zeros(len(uids), dtype=np.int32)\n for value, width, destination, counts in (\n (\"liked\", LIKE_ITEMS, liked, like_counts),\n (\"disliked\", DISLIKE_ITEMS, disliked, dislike_counts),\n ):\n selected = state[state.state == value]\n for uid, rows in selected.groupby(\"uid\", sort=False):\n row = int(user_rows.get_indexer([int(uid)])[0])\n if row < 0:\n continue\n items = np.sort(rows.item.unique())\n counts[row] = len(items)\n retained = items[:width]\n destination[row, : len(retained)] = retained.astype(np.uint16)\n return liked, disliked, like_counts, dislike_counts\n\n\nclass SequentialTwoTower(nn.Module):\n \"\"\"Order-sensitive user tower and independent catalog-aware item tower.\"\"\"\n\n def __init__(self, item_features: np.ndarray, config: TowerConfig) -> None:\n super().__init__()\n n_items, n_item_features = item_features.shape\n dim = config.embedding_dim\n self.n_items = n_items\n self.context_embedding = nn.Embedding(\n n_items + 1, dim, padding_idx=n_items\n )\n self.event_projection = nn.Sequential(\n nn.Linear(dim + 3, config.hidden_dim),\n nn.GELU(),\n )\n self.sequence_encoder = nn.GRU(\n input_size=config.hidden_dim,\n hidden_size=dim,\n num_layers=1,\n batch_first=True,\n )\n self.user_tower = nn.Sequential(\n nn.Linear(dim * 3 + 6, config.user_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_1, config.user_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.user_hidden_2, dim),\n )\n self.candidate_embedding = nn.Embedding(n_items, dim)\n self.register_buffer(\n \"item_features\", torch.from_numpy(item_features), persistent=True\n )\n self.item_tower = nn.Sequential(\n nn.Linear(dim + n_item_features, config.item_hidden_1),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_1, config.item_hidden_2),\n nn.GELU(),\n nn.Dropout(config.dropout),\n nn.Linear(config.item_hidden_2, dim),\n )\n nn.init.normal_(self.context_embedding.weight, std=0.02)\n nn.init.normal_(self.candidate_embedding.weight, std=0.02)\n with torch.no_grad():\n self.context_embedding.weight[n_items].zero_()\n\n def _mean_context_channel(self, items: torch.Tensor) -> torch.Tensor:\n mask = items.ne(self.n_items)\n vectors = self.context_embedding(items)\n return (vectors * mask.unsqueeze(-1)).sum(dim=1) / mask.sum(\n dim=1, keepdim=True\n ).clamp_min(1)\n\n def encode_items(self, items: torch.Tensor) -> torch.Tensor:\n inputs = torch.cat(\n [self.candidate_embedding(items), self.item_features[items]], dim=1\n )\n return self.item_tower(inputs)\n\n\ndef invalid_negative_mask(\n negatives: torch.Tensor,\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n) -> torch.Tensor:\n \"\"\"Identify targets, known positives, active likes, and row duplicates.\"\"\"\n invalid = negatives.eq(targets[:, None])\n invalid |= negatives[:, :, None].eq(context_items[:, None, :]).any(dim=2)\n invalid |= negatives[:, :, None].eq(liked_items[:, None, :]).any(dim=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= negatives[:, column, None].eq(\n negatives[:, :column]\n ).any(dim=1)\n return invalid\n\n\ndef draw_filtered_mixed_negatives(\n targets: torch.Tensor,\n context_items: torch.Tensor,\n liked_items: torch.Tensor,\n n_items: int,\n uniform_count: int,\n inbatch_count: int,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw uniform and unique-target in-batch negatives.\"\"\"\n batch_size = len(targets)\n uniform = torch.randint(\n n_items,\n (batch_size, uniform_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n :, uniform_count : uniform_count + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]]\n negatives = negatives_cpu.to(device)\n correction = correction_cpu.to(device)\n for _ in range(32):\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if not bool(invalid.any()):\n return negatives, correction\n replacements = torch.randint(\n n_items,\n (int(invalid.sum().detach().cpu()),),\n generator=generator,\n device=\"cpu\",\n ).to(device)\n negatives[invalid] = replacements\n correction[invalid] = 1.0\n invalid = invalid_negative_mask(\n negatives, targets, context_items, liked_items\n )\n if bool(invalid.any()):\n raise RuntimeError(\"mixed negative resampling failed false-negative filter\")\n return negatives, correction\n",
"diffStat": {
"model_added_lines": 21,
"model_removed_lines": 9,
"model_added_chars": 873,
"model_removed_chars": 299,
"user_added_lines": 0,
"user_removed_lines": 0,
"user_added_chars": 0,
"user_removed_chars": 0
},
"isNewFile": false,
"isBuildFile": false
},
"description": "solution/two_tower_model.py: inbatch = torch.empty((bat... => inbatch = torch.empty((bat...",
"displayName": "Edit",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T02:44:28.237Z",
"content": "Successfully modified file: /app/solution/two_tower_model.py (1 replacements). Here is the updated code:\n...\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long, device=\"cpu\")\n corrected_count = 0\n if inbatch_count:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(inbatch_count, max(len(unique_targets) - 1, 0))\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(targets.detach().cpu()[:, None]),\n -1.0,\n )\n columns = torch.topk(priorities, k=corrected_count, dim=1).indices\n inbatch = unique_targets[columns]\n if corrected_count < inbatch_count:\n filler = torch.randint(\n n_items,\n (batch_size, inbatch_count - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives_cpu = torch.cat([uniform, inbatch], dim=1)\n correction_cpu = torch.ones_like(negatives_cpu, dtype=torch.float32)\n if corrected_count:\n correction_cpu[\n...",
"isError": false
},
"responseMessageId": "fea56012-efe4-40af-8865-32ab892772ff"
}
]
},
{
"id": 86,
"role": "agent",
"timestamp": "2026-09-29T02:44:30.715Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:44:30.715Z",
"callId": "run_shell_command__call_59019",
"name": "run_shell_command",
"input": {
"description": "Check syntax of solution files",
"command": "python3 -m py_compile /app/solution/train_current_model.py /app/solution/two_tower_model.py"
},
"recorded": {
"id": "run_shell_command__call_59019",
"name": "run_shell_command",
"args": {
"description": "Check syntax of solution files",
"command": "python3 -m py_compile /app/solution/train_current_model.py /app/solution/two_tower_model.py"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_59019",
"name": "run_shell_command",
"response": {
"output": "\nOutput: (empty)\nProcess Group PGID: 2132\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:44:30.865Z",
"resultDisplay": "",
"description": "python3 -m py_compile /app/solution/train_current_model.py /app/solution/two_tower_model.py",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:44:30.867Z",
"content": "\nOutput: (empty)\nProcess Group PGID: 2132\n",
"isError": false
},
"responseMessageId": "34d44461-a240-4a47-a33a-2e6ace314fdb"
}
]
},
{
"id": 87,
"role": "agent",
"timestamp": "2026-09-29T02:44:37.612Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:37.612Z",
"text": "Exploring Model Training Parameters\n\nI'm currently investigating the impact of specific training configurations on model performance. My focus is on experiment 4, particularly the effects of `--target-weighting discovery-graded`, `--loss-type bce`, and various negative sampling strategies (`--uniform-negatives` and `--inbatch-negatives`), including the `--inbatch-correction` parameter."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:44:37.612Z",
"text": "Refining Objective Weighting\n\nI'm now exploring adjustments to the `organic-like-target-weight` within the discovery objective, considering a gain ratio of 7.0 to match the DCG gain. I'm also evaluating a reduced `ordinary-target-weight` of 0.1 and varying `inbatch_correction_power`. Additionally, I'm testing different `inbatch_negatives` counts."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:44:37.612Z",
"callId": "run_shell_command__call_67352",
"name": "run_shell_command",
"input": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --target-weighting discovery-graded \\\n --organic-like-target-weight 7.0 \\\n --loss-type bce \\\n --uniform-negatives 24 \\\n --inbatch-negatives 8 \\\n --inbatch-correction-power 0.5 \\\n --output /app/solution/exp4_graded7.parquet",
"description": "Train with organic-like-target-weight=7.0"
},
"recorded": {
"id": "run_shell_command__call_67352",
"name": "run_shell_command",
"args": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --target-weighting discovery-graded \\\n --organic-like-target-weight 7.0 \\\n --loss-type bce \\\n --uniform-negatives 24 \\\n --inbatch-negatives 8 \\\n --inbatch-correction-power 0.5 \\\n --output /app/solution/exp4_graded7.parquet",
"description": "Train with organic-like-target-weight=7.0"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_67352",
"name": "run_shell_command",
"response": {
"output": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.319 max=7.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.554236 running_bce=0.545155 elapsed=195.7s\nepoch=1/1 train_loss=0.54317 validation_loss=0.50813 pair_accuracy=0.760 train_targets=1,052,953 validation_targets=130,103 train_seconds=208.9 validation_seconds=15.3\nrestored best validation-BCE checkpoint: epoch=1 loss=0.508131\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp4_graded7.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 315.964,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 7.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5431721092790005,\n \"positive_logit\": 0.7727052889027716,\n \"negative_logit\": -0.632630268761765,\n \"pair_accuracy\": 0.7601297256382763,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 360556.0,\n \"batches\": 266.0,\n \"seconds\": 208.870717368,\n \"validation_loss\": 0.5081311107264754,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 43149.5,\n \"validation_seconds\": 15.257218306999675\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.6113882064819336,\n \"query_norm_std\": 0.7923927307128906,\n \"item_norm_mean\": 1.9114322662353516,\n \"item_norm_std\": 0.8259212970733643\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 2135\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:49:57.971Z",
"resultDisplay": "loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.319 max=7.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.554236 running_bce=0.545155 elapsed=195.7s\nepoch=1/1 train_loss=0.54317 validation_loss=0.50813 pair_accuracy=0.760 train_targets=1,052,953 validation_targets=130,103 train_seconds=208.9 validation_seconds=15.3\nrestored best validation-BCE checkpoint: epoch=1 loss=0.508131\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp4_graded7.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 315.964,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 7.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5431721092790005,\n \"positive_logit\": 0.7727052889027716,\n \"negative_logit\": -0.632630268761765,\n \"pair_accuracy\": 0.7601297256382763,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 360556.0,\n \"batches\": 266.0,\n \"seconds\": 208.870717368,\n \"validation_loss\": 0.5081311107264754,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 43149.5,\n \"validation_seconds\": 15.257218306999675\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.6113882064819336,\n \"query_norm_std\": 0.7923927307128906,\n \"item_norm_mean\": 1.9114322662353516,\n \"item_norm_std\": 0.8259212970733643\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}",
"description": "Train with organic-like-target-weight=7.0",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:49:57.975Z",
"content": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.319 max=7.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.554236 running_bce=0.545155 elapsed=195.7s\nepoch=1/1 train_loss=0.54317 validation_loss=0.50813 pair_accuracy=0.760 train_targets=1,052,953 validation_targets=130,103 train_seconds=208.9 validation_seconds=15.3\nrestored best validation-BCE checkpoint: epoch=1 loss=0.508131\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp4_graded7.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 315.964,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 24,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 7.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5431721092790005,\n \"positive_logit\": 0.7727052889027716,\n \"negative_logit\": -0.632630268761765,\n \"pair_accuracy\": 0.7601297256382763,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 360556.0,\n \"batches\": 266.0,\n \"seconds\": 208.870717368,\n \"validation_loss\": 0.5081311107264754,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 43149.5,\n \"validation_seconds\": 15.257218306999675\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.6113882064819336,\n \"query_norm_std\": 0.7923927307128906,\n \"item_norm_mean\": 1.9114322662353516,\n \"item_norm_std\": 0.8259212970733643\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 2135\n",
"isError": false
},
"responseMessageId": "4a48f9ba-36a2-451c-8a48-1a9bd157b9c1"
}
]
},
{
"id": 88,
"role": "agent",
"timestamp": "2026-09-29T02:50:05.782Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:50:05.782Z",
"callId": "run_shell_command__call_5915228",
"name": "run_shell_command",
"input": {
"command": "python3 /task/evaluate_public.py /app/solution/exp4_graded7.parquet",
"description": "Evaluate exp4 ranking"
},
"recorded": {
"id": "run_shell_command__call_5915228",
"name": "run_shell_command",
"args": {
"command": "python3 /task/evaluate_public.py /app/solution/exp4_graded7.parquet",
"description": "Evaluate exp4 ranking"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5915228",
"name": "run_shell_command",
"response": {
"output": "\nOutput: {\n \"model\": \"/app/solution/exp4_graded7.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.022166,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 2166\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:50:09.123Z",
"resultDisplay": "{\n \"model\": \"/app/solution/exp4_graded7.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.022166,\n \"quality_users\": 4263\n }\n}",
"description": "python3 /task/evaluate_public.py /app/solution/exp4_graded7.parquet",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:50:09.125Z",
"content": "\nOutput: {\n \"model\": \"/app/solution/exp4_graded7.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.022166,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 2166\n",
"isError": false
},
"responseMessageId": "ed5bb02b-4e98-4734-a40e-7674b557be19"
}
]
},
{
"id": 89,
"role": "agent",
"timestamp": "2026-09-29T02:50:16.597Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:50:16.597Z",
"text": "Refining Organic Weight\n\nI'm seeing that a target weight around 3.0 is showing better initial results than 7.0 for the organic targets. My current focus is on the nuances of negative sampling. For Exp 1, I'm specifically scrutinizing the impact of 24 uniform negatives, 8 in-batch negatives, and an in-batch correction power of 0.5."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:50:16.597Z",
"text": "Testing Negative Sampling Strategies\n\nI'm now exploring variations in negative sampling, specifically adjusting the balance between in-batch and uniform negatives while keeping the total constant at 32. I'm also re-evaluating the `inbatch_correction_power`, especially its impact when set to 0.0, recalling a strong performance then."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:50:16.597Z",
"callId": "run_shell_command__call_5017359",
"name": "run_shell_command",
"input": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --target-weighting discovery-graded \\\n --loss-type bce \\\n --uniform-negatives 32 \\\n --inbatch-negatives 0 \\\n --output /app/solution/exp5_uniform32.parquet",
"description": "Train with only uniform negatives (32)"
},
"recorded": {
"id": "run_shell_command__call_5017359",
"name": "run_shell_command",
"args": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --target-weighting discovery-graded \\\n --loss-type bce \\\n --uniform-negatives 32 \\\n --inbatch-negatives 0 \\\n --output /app/solution/exp5_uniform32.parquet",
"description": "Train with only uniform negatives (32)"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5017359",
"name": "run_shell_command",
"response": {
"output": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=1.000 mean_on_targets=1.000 max=1.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.542264 running_bce=0.527347 elapsed=180.8s\nepoch=1/1 train_loss=0.52544 validation_loss=0.48448 pair_accuracy=0.798 train_targets=1,052,953 validation_targets=130,103 train_seconds=192.8 validation_seconds=15.4\nrestored best validation-BCE checkpoint: epoch=1 loss=0.484480\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp5_uniform32.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 298.89,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 32,\n \"inbatch_negatives\": 0,\n \"inbatch_correction_power\": 0.0,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5254377356205274,\n \"positive_logit\": 0.9194933304166354,\n \"negative_logit\": -0.8096884111770254,\n \"pair_accuracy\": 0.7977172592223964,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 192.82824725499995,\n \"validation_loss\": 0.4844796377623661,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 15.39293569900019\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.4759684801101685,\n \"query_norm_std\": 0.6978866457939148,\n \"item_norm_mean\": 1.9009125232696533,\n \"item_norm_std\": 0.8285666704177856\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 2186\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:55:19.805Z",
"resultDisplay": "loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=1.000 mean_on_targets=1.000 max=1.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.542264 running_bce=0.527347 elapsed=180.8s\nepoch=1/1 train_loss=0.52544 validation_loss=0.48448 pair_accuracy=0.798 train_targets=1,052,953 validation_targets=130,103 train_seconds=192.8 validation_seconds=15.4\nrestored best validation-BCE checkpoint: epoch=1 loss=0.484480\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp5_uniform32.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 298.89,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 32,\n \"inbatch_negatives\": 0,\n \"inbatch_correction_power\": 0.0,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5254377356205274,\n \"positive_logit\": 0.9194933304166354,\n \"negative_logit\": -0.8096884111770254,\n \"pair_accuracy\": 0.7977172592223964,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 192.82824725499995,\n \"validation_loss\": 0.4844796377623661,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 15.39293569900019\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.4759684801101685,\n \"query_norm_std\": 0.6978866457939148,\n \"item_norm_mean\": 1.9009125232696533,\n \"item_norm_std\": 0.8285666704177856\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}",
"description": "Train with only uniform negatives (32)",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:55:19.808Z",
"content": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=1.000 mean_on_targets=1.000 max=1.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.542264 running_bce=0.527347 elapsed=180.8s\nepoch=1/1 train_loss=0.52544 validation_loss=0.48448 pair_accuracy=0.798 train_targets=1,052,953 validation_targets=130,103 train_seconds=192.8 validation_seconds=15.4\nrestored best validation-BCE checkpoint: epoch=1 loss=0.484480\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp5_uniform32.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 298.89,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 32,\n \"inbatch_negatives\": 0,\n \"inbatch_correction_power\": 0.0,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5254377356205274,\n \"positive_logit\": 0.9194933304166354,\n \"negative_logit\": -0.8096884111770254,\n \"pair_accuracy\": 0.7977172592223964,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 192.82824725499995,\n \"validation_loss\": 0.4844796377623661,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 15.39293569900019\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.4759684801101685,\n \"query_norm_std\": 0.6978866457939148,\n \"item_norm_mean\": 1.9009125232696533,\n \"item_norm_std\": 0.8285666704177856\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 2186\n",
"isError": false
},
"responseMessageId": "81ece5c8-3985-45b2-97bb-6d634ebb1ebd"
}
]
},
{
"id": 90,
"role": "agent",
"timestamp": "2026-09-29T02:55:25.544Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T02:55:25.544Z",
"callId": "run_shell_command__call_5562715",
"name": "run_shell_command",
"input": {
"description": "Evaluate exp5 ranking",
"command": "python3 /task/evaluate_public.py /app/solution/exp5_uniform32.parquet"
},
"recorded": {
"id": "run_shell_command__call_5562715",
"name": "run_shell_command",
"args": {
"description": "Evaluate exp5 ranking",
"command": "python3 /task/evaluate_public.py /app/solution/exp5_uniform32.parquet"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_5562715",
"name": "run_shell_command",
"response": {
"output": "\nOutput: {\n \"model\": \"/app/solution/exp5_uniform32.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.022328,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 2217\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T02:55:28.885Z",
"resultDisplay": "{\n \"model\": \"/app/solution/exp5_uniform32.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.022328,\n \"quality_users\": 4263\n }\n}",
"description": "python3 /task/evaluate_public.py /app/solution/exp5_uniform32.parquet",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T02:55:28.887Z",
"content": "\nOutput: {\n \"model\": \"/app/solution/exp5_uniform32.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.022328,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 2217\n",
"isError": false
},
"responseMessageId": "09eb4b6b-5560-4eb8-a4ff-5e0fa4e3bca0"
}
]
},
{
"id": 91,
"role": "agent",
"timestamp": "2026-09-29T02:55:35.927Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:55:35.927Z",
"text": "Testing In-Batch Negatives\n\nMy recent experiments indicate that incorporating in-batch negatives significantly boosts performance, pushing the score from 0.0223 to 0.0235. I'm now exploring further refinements to leverage this promising observation."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T02:55:35.927Z",
"text": "Exploring Negative Uniformity\n\nI'm now investigating the impact of increasing the total number of negatives, specifically exploring combinations like 48 or 64. The intuition is that a larger, more uniform negative pool might further enhance the retrieval model's understanding of the vast 30,000-item catalog. I'm also analyzing the runtime implications, observing that the `model.encode_items` step already processes a significant portion of the catalog."
},
{
"kind": "tool",
"timestamp": "2026-09-29T02:55:35.927Z",
"callId": "run_shell_command__call_2852921",
"name": "run_shell_command",
"input": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --target-weighting discovery-graded \\\n --loss-type bce \\\n --uniform-negatives 48 \\\n --inbatch-negatives 8 \\\n --inbatch-correction-power 0.5 \\\n --output /app/solution/exp6_uniform48_inbatch8.parquet",
"description": "Train with 48 uniform and 8 inbatch negatives"
},
"recorded": {
"id": "run_shell_command__call_2852921",
"name": "run_shell_command",
"args": {
"command": "python3 /app/solution/train_current_model.py \\\n --stage validation \\\n --public-dir /task \\\n --prepared-cache /app/solution/validation_cache.npz \\\n --target-weighting discovery-graded \\\n --loss-type bce \\\n --uniform-negatives 48 \\\n --inbatch-negatives 8 \\\n --inbatch-correction-power 0.5 \\\n --output /app/solution/exp6_uniform48_inbatch8.parquet",
"description": "Train with 48 uniform and 8 inbatch negatives"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_2852921",
"name": "run_shell_command",
"response": {
"output": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.546935 running_bce=0.538523 elapsed=237.4s\nepoch=1/1 train_loss=0.53649 validation_loss=0.49680 pair_accuracy=0.775 train_targets=1,052,953 validation_targets=130,103 train_seconds=253.0 validation_seconds=19.7\nrestored best validation-BCE checkpoint: epoch=1 loss=0.496797\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp6_uniform48_inbatch8.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 363.611,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 48,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5364929355689915,\n \"positive_logit\": 0.8233693339937159,\n \"negative_logit\": -0.6997988908465026,\n \"pair_accuracy\": 0.7751145723367655,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 253.04984047499966,\n \"validation_loss\": 0.4967968370128568,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 19.672006431000227\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.5436816215515137,\n \"query_norm_std\": 0.6917167901992798,\n \"item_norm_mean\": 1.8821020126342773,\n \"item_norm_std\": 0.8109329342842102\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 2237\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T03:01:43.845Z",
"resultDisplay": "loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.546935 running_bce=0.538523 elapsed=237.4s\nepoch=1/1 train_loss=0.53649 validation_loss=0.49680 pair_accuracy=0.775 train_targets=1,052,953 validation_targets=130,103 train_seconds=253.0 validation_seconds=19.7\nrestored best validation-BCE checkpoint: epoch=1 loss=0.496797\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp6_uniform48_inbatch8.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 363.611,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 48,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5364929355689915,\n \"positive_logit\": 0.8233693339937159,\n \"negative_logit\": -0.6997988908465026,\n \"pair_accuracy\": 0.7751145723367655,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 253.04984047499966,\n \"validation_loss\": 0.4967968370128568,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 19.672006431000227\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.5436816215515137,\n \"query_norm_std\": 0.6917167901992798,\n \"item_norm_mean\": 1.8821020126342773,\n \"item_norm_std\": 0.8109329342842102\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}",
"description": "Train with 48 uniform and 8 inbatch negatives",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T03:01:46.985Z",
"content": "\nOutput: loaded full-sequence cache: tokens=20,056,329 targets=20,047,194\nchronological BCE window: train=1,052,953 validation=130,103 selected=1,183,056 discarded_old_targets=18,864,138 all=20,047,194\ninbatch correction: min=0.250 mean_on_targets=1.001 max=4.000\nloaded organic-like outcomes: rows=301,527 users=7,526\ngrade-3 first-encounter targets=46,417 horizon_days=7\ntarget weighting=discovery-graded min=0.250 mean=0.310 max=3.000\nfull-history false-negative filter: users=9,135 unique_user_items=5,524,275 bytes=34,256,250\nepoch=1/1 batches=250 targets=987,417 batch_bce=0.546935 running_bce=0.538523 elapsed=237.4s\nepoch=1/1 train_loss=0.53649 validation_loss=0.49680 pair_accuracy=0.775 train_targets=1,052,953 validation_targets=130,103 train_seconds=253.0 validation_seconds=19.7\nrestored best validation-BCE checkpoint: epoch=1 loss=0.496797\nranked users=1,024/8,456\nranked users=2,048/8,456\nranked users=3,072/8,456\nranked users=4,096/8,456\nranked users=5,120/8,456\nranked users=6,144/8,456\nranked users=7,168/8,456\nranked users=8,192/8,456\nranked users=8,456/8,456\n{\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": \"validation\",\n \"output\": \"/app/solution/exp6_uniform48_inbatch8.parquet\",\n \"rows\": 845600,\n \"users\": 8456,\n \"runtime_seconds\": 363.611,\n \"public_inputs_only\": true,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": \"every-adjacent-target-within-recent-chronological-window\",\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": false,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": \"24-uniform-plus-8-propensity-corrected-inbatch\",\n \"false_negative_filter\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\"\n },\n \"config\": {\n \"bptt_steps\": 100,\n \"user_batch_size\": 64,\n \"embedding_dim\": 192,\n \"hidden_dim\": 192,\n \"user_hidden_1\": 512,\n \"user_hidden_2\": 256,\n \"item_hidden_1\": 512,\n \"item_hidden_2\": 256,\n \"dropout\": 0.05,\n \"epochs\": 1,\n \"learning_rate\": 0.001,\n \"weight_decay\": 1e-05,\n \"gradient_clip\": 2.0,\n \"loss_microbatch_size\": 65536,\n \"uniform_negatives\": 48,\n \"inbatch_negatives\": 8,\n \"inbatch_correction_power\": 0.5,\n \"inbatch_correction_min\": 0.25,\n \"inbatch_correction_max\": 4.0,\n \"negative_filter_scope\": \"full-training-history\",\n \"target_weighting\": \"discovery-graded\",\n \"ordinary_target_weight\": 0.25,\n \"organic_strong_target_weight\": 1.0,\n \"organic_like_target_weight\": 3.0,\n \"discovery_horizon_days\": 7,\n \"validation_fraction\": 0.1,\n \"max_train_targets_per_user\": 128,\n \"max_validation_targets_per_user\": 16,\n \"early_stopping_patience\": 1,\n \"early_stopping_min_delta\": 0.0001,\n \"loss_type\": \"bce\",\n \"temperature\": 0.1,\n \"seed\": 29\n },\n \"sequence_tokens\": 20056329,\n \"all_next_item_targets\": 20047194,\n \"selected_training_targets\": 1052953,\n \"selected_validation_targets\": 130103,\n \"discarded_old_targets\": 18864138,\n \"training_history\": [\n {\n \"epoch\": 1.0,\n \"loss\": 0.5364929355689915,\n \"positive_logit\": 0.8233693339937159,\n \"negative_logit\": -0.6997988908465026,\n \"pair_accuracy\": 0.7751145723367655,\n \"targets\": 1052953.0,\n \"target_weight_sum\": 348780.0,\n \"batches\": 266.0,\n \"seconds\": 253.04984047499966,\n \"validation_loss\": 0.4967968370128568,\n \"validation_targets\": 130103.0,\n \"validation_target_weight_sum\": 42129.5,\n \"validation_seconds\": 19.672006431000227\n }\n ],\n \"embedding_diagnostics\": {\n \"query_norm_mean\": 1.5436816215515137,\n \"query_norm_std\": 0.6917167901992798,\n \"item_norm_mean\": 1.8821020126342773,\n \"item_norm_std\": 0.8109329342842102\n },\n \"torch_version\": \"2.8.0+cpu\",\n \"device\": \"cpu\"\n}\nProcess Group PGID: 2237\n",
"isError": false
},
"responseMessageId": "10362692-1825-4765-8c6d-d0b9394b1f8a"
}
]
},
{
"id": 92,
"role": "agent",
"timestamp": "2026-09-29T03:01:54.992Z",
"blocks": [
{
"kind": "tool",
"timestamp": "2026-09-29T03:01:54.992Z",
"callId": "run_shell_command__call_3576940",
"name": "run_shell_command",
"input": {
"command": "python3 /task/evaluate_public.py /app/solution/exp6_uniform48_inbatch8.parquet",
"description": "Evaluate exp6 ranking"
},
"recorded": {
"id": "run_shell_command__call_3576940",
"name": "run_shell_command",
"args": {
"command": "python3 /task/evaluate_public.py /app/solution/exp6_uniform48_inbatch8.parquet",
"description": "Evaluate exp6 ranking"
},
"result": [
{
"functionResponse": {
"id": "run_shell_command__call_3576940",
"name": "run_shell_command",
"response": {
"output": "\nOutput: {\n \"model\": \"/app/solution/exp6_uniform48_inbatch8.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.024565,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 2268\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T03:01:58.347Z",
"resultDisplay": "{\n \"model\": \"/app/solution/exp6_uniform48_inbatch8.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.024565,\n \"quality_users\": 4263\n }\n}",
"description": "python3 /task/evaluate_public.py /app/solution/exp6_uniform48_inbatch8.parquet",
"displayName": "Shell",
"renderOutputAsMarkdown": false
},
"result": {
"timestamp": "2026-09-29T03:01:58.350Z",
"content": "\nOutput: {\n \"model\": \"/app/solution/exp6_uniform48_inbatch8.parquet\",\n \"scores\": {\n \"quality_ndcg@10\": 0.024565,\n \"quality_users\": 4263\n }\n}\nProcess Group PGID: 2268\n",
"isError": false
},
"responseMessageId": "d9ad50c2-a72d-4ca0-b601-6d49ee9651ff"
}
]
},
{
"id": 93,
"role": "agent",
"timestamp": "2026-09-29T03:02:09.342Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T03:02:09.342Z",
"text": "Improving NDCG@10 Performance\n\nMy latest experiments have yielded encouraging results. Specifically, I observed a jump in NDCG@10 to 0.024565, a significant improvement over the baseline of 0.021280. This progress is largely attributed to experiment 6, which employed discovery-graded weighting with 48 uniform and 8 in-batch samples, surpassing experiment 1's 0.023522."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T03:02:09.342Z",
"text": "Exploring Hyperparameter Adjustments\n\nI'm now investigating the impact of increasing `uniform_negatives` and tweaking `inbatch_negatives`. I'm also considering varying `inbatch_correction_power`, starting with `uniform_negatives = 64, inbatch_negatives = 8`. Given our remaining time budget, I need to prioritize running the final submission training."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T03:02:09.342Z",
"text": "Securing Submission File\n\nI'm prioritizing generating a valid submission file immediately. This involves running `--stage submission` with current best settings to ensure `submission.parquet` is created, mitigating any timeout risks. I’ll then save this best valid submission to safeguard against deadline issues."
},
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T03:02:09.342Z",
"text": "Validating Submission Criteria\n\nI'm ensuring my submission adheres to strict formatting rules: integer entries, all target users included, exactly 100 distinct items and ranks per user, and only from eligible candidates. The current best settings are `--target-weighting discovery-graded`, `--uniform-negatives 48`, `--inbatch-negatives 8`, `--inbatch-correction-power 0.5`, and `--loss-type bce`. I will now proceed with the submission stage."
},
{
"kind": "tool",
"timestamp": "2026-09-29T03:02:09.342Z",
"callId": "read_file__call_59740",
"name": "read_file",
"input": {
"start_line": 45,
"file_path": "/app/solution/train_current_model.py",
"end_line": 75
},
"recorded": {
"id": "read_file__call_59740",
"name": "read_file",
"args": {
"start_line": 45,
"file_path": "/app/solution/train_current_model.py",
"end_line": 75
},
"result": [
{
"functionResponse": {
"id": "read_file__call_59740",
"name": "read_file",
"response": {
"output": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 45-75 of 2215 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 76.\n\n--- FILE CONTENT (truncated) ---\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n"
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T03:02:09.351Z",
"resultDisplay": "Read lines 45-75 of 2215 from solution/train_current_model.py",
"description": "solution/train_current_model.py",
"displayName": "ReadFile",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T03:02:09.354Z",
"content": "\nIMPORTANT: The file content has been truncated.\nStatus: Showing lines 45-75 of 2215 total lines.\nAction: To read more of the file, you can use the 'start_line' and 'end_line' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use start_line: 76.\n\n--- FILE CONTENT (truncated) ---\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n",
"isError": false
},
"responseMessageId": "9f7525d2-026b-416e-923d-89f9f22b17cc"
}
]
},
{
"id": 94,
"role": "agent",
"timestamp": "2026-09-29T03:02:19.984Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T03:02:19.984Z",
"text": "Updating Configuration Defaults\n\nI'm refining the default negative sampling parameters within `Config` in `train_current_model.py`. Specifically, I'm setting `uniform_negatives` to 48, `inbatch_negatives` to 8, and `inbatch_correction_power` to 0.5 to optimize our training process."
},
{
"kind": "tool",
"timestamp": "2026-09-29T03:02:19.984Z",
"callId": "replace__call_7706670",
"name": "replace",
"input": {
"old_string": " uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29",
"new_string": " uniform_negatives: int = 48\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"bce\"\n temperature: float = 0.10\n seed: int = 29",
"allow_multiple": false,
"instruction": "Set best hyperparameters as Config defaults",
"file_path": "/app/solution/train_current_model.py"
},
"recorded": {
"id": "replace__call_7706670",
"name": "replace",
"args": {
"old_string": " uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29",
"new_string": " uniform_negatives: int = 48\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"bce\"\n temperature: float = 0.10\n seed: int = 29",
"allow_multiple": false,
"instruction": "Set best hyperparameters as Config defaults",
"file_path": "/app/solution/train_current_model.py"
},
"result": [
{
"functionResponse": {
"id": "replace__call_7706670",
"name": "replace",
"response": {
"output": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 48\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n...\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"bce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\n..."
}
}
}
],
"status": "success",
"timestamp": "2026-09-29T03:02:19.998Z",
"resultDisplay": {
"fileDiff": "Index: train_current_model.py\n===================================================================\n--- train_current_model.py\tCurrent\n+++ train_current_model.py\tProposed\n@@ -53,9 +53,9 @@\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n- uniform_negatives: int = 16\n- inbatch_negatives: int = 16\n- inbatch_correction_power: float = 0.0\n+ uniform_negatives: int = 48\n+ inbatch_negatives: int = 8\n+ inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n@@ -69,7 +69,7 @@\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n- loss_type: str = \"infonce\"\n+ loss_type: str = \"bce\"\n temperature: float = 0.10\n seed: int = 29\n \n",
"fileName": "train_current_model.py",
"filePath": "/app/solution/train_current_model.py",
"originalContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 16\n inbatch_negatives: int = 16\n inbatch_correction_power: float = 0.0\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"infonce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n if config.loss_type == \"infonce\":\n all_logits = torch.cat(\n [positive_logits.unsqueeze(1), negative_logits], dim=1\n )\n scaled_logits = all_logits / config.temperature\n target_zeros = torch.zeros(\n len(all_logits), dtype=torch.long, device=device\n )\n row_losses = F.cross_entropy(\n scaled_logits, target_zeros, reduction=\"none\"\n )\n loss_sum = (selected_weights * row_losses).sum()\n else:\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n parser.add_argument(\n \"--uniform-negatives\",\n type=int,\n default=Config.uniform_negatives,\n )\n parser.add_argument(\n \"--inbatch-negatives\",\n type=int,\n default=Config.inbatch_negatives,\n )\n parser.add_argument(\n \"--loss-type\",\n choices=(\"infonce\", \"bce\"),\n default=Config.loss_type,\n )\n parser.add_argument(\n \"--temperature\",\n type=float,\n default=Config.temperature,\n )\n parser.add_argument(\n \"--inbatch-correction-power\",\n type=float,\n default=Config.inbatch_correction_power,\n )\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n or args.temperature <= 0\n or args.uniform_negatives < 0\n or args.inbatch_negatives < 0\n ):\n parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n if args.uniform_negatives + args.inbatch_negatives < 1:\n parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n uniform_negatives=args.uniform_negatives,\n inbatch_negatives=args.inbatch_negatives,\n inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n loss_type=args.loss_type,\n temperature=args.temperature,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"newContent": "#!/usr/bin/env python3\n\"\"\"Train the Yambda windowed two-tower baseline.\n\nEvery catalog listen with at least 50 percent completion is a sequence token.\nWithin each selected chronological window, every adjacent target contributes a\nloss. The fast default retains each user's most recent 128 training targets and\n16 held-out validation targets; passing zero for either cap restores the\nuncapped behavior for that side of the split. A 100-step truncated-BPTT block\ncomputes all of its timestep losses and carries the detached GRU hidden state\ninto the next block.\n\nThe model is a pure two-tower retriever: no user-ID embedding, no output\nnormalization, raw dot-product retrieval, sample-weighted binary cross entropy,\nand 24 uniform plus eight propensity-corrected unique in-batch negatives. Every\nselected adjacent target retains a nonzero weight. Only files under the supplied\npublic directory are read.\n\"\"\"\nfrom __future__ import annotations\n\nimport argparse\nimport json\nimport random\nimport sys\nimport time\nfrom dataclasses import asdict, dataclass\nfrom pathlib import Path\n\nimport numpy as np\nimport pandas as pd\nimport torch\nfrom torch import nn\nfrom torch.nn import functional as F\n\nimport two_tower_model as base\n\n\nCACHE_VERSION = 2\n\n\n@dataclass(frozen=True)\nclass Config:\n bptt_steps: int = 100\n user_batch_size: int = 64\n embedding_dim: int = 192\n hidden_dim: int = 192\n user_hidden_1: int = 512\n user_hidden_2: int = 256\n item_hidden_1: int = 512\n item_hidden_2: int = 256\n dropout: float = 0.05\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 48\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n organic_strong_target_weight: float = 1.0\n organic_like_target_weight: float = 3.0\n discovery_horizon_days: int = 7\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"bce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\nclass CandidateSet:\n uids: np.ndarray\n item_ids: np.ndarray\n packed: np.ndarray\n\n @classmethod\n def read(cls, path: Path) -> \"CandidateSet\":\n with np.load(path, allow_pickle=False) as artifact:\n result = cls(\n uids=artifact[\"uids\"].astype(np.int64, copy=True),\n item_ids=artifact[\"item_ids\"].astype(np.int64, copy=True),\n packed=artifact[\"packed_eligible\"].astype(np.uint8, copy=True),\n )\n expected = (len(result.uids), (len(result.item_ids) + 7) // 8)\n if result.packed.shape != expected:\n raise ValueError(\n f\"invalid candidate artifact shape {result.packed.shape}; \"\n f\"expected {expected}\"\n )\n return result\n\n\n@dataclass(frozen=True)\nclass SequenceData:\n item_ids: np.ndarray\n item_features: np.ndarray\n user_ids: np.ndarray\n offsets: np.ndarray\n sequence_timestamps: np.ndarray\n sequence_items: np.ndarray\n event_features: np.ndarray\n activity_features: np.ndarray\n state_ids: np.ndarray\n liked_states: np.ndarray\n disliked_states: np.ndarray\n state_counts: np.ndarray\n inference_user_rows: np.ndarray\n inference_liked_items: np.ndarray\n inference_disliked_items: np.ndarray\n inference_user_features: np.ndarray\n\n @property\n def lengths(self) -> np.ndarray:\n return np.diff(self.offsets)\n\n @property\n def target_count(self) -> int:\n return int(np.maximum(self.lengths - 1, 0).sum())\n\n\n@dataclass(frozen=True)\nclass TargetPartition:\n \"\"\"A contiguous recent target window and its chronological BCE split.\"\"\"\n\n window_starts: np.ndarray\n training_counts: np.ndarray\n validation_counts: np.ndarray\n history_training_counts: np.ndarray\n\n @property\n def selected_count(self) -> int:\n return int(self.training_counts.sum() + self.validation_counts.sum())\n\n\ndef log(message: str) -> None:\n print(message, file=sys.stderr, flush=True)\n\n\ndef seed_everything(seed: int) -> None:\n random.seed(seed)\n np.random.seed(seed)\n torch.manual_seed(seed)\n\n\ndef model_config(config: Config) -> base.TowerConfig:\n \"\"\"Map the dense trainer configuration onto the unchanged tower.\"\"\"\n return base.TowerConfig(\n sequence_length=config.bptt_steps,\n embedding_dim=config.embedding_dim,\n hidden_dim=config.hidden_dim,\n user_hidden_1=config.user_hidden_1,\n user_hidden_2=config.user_hidden_2,\n item_hidden_1=config.item_hidden_1,\n item_hidden_2=config.item_hidden_2,\n dropout=config.dropout,\n epochs=config.epochs,\n learning_rate=config.learning_rate,\n weight_decay=config.weight_decay,\n gradient_clip=config.gradient_clip,\n uniform_negatives=config.uniform_negatives,\n inbatch_negatives=config.inbatch_negatives,\n inbatch_correction_power=config.inbatch_correction_power,\n inbatch_correction_min=config.inbatch_correction_min,\n inbatch_correction_max=config.inbatch_correction_max,\n seed=config.seed,\n )\n\n\ndef append_state_snapshot(\n active_likes: dict[int, int],\n active_dislikes: dict[int, int],\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> int:\n liked_states.append(base.pack_active_items(active_likes, base.LIKE_ITEMS, n_items))\n disliked_states.append(\n base.pack_active_items(active_dislikes, base.DISLIKE_ITEMS, n_items)\n )\n state_counts.append((len(active_likes), len(active_dislikes)))\n return len(liked_states) - 1\n\n\ndef causal_activity_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n organic: np.ndarray,\n completion: np.ndarray,\n) -> np.ndarray:\n \"\"\"Compute the first four reviewed user features at every event cutoff.\"\"\"\n length = len(items)\n result = np.zeros((length, 4), dtype=np.float16)\n if not length:\n return result\n left_rows = np.searchsorted(\n timestamps,\n timestamps - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n rows = np.arange(length, dtype=np.int64)\n counts = rows - left_rows + 1\n organic_sum = np.cumsum(organic.astype(np.float64))\n completion_sum = np.cumsum(np.minimum(completion, 100).astype(np.float64))\n before_organic = np.where(\n left_rows > 0, organic_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n before_completion = np.where(\n left_rows > 0, completion_sum[np.maximum(left_rows - 1, 0)], 0.0\n )\n\n unique_counts = np.empty(length, dtype=np.int32)\n frequencies: dict[int, int] = {}\n left = 0\n for right, raw_item in enumerate(items):\n item = int(raw_item)\n frequencies[item] = frequencies.get(item, 0) + 1\n required_left = int(left_rows[right])\n while left < required_left:\n old_item = int(items[left])\n remaining = frequencies[old_item] - 1\n if remaining:\n frequencies[old_item] = remaining\n else:\n del frequencies[old_item]\n left += 1\n unique_counts[right] = len(frequencies)\n\n result[:, 0] = (np.log1p(counts) / 8.0).astype(np.float16)\n result[:, 1] = (np.log1p(unique_counts) / 6.0).astype(np.float16)\n result[:, 2] = (\n (organic_sum - before_organic) / np.maximum(counts, 1)\n ).astype(np.float16)\n result[:, 3] = (\n (completion_sum - before_completion)\n / np.maximum(counts, 1)\n / 100.0\n ).astype(np.float16)\n return result\n\n\ndef build_sequence_parts(\n listens: base.ListenEvents,\n explicit: base.ExplicitEvents,\n n_items: int,\n liked_states: list[np.ndarray],\n disliked_states: list[np.ndarray],\n state_counts: list[tuple[int, int]],\n) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray, np.ndarray] | None:\n qualifying = listens.completion_pct >= base.LISTEN_POSITIVE_THRESHOLD\n timestamps = listens.timestamps[qualifying].astype(np.int64, copy=False)\n items = listens.items[qualifying].astype(np.uint16, copy=False)\n organic = listens.organic[qualifying].astype(np.float32, copy=False)\n completion = listens.completion_pct[qualifying].astype(np.float32, copy=False)\n if not len(items):\n return None\n\n event_features = np.zeros((len(items), 3), dtype=np.float16)\n event_features[:, 0] = organic.astype(np.float16)\n event_features[:, 1] = (\n np.minimum(completion, 100.0) / 100.0\n ).astype(np.float16)\n if len(items) > 1:\n gaps = np.maximum(0, timestamps[1:] - timestamps[:-1])\n event_features[1:, 2] = np.exp(\n -gaps.astype(np.float64) / (60.0 * base.DAY)\n ).astype(np.float16)\n\n activity = causal_activity_features(\n timestamps, items, organic, completion\n )\n states = np.zeros(len(items), dtype=np.uint32)\n active_likes: dict[int, int] = {}\n active_dislikes: dict[int, int] = {}\n explicit_position = 0\n current_state = 0\n for row, timestamp in enumerate(timestamps):\n changed = False\n while (\n explicit_position < len(explicit.timestamps)\n and int(explicit.timestamps[explicit_position]) < int(timestamp)\n ):\n item = int(explicit.items[explicit_position])\n event_timestamp = int(explicit.timestamps[explicit_position])\n destination = (\n active_likes\n if int(explicit.channel[explicit_position]) == 0\n else active_dislikes\n )\n if int(explicit.active[explicit_position]) == 1:\n destination[item] = event_timestamp\n else:\n destination.pop(item, None)\n explicit_position += 1\n changed = True\n if changed:\n current_state = append_state_snapshot(\n active_likes,\n active_dislikes,\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n states[row] = np.uint32(current_state)\n return timestamps, items.copy(), event_features, activity, states\n\n\ndef final_user_features(\n timestamps: np.ndarray,\n items: np.ndarray,\n event_features: np.ndarray,\n history_end: int,\n like_count: int,\n dislike_count: int,\n) -> np.ndarray:\n start = int(\n np.searchsorted(\n timestamps,\n history_end - base.PROFILE_LOOKBACK_DAYS * base.DAY,\n side=\"left\",\n )\n )\n result = np.zeros(6, dtype=np.float32)\n recent_items = items[start:]\n if len(recent_items):\n result[0] = np.log1p(len(recent_items)) / 8.0\n result[1] = np.log1p(len(np.unique(recent_items))) / 6.0\n result[2] = float(np.mean(event_features[start:, 0]))\n result[3] = float(np.mean(event_features[start:, 1]))\n result[4] = np.log1p(like_count) / 6.0\n result[5] = np.log1p(dislike_count) / 4.0\n return result\n\n\ndef prepare_data(\n public: Path, stage: str, config: Config\n) -> tuple[SequenceData, CandidateSet]:\n data = public / \"data\"\n catalog = pd.read_parquet(data / \"candidate_catalog.parquet\").sort_values(\n \"popularity_rank\"\n )\n item_ids = catalog.item_id.to_numpy(dtype=np.int64, copy=True)\n item_index = pd.Index(item_ids)\n n_items = len(item_ids)\n if n_items >= np.iinfo(np.uint16).max:\n raise RuntimeError(\"uint16 item storage is too small for this catalog\")\n\n if stage == \"validation\":\n prefixes = (\"train\",)\n history_end = base.TRAIN_END\n candidate_name = \"validation_eligible_candidates.npz\"\n state_name = \"validation_preference_state.parquet\"\n else:\n prefixes = (\"train\", \"val\")\n history_end = base.VALIDATION_END\n candidate_name = \"test_eligible_candidates.npz\"\n state_name = \"test_preference_state.parquet\"\n eligibility = CandidateSet.read(data / candidate_name)\n if not np.array_equal(eligibility.item_ids, item_ids):\n raise RuntimeError(\"catalog and candidate artifact item order differ\")\n\n explicit_by_user = base.load_explicit_events(data, prefixes, item_index)\n inference_likes, inference_dislikes, like_counts, dislike_counts = (\n base.load_inference_state(\n data / state_name,\n item_index,\n eligibility.uids,\n n_items,\n )\n )\n inference_rows = {int(uid): row for row, uid in enumerate(eligibility.uids)}\n inference_user_features = np.zeros((len(eligibility.uids), 6), dtype=np.float32)\n inference_sequence_rows = np.full(len(eligibility.uids), -1, dtype=np.int32)\n\n # Snapshot zero is the shared empty explicit state.\n liked_states = [np.full(base.LIKE_ITEMS, n_items, dtype=np.uint16)]\n disliked_states = [\n np.full(base.DISLIKE_ITEMS, n_items, dtype=np.uint16)\n ]\n state_counts: list[tuple[int, int]] = [(0, 0)]\n user_ids: list[int] = []\n offsets = [0]\n timestamp_parts: list[np.ndarray] = []\n item_parts: list[np.ndarray] = []\n event_parts: list[np.ndarray] = []\n activity_parts: list[np.ndarray] = []\n state_parts: list[np.ndarray] = []\n\n listen_paths = [data / f\"{prefix}_listens.parquet\" for prefix in prefixes]\n started = time.monotonic()\n for seen_users, (uid, listens) in enumerate(\n base.merge_listen_streams(listen_paths, item_index), start=1\n ):\n parts = build_sequence_parts(\n listens,\n explicit_by_user.get(uid, base.empty_explicit_events()),\n n_items,\n liked_states,\n disliked_states,\n state_counts,\n )\n if parts is None:\n continue\n sequence_row = len(user_ids)\n user_ids.append(uid)\n timestamp_parts.append(parts[0].astype(np.uint32, copy=False))\n item_parts.append(parts[1])\n event_parts.append(parts[2])\n activity_parts.append(parts[3])\n state_parts.append(parts[4])\n offsets.append(offsets[-1] + len(parts[1]))\n inference_row = inference_rows.get(uid)\n if inference_row is not None:\n inference_sequence_rows[inference_row] = sequence_row\n inference_user_features[inference_row] = final_user_features(\n parts[0],\n parts[1],\n parts[2],\n history_end,\n int(like_counts[inference_row]),\n int(dislike_counts[inference_row]),\n )\n if seen_users % 1_000 == 0:\n log(\n f\"prepared users={seen_users:,} tokens={offsets[-1]:,} \"\n f\"states={len(liked_states):,} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n missing = np.flatnonzero(inference_sequence_rows < 0)\n if len(missing):\n inference_user_features[missing, 4] = np.log1p(like_counts[missing]) / 6.0\n inference_user_features[missing, 5] = (\n np.log1p(dislike_counts[missing]) / 4.0\n )\n log(f\"target users without qualifying catalog sequence={len(missing):,}\")\n\n prepared = SequenceData(\n item_ids=item_ids,\n item_features=base.build_item_features(catalog),\n user_ids=np.asarray(user_ids, dtype=np.int64),\n offsets=np.asarray(offsets, dtype=np.int64),\n sequence_timestamps=np.concatenate(timestamp_parts),\n sequence_items=np.concatenate(item_parts),\n event_features=np.concatenate(event_parts),\n activity_features=np.concatenate(activity_parts),\n state_ids=np.concatenate(state_parts),\n liked_states=np.stack(liked_states),\n disliked_states=np.stack(disliked_states),\n state_counts=np.asarray(state_counts, dtype=np.int32),\n inference_user_rows=inference_sequence_rows,\n inference_liked_items=inference_likes,\n inference_disliked_items=inference_dislikes,\n inference_user_features=inference_user_features,\n )\n log(\n f\"prepared stage={stage} sequence_users={len(prepared.user_ids):,} \"\n f\"tokens={len(prepared.sequence_items):,} \"\n f\"next_item_targets={prepared.target_count:,} \"\n f\"states={len(prepared.liked_states):,}\"\n )\n return prepared, eligibility\n\n\ndef cache_metadata(stage: str, config: Config) -> dict[str, object]:\n return {\n \"cache_version\": CACHE_VERSION,\n \"stage\": stage,\n \"positive_listen_threshold\": base.LISTEN_POSITIVE_THRESHOLD,\n \"profile_lookback_days\": base.PROFILE_LOOKBACK_DAYS,\n \"event_time_feature\": \"exp-negative-gap-over-60-days\",\n }\n\n\ndef save_cache(\n path: Path, prepared: SequenceData, stage: str, config: Config\n) -> None:\n path.parent.mkdir(parents=True, exist_ok=True)\n np.savez(\n path,\n metadata=np.asarray(json.dumps(cache_metadata(stage, config), sort_keys=True)),\n **prepared.__dict__,\n )\n log(f\"saved public-derived full-sequence cache: {path}\")\n\n\ndef load_cache(path: Path, stage: str, config: Config) -> SequenceData:\n with np.load(path, allow_pickle=False) as artifact:\n actual = json.loads(str(artifact[\"metadata\"].item()))\n expected = cache_metadata(stage, config)\n if actual != expected:\n raise RuntimeError(f\"sequence cache differs: {actual} != {expected}\")\n values = {\n field: artifact[field].copy()\n for field in SequenceData.__dataclass_fields__\n }\n prepared = SequenceData(**values)\n log(\n f\"loaded full-sequence cache: tokens={len(prepared.sequence_items):,} \"\n f\"targets={prepared.target_count:,}\"\n )\n return prepared\n\n\ndef load_or_prepare(\n public: Path,\n stage: str,\n config: Config,\n cache: Path | None,\n) -> tuple[SequenceData, CandidateSet]:\n candidate_name = (\n \"validation_eligible_candidates.npz\"\n if stage == \"validation\"\n else \"test_eligible_candidates.npz\"\n )\n eligibility = CandidateSet.read(public / \"data\" / candidate_name)\n if cache is not None and cache.is_file():\n prepared = load_cache(cache, stage, config)\n if not np.array_equal(prepared.item_ids, eligibility.item_ids):\n raise RuntimeError(\"cached catalog differs from candidate artifact\")\n return prepared, eligibility\n prepared, built_eligibility = prepare_data(public, stage, config)\n if cache is not None:\n save_cache(cache, prepared, stage, config)\n return prepared, built_eligibility\n\n\ndef build_item_correction(\n prepared: SequenceData,\n config: Config,\n target_starts: np.ndarray,\n target_counts: np.ndarray,\n) -> torch.Tensor:\n \"\"\"Estimate in-batch propensities from the selected training targets.\"\"\"\n counts = np.zeros(len(prepared.item_ids), dtype=np.float64)\n for user_row, count in enumerate(target_counts):\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n target_start = int(target_starts[user_row])\n counts += np.bincount(\n prepared.sequence_items[\n offset\n + target_start\n + 1 : offset\n + target_start\n + int(count)\n + 1\n ].astype(np.int64),\n minlength=len(prepared.item_ids),\n )\n total = float(counts.sum())\n probabilities = (counts + 1.0) / (total + len(counts))\n raw = np.power(\n (1.0 / len(counts)) / probabilities,\n config.inbatch_correction_power,\n )\n normalization = float(np.sum(counts * raw) / max(total, 1.0))\n correction = np.clip(\n raw / max(normalization, 1.0e-12),\n config.inbatch_correction_min,\n config.inbatch_correction_max,\n ).astype(np.float32)\n mean_on_targets = float(np.sum(counts * correction) / max(total, 1.0))\n log(\n f\"inbatch correction: min={correction.min():.3f} \"\n f\"mean_on_targets={mean_on_targets:.3f} max={correction.max():.3f}\"\n )\n return torch.from_numpy(correction)\n\n\ndef build_known_positive_filter(\n prepared: SequenceData, training_counts: np.ndarray\n) -> np.ndarray:\n \"\"\"Pack each user's complete public-training positive-item set.\"\"\"\n width = (len(prepared.item_ids) + 7) // 8\n packed = np.zeros((len(prepared.user_ids), width), dtype=np.uint8)\n retained = 0\n for user_row, target_count in enumerate(training_counts):\n if not target_count:\n continue\n offset = int(prepared.offsets[user_row])\n # T adjacent targets consume sequence positions 0 through T. The\n # chronological BCE suffix starts at T + 1 and is intentionally absent.\n items = np.unique(\n prepared.sequence_items[\n offset : offset + int(target_count) + 1\n ].astype(np.int64)\n )\n byte_columns = items >> 3\n bit_values = np.left_shift(\n np.uint8(1), (items & 7).astype(np.uint8)\n )\n np.bitwise_or.at(packed[user_row], byte_columns, bit_values)\n retained += len(items)\n log(\n f\"full-history false-negative filter: users={len(prepared.user_ids):,} \"\n f\"unique_user_items={retained:,} bytes={packed.nbytes:,}\"\n )\n return packed\n\n\ndef invalid_full_history_negatives(\n negatives: np.ndarray,\n targets: np.ndarray,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray,\n liked_items: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return row-level invalid negatives using the complete training prefix.\"\"\"\n byte_columns = negatives >> 3\n bit_columns = negatives & 7\n known = known_positive_packed[user_rows[:, None], byte_columns]\n invalid = ((known >> bit_columns) & 1).astype(bool)\n invalid |= negatives == targets[:, None]\n invalid |= (negatives[:, :, None] == liked_items[:, None, :]).any(axis=2)\n for column in range(1, negatives.shape[1]):\n invalid[:, column] |= (\n negatives[:, column, None] == negatives[:, :column]\n ).any(axis=1)\n return invalid\n\n\ndef draw_full_history_filtered_negatives(\n targets: torch.Tensor,\n user_rows: np.ndarray,\n liked_items: torch.Tensor,\n known_positive_packed: np.ndarray,\n n_items: int,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n \"\"\"Draw mixed negatives and reject all known public-training positives.\"\"\"\n targets_cpu = targets.detach().cpu().numpy().astype(np.int64, copy=False)\n liked_cpu = liked_items.detach().cpu().numpy().astype(np.int64, copy=False)\n batch_size = len(targets_cpu)\n uniform = torch.randint(\n n_items,\n (batch_size, config.uniform_negatives),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.empty((batch_size, 0), dtype=torch.long)\n corrected_count = 0\n if config.inbatch_negatives:\n unique_targets = torch.unique(targets.detach().cpu())\n corrected_count = min(\n config.inbatch_negatives, max(len(unique_targets) - 1, 0)\n )\n if corrected_count:\n priorities = torch.rand(\n (batch_size, len(unique_targets)), generator=generator\n )\n priorities.masked_fill_(\n unique_targets[None, :].eq(\n torch.from_numpy(targets_cpu)[:, None]\n ),\n -1.0,\n )\n columns = torch.topk(\n priorities, k=corrected_count, dim=1\n ).indices\n inbatch = unique_targets[columns]\n if corrected_count < config.inbatch_negatives:\n filler = torch.randint(\n n_items,\n (batch_size, config.inbatch_negatives - corrected_count),\n generator=generator,\n device=\"cpu\",\n )\n inbatch = torch.cat([inbatch, filler], dim=1)\n\n negatives = torch.cat([uniform, inbatch], dim=1).numpy()\n correction = np.ones_like(negatives, dtype=np.float32)\n if corrected_count:\n correction[\n :, config.uniform_negatives : config.uniform_negatives + corrected_count\n ] = item_correction[inbatch[:, :corrected_count]].numpy()\n for _ in range(32):\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if not np.any(invalid):\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n replacements = torch.randint(\n n_items,\n (int(invalid.sum()),),\n generator=generator,\n device=\"cpu\",\n ).numpy()\n negatives[invalid] = replacements\n # Rejected in-batch items become ordinary uniform draws.\n correction[invalid] = 1.0\n invalid = invalid_full_history_negatives(\n negatives,\n targets_cpu,\n user_rows,\n known_positive_packed,\n liked_cpu,\n )\n if np.any(invalid):\n raise RuntimeError(\"full-history negative resampling failed\")\n return (\n torch.from_numpy(negatives).to(device),\n torch.from_numpy(correction).to(device),\n )\n\n\ndef draw_training_negatives(\n positive_items: torch.Tensor,\n known_history: torch.Tensor,\n liked_items: torch.Tensor,\n user_rows: np.ndarray,\n known_positive_packed: np.ndarray | None,\n prepared: SequenceData,\n config: Config,\n item_correction: torch.Tensor,\n generator: torch.Generator,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor]:\n if config.negative_filter_scope == \"full-training-history\":\n if known_positive_packed is None:\n raise RuntimeError(\"full-history negative filter was not built\")\n return draw_full_history_filtered_negatives(\n positive_items,\n user_rows,\n liked_items,\n known_positive_packed,\n len(prepared.item_ids),\n config,\n item_correction,\n generator,\n device,\n )\n return base.draw_filtered_mixed_negatives(\n positive_items,\n known_history,\n liked_items,\n len(prepared.item_ids),\n config.uniform_negatives,\n config.inbatch_negatives,\n item_correction,\n generator,\n device,\n )\n\n\ndef event_sequence(\n model: base.SequentialTwoTower,\n items: torch.Tensor,\n features: torch.Tensor,\n hidden: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n inputs = torch.cat([model.context_embedding(items), features], dim=-1)\n projected = model.event_projection(inputs)\n return model.sequence_encoder(projected, hidden)\n\n\ndef pool_explicit_states(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n state_ids: np.ndarray,\n device: torch.device,\n) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:\n unique_states, inverse = np.unique(state_ids, return_inverse=True)\n liked_items = torch.from_numpy(\n prepared.liked_states[unique_states].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.disliked_states[unique_states].astype(np.int64)\n ).to(device)\n liked_vectors = model._mean_context_channel(liked_items)\n disliked_vectors = model._mean_context_channel(disliked_items)\n inverse_rows = torch.from_numpy(inverse.astype(np.int64)).to(device)\n counts = prepared.state_counts[state_ids]\n return (\n liked_vectors[inverse_rows],\n disliked_vectors[inverse_rows],\n torch.from_numpy(counts.astype(np.float32)).to(device),\n )\n\n\ndef user_queries(\n model: base.SequentialTwoTower,\n sequence_vectors: torch.Tensor,\n liked_vectors: torch.Tensor,\n disliked_vectors: torch.Tensor,\n user_features: torch.Tensor,\n) -> torch.Tensor:\n return model.user_tower(\n torch.cat(\n [sequence_vectors, liked_vectors, disliked_vectors, user_features],\n dim=1,\n )\n )\n\n\ndef candidate_vectors(\n model: base.SequentialTwoTower,\n positives: torch.Tensor,\n negatives: torch.Tensor,\n) -> tuple[torch.Tensor, torch.Tensor]:\n all_items = torch.cat([positives, negatives.reshape(-1)])\n unique_items, inverse = torch.unique(all_items, return_inverse=True)\n encoded = model.encode_items(unique_items)\n positive_vectors = encoded[inverse[: len(positives)]]\n negative_vectors = encoded[inverse[len(positives) :]].reshape(\n len(positives), negatives.shape[1], -1\n )\n return positive_vectors, negative_vectors\n\n\ndef history_windows(\n sequence: np.ndarray,\n start: int,\n count: int,\n width: int,\n padding_item: int,\n) -> np.ndarray:\n base_start = max(0, start - width + 1)\n segment = sequence[base_start : start + count]\n padded = np.concatenate(\n [np.full(width - 1, padding_item, dtype=np.uint16), segment]\n )\n windows = np.lib.stride_tricks.sliding_window_view(padded, width)\n offset = start - base_start\n return windows[offset : offset + count].copy()\n\n\ndef corrected_negative_loss(\n logits: torch.Tensor,\n correction: torch.Tensor,\n config: Config,\n) -> torch.Tensor:\n raw = F.softplus(logits)\n total = config.uniform_negatives + config.inbatch_negatives\n result = torch.zeros(len(logits), device=logits.device)\n if config.uniform_negatives:\n result += config.uniform_negatives * raw[\n :, : config.uniform_negatives\n ].mean(dim=1)\n if config.inbatch_negatives:\n selected = slice(config.uniform_negatives, total)\n weights = correction[:, selected]\n result += config.inbatch_negatives * (\n (raw[:, selected] * weights).sum(dim=1)\n / weights.sum(dim=1).clamp_min(1.0e-6)\n )\n return result / total\n\n\ndef retained_target_window_starts(\n total_targets: np.ndarray,\n validation_counts: np.ndarray,\n training_counts: np.ndarray,\n) -> np.ndarray:\n \"\"\"Return the discarded prefix before the retained chronological suffix.\"\"\"\n training_region_ends = total_targets - validation_counts\n window_starts = training_region_ends - training_counts\n if (\n np.any(window_starts < 0)\n or np.any(training_counts < 0)\n or np.any(validation_counts < 0)\n ):\n raise RuntimeError(\"chronological target partition produced negative counts\")\n if not np.array_equal(\n window_starts + training_counts + validation_counts, total_targets\n ):\n raise RuntimeError(\"chronological target window is not a final contiguous suffix\")\n return window_starts\n\n\ndef chronological_target_partition(\n prepared: SequenceData,\n validation_fraction: float,\n max_train_targets_per_user: int,\n max_validation_targets_per_user: int,\n) -> TargetPartition:\n \"\"\"Select a recent contiguous window with a final out-of-time BCE suffix.\"\"\"\n totals = np.maximum(prepared.lengths - 1, 0).astype(np.int64)\n validation = np.floor(totals * validation_fraction).astype(np.int64)\n validation[(totals >= 2) & (validation == 0)] = 1\n if max_validation_targets_per_user:\n validation = np.minimum(validation, max_validation_targets_per_user)\n\n history_training = totals - validation\n training = history_training.copy()\n if max_train_targets_per_user:\n training = np.minimum(training, max_train_targets_per_user)\n window_starts = retained_target_window_starts(totals, validation, training)\n return TargetPartition(\n window_starts=window_starts,\n training_counts=training,\n validation_counts=validation,\n history_training_counts=history_training,\n )\n\n\ndef load_organic_like_outcomes(\n public: Path, stage: str, item_ids: np.ndarray\n) -> dict[int, dict[int, np.ndarray]]:\n \"\"\"Load mapped organic-like timestamps from public fitting history.\"\"\"\n prefixes = (\"train\",) if stage == \"validation\" else (\"train\", \"val\")\n frames = [\n pd.read_parquet(\n public / \"data\" / f\"{prefix}_likes.parquet\",\n columns=[\"uid\", \"timestamp\", \"item_id\", \"is_organic\"],\n )\n for prefix in prefixes\n ]\n likes = pd.concat(frames, ignore_index=True)\n likes = likes[likes.is_organic == 1].copy()\n mapped = pd.Index(item_ids).get_indexer(\n likes.item_id.to_numpy(dtype=np.int64)\n )\n likes = likes.loc[mapped >= 0, [\"uid\", \"timestamp\"]].copy()\n likes[\"item\"] = mapped[mapped >= 0].astype(np.int32, copy=False)\n likes = likes.sort_values([\"uid\", \"item\", \"timestamp\"], kind=\"stable\")\n nested: dict[int, dict[int, list[int]]] = {}\n for raw_uid, raw_timestamp, raw_item in likes.itertuples(\n index=False, name=None\n ):\n nested.setdefault(int(raw_uid), {}).setdefault(int(raw_item), []).append(\n int(raw_timestamp)\n )\n result = {\n uid: {\n item: np.asarray(timestamps, dtype=np.int64)\n for item, timestamps in items.items()\n }\n for uid, items in nested.items()\n }\n log(\n f\"loaded organic-like outcomes: rows={len(likes):,} \"\n f\"users={len(result):,}\"\n )\n return result\n\n\ndef build_target_weights(\n public: Path,\n stage: str,\n prepared: SequenceData,\n training_counts: np.ndarray,\n config: Config,\n) -> np.ndarray:\n \"\"\"Build nonzero per-token weights without dropping adjacent targets.\"\"\"\n if config.target_weighting == \"uniform\":\n weights = np.ones(len(prepared.sequence_items), dtype=np.float32)\n else:\n weights = np.full(\n len(prepared.sequence_items),\n config.ordinary_target_weight,\n dtype=np.float32,\n )\n organic_strong = (\n (prepared.event_features[:, 0] > 0.5)\n & (prepared.event_features[:, 1] >= 0.8)\n )\n weights[organic_strong] = config.organic_strong_target_weight\n if config.target_weighting == \"discovery-graded\":\n like_outcomes = load_organic_like_outcomes(\n public, stage, prepared.item_ids\n )\n history_end = (\n base.TRAIN_END if stage == \"validation\" else base.VALIDATION_END\n )\n horizon = config.discovery_horizon_days * base.DAY\n grade_three = 0\n for user_row, uid in enumerate(prepared.user_ids):\n start = int(prepared.offsets[user_row])\n end = int(prepared.offsets[user_row + 1])\n if end - start < 2:\n continue\n last_training_target = start + int(training_counts[user_row])\n first_validation_target = last_training_target + 1\n split_timestamp = (\n int(prepared.sequence_timestamps[first_validation_target])\n if first_validation_target < end\n else history_end\n )\n user_likes = like_outcomes.get(int(uid), {})\n seen = {int(prepared.sequence_items[start])}\n for position in range(start + 1, end):\n item = int(prepared.sequence_items[position])\n novel = item not in seen\n seen.add(item)\n if not novel:\n # Repeats remain training examples, but they cannot be\n # eligible discovery outcomes at the corresponding\n # cutoff and therefore keep only the ordinary weight.\n weights[position] = config.ordinary_target_weight\n continue\n timestamps = user_likes.get(item)\n if timestamps is None:\n continue\n timestamp = int(prepared.sequence_timestamps[position])\n upper = min(\n timestamp + horizon,\n split_timestamp\n if position <= last_training_target\n else history_end,\n )\n outcome = int(np.searchsorted(timestamps, timestamp, side=\"left\"))\n if outcome < len(timestamps) and int(timestamps[outcome]) < upper:\n weights[position] = config.organic_like_target_weight\n grade_three += 1\n log(\n f\"grade-3 first-encounter targets={grade_three:,} \"\n f\"horizon_days={config.discovery_horizon_days}\"\n )\n log(\n f\"target weighting={config.target_weighting} \"\n f\"min={weights.min():.3f} mean={weights.mean():.3f} \"\n f\"max={weights.max():.3f}\"\n )\n return weights\n\n\ndef build_dense_block(\n prepared: SequenceData,\n target_weights: np.ndarray,\n users: np.ndarray,\n window_starts: np.ndarray,\n process_counts: np.ndarray,\n score_starts: np.ndarray,\n start: int,\n steps: int,\n config: Config,\n) -> tuple[np.ndarray, ...]:\n \"\"\"Build one causal sequence block and mark the target rows to score.\"\"\"\n batch_size = len(users)\n padding_item = len(prepared.item_ids)\n input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)\n event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)\n activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)\n state_ids = np.zeros((batch_size, steps), dtype=np.uint32)\n targets = np.zeros((batch_size, steps), dtype=np.uint16)\n weights = np.ones((batch_size, steps), dtype=np.float32)\n scored = np.zeros((batch_size, steps), dtype=bool)\n histories = np.full(\n (batch_size, steps, config.bptt_steps),\n padding_item,\n dtype=np.uint16,\n )\n processed = np.zeros(batch_size, dtype=np.int32)\n\n lengths = prepared.lengths\n for row, user_row in enumerate(users):\n count = min(steps, max(int(process_counts[row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[user_row])\n window_start = int(window_starts[row])\n absolute_start = window_start + start\n positions = slice(\n offset + absolute_start,\n offset + absolute_start + count,\n )\n target_positions = slice(\n offset + absolute_start + 1,\n offset + absolute_start + count + 1,\n )\n input_items[row, :count] = prepared.sequence_items[positions]\n event_features[row, :count] = prepared.event_features[positions]\n activity_features[row, :count] = prepared.activity_features[positions]\n state_ids[row, :count] = prepared.state_ids[positions]\n targets[row, :count] = prepared.sequence_items[target_positions]\n weights[row, :count] = target_weights[target_positions]\n score_from = min(count, max(int(score_starts[row]) - start, 0))\n scored[row, score_from:count] = True\n processed[row] = count\n user_sequence = prepared.sequence_items[\n offset : offset + int(lengths[user_row])\n ]\n histories[row, :count] = history_windows(\n user_sequence,\n absolute_start,\n count,\n config.bptt_steps,\n padding_item,\n )\n return (\n input_items,\n event_features,\n activity_features,\n state_ids,\n targets,\n scored,\n histories,\n processed,\n weights,\n )\n\n\ndef score_target_microbatches(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n sequence_vectors: torch.Tensor,\n flat_states: np.ndarray,\n flat_activity: np.ndarray,\n positive_items: torch.Tensor,\n negatives: torch.Tensor,\n negative_weights: torch.Tensor,\n sample_weights: np.ndarray,\n device: torch.device,\n backward: bool,\n) -> tuple[dict[str, float], torch.Tensor | None]:\n \"\"\"Compute one logical block's exact BCE in bounded-memory slices.\"\"\"\n target_count = len(positive_items)\n total_weight = float(sample_weights.sum())\n if total_weight <= 0:\n raise RuntimeError(\"target block has no positive sample weight\")\n sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None\n statistics = {\n \"loss_sum\": 0.0,\n \"positive_sum\": 0.0,\n \"negative_sum\": 0.0,\n \"pair_correct\": 0.0,\n \"weight_sum\": 0.0,\n }\n for begin in range(0, target_count, config.loss_microbatch_size):\n end = min(begin + config.loss_microbatch_size, target_count)\n selected_states = flat_states[begin:end]\n if backward:\n sequence_input = (\n sequence_vectors[begin:end].detach().requires_grad_(True)\n )\n else:\n sequence_input = sequence_vectors[begin:end]\n liked_vectors, disliked_vectors, _ = pool_explicit_states(\n model, prepared, selected_states, device\n )\n counts = prepared.state_counts[selected_states]\n numeric = np.zeros((end - begin, 6), dtype=np.float32)\n numeric[:, :4] = flat_activity[begin:end]\n numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0\n numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0\n query_vectors = user_queries(\n model,\n sequence_input,\n liked_vectors,\n disliked_vectors,\n torch.from_numpy(numeric).to(device),\n )\n positive_vectors, negative_vectors = candidate_vectors(\n model,\n positive_items[begin:end],\n negatives[begin:end],\n )\n positive_logits = (query_vectors * positive_vectors).sum(dim=1)\n negative_logits = torch.einsum(\n \"bd,bkd->bk\", query_vectors, negative_vectors\n )\n selected_weights = torch.from_numpy(\n sample_weights[begin:end].astype(np.float32, copy=False)\n ).to(device)\n if config.loss_type == \"infonce\":\n all_logits = torch.cat(\n [positive_logits.unsqueeze(1), negative_logits], dim=1\n )\n scaled_logits = all_logits / config.temperature\n target_zeros = torch.zeros(\n len(all_logits), dtype=torch.long, device=device\n )\n row_losses = F.cross_entropy(\n scaled_logits, target_zeros, reduction=\"none\"\n )\n loss_sum = (selected_weights * row_losses).sum()\n else:\n positive_loss = F.softplus(-positive_logits)\n negative_loss = corrected_negative_loss(\n negative_logits, negative_weights[begin:end], config\n )\n loss_sum = (\n selected_weights * (positive_loss + negative_loss) / 2.0\n ).sum()\n if not bool(torch.isfinite(loss_sum)):\n raise RuntimeError(\"dense next-item training produced non-finite loss\")\n if backward:\n (loss_sum / total_weight).backward()\n if sequence_input.grad is None:\n raise RuntimeError(\"sequence microbatch did not produce a gradient\")\n sequence_gradient[begin:end] = sequence_input.grad\n statistics[\"loss_sum\"] += float(loss_sum.detach().cpu())\n statistics[\"positive_sum\"] += float(positive_logits.detach().sum().cpu())\n statistics[\"negative_sum\"] += float(negative_logits.detach().sum().cpu())\n statistics[\"pair_correct\"] += float(\n (positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()\n )\n statistics[\"weight_sum\"] += float(selected_weights.sum().detach().cpu())\n return statistics, sequence_gradient\n\n\ndef release_accelerator_cache(device: torch.device) -> None:\n if device.type == \"mps\":\n torch.mps.empty_cache()\n\n\ndef run_training_epoch(\n model: base.SequentialTwoTower,\n optimizer: torch.optim.Optimizer,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n target_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n generator: torch.Generator,\n device: torch.device,\n epoch: int,\n) -> dict[str, float]:\n model.train()\n train_users = np.flatnonzero(target_counts > 0)\n sorted_users = train_users[\n np.argsort(target_counts[train_users], kind=\"stable\")\n ]\n groups = [\n sorted_users[start : start + config.user_batch_size]\n for start in range(0, len(sorted_users), config.user_batch_size)\n ]\n group_order = torch.randperm(len(groups), generator=generator).numpy()\n negative_count = config.uniform_negatives + config.inbatch_negatives\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n total_positive = 0.0\n total_negative = 0.0\n total_pair_correct = 0.0\n batches = 0\n started = time.monotonic()\n\n for group_number in group_order:\n users = groups[int(group_number)]\n group_counts = target_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_counts.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_counts,\n np.zeros(len(users), dtype=np.int64),\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0).detach()\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n optimizer.zero_grad(set_to_none=True)\n statistics, sequence_gradient = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=True,\n )\n if sequence_gradient is None:\n raise RuntimeError(\"training block omitted its sequence gradient\")\n sequence_vectors.backward(sequence_gradient)\n nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)\n optimizer.step()\n\n count = len(positive_items)\n total_loss += statistics[\"loss_sum\"]\n total_targets += count\n total_weight += statistics[\"weight_sum\"]\n total_positive += statistics[\"positive_sum\"]\n total_negative += statistics[\"negative_sum\"]\n total_pair_correct += statistics[\"pair_correct\"]\n batches += 1\n if batches % 25 == 0:\n release_accelerator_cache(device)\n if batches % 250 == 0:\n batch_bce = statistics[\"loss_sum\"] / max(\n statistics[\"weight_sum\"], 1.0e-12\n )\n running_bce = total_loss / max(total_weight, 1.0e-12)\n log(\n f\"epoch={epoch}/{config.epochs} batches={batches:,} \"\n f\"targets={total_targets:,} \"\n f\"batch_bce={batch_bce:.6f} \"\n f\"running_bce={running_bce:.6f} \"\n f\"elapsed={time.monotonic() - started:.1f}s\"\n )\n\n return {\n \"epoch\": float(epoch),\n \"loss\": total_loss / max(total_weight, 1.0e-12),\n \"positive_logit\": total_positive / max(total_targets, 1),\n \"negative_logit\": total_negative / max(total_targets * negative_count, 1),\n \"pair_accuracy\": total_pair_correct\n / max(total_targets * negative_count, 1),\n \"targets\": float(total_targets),\n \"target_weight_sum\": total_weight,\n \"batches\": float(batches),\n \"seconds\": time.monotonic() - started,\n }\n\n\n@torch.no_grad()\ndef evaluate_validation_bce(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n target_weights: np.ndarray,\n window_starts: np.ndarray,\n training_counts: np.ndarray,\n validation_counts: np.ndarray,\n item_correction: torch.Tensor,\n known_positive_packed: np.ndarray | None,\n device: torch.device,\n) -> dict[str, float]:\n \"\"\"Measure deterministic BCE on each user's chronological target suffix.\"\"\"\n model.eval()\n totals = training_counts + validation_counts\n users_with_validation = np.flatnonzero(validation_counts > 0)\n ordered = users_with_validation[\n np.argsort(totals[users_with_validation], kind=\"stable\")\n ]\n groups = [\n ordered[start : start + config.user_batch_size]\n for start in range(0, len(ordered), config.user_batch_size)\n ]\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 20_000)\n total_loss = 0.0\n total_targets = 0\n total_weight = 0.0\n started = time.monotonic()\n\n for group_number, users in enumerate(groups, start=1):\n group_totals = totals[users]\n group_starts = training_counts[users]\n hidden = torch.zeros(\n 1, len(users), config.embedding_dim, device=device\n )\n max_targets = int(group_totals.max())\n for start in range(0, max_targets, config.bptt_steps):\n steps = min(config.bptt_steps, max_targets - start)\n block = build_dense_block(\n prepared,\n target_weights,\n users,\n window_starts[users],\n group_totals,\n group_starts,\n start,\n steps,\n config,\n )\n sequence_outputs, _ = event_sequence(\n model,\n torch.from_numpy(block[0].astype(np.int64)).to(device),\n torch.from_numpy(block[1].astype(np.float32)).to(device),\n hidden,\n )\n hidden = torch.stack(\n [\n sequence_outputs[row, count - 1]\n if count\n else hidden[0, row]\n for row, count in enumerate(block[7])\n ]\n ).unsqueeze(0)\n flat_scored = block[5].reshape(-1)\n if not np.any(flat_scored):\n continue\n mask = torch.from_numpy(flat_scored).to(device)\n sequence_vectors = sequence_outputs.reshape(\n -1, config.embedding_dim\n )[mask]\n flat_states = block[3].reshape(-1)[flat_scored]\n positive_items = torch.from_numpy(\n block[4].reshape(-1)[flat_scored].astype(np.int64)\n ).to(device)\n known_history = torch.from_numpy(\n block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(\n np.int64\n )\n ).to(device)\n liked_items = torch.from_numpy(\n prepared.liked_states[flat_states].astype(np.int64)\n ).to(device)\n flat_user_rows = np.broadcast_to(\n users[:, None], block[5].shape\n ).reshape(-1)[flat_scored]\n negatives, negative_weights = draw_training_negatives(\n positive_items,\n known_history,\n liked_items,\n flat_user_rows,\n known_positive_packed,\n prepared,\n config,\n item_correction,\n generator,\n device,\n )\n statistics, _ = score_target_microbatches(\n model,\n prepared,\n config,\n sequence_vectors,\n flat_states,\n block[2].reshape(-1, 4)[flat_scored].astype(np.float32),\n positive_items,\n negatives,\n negative_weights,\n block[8].reshape(-1)[flat_scored],\n device,\n backward=False,\n )\n total_loss += statistics[\"loss_sum\"]\n total_targets += len(positive_items)\n total_weight += statistics[\"weight_sum\"]\n if group_number % 25 == 0:\n release_accelerator_cache(device)\n return {\n \"validation_loss\": total_loss / max(total_weight, 1.0e-12),\n \"validation_targets\": float(total_targets),\n \"validation_target_weight_sum\": total_weight,\n \"validation_seconds\": time.monotonic() - started,\n }\n\n\ndef snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:\n return {\n name: value.detach().cpu().clone()\n for name, value in model.state_dict().items()\n }\n\n\ndef save_epoch_checkpoint(\n checkpoint_dir: Path,\n epoch: int,\n model_state: dict[str, torch.Tensor],\n config: Config,\n diagnostics: dict[str, float],\n optimizer: torch.optim.Optimizer,\n generator: torch.Generator,\n) -> Path:\n checkpoint_dir.mkdir(parents=True, exist_ok=True)\n path = checkpoint_dir / f\"epoch-{epoch:02d}.pt\"\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": model_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n path,\n )\n log(f\"saved epoch checkpoint: {path}\")\n return path\n\n\ndef train_model(\n public: Path,\n stage: str,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n checkpoint_dir: Path | None,\n resume_checkpoint: Path | None,\n) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:\n partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n training_counts = partition.training_counts\n validation_counts = partition.validation_counts\n log(\n f\"chronological BCE window: train={int(training_counts.sum()):,} \"\n f\"validation={int(validation_counts.sum()):,} \"\n f\"selected={partition.selected_count:,} \"\n f\"discarded_old_targets={int(partition.window_starts.sum()):,} \"\n f\"all={prepared.target_count:,}\"\n )\n model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(\n device\n )\n optimizer = torch.optim.AdamW(\n model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay\n )\n generator = torch.Generator(device=\"cpu\").manual_seed(config.seed + 10_000)\n item_correction = build_item_correction(\n prepared,\n config,\n partition.window_starts,\n training_counts,\n )\n target_weights = build_target_weights(\n public,\n stage,\n prepared,\n partition.history_training_counts,\n config,\n )\n known_positive_packed = (\n build_known_positive_filter(prepared, partition.history_training_counts)\n if config.negative_filter_scope == \"full-training-history\"\n else None\n )\n history: list[dict[str, float]] = []\n best_loss = float(\"inf\")\n best_epoch = 0\n best_state: dict[str, torch.Tensor] | None = None\n epochs_without_improvement = 0\n start_epoch = 0\n\n if resume_checkpoint is not None:\n payload = torch.load(\n resume_checkpoint, map_location=device, weights_only=False\n )\n stored_config = payload.get(\"config\", {})\n architecture_fields = (\n \"bptt_steps\",\n \"embedding_dim\",\n \"hidden_dim\",\n \"user_hidden_1\",\n \"user_hidden_2\",\n \"item_hidden_1\",\n \"item_hidden_2\",\n )\n mismatches = {\n name: (stored_config.get(name), getattr(config, name))\n for name in architecture_fields\n if stored_config.get(name) != getattr(config, name)\n }\n if mismatches:\n raise RuntimeError(\n f\"resume checkpoint architecture differs: {mismatches}\"\n )\n stored_filter_scope = stored_config.get(\n \"negative_filter_scope\", \"last-100\"\n )\n stored_target_weighting = stored_config.get(\n \"target_weighting\", \"uniform\"\n )\n stored_weight_values = (\n stored_config.get(\"ordinary_target_weight\", 1.0),\n stored_config.get(\"organic_strong_target_weight\", 1.0),\n stored_config.get(\"organic_like_target_weight\", 3.0),\n stored_config.get(\"discovery_horizon_days\", 7),\n )\n current_weight_values = (\n config.ordinary_target_weight,\n config.organic_strong_target_weight,\n config.organic_like_target_weight,\n config.discovery_horizon_days,\n )\n stored_window_values = (\n stored_config.get(\"validation_fraction\", 0.10),\n stored_config.get(\"max_train_targets_per_user\", 0),\n stored_config.get(\"max_validation_targets_per_user\", 0),\n )\n current_window_values = (\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n objective_changed = (\n stored_filter_scope != config.negative_filter_scope\n or stored_target_weighting != config.target_weighting\n or stored_weight_values != current_weight_values\n or stored_window_values != current_window_values\n )\n model.load_state_dict(payload[\"model_state\"])\n if \"optimizer_state\" in payload and not objective_changed:\n optimizer.load_state_dict(payload[\"optimizer_state\"])\n for group in optimizer.param_groups:\n group[\"lr\"] = config.learning_rate\n group[\"weight_decay\"] = config.weight_decay\n log(f\"restored optimizer state from {resume_checkpoint}\")\n else:\n log(\n f\"using a fresh AdamW optimizer after loading {resume_checkpoint}\"\n )\n if \"generator_state\" in payload and not objective_changed:\n generator.set_state(payload[\"generator_state\"])\n start_epoch = int(payload[\"epoch\"])\n if start_epoch >= config.epochs:\n raise RuntimeError(\n f\"resume epoch {start_epoch} must be below --epochs {config.epochs}\"\n )\n prior = {\n str(name): float(value)\n for name, value in payload.get(\"diagnostics\", {}).items()\n }\n if objective_changed:\n prior.pop(\"validation_loss\", None)\n log(\n \"BCE objective changed: filter \"\n f\"{stored_filter_scope}->{config.negative_filter_scope}, \"\n \"target weighting \"\n f\"{stored_target_weighting}->{config.target_weighting}, \"\n f\"target window {stored_window_values}->{current_window_values}; \"\n \"recomputing the resume checkpoint's validation BCE\"\n )\n if \"validation_loss\" not in prior:\n prior.update(\n evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n )\n history.append(prior)\n best_loss = float(prior[\"validation_loss\"])\n best_epoch = start_epoch\n best_state = snapshot_model(model)\n log(\n f\"resumed validation-BCE training: epoch={start_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n\n for epoch in range(start_epoch + 1, config.epochs + 1):\n diagnostics = run_training_epoch(\n model,\n optimizer,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n item_correction,\n known_positive_packed,\n generator,\n device,\n epoch,\n )\n validation = evaluate_validation_bce(\n model,\n prepared,\n config,\n target_weights,\n partition.window_starts,\n training_counts,\n validation_counts,\n item_correction,\n known_positive_packed,\n device,\n )\n diagnostics.update(validation)\n history.append(diagnostics)\n current_state = snapshot_model(model)\n if checkpoint_dir is not None:\n save_epoch_checkpoint(\n checkpoint_dir,\n epoch,\n current_state,\n config,\n diagnostics,\n optimizer,\n generator,\n )\n improved = (\n diagnostics[\"validation_loss\"]\n < best_loss - config.early_stopping_min_delta\n )\n if improved:\n best_loss = diagnostics[\"validation_loss\"]\n best_epoch = epoch\n best_state = current_state\n epochs_without_improvement = 0\n if checkpoint_dir is not None:\n torch.save(\n {\n \"epoch\": epoch,\n \"config\": asdict(config),\n \"diagnostics\": diagnostics,\n \"model_state\": current_state,\n \"optimizer_state\": optimizer.state_dict(),\n \"generator_state\": generator.get_state(),\n },\n checkpoint_dir / \"best.pt\",\n )\n else:\n epochs_without_improvement += 1\n log(\n f\"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} \"\n f\"validation_loss={diagnostics['validation_loss']:.5f} \"\n f\"pair_accuracy={diagnostics['pair_accuracy']:.3f} \"\n f\"train_targets={int(diagnostics['targets']):,} \"\n f\"validation_targets={int(diagnostics['validation_targets']):,} \"\n f\"train_seconds={diagnostics['seconds']:.1f} \"\n f\"validation_seconds={diagnostics['validation_seconds']:.1f}\"\n )\n release_accelerator_cache(device)\n if epochs_without_improvement >= config.early_stopping_patience:\n log(\n f\"early stopping after epoch={epoch}; \"\n f\"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}\"\n )\n break\n\n if best_state is None:\n raise RuntimeError(\"training did not produce a valid checkpoint\")\n model.load_state_dict(best_state)\n model.to(device).eval()\n log(\n f\"restored best validation-BCE checkpoint: epoch={best_epoch} \"\n f\"loss={best_loss:.6f}\"\n )\n return model, history\n\n\n@torch.inference_mode()\ndef inference_queries(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n config: Config,\n device: torch.device,\n) -> torch.Tensor:\n sequence_rows = prepared.inference_user_rows\n lengths = np.where(\n sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0\n )\n ordered = np.argsort(lengths, kind=\"stable\")\n result = torch.zeros(\n len(sequence_rows), config.embedding_dim, dtype=torch.float32\n )\n for group_start in range(0, len(ordered), config.user_batch_size):\n output_rows = ordered[group_start : group_start + config.user_batch_size]\n rows = sequence_rows[output_rows]\n group_lengths = lengths[output_rows]\n hidden = torch.zeros(\n 1, len(output_rows), config.embedding_dim, device=device\n )\n for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):\n steps = min(\n config.bptt_steps,\n int(group_lengths.max(initial=0)) - start,\n )\n items = np.full(\n (len(output_rows), steps),\n len(prepared.item_ids),\n dtype=np.uint16,\n )\n features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)\n counts = np.zeros(len(output_rows), dtype=np.int32)\n for local_row, sequence_row in enumerate(rows):\n if sequence_row < 0:\n continue\n count = min(steps, max(int(group_lengths[local_row]) - start, 0))\n if not count:\n continue\n offset = int(prepared.offsets[sequence_row])\n selected = slice(offset + start, offset + start + count)\n items[local_row, :count] = prepared.sequence_items[selected]\n features[local_row, :count] = prepared.event_features[selected]\n counts[local_row] = count\n outputs, _ = event_sequence(\n model,\n torch.from_numpy(items.astype(np.int64)).to(device),\n torch.from_numpy(features.astype(np.float32)).to(device),\n hidden,\n )\n next_rows: list[torch.Tensor] = []\n for local_row, count in enumerate(counts):\n next_rows.append(\n outputs[local_row, count - 1]\n if count\n else hidden[0, local_row]\n )\n hidden = torch.stack(next_rows).unsqueeze(0)\n\n liked_items = torch.from_numpy(\n prepared.inference_liked_items[output_rows].astype(np.int64)\n ).to(device)\n disliked_items = torch.from_numpy(\n prepared.inference_disliked_items[output_rows].astype(np.int64)\n ).to(device)\n queries = user_queries(\n model,\n hidden.squeeze(0),\n model._mean_context_channel(liked_items),\n model._mean_context_channel(disliked_items),\n torch.from_numpy(\n prepared.inference_user_features[output_rows].astype(np.float32)\n ).to(device),\n )\n result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()\n return result\n\n\n@torch.inference_mode()\ndef rank_candidates(\n model: base.SequentialTwoTower,\n prepared: SequenceData,\n eligibility: CandidateSet,\n config: Config,\n device: torch.device,\n ranking_batch_size: int,\n) -> tuple[pd.DataFrame, dict[str, float]]:\n model.eval()\n queries = inference_queries(model, prepared, config, device)\n item_parts: list[torch.Tensor] = []\n for start in range(0, len(prepared.item_ids), 2_048):\n rows = torch.arange(\n start,\n min(start + 2_048, len(prepared.item_ids)),\n dtype=torch.long,\n device=device,\n )\n item_parts.append(model.encode_items(rows).cpu())\n items = torch.cat(item_parts)\n rows: list[tuple[int, int, int]] = []\n for start in range(0, len(eligibility.uids), ranking_batch_size):\n end = min(start + ranking_batch_size, len(eligibility.uids))\n scores = queries[start:end] @ items.T\n eligible = np.unpackbits(\n eligibility.packed[start:end],\n axis=1,\n count=len(prepared.item_ids),\n bitorder=\"little\",\n ).astype(bool, copy=False)\n scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)\n selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()\n for local_row, columns in enumerate(selected):\n uid = int(eligibility.uids[start + local_row])\n rows.extend(\n (uid, int(prepared.item_ids[column]), rank)\n for rank, column in enumerate(columns, start=1)\n )\n if end == len(eligibility.uids) or end % 1_024 == 0:\n log(f\"ranked users={end:,}/{len(eligibility.uids):,}\")\n query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()\n item_norm = torch.linalg.vector_norm(items, dim=1).numpy()\n diagnostics = {\n \"query_norm_mean\": float(query_norm.mean()),\n \"query_norm_std\": float(query_norm.std()),\n \"item_norm_mean\": float(item_norm.mean()),\n \"item_norm_std\": float(item_norm.std()),\n }\n return pd.DataFrame(rows, columns=[\"uid\", \"item_id\", \"rank\"]), diagnostics\n\n\ndef write_ranking(frame: pd.DataFrame, output: Path) -> None:\n output.parent.mkdir(parents=True, exist_ok=True)\n if output.suffix == \".parquet\":\n frame.to_parquet(output, index=False, compression=\"zstd\")\n elif output.suffix == \".csv\":\n frame.to_csv(output, index=False)\n else:\n raise ValueError(\"--output must end in .parquet or .csv\")\n\n\ndef main() -> int:\n parser = argparse.ArgumentParser(description=__doc__)\n parser.add_argument(\n \"--stage\", choices=(\"validation\", \"submission\"), default=\"validation\"\n )\n parser.add_argument(\"--output\", type=Path, required=True)\n parser.add_argument(\"--public-dir\", type=Path, required=True)\n parser.add_argument(\"--prepared-cache\", type=Path)\n parser.add_argument(\"--device\", choices=(\"cpu\", \"mps\"), default=\"cpu\")\n parser.add_argument(\"--threads\", type=int, default=8)\n parser.add_argument(\"--bptt-steps\", type=int, default=Config.bptt_steps)\n parser.add_argument(\n \"--user-batch-size\", type=int, default=Config.user_batch_size\n )\n parser.add_argument(\"--epochs\", type=int, default=Config.epochs)\n parser.add_argument(\"--learning-rate\", type=float, default=Config.learning_rate)\n parser.add_argument(\n \"--loss-microbatch-size\",\n type=int,\n default=Config.loss_microbatch_size,\n )\n parser.add_argument(\n \"--negative-filter-scope\",\n choices=(\"full-training-history\", \"last-100\"),\n default=Config.negative_filter_scope,\n )\n parser.add_argument(\n \"--target-weighting\",\n choices=(\"discovery-graded\", \"organic-strong\", \"uniform\"),\n default=Config.target_weighting,\n )\n parser.add_argument(\n \"--ordinary-target-weight\",\n type=float,\n default=Config.ordinary_target_weight,\n )\n parser.add_argument(\n \"--organic-strong-target-weight\",\n type=float,\n default=Config.organic_strong_target_weight,\n )\n parser.add_argument(\n \"--organic-like-target-weight\",\n type=float,\n default=Config.organic_like_target_weight,\n )\n parser.add_argument(\n \"--discovery-horizon-days\",\n type=int,\n default=Config.discovery_horizon_days,\n )\n parser.add_argument(\n \"--validation-fraction\",\n type=float,\n default=Config.validation_fraction,\n )\n parser.add_argument(\n \"--max-train-targets-per-user\",\n type=int,\n default=Config.max_train_targets_per_user,\n help=\"retain this many recent pre-validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--max-validation-targets-per-user\",\n type=int,\n default=Config.max_validation_targets_per_user,\n help=\"retain this many final validation targets per user; 0 is uncapped\",\n )\n parser.add_argument(\n \"--early-stopping-patience\",\n type=int,\n default=Config.early_stopping_patience,\n )\n parser.add_argument(\n \"--early-stopping-min-delta\",\n type=float,\n default=Config.early_stopping_min_delta,\n )\n parser.add_argument(\"--checkpoint-dir\", type=Path)\n parser.add_argument(\"--resume-checkpoint\", type=Path)\n parser.add_argument(\"--seed\", type=int, default=Config.seed)\n parser.add_argument(\"--ranking-batch-size\", type=int, default=64)\n parser.add_argument(\"--prepare-only\", action=\"store_true\")\n parser.add_argument(\n \"--uniform-negatives\",\n type=int,\n default=Config.uniform_negatives,\n )\n parser.add_argument(\n \"--inbatch-negatives\",\n type=int,\n default=Config.inbatch_negatives,\n )\n parser.add_argument(\n \"--loss-type\",\n choices=(\"infonce\", \"bce\"),\n default=Config.loss_type,\n )\n parser.add_argument(\n \"--temperature\",\n type=float,\n default=Config.temperature,\n )\n parser.add_argument(\n \"--inbatch-correction-power\",\n type=float,\n default=Config.inbatch_correction_power,\n )\n args = parser.parse_args()\n\n if args.threads < 1 or args.bptt_steps < 2 or args.user_batch_size < 1:\n parser.error(\"threads, BPTT steps, and user batch size must be positive\")\n if (\n args.epochs < 1\n or args.learning_rate <= 0\n or args.loss_microbatch_size < 1\n or args.early_stopping_patience < 1\n or args.early_stopping_min_delta < 0\n or args.ordinary_target_weight <= 0\n or args.organic_strong_target_weight <= 0\n or args.organic_like_target_weight <= 0\n or args.discovery_horizon_days < 1\n or args.max_train_targets_per_user < 0\n or args.max_validation_targets_per_user < 0\n or args.temperature <= 0\n or args.uniform_negatives < 0\n or args.inbatch_negatives < 0\n ):\n parser.error(\"training counts, learning rate, temperature, and patience are invalid\")\n if args.uniform_negatives + args.inbatch_negatives < 1:\n parser.error(\"must have at least one negative sample\")\n if not 0.0 < args.validation_fraction < 1.0:\n parser.error(\"validation fraction must be strictly between zero and one\")\n public = args.public_dir.resolve()\n if not (public / \"data\" / \"candidate_catalog.parquet\").is_file():\n parser.error(f\"public task data not found under {public}\")\n config = Config(\n bptt_steps=args.bptt_steps,\n user_batch_size=args.user_batch_size,\n epochs=args.epochs,\n learning_rate=args.learning_rate,\n loss_microbatch_size=args.loss_microbatch_size,\n uniform_negatives=args.uniform_negatives,\n inbatch_negatives=args.inbatch_negatives,\n inbatch_correction_power=args.inbatch_correction_power,\n negative_filter_scope=args.negative_filter_scope,\n target_weighting=args.target_weighting,\n ordinary_target_weight=args.ordinary_target_weight,\n organic_strong_target_weight=args.organic_strong_target_weight,\n organic_like_target_weight=args.organic_like_target_weight,\n discovery_horizon_days=args.discovery_horizon_days,\n validation_fraction=args.validation_fraction,\n max_train_targets_per_user=args.max_train_targets_per_user,\n max_validation_targets_per_user=args.max_validation_targets_per_user,\n early_stopping_patience=args.early_stopping_patience,\n early_stopping_min_delta=args.early_stopping_min_delta,\n loss_type=args.loss_type,\n temperature=args.temperature,\n seed=args.seed,\n )\n torch.set_num_threads(args.threads)\n torch.set_num_interop_threads(1)\n seed_everything(config.seed)\n device = torch.device(args.device)\n if device.type == \"mps\" and not torch.backends.mps.is_available():\n parser.error(\"MPS was requested but is unavailable\")\n\n started = time.monotonic()\n prepared, eligibility = load_or_prepare(\n public,\n args.stage,\n config,\n args.prepared_cache.resolve() if args.prepared_cache else None,\n )\n target_partition = chronological_target_partition(\n prepared,\n config.validation_fraction,\n config.max_train_targets_per_user,\n config.max_validation_targets_per_user,\n )\n if args.prepare_only:\n print(\n json.dumps(\n {\n \"stage\": args.stage,\n \"sequence_users\": len(prepared.user_ids),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(\n target_partition.window_starts.sum()\n ),\n \"target_users\": len(eligibility.uids),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"config\": asdict(config),\n },\n indent=2,\n )\n )\n return 0\n\n model, training_history = train_model(\n public,\n args.stage,\n prepared,\n config,\n device,\n args.checkpoint_dir.resolve() if args.checkpoint_dir else None,\n args.resume_checkpoint.resolve() if args.resume_checkpoint else None,\n )\n ranking, embedding_diagnostics = rank_candidates(\n model,\n prepared,\n eligibility,\n config,\n device,\n args.ranking_batch_size,\n )\n write_ranking(ranking, args.output.resolve())\n print(\n json.dumps(\n {\n \"baseline\": \"yambda-windowed-sequence-two-tower-base\",\n \"stage\": args.stage,\n \"output\": str(args.output.resolve()),\n \"rows\": len(ranking),\n \"users\": int(ranking.uid.nunique()),\n \"runtime_seconds\": round(time.monotonic() - started, 3),\n \"public_inputs_only\": True,\n \"architecture\": {\n \"family\": \"pure-windowed-sequence-two-tower\",\n \"sequence_training\": (\n \"every-adjacent-target-within-recent-chronological-window\"\n ),\n \"sequence_encoder\": \"one-layer-GRU-dense-timestep-loss\",\n \"bptt_hidden_state\": \"carried-and-detached\",\n \"model_selection\": \"chronological-validation-BCE-early-stopping\",\n \"loss_execution\": \"gradient-accumulated-microbatches\",\n \"user_id_embedding\": False,\n \"user_mlp\": \"582-512-256-192\",\n \"item_mlp\": \"196-512-256-192\",\n \"normalization\": \"none\",\n \"score\": \"raw-dot-product\",\n \"objective\": \"sample-weighted-BCE-at-every-timestep\",\n \"negative_sampling\": (\n \"24-uniform-plus-8-propensity-corrected-inbatch\"\n ),\n \"false_negative_filter\": config.negative_filter_scope,\n \"target_weighting\": config.target_weighting,\n },\n \"config\": asdict(config),\n \"sequence_tokens\": len(prepared.sequence_items),\n \"all_next_item_targets\": prepared.target_count,\n \"selected_training_targets\": int(\n target_partition.training_counts.sum()\n ),\n \"selected_validation_targets\": int(\n target_partition.validation_counts.sum()\n ),\n \"discarded_old_targets\": int(target_partition.window_starts.sum()),\n \"training_history\": training_history,\n \"embedding_diagnostics\": embedding_diagnostics,\n \"torch_version\": torch.__version__,\n \"device\": str(device),\n },\n indent=2,\n )\n )\n return 0\n\n\nif __name__ == \"__main__\":\n raise SystemExit(main())\n",
"diffStat": {
"model_added_lines": 4,
"model_removed_lines": 4,
"model_added_chars": 128,
"model_removed_chars": 133,
"user_added_lines": 0,
"user_removed_lines": 0,
"user_added_chars": 0,
"user_removed_chars": 0
},
"isNewFile": false,
"isBuildFile": false
},
"description": "solution/train_current_model.py: uniform_negatives: int = 1... => uniform_negatives: int = 4...",
"displayName": "Edit",
"renderOutputAsMarkdown": true
},
"result": {
"timestamp": "2026-09-29T03:02:20.001Z",
"content": "Successfully modified file: /app/solution/train_current_model.py (1 replacements). Here is the updated code:\n...\n epochs: int = 1\n learning_rate: float = 1.0e-3\n weight_decay: float = 1.0e-5\n gradient_clip: float = 2.0\n loss_microbatch_size: int = 65_536\n uniform_negatives: int = 48\n inbatch_negatives: int = 8\n inbatch_correction_power: float = 0.5\n inbatch_correction_min: float = 0.25\n inbatch_correction_max: float = 4.0\n negative_filter_scope: str = \"full-training-history\"\n target_weighting: str = \"discovery-graded\"\n ordinary_target_weight: float = 0.25\n...\n validation_fraction: float = 0.10\n max_train_targets_per_user: int = 128\n max_validation_targets_per_user: int = 16\n early_stopping_patience: int = 1\n early_stopping_min_delta: float = 1.0e-4\n loss_type: str = \"bce\"\n temperature: float = 0.10\n seed: int = 29\n\n\n@dataclass(frozen=True)\n...",
"isError": false
},
"responseMessageId": "759d8c1b-55ef-467b-a63b-c098f738bd9a"
}
]
},
{
"id": 95,
"role": "agent",
"timestamp": "2026-09-29T03:02:31.703Z",
"blocks": [
{
"kind": "reasoning",
"representation": "summary",
"timestamp": "2026-09-29T03:02:31.703Z",
"text": "Verifying argparse defaults\n\nI'm currently reviewing the `argparse` configurations within the `main()` function. My focus is on confirming that the default values assigned to `--uniform-negatives` and `--inbatch-negatives` correctly align with the `Config.uniform_negatives` and `Config.inbatch_negatives` settings, which are currently established at 48 and 8 respectively."
},
{
"kind": "message",
"timestamp": "2026-09-29T03:02:31.703Z",
"text": "In `train_current_model.py`, I set the verified optimal hyperparameters as the default `Config` values (`uniform_negatives=48`, `inbatch_negatives=8`, `target_weighting=discovery-graded`, `inbatch_correction_power=0.5`, `loss_type=bce`).\n\nNext, I will verify that running with defaults reproduces the improved backtest score."
}
]
}
],
"source": {
"format": "gemini-cli-session",
"sha256": "9de057512c2c3e0d6a1764b856163e224d6cc7d9fc1e369ade776b397d9e5e3f",
"records": 466,
"sessionMetadata": {
"sessionId": "0aad8420-cbfb-4325-b1b4-2d368ce6c0fc",
"projectHash": "f53b52ad6d21cceb72dfa78fb67614fe14f110c58e68412b01508d6a485501c3",
"startTime": "2026-09-29T02:04:46.546Z",
"lastUpdated": "2026-09-29T02:04:46.546Z",
"kind": "main"
},
"sessionUpdates": 187,
"usageRecords": [
{
"messageId": "a7c20ed4-2aa3-4c27-a466-36a804367707",
"timestamp": "2026-09-29T02:04:50.875Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 10359,
"output": 116,
"cached": 7650,
"thoughts": 302,
"tool": 0,
"total": 10777
}
},
{
"messageId": "d49b25af-bdc9-4544-b8bd-55add5afd3ac",
"timestamp": "2026-09-29T02:04:52.573Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 10872,
"output": 42,
"cached": 7654,
"thoughts": 17,
"tool": 0,
"total": 10931
}
},
{
"messageId": "a706e2e8-954e-416c-ae67-e840d930aa19",
"timestamp": "2026-09-29T02:04:55.189Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 11011,
"output": 33,
"cached": 7635,
"thoughts": 134,
"tool": 0,
"total": 11178
}
},
{
"messageId": "89be7542-b007-4f3c-8c86-ab0fecd8043c",
"timestamp": "2026-09-29T02:04:56.985Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 11441,
"output": 38,
"cached": 7638,
"thoughts": 51,
"tool": 0,
"total": 11530
}
},
{
"messageId": "ef137834-fc98-41a2-93e1-e6c3aee1ec77",
"timestamp": "2026-09-29T02:05:05.559Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 11570,
"output": 53,
"cached": 7628,
"thoughts": 208,
"tool": 0,
"total": 11831
}
},
{
"messageId": "3928dbbc-c88f-4046-8510-1ad5e959e8c3",
"timestamp": "2026-09-29T02:05:26.198Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 12524,
"output": 85,
"cached": 7653,
"thoughts": 189,
"tool": 0,
"total": 12798
}
},
{
"messageId": "babfe920-66a8-4def-b952-7028fee4c930",
"timestamp": "2026-09-29T02:05:28.620Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 12827,
"output": 43,
"cached": 7650,
"thoughts": 76,
"tool": 0,
"total": 12946
}
},
{
"messageId": "2da7dfd0-c0ed-44f3-a477-111acecd5f9c",
"timestamp": "2026-09-29T02:05:31.126Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 13381,
"output": 43,
"cached": 7658,
"thoughts": 18,
"tool": 0,
"total": 13442
}
},
{
"messageId": "7ce9e4ec-e3f7-400f-8ba3-65f0a63a2948",
"timestamp": "2026-09-29T02:05:37.722Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 13495,
"output": 43,
"cached": 11472,
"thoughts": 18,
"tool": 0,
"total": 13556
}
},
{
"messageId": "6fe0845c-67d2-4ded-9e03-b9967c1cf376",
"timestamp": "2026-09-29T02:05:40.665Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 13605,
"output": 54,
"cached": 11458,
"thoughts": 222,
"tool": 0,
"total": 13881
}
},
{
"messageId": "afa5ada1-7f12-4350-9c36-bd6d129f8090",
"timestamp": "2026-09-29T02:05:42.587Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 13948,
"output": 43,
"cached": 11457,
"thoughts": 58,
"tool": 0,
"total": 14049
}
},
{
"messageId": "c226755e-e91d-4142-8a0d-d98544232195",
"timestamp": "2026-09-29T02:05:44.225Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 15712,
"output": 45,
"cached": 11527,
"thoughts": 23,
"tool": 0,
"total": 15780
}
},
{
"messageId": "ec7556c8-5dc8-472a-b85f-292381c0a466",
"timestamp": "2026-09-29T02:05:45.775Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 17724,
"output": 45,
"cached": 15456,
"thoughts": 23,
"tool": 0,
"total": 17792
}
},
{
"messageId": "70ea968a-cebc-453b-891e-edd3391078ab",
"timestamp": "2026-09-29T02:05:47.852Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 19320,
"output": 31,
"cached": 15509,
"thoughts": 65,
"tool": 0,
"total": 19416
}
},
{
"messageId": "85c310a8-0fab-4f51-8029-a82a8f1da2f6",
"timestamp": "2026-09-29T02:05:52.165Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 20306,
"output": 75,
"cached": 15531,
"thoughts": 440,
"tool": 0,
"total": 20821
}
},
{
"messageId": "6878e022-677e-474d-abe4-bf8a44ba23fa",
"timestamp": "2026-09-29T02:12:16.408Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 23049,
"output": 46,
"cached": 7805,
"thoughts": 41,
"tool": 0,
"total": 23136
}
},
{
"messageId": "19f2d311-d3e8-40eb-a1b4-2808fda2071a",
"timestamp": "2026-09-29T02:12:25.371Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 23222,
"output": 45,
"cached": 19500,
"thoughts": 661,
"tool": 0,
"total": 23928
}
},
{
"messageId": "c7ed7da7-648c-4421-b90a-e977d375f789",
"timestamp": "2026-09-29T02:12:29.441Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 24800,
"output": 45,
"cached": 19540,
"thoughts": 334,
"tool": 0,
"total": 25179
}
},
{
"messageId": "13496b7f-6adf-4163-b225-10f58c3eaaa8",
"timestamp": "2026-09-29T02:12:34.621Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 26708,
"output": 45,
"cached": 23503,
"thoughts": 342,
"tool": 0,
"total": 27095
}
},
{
"messageId": "df9d17bc-b2b9-4a9b-899f-bd721015403b",
"timestamp": "2026-09-29T02:12:36.361Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 28604,
"output": 46,
"cached": 23550,
"thoughts": 26,
"tool": 0,
"total": 28676
}
},
{
"messageId": "2bb5ec60-dea6-4a12-9d5f-0252730c32d9",
"timestamp": "2026-09-29T02:12:40.454Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 30859,
"output": 47,
"cached": 0,
"thoughts": 26,
"tool": 0,
"total": 30932
}
},
{
"messageId": "7ab117a6-4fe7-4278-8945-6f9cc474b108",
"timestamp": "2026-09-29T02:12:42.254Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 33104,
"output": 43,
"cached": 27590,
"thoughts": 27,
"tool": 0,
"total": 33174
}
},
{
"messageId": "d62c66e7-29c7-4ec4-aaf0-d4b225d9cd80",
"timestamp": "2026-09-29T02:12:44.286Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 33752,
"output": 47,
"cached": 31532,
"thoughts": 53,
"tool": 0,
"total": 33852
}
},
{
"messageId": "7183f901-f65e-41fe-996b-91b9db3113bf",
"timestamp": "2026-09-29T02:12:46.098Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 35490,
"output": 47,
"cached": 31568,
"thoughts": 23,
"tool": 0,
"total": 35560
}
},
{
"messageId": "8e285c80-8bcd-4cf2-ab77-5de255cf7ca1",
"timestamp": "2026-09-29T02:12:48.167Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 36753,
"output": 45,
"cached": 31586,
"thoughts": 70,
"tool": 0,
"total": 36868
}
},
{
"messageId": "becc4f08-3059-418c-8b20-3f583d8b0a31",
"timestamp": "2026-09-29T02:12:51.556Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 37601,
"output": 45,
"cached": 35539,
"thoughts": 270,
"tool": 0,
"total": 37916
}
},
{
"messageId": "869eb9f7-ead5-4042-b39d-795837568068",
"timestamp": "2026-09-29T02:12:53.874Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 39595,
"output": 81,
"cached": 35581,
"thoughts": 80,
"tool": 0,
"total": 39756
}
},
{
"messageId": "443d899e-9953-464c-b58f-368f226979d4",
"timestamp": "2026-09-29T02:12:59.921Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 40207,
"output": 92,
"cached": 35578,
"thoughts": 35,
"tool": 0,
"total": 40334
}
},
{
"messageId": "08878d10-1ab5-4604-a298-516ec84a3250",
"timestamp": "2026-09-29T02:13:59.362Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 41366,
"output": 102,
"cached": 35591,
"thoughts": 64,
"tool": 0,
"total": 41532
}
},
{
"messageId": "93c9d788-6b63-4f9a-8217-bbc514adc3ab",
"timestamp": "2026-09-29T02:14:07.305Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 41613,
"output": 42,
"cached": 39526,
"thoughts": 133,
"tool": 0,
"total": 41788
}
},
{
"messageId": "79160266-434e-4613-b3a5-ea4b402454b7",
"timestamp": "2026-09-29T02:14:09.488Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 42528,
"output": 44,
"cached": 39533,
"thoughts": 23,
"tool": 0,
"total": 42595
}
},
{
"messageId": "7bef1775-6c92-4683-8a78-10709b4bae27",
"timestamp": "2026-09-29T02:14:11.980Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 43430,
"output": 47,
"cached": 39538,
"thoughts": 46,
"tool": 0,
"total": 43523
}
},
{
"messageId": "a4c3d1b4-c1a0-42f7-9de3-61d0e98101d1",
"timestamp": "2026-09-29T02:14:38.124Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 45289,
"output": 45,
"cached": 39573,
"thoughts": 3929,
"tool": 0,
"total": 49263
}
},
{
"messageId": "1f272eb2-b74a-477b-927d-1423ce95d70b",
"timestamp": "2026-09-29T02:14:50.187Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 50213,
"output": 33,
"cached": 43653,
"thoughts": 1564,
"tool": 0,
"total": 51810
}
},
{
"messageId": "f7edc6ea-19a9-4e63-ba16-c3676064128a",
"timestamp": "2026-09-29T02:15:03.701Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 52854,
"output": 47,
"cached": 47673,
"thoughts": 212,
"tool": 0,
"total": 53113
}
},
{
"messageId": "b166e978-2608-4f93-bd6b-1ef810ce79bf",
"timestamp": "2026-09-29T02:15:07.619Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 54332,
"output": 47,
"cached": 51664,
"thoughts": 33,
"tool": 0,
"total": 54412
}
},
{
"messageId": "36be4cc5-72f7-4810-92c6-78bb08d2d18c",
"timestamp": "2026-09-29T02:15:09.481Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 56268,
"output": 47,
"cached": 51694,
"thoughts": 27,
"tool": 0,
"total": 56342
}
},
{
"messageId": "ea469e29-92ff-461f-8b37-78394484b77e",
"timestamp": "2026-09-29T02:15:24.815Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 57120,
"output": 165,
"cached": 51694,
"thoughts": 2031,
"tool": 0,
"total": 59316
}
},
{
"messageId": "7bb6d185-3108-4bcc-b72c-b2ea9741e8ad",
"timestamp": "2026-09-29T02:15:28.477Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 59371,
"output": 247,
"cached": 55708,
"thoughts": 91,
"tool": 0,
"total": 59709
}
},
{
"messageId": "8dfec748-d268-4ab2-9827-02b95df25717",
"timestamp": "2026-09-29T02:15:42.950Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 59775,
"output": 251,
"cached": 55695,
"thoughts": 18,
"tool": 0,
"total": 60044
}
},
{
"messageId": "e97b3cee-47a3-42e2-a369-8e9343c5d664",
"timestamp": "2026-09-29T02:15:48.185Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 60149,
"output": 172,
"cached": 55682,
"thoughts": 85,
"tool": 0,
"total": 60406
}
},
{
"messageId": "9faa9027-e11f-43da-8b6b-f9255aaa94a5",
"timestamp": "2026-09-29T02:15:53.659Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 60692,
"output": 177,
"cached": 55673,
"thoughts": 153,
"tool": 0,
"total": 61022
}
},
{
"messageId": "090bc5e0-5cfe-4695-9b08-9d913fb9876f",
"timestamp": "2026-09-29T02:15:58.322Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 61268,
"output": 254,
"cached": 55665,
"thoughts": 66,
"tool": 0,
"total": 61588
}
},
{
"messageId": "51d70ae7-a162-44b4-a6d7-0d207fbb7be2",
"timestamp": "2026-09-29T02:16:42.530Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 61775,
"output": 28,
"cached": 59631,
"thoughts": 6046,
"tool": 0,
"total": 67849
}
},
{
"messageId": "b1b925cc-bc83-449f-a019-07a852da5029",
"timestamp": "2026-09-29T02:16:48.935Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 68698,
"output": 193,
"cached": 59787,
"thoughts": 147,
"tool": 0,
"total": 69038
}
},
{
"messageId": "c974bffe-ee65-43f1-8eb1-683a1e038809",
"timestamp": "2026-09-29T02:17:31.538Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 69218,
"output": 230,
"cached": 63762,
"thoughts": 5976,
"tool": 0,
"total": 75424
}
},
{
"messageId": "e3938739-2c39-4bef-b38e-45ac57b04d1f",
"timestamp": "2026-09-29T02:17:37.233Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 75552,
"output": 68,
"cached": 67879,
"thoughts": 20,
"tool": 0,
"total": 75640
}
},
{
"messageId": "95c3c3ab-aa78-420e-8f6e-0749b0697a8e",
"timestamp": "2026-09-29T02:17:40.915Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 75757,
"output": 244,
"cached": 71852,
"thoughts": 28,
"tool": 0,
"total": 76029
}
},
{
"messageId": "212eace9-91fc-4d82-acfb-6de9aabe5680",
"timestamp": "2026-09-29T02:18:45.976Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 76139,
"output": 90,
"cached": 71838,
"thoughts": 10156,
"tool": 0,
"total": 86385
}
},
{
"messageId": "981ff26b-d48e-43b8-a660-76d1aecbd263",
"timestamp": "2026-09-29T02:24:28.764Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 88246,
"output": 106,
"cached": 8007,
"thoughts": 3750,
"tool": 0,
"total": 92102
}
},
{
"messageId": "f61a6cc2-1acc-44b4-a54a-23d293a02eaf",
"timestamp": "2026-09-29T02:29:56.146Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 94007,
"output": 51,
"cached": 0,
"thoughts": 30,
"tool": 0,
"total": 94088
}
},
{
"messageId": "93493f74-b697-44e6-8ed2-99c6ce96a769",
"timestamp": "2026-09-29T02:30:02.202Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 94178,
"output": 126,
"cached": 92171,
"thoughts": 75,
"tool": 0,
"total": 94379
}
},
{
"messageId": "fef816a6-cf30-4066-afa5-504ff754fbfd",
"timestamp": "2026-09-29T02:30:22.738Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 94570,
"output": 45,
"cached": 92154,
"thoughts": 2543,
"tool": 0,
"total": 97158
}
},
{
"messageId": "0329f26e-f960-4b94-9791-130d60411ed2",
"timestamp": "2026-09-29T02:31:00.212Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 98147,
"output": 195,
"cached": 92204,
"thoughts": 5325,
"tool": 0,
"total": 103667
}
},
{
"messageId": "8b23bc43-7475-453a-9c1e-f4e11cb1ef7a",
"timestamp": "2026-09-29T02:31:19.010Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 103841,
"output": 43,
"cached": 96298,
"thoughts": 3040,
"tool": 0,
"total": 106924
}
},
{
"messageId": "1ea961be-98ac-4acb-84fd-4e2b92873a8e",
"timestamp": "2026-09-29T02:31:21.874Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 107472,
"output": 45,
"cached": 100355,
"thoughts": 149,
"tool": 0,
"total": 107666
}
},
{
"messageId": "acd50465-26dd-422f-8878-cb766d0fa44f",
"timestamp": "2026-09-29T02:31:27.860Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 108287,
"output": 47,
"cached": 104361,
"thoughts": 618,
"tool": 0,
"total": 108952
}
},
{
"messageId": "6056b538-c1b0-4df4-baa2-30c6f30b0971",
"timestamp": "2026-09-29T02:31:33.038Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 109495,
"output": 47,
"cached": 104360,
"thoughts": 391,
"tool": 0,
"total": 109933
}
},
{
"messageId": "53336684-d123-4c5e-ab4f-11f53e07cfc9",
"timestamp": "2026-09-29T02:31:44.830Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 110723,
"output": 544,
"cached": 108373,
"thoughts": 1163,
"tool": 0,
"total": 112430
}
},
{
"messageId": "ca40791c-7429-4880-968a-41907617200a",
"timestamp": "2026-09-29T02:31:50.264Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 112436,
"output": 37,
"cached": 108372,
"thoughts": 107,
"tool": 0,
"total": 112580
}
},
{
"messageId": "3cacbb01-e6c3-4ea2-9523-cb241ce3067e",
"timestamp": "2026-09-29T02:31:53.994Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 112884,
"output": 80,
"cached": 108356,
"thoughts": 122,
"tool": 0,
"total": 113086
}
},
{
"messageId": "4139c098-d467-48d8-b66b-27801b136cce",
"timestamp": "2026-09-29T02:31:58.703Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 113115,
"output": 544,
"cached": 108336,
"thoughts": 18,
"tool": 0,
"total": 113677
}
},
{
"messageId": "7ede99bf-78f6-4094-9c86-74c3f1d6edd8",
"timestamp": "2026-09-29T02:32:13.796Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 113882,
"output": 710,
"cached": 108317,
"thoughts": 766,
"tool": 0,
"total": 115358
}
},
{
"messageId": "56596ab3-fe38-44a7-904e-f55e5f9ad00f",
"timestamp": "2026-09-29T02:32:18.333Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 115728,
"output": 45,
"cached": 112332,
"thoughts": 64,
"tool": 0,
"total": 115837
}
},
{
"messageId": "00c17bec-fe96-4adf-b5fb-18f0e9f8fc4d",
"timestamp": "2026-09-29T02:32:23.157Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 116428,
"output": 572,
"cached": 112321,
"thoughts": 27,
"tool": 0,
"total": 117027
}
},
{
"messageId": "6a5de5ff-16ee-43cb-bc7c-954d7c6a2a8f",
"timestamp": "2026-09-29T02:32:26.080Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 117237,
"output": 47,
"cached": 112303,
"thoughts": 55,
"tool": 0,
"total": 117339
}
},
{
"messageId": "f16b20b6-aaca-43f0-9814-3858c5b271e3",
"timestamp": "2026-09-29T02:32:30.302Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 117907,
"output": 434,
"cached": 112292,
"thoughts": 16,
"tool": 0,
"total": 118357
}
},
{
"messageId": "d37f851a-3d87-4e5d-8324-ab4a406a0082",
"timestamp": "2026-09-29T02:32:32.952Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 118743,
"output": 47,
"cached": 116285,
"thoughts": 54,
"tool": 0,
"total": 118844
}
},
{
"messageId": "5a1f5acd-b3fc-43d0-962e-cf4464202d20",
"timestamp": "2026-09-29T02:32:36.650Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 120393,
"output": 47,
"cached": 116294,
"thoughts": 22,
"tool": 0,
"total": 120462
}
},
{
"messageId": "687f7951-b8ca-49c5-ab86-0b65af3a9c66",
"timestamp": "2026-09-29T02:32:47.528Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 120963,
"output": 1805,
"cached": 116281,
"thoughts": 64,
"tool": 0,
"total": 122832
}
},
{
"messageId": "ae441d94-9177-4cf4-8a1f-e35841e03340",
"timestamp": "2026-09-29T02:32:52.837Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 123820,
"output": 58,
"cached": 120315,
"thoughts": 51,
"tool": 0,
"total": 123929
}
},
{
"messageId": "cb3e1342-b57a-4bde-b9c4-a6b9cd72c603",
"timestamp": "2026-09-29T02:32:57.820Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 123958,
"output": 159,
"cached": 120293,
"thoughts": 172,
"tool": 0,
"total": 124289
}
},
{
"messageId": "d62425b2-472d-4ac3-995c-5fdb14d6d55b",
"timestamp": "2026-09-29T02:37:51.014Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 126219,
"output": 57,
"cached": 0,
"thoughts": 56,
"tool": 0,
"total": 126332
}
},
{
"messageId": "5e8d9f3b-653e-4663-9128-bf45ed3ff7ef",
"timestamp": "2026-09-29T02:38:00.571Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 126425,
"output": 128,
"cached": 124304,
"thoughts": 271,
"tool": 0,
"total": 126824
}
},
{
"messageId": "7e2a2939-4fd5-49ce-bc1f-15c9b663d312",
"timestamp": "2026-09-29T02:38:08.008Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 127005,
"output": 159,
"cached": 124291,
"thoughts": 151,
"tool": 0,
"total": 127315
}
},
{
"messageId": "69efc7ee-4ab3-49b6-bee3-7a491223f7aa",
"timestamp": "2026-09-29T02:43:01.668Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 129245,
"output": 53,
"cached": 0,
"thoughts": 20,
"tool": 0,
"total": 129318
}
},
{
"messageId": "ba8a7bcb-ebf0-4cb1-a7ec-c1f4356d4948",
"timestamp": "2026-09-29T02:43:11.271Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 129412,
"output": 130,
"cached": 124291,
"thoughts": 60,
"tool": 0,
"total": 129602
}
},
{
"messageId": "4a5070b2-1a95-4200-9ce8-621e20e2d27d",
"timestamp": "2026-09-29T02:43:31.459Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 129782,
"output": 58,
"cached": 124274,
"thoughts": 2962,
"tool": 0,
"total": 132802
}
},
{
"messageId": "83d34492-956c-41c7-84bd-fdbc2061aec0",
"timestamp": "2026-09-29T02:44:06.406Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 135077,
"output": 61,
"cached": 128366,
"thoughts": 5250,
"tool": 0,
"total": 140388
}
},
{
"messageId": "cb8b03c9-4d9f-4a0f-95c3-a43c2df06853",
"timestamp": "2026-09-29T02:44:09.485Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 140717,
"output": 45,
"cached": 132463,
"thoughts": 91,
"tool": 0,
"total": 140853
}
},
{
"messageId": "8a58161f-d8e8-4313-823b-d15df6b2d161",
"timestamp": "2026-09-29T02:44:13.952Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 141289,
"output": 492,
"cached": 136464,
"thoughts": 20,
"tool": 0,
"total": 141801
}
},
{
"messageId": "07b37b72-61c6-410e-836c-72c114ed6158",
"timestamp": "2026-09-29T02:44:23.571Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 142178,
"output": 45,
"cached": 136447,
"thoughts": 50,
"tool": 0,
"total": 142273
}
},
{
"messageId": "a3c94b71-2c7f-49c5-bad3-aee6f8450116",
"timestamp": "2026-09-29T02:44:28.225Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 142733,
"output": 493,
"cached": 140446,
"thoughts": 19,
"tool": 0,
"total": 143245
}
},
{
"messageId": "23c5d756-122c-4418-810f-1e6dc699a9be",
"timestamp": "2026-09-29T02:44:30.715Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 143603,
"output": 58,
"cached": 140429,
"thoughts": 25,
"tool": 0,
"total": 143686
}
},
{
"messageId": "12bce607-bc57-4c3a-95af-761e0a6d88a4",
"timestamp": "2026-09-29T02:44:37.612Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 143715,
"output": 170,
"cached": 140406,
"thoughts": 577,
"tool": 0,
"total": 144462
}
},
{
"messageId": "d57e3fba-0808-4840-aff9-67c4e3003fd4",
"timestamp": "2026-09-29T02:50:05.782Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 146382,
"output": 48,
"cached": 0,
"thoughts": 14,
"tool": 0,
"total": 146444
}
},
{
"messageId": "d49fbe9a-6ef2-4e11-b384-1feb10480134",
"timestamp": "2026-09-29T02:50:16.597Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 146533,
"output": 138,
"cached": 144425,
"thoughts": 501,
"tool": 0,
"total": 147172
}
},
{
"messageId": "de655d7d-ae78-4d06-9e7d-f569ca55e730",
"timestamp": "2026-09-29T02:55:25.544Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 149097,
"output": 49,
"cached": 0,
"thoughts": 15,
"tool": 0,
"total": 149161
}
},
{
"messageId": "ded50113-f079-4302-8ecb-45938d6de1c4",
"timestamp": "2026-09-29T02:55:35.927Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 149251,
"output": 159,
"cached": 144430,
"thoughts": 554,
"tool": 0,
"total": 149964
}
},
{
"messageId": "8877c3fc-144f-443f-8bff-9f188ed63890",
"timestamp": "2026-09-29T03:01:54.992Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 151895,
"output": 53,
"cached": 8025,
"thoughts": 19,
"tool": 0,
"total": 151967
}
},
{
"messageId": "4bf9c485-3867-4281-b423-8975a7484599",
"timestamp": "2026-09-29T03:02:09.342Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 152061,
"output": 43,
"cached": 148448,
"thoughts": 1365,
"tool": 0,
"total": 153469
}
},
{
"messageId": "cec96189-4908-4883-a5a3-31a636456be8",
"timestamp": "2026-09-29T03:02:19.984Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 153982,
"output": 601,
"cached": 148461,
"thoughts": 114,
"tool": 0,
"total": 154697
}
},
{
"messageId": "1bacec03-76fe-4a6d-9024-b324fcf8efd7",
"timestamp": "2026-09-29T03:02:31.703Z",
"model": "gemini-3.8-flash",
"tokens": {
"input": 155019,
"output": 202,
"cached": 152460,
"thoughts": 220,
"tool": 0,
"total": 155441
}
}
]
}
}