@terminal3/t3n-sdk 5.10.0 → 5.11.0

package/dist/index.d.ts

@@ -5638,6 +5638,28 @@ declare class SessionUsageReportClient {
      * the partial count the node reports. The year forms cannot reach that.
      */
     getOrgCallCountForWindow(orgDid: string, fromMs: number, toMs: number): Promise<number>;
+    /**
+     * How many calls the organisation's agents made over `[fromMs, toMs)` in
+     * milliseconds — **including the ones that were refused or failed**, since
+     * reviewing agents means seeing what they attempted.
+     *
+     * That makes this figure independent of {@link getOrgCallCountForWindow}
+     * rather than a share of it: a window of nothing but refused agent calls
+     * reads non-zero here and zero there, so do not render one as a percentage
+     * of the other. The node keeps them as two contract exports for that reason,
+     * and each reply carries only its own number — asking for both is two reads.
+     * Both do exclude administrative dispatches, this read included.
+     *
+     * Agent or person comes from the actor classification stamped on each call
+     * when it happened — a call an agent made before its DID was classified as
+     * one stays in the human share for ever.
+     *
+     * Same window rules, same `not_org_admin: ...` refusal, and the same throw
+     * on a window too wide to read in one call as
+     * {@link getOrgCallCountForWindow}. There is no calendar-year form: pass the
+     * window you want, on whole UTC days.
+     */
+    getOrgAgentCallCountForWindow(orgDid: string, fromMs: number, toMs: number): Promise<number>;
 }
 /**
  * Construct a {@link SessionUsageReportClient} from a caller-owned