Release 0.1.9

Author: lletourmy

CHANGELOG.md

@@ -12,6 +12,14 @@ Living plan (what’s next): [`doc/roadmap.md`](doc/roadmap.md).
 
 ## [Unreleased]
 
+## [0.1.9] — 2026-09-10
+
+Copilot rail can pick which Snowflake connections TOML to use.
+
+### Added
+
+- Copilot rail **Config file** + **Connection** selectboxes on one row — the connection popover lists `~/.snowflake/*.toml`. A single file is still listed (one option). `toml_file=` sets the default. Profile names come from the selected file. Helpers: `list_snowflake_connections()`, `list_snowflake_toml_files()`, `resolve_snowflake_config_path()`.
+
 ## [0.1.8.1] — 2026-09-07
 
 Copilot rail starters can fill the chat input without sending.

ID.md

@@ -9,7 +9,7 @@
 | **Asset Owner** | Laurent Letourmy — laurent.letourmy@devoteam.com |
 | **Contributors** | DevoteamSP / streamlit-coco contributors |
 | **Created** | 2026-07 |
-| **Last updated** | 2026-09-07 |
+| **Last updated** | 2026-09-10 |
 | **Confidentiality** | Public |
 
 ---
@@ -28,7 +28,7 @@
 
 ## Maturity Justification
 
-**Current level**: N0 → closing alpha toward N1 (PyPI `0.1.8.1`)
+**Current level**: N0 → closing alpha toward N1 (PyPI `0.1.9`)
 
 - Clients where used: 0 (alpha). Internal: Data Product Studio + Data Product Forge
 - Consultants trained: 0 additional. Enablement pack + workshop W01 shipped in `0.1.6`; registry `consultants_enabled: 1` is the asset owner.
@@ -42,7 +42,7 @@
 - [x] Consultant enablement pack (`doc/training/`) + workshop W01 (`0.1.6`)
 - [x] Owner + KPIs on this sheet
 - [x] Security threat model + audit pack (`doc/security/`) — SEC-01 / SEC-02 still open for v0.2
-- [x] Marketing one-pager (`doc/marketing/one-pager.md`) — refreshed for `0.1.8.1`
+- [x] Marketing one-pager (`doc/marketing/one-pager.md`) — refreshed for `0.1.9`
 - [ ] 1 additional consultant trained via W01 (pack exists; count still 0 beyond owner)
 - [ ] Remaining live UI checklists — core panel / approvals / tools / structured / CCv2 signed off; copilot-rail still pending
 - [ ] 2+ client usages

README.md

@@ -9,7 +9,7 @@ You own the page. CoCo owns the session. `copilot_rail()` sits in the product an
 
 ![BI → Semantic — Preview of the generated Streamlit app beside the Copilot rail](doc/screenshot.png)
 
-> Alpha `0.1.8.1` — API may still move. Star / watch the repo if you plan to ship on it.
+> Alpha `0.1.9` — API may still move. Star / watch the repo if you plan to ship on it.
 
 **Repo:** [github.com/lletourmy/streamlit-coco](https://github.com/lletourmy/streamlit-coco) *(temporary PyPI source)* · **Dev:** [streamlit-coco-dev](https://github.com/DevoteamSP/streamlit-coco-dev)  
 **SDK docs:** [Cortex Code Agent SDK](https://docs.snowflake.com/en/user-guide/cortex-code-agent-sdk/cortex-code-agent-sdk)
@@ -37,7 +37,7 @@ Also: headless `query()` for scripts and CI, plus a legacy all-in-one `chat()` i
 - **You need Slack, a hosted CoCo SaaS, or a product MCP server.** Out of scope. MCP *passthrough* via `mcp_servers` already works.
 - **You would not type the SQL yourself on this role.** The agent uses the Snowflake role in the connection — do not wire `ACCOUNTADMIN` into a web UI.
 
-Alpha `0.1.8.1` — APIs may still move. Prefer `panel()` + your own input; `chat()` is the legacy all-in-one.
+Alpha `0.1.9` — APIs may still move. Prefer `panel()` + your own input; `chat()` is the legacy all-in-one.
 
 ---
 
@@ -172,7 +172,7 @@ Legacy `chat()` is the same session, with a CCv2 frontend instead of native widg
 | Capability | Entry points |
 | --- | --- |
 | Native panel + approvals | `panel()`, `chat_input_bar()`, `render_approvals()` |
-| Copilot rail (right-column Copilot) | `copilot_rail()`, `transcript_display_config()`, `example_questions=` / `deferred=` — [`doc/features/copilot-rail/`](doc/features/copilot-rail/) |
+| Copilot rail (right-column Copilot) | `copilot_rail()`, `transcript_display_config()`, `example_questions=` / `deferred=` / `toml_file=` — [`doc/features/copilot-rail/`](doc/features/copilot-rail/) |
 | App viewer (child Streamlit iframe) | `app_viewer()`, `default_fix_prompt()` — [`doc/features/app-viewer/`](doc/features/app-viewer/) |
 | Tool cards & AskUser / plan UI | see [`doc/features/tools-display/`](doc/features/tools-display/) |
 | Session & options | `CocoSession`, `CocoOptions`, `get_or_create_session` |

doc/api.md

@@ -1,7 +1,7 @@
 # API reference — streamlit-coco
 
 Public surface exported from `import streamlit_coco as st_coco`.  
-Alpha `0.1.8.1` — signatures may still move; prefer this page over the PRD sketch.
+Alpha `0.1.9` — signatures may still move; prefer this page over the PRD sketch.
 
 **Related:** [README quickstart](../README.md) · [Local deployment](deployment/local.md) · [Feature docs](features/README.md) · [SDK docs](https://docs.snowflake.com/en/user-guide/cortex-code-agent-sdk/cortex-code-agent-sdk)
 
@@ -176,7 +176,8 @@ status card).
 | --- | --- | --- |
 | `session` | — | `CocoSession` or `None` until connected |
 | `connected` | `True` | Whether Connect has been confirmed |
-| `connections` | `None` | Snowflake connection names for the popover |
+| `connections` | `None` | Extra connection names prepended on the popover (e.g. from `st.secrets`). Profiles from the selected TOML always appear |
+| `toml_file` | `None` | Default for the **Config file** selectbox (beside **Connection** on one row). A bare name is looked up under `~/.snowflake/`; a path is used as given |
 | `on_connect` / `on_disconnect` | `None` | Callbacks; omit to hide the popover |
 | `job` | `None` | `{prompt, label, status, expect_structured, …}` |
 | `on_job_sent` | `None` | Called after a queued prompt is `session.send`'d |
@@ -288,7 +289,7 @@ Low-level resolve for custom approval UIs.
 
 | Function | Role |
 | --- | --- |
-| `render_environment_status(env=None, *, connection=None, stacked=False, show_title=True)` | SDK / CLI / Snowflake probe UI |
+| `render_environment_status(env=None, *, connection=None, toml_file=None, stacked=False, show_title=True)` | SDK / CLI / Snowflake probe UI |
 | `render_start_gate(options, *, session_key=…, gate_key=…, warm_up=True, env=None) -> bool` | Landing screen; `False` → call `st.stop()` |
 
 ---
@@ -358,14 +359,26 @@ Flatten events for audit views (requires pandas).
 
 ## Environment & errors
 
-### `check_environment(*, connection=None, cli_path=None) -> CocoEnvironment`
+### `check_environment(*, connection=None, cli_path=None, toml_file=None) -> CocoEnvironment`
 
 Probe without starting an agent. Does not raise.
 
-`CocoEnvironment` fields: `sdk_installed`, `sdk_version`, `cli_path`, `cli_version`, `snowflake_config_file`, `connection_hint`.  
-Properties: `ready`, `cli_ok`, `snowflake_config_found`, `snowflake_config_display`.
+`CocoEnvironment` fields: `sdk_installed`, `sdk_version`, `cli_path`, `cli_version`, `snowflake_config_file`, `connection_hint`, `toml_file`.  
+Properties: `ready`, `cli_ok`, `snowflake_config_found`, `snowflake_config_display`, `snowflake_config_missing_label`.
 
-### `require_environment(*, connection=None, cli_path=None, require_snowflake_config=False) -> CocoEnvironment`
+`toml_file` is a Snowflake connections TOML filename under `~/.snowflake/` or a path. When omitted, the only `*.toml` in that directory is used whatever its name; if several exist, `connections.toml` is preferred, then `config.toml`.
+
+### `list_snowflake_toml_files() -> list[Path]`
+
+`*.toml` files under `~/.snowflake/`, with `connections.toml` then `config.toml` first, then the rest alphabetically.
+
+### `list_snowflake_connections(toml_file=None) -> list[str]`
+
+Connection profile names from that TOML. Bare names resolve under `~/.snowflake/`. Legacy `config.toml` is read from the `[connections]` table; other files use top-level tables.
+
+Helpers: `resolve_snowflake_config_path(toml_file=None, *, must_exist=True)`, `default_snowflake_connection_name(toml_file=None)`.
+
+### `require_environment(*, connection=None, cli_path=None, toml_file=None, require_snowflake_config=False) -> CocoEnvironment`
 
 Like `check_environment`, but raises typed errors when SDK/CLI (and optionally Snowflake config) are missing.
 
@@ -406,7 +419,7 @@ Tool card UX: [`features/tools-display/SPEC.md`](features/tools-display/SPEC.md)
 ## Package metadata
 
 ```python
-st_coco.__version__  # e.g. "0.1.8.1"
+st_coco.__version__  # e.g. "0.1.9"
 ```
 
 Private modules (`bridge`, `tool_cards`, `tool_extract`, …) are implementation details and are not part of the stable public surface.

doc/deployment/publish.md

@@ -50,9 +50,9 @@ cp -R doc-dev/releases/_template/. "doc-dev/releases/${VER}/"
 ```
 
 - Public checklist: [`doc/releases/`](../releases/README.md) → `doc/releases/X.Y.Z/CHECKLIST.md`  
-  (current: [`doc/releases/0.1.8.1/`](../releases/0.1.8.1/))
+  (current: [`doc/releases/0.1.9/`](../releases/0.1.9/))
 - Outreach (LinkedIn / Medium / community): [`doc-dev/releases/`](../../doc-dev/releases/README.md)  
-  (current: [`doc-dev/releases/0.1.8.1/`](../../doc-dev/releases/0.1.8.1/)) — **never synced** to the public repo
+  (current: [`doc-dev/releases/0.1.9/`](../../doc-dev/releases/0.1.9/)) — **never synced** to the public repo
 
 ```bash
 make test-all

doc/features/README.md

@@ -42,7 +42,7 @@ Exploratory prompts: [`examples/testdata/`](../../examples/testdata/).
 | UI golden path — tools-display | **Pass (core)** (2026-07-27) | [`tools-display/test-checklist.md`](tools-display/test-checklist.md) — Glob/Grep/Read/Write/Edit live; SQL/AskUser/plan/debug deferred |
 | UI golden path — structured-output | **Pass (core)** (2026-07-27) | [`structured-output/test-checklist.md`](structured-output/test-checklist.md) — `make structured` + `output_schema` live |
 | UI golden path — chat-ccv2 | **Pass** (2026-07-27) | [`chat-ccv2/test-checklist.md`](chat-ccv2/test-checklist.md) — `make approval` live |
-| UI golden path — copilot-rail | **Pending** (`0.1.8.1` deferred step) | [`copilot-rail/test-checklist.md`](copilot-rail/test-checklist.md) — `make bi-semantic` (step 2b-deferred) |
+| UI golden path — copilot-rail | **Pending** (`0.1.9` Config file row) | [`copilot-rail/test-checklist.md`](copilot-rail/test-checklist.md) — `make app-builder` (step 1a) |
 | UI golden path — app-viewer | **Pending** (`0.1.7`) | [`app-viewer/test-checklist.md`](app-viewer/test-checklist.md) — `make bi-semantic` |
 | UI golden path — app-builder | **Automated** (`0.1.8`) | [`app-builder/test-checklist.md`](app-builder/test-checklist.md) — `make test-all` 2026-09-06; live CoCo sign-off still open |
 

doc/features/copilot-rail/copilot-rail.md

@@ -3,7 +3,7 @@
 Reusable right-rail Copilot for Streamlit apps: connection, queued jobs,
 transcript compactness, `panel()`, and `chat_input_bar()`.
 
-**Status:** Shipped in **`0.1.6`**. Example questions + Display config popover in **`0.1.8`**. `deferred=` example questions in **`0.1.8.1`**.
+**Status:** Shipped in **`0.1.6`**. Example questions + Display config popover in **`0.1.8`**. `deferred=` example questions in **`0.1.8.1`**. Config file picker / `toml_file=` in **`0.1.9`**.
 
 ## What
 
@@ -43,7 +43,7 @@ session = st_coco.get_or_create_session(opts, key="copilot")
 st_coco.copilot_rail(
     session,
     connected=True,
-    connections=["analytics"],
+    toml_file="connections.toml",
     connection_name="analytics",
     on_connect=lambda name: ...,
     on_disconnect=lambda: ...,
@@ -88,6 +88,13 @@ not run it — the user can edit, then submit. Starters disappear once a turn
 starts, the chat has a user or assistant message, or a job is present, and
 return after **Clear chat**. A deferred click does not hide them.
 
+Pass **`toml_file=`** to set the default Snowflake connections file. The
+connection popover puts **Config file** and **Connection** selectboxes on
+one row. A single ``~/.snowflake/*.toml`` is still listed (one option);
+several files are all listed. Profile names always come from the selected
+file. ``connections=`` extra names are prepended (for example from
+``st.secrets``). The environment probe shows the selected file.
+
 ## Limitations
 
 - Callers still own session lifecycle (reset on cwd / schema change).
@@ -96,7 +103,7 @@ return after **Clear chat**. A deferred click does not hide them.
   `panel()` still has its own streaming fragment so the icon stays clickable
   while CoCo runs.
 - Tool cards are not character-truncated (they are already compact expanders).
-- Version tag for this API is **`0.1.8.1`** (`pip install "streamlit-coco[sdk]==0.1.8.1"`). Rail chrome shipped in `0.1.6`; example questions in `0.1.8`; `deferred=` in `0.1.8.1`.
+- Version tag for this API is **`0.1.9`** (`pip install "streamlit-coco[sdk]==0.1.9"`). Rail chrome shipped in `0.1.6`; example questions in `0.1.8`; `deferred=` in `0.1.8.1`; Config file picker in `0.1.9`.
 
 ## Related
 

doc/features/copilot-rail/test-checklist.md

@@ -15,6 +15,7 @@
 | # | Step | Expected |
 | --- | --- | --- |
 | 1 | Open an app that mounts `copilot_rail` disconnected | Connection popover; no session |
+| 1a | Open Connection | **Config file** and **Connection** selectboxes sit on one row. One `~/.snowflake/*.toml` → one config option; several → pick among them. Profiles and the environment probe follow the selected file |
 | 2 | Connect | Environment status; Copilot ready caption. If the app passed `example_questions`, starter buttons appear under the empty transcript (title on the button) |
 | 2a | Hover a starter button | Tooltip shows the **question** text (not just the title) |
 | 2b | Click a starter | The question is sent as a user turn; starters hide; CoCo runs |

doc/marketing/demo.md

@@ -109,7 +109,7 @@
 | Does it work with SiS? | Not yet — pure Python, waiting for the CoCo API |
 | What LLM does it use? | Whatever Cortex Code uses (Claude, ChatGPT...) — no config needed |
 | Can I customize which tools need approval? | Yes — `permission_mode` in `CocoOptions` |
-| Is it production-ready? | Alpha (`0.1.8.1`) — use in internal tools today, production after N1 |
+| Is it production-ready? | Alpha (`0.1.9`) — use in internal tools today, production after N1 |
 
 ---
 

doc/marketing/one-pager.md

@@ -17,7 +17,7 @@ Teams building Streamlit apps on Snowflake need AI-assisted data exploration, co
 | Capability | What it does |
 |-----------|--------------|
 | `panel()` | Streaming agent transcript with tool cards (SQL, Read, Write, Grep) |
-| `copilot_rail()` | Right-rail Copilot: connection, queued jobs, compact transcript; `example_questions=` / `deferred=` (`0.1.8` / `0.1.8.1`) |
+| `copilot_rail()` | Right-rail Copilot: connection, queued jobs, compact transcript; `example_questions=` / `deferred=` / `toml_file=` (`0.1.8` / `0.1.8.1` / `0.1.9`) |
 | `app_viewer()` | Child Streamlit process + iframe + **Fix with CoCo** (`0.1.7`) |
 | App Builder | Type library → brief → CoCo Write → Preview (`0.1.8`, `make app-builder`) |
 | Approval gates | Human-in-the-loop pause before destructive tools execute |
@@ -81,7 +81,7 @@ streamlit run app.py
 
 | | |
 |---|---|
-| **Level** | N0 (Alpha `0.1.8.1`) — targeting N1 |
+| **Level** | N0 (Alpha `0.1.9`) — targeting N1 |
 | **License** | Apache-2.0 |
 | **Owner** | Laurent Letourmy — Devoteam Snowflake Partner |
 | **Repo** | [github.com/DevoteamSP/streamlit-coco](https://github.com/DevoteamSP/streamlit-coco) |