@slothmoney/agent-cli 0.19.0 → 0.21.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.21.0 - 2026-08-28
+
+- Add `scenarios` commands to list, create, update, activate, and delete the
+  month-anchored choices used by Goal forecasts.
+- Preview every scenario change against Sloth's canonical planner with zero
+  writes; `--apply` remains the explicit write boundary.
+- Create the common No/Yes choice directly, support recurring and one-off
+  account contributions, and return the recalculated Goal roadmap.
+
+## 0.20.0 - 2026-08-27
+
+- Add `portfolio` views for personal, partner-shared, and combined household
+  savings and investments.
+- Add account-level partner visibility updates for private, balance-only, and
+  balance-and-holdings sharing.
+- Keep portfolio results strict, machine-readable, and explicit about refresh
+  status and excluded currencies.
+
 ## 0.19.0 - 2026-08-26
 
 - Make every Goal use one explicit personal Goal-funding account and expose

package/README.md

@@ -1,6 +1,6 @@
 # Sloth Agent CLI
 
-Use your own agent to inspect accounts, investments, and budgets, manage goals, move assigned budget money, update planned amounts, categorise transactions, and configure payment notifications through the
+Use your own agent to inspect personal and household accounts, investments, and budgets, manage goals and forecast scenarios, move assigned budget money, update planned amounts, categorise transactions, and configure payment notifications through the
 [Sloth Money Agent API](https://slothmoney.app/developers/).
 
 ## Install
@@ -15,7 +15,7 @@ sloth-agent --version
 For a one-off pinned run:
 
 ```bash
-npm exec --yes --package=@slothmoney/agent-cli@0.17.0 -- sloth-agent --help
+npm exec --yes --package=@slothmoney/agent-cli@0.21.0 -- sloth-agent --help
 ```
 
 ## Authenticate
@@ -24,10 +24,10 @@ Create a personal access token in Sloth Money under
 **Settings > Developer access**, then choose the authentication method for
 where the CLI runs.
 
-New tokens are view-only. That is enough for `auth status`, `accounts`, `investments`,
-`budget`, `categories`, `transactions`, and `goals` list. Enable **Allow changes** when
+New tokens are view-only. That is enough for `auth status`, `accounts`, `investments`, `portfolio`,
+`budget`, `categories`, `transactions`, `goals`, and `scenarios` list. Enable **Allow changes** when
 creating the token only if the CLI must apply assignments, manage categories
-or line items, move assigned budget money, update planned budgets, manage accounts, ask a partner for an explanation, or manage goals. Token
+or line items, move assigned budget money, update planned budgets, manage accounts, ask a partner for an explanation, or manage goals and scenarios. Token
 permissions cannot be changed later - revoke and reissue the token instead.
 
 ### Local computer
@@ -103,6 +103,7 @@ options, output, and examples. For example:
 ```bash
 sloth-agent auth login --help
 sloth-agent accounts --help
+sloth-agent portfolio --help
 sloth-agent budget --help
 sloth-agent budget status --help
 sloth-agent budget update --help
@@ -121,6 +122,9 @@ sloth-agent goals create --help
 sloth-agent goals update --help
 sloth-agent goals mark-spent --help
 sloth-agent goals restore --help
+sloth-agent scenarios create --help
+sloth-agent scenarios update --help
+sloth-agent scenarios activate --help
 sloth-agent ask-partner --help
 ```
 
@@ -584,7 +588,8 @@ sloth-agent accounts
 The command is read-only and cache-only: it does not refresh linked banks or
 change account data. Each result contains an opaque `accountRef`, personal or
 joint ownership, connected or manual source, native balance/currency when
-known, `lastBalanceUpdatedAt`, `connectionState`, and `isGoalFundingAccount`.
+known, `lastBalanceUpdatedAt`, `connectionState`, `isGoalFundingAccount`, and
+`partnerVisibility`.
 Missing values are JSON
 `null`; currencies are never converted or combined. Partner personal accounts
 are excluded, while enabled shared joint accounts follow Sloth's existing
@@ -604,7 +609,7 @@ Copy the value from `sloth-agent accounts`. Account references are the public
 account identifier for transaction filtering.
 
 Account changes are previews unless `--apply` is present. Connected accounts
-support only Goal-funding eligibility. Manual current accounts support their
+support Goal-funding eligibility and partner visibility. Manual current accounts support their
 institution, name, currency, and ownership. Manual balance accounts also
 support balance, Savings/Investments type, and Goal-funding eligibility.
 Partner-owned shared accounts return an explanatory error.
@@ -618,14 +623,31 @@ sloth-agent accounts update \
   --ownership individual \
   --balance-amount 12500.75 \
   --account-type investments \
-  --goal-funding-account false
+  --goal-funding-account false \
+  --partner-visibility holdings
 
 sloth-agent accounts update \
   --account-ref sloth_account_v1_... \
-  --goal-funding-account false \
+  --partner-visibility balance \
   --apply
 ```
 
+Read the same current position from your, your partner's, or the combined
+household perspective:
+
+```bash
+sloth-agent portfolio
+sloth-agent portfolio --view partner
+sloth-agent portfolio --view household
+```
+
+The command waits up to 45 seconds for eligible linked balances to refresh,
+then returns cached data if work continues. Partner accounts appear only when
+their owner has shared the balance or linked holdings. Sharing is for household
+planning only. It does not change account ownership, transaction access, Goal
+funding, or who can move money. Totals use the viewer's budget currency and
+exclude other native currencies without converting them.
+
 Archive an owned manual account. The account disappears from active Sloth
 surfaces, but its underlying records are retained. Repeating an applied removal
 is safe and returns `changed: false`.
@@ -729,6 +751,52 @@ one-based `priority`; `1` is highest. Moving one goal automatically shifts the
 goals between its old and new positions. Sloth recalculates the active-scenario
 roadmap before every applied Goal mutation and returns the updated forecast.
 
+List the scenarios that supply assumptions to that roadmap:
+
+```bash
+sloth-agent scenarios
+```
+
+Create a monthly contribution choice. Preview is the default and performs zero
+writes; add `--apply` after reviewing the returned scenario and recalculated
+Goals:
+
+```bash
+sloth-agent scenarios create \
+  --month 2026-09 \
+  --name "Deposit £100 into the shopping pot each month?" \
+  --account-ref sloth_account_v1_... \
+  --recurring-amount 100
+```
+
+Creation adds No and Yes options and activates Yes. The recurring contribution
+continues until a later active scenario changes it. A one-off amount applies
+only in the scenario month. Scenarios alter the forecast; they do not move
+money.
+
+Use stable IDs from `scenarios` output to edit or select an option:
+
+```bash
+sloth-agent scenarios update \
+  --month 2026-09 \
+  --option-id yes \
+  --account-ref sloth_account_v1_... \
+  --recurring-amount 125 \
+  --apply
+
+sloth-agent scenarios activate \
+  --month 2026-09 \
+  --option-id no \
+  --apply
+
+sloth-agent scenarios delete --month 2026-09 --apply
+```
+
+For recurring contributions, `--recurring-amount 0` explicitly stops the
+earlier amount. `--clear-recurring` removes this month's override, so the
+earlier recurring amount continues. Contribution updates use the active option
+when `--option-id` is omitted.
+
 Read uncategorised contributions to the joint budget:
 
 ```bash

package/dist/args.js

@@ -67,6 +67,16 @@ function parsePositiveDecimalAmount(value, name) {
     }
     return amount;
 }
+function parseNonNegativeDecimalAmount(value, name) {
+    if (!/^\d+(?:\.\d{1,2})?$/.test(value)) {
+        throw new UsageError(`${name} must be zero or a positive amount with at most two decimal places`);
+    }
+    const amount = Number(value);
+    if (!Number.isFinite(amount) || amount < 0) {
+        throw new UsageError(`${name} must be zero or a positive amount with at most two decimal places`);
+    }
+    return amount;
+}
 function parsePositiveAmountPence(value, name) {
     validatePositiveDecimalAmount(value, name);
     const [wholePounds, fractionalPounds = ''] = value.split('.');
@@ -390,6 +400,7 @@ function parseAccounts(args, baseUrl) {
             '--balance-amount',
             '--account-type',
             '--goal-funding-account',
+            '--partner-visibility',
         ]));
         const institutionName = values.get('--institution-name');
         const accountName = values.get('--account-name');
@@ -398,6 +409,7 @@ function parseAccounts(args, baseUrl) {
         const balanceValue = values.get('--balance-amount');
         const accountTypeValue = values.get('--account-type');
         const sourceValue = values.get('--goal-funding-account');
+        const partnerVisibility = values.get('--partner-visibility');
         if (currencyValue !== undefined && !/^[A-Za-z]{3}$/.test(currencyValue)) {
             throw new UsageError('--currency must be a three-letter currency code');
         }
@@ -414,6 +426,12 @@ function parseAccounts(args, baseUrl) {
         if (sourceValue !== undefined && sourceValue !== 'true' && sourceValue !== 'false') {
             throw new UsageError('--goal-funding-account must be true or false');
         }
+        if (partnerVisibility !== undefined
+            && partnerVisibility !== 'private'
+            && partnerVisibility !== 'balance'
+            && partnerVisibility !== 'holdings') {
+            throw new UsageError('--partner-visibility must be private, balance, or holdings');
+        }
         const update = {
             ...(institutionName === undefined
                 ? {}
@@ -430,6 +448,9 @@ function parseAccounts(args, baseUrl) {
                 ? {}
                 : { accountType: accountTypeValue }),
             ...(sourceValue === undefined ? {} : { isGoalFundingAccount: sourceValue === 'true' }),
+            ...(partnerVisibility === undefined ? {} : {
+                partnerVisibility: partnerVisibility,
+            }),
         };
         if (Object.keys(update).length === 0) {
             throw new UsageError('accounts update requires at least one field to update');
@@ -471,6 +492,16 @@ function parseInvestments(args, baseUrl) {
     }
     return withBaseUrl({ command: 'investments', ...(accountRef ? { accountRef } : {}) }, baseUrl);
 }
+function parsePortfolio(args, baseUrl) {
+    const { values, apply } = parseNamedOptions(args, 'portfolio', new Set(['--view']));
+    if (apply)
+        throw new UsageError('portfolio does not accept --apply');
+    const view = values.get('--view') ?? 'mine';
+    if (view !== 'mine' && view !== 'partner' && view !== 'household') {
+        throw new UsageError('--view must be mine, partner, or household');
+    }
+    return withBaseUrl({ command: 'portfolio', view }, baseUrl);
+}
 function parseBudget(args, baseUrl) {
     const subcommand = args[0] === 'status' || args[0] === 'update' || args[0] === 'move'
         ? args.shift()
@@ -843,6 +874,226 @@ function parseGoals(args, baseUrl) {
     }
     throw new UsageError(`Unknown goals command: ${subcommand}`);
 }
+function parseScenarioText(value, option, maxLength = 60) {
+    const text = value.trim();
+    if (text.length > maxLength) {
+        throw new UsageError(`${option} must be at most ${maxLength} characters`);
+    }
+    return text;
+}
+function parseScenarios(args, baseUrl) {
+    const subcommand = args.shift();
+    if (subcommand === undefined || subcommand === 'list') {
+        if (args.length > 0) {
+            throw new UsageError(`Unknown scenarios list option: ${args[0]}`);
+        }
+        return withBaseUrl({ command: 'scenarios-list' }, baseUrl);
+    }
+    if (subcommand === 'create') {
+        let monthKey;
+        let name;
+        let accountRef;
+        let recurringAmount;
+        let oneOffAmount;
+        let apply = false;
+        for (let index = 0; index < args.length; index += 1) {
+            const argument = args[index];
+            if (argument === '--apply') {
+                if (apply)
+                    throw new UsageError('--apply may only be provided once');
+                apply = true;
+                continue;
+            }
+            const [option, inlineValue] = argument.includes('=')
+                ? argument.split(/=(.*)/s, 2)
+                : [argument, undefined];
+            if (option !== '--month'
+                && option !== '--name'
+                && option !== '--account-ref'
+                && option !== '--recurring-amount'
+                && option !== '--one-off-amount') {
+                throw new UsageError(`Unknown scenarios create option: ${argument}`);
+            }
+            const value = requireNonEmpty(inlineValue ?? readOptionValue(args, index, option), option);
+            if (inlineValue === undefined)
+                index += 1;
+            if (option === '--month') {
+                monthKey = setOnce(monthKey, parseGoalMonthKey(value, option), option);
+            }
+            else if (option === '--name') {
+                name = setOnce(name, parseScenarioText(value, option), option);
+            }
+            else if (option === '--account-ref') {
+                accountRef = setOnce(accountRef, parseAccountRef(value), option);
+            }
+            else if (option === '--recurring-amount') {
+                recurringAmount = setOnce(recurringAmount, parseNonNegativeDecimalAmount(value, option), option);
+            }
+            else {
+                oneOffAmount = setOnce(oneOffAmount, parseNonNegativeDecimalAmount(value, option), option);
+            }
+        }
+        if (!monthKey)
+            throw new UsageError('scenarios create requires --month <YYYY-MM>');
+        if (!name)
+            throw new UsageError('scenarios create requires --name <name>');
+        if (!accountRef)
+            throw new UsageError('scenarios create requires --account-ref <accountRef>');
+        if (recurringAmount === undefined && oneOffAmount === undefined) {
+            throw new UsageError('scenarios create requires --recurring-amount or --one-off-amount');
+        }
+        if ((recurringAmount ?? 0) === 0 && (oneOffAmount ?? 0) === 0) {
+            throw new UsageError('scenarios create requires at least one positive contribution');
+        }
+        return withBaseUrl({
+            command: 'scenarios-create',
+            monthKey,
+            name,
+            accountRef,
+            ...(recurringAmount === undefined ? {} : { recurringAmount }),
+            ...(oneOffAmount === undefined
+                ? recurringAmount === undefined ? {} : { oneOffAmount: 0 }
+                : { oneOffAmount }),
+            apply,
+        }, baseUrl);
+    }
+    if (subcommand === 'update') {
+        let monthKey;
+        let name;
+        let optionId;
+        let optionLabel;
+        let accountRef;
+        let recurringAmount;
+        let oneOffAmount;
+        let apply = false;
+        for (let index = 0; index < args.length; index += 1) {
+            const argument = args[index];
+            if (argument === '--apply') {
+                if (apply)
+                    throw new UsageError('--apply may only be provided once');
+                apply = true;
+                continue;
+            }
+            if (argument === '--clear-recurring') {
+                if (recurringAmount !== undefined) {
+                    throw new UsageError('--recurring-amount and --clear-recurring are mutually exclusive');
+                }
+                recurringAmount = null;
+                continue;
+            }
+            const [option, inlineValue] = argument.includes('=')
+                ? argument.split(/=(.*)/s, 2)
+                : [argument, undefined];
+            if (option !== '--month'
+                && option !== '--name'
+                && option !== '--option-id'
+                && option !== '--option-label'
+                && option !== '--account-ref'
+                && option !== '--recurring-amount'
+                && option !== '--one-off-amount') {
+                throw new UsageError(`Unknown scenarios update option: ${argument}`);
+            }
+            const value = requireNonEmpty(inlineValue ?? readOptionValue(args, index, option), option);
+            if (inlineValue === undefined)
+                index += 1;
+            if (option === '--month') {
+                monthKey = setOnce(monthKey, parseGoalMonthKey(value, option), option);
+            }
+            else if (option === '--name') {
+                name = setOnce(name, parseScenarioText(value, option), option);
+            }
+            else if (option === '--option-id') {
+                optionId = setOnce(optionId, parseScenarioText(value, option, 200), option);
+            }
+            else if (option === '--option-label') {
+                optionLabel = setOnce(optionLabel, parseScenarioText(value, option), option);
+            }
+            else if (option === '--account-ref') {
+                accountRef = setOnce(accountRef, parseAccountRef(value), option);
+            }
+            else if (option === '--recurring-amount') {
+                if (recurringAmount !== undefined) {
+                    throw new UsageError('--recurring-amount and --clear-recurring are mutually exclusive');
+                }
+                recurringAmount = parseNonNegativeDecimalAmount(value, option);
+            }
+            else {
+                oneOffAmount = setOnce(oneOffAmount, parseNonNegativeDecimalAmount(value, option), option);
+            }
+        }
+        if (!monthKey)
+            throw new UsageError('scenarios update requires --month <YYYY-MM>');
+        if (optionLabel !== undefined && optionId === undefined) {
+            throw new UsageError('--option-label requires --option-id');
+        }
+        if ((recurringAmount !== undefined || oneOffAmount !== undefined) && !accountRef) {
+            throw new UsageError('scenario contribution changes require --account-ref');
+        }
+        if (accountRef !== undefined
+            && recurringAmount === undefined
+            && oneOffAmount === undefined) {
+            throw new UsageError('--account-ref requires a contribution change');
+        }
+        if (name === undefined
+            && optionLabel === undefined
+            && accountRef === undefined
+            && recurringAmount === undefined
+            && oneOffAmount === undefined) {
+            throw new UsageError('scenarios update requires at least one field to update');
+        }
+        return withBaseUrl({
+            command: 'scenarios-update',
+            monthKey,
+            ...(name === undefined ? {} : { name }),
+            ...(optionId === undefined ? {} : { optionId }),
+            ...(optionLabel === undefined ? {} : { optionLabel }),
+            ...(accountRef === undefined ? {} : { accountRef }),
+            ...(recurringAmount === undefined ? {} : { recurringAmount }),
+            ...(oneOffAmount === undefined ? {} : { oneOffAmount }),
+            apply,
+        }, baseUrl);
+    }
+    if (subcommand === 'activate' || subcommand === 'delete') {
+        let monthKey;
+        let optionId;
+        let apply = false;
+        for (let index = 0; index < args.length; index += 1) {
+            const argument = args[index];
+            if (argument === '--apply') {
+                if (apply)
+                    throw new UsageError('--apply may only be provided once');
+                apply = true;
+                continue;
+            }
+            const [option, inlineValue] = argument.includes('=')
+                ? argument.split(/=(.*)/s, 2)
+                : [argument, undefined];
+            if (option !== '--month' && !(subcommand === 'activate' && option === '--option-id')) {
+                throw new UsageError(`Unknown scenarios ${subcommand} option: ${argument}`);
+            }
+            const value = requireNonEmpty(inlineValue ?? readOptionValue(args, index, option), option);
+            if (inlineValue === undefined)
+                index += 1;
+            if (option === '--month') {
+                monthKey = setOnce(monthKey, parseGoalMonthKey(value, option), option);
+            }
+            else {
+                optionId = setOnce(optionId, parseScenarioText(value, option, 200), option);
+            }
+        }
+        if (!monthKey)
+            throw new UsageError(`scenarios ${subcommand} requires --month <YYYY-MM>`);
+        if (subcommand === 'activate') {
+            if (!optionId)
+                throw new UsageError('scenarios activate requires --option-id <id>');
+            return withBaseUrl({
+                command: 'scenarios-activate', monthKey, optionId, apply,
+            }, baseUrl);
+        }
+        return withBaseUrl({ command: 'scenarios-delete', monthKey, apply }, baseUrl);
+    }
+    throw new UsageError(`Unknown scenarios command: ${subcommand}`);
+}
 function parseRules(args, baseUrl) {
     const subcommand = args.shift();
     if (subcommand === undefined || subcommand === 'list') {
@@ -924,6 +1175,19 @@ function helpTopic(argv) {
             return 'goals-delete';
         return 'goals';
     }
+    if (command === 'scenarios') {
+        if (subcommand === 'list')
+            return 'scenarios-list';
+        if (subcommand === 'create')
+            return 'scenarios-create';
+        if (subcommand === 'update')
+            return 'scenarios-update';
+        if (subcommand === 'activate')
+            return 'scenarios-activate';
+        if (subcommand === 'delete')
+            return 'scenarios-delete';
+        return 'scenarios';
+    }
     if (command === 'rules') {
         if (subcommand === 'get')
             return 'rules-get';
@@ -979,8 +1243,8 @@ function helpTopic(argv) {
             return 'accounts-remove';
         return command;
     }
-    if (command === 'investments')
-        return 'investments';
+    if (command === 'investments' || command === 'portfolio')
+        return command;
     return undefined;
 }
 export function parseArgs(argv) {
@@ -1000,6 +1264,9 @@ export function parseArgs(argv) {
     if (command === 'goals') {
         return parseGoals(args, baseUrl);
     }
+    if (command === 'scenarios') {
+        return parseScenarios(args, baseUrl);
+    }
     if (command === 'rules') {
         return parseRules(args, baseUrl);
     }
@@ -1015,6 +1282,9 @@ export function parseArgs(argv) {
     if (command === 'investments') {
         return parseInvestments(args, baseUrl);
     }
+    if (command === 'portfolio') {
+        return parsePortfolio(args, baseUrl);
+    }
     if (command === 'budget') {
         return parseBudget(args, baseUrl);
     }

package/dist/cli.js

@@ -6,7 +6,7 @@ import { ICON_KEYS } from './category-metadata.js';
 import { parseApiResponse, parseAssignmentOperationResponse, toLegacyAssignmentResponse, validateAssignmentPayload, validateBudgetMovementResponse, validateBudgetUpdatePayload, validateNotificationRulePayload, validateReceiptConfirmation, } from './contracts.js';
 import { createSystemCredentialStore, secureStorageUnavailableError, } from './credential-store.js';
 import { ApiError, CliError, ConfigError, UsageError, } from './errors.js';
-export const CLI_VERSION = '0.19.0';
+export const CLI_VERSION = '0.21.0';
 const REQUEST_TIMEOUT_MS = 60_000;
 const MAX_CONTRACT_PDF_BYTES = 6_000_000;
 const API_ORIGIN_HELP_LINES = [
@@ -34,6 +34,7 @@ export function usageText() {
         '  sloth-agent accounts update --account-ref REF [fields] [--apply]',
         '  sloth-agent accounts remove --account-ref REF [--apply]',
         '  sloth-agent investments [--account-ref REF] [--base-url URL]',
+        '  sloth-agent portfolio [--view mine|partner|household] [--base-url URL]',
         '  sloth-agent budget --scope personal|joint [--period YYYY-MM] [--base-url URL]',
         '  sloth-agent budget status --scope personal|joint [--period YYYY-MM] [--base-url URL]',
         '  sloth-agent budget update --scope personal|joint [--period YYYY-MM]',
@@ -67,6 +68,12 @@ export function usageText() {
         '  sloth-agent goals mark-spent --goal-id ID [--apply] [--base-url URL]',
         '  sloth-agent goals restore --goal-id ID [--apply] [--base-url URL]',
         '  sloth-agent goals delete --goal-id ID [--apply] [--base-url URL]',
+        '  sloth-agent scenarios [list] [--base-url URL]',
+        '  sloth-agent scenarios create --month YYYY-MM --name NAME --account-ref REF',
+        '    [--recurring-amount AMOUNT] [--one-off-amount AMOUNT] [--apply]',
+        '  sloth-agent scenarios update --month YYYY-MM [fields] [--apply]',
+        '  sloth-agent scenarios activate --month YYYY-MM --option-id ID [--apply]',
+        '  sloth-agent scenarios delete --month YYYY-MM [--apply]',
         '  sloth-agent ask-partner --transaction-ref REF [--base-url URL]',
         '',
         'Help:',
@@ -378,11 +385,14 @@ export function accountsUpdateHelpText() {
         '  --balance-amount AMOUNT             Balance-only account balance.',
         '  --account-type savings|investments Balance-only account type.',
         '  --goal-funding-account true|false   Whether Goals may use this account.',
+        '  --partner-visibility private|balance|holdings',
+        '                                      What this account shares with your partner.',
         '',
         'Write behavior:',
         '  Without --apply, returns a JSON preview without credentials or a network request.',
         '  With --apply, requires agent:write on a write-enabled token and updates saved Sloth metadata.',
-        '  Connected accounts support only --goal-funding-account.',
+        '  Connected accounts support --goal-funding-account and --partner-visibility.',
+        '  Sharing exposes planning data only. It does not change ownership or assign the account to Goals.',
         '  Manual current accounts cannot change type, balance, or Goal-funding membership.',
         '  Partner-owned shared accounts cannot be changed.',
         '  Unknown, disconnected, or inaccessible references return Account not found.',
@@ -442,6 +452,33 @@ export function investmentsHelpText() {
         '  provider-native and are not converted or guaranteed to reconcile to totals.',
     ].join('\n');
 }
+export function portfolioHelpText() {
+    return [
+        'Sloth Agent CLI — portfolio',
+        '',
+        'Read your savings and investments from one household planning perspective.',
+        '',
+        'Usage:',
+        '  sloth-agent portfolio [--view mine|partner|household] [--base-url URL]',
+        '',
+        'Options:',
+        '  --view mine|partner|household  Optional. Defaults to mine.',
+        '  --base-url URL                 Optional. Override the API origin.',
+        '  -h, --help                     Show this help.',
+        ...API_ORIGIN_HELP_LINES,
+        '',
+        'Access:',
+        '  This read-only command waits up to 45 seconds for eligible linked balances to refresh.',
+        '  Partner shows only balances or holdings your partner explicitly shared.',
+        '  Household combines your accounts with those shared balances and deduplicates joint accounts.',
+        '  Shared data supports planning only. It does not assign partner accounts to Goals or change ownership.',
+        '',
+        'Output:',
+        '  totals gives savings, investments, and tracked amounts in the viewer currency.',
+        '  accounts includes ownerRole, freshness, sharing level, and permitted holdings.',
+        '  refresh reports whether eligible linked balances refreshed or cached data was returned.',
+    ].join('\n');
+}
 export function budgetHelpText() {
     return [
         'Sloth Agent CLI — budget',
@@ -927,6 +964,192 @@ export function goalsDeleteHelpText() {
         '  Apply mode returns deleted and deletedGoalId.',
     ].join('\n');
 }
+export function scenariosHelpText() {
+    return [
+        'Sloth Agent CLI - scenarios',
+        '',
+        'Manage the month-anchored choices used by the Goal forecast.',
+        'Each scenario contains options. Its active option controls the forecast calculation.',
+        '',
+        'Commands:',
+        '  sloth-agent scenarios list       List scenarios and their options.',
+        '  sloth-agent scenarios create     Create a No/Yes scenario.',
+        '  sloth-agent scenarios update     Change a scenario or option.',
+        '  sloth-agent scenarios activate   Make an option active.',
+        '  sloth-agent scenarios delete     Remove a scenario.',
+        '',
+        'Help:',
+        '  Run sloth-agent scenarios <command> --help for command-specific details.',
+        ...API_ORIGIN_HELP_LINES,
+    ].join('\n');
+}
+export function scenariosListHelpText() {
+    return [
+        'Sloth Agent CLI - scenarios list',
+        '',
+        'List each scenario, its active option, and account contributions.',
+        '',
+        'Usage:',
+        '  sloth-agent scenarios [list] [--base-url URL] [-h]',
+        '',
+        'Options:',
+        '  --base-url URL   Optional. Override the API origin.',
+        '  -h, --help       Show this help.',
+        '',
+        'Behavior:',
+        'This command is read-only and requires agent:read.',
+        ...API_ORIGIN_HELP_LINES,
+        '',
+        'Output:',
+        '  JSON with currency, forecastBasis, and scenarios. Each scenario contains',
+        '  activeOptionId and options with isActive and account contributions.',
+    ].join('\n');
+}
+export function scenariosCreateHelpText() {
+    return [
+        'Sloth Agent CLI - scenarios create',
+        '',
+        'Create a month-anchored choice and recalculate the Goal roadmap.',
+        '',
+        'Usage:',
+        '  sloth-agent scenarios create --month YYYY-MM --name NAME --account-ref REF',
+        '    [--recurring-amount AMOUNT] [--one-off-amount AMOUNT] [--apply]',
+        '    [--base-url URL] [-h]',
+        '',
+        'Required:',
+        '  --month YYYY-MM              Month when this scenario begins.',
+        '  --name NAME                  Question shown for the scenario, up to 60 characters.',
+        '  --account-ref REF            Exact accountRef from sloth-agent accounts.',
+        '',
+        'Contribution: provide at least one:',
+        '  --recurring-amount AMOUNT    Optional monthly contribution in the budget currency.',
+        '  --one-off-amount AMOUNT      Optional contribution for this month.',
+        '  AMOUNT accepts zero or a positive decimal with at most two decimal places.',
+        '  At least one supplied amount must be positive.',
+        '',
+        'Options:',
+        '  --apply          Optional. Save the scenario; otherwise preview it.',
+        '  --base-url URL   Optional. Override the API origin.',
+        '  -h, --help       Show this help.',
+        '',
+        'Provide at least one positive contribution. A recurring contribution continues',
+        'until a later active scenario changes it. Creation adds No and Yes options and',
+        'activates Yes. It records a forecast assumption and does not move money.',
+        '',
+        'Write behavior:',
+        '  Without --apply, Sloth authenticates, calculates the result, and performs zero writes.',
+        '  With --apply, Sloth saves the scenario using a write-enabled token with Allow changes.',
+        ...API_ORIGIN_HELP_LINES,
+        '',
+        'Output:',
+        '  JSON with changed, forecastBasis, the proposed or saved scenario, and',
+        '  recalculated Goals. Preview and apply use the same output contract.',
+        '',
+        'Example:',
+        '  sloth-agent scenarios create --month 2026-09 \\',
+        '    --name "Deposit £100 into the shopping pot each month?" \\',
+        '    --account-ref PASTE_THE_EXACT_ACCOUNT_REF_HERE --recurring-amount 100',
+    ].join('\n');
+}
+export function scenariosUpdateHelpText() {
+    return [
+        'Sloth Agent CLI - scenarios update',
+        '',
+        'Change a scenario, one option, or an account contribution.',
+        '',
+        'Usage:',
+        '  sloth-agent scenarios update --month YYYY-MM [fields] [--apply]',
+        '    [--base-url URL] [-h]',
+        '',
+        'Required:',
+        '  --month YYYY-MM                 Scenario month.',
+        '',
+        'Fields:',
+        '  --name NAME                     Rename the scenario, up to 60 characters.',
+        '  --option-id ID                  Select an option ID, up to 200 characters.',
+        '  --option-label LABEL            Rename it, up to 60 characters; requires --option-id.',
+        '  --account-ref REF               Account for contribution changes.',
+        '  --recurring-amount AMOUNT       Set a monthly contribution; cannot be used',
+        '                                  with --clear-recurring.',
+        '  --clear-recurring               Inherit the earlier recurring amount.',
+        '  --one-off-amount AMOUNT         Set this month\'s one-off contribution.',
+        '  Amounts accept zero or a positive decimal with at most two decimal places.',
+        '  Contribution fields require --account-ref, and --account-ref requires one',
+        '  of those fields. Provide at least one field that changes the scenario.',
+        '',
+        'Options:',
+        '  --apply          Optional. Save the change; otherwise preview it.',
+        '  --base-url URL   Optional. Override the API origin.',
+        '  -h, --help       Show this help.',
+        '',
+        'Contribution changes use the active option when --option-id is omitted.',
+        'For recurring contributions, zero explicitly stops the earlier recurring amount.',
+        '--clear-recurring removes this override so the earlier recurring amount continues.',
+        '',
+        'Write behavior:',
+        '  Without --apply, Sloth authenticates, calculates the result, and performs zero writes.',
+        '  With --apply, Sloth saves the change using a write-enabled token with Allow changes.',
+        ...API_ORIGIN_HELP_LINES,
+        '',
+        'Output:',
+        '  JSON with changed, forecastBasis, the proposed or saved scenario, and',
+        '  recalculated Goals. Preview and apply use the same output contract.',
+    ].join('\n');
+}
+export function scenariosActivateHelpText() {
+    return [
+        'Sloth Agent CLI - scenarios activate',
+        '',
+        'Select the option that controls the forecast and recalculates Goals.',
+        '',
+        'Usage:',
+        '  sloth-agent scenarios activate --month YYYY-MM --option-id ID [--apply]',
+        '    [--base-url URL] [-h]',
+        '',
+        'Required:',
+        '  --month YYYY-MM   Scenario month.',
+        '  --option-id ID    Exact option ID from scenarios list, up to 200 characters.',
+        '',
+        'Options:',
+        '  --apply          Optional. Save the active option; otherwise preview it.',
+        '  --base-url URL   Optional. Override the API origin.',
+        '  -h, --help       Show this help.',
+        '',
+        'Write behavior:',
+        'Without --apply, Sloth calculates the result and performs zero writes.',
+        'With --apply, Sloth saves the active option using a write-enabled token with Allow changes.',
+        ...API_ORIGIN_HELP_LINES,
+        '',
+        'Output:',
+        '  JSON with changed, forecastBasis, the selected scenario, and recalculated Goals.',
+    ].join('\n');
+}
+export function scenariosDeleteHelpText() {
+    return [
+        'Sloth Agent CLI - scenarios delete',
+        '',
+        'Remove one scenario. Sloth recalculates Goals without it.',
+        '',
+        'Usage:',
+        '  sloth-agent scenarios delete --month YYYY-MM [--apply] [--base-url URL] [-h]',
+        '',
+        'Required:',
+        '  --month YYYY-MM   Scenario month.',
+        '',
+        'Options:',
+        '  --apply          Optional. Remove the scenario; otherwise preview deletion.',
+        '  --base-url URL   Optional. Override the API origin.',
+        '  -h, --help       Show this help.',
+        '',
+        'Write behavior:',
+        'Without --apply, Sloth calculates the result and performs zero writes.',
+        'With --apply, Sloth removes the scenario using a write-enabled token with Allow changes.',
+        ...API_ORIGIN_HELP_LINES,
+        '',
+        'Output:',
+        '  JSON with changed, forecastBasis, deletedMonthKey, and recalculated Goals.',
+    ].join('\n');
+}
 export function askPartnerHelpText() {
     return [
         'Sloth Agent CLI — ask-partner',
@@ -1173,6 +1396,7 @@ export function commandHelpText(topic) {
         'accounts-update': accountsUpdateHelpText,
         'accounts-remove': accountsRemoveHelpText,
         investments: investmentsHelpText,
+        portfolio: portfolioHelpText,
         budget: budgetHelpText,
         'budget-status': budgetStatusHelpText,
         'budget-move': budgetMoveHelpText,
@@ -1202,6 +1426,12 @@ export function commandHelpText(topic) {
         'goals-mark-spent': goalsMarkSpentHelpText,
         'goals-restore': goalsRestoreHelpText,
         'goals-delete': goalsDeleteHelpText,
+        scenarios: scenariosHelpText,
+        'scenarios-list': scenariosListHelpText,
+        'scenarios-create': scenariosCreateHelpText,
+        'scenarios-update': scenariosUpdateHelpText,
+        'scenarios-activate': scenariosActivateHelpText,
+        'scenarios-delete': scenariosDeleteHelpText,
         'ask-partner': askPartnerHelpText,
     };
     return helpByTopic[topic]();
@@ -1524,6 +1754,77 @@ function hasFailures(value) {
         return false;
     return Array.isArray(value.failed) && value.failed.length > 0;
 }
+function scenarioRequestDescriptor(parsed, baseUrl) {
+    const previewEndpoint = `${baseUrl}/api/agent/v1/scenarios/preview`;
+    switch (parsed.command) {
+        case 'scenarios-create': {
+            const scenario = {
+                monthKey: parsed.monthKey,
+                name: parsed.name,
+                accountRef: parsed.accountRef,
+                ...(parsed.recurringAmount === undefined
+                    ? {}
+                    : { recurringAmount: parsed.recurringAmount }),
+                ...(parsed.oneOffAmount === undefined
+                    ? {}
+                    : { oneOffAmount: parsed.oneOffAmount }),
+            };
+            return parsed.apply
+                ? { endpoint: `${baseUrl}/api/agent/v1/scenarios`, method: 'POST', body: scenario }
+                : {
+                    endpoint: previewEndpoint,
+                    method: 'POST',
+                    body: { action: 'create', scenario },
+                };
+        }
+        case 'scenarios-update': {
+            const updates = {
+                ...(parsed.name === undefined ? {} : { name: parsed.name }),
+                ...(parsed.optionId === undefined ? {} : { optionId: parsed.optionId }),
+                ...(parsed.optionLabel === undefined ? {} : { optionLabel: parsed.optionLabel }),
+                ...(parsed.accountRef === undefined ? {} : { accountRef: parsed.accountRef }),
+                ...(parsed.recurringAmount === undefined
+                    ? {}
+                    : { recurringAmount: parsed.recurringAmount }),
+                ...(parsed.oneOffAmount === undefined ? {} : { oneOffAmount: parsed.oneOffAmount }),
+            };
+            return parsed.apply
+                ? {
+                    endpoint: `${baseUrl}/api/agent/v1/scenarios/${encodeURIComponent(parsed.monthKey)}`,
+                    method: 'PATCH',
+                    body: updates,
+                }
+                : {
+                    endpoint: previewEndpoint,
+                    method: 'POST',
+                    body: { action: 'update', monthKey: parsed.monthKey, updates },
+                };
+        }
+        case 'scenarios-activate':
+            return parsed.apply
+                ? {
+                    endpoint: `${baseUrl}/api/agent/v1/scenarios/${encodeURIComponent(parsed.monthKey)}/activate`,
+                    method: 'POST',
+                    body: { optionId: parsed.optionId },
+                }
+                : {
+                    endpoint: previewEndpoint,
+                    method: 'POST',
+                    body: { action: 'activate', monthKey: parsed.monthKey, optionId: parsed.optionId },
+                };
+        case 'scenarios-delete':
+            return parsed.apply
+                ? {
+                    endpoint: `${baseUrl}/api/agent/v1/scenarios/${encodeURIComponent(parsed.monthKey)}`,
+                    method: 'DELETE',
+                }
+                : {
+                    endpoint: previewEndpoint,
+                    method: 'POST',
+                    body: { action: 'delete', monthKey: parsed.monthKey },
+                };
+    }
+}
 export async function runCli(argv = process.argv.slice(2), options = {}) {
     const environment = options.env ?? process.env;
     const fetchImplementation = options.fetch ?? globalThis.fetch;
@@ -1969,6 +2270,31 @@ export async function runCli(argv = process.argv.slice(2), options = {}) {
             writeJson(writeStdout, data);
             return 0;
         }
+        if (parsed.command === 'scenarios-list') {
+            const response = await fetchImplementation(`${baseUrl}/api/agent/v1/scenarios`, {
+                method: 'GET',
+                headers,
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+            writeJson(writeStdout, parseApiResponse('scenarios-list', await parseHttpResponse(response, token)));
+            return 0;
+        }
+        if (parsed.command === 'scenarios-create'
+            || parsed.command === 'scenarios-update'
+            || parsed.command === 'scenarios-activate'
+            || parsed.command === 'scenarios-delete') {
+            const request = scenarioRequestDescriptor(parsed, baseUrl);
+            const response = await fetchImplementation(request.endpoint, {
+                method: request.method,
+                headers: request.body === undefined
+                    ? headers
+                    : { ...headers, 'Content-Type': 'application/json' },
+                ...(request.body === undefined ? {} : { body: JSON.stringify(request.body) }),
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+            writeJson(writeStdout, parseApiResponse('scenarios-mutation', await parseHttpResponse(response, token)));
+            return 0;
+        }
         if (parsed.command === 'assign') {
             const payload = assignmentPayload;
             const data = await applyAssignments(fetchImplementation, sleep, baseUrl, token, payload);
@@ -2063,19 +2389,21 @@ export async function runCli(argv = process.argv.slice(2), options = {}) {
         }
         const path = parsed.command === 'accounts'
             ? '/api/agent/v1/accounts'
-            : parsed.command === 'investments'
-                ? `/api/agent/v1/investments${parsed.accountRef
-                    ? `?${new URLSearchParams({ accountRef: parsed.accountRef }).toString()}`
-                    : ''}`
-                : parsed.command === 'categories'
-                    ? '/api/agent/v1/categories'
-                    : `/api/agent/v1/transactions${(() => {
-                        const query = buildTransactionsQuery(parsed.filters);
-                        return query ? `?${query}` : '';
-                    })()}`;
+            : parsed.command === 'portfolio'
+                ? `/api/agent/v1/portfolio?${new URLSearchParams({ view: parsed.view }).toString()}`
+                : parsed.command === 'investments'
+                    ? `/api/agent/v1/investments${parsed.accountRef
+                        ? `?${new URLSearchParams({ accountRef: parsed.accountRef }).toString()}`
+                        : ''}`
+                    : parsed.command === 'categories'
+                        ? '/api/agent/v1/categories'
+                        : `/api/agent/v1/transactions${(() => {
+                            const query = buildTransactionsQuery(parsed.filters);
+                            return query ? `?${query}` : '';
+                        })()}`;
         const response = await fetchImplementation(`${baseUrl}${path}`, {
             method: 'GET',
-            headers: parsed.command === 'transactions'
+            headers: parsed.command === 'transactions' || parsed.command === 'portfolio'
                 ? { ...headers, Prefer: 'wait=45' }
                 : headers,
             signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),

package/dist/contracts.js

@@ -861,6 +861,7 @@ function isAccount(value) {
             'lastBalanceUpdatedAt',
             'connectionState',
             'isGoalFundingAccount',
+            'partnerVisibility',
         ])
         && isAccountRef(value.accountRef)
         && isNullableNonEmptyString(value.accountName)
@@ -879,7 +880,10 @@ function isAccount(value) {
             || value.connectionState === 'expired'
             || value.connectionState === 'manual'
             || value.connectionState === 'unknown')
-        && typeof value.isGoalFundingAccount === 'boolean');
+        && typeof value.isGoalFundingAccount === 'boolean'
+        && (value.partnerVisibility === 'private'
+            || value.partnerVisibility === 'balance'
+            || value.partnerVisibility === 'holdings'));
 }
 function isAccountsResponse(value) {
     return (isObject(value)
@@ -945,6 +949,55 @@ function isInvestmentsResponse(value) {
                 && holdings.every(isInvestmentHolding));
         }));
 }
+function isPortfolioAccount(value) {
+    return isObject(value)
+        && hasOnlyFields(value, [
+            'accountRef', 'ownerRole', 'accountName', 'institutionName', 'accountType',
+            'ownership', 'balanceAmount', 'currency', 'source', 'lastBalanceUpdatedAt',
+            'connectionState', 'partnerVisibility', 'isGoalFundingAccount', 'holdings',
+        ])
+        && isAccountRef(value.accountRef)
+        && (value.ownerRole === 'you' || value.ownerRole === 'partner')
+        && isNullableNonEmptyString(value.accountName)
+        && isNullableNonEmptyString(value.institutionName)
+        && (value.accountType === 'savings' || value.accountType === 'investments')
+        && (value.ownership === 'personal' || value.ownership === 'joint')
+        && (value.balanceAmount === null || (typeof value.balanceAmount === 'number' && Number.isFinite(value.balanceAmount)))
+        && isCurrency(value.currency)
+        && (value.source === 'connected' || value.source === 'manual')
+        && (value.lastBalanceUpdatedAt === null || isIsoDateTime(value.lastBalanceUpdatedAt))
+        && ['active', 'expired', 'manual', 'unknown'].includes(String(value.connectionState))
+        && ['private', 'balance', 'holdings'].includes(String(value.partnerVisibility))
+        && (value.isGoalFundingAccount === null || typeof value.isGoalFundingAccount === 'boolean')
+        && Array.isArray(value.holdings)
+        && value.holdings.every(isInvestmentHolding);
+}
+function isPortfolioResponse(value) {
+    if (!isObject(value) || !hasOnlyFields(value, [
+        'asOf', 'currency', 'view', 'hasPartner', 'totals',
+        'excludedCurrencyAccountCount', 'accounts', 'refresh',
+    ]))
+        return false;
+    const totals = value.totals;
+    const refresh = value.refresh;
+    return isIsoDateTime(value.asOf)
+        && isCurrency(value.currency)
+        && ['mine', 'partner', 'household'].includes(String(value.view))
+        && typeof value.hasPartner === 'boolean'
+        && isObject(totals)
+        && hasOnlyFields(totals, ['savingsAmount', 'investmentsAmount', 'trackedAmount'])
+        && ['savingsAmount', 'investmentsAmount', 'trackedAmount'].every(field => (typeof totals[field] === 'number' && Number.isFinite(totals[field])))
+        && Number.isSafeInteger(value.excludedCurrencyAccountCount)
+        && Number(value.excludedCurrencyAccountCount) >= 0
+        && Array.isArray(value.accounts)
+        && value.accounts.every(isPortfolioAccount)
+        && isObject(refresh)
+        && hasOnlyFields(refresh, ['status', 'reason', 'utcDate'])
+        && ['skipped', 'completed', 'in_progress', 'partial', 'failed'].includes(String(refresh.status))
+        && typeof refresh.reason === 'string'
+        && refresh.reason.length > 0
+        && isIsoDate(refresh.utcDate);
+}
 function isForecastBasis(value) {
     return isObject(value)
         && hasOnlyFields(value, [
@@ -1001,6 +1054,101 @@ function isGoalDeleteResponse(value) {
         && typeof value.deletedGoalId === 'string'
         && value.deletedGoalId.trim().length > 0);
 }
+function isScenarioAmount(value) {
+    return typeof value === 'number'
+        && Number.isFinite(value)
+        && value >= 0
+        && Math.abs(value * 100 - Math.round(value * 100)) < Number.EPSILON * 100;
+}
+function isScenarioContribution(value) {
+    return isObject(value)
+        && hasOnlyFields(value, [
+            'accountRef',
+            'accountLabel',
+            'accountType',
+            'recurringAmount',
+            'oneOffAmount',
+        ])
+        && isAccountRef(value.accountRef)
+        && typeof value.accountLabel === 'string'
+        && value.accountLabel.trim().length > 0
+        && (value.accountType === 'current'
+            || value.accountType === 'savings'
+            || value.accountType === 'investments')
+        && (value.recurringAmount === null
+            || isScenarioAmount(value.recurringAmount))
+        && isScenarioAmount(value.oneOffAmount);
+}
+function isScenarioOption(value) {
+    return isObject(value)
+        && hasOnlyFields(value, ['id', 'label', 'isActive', 'contributions'])
+        && typeof value.id === 'string'
+        && value.id.trim().length > 0
+        && value.id === value.id.trim()
+        && value.id.length <= 200
+        && typeof value.label === 'string'
+        && value.label.trim().length > 0
+        && value.label === value.label.trim()
+        && value.label.length <= 60
+        && typeof value.isActive === 'boolean'
+        && Array.isArray(value.contributions)
+        && value.contributions.every(isScenarioContribution);
+}
+function hasConsistentScenarioOptions(options, activeOptionId) {
+    const parsedOptions = options.filter(isObject);
+    if (parsedOptions.length !== options.length)
+        return false;
+    const optionIds = parsedOptions.map(option => String(option.id));
+    const activeOptions = parsedOptions.filter(option => option.isActive === true);
+    return new Set(optionIds).size === optionIds.length
+        && activeOptions.length === 1
+        && activeOptions[0]?.id === activeOptionId;
+}
+function isScenario(value) {
+    return isObject(value)
+        && hasOnlyFields(value, ['monthKey', 'name', 'activeOptionId', 'options'])
+        && isMonthKeyOrNull(value.monthKey)
+        && value.monthKey !== null
+        && (value.name === null
+            || (typeof value.name === 'string'
+                && value.name.trim().length > 0
+                && value.name === value.name.trim()
+                && value.name.length <= 60))
+        && typeof value.activeOptionId === 'string'
+        && value.activeOptionId.trim().length > 0
+        && value.activeOptionId === value.activeOptionId.trim()
+        && value.activeOptionId.length <= 200
+        && Array.isArray(value.options)
+        && value.options.length > 0
+        && value.options.every(isScenarioOption)
+        && hasConsistentScenarioOptions(value.options, value.activeOptionId);
+}
+function isScenariosResponse(value) {
+    return isObject(value)
+        && hasOnlyFields(value, ['currency', 'forecastBasis', 'scenarios'])
+        && isCurrency(value.currency)
+        && isForecastBasis(value.forecastBasis)
+        && Array.isArray(value.scenarios)
+        && value.scenarios.every(isScenario);
+}
+function isScenarioMutationResponse(value) {
+    return isObject(value)
+        && hasOnlyFields(value, [
+            'currency',
+            'changed',
+            'forecastBasis',
+            'scenario',
+            'deletedMonthKey',
+            'goals',
+        ])
+        && isCurrency(value.currency)
+        && typeof value.changed === 'boolean'
+        && isForecastBasis(value.forecastBasis)
+        && (value.scenario === null || isScenario(value.scenario))
+        && isMonthKeyOrNull(value.deletedMonthKey)
+        && Array.isArray(value.goals)
+        && value.goals.every(isGoal);
+}
 function isReceiptConfirmation(value) {
     try {
         validateReceiptConfirmation(value);
@@ -1059,47 +1207,53 @@ export function parseApiResponse(command, value) {
                 ? isAccountRemovalResponse(value)
                 : command === 'investments'
                     ? isInvestmentsResponse(value)
-                    : command === 'budget' || command === 'budget-update'
-                        ? isBudgetResponse(value)
-                        : command === 'budget-status'
-                            ? isBudgetActivityStatusResponse(value)
-                            : command === 'budget-move'
-                                ? isBudgetMovementResponse(value)
-                                : command === 'categories'
-                                    ? isCategoryResponse(value)
-                                    : command === 'categories-create' || command === 'categories-rename'
-                                        ? isCategoryMutationResponse(value)
-                                        : command === 'line-items-create' || command === 'line-items-rename'
-                                            ? isLineItemMutationResponse(value)
-                                            : command === 'transactions'
-                                                ? isTransactionsResponse(value)
-                                                : command === 'rules-list'
-                                                    ? isNotificationRuleListResponse(value)
-                                                    : command === 'rules-get' || command === 'rules-set'
-                                                        ? isNotificationRuleResponse(value)
-                                                        : command === 'rules-delete'
-                                                            ? isNotificationRuleDeleteResponse(value)
-                                                            : command === 'rules-scan-contract'
-                                                                ? isRenewalExtractionResponse(value)
-                                                                : command === 'receipts-extract'
-                                                                    ? isReceiptExtractResponse(value)
-                                                                    : command === 'receipts-get'
-                                                                        ? isReceiptLookupResponse(value)
-                                                                        : command === 'receipts-attach'
-                                                                            ? isReceiptMutationResponse(value)
-                                                                            : command === 'receipts-remove'
-                                                                                ? isReceiptDeleteResponse(value)
-                                                                                : command === 'assign'
-                                                                                    ? isAssignmentResponse(value)
-                                                                                    : command === 'ask-partner'
-                                                                                        ? isPartnerResponse(value)
-                                                                                        : command === 'goals-list'
-                                                                                            ? isGoalsResponse(value)
-                                                                                            : command === 'goals-preview'
-                                                                                                ? isGoalPreviewResponse(value)
-                                                                                                : command === 'goals-delete'
-                                                                                                    ? isGoalDeleteResponse(value)
-                                                                                                    : isGoalMutationResponse(value);
+                    : command === 'portfolio'
+                        ? isPortfolioResponse(value)
+                        : command === 'budget' || command === 'budget-update'
+                            ? isBudgetResponse(value)
+                            : command === 'budget-status'
+                                ? isBudgetActivityStatusResponse(value)
+                                : command === 'budget-move'
+                                    ? isBudgetMovementResponse(value)
+                                    : command === 'categories'
+                                        ? isCategoryResponse(value)
+                                        : command === 'categories-create' || command === 'categories-rename'
+                                            ? isCategoryMutationResponse(value)
+                                            : command === 'line-items-create' || command === 'line-items-rename'
+                                                ? isLineItemMutationResponse(value)
+                                                : command === 'transactions'
+                                                    ? isTransactionsResponse(value)
+                                                    : command === 'rules-list'
+                                                        ? isNotificationRuleListResponse(value)
+                                                        : command === 'rules-get' || command === 'rules-set'
+                                                            ? isNotificationRuleResponse(value)
+                                                            : command === 'rules-delete'
+                                                                ? isNotificationRuleDeleteResponse(value)
+                                                                : command === 'rules-scan-contract'
+                                                                    ? isRenewalExtractionResponse(value)
+                                                                    : command === 'receipts-extract'
+                                                                        ? isReceiptExtractResponse(value)
+                                                                        : command === 'receipts-get'
+                                                                            ? isReceiptLookupResponse(value)
+                                                                            : command === 'receipts-attach'
+                                                                                ? isReceiptMutationResponse(value)
+                                                                                : command === 'receipts-remove'
+                                                                                    ? isReceiptDeleteResponse(value)
+                                                                                    : command === 'assign'
+                                                                                        ? isAssignmentResponse(value)
+                                                                                        : command === 'ask-partner'
+                                                                                            ? isPartnerResponse(value)
+                                                                                            : command === 'goals-list'
+                                                                                                ? isGoalsResponse(value)
+                                                                                                : command === 'scenarios-list'
+                                                                                                    ? isScenariosResponse(value)
+                                                                                                    : command === 'scenarios-mutation'
+                                                                                                        ? isScenarioMutationResponse(value)
+                                                                                                        : command === 'goals-preview'
+                                                                                                            ? isGoalPreviewResponse(value)
+                                                                                                            : command === 'goals-delete'
+                                                                                                                ? isGoalDeleteResponse(value)
+                                                                                                                : isGoalMutationResponse(value);
     if (!valid) {
         const label = command === 'assign' ? 'assignment' : command;
         throw new ApiError(`Invalid ${label} response from the Agent API`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slothmoney/agent-cli",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description": "Command-line access to the Sloth Money Agent API.",
   "type": "module",
   "bin": {