The model / The tools

Money has structure.
Keep the structure.

A household is more than a list of balances. Model the owners, the assets, the liabilities, and their changes over time.

Concrete household shapes

Simple to start.
Room for the real picture.

These diagrams show model capabilities. They contain no real household records. Use aliases and opaque IDs for people and accounts.

Five parts. One model.

Keep a fact’s meaning
with the fact.

Dated ownership lets the model follow a change of owners. It keeps corporation ownership and trust roles distinct. The household total counts a value one time.

THINGS

Entities & accounts

People, corporations, and trusts. Cash, investment accounts, property, private businesses, debt, and other assets.

STATES

Values & holdings

A dated account value or end-of-day instrument quantity. An investment account uses a total or holdings valuation.

FLOWS

Transactions

Income, expense, transfer, buy, and sell. A transfer pair keeps movement separate from income.

EXPECTATIONS

What you expect

Income sources carry expected amounts, periods, and recipients. The model keeps expected income separate from actual reports.

REPORTS

What you record

Gross income and tax withheld for an inclusive period. An asset source returns dated owner shares with the full source amount.

Kept current in the background

Connected banks.
Dated market facts.

Canada and the United States.

Bank connections

Plaid connects chequing and savings, credit cards, lines of credit, loans, and mortgages. Imports run every six hours and on each bank webhook.

Investments

You or your agent record trades, holdings, or one account total. Sightline prices public instruments from market data.

Daily facts

Daily public instrument and index closes. Daily exchange rates. Currency conversion and daily net worth with history.

Honest totals

Results identify incomplete, stale, or estimated data. They state the effective scope. A restricted total covers only permitted records.

Your calculations

The agent or app calculates returns, taxes, budgets, and other results. Sightline supplies two skills: account setup and a Canadian income tax estimate that the agent executes.

The complete public surface

32 tools.
19 read. 13 write.

Every agent and app uses this contract. The grant controls which tools and records it can use. Search the tool names or descriptions.

32 tools · 19 read · 13 write

FULL = full detail required

Start & household

Read the setup skill, household state, and available instructions.

Read household currency, counts, and data freshness within scope.

Read net worth, history, components, and completeness within scope.

Entities & ownership

Represent people, corporations, trusts, and their dated relationships.

Create a person, corporation, or trust after a check for duplicates.

Accounts & banks

Read accounts, record values, and check bank import status.

List accounts with owners, selected values, and data freshness.

Create a manual account with an optional first dated value.

Change account details, valuation mode, or dated owners.

Holdings, prices & currency

Record investment state and read public prices and exchange rates.

List dated holdings, prices, and account total comparisons.

Record an instrument quantity or cash amount at the end of a date.

Transactions

Keep income, expense, transfer, buy, and sell flows distinct.

List ledger records with account, entity, date, type, and category filters.

Income expectations & reports

Separate expected amounts from actual gross income and tax withheld.

Create or change an income source and its expected amounts.

Record removal

Remove manual records within the write scope of the grant.

Delete a manual record and retain its prior values in the change log.