kira-wallet 0.1.16 → 0.1.17

package/docs/RELEASE.md

@@ -79,7 +79,7 @@ The earlier unpublished 0.1.2 candidate is preserved in the ignored
 `dist/preserved-0.1.2-bad8f02/` directory. Use the current `dist/release.json`
 and its matching archive for publication; do not mix manifests from candidates.
 
-Keep published GitHub tags, release assets and npm versions through 0.1.15
+Keep published GitHub tags, release assets and npm versions through 0.1.16
 immutable. Do not rebuild them from later documentation commits. Future package
 changes need a new version. Release preparation does not publish a GitHub
 release, promote the website or publish to npm.
@@ -95,12 +95,12 @@ python3 scripts/prepare-release.py
 ```
 
 `prepare-release.py` scans the package boundary and creates
-`dist/kira-wallet-0.1.16.tgz`. The ignored `dist/release.json` records its source
+`dist/kira-wallet-0.1.17.tgz`. The ignored `dist/release.json` records its source
 commit, SHA-256 and member count. It never publishes. After reviewing that
 manifest, the operator's final command from the project root is:
 
 ```sh
-npm publish ./dist/kira-wallet-0.1.16.tgz --access public
+npm publish ./dist/kira-wallet-0.1.17.tgz --access public
 ```
 
 Use the operator's npm account and complete authentication or OTP personally.
@@ -433,7 +433,7 @@ personal 0.1.14 installation, credentials, paused history and published archives
 Use a separate private workspace for candidate acceptance. No GitHub release,
 website deployment or personal app upgrade is part of this preparation.
 
-## Release candidate: 0.1.16
+## Published 0.1.16
 
 This version repairs Mint Club symbol routes, including ERC1155 NFT routes and
 encoded symbols, without rewriting historical snapshots. Market lookup attaches
@@ -487,5 +487,33 @@ history privacy checks, exact archive membership, real unchanged natural-languag
 questions and responsive market interactions. Review not selected. Publication
 remains operator-only. A feature-branch candidate is not a merged release or a
 published package; the final manifest must identify the accepted source commit.
-Preserve the superseded unpublished archive before creating the final 0.1.16
-candidate. Only the archive matching the final manifest is a publication target.
+The final 0.1.16 archive was frozen from landed source. Superseded unpublished
+candidates are preserved. Only the archive matching its final manifest was a
+publication target.
+
+The operator published 0.1.16 on October 20, 2026. Its registry archive matched
+the frozen manifest and all 101 installed package members. Live acceptance
+found the agent-context omission addressed in 0.1.17 below. The published
+archive remains immutable.
+
+## Release candidate: 0.1.17
+
+After a price refresh saved a full-balance DEX quote, chat could report that no
+estimate existed while the UI displayed it. Detailed agent facts now include
+the same validated `sell_out` projection used by the UI. Compact holdings pages
+retain quote presence and defer the detailed output to a scoped token read.
+The separate legacy Mint Club burn field does not represent every sale route.
+
+Output amounts, quote and price observation times, reference valuations, gas
+exclusions and execution caveats stay intact. Wrong-wallet caches, partial
+inputs and testnet positions remain excluded. Independent wallet estimates
+sharing liquidity cannot be added into portfolio proceeds. This change adds
+no provider calls or quote calculations.
+
+Acceptance includes the full repository suite, clean installation, tracked and
+history privacy checks, and exact archive membership. An isolated exact package
+using the same saved records, model settings, prior conversation and unchanged
+question returned the recorded DEX output and reference valuation without
+starting provider jobs. Product acceptance applies only to identical product
+bytes. Review not selected. Freeze the final archive from the landed source
+and dry-run that archive. npm publication remains operator-only.

package/kira_agent.py

@@ -32,7 +32,8 @@ SYSTEM = ('You are Kira, a careful wallet research partner. Answer in the langua
     'Use token_read before judging or retracting market details when pools are omitted. Testnet assets are excluded from portfolio valuation; do not infer a zero market price. '
     'Use holdings_query search for token names or symbols, rank for top-N, and aggregate for counts and sums. These scan every approved saved holding on the host and return bounded results. Never page through inventories for ranking, counting or named-token questions. Use one search per named token, optionally chain-filtered. Report same-symbol ambiguity with chain and contract. Rank group_by asset combines the priced subset by identity; group_by position ranks wallet positions. Unknown prices are excluded from ranks and counted separately. '
     'assets_omitted and next_offset describe a page, not missing holdings. Use wallet_read with offset and limit for more holdings, and token_read for detailed evidence. '
-    'Compact pages defer exit_quote and curve details. exit_quote_recorded true means a validated historical quote exists in the record even if its output is omitted here. Use token_read before judging execution evidence or claiming that a quote is absent. False means no validated quote in this snapshot, not that no exit route exists. '
+    'Compact pages defer sell_out, exit_quote and curve details. exit_quote_recorded true means a validated saved full-balance quote exists, including cached DEX quotes, even if its output is omitted here. Use token_read before judging execution evidence or claiming that a quote is absent. False means no validated quote in these records, not that no exit route exists. '
+    'sell_out is the same saved full-balance estimate shown in the wallet UI. exit_quote is the separate Mint Club burn record; a null exit_quote does not invalidate a sell_out quote. Preserve sell_out output amount, token, quote time, output_price time, valuation and gas/execution flags. Its value_usd is a reference valuation of the received token, not verified dollar sale proceeds. reserve_reference values only the burn output; terminal_reference uses a recorded terminal route. Neither guarantees execution. Keep estimates per wallet and never sum independent quotes using shared liquidity. '
     'Only an unfiltered complete inventory needs every holdings page. For that request, follow next_offset for each approved wallet using limit 100 and state which pages remain unread if the budget prevents completion. '
     'A question about a specific token or native asset across all wallets or networks is a filtered query. token_read already returns that asset across every approved wallet, including saved native observations. Do not enumerate unrelated wallet inventory pages for a token-specific question. Inventory pages defer curve and exit details to token_read. '
     'For USD-threshold questions, pass minimum_value_usd to token_read. Use the exact returned position_count, including the combined records_read count, rather than counting rows yourself. Unpriced and outside-USD positions are reported separately, not valued at zero. '
@@ -364,7 +365,8 @@ def wallet_facts(wallets, *, pool_budget=40_000):
             if item['archived']:item['historical_value_usd']=asset.get('historical_value_usd')
             item['price'] = pick(asset['price'],('usd','basis','quality','observed_at')) if asset.get('price') else None
             item['exit_quote'] = asset.get('exit_quote')
-            item['exit_quote_recorded'] = asset.get('exit_quote') is not None
+            item['sell_out'] = asset.get('sell_out')
+            item['exit_quote_recorded'] = item['exit_quote'] is not None or item['sell_out'] is not None
             item['exit_route'] = asset.get('exit_route')
             item['markets'] = asset.get('links',[])
             pools=asset.get('market_pools',[]);item['pools']=[];item['pools_recorded']=len(pools)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kira-wallet",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Manage your wallets with your own AI. Track tokens, research markets and refresh holdings in a local workspace.",
   "license": "MIT",
   "private": false,