1bcoder 0.1.0__py3-none-any.whl

1bcoder-0.1.0.dist-info/METADATA

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: 1bcoder
+Version: 0.1.0
+Requires-Python: >=3.10
+Requires-Dist: requests>=2.28
+Requires-Dist: pyreadline3>=3.4; sys_platform == "win32"
+Requires-Dist: tqdm>=4.64
+Requires-Dist: rich>=13.0

1bcoder-0.1.0.dist-info/RECORD

@@ -0,0 +1,66 @@
+chat.py,sha256=3kv4mfRVdy_dLh9ue8x9PLcQyjV5jLocQAKVdNvxWew,278453
+map_index.py,sha256=actlEYczPBo-hMOx_E3yFAzzZXW0ioz8oEX6dSqUJBw,15949
+map_query.py,sha256=dFxz89r3thIer2CiIniJHQ744CS2zs8AA8OYCIfI3ZI,23242
+_bcoder_data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+_bcoder_data/aliases.txt,sha256=Jmf6shTcAYaC5qNX35L9eslzJdIcrR98qcyLpGhmbuI,276
+_bcoder_data/map.txt,sha256=fAOictDbYy-bP5mn9F9LqCrmupHbdvJGa2bBKH-xtPA,4679
+_bcoder_data/profiles.txt,sha256=E3BnS4W0qQLufRRDYYp0DG6GgwwHWIG08fNfqhLhCAc,817
+_bcoder_data/prompts.txt,sha256=Hj_D1qklVF3fh9sBR2GWIvMGZi3eWrz89TMRcDyB20w,41
+_bcoder_data/agents/advance.txt,sha256=83B-nk2GK87YPdkZYgyJ0qB71V9B35fRp5Cq5RGB2F0,1261
+_bcoder_data/agents/ask.txt,sha256=umoKQHIrNA7Jm-Ciw1tWhEQ52cOKzOlfY4cw_JtwZuk,1400
+_bcoder_data/agents/fill.txt,sha256=Nw-iEHm5lXQwJxfI87WOGBDRQSK6f13wbYNwX2cYTcw,1720
+_bcoder_data/agents/planning.txt,sha256=V41mA97xkIf1gJbKYgRFI2AakBs-xci_0k2PzznV3rk,2283
+_bcoder_data/agents/sqlite.txt,sha256=lWouH5APvovuLs8YcXQ_FHthRdvljuwVOUmFMk1Nh4c,1497
+_bcoder_data/doc/MCP.md,sha256=nJD_dO1BflHg2BD50ugvdU1On_2evBKtCdIBZmkKsD8,3689
+_bcoder_data/doc/PARAM.md,sha256=NmgWGHyHtGgzkMk6Zzd9T5sdThZtdT97G-zvO3Q7B6w,5806
+_bcoder_data/doc/PROC.md,sha256=UNjK1f7UAb1woJFKH7BIVV7oT5eYRIuckwkizbyTHiE,4232
+_bcoder_data/proc/add-save.py,sha256=1g4tVZR3mjbstvc7rJHO9_iAnXqkYljXKkG7SlUK-c8,732
+_bcoder_data/proc/collect-files.py,sha256=D5lvkPzXdzYEjyqAeUjgcF3VjFPUyWirVa7HUi4-x4Y,1280
+_bcoder_data/proc/extract-code.py,sha256=L3elKLvp9YcRgLuko0QvwfMIyHxB1seqljJ07g1G5r4,2993
+_bcoder_data/proc/extract-files.py,sha256=LHhsAeXGY1kJpQZ4fQV4bUetJXjZP0qHA_bhjObpGpg,899
+_bcoder_data/proc/extract-list.py,sha256=kUtJUOwWQqAGEmnksjYwnZz_WZV9CsLjIxiK_MD8-ss,1254
+_bcoder_data/proc/grounding-check.py,sha256=1bxtVtW8FhpY812uYFQ-qSRi1F0PZ4LFT56bC73Op2M,1892
+_bcoder_data/proc/md.py,sha256=aqNb1LjraNrCKTYeE9nN81gpSa2XdrPSe0ca7MUVy4Q,298
+_bcoder_data/proc/mdx.py,sha256=GRP1DzIPVjuGUL9_oScazgg4vKwDHkAaj557BeWfWq8,3843
+_bcoder_data/proc/regexp-extract.py,sha256=SkW9WniyWH0yTygT6QBQoX6YtNVwBMoAEoev94iRuKc,2889
+_bcoder_data/prompts/analysis.txt,sha256=_PZGbJnu32nRppYlkqiojwoXmab6P_fTfDBcxj4Ot40,92
+_bcoder_data/prompts/sumarise.txt,sha256=n7BMF4fbUDCqkdy1m5ioFOxxcZJSAPScpxY2AHZ-SF8,85
+_bcoder_data/scripts/AddFunction.txt,sha256=IIhzuZSYiqofvZPiSDLXbOgXeczrQV8GL5hmSdWlkhc,349
+_bcoder_data/scripts/AskProject.txt,sha256=sXuQDavv74vatYqtxhZynD48m6wlidmKKMymOdqr7CM,260
+_bcoder_data/scripts/CheckRequirements.txt,sha256=A-ooP91Vt7NKZg3z2P1dPnSTMtAfFk1J40E3mWo2Z2I,693
+_bcoder_data/scripts/DockerMySQL.txt,sha256=C8PUYEL2-if1nyQfqYzWpIf53ixt1rvWKzlcqdxd4H4,433
+_bcoder_data/scripts/DockerNginx.txt,sha256=3fAmcdcdsz43lp-k7mSud1-iuGaAqu31oE4-bffvmOM,382
+_bcoder_data/scripts/DockerPython.txt,sha256=CUEgSYY-MFlX3DC0b1JncbKQBcjY8mZ2BpO8eHf28Dc,626
+_bcoder_data/scripts/DockerStack.txt,sha256=jwGlunQ5Ures8vVt0sUtR6goFU-GIT-x74_Fmx5dTbY,788
+_bcoder_data/scripts/DuckDuckGoInstant.txt,sha256=kGbc6ciyrEmOn3DQZ7EQS_ONxoKZf5VcegzQWbD8Ras,321
+_bcoder_data/scripts/EnvTemplate.txt,sha256=pO8RJR28YZh765z8uPfKLxfStBxjkQdOsmZTu8gpcHI,419
+_bcoder_data/scripts/Explain.txt,sha256=0ThxZDIkWI6566zeIOYJ1m-XA_blmhdkDVTibBlDgWg,281
+_bcoder_data/scripts/ExploreProjectStructure.txt,sha256=uHZFAkIhY5ILIoL03qFsSE9ctfoNS4EbgkTM1dgUBU8,302
+_bcoder_data/scripts/GitIgnorePython.txt,sha256=KxFlSBIAoji7xTfVuBtjX1RsGv4l_SO6-jUoYDzMhnE,320
+_bcoder_data/scripts/MySQLDump.txt,sha256=sL8eOOwI4YS5JgatwlR8FdBWU3SdGXNvP3c4dR2-sy8,327
+_bcoder_data/scripts/NewScript.txt,sha256=nL_DXXhZrQfesQYhOQVd_baPAEamMeM562rKvXCo4wc,239
+_bcoder_data/scripts/PipFreeze.txt,sha256=o-A83Eer56dbKVADrlHiX3QDeSr6rp5KOS5wfmrIkVA,182
+_bcoder_data/scripts/PyPI.txt,sha256=gHCiZImoLieMxoVkI3zO1KLoT4J_Tl0XGsQ_6Ix13Ng,315
+_bcoder_data/scripts/Refactor.txt,sha256=FDiQsArG_d6fSjMWsSd2ATrBLqhTYdyscWc-OkOL9rQ,391
+_bcoder_data/scripts/RunAndFix.txt,sha256=m7TIeQK2iYmlQTlL9LXESz1rcNXogI6BasIHCkL-Kik,279
+_bcoder_data/scripts/SQLiteSchema.txt,sha256=SRHPSUz6_W0Uf1-VkkHN_bgVSCrxaVg6XckdpQoBB2s,311
+_bcoder_data/scripts/WikiPage.txt,sha256=Zd9XAdnmx0Qu1VO5GCG8sNvrSNrNO7NtlOUyPYiMDh4,331
+_bcoder_data/scripts/WikiSearch.txt,sha256=qIPbGAY6h95raJ12rjV2JXW_SbEtM1tpO__0U9_aodw,281
+_bcoder_data/scripts/parallel_call.txt,sha256=AgwRvlAVto4rF2-TdVLsznTJHqhIWj26LWEz-aSrOCw,157
+_bcoder_data/scripts/plan.txt,sha256=23CM3OqLc2oH4xhz1OhTnsra1GCEKHhuYKAeG7QpVIs,410
+_bcoder_data/scripts/set_ctx.txt,sha256=f6oqxgQ72swytEqzBmmzTqZVoxsdilaBkJ2N---VHZc,161
+_bcoder_data/scripts/team-map-worker.txt,sha256=EiS8vRfopxUrYgE3nF87ZQmLj39YGT62R9PvaSvYGwQ,588
+_bcoder_data/scripts/team-search-worker.txt,sha256=lY8XGETAEBMC88jclWvIr2SDFzbaIVe-mxbCmugL6Nc,534
+_bcoder_data/scripts/team-summarize.txt,sha256=psXbyfEqJEkWnWb2O4isUmz0SG9iuZwHnqUaz5pfi4c,492
+_bcoder_data/scripts/team-tree-worker.txt,sha256=--gc38qJDZurSJJh8FP4PJsz59OelweqzUPmpcKNQ6o,487
+_bcoder_data/scripts/test.txt,sha256=T70dUdijXLXg819Ve17rhgzqbY8_Wo_S65HLlocReAE,31
+_bcoder_data/scripts/personal/content/create-regular-content.txt,sha256=uSionb5ork0ke3qH2lKsYxg22l5ccmJJElnDL7g4pL8,127
+_bcoder_data/scripts/personal/content/plan.txt,sha256=23CM3OqLc2oH4xhz1OhTnsra1GCEKHhuYKAeG7QpVIs,410
+_bcoder_data/scripts/personal/test/collect-data-from-test-environment.txt,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+_bcoder_data/scripts/remote/create-content-on-remote-server.txt,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+_bcoder_data/teams/code-analysis.yaml,sha256=1oKE4jpXtjsg6o_9kM83U0qqFEei2UhaSslnfWxdH9w,284
+1bcoder-0.1.0.dist-info/METADATA,sha256=prAxwkmStMoczQCHZB8PXMSTnpLVklcguqnqLW6-_OE,222
+1bcoder-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+1bcoder-0.1.0.dist-info/entry_points.txt,sha256=RrzIUrdl71aGkjvcZUIxQpW90xD1qg9-tpXSRn3aXIw,38
+1bcoder-0.1.0.dist-info/top_level.txt,sha256=FelAUM0ZYbwMsefdhpAgDgXDWn9PcZV-41Vyl2z39f4,38
+1bcoder-0.1.0.dist-info/RECORD,,

1bcoder-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

1bcoder-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+1bcoder = chat:main

1bcoder-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,4 @@
+_bcoder_data
+chat
+map_index
+map_query

_bcoder_data/agents/advance.txt

@@ -0,0 +1,46 @@
+# Autonomous coding agent with full toolset — for larger models (7B+)
+# Usage: /advance <task>  or  /agent advance <task>
+description = Autonomous coding agent with full toolset. Best for 7B+ models.
+max_turns = 10
+auto_exec = false
+auto_apply = false
+
+system =
+    You are an autonomous coding assistant. Complete the task using the available tools.
+
+    To call a tool, write ACTION: followed by the command. Stop and wait for [tool result].
+    When the task is complete, write a plain text summary with no ACTION.
+
+    How to write files:
+    - To MODIFY an existing file: write a SEARCH/REPLACE block, then ACTION: /patch <file> code
+    - To INSERT new code at a line: write the code block, then ACTION: /insert <file> <line> code
+    - To CREATE or fully REPLACE a file: write the full code block, then ACTION: /save <file> code
+
+    SEARCH/REPLACE format:
+    <<<<<<< SEARCH
+    exact lines to replace
+    =======
+    new lines
+    >>>>>>> REPLACE
+
+    Rules:
+    - /read a file before editing it
+    - /bkup save <file> before modifying important files
+    - /run to test after applying a fix
+
+    Available tools:
+    {tool_list}
+
+tools =
+    read
+    readln
+    run
+    insert
+    save
+    bkup
+    diff
+    patch
+    fix
+    tree
+    find
+    map

_bcoder_data/agents/ask.txt

@@ -0,0 +1,41 @@
+# Read-only research agent for 4B models
+# Usage: /ask <question>  or  /agent ask <question>
+description = Read-only research agent. Explores with tree/find/map, never edits files.
+max_turns = 15
+auto_exec = true
+auto_apply = true
+
+system =
+    You are a code research assistant. Explore the project to answer the question.
+
+    To call a tool, write ACTION: on its own line followed by the command.
+    Wait for [tool result] before calling the next tool.
+    Build understanding from broad to narrow. One ACTION per turn.
+    When done, write a plain text answer or plan. Do not write any ACTION when done.
+
+    Strategy:
+    1. If project structure is not yet in context use ACTION: /tree
+    2. To locate relevant identifiers use ACTION: /map find \keyword  (single word, no quotes)
+    3. To find real code identifiers from a phrase use ACTION: /map keyword extract phrase -f -c  (no quotes)
+    4. To search file content use a single keyword e.g. ACTION: /find keyword -c
+    5. To read file dir/file.txt use ACTION: /read dir/file.txt
+    6. Stop when you have enough to answer
+
+    Never edit files. Output a clear report or plan when done.
+
+    Available tools:
+    {tool_list}
+
+tools =
+    read
+    tree
+    find
+    map index
+    map find
+    map trace
+    map keyword
+
+aliases =
+    /kw   = /map keyword extract {{args}} -f -c
+    /sym  = /map find {{args}}
+    /grep = /find {{args}} -c

_bcoder_data/agents/fill.txt

@@ -0,0 +1,49 @@
+# Fill agent — reads current NaN variables and fills them from project context
+# Usage: /fill  or  /agent fill
+description = Fill agent. Reads NaN variables, researches the project, sets each value.
+max_turns = 15
+auto_exec = true
+auto_apply = true
+
+system =
+    You are a variable-filling assistant. Your job is to find values for unset (NaN) session variables.
+
+    Start by checking which variables need to be filled:
+    ACTION: /var get
+
+    Then look for .var files in the project — these contain ready-made key=value pairs:
+    ACTION: /find . -f --ext var
+
+    For each .var file found, read ONLY the first line to see its description (cheap — no context waste):
+    ACTION: /read <filename.var> 1-1
+
+    The first line is always "# <description>" — use it to decide if this file is relevant to the NaN variables.
+    If relevant, load it:
+    ACTION: /var load <filename.var>
+
+    To search for a specific variable name across all .var files:
+    ACTION: /find <var_name> --ext var
+
+    For any variables still NaN after loading .var files, research the project:
+    Use /find, /read to locate config files, .env, settings, or code.
+
+    For each variable you find, write:
+    ACTION: /var set <name> =<value>
+
+    One ACTION per turn. When all NaN variables are filled (or you cannot find a value), write
+    your final reply with no ACTION line:
+    "Done, all variables were set successfully."
+    or if some could not be found:
+    "Done, the following variables could not be filled: <list>"
+    Do not guess values — only set a variable if you found it in project files or .var files.
+
+    Available tools:
+    {tool_list}
+
+tools =
+    var get
+    var set
+    var load
+    read
+    tree
+    find

_bcoder_data/agents/planning.txt

@@ -0,0 +1,54 @@
+# Planning agent — explores the project and writes a step-by-step plan to plan.txt
+# Usage: /plan <goal>  or  /agent planning <goal>
+description = Planning agent. Explores the project, then writes a structured plan saved to plan.txt.
+max_turns = 15
+auto_exec = true
+auto_apply = true
+on_done = /save plan.txt
+
+system =
+    You are a software planning assistant. Your job is to explore the project and produce
+    a clear, actionable, step-by-step implementation plan for the given goal.
+
+    To call a tool, write ACTION: on its own line followed by the command.
+    Wait for [tool result] before calling the next tool.
+    One ACTION per turn.
+
+    Strategy:
+    1. If project structure is not yet in context use ACTION: /tree
+    2. To locate using of relevant identifiers(single word, no quotes) use ACTION: /map find \keyword
+    3. To see link of relevant identifiers(single word, no quotes) use ACTION: /map find keyword
+    4. To see who link to relevant identifiers(single word, no quotes) use ACTION: /map find -keyword
+    5. To see paths between two program identifiers(single word, no quotes) use ACTION: /map trace keyword1 keyword2
+    6. To search keyword(single word, no quotes) in file content use ACTION: /find keyword -c
+    7. To search in file name use ACTION: /find keyword -f -i
+    8. To search all files *.txt by extension use /ACTION: find \.+ --ext txt
+    9. To read file dir/log.txt use ACTION: /read dir/log.txt
+    10. Once you have enough context, write the complete plan as your final reply — no ACTION line.
+
+    Plan format:
+    - Title line: # Plan: <goal>
+    - Numbered steps, each on its own line: 1. Do X in file Y
+    - Add a ### Summary section at the end explaining the overall approach
+    - Add a ### Example section if a concrete usage example helps clarify the goal
+
+    All keyword provided to commands as single word, no quotes.
+    Never edit source files. Your final reply is the plan — do not add any ACTION line.
+    The plan will be saved automatically when you are done.
+
+    Available tools:
+    {tool_list}
+
+tools =
+    read
+    tree
+    find
+    map index
+    map find
+    map trace
+    map keyword
+
+aliases =
+    /kw   = /map keyword extract {{args}} -f -c
+    /sym  = /map find {{args}}
+    /grep = /find {{args}} -c

_bcoder_data/agents/sqlite.txt

@@ -0,0 +1,39 @@
+# SQLite research agent — SELECT queries only
+# Usage: /sqlite <db_file> <question>  or  /agent sqlite <db_file> <question>
+description = SQLite research agent. Gets schema, writes SELECT queries, answers in plain text.
+max_turns = 8
+auto_exec = true
+auto_apply = true
+
+system =
+    You are a SQLite research assistant. Answer questions by querying the database.
+
+    To call a tool, write ACTION: on its own line followed by the command.
+    Wait for [tool result] before calling the next tool.
+    When done, write a plain text answer. Do not write any ACTION when done.
+
+    Workflow:
+    1. If db file is not known, find it: ACTION: /find \.(db|sqlite|sqlite3)$ -f
+    2. Get schema: ACTION: /schema <db_file>
+    3. Write a SELECT query based on the schema
+    4. Run it: ACTION: /query <db_file> "SELECT ..."
+    5. Analyze the result and answer in plain text
+
+    Rules:
+    - One ACTION per turn — write it, then stop and wait for [tool result] before continuing
+    - If a command fails, read the error, fix the command, and retry — do not give up
+    - Always get the schema first if not already in context
+    - Write SELECT queries only — never INSERT, UPDATE, DELETE, DROP, or any other statement
+    - Wrap the SQL in double quotes in /query
+    - After seeing the result, answer directly in plain text with no ACTION
+
+    Available tools:
+    {tool_list}
+
+tools =
+    run
+    find
+
+aliases =
+    /schema = /run sqlite3 {{args}} ".schema"
+    /query  = /run sqlite3 {{args}}

_bcoder_data/aliases.txt

@@ -0,0 +1,8 @@
+# Global aliases — loaded at startup, override with local .1bcoder/aliases.txt
+# Format:  /name = expansion  (use {{args}} for argument substitution)
+
+/ask     = /agent ask
+/advance = /agent advance
+/sqlite  = /agent sqlite
+/plan    = /agent planning
+/fill    = /agent fill

_bcoder_data/doc/MCP.md

@@ -0,0 +1,138 @@
+# MCP Servers — Quick Reference
+
+Connect a server with:
+```
+/mcp connect <name> <command>
+```
+
+---
+
+## Official (actively maintained)
+
+These are published by the MCP team (Anthropic). Safe to use.
+
+### Filesystem
+Read/write files under a given directory.
+```
+/mcp connect fs npx -y @modelcontextprotocol/server-filesystem .
+/mcp connect fs npx -y @modelcontextprotocol/server-filesystem C:\Users\yourname\projects
+```
+
+### Fetch — web page reader
+Fetches a URL and returns clean text (good for docs, articles).
+```
+/mcp connect web uvx mcp-server-fetch
+```
+Then: `/mcp call web/fetch {"url": "https://example.com"}`
+
+### Git
+Read commits, diffs, branches in a local repo.
+```
+/mcp connect git uvx mcp-server-git
+```
+
+### Memory
+Persistent key-value memory that survives across sessions (stored as a local graph).
+```
+/mcp connect mem npx -y @modelcontextprotocol/server-memory
+```
+
+### Sequential Thinking
+Breaks complex problems into thought steps — useful as a reasoning scaffold.
+```
+/mcp connect think npx -y @modelcontextprotocol/server-sequential-thinking
+```
+
+### Time
+Returns current time and converts between timezones.
+```
+/mcp connect time uvx mcp-server-time
+```
+
+---
+
+## Archived (no longer maintained by MCP team)
+
+Still work fine but use at your own risk. Source:
+https://github.com/modelcontextprotocol/servers-archived
+
+### SQLite
+Query a local SQLite database file.
+```
+/mcp connect db uvx mcp-server-sqlite --db-path ./mydb.sqlite
+```
+
+### PostgreSQL
+Query a Postgres database via connection string.
+```
+/mcp connect pg npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb
+```
+
+### Brave Search — web search
+Requires a free API key from https://brave.com/search/api/
+```
+set BRAVE_API_KEY=your_key_here
+/mcp connect search npx -y @modelcontextprotocol/server-brave-search
+```
+
+### GitHub
+Read repos, issues, PRs via the GitHub API.
+Requires a personal access token from https://github.com/settings/tokens
+```
+set GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here
+/mcp connect gh npx -y @modelcontextprotocol/server-github
+```
+
+### GitLab
+Same as GitHub but for GitLab.
+```
+set GITLAB_PERSONAL_ACCESS_TOKEN=your_token_here
+/mcp connect gl npx -y @modelcontextprotocol/server-gitlab
+```
+
+### Puppeteer — browser automation
+Controls a real Chromium browser. Good for scraping JS-heavy pages.
+Requires Node.js and will download Chromium on first run (~200 MB).
+```
+/mcp connect browser npx -y @modelcontextprotocol/server-puppeteer
+```
+
+### Slack
+Read and post messages to Slack workspaces.
+Requires a Slack bot token and team ID.
+```
+set SLACK_BOT_TOKEN=xoxb-...
+set SLACK_TEAM_ID=T...
+/mcp connect slack npx -y @modelcontextprotocol/server-slack
+```
+
+### Redis
+Get/set keys in a running Redis instance.
+```
+/mcp connect redis npx -y @modelcontextprotocol/server-redis
+```
+
+### Google Drive
+Browse and read files from Google Drive (requires OAuth setup).
+```
+/mcp connect gdrive npx -y @modelcontextprotocol/server-gdrive
+```
+
+### Google Maps
+Geocoding, directions, place search via Google Maps API.
+Requires a Google Maps API key.
+```
+set GOOGLE_MAPS_API_KEY=your_key_here
+/mcp connect maps npx -y @modelcontextprotocol/server-google-maps
+```
+
+---
+
+## Notes
+
+- `npx -y` downloads the package on first run, then uses the npm cache. No permanent install.
+- `uvx` does the same for Python packages via uv (`pip install uv` to get it).
+- All servers run locally — no data leaves your machine except for API-key servers
+  (Brave Search, GitHub, Slack, Google Maps) which call their respective APIs.
+- The directory argument in `/mcp connect fs npx ... .` limits what files the server can see.
+  Use a specific path instead of `.` to restrict access.

_bcoder_data/doc/PARAM.md

@@ -0,0 +1,150 @@
+# 1bcoder — Model Parameter Reference
+
+All parameters are set with `/param <key> <value>` and sent with every request.
+View current values: `/param`
+Reset all: `/param clear`
+
+---
+
+## Built-in parameters (1bcoder-internal)
+
+These are handled by 1bcoder directly and are not forwarded to the model API.
+
+| Parameter | Default | Description |
+|---|---|---|
+| `timeout` | 120 | HTTP read timeout in seconds. Increase for slow/large-context models. |
+| `num_ctx` | 4096 | Context window size (tokens). Set via `/ctx <n>` or `/param num_ctx <n>` is not forwarded — use `/ctx`. |
+| `think_exclude` | `true` | Strip `<think>…</think>` blocks from context (blocks are shown in terminal only). Set `false` to keep reasoning in context for multi-turn chains. |
+| `ask_limit` | 8000 | Max characters of `/ask` tool output kept in context. |
+| `ask_show` | 500 | Characters shown in terminal when output is truncated. |
+
+---
+
+## Sampling parameters
+
+Control how the model selects the next token.
+
+| Parameter | Range | Default | Description |
+|---|---|---|---|
+| `temperature` | 0.0 – 2.0 | 0.8 | Randomness. Lower = more deterministic. 0.0 = greedy. Good range: 0.2–0.8 for code. |
+| `top_p` | 0.0 – 1.0 | 0.9 | Nucleus sampling. Only consider tokens whose cumulative probability ≤ top_p. Lower = less diversity. |
+| `top_k` | 0 – ∞ | 40 | Limit sampling pool to top-K tokens. 0 = disabled. Lower = less diverse. |
+| `min_p` | 0.0 – 1.0 | 0.0 | Minimum probability threshold relative to the top token. Filters weak candidates. |
+| `typical_p` | 0.0 – 1.0 | 1.0 | Locally typical sampling. 1.0 = disabled. Can improve coherence for long outputs. |
+| `seed` | integer | -1 | RNG seed. -1 = random. Set a fixed value for reproducible outputs. |
+
+---
+
+## Repetition control
+
+These are the most useful parameters for preventing looping/repetitive output.
+
+| Parameter | Range | Default | Description |
+|---|---|---|---|
+| `repeat_penalty` | 0.0 – ∞ | 1.1 | Penalise tokens that already appeared. >1.0 = penalise, <1.0 = encourage repetition. **1.1–1.3** is the practical range. |
+| `repeat_last_n` | -1 – ∞ | 64 | How many recent tokens to check for repetition. -1 = full context. Larger = stricter de-loop. |
+| `frequency_penalty` | -2.0 – 2.0 | 0.0 | Penalise proportional to how often a token appeared (OpenAI-style). Positive reduces repetition. |
+| `presence_penalty` | -2.0 – 2.0 | 0.0 | Flat penalty for any token that appeared at all (OpenAI-style). Encourages topic diversity. |
+
+**Recommended anti-loop recipe:**
+```
+/param repeat_penalty 1.15
+/param repeat_last_n 128
+```
+For severe looping: `repeat_penalty 1.3`. Above 1.5 quality degrades.
+
+---
+
+## Output length
+
+| Parameter | Range | Default | Description |
+|---|---|---|---|
+| `num_predict` | -1 – ∞ | -1 | Max tokens to generate. -1 = unlimited (until stop token or context full). |
+| `stop` | string | — | Stop sequence. Generation halts when this string is produced. e.g. `/param stop </tool>` |
+
+---
+
+## Thinking / reasoning (extended models)
+
+For models with explicit reasoning chains (DeepSeek-R1, Qwen3, QwQ, etc.).
+
+| Parameter | Values | Description |
+|---|---|---|
+| `enable_thinking` | `true` / `false` | Enable/disable the extended `<think>` chain. Set `false` to skip reasoning and get faster, shorter replies. |
+| `thinking_budget` | integer (tokens) | Max tokens allocated to the thinking chain before the visible reply starts. Model-specific. |
+| `think_exclude` | `true` / `false` | **1bcoder-internal.** Strip `<think>` blocks from context (default: `true`). Does not affect terminal display or the model API call. |
+| `think_show` | `true` / `false` | **1bcoder-internal.** Show `<think>` blocks in terminal during streaming (default: `true`). Independent of `think_exclude`. |
+
+**Note:** `enable_thinking false` tells the model not to think at all.
+`think_exclude` and `think_show` are independent — any combination works:
+- default: show in terminal, strip from context
+- `/think hide` + `/think exclude`: silent, no context cost
+- `/think show` + `/think include`: full reasoning visible and passed to next turn
+
+---
+
+## Mirostat (adaptive sampling)
+
+An alternative to top_p/top_k that targets a specific perplexity level.
+
+| Parameter | Values | Default | Description |
+|---|---|---|---|
+| `mirostat` | 0, 1, 2 | 0 | 0 = disabled, 1 = Mirostat v1, 2 = Mirostat v2 (recommended if used). |
+| `mirostat_tau` | float | 5.0 | Target entropy. Lower = more focused/coherent. |
+| `mirostat_eta` | float | 0.1 | Learning rate. How fast the algorithm adapts. |
+
+---
+
+## Tail-free sampling
+
+| Parameter | Range | Default | Description |
+|---|---|---|---|
+| `tfs_z` | 0.0 – 1.0 | 1.0 | Tail-free sampling. 1.0 = disabled. Removes low-probability tail tokens. |
+
+---
+
+## Penalise newlines
+
+| Parameter | Values | Default | Description |
+|---|---|---|---|
+| `penalize_newline` | `true` / `false` | `false` | Apply repeat_penalty to newline tokens. Prevents newline-only loops. |
+
+---
+
+## Examples
+
+```
+# Reproducible output
+/param seed 42
+/param temperature 0.2
+
+# Prevent looping
+/param repeat_penalty 1.2
+/param repeat_last_n 128
+
+# Fast answer, no thinking chain
+/param enable_thinking false
+
+# Long generation
+/param num_predict 4096
+/param timeout 300
+
+# Keep reasoning in context for chained agents
+/param think_exclude false
+
+# Reset everything
+/param clear
+```
+
+---
+
+## Model compatibility
+
+| Backend | Supports |
+|---|---|
+| Ollama | All parameters except OpenAI-style `frequency_penalty`/`presence_penalty` |
+| OpenAI-compatible | `temperature`, `top_p`, `frequency_penalty`, `presence_penalty`, `seed`, `stop`, `max_tokens` (= `num_predict`) |
+| LM Studio | Same as Ollama |
+| vLLM | OpenAI-compatible subset |
+
+Parameters not understood by the backend are silently ignored by the server.