aimeat 2.6.1 → 3.0.0

package/dist/src/models/connection-schemas.d.ts

@@ -92,12 +92,37 @@ export interface ConnectionRecord {
     lastError: string | null;
     createdAt: string;
     updatedAt: string;
+    /**
+     * WHICH client minted this token, when it was not the node's own.
+     *
+     * This exists because a refresh must be made by the SAME client that issued the token. A user who
+     * connects with their own app and is then refreshed with the node's app gets an invalid_grant they
+     * cannot read and a connection that dies on its first renewal, hours after it appeared to work.
+     *
+     * null means the node's configured client, which is both the default and every connection that
+     * existed before principals could bring their own.
+     */
+    providerClientId: string | null;
 }
 /**
  * What an app is allowed to see (decision K1). Enough to name the account in a picker and to show
  * that it needs attention; not enough to reason about the provider's scope vocabulary, whose
  * meaning an app cannot know. Capability questions go through a `can(capability)` ask instead.
  */
+/** One published item as a history view shows it: the attempt, plus who it went to. */
+export interface PublishHistoryItem {
+    id: string;
+    connectionId: string;
+    provider: string;
+    accountLabel: string;
+    status: PublishStatus;
+    externalRef: string | null;
+    storageKey: string;
+    error: string | null;
+    createdAt: string;
+    /** The most recent sample, when one has been taken. Null means nobody has asked yet. */
+    latest: PublishMetricSample | null;
+}
 export interface PublicConnection {
     id: string;
     provider: string;
@@ -192,12 +217,62 @@ export type PublishStatus = 'in_flight' | 'held' | 'queued' | 'done' | 'failed'
 export interface ProviderClientRecord {
     id: string;
     provider: string;
-    /** Instance origin, normalised and validated: it comes from a user, so it is an SSRF vector. */
-    instance: string;
+    /**
+     * Instance origin, normalised and validated: it comes from a user, so it is an SSRF vector.
+     * Null on a row that belongs to a principal rather than to an instance.
+     */
+    instance: string | null;
+    /**
+     * WHOSE client this is. Null means the NODE's own registration, acquired by registering at an
+     * instance and shared by everyone arriving from there.
+     *
+     * Non-null means a principal supplied their own app. That is the answer to the cost of a shared
+     * registration: everyone on one node otherwise appears to the provider as one application and
+     * shares its rate limit, its reputation and, at X, its bill. A principal who brings their own
+     * spends their own.
+     */
+    principal: string | null;
     clientId: string;
     clientSecret: string;
     registeredAt: string;
 }
+/**
+ * What a platform reports back about one published item, at one moment.
+ *
+ * A TIME SERIES AND NOT A FIELD ON THE ATTEMPT. "How did that post do" is a question about a curve:
+ * a number that only ever holds the latest value can say a post has 40 likes and can never say
+ * whether that happened in an hour or over a month, which is the part anyone deciding what to
+ * publish next actually needs.
+ *
+ * NORMALISED, WITH THE ORIGINAL KEPT. Every platform names these differently and measures slightly
+ * different things — a Mastodon "reblog", a Bluesky "repost", an X "retweet" and a LinkedIn "share"
+ * are cousins, not synonyms. The normalised fields make a comparison possible; `raw` keeps what the
+ * provider actually said, so a wrong mapping stays discoverable rather than becoming the only
+ * record. A field the provider does not report is null, never 0: absent and zero are different
+ * answers and collapsing them invents engagement that was never measured.
+ */
+export interface PublishMetricSample {
+    id: string;
+    attemptId: string;
+    /** When THIS node asked. Not when the platform computed it, which is rarely knowable. */
+    fetchedAt: string;
+    /** Views/impressions. Null where the platform does not report it to the author. */
+    impressions: number | null;
+    likes: number | null;
+    comments: number | null;
+    /** Reblogs, reposts, retweets, shares. Named once so a comparison is possible at all. */
+    shares: number | null;
+    /** Exactly what the provider returned, so a mapping mistake stays visible. */
+    raw: Record<string, unknown>;
+}
+/** A principal's own client as an app or panel may see it. NEVER carries the secret. */
+export interface PublicProviderClient {
+    provider: string;
+    clientId: string;
+    registeredAt: string;
+    /** How many of this principal's connections were minted by it, so deleting is an informed act. */
+    connectionCount: number;
+}
 /** Rows a caller may set when opening an attempt; the rest is the store's business. */
 export type NewPublishAttempt = Pick<PublishAttempt, 'id' | 'idempotencyKey' | 'publisher' | 'connectionId' | 'delegationId' | 'storageKey' | 'status'>;
 //# sourceMappingURL=connection-schemas.d.ts.map

package/dist/src/models/connection-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-schemas.d.ts","sourceRoot":"","sources":["../../../src/models/connection-schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connection-schemas.d.ts","sourceRoot":"","sources":["../../../src/models/connection-schemas.ts"],"names":[],"mappings":"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"}

package/dist/src/models/finance-schemas.d.ts

@@ -0,0 +1,268 @@
+/**
+ * @file finance-schemas.ts
+ * @description Record types for the generic finance domain: sales invoices, accounting
+ *   vouchers, the VAT-code registry and fiscal years. This is NOT a bookkeeping program —
+ *   the goal is a complete, VAT-itemized audit trail (tositeketju) and clean export for an
+ *   accountant. Corrections are made with credit notes and reversal vouchers, never by
+ *   mutating a sent invoice or a booked voucher (KPL audit-trail requirement).
+ *
+ *   Naming note: the record type `InvoiceRecord` here is a Finnish sales invoice
+ *   (myyntilasku, Finvoice 3.0). It is DISTINCT from the `io.aimeat.invoice` payment
+ *   handler in src/commerce/, which is a "settle offline" payment RAIL. Tables are
+ *   prefixed Finance* / finance_* to keep the two apart.
+ *
+ *   Money is integer minor units (cents) everywhere; quantities are integer thousandths;
+ *   VAT rates are basis points (2550 = 25.5 %). Rates live in the FinanceVatCode registry
+ *   with validity windows — never hardcoded (the reduced rate changed 14 % → 13.5 % on
+ *   2026-01-01, which is exactly why).
+ *
+ * @structure
+ *   - InvoiceParty / InvoiceLine / VatBreakdownEntry — jsonb value shapes
+ *   - InvoiceRecord — myyntilasku, immutable after leaving 'draft'
+ *   - VoucherRecord — tosite, append-only, sequential number per owner+fiscal year
+ *   - VatCodeRecord — node-global VAT registry with validity windows
+ *   - FiscalYearRecord — tilikausi with a lock that rejects new bookings
+ *   - Query types for the repository layer
+ *
+ * @usage import type { InvoiceRecord, ... } from '../models/finance-schemas.js';
+ *
+ * @version-history
+ *   v1.0.0 — 2026-08-06 — Company-in-a-box phase 1: initial finance domain.
+ */
+/** How an invoice may be delivered to the buyer. */
+export type InvoiceDeliveryMethod = 'finvoice' | 'email' | 'manual';
+/**
+ * Invoice lifecycle. Numbers and dates are assigned on the draft→sent transition so the
+ * invoice-number sequence stays gapless (deleted drafts never consume a number). After
+ * 'sent' the document is immutable; money-state moves sent→paid/overdue and corrections
+ * go through a credit note (type 'credit_note', creditsInvoiceId set), which flips the
+ * original to 'credited'.
+ */
+export type InvoiceStatus = 'draft' | 'sent' | 'paid' | 'overdue' | 'credited' | 'cancelled';
+export type InvoiceType = 'invoice' | 'credit_note';
+/** Delivery outcome reported by the e-invoice operator (or the email door). */
+export type InvoiceDeliveryStatus = 'pending' | 'delivered' | 'rejected';
+/**
+ * Party snapshot embedded in the invoice. A snapshot, not a contact reference: the
+ * bookkeeping record must show the party as it was at invoice time even if the contact
+ * is edited or deleted later.
+ */
+export interface InvoiceParty {
+    /** Display / legal name. */
+    name: string;
+    /** Finnish business id (Y-tunnus), e.g. "3323553-5". */
+    businessId?: string;
+    /** EU VAT id, e.g. "FI33235535". */
+    vatId?: string;
+    /** Contact id in the owner's contact book (buyer only; sellers have no contact). */
+    contactId?: string;
+    email?: string;
+    streetAddress?: string;
+    postalCode?: string;
+    city?: string;
+    /** ISO 3166-1 alpha-2, default FI. */
+    country?: string;
+    /** E-invoicing address (verkkolaskuosoite / OVT), e.g. "003733235535". */
+    einvoiceAddress?: string;
+    /** E-invoice operator id (välittäjätunnus), e.g. "003721291126" (Maventa). */
+    einvoiceOperator?: string;
+    /** Seller bank account for payment (IBAN) — seller side only. */
+    iban?: string;
+    bic?: string;
+}
+/** One invoice line. All derived amounts are precomputed and stored (audit trail). */
+export interface InvoiceLine {
+    description: string;
+    /** Quantity in thousandths: 1500 = 1.5 units. */
+    quantityMilli: number;
+    /** Unit label shown on the invoice, e.g. "h", "kpl", "pcs". */
+    unit: string;
+    /** Net unit price in minor units (cents). */
+    unitPriceMinor: number;
+    /** FinanceVatCode id applied to this line. */
+    vatCodeId: string;
+    /** VAT rate snapshot in basis points (2550 = 25.5 %) at invoice time. */
+    vatRateBp: number;
+    /** Line net = round(quantityMilli * unitPriceMinor / 1000), cents. */
+    netMinor: number;
+    /** Line VAT = round(netMinor * vatRateBp / 10000), cents. */
+    vatMinor: number;
+    /** netMinor + vatMinor, cents. */
+    grossMinor: number;
+}
+/** Per-VAT-code totals, used on both invoices and vouchers. */
+export interface VatBreakdownEntry {
+    vatCodeId: string;
+    vatRateBp: number;
+    netMinor: number;
+    vatMinor: number;
+}
+/**
+ * A sales invoice (myyntilasku). Owned by the seller GHII; optionally grouped under an
+ * organism so an accountant role scoped to the organism can read it.
+ */
+export interface InvoiceRecord {
+    id: string;
+    /** Seller owner GHII (resolveIdentity output). Authorization happens in the route. */
+    ownerGhii: string;
+    /** Optional grouping to the company organism. Plain column, no FK. */
+    organismId: string | null;
+    type: InvoiceType;
+    /** For credit notes: the invoice this credits. */
+    creditsInvoiceId: string | null;
+    status: InvoiceStatus;
+    /** Sequential number per owner, assigned at send. Null while draft. */
+    numberSeq: number | null;
+    /** Display number, e.g. "2026-14". Null while draft. */
+    invoiceNumber: string | null;
+    seller: InvoiceParty;
+    buyer: InvoiceParty;
+    lines: InvoiceLine[];
+    /** ISO 4217; v1 always EUR. */
+    currency: string;
+    totalNetMinor: number;
+    totalVatMinor: number;
+    totalGrossMinor: number;
+    vatBreakdown: VatBreakdownEntry[];
+    /** Finnish reference (viitenumero) or RF creditor reference. Assigned at send. */
+    referenceNumber: string | null;
+    paymentTermsDays: number;
+    /** Invoice date (ISO date), set at send. */
+    invoiceDate: string | null;
+    dueDate: string | null;
+    deliveryMethod: InvoiceDeliveryMethod | null;
+    sentAt: string | null;
+    deliveryStatus: InvoiceDeliveryStatus | null;
+    /** Operator-side message id for delivery status callbacks. */
+    operatorMessageId: string | null;
+    /** Storage key of the generated Finvoice 3.0 XML. */
+    finvoiceXmlKey: string | null;
+    paidAt: string | null;
+    /** Commerce trackingCode when payment arrived through the checkout/wallet rails. */
+    paidTrackingCode: string | null;
+    /** External payment reference (e.g. a bank archive id or Stripe id). */
+    externalRef: string | null;
+    fiscalYearId: string | null;
+    notes: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Where a voucher came from. */
+export type VoucherSource = 'stripe' | 'checkout' | 'invoice' | 'receipt' | 'manual' | 'morsel';
+/**
+ * 'transfer' is money moving between the company's own balances (e.g. a Stripe payout to
+ * the bank account): it needs a voucher for the audit trail but is neither revenue nor
+ * cost — the VAT report and P&L skip it, which is what prevents double counting.
+ */
+export type VoucherDirection = 'income' | 'expense' | 'transfer';
+/**
+ * An accounting voucher (tosite). Append-only: once created it is never edited or
+ * deleted; a mistake is corrected with a new voucher whose reversesVoucherId points
+ * back. Attachments (receipt images) may be added after creation — that augments the
+ * evidence, it does not change the booking.
+ */
+export interface VoucherRecord {
+    id: string;
+    ownerGhii: string;
+    organismId: string | null;
+    fiscalYearId: string;
+    /** Sequential per owner + fiscal year, claimed atomically at create. */
+    voucherNumber: number;
+    /** Booking date (ISO date). Must fall inside the fiscal year. */
+    date: string;
+    description: string;
+    direction: VoucherDirection;
+    source: VoucherSource;
+    /** Gross amount in minor units (cents), always positive; direction carries the sign. */
+    amountMinor: number;
+    currency: string;
+    vatBreakdown: VatBreakdownEntry[];
+    /** Free-text counterparty (payer/payee) when there is no contact. */
+    counterparty: string | null;
+    invoiceId: string | null;
+    /** Commerce trackingCode — the universal join key to checkout/wallet/payables. */
+    trackingCode: string | null;
+    /** External system reference (Stripe charge/payout id, bank archive id). Used for webhook idempotency. */
+    externalRef: string | null;
+    /** Storage keys of attached evidence (receipt images, PDFs). */
+    attachments: string[];
+    /** Set when this voucher reverses an earlier one. */
+    reversesVoucherId: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export type VatCategory = 'standard' | 'reduced' | 'zero' | 'exempt' | 'reverse_charge';
+/**
+ * Node-global VAT code. Seeded with the Finnish registry (see services/finance/vat-codes.ts)
+ * and extensible by the operator. Validity windows make rate changes data, not code.
+ */
+export interface VatCodeRecord {
+    /** Stable id, e.g. "fi-std-2550". */
+    id: string;
+    countryCode: string;
+    category: VatCategory;
+    /** Rate in basis points: 2550 = 25.5 %. */
+    rateBp: number;
+    label: {
+        en: string;
+        fi: string;
+    };
+    /** ISO date this code becomes valid. */
+    validFrom: string;
+    /** ISO date after which the code no longer applies; null = open-ended. */
+    validTo: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * A fiscal year (tilikausi). Locking is the accountant's period close: a locked year
+ * rejects new vouchers and any invoice send dated inside it.
+ */
+export interface FiscalYearRecord {
+    id: string;
+    ownerGhii: string;
+    organismId: string | null;
+    /** Display label, e.g. "2026". */
+    label: string;
+    /** ISO date, inclusive. */
+    startDate: string;
+    /** ISO date, inclusive. */
+    endDate: string;
+    locked: boolean;
+    lockedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Repository query narrowing for invoices. */
+export interface InvoiceQuery {
+    ownerGhii: string;
+    organismId?: string;
+    status?: InvoiceStatus | InvoiceStatus[];
+    type?: InvoiceType;
+    buyerContactId?: string;
+    /** invoiceDate >= from (ISO date). */
+    from?: string;
+    /** invoiceDate <= to (ISO date). */
+    to?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Repository query narrowing for vouchers. */
+export interface VoucherQuery {
+    ownerGhii: string;
+    organismId?: string;
+    fiscalYearId?: string;
+    source?: VoucherSource;
+    direction?: VoucherDirection;
+    /** date >= from (ISO date). */
+    from?: string;
+    /** date <= to (ISO date). */
+    to?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Fields a caller may set when creating an invoice draft (the rest is computed/assigned). */
+export type NewInvoiceDraft = Pick<InvoiceRecord, 'ownerGhii' | 'organismId' | 'type' | 'creditsInvoiceId' | 'seller' | 'buyer' | 'currency' | 'paymentTermsDays' | 'notes'> & {
+    lines: Omit<InvoiceLine, 'netMinor' | 'vatMinor' | 'grossMinor' | 'vatRateBp'>[];
+};
+//# sourceMappingURL=finance-schemas.d.ts.map

package/dist/src/models/finance-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finance-schemas.d.ts","sourceRoot":"","sources":["../../../src/models/finance-schemas.ts"],"names":[],"mappings":"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"}

package/dist/src/models/finance-schemas.js

@@ -0,0 +1,33 @@
+/**
+ * @file finance-schemas.ts
+ * @description Record types for the generic finance domain: sales invoices, accounting
+ *   vouchers, the VAT-code registry and fiscal years. This is NOT a bookkeeping program —
+ *   the goal is a complete, VAT-itemized audit trail (tositeketju) and clean export for an
+ *   accountant. Corrections are made with credit notes and reversal vouchers, never by
+ *   mutating a sent invoice or a booked voucher (KPL audit-trail requirement).
+ *
+ *   Naming note: the record type `InvoiceRecord` here is a Finnish sales invoice
+ *   (myyntilasku, Finvoice 3.0). It is DISTINCT from the `io.aimeat.invoice` payment
+ *   handler in src/commerce/, which is a "settle offline" payment RAIL. Tables are
+ *   prefixed Finance* / finance_* to keep the two apart.
+ *
+ *   Money is integer minor units (cents) everywhere; quantities are integer thousandths;
+ *   VAT rates are basis points (2550 = 25.5 %). Rates live in the FinanceVatCode registry
+ *   with validity windows — never hardcoded (the reduced rate changed 14 % → 13.5 % on
+ *   2026-01-01, which is exactly why).
+ *
+ * @structure
+ *   - InvoiceParty / InvoiceLine / VatBreakdownEntry — jsonb value shapes
+ *   - InvoiceRecord — myyntilasku, immutable after leaving 'draft'
+ *   - VoucherRecord — tosite, append-only, sequential number per owner+fiscal year
+ *   - VatCodeRecord — node-global VAT registry with validity windows
+ *   - FiscalYearRecord — tilikausi with a lock that rejects new bookings
+ *   - Query types for the repository layer
+ *
+ * @usage import type { InvoiceRecord, ... } from '../models/finance-schemas.js';
+ *
+ * @version-history
+ *   v1.0.0 — 2026-08-06 — Company-in-a-box phase 1: initial finance domain.
+ */
+export {};
+//# sourceMappingURL=finance-schemas.js.map

package/dist/src/models/finance-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finance-schemas.js","sourceRoot":"","sources":["../../../src/models/finance-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG"}

package/dist/src/models/message-schemas.d.ts

@@ -7,6 +7,8 @@
  * @structure MessageAttachmentInputSchema, InteractivePayloadSchema, MessageSendSchema
  * @usage import { MessageSendSchema } from '../models/message-schemas.js';
  * @version-history
+ *   v1.3.0 -- 2026-08-11 -- `to` accepts a named group address (support@operators) and is optional
+ *     when conversation_id names a group thread: a reply into a group is addressed to the thread.
  *   Text limits raised — 2026-07-30 — prompts/labels to 10 000 and bodies to 200 000.
  *   v1.0.0 -- 2026-06-16 -- Initial creation for user-to-user messaging (layer 2: local messaging).
  *   v1.2.0 -- 2026-08-01 -- Voice messages: an attachment may carry `duration_seconds` and a
@@ -101,7 +103,7 @@ export declare const InteractivePayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObj
     }, z.core.$strip>>;
 }, z.core.$strip>], "role">;
 export declare const MessageSendSchema: z.ZodObject<{
-    to: z.ZodString;
+    to: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     body: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     reply_to: z.ZodOptional<z.ZodString>;
     conversation_id: z.ZodOptional<z.ZodString>;

package/dist/src/models/message-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-schemas.d.ts","sourceRoot":"","sources":["../../../src/models/message-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;iBA2BvC,CAAC;AAIH,wDAAwD;AACxD,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,yBAAyB;;;;;;;;;;;iBAQpC,CAAC;AAEH,kGAAkG;AAClG,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;2BAanC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB7B,CAAC;AAIF;;uEAEuE;AACvE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAc/B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACjE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC/E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACjF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"message-schemas.d.ts","sourceRoot":"","sources":["../../../src/models/message-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;iBA2BvC,CAAC;AAIH,wDAAwD;AACxD,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,yBAAyB;;;;;;;;;;;iBAQpC,CAAC;AAEH,kGAAkG;AAClG,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;2BAanC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsB7B,CAAC;AAIF;;uEAEuE;AACvE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAc/B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACjE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC/E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACjF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/src/models/message-schemas.js

@@ -7,6 +7,8 @@
  * @structure MessageAttachmentInputSchema, InteractivePayloadSchema, MessageSendSchema
  * @usage import { MessageSendSchema } from '../models/message-schemas.js';
  * @version-history
+ *   v1.3.0 -- 2026-08-11 -- `to` accepts a named group address (support@operators) and is optional
+ *     when conversation_id names a group thread: a reply into a group is addressed to the thread.
  *   Text limits raised — 2026-07-30 — prompts/labels to 10 000 and bodies to 200 000.
  *   v1.0.0 -- 2026-06-16 -- Initial creation for user-to-user messaging (layer 2: local messaging).
  *   v1.2.0 -- 2026-08-01 -- Voice messages: an attachment may carry `duration_seconds` and a
@@ -90,8 +92,13 @@ export const InteractivePayloadSchema = z.discriminatedUnion('role', [
     }),
 ]);
 export const MessageSendSchema = z.object({
-    /** Recipient — a human GHII (owner@node). */
-    to: z.string().min(3).max(256),
+    /**
+     * Recipient: a human GHII (`owner@node`), an agent (`agent#owner@node`), an app
+     * (`eco:app#owner@node`), or a NAMED GROUP address — `support@operators`, which reaches whoever
+     * runs this node. Optional when `conversation_id` names an existing group thread, because a reply
+     * into a group is addressed to the thread rather than to one of the people in it.
+     */
+    to: z.string().min(3).max(256).optional().default(''),
     /** GFM markdown body. May be empty when sending attachment-only. */
     body: z.string().max(200_000).optional().default(''),
     /** Id of a message being replied to (same conversation). */

package/dist/src/models/message-schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-schemas.js","sourceRoot":"","sources":["../../../src/models/message-schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"message-schemas.js","sourceRoot":"","sources":["../../../src/models/message-schemas.ts"],"names":[],"mappings":"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"}

package/dist/src/models/outbound-schemas.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @file outbound-schemas.ts
+ * @description Record types for the outbound messaging door: the recipient registry
+ *   (outbound contacts) and the append-only send log. The registry is the structural
+ *   anti-spam device — /v1/outbound/send takes a contact id, never a free address, so
+ *   every recipient is a deliberately saved entry with its own opt-out and bounce state.
+ *
+ *   Distinct from /v1/contacts (ContactConsentRecord), which is GHII↔GHII messaging
+ *   consent between AIMEAT identities. An outbound contact is a customer/lead with an
+ *   EMAIL, who may or may not have an AIMEAT identity — when they do (resolved via the
+ *   privacy-preserving email hash), delivery prefers their AIMEAT inbox+push and email
+ *   becomes the fallback.
+ *
+ * @structure OutboundContactRecord · OutboundMessageRecord (send log) · query types
+ * @usage import type { OutboundContactRecord, ... } from '../models/outbound-schemas.js';
+ * @version-history
+ *   v1.0.0 — 2026-08-06 — Company-in-a-box phase 2: outbound door.
+ */
+/**
+ * A saved outbound recipient. Opt-out blocks marketing sends (transactional and
+ * invoice sends still go through — a customer cannot opt out of their own invoice).
+ * Three bounces suppress the address entirely until the owner clears it.
+ */
+export interface OutboundContactRecord {
+    id: string;
+    ownerGhii: string;
+    name: string;
+    email: string;
+    /** Resolved AIMEAT identity (GHII) when the email belongs to a registered user here. */
+    ghii: string | null;
+    tags: string[];
+    optedOut: boolean;
+    optOutAt: string | null;
+    /** Unguessable token for the public unsubscribe link. */
+    optOutToken: string;
+    bounceCount: number;
+    /** Set at the third bounce; a suppressed address rejects every send. */
+    suppressedAt: string | null;
+    notes: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export type OutboundChannel = 'inbox' | 'email';
+/**
+ * Message intent. 'marketing' requires the opt-out link and is blocked by opt-out;
+ * 'transactional' and 'invoice' are operational messages the relationship itself implies.
+ */
+export type OutboundKind = 'transactional' | 'marketing' | 'invoice';
+export type OutboundStatus = 'sent' | 'failed' | 'suppressed' | 'skipped';
+/** One row of the append-only send log (the GDPR-answerable record of what left the node). */
+export interface OutboundMessageRecord {
+    id: string;
+    ownerGhii: string;
+    contactId: string;
+    channel: OutboundChannel;
+    kind: OutboundKind;
+    subject: string;
+    /** Memory-record template id when a template was used. */
+    templateId: string | null;
+    status: OutboundStatus;
+    error: string | null;
+    invoiceId: string | null;
+    createdAt: string;
+}
+export interface OutboundContactQuery {
+    ownerGhii: string;
+    optedOut?: boolean;
+    suppressed?: boolean;
+    tag?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface OutboundLogQuery {
+    ownerGhii: string;
+    contactId?: string;
+    kind?: OutboundKind;
+    status?: OutboundStatus;
+    limit?: number;
+    offset?: number;
+}
+//# sourceMappingURL=outbound-schemas.d.ts.map

package/dist/src/models/outbound-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-schemas.d.ts","sourceRoot":"","sources":["../../../src/models/outbound-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,WAAW,GAAG,SAAS,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;AAE1E,8FAA8F;AAC9F,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/src/models/outbound-schemas.js

@@ -0,0 +1,20 @@
+/**
+ * @file outbound-schemas.ts
+ * @description Record types for the outbound messaging door: the recipient registry
+ *   (outbound contacts) and the append-only send log. The registry is the structural
+ *   anti-spam device — /v1/outbound/send takes a contact id, never a free address, so
+ *   every recipient is a deliberately saved entry with its own opt-out and bounce state.
+ *
+ *   Distinct from /v1/contacts (ContactConsentRecord), which is GHII↔GHII messaging
+ *   consent between AIMEAT identities. An outbound contact is a customer/lead with an
+ *   EMAIL, who may or may not have an AIMEAT identity — when they do (resolved via the
+ *   privacy-preserving email hash), delivery prefers their AIMEAT inbox+push and email
+ *   becomes the fallback.
+ *
+ * @structure OutboundContactRecord · OutboundMessageRecord (send log) · query types
+ * @usage import type { OutboundContactRecord, ... } from '../models/outbound-schemas.js';
+ * @version-history
+ *   v1.0.0 — 2026-08-06 — Company-in-a-box phase 2: outbound door.
+ */
+export {};
+//# sourceMappingURL=outbound-schemas.js.map

package/dist/src/models/outbound-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-schemas.js","sourceRoot":"","sources":["../../../src/models/outbound-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/src/models/schemas.d.ts

@@ -13,6 +13,9 @@
  *   - validateBody(schema, nodeId): Express middleware wiring a schema to the request pipeline
  *
  * @version-history
+ *   Password floor unsplit — 2026-08-12 — GhiiRegistrationSchema drops password.min(8). The rule was
+ *     duplicated in validatePasswordStrength, and the schema copy answered first, so a short password
+ *     came back VALIDATION_ERROR instead of the WEAK_PASSWORD the route documents and clients branch on.
  *   Text limits raised — 2026-07-30 — descriptions/reasons/messages to 10 000, bodies to 200 000.
  *   v1.0.0 — 2026-07-13 — Header added; file pre-dates header standard
  */