WARNING: No source added in .add_source_document

[JKDevz]

I followed the following LLMWare tutorial on YouTube and ran into the following error when using Prompter.add_source_document().

source = prompter.add_source_document(contracts_path, contract, query=key)

This gives me a Warning that the source was not added.

What could be the issue?

My contracts_path = ./docs/. My files do have spaces in their names, but I doubt that would be an issue. Could it be the file-type suffix?

Tutorial Video Followed: https://www.youtube.com/watch?v=8aV5p3tErP0

[mferris77]

I'm encountering this as well. While I haven't been able to figure out the root cause yet, I learned that when you create the query list, the keys (ie 'base salary', 'vacation') are used to reduce the amount of content to only chunks of content containing those terms. So if you're using a label there that won't be found in the document, it won't return any chunks of text.

When I updated the query list to something that was on the first page I then got some results. But now it seems to only be parsing the first page - or 10 chunks. So I'm not sure if it's limiting itself to 10 chunks or is encountering an issue with pages in the document.

Their example contracts have multiple pages so I'm not quite sure what the issue is.

[Pravalika-Batchu]

Hey! I ran into that same issue with "prompter.add_source_document()" giving a warning that the source wasn't added. After looking into it, I think the main reason is that the query key we're using (like 'base salary' or 'vacation') has to actually exist exactly in the document. If it doesn’t match any content, no chunks get picked up and it doesn’t add the source.

To check, try using a super common word like “employee” or even set query=None just to see if the document gets loaded without filtering. That’ll tell us if the file itself is fine.

Also, the file type might matter — make sure it’s a .pdf or .txt. And spaces in the filename probably aren’t the issue, but to be safe, try renaming one file to something simple like contract1.pdf.

Lastly, it looks like it only pulls in up to 10 chunks, so if our key is on a later page or not found early, it might get skipped.

[Surbhiiiiiii]

Problem

Calling Prompt.add_source_document(fp, fn, query="foo") printed
WARNING: No source added in .add_source_document. whenever the query string
returned no matches, leaving the prompt without any source context.

Solution

• Parse the document as before.
• Run fast_search_dicts.
• If the search yields 0 hits, keep the original parsed chunks instead of discarding them.

Test coverage

Added tests/test_prompt_sources.py which:

1. Creates a tmp file.
2. Calls add_source_document(..., query="no_hits").
3. Asserts one chunk is still attached and no warning is raised.

python -m pytest tests/test_prompt_sources.py -q → 1 passed.

Checklist

• Code compiles (Windows & *nix).
• New test passes.
• No public API change.
• black and flake8 show no issues (pre-commit ran clean).

Fixes #1172