plasalid 0.2.0

package/LICENSE

@@ -0,0 +1,213 @@
+"Commons Clause" License Condition v1.0
+
+The Software is provided to you by the Licensor under the License, as defined
+below, subject to the following condition.
+
+Without limiting other conditions in the License, the grant of rights under
+the License will not include, and the License does not grant to you, the right
+to Sell the Software.
+
+For purposes of the foregoing, "Sell" means practicing any or all of the
+rights granted to you under the License to provide to third parties, for a fee
+or other consideration (including without limitation fees for hosting or
+consulting/support services related to the Software), a product or service
+whose value derives, entirely or substantially, from the functionality of the
+Software. Any license notice or attribution required by the License must also
+include this Commons Clause License Condition notice.
+
+Software:  Plasalid
+License:   Apache License, Version 2.0
+Licensor:  Phureewat A
+
+----------------------------------------------------------------------
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may accept Support,
+      Warranty, Indemnity, or other liability obligations and/or rights
+      consistent with this License. However, in accepting such obligations,
+      You may only act on Your own behalf and on Your sole responsibility,
+      not on behalf of any other Contributor, and only if You agree to
+      indemnify, defend, and hold each Contributor harmless for any
+      liability incurred by, or claims asserted against, such Contributor
+      by reason of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Phureewat A
+
+   Licensed under the Apache License, Version 2.0 (the "License") with the
+   Commons Clause License Condition v1.0 as stated above; you may not use
+   this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,176 @@
+<h1 align="center">Plasalid</h1>
+
+<p align="center">
+  <strong>Talk to your money</strong>
+</p>
+
+<p align="center">
+  A local-first AI that reads every line of your transactions and coaches you the best move.
+</p>
+
+
+<br />
+
+Plasalid lets you actually *talk* to your money. Drop the bank and credit-card statements you already receive into a folder; Plasalid scans them into a queryable, double-entry database on your own machine. Then chat with it — an AI partner that has read every line and tells you, sharply and proactively, what's going on with your money. Local, private, yours.
+
+Plasalid exists because in markets like Thailand there's no Plaid: bank data is locked behind statement PDFs, and most people can't afford a real financial advisor either. Plasalid closes both gaps. Your statements become a database, and an AI that knows that database becomes the money coach you'd otherwise have to hire. Your machine, your encryption key, your data.
+
+In Thailand, personal finance isn't taught in school. Fee-based advisors are out of reach for most households. The loudest "advice" channels are bank salespeople pitching their employer's products. Over 5 million people are already flagged as non-performing borrowers, and a generation that wants to manage money better has nowhere accessible to learn how. Plasalid's bet is that capable AI changes this — the same intelligence that can read a statement can also explain what the numbers mean, surface what's about to go wrong, and coach someone through real decisions about debt, budget, and savings. At zero marginal cost, in your language, on your own machine.
+
+Plasalid can also scales upward in case financial survival isn't your question — help you setup a goal for vacation trip, building an emergency fund, choosing investments, planning a down payment or retirement, working toward the freedom to walk away from a bad job. From getting out of debt to financial freedom, Plasalid grows with you.
+
+## Features
+
+### Your personal money coach
+
+- **Sees every balance, every transaction** — Plasalid's chat reads from your bank and credit-card statements, not generic categories. "Where did ฿14k go in March?" gets a specific answer.
+- **Sharp and proactive** — Leads with the insight, not the breakdown. Flags concerning patterns (overdraft trajectory, unusual spending, payments due soon) even if you didn't ask.
+- **Has a point of view** — When you ask "what should I do?", you get a recommendation, not a list of options.
+- **Remembers what matters** — Persists biographical context (family, employer, goals) and per-statement scanning hints across sessions, so each conversation starts smarter than the last.
+
+### A data harness AI can plug into
+
+- **The missing aggregator** — In markets without Plaid, there's no bank API that easy to access. Plasalid turns the documents you already receive into a database that machine can read, so the data layer stops being the blocker.
+- **Composable substrate** — Plasalid's local SQLite is plain, queryable double-entry data. Any tool that can read SQLite — Claude Code, MCP servers, your own scripts, dashboards — can build automations, alerts, exporters, or personalized analyses on top, with no further integration work.
+- **No vendor lock, no rate limits** — Standard accounts and journal lines, your encryption key, your machine. Nothing to revoke, throttle, or paywall.
+- **BYO model** — Pick Anthropic (Claude) or any OpenAI-compatible server (Ollama, OpenAI, LM Studio, vLLM, …) at setup time. Local models keep the conversation 100% on your machine.
+
+### Drop documents in, get structured data out
+
+- **Encrypted PDFs handled inline** — Statement password-protected? Plasalid prompts you once, then remembers the password (encrypted at rest) under a filename pattern so the next month's statement unlocks silently.
+- **Asks instead of guessing** — Ambiguous row? The scanner pauses and prompts you.
+- **Idempotent scan** — Files are hashed; re-running `plasalid scan` skips what it already scanned. `--force` cascade-deletes prior records before re-scanning.
+- **Learns your statements** — Per-bank scanning hints persist across runs (the AI saves them in a local memory table) so each new statement scans more accurately than the last.
+
+### Correctness, not vibes
+
+- **Double-entry bookkeeping** — Every transaction balances enforced by standard double-entry accounting.
+- **Account metadata preserved** — Bank, masked number, statement day, due day, points.
+- **Dates normalized** — ISO Gregorian; Buddhist-Era dates converted automatically.
+- **Reconcile pass** — `plasalid reconcile` surfaces duplicate entries, similar accounts, and unused accounts; merges, renames, and deletes happen only after explicit confirmation. `--dry-run` previews without writing.
+
+### Your data never leaves your machine
+
+- **Encrypted local database** — All data stays on your machine in an AES-256 encrypted SQLite database.
+- **PII masking** — Names, national IDs, phones, full account/card numbers scrubbed before anything reaches the AI.
+- **No telemetry. No analytics.** Only outbound traffic is to your configured AI provider.
+
+
+## Install
+
+```bash
+npm install -g plasalid
+```
+
+Requires Node ≥ 18.
+
+## Quick Start
+
+```bash
+plasalid setup
+```
+
+Then:
+
+1. Drop any PDFs anywhere under `~/.plasalid/data/`. Subfolders are allowed but not interpreted — the AI infers account type from the document.
+2. Run `plasalid scan` and answer any clarifying questions inline.
+3. Run `plasalid` to chat with what was scanned.
+
+Other day-to-day commands:
+
+- `plasalid scan <regex>` — only scan files whose path matches the regex.
+- `plasalid scan <regex> --force` — re-scan matching files (replaces prior records).
+- `plasalid reconcile --dry-run` — periodically surface duplicate entries and similar accounts; re-run without `--dry-run` to apply fixes interactively.
+- `plasalid revert <regex>` — delete scanned files matching the regex and every journal entry derived from them.
+
+## Commands
+
+Run `plasalid --help` to see all available commands.
+
+```bash
+plasalid                            # Interactive TUI chat with your local data
+plasalid setup                      # Configure API key, encryption, and data directory
+plasalid data                       # Open the Plasalid data folder in your OS file explorer
+plasalid accounts                   # Show the chart of accounts with balances
+plasalid status                     # Net worth and this-month income/expense totals
+plasalid transactions               # List journal lines (filter by --account, --from, --to, --query, --limit)
+plasalid scan [regex] [--force]     # Scan new PDFs; --force cascade-deletes prior records before re-scanning
+plasalid revert <regex>             # Delete scanned files matching <regex> and their journal entries
+plasalid reconcile [--dry-run]      # Review the journal: duplicates, similar accounts, unused accounts (--account, --from, --to also accepted)
+```
+
+## How It Works
+
+```
+  Bank statements · Credit-card statements
+                  │
+             (drop PDFs)
+                  │
+       ┌──────────▼──────────┐
+       │  ~/.plasalid/data/  │
+       └──────────┬──────────┘
+                  │
+             plasalid scan
+                  │
+       Claude API (PII-redacted)
+                  │
+       ┌──────────▼──────────┐
+       │     Encrypted DB    │◀──── plasalid reconcile
+       └──────────┬──────────┘       
+                  │                   
+        plasalid · chat               
+```
+
+Two outbound calls: the AI provider during scan, and the AI provider during chat. Both are PII-redacted. Your financial data is never stored off your machine. No telemetry. No analytics.
+
+## Security & Privacy
+
+- All financial data stored locally in `~/.plasalid/db.sqlite`
+- Database encrypted with AES-256 (libsql)
+- Config file stored with `0600` permissions
+- PII redacted before sending to any AI provider
+- Encrypted-PDF passwords are AES-GCM-encrypted inside `db.sqlite` under a filename pattern; never written to disk in plaintext.
+- Only outbound traffic is to your configured AI provider
+
+## Configuration
+
+Plasalid stores everything in `~/.plasalid/`:
+
+```
+~/.plasalid/
+  config.json          # API keys and preferences (0600 permissions)
+  context.md           # Persistent personal context
+  db.sqlite            # Encrypted SQLite database
+  data/                # Drop any PDFs here (subfolders allowed; AI classifies)
+```
+
+`db.sqlite` holds the journal, chart of accounts, scan history, persisted long-term memories, and AES-GCM-encrypted PDF passwords keyed by filename pattern. Everything is wrapped in libsql's AES-256 page encryption.
+
+### Environment Variables
+
+```bash
+ANTHROPIC_API_KEY=            # Anthropic API key (required when provider is anthropic)
+PLASALID_MODEL=               # Model name; default for Anthropic: claude-sonnet-4-6
+PLASALID_PROVIDER=            # anthropic | openai-compatible. Default: anthropic
+OPENAI_COMPATIBLE_BASE_URL=   # e.g. http://localhost:11434/v1 (Ollama)
+OPENAI_COMPATIBLE_API_KEY=    # API key for the OpenAI-compatible server (often unused)
+PLASALID_DB_ENCRYPTION_KEY=   # DB encryption passphrase
+PLASALID_DB_PATH=             # Default: ~/.plasalid/db.sqlite
+PLASALID_DATA_DIR=            # Default: ~/.plasalid/data
+```
+
+## Contributing
+
+```bash
+git clone https://github.com/phureewat29/plasalid
+cd plasalid
+npm install
+npm run build
+npm link # makes 'plasalid' available globally
+```
+
+## License
+
+Plasalid is released under the [Apache License 2.0 with the Commons Clause](./LICENSE).
+
+You're free to use, copy, modify, distribute, and fork it. The Commons Clause adds one restriction: **you may not Sell the Software** — that is, you may not provide a paid product or service whose value derives entirely or substantially from Plasalid's functionality (including paid hosting or support). For commercial-resale rights, contact the copyright holder to negotiate a separate license.

package/dist/accounts/taxonomy.d.ts

@@ -0,0 +1,31 @@
+export type AccountType = "asset" | "liability" | "income" | "expense" | "equity";
+export type InstitutionKind = "bank" | "card_issuer" | "wallet" | "payment_rail" | "broker" | "crypto_exchange" | "insurer" | "gov" | "telco" | "utility";
+export interface ThaiInstitution {
+    code: string;
+    label: string;
+    kind: InstitutionKind;
+    /** Optional disambiguating note for the AI (mergers, rebrands, regulatory status). */
+    notes?: string;
+}
+export declare const THAI_BANKS: ThaiInstitution[];
+export declare const THAI_CARD_ISSUERS: ThaiInstitution[];
+export declare const THAI_WALLETS: ThaiInstitution[];
+export declare const THAI_PAYMENT_RAILS: ThaiInstitution[];
+export declare const THAI_BROKERS: ThaiInstitution[];
+export declare const THAI_CRYPTO_EXCHANGES: ThaiInstitution[];
+export declare const THAI_INSURERS: ThaiInstitution[];
+export declare const THAI_GOV: ThaiInstitution[];
+export declare const THAI_UTILITIES: ThaiInstitution[];
+export declare const THAI_TELCOS: ThaiInstitution[];
+export declare const ALL_THAI_INSTITUTIONS: ThaiInstitution[];
+export declare const ACCOUNT_TYPE_DESCRIPTIONS: Record<AccountType, string>;
+export declare const SUGGESTED_ASSET_SUBTYPES: string[];
+export declare const SUGGESTED_LIABILITY_SUBTYPES: string[];
+export declare const SUGGESTED_EXPENSE_SUBTYPES: string[];
+export declare const SUGGESTED_INCOME_SUBTYPES: string[];
+/**
+ * Stringified Thai taxonomy block for the scan/reconcile system prompts.
+ * Lists known Thai institutions and suggested subtypes so the model picks
+ * consistent `bank_name` and `subtype` values across statements.
+ */
+export declare function getThaiTaxonomyHint(): string;

package/dist/accounts/taxonomy.js

@@ -0,0 +1,189 @@
+export const THAI_BANKS = [
+    { code: "KBANK", label: "Kasikornbank", kind: "bank" },
+    { code: "SCB", label: "Siam Commercial Bank", kind: "bank" },
+    { code: "BBL", label: "Bangkok Bank", kind: "bank" },
+    { code: "KTB", label: "Krungthai Bank", kind: "bank", notes: "State-owned." },
+    { code: "BAY", label: "Krungsri (Bank of Ayudhya)", kind: "bank" },
+    { code: "TTB", label: "TMBThanachart Bank", kind: "bank", notes: "Result of TMB + Thanachart merger." },
+    { code: "UOB-TH", label: "UOB Thailand", kind: "bank", notes: "Absorbed Citi Thailand's consumer banking (incl. cards) in Nov 2022." },
+    { code: "CIMB-TH", label: "CIMB Thai", kind: "bank" },
+    { code: "GHB", label: "Government Housing Bank", kind: "bank", notes: "State-owned, mortgage focus." },
+    { code: "GSB", label: "Government Savings Bank", kind: "bank", notes: "State-owned." },
+    { code: "LH-BANK", label: "Land and Houses Bank", kind: "bank" },
+    { code: "KKP", label: "Kiatnakin Phatra Bank", kind: "bank", notes: "Merged 2020 from KK + Phatra." },
+    { code: "TISCO", label: "TISCO Bank", kind: "bank" },
+    { code: "IBT", label: "Islamic Bank of Thailand", kind: "bank", notes: "State-owned; serves all customers." },
+    { code: "ICBC-TH", label: "ICBC (Thai)", kind: "bank", notes: "Subsidiary of ICBC China." },
+    { code: "BAAC", label: "Bank for Agriculture and Agricultural Cooperatives", kind: "bank", notes: "State-owned, rural finance." },
+];
+export const THAI_CARD_ISSUERS = [
+    { code: "KTC", label: "Krungthai Card", kind: "card_issuer", notes: "Listed subsidiary of KTB." },
+    { code: "AEON", label: "AEON Thana Sinsap", kind: "card_issuer" },
+    { code: "FIRSTCHOICE", label: "Krungsri First Choice", kind: "card_issuer" },
+    { code: "CITI-TH", label: "Citibank Thailand", kind: "card_issuer", notes: "Consumer cards migrated to UOB-TH in Nov 2022; only historical statements still reference Citi." },
+    { code: "AMEX-TH", label: "American Express Thailand", kind: "card_issuer" },
+    { code: "CARDX", label: "CardX", kind: "card_issuer", notes: "SCB X consumer-card spinoff; issues cards previously branded SCB." },
+    { code: "DINERS", label: "Diners Club Thailand", kind: "card_issuer" },
+    { code: "UOB-TH", label: "UOB Thailand (Cards)", kind: "card_issuer", notes: "Same legal entity as the bank UOB-TH; now issues both its own card line (UOB Yolo, UOB Premier) and the migrated Citi consumer cards." },
+];
+export const THAI_WALLETS = [
+    { code: "TRUEMONEY", label: "TrueMoney Wallet", kind: "wallet" },
+    { code: "LINEPAY", label: "Rabbit LINE Pay", kind: "wallet" },
+    { code: "SHOPEEPAY", label: "ShopeePay", kind: "wallet" },
+    { code: "GRABPAY", label: "GrabPay (Thailand)", kind: "wallet" },
+    { code: "DOLFIN", label: "Dolfin Wallet", kind: "wallet", notes: "Central Group + JD.com joint venture." },
+    { code: "MPAY", label: "mPay", kind: "wallet", notes: "AIS-operated." },
+    { code: "PAOTANG", label: "Paotang", kind: "wallet", notes: "Krungthai-operated; government-benefits and tax e-wallet." },
+];
+export const THAI_PAYMENT_RAILS = [
+    { code: "PROMPTPAY", label: "PromptPay", kind: "payment_rail", notes: "National 24/7 interbank rail; appears on transfer slips, not an issuer." },
+];
+export const THAI_BROKERS = [
+    { code: "INNOVESTX", label: "InnovestX Securities", kind: "broker", notes: "Former SCBS; SCBX subsidiary." },
+    { code: "BLS", label: "Bualuang Securities", kind: "broker", notes: "BBL subsidiary." },
+    { code: "KS", label: "Kasikorn Securities", kind: "broker", notes: "KBANK subsidiary." },
+    { code: "KGI-TH", label: "KGI Securities (Thailand)", kind: "broker" },
+    { code: "MAYBANK-SEC", label: "Maybank Securities (Thailand)", kind: "broker" },
+    { code: "ASP", label: "Asia Plus Securities", kind: "broker" },
+    { code: "TISCO-SEC", label: "TISCO Securities", kind: "broker" },
+    { code: "KSS", label: "Krungsri Securities", kind: "broker", notes: "BAY subsidiary." },
+    { code: "KKPS", label: "Kiatnakin Phatra Securities", kind: "broker", notes: "KKP subsidiary." },
+    { code: "LH-SEC", label: "Land and Houses Securities", kind: "broker" },
+    { code: "FINANSIA", label: "Finansia Syrus Securities", kind: "broker" },
+    { code: "YUANTA-TH", label: "Yuanta Securities (Thailand)", kind: "broker" },
+    { code: "DBSVICKERS", label: "DBS Vickers Securities (Thailand)", kind: "broker" },
+    { code: "KTBST", label: "Krungthai Xspring Securities", kind: "broker", notes: "Formerly KTBST; KTB-affiliated." },
+];
+export const THAI_CRYPTO_EXCHANGES = [
+    { code: "BITKUB", label: "Bitkub Exchange", kind: "crypto_exchange", notes: "SEC-licensed; dominant market share." },
+    { code: "UPBIT-TH", label: "Upbit Thailand", kind: "crypto_exchange", notes: "SEC-licensed; subsidiary of South Korean Upbit." },
+    { code: "ORBIX", label: "Orbix Trade", kind: "crypto_exchange", notes: "Former Satang Pro; rebranded under KBank ownership." },
+    { code: "GULF-BINANCE", label: "Binance Thailand (Gulf Binance)", kind: "crypto_exchange", notes: "Binance + Gulf Innova JV; SEC-licensed." },
+    { code: "KUCOIN-TH", label: "KuCoin Thailand", kind: "crypto_exchange", notes: "Former ERX; rebranded 2025 after KuCoin acquisition." },
+    { code: "WAANX", label: "WaanX", kind: "crypto_exchange", notes: "SEC-licensed." },
+    { code: "TDX", label: "Thai Digital Assets Exchange", kind: "crypto_exchange", notes: "SET Group subsidiary." },
+    { code: "GMO-Z-EX", label: "Z.com EX (GMO-Z.com)", kind: "crypto_exchange", notes: "Japanese GMO subsidiary." },
+    { code: "ZIPMEX", label: "Zipmex", kind: "crypto_exchange", notes: "Defunct since Nov 2023; statements only appear in historical files." },
+];
+export const THAI_INSURERS = [
+    // Life
+    { code: "AIA-TH", label: "AIA Thailand", kind: "insurer", notes: "Life; market leader." },
+    { code: "MUANG-THAI-LIFE", label: "Muang Thai Life Insurance", kind: "insurer", notes: "Life." },
+    { code: "THAI-LIFE", label: "Thai Life Insurance", kind: "insurer", notes: "Life; listed (TLI)." },
+    { code: "FWD-TH", label: "FWD Thailand", kind: "insurer", notes: "Life." },
+    { code: "ALLIANZ-AYUDHYA-LIFE", label: "Allianz Ayudhya Assurance", kind: "insurer", notes: "Life; Allianz + BAY JV." },
+    { code: "KTAXA", label: "Krungthai-AXA Life", kind: "insurer", notes: "Life; KTB + AXA JV." },
+    { code: "BANGKOK-LIFE", label: "Bangkok Life Assurance", kind: "insurer", notes: "Life." },
+    { code: "CHUBB-SAMAGGI", label: "Chubb Samaggi Insurance", kind: "insurer", notes: "Life and non-life." },
+    { code: "GENERALI-TH", label: "Generali Thailand", kind: "insurer", notes: "Life." },
+    // Non-life
+    { code: "DHIPAYA", label: "Dhipaya Insurance", kind: "insurer", notes: "Non-life." },
+    { code: "BANGKOK-INS", label: "Bangkok Insurance", kind: "insurer", notes: "Non-life." },
+    { code: "ALLIANZ-AYUDHYA-GENERAL", label: "Allianz Ayudhya General Insurance", kind: "insurer", notes: "Non-life." },
+    { code: "VIRIYAH", label: "Viriyah Insurance", kind: "insurer", notes: "Non-life; #1 motor insurer." },
+    { code: "TOKIO-MARINE", label: "Tokio Marine (Thailand)", kind: "insurer", notes: "Non-life." },
+];
+export const THAI_GOV = [
+    { code: "REVDEPT", label: "Revenue Department (กรมสรรพากร)", kind: "gov", notes: "Income tax, VAT, excise." },
+    { code: "SSO", label: "Social Security Office (สำนักงานประกันสังคม)", kind: "gov", notes: "Employee + self-employed social security contributions." },
+    { code: "BOT", label: "Bank of Thailand", kind: "gov", notes: "Central bank; rarely on consumer statements outside of regulatory letters." },
+    { code: "MOF", label: "Ministry of Finance", kind: "gov" },
+    { code: "LDT", label: "Department of Lands (กรมที่ดิน)", kind: "gov", notes: "Land registration, property tax." },
+    { code: "CUSTOMS", label: "Customs Department (กรมศุลกากร)", kind: "gov", notes: "Import/export duties." },
+];
+export const THAI_UTILITIES = [
+    { code: "MEA", label: "Metropolitan Electricity Authority (กฟน.)", kind: "utility", notes: "Electricity for Bangkok, Nonthaburi, Samut Prakan." },
+    { code: "PEA", label: "Provincial Electricity Authority (กฟภ.)", kind: "utility", notes: "Electricity for the rest of Thailand outside MEA's area." },
+    { code: "MWA", label: "Metropolitan Waterworks Authority (กปน.)", kind: "utility", notes: "Water for Bangkok, Nonthaburi, Samut Prakan." },
+    { code: "PWA", label: "Provincial Waterworks Authority (กปภ.)", kind: "utility", notes: "Water for the rest of Thailand." },
+    { code: "EGAT", label: "Electricity Generating Authority of Thailand (กฟผ.)", kind: "utility", notes: "Power generation; rarely appears on consumer bills directly." },
+];
+export const THAI_TELCOS = [
+    { code: "AIS", label: "Advanced Info Service (AIS)", kind: "telco" },
+    { code: "TRUE-CORP", label: "True Corporation", kind: "telco", notes: "Merged entity of True + dtac since March 2023." },
+    { code: "TRUEMOVE", label: "TrueMove H", kind: "telco", notes: "Brand retained under TRUE-CORP per NBTC ruling." },
+    { code: "DTAC", label: "dtac", kind: "telco", notes: "Brand retained under TRUE-CORP per NBTC ruling." },
+    { code: "NT", label: "National Telecom (NT)", kind: "telco", notes: "Former TOT; state-owned, minimal consumer presence." },
+];
+export const ALL_THAI_INSTITUTIONS = [
+    ...THAI_BANKS,
+    ...THAI_CARD_ISSUERS,
+    ...THAI_WALLETS,
+    ...THAI_PAYMENT_RAILS,
+    ...THAI_BROKERS,
+    ...THAI_CRYPTO_EXCHANGES,
+    ...THAI_INSURERS,
+    ...THAI_GOV,
+    ...THAI_TELCOS,
+    ...THAI_UTILITIES,
+];
+export const ACCOUNT_TYPE_DESCRIPTIONS = {
+    asset: "Bank accounts, cash, prepaid wallets, receivables.",
+    liability: "Credit cards, loans, mortgages, money the user owes.",
+    income: "Salary, side income, dividends, refunds.",
+    expense: "Spending categories (food, transport, utilities, etc.).",
+    equity: "Owner's equity / opening balance equity (for reconciliation).",
+};
+export const SUGGESTED_ASSET_SUBTYPES = [
+    "bank",
+    "cash",
+    "wallet",
+    "prepaid_card",
+    "brokerage",
+    "crypto",
+    "receivable",
+];
+export const SUGGESTED_LIABILITY_SUBTYPES = [
+    "credit_card",
+    "home_loan",
+    "auto_loan",
+    "personal_loan",
+    "student_loan",
+    "revolving",
+    "deferred_income",
+];
+export const SUGGESTED_EXPENSE_SUBTYPES = [
+    "food",
+    "transport",
+    "utilities",
+    "rent",
+    "housing",
+    "healthcare",
+    "entertainment",
+    "shopping",
+    "subscriptions",
+    "education",
+    "travel",
+    "fees_and_interest",
+    "tax",
+    "insurance",
+    "other",
+];
+export const SUGGESTED_INCOME_SUBTYPES = [
+    "salary",
+    "bonus",
+    "freelance",
+    "interest",
+    "dividend",
+    "refund",
+    "other",
+];
+/**
+ * Stringified Thai taxonomy block for the scan/reconcile system prompts.
+ * Lists known Thai institutions and suggested subtypes so the model picks
+ * consistent `bank_name` and `subtype` values across statements.
+ */
+export function getThaiTaxonomyHint() {
+    const institutions = ALL_THAI_INSTITUTIONS
+        .map(i => `${i.code} (${i.label}, ${i.kind})${i.notes ? ` — ${i.notes}` : ""}`)
+        .join("\n");
+    return [
+        `Known Thai institutions:`,
+        institutions,
+        ``,
+        `Suggested asset subtypes: ${SUGGESTED_ASSET_SUBTYPES.join(", ")}`,
+        `Suggested liability subtypes: ${SUGGESTED_LIABILITY_SUBTYPES.join(", ")}`,
+        `Suggested expense subtypes: ${SUGGESTED_EXPENSE_SUBTYPES.join(", ")}`,
+        `Suggested income subtypes: ${SUGGESTED_INCOME_SUBTYPES.join(", ")}`,
+    ].join("\n");
+}

package/dist/ai/agent.d.ts

@@ -0,0 +1,43 @@
+import type Database from "libsql";
+import { type ScanPromptOptions, type ReconcilePromptOptions } from "./system-prompt.js";
+import { type AgentExecutionContext } from "./tools/index.js";
+import type { NormalizedMessage } from "./provider.js";
+export type ProgressCallback = (event: {
+    phase: "tool" | "responding";
+    toolName?: string;
+    toolCount: number;
+    elapsedMs: number;
+}) => void;
+export declare class AbortedError extends Error {
+    constructor();
+}
+/**
+ * Conversational chat used by the Ink TUI. Reuses conversation_history for context
+ * continuity, redacts PII on the way out, restores it on the way in for display.
+ */
+export declare function handleChatMessage(db: Database.Database, userMessage: string, onProgress?: ProgressCallback, signal?: AbortSignal): Promise<string>;
+/**
+ * Scan-time agent loop. Caller supplies the initial user message (which carries
+ * the PDF as a content block) and a AgentExecutionContext that scopes the file
+ * id, scanner version, and interactivity for ask_user.
+ */
+export declare function runScanAgent(opts: {
+    db: Database.Database;
+    initialMessages: NormalizedMessage[];
+    prompt: ScanPromptOptions;
+    agentCtx: AgentExecutionContext;
+    onProgress?: ProgressCallback;
+    signal?: AbortSignal;
+}): Promise<string>;
+/**
+ * Reconcile-time agent loop. Walks the existing journal with the reconcile
+ * tool profile (read tools + write/merge/delete primitives).
+ */
+export declare function runReconcileAgent(opts: {
+    db: Database.Database;
+    initialMessages: NormalizedMessage[];
+    prompt: ReconcilePromptOptions;
+    agentCtx: AgentExecutionContext;
+    onProgress?: ProgressCallback;
+    signal?: AbortSignal;
+}): Promise<string>;