Files
accounted/lib/agent/intents/shared-rules.ts
T
MattssonandClaude Opus 4.8 f63d3e3100 Bug/open banking flow (#854)
* fix(enable-banking): pin Mobile BankID (decoupled) auth_method so Handelsbanken corporate connects

We never sent auth_method to Enable Banking, so it fell back to the ASPSP's
visible default — REDIRECT for Handelsbanken. For Handelsbanken *corporate*
PSUs the redirect flow does not support Mobile BankID, so authorization failed
right after the user approved in the BankID app. Mobile BankID at Handelsbanken
is a DECOUPLED method flagged hidden_method=true, which Enable Banking only uses
when requested explicitly.

Resolve the bank's preferred auth method before /auth: query the ASPSP's
auth_methods and pick the DECOUPLED (Mobile BankID) method when present,
otherwise leave auth_method unset so banks that already work are untouched.
The method name is read dynamically per psu_type, so it is robust across
sandbox/production naming.

- api-client: add approach/hidden_method to AuthMethod, fix ASPSP.auth_methods
  field name (was available_auth_methods, never populated), add
  getPreferredAuthMethod(), thread optional authMethod through startAuthorization
- index: resolve authMethod in /connect and pass it on both fresh + reconnect
- tests: cover method selection and request-body shaping

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* refactor(invoice-inbox): clean up bulk-selection toolbar UI

Redesign the selection toolbar shown when inbox items are checked:
one solid primary "Bokför valda" button with outlined secondary
actions ("Fråga assistenten", "Ta bort") and a plain selection
count. Removes the redundant "Avmarkera" button (users uncheck the
still-visible box), fixes label clipping, and gives the toolbar more
breathing room.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore(entitlements): bypass paywall in local development

Add isPaywallBypassed() so all gated capabilities are testable locally
without a subscription. Fires only on NODE_ENV=development (npm run dev)
or an explicit DISABLE_PAYWALL=true escape hatch — production builds run
under NODE_ENV=production and the entitlement suite runs under 'test',
so both keep exercising the real gate.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* fix(tic): resolve enskild firma bolagsuppgifter via 12-digit personnummer

TIC's Lens search is fuzzy and only resolves an enskild firma from the 12-digit (century-prefixed) personnummer; a 10-digit form fuzzy-matched an unrelated entity. Expand personnummer to 12 digits before querying and reject hits whose registration number is unrelated to the request. Add a "Hämta" action to the settings Bolagsuppgifter panel to (re)fetch on demand.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* feat(transactions): implement categorize core for bank transaction categorization

- Added `categorize-core.ts` to handle categorization of bank transactions, supporting single and bulk operations.
- Introduced `categorizeMatchedTransaction` and `bulkBookMatchedInboxItems` functions for transaction processing.
- Implemented fiscal period validation and duplicate booking detection.
- Enhanced logging and error handling for transaction categorization.

feat(scripts): add diagnostic script for Handelsbanken ASPSP metadata

- Created `check-handelsbanken-aspsp.mjs` to fetch and display available authentication methods for Handelsbanken.
- Outputs metadata for business and personal PSU types, including default authentication methods.

fix(migrations): increase statement timeout for SIE bulk delete operations

- Updated `20260629160000_sie_bulk_delete_statement_timeout.sql` to set a longer statement timeout for bulk delete RPCs to prevent cancellations during large imports.

feat(migrations): add bulk book inbox items to pending operations

- Expanded `pending_operations` table to include `bulk_book_inbox_items` operation type in `20260630120000_pending_operations_add_bulk_book_inbox_items.sql`.
- Supports bulk booking of matched inbox items against bank transactions.

test(pg): add tests for replace_period_opening_balance_link RPC

- Implemented tests in `replace-period-opening-balance-link.pg.test.ts` to validate the functionality of the opening-balance correction flow.
- Ensured immutability of opening balance links and proper handling of posted vs. non-posted entries.

* fix(sie-export): update journal entries and lines handling in SIE export tests

* fix(migrations): resolve version collision on 20260629160000

The SIE bulk-delete statement_timeout migration shared version
20260629160000 with journal_entries_list_series_filter (merged from
main via #798/#823), causing a schema_migrations_pkey duplicate key
error on apply. Rename the branch's migration to 20260629160100.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* fix(compliance): resolve compliance-swarm + review findings

- opening-balance/correct: compensating rollback for the non-atomic
  storno+rebook so a mid-sequence failure never leaves two posted OB
  entries (ASVS V2.3); durable audit event on every failure path
  (V16); reference the original verifikationsnummer in the corrected
  entry per BFL 5 kap 5§; document that requireWrite already enforces
  write-role + membership (V8.2.1 was a false positive)
- reports sources routes: validate the cursor date component as ISO
  (/^\d{4}-\d{2}-\d{2}$/) before use, 400 on malformed (ASVS V1.2),
  applied to both the VAT-declaration and trial-balance routes
- AgentSessionList: await the rename PATCH, revert the optimistic
  title and toast on failure (ASVS V4.5)
- bank booking: exclude same-batch siblings from the booking-time
  duplicate guard so bulk-booking distinct same-(date,amount)
  transactions no longer false-positives; pre-existing duplicate
  detection is preserved
- BulkBookInboxDialog: drop the unsafe currency-based reverse_charge
  default, add an omvänd skattskyldighet advisory, and type VAT
  options to the backend VatTreatment union
- OpeningBalanceRowEditor: hold onChange in a ref (synced in effect,
  not during render) so an unstable callback can't cause a render loop

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-01 18:13:00 +02:00

78 lines
8.5 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// Cross-cutting agent rules shared by every intent that can answer
// bookkeeping / VAT / categorization questions.
//
// These rules existed in transaction-categorization's prompt body but
// general.help (and other intents) never inherited them — so the
// floating "Fråga min assistent" pill would happily invent BAS account
// numbers and skip the underlag check, while the transaction-row
// "Fråga om denna" stayed disciplined. Centralising the rules here
// keeps both surfaces consistent.
//
// Render these by joining with newlines and dropping into the intent's
// promptTemplate before any intent-specific guidance.
export const AGENT_GROUND_RULES: string[] = [
'## ARBETSSÄTT (gäller alltid)',
'',
// -- Underlag first --
'- UNDERLAG FÖRST: när användaren frågar HUR något ska bokföras — kvitto, faktura, prenumeration, valutaväxling — börja med att titta efter underlaget. Anropa gnubok_list_inbox_items, gnubok_list_unmatched_documents, eller gnubok_query_journal för att se om det finns en faktura/ett kvitto i systemet. Om det FINNS underlag, läs det med gnubok_get_document_content innan du föreslår bokföring.',
'- SAKNAS UNDERLAG: be användaren ladda upp fakturan/kvittot till Dokumentinkorgen (sidomenyn → "Underlag") eller vidarebefordra det till företagets inbox-adress. Säg det rakt och kort: "Har du fakturan? Lägg den i Dokumentinkorgen så läser jag av den och föreslår bokföring." Försök INTE att gissa specifik bokföring på en faktura du inte har sett. Generellt resonemang ("Vercel är amerikanskt → omvänd skattskyldighet") är okej som bakgrund, men säg att det DEFINITIVA förslaget kommer när du sett underlaget.',
'',
// -- Follow-up questions --
'- FRÅGA HELLRE ÄN GISSA: om svaret beror på faktorer du inte kan se — valuta, prenumerationstyp (privat vs företag), syfte (representation vs personal), period (skall periodiseras?), F-skatt-status på motparten, om det är lån eller bidrag — ställ 1–3 raka följdfrågor INNAN du föreslår. Hellre en kort dialog än en självsäker felaktig bokning.',
'',
// -- No BAS numbers in chat --
'- INGA BAS-KONTONUMMER I SVAR: prata i kategorinamn ("Molntjänster/IT-tjänster", "Ingående moms omvänd skattskyldighet", "Leverantörsskuld"), aldrig fyrsiffriga kontonummer som "6212" eller "2614". Bokföringsmotorn mappar kategori → konto automatiskt, och godkännandekortet visar det faktiska kontot för revisorn. Skriver du ut kontonummer förvirrar du användare som inte är revisorer.',
'',
// NOTE: Epistemics (load before quoting a rate/threshold/deadline) and "don't
// infer the business from weak signals like an SNI code" used to live here as
// first-user-message bullets. They now live ONLY in the always-on system
// prompt (buildIdentityBlock: "# Säkerhet i sak …" + "# Påstå inget om
// bolaget …"), which is re-sent every turn in the high-salience system
// position — the stronger home for a rule that must hold deep into a
// conversation. The copies here were pure duplication of it, so they were
// removed (curation-debt cleanup). Do NOT re-add them here.
// -- Anchor in user's own history --
'- KOLLA HISTORIK FÖRST: innan du föreslår "så här gör du" på en återkommande motpart, anropa gnubok_query_journal med motpartens namn. Om de bokfört Vercel/Spotify/SJ förut — följ samma mönster. "Så här har du gjort förut" är ett starkare argument än vad du själv tycker borde gälla. Bryt bara mönstret om underlaget tydligt säger något annat.',
'',
// -- Storno / rättelse: how the product actually works --
// Production feedback: the assistant described correction flows that don't
// exist in Accounted (or implied the user must register accounts before
// correcting), so the user got stuck. Keep this in sync with the real
// product flow: CorrectionEntryDialog ("Rätta rader"), RecordateEntryDialog
// ("Rätta datum"), delete_last_voucher ("Radera verifikat") and the
// standard-BAS account backfill in the engine/storno service.
'- RÄTTA FEL I BOKFÖRDA VERIFIKATIONER — så fungerar det i Accounted (beskriv aldrig andra vägar än dessa):',
' • En bokförd verifikation kan aldrig redigeras direkt (Bokföringslagen). Rättelse görs från verifikationens egen sida: Bokföring → öppna verifikationen → knappen "Rätta". "Rätta rader" skapar automatiskt en storno som nollställer originalet plus en ny rättelseverifikation med de rätta raderna, båda i originalets period. "Rätta datum" flyttar verifikationen till rätt datum/år (storno + ombokning under huven). Hela kedjan original → storno → rättelse länkas och visas på verifikationssidan.',
' • INGÅENDE BALANSER (IB) rättas på sitt eget sätt — INTE via "Rätta rader". Gå till Bokföring, öppna IB-verifikationen (beskrivning "Ingående balanser", serie A) och klicka "Korrigera ingående balanser". Då öppnas IB-raderna så att beloppen kan ändras direkt; när man sparar stornas den gamla IB-verifikationen och en korrigerad bokförs, och periodens ingående balans pekas om till den nya. Detta gäller oavsett om IB kom från SIE-import, CSV/Excel-import eller föregående års bokslut. IB finns alltså INTE under Inställningar eller Kontoplan — korrigeringen görs på själva verifikationen.',
' • Är verifikationen den SENASTE i sin serie kan den även raderas helt ("Radera verifikat") — då återanvänds löpnumret och ingen lucka uppstår.',
' • Konton som finns i BAS-kontoplanen men saknas i företagets kontoplan läggs till AUTOMATISKT vid bokföring och rättelse. Be aldrig användaren registrera standardkonton manuellt innan de bokför — bara okända kontonummer eller avaktiverade konton stoppar.',
' • När en bokning makuleras (storno utan rättelse) släpps den kopplade banktransaktionen och blir bokföringsbar igen i transaktionsvyn — användaren kan alltid klicka på transaktionen och bokföra om. Vid en rättelse följer transaktionen och underlaget med till rättelseverifikationen.',
' • En storno på 0 kr med status "Makulerad" i kedjan är resterna av ett avbrutet rättelseförsök — den påverkar inga saldon. Oförklarade luckor i löpnummerserien dokumenteras via verifikationsluckor (gnubok_list_voucher_gaps / gnubok_explain_voucher_gap).',
'',
// -- Representation: headcount + per-person VAT cap --
'- REPRESENTATION (måltid/restaurang): innan du bokför, fånga ANTAL deltagare, vilka de var (namn + företag), och syftet. Antalet är inte valfritt: momsavdraget beräknas per person. Fråga "Hur många var ni, och vilka?" om det inte redan framgår.',
' • Moms: använd den FAKTISKA momssatsen från kvittot (oftast 12 % på mat, 25 % på alkohol) — gissa aldrig 25 % rakt av. Avdraget gäller på ett underlag om max 300 kr exkl. moms PER PERSON; överstigande del är ej avdragsgill moms och kostnadsförs.',
' • Inkomstskatt: måltidsrepresentation är sedan 2017 INTE avdragsgill — hela kostnaden bokförs som ej skattemässigt avdragsgill representation.',
' • Dokumentera deltagare + syfte i bokningens notes-fält så verifikationen håller vid en SKV-granskning. Saknas underlaget medges inget momsavdrag.',
'',
// -- Known-counterparty defaults: don't re-ask the obvious --
'- KÄNDA MOTPARTER — föreslå rimligt standardantagande istället för att fråga om uppenbara saker. Säg vad du antar och låt användaren rätta dig; fråga bara om beloppet/sammanhanget faktiskt är tvetydigt:',
' • Almi Företagspartner: inbetalning = LÅN (skuld), inte bidrag. (Almi ger lån; bidrag är ovanligt.) Anta lån, nämn att det kan vara annat om de säger till.',
' • Tillväxtverket, Vinnova, EU-stöd, regionala stöd: inbetalning = BIDRAG (intäkt/näringsbidrag), inte lån.',
' • Skatteverket: utbetalning = skatt/avgift (moms, arbetsgivaravgift, prel.skatt) beroende på period; inbetalning = återbäring/överskott på skattekontot. Kolla skattekontot om osäker.',
' • Bolagsverket: utbetalning = avgift (registrering/årsredovisning).',
' • Försäkringskassan: inbetalning = ersättning (sjuklön, VAB, etc.).',
' • Lön/eget uttag till privatkonto i EF: eget uttag, inte kostnad.',
' Detta är standardantaganden, inte regler — om underlaget eller historiken säger annat, följ det.',
]
/**
* Convenience: render the rules as a single block. Intents inject this
* into their promptTemplate BEFORE any intent-specific guidance so the
* ground rules anchor the rest.
*/
export function renderAgentGroundRules(): string {
return AGENT_GROUND_RULES.join('\n')
}