@terminal3/t3n-sdk 5.3.0 → 5.4.0

package/dist/index.d.ts

@@ -5256,6 +5256,35 @@ declare class SessionUsageReportClient {
      * org's usage.
      */
     getOrgUsageReport(input: OrgUsageReportInput): Promise<OrgUsageReport>;
+    /**
+     * Fetch how many calls an organisation's members and their agents have
+     * completed so far this calendar year (UTC).
+     *
+     * Counted by CALLER, not by contract owner, so calls into the platform's own
+     * system contracts count as the organisation's usage. Unsuccessful calls and
+     * admin-contract dispatches are excluded, the latter so that reading this
+     * number does not increase it.
+     *
+     * Refuses with `not_org_admin: ...` when the authenticated session DID is
+     * not in the org's admin set, exactly as {@link getOrgUsageReport} does.
+     */
+    getOrgCallCountThisYear(orgDid: string): Promise<number>;
+    /** As {@link getOrgCallCountThisYear}, for a given UTC calendar year. */
+    getOrgCallCountForYear(orgDid: string, year: number): Promise<number>;
+    /**
+     * As {@link getOrgCallCountThisYear}, over an explicit `[fromMs, toMs)`
+     * window in milliseconds.
+     *
+     * Pass whole UTC days (multiples of 86400000) unless you can live with a
+     * figure wider than its label: the counter has day granularity, so the node
+     * widens a ragged window to the days it touches and the count then includes
+     * the hours either side of what was asked for.
+     *
+     * Throws when the window covers more active days than the node reads in one
+     * call — roughly eleven years of unbroken daily use — rather than returning
+     * the partial count the node reports. The year forms cannot reach that.
+     */
+    getOrgCallCountForWindow(orgDid: string, fromMs: number, toMs: number): Promise<number>;
 }
 /**
  * Construct a {@link SessionUsageReportClient} from a caller-owned