@terminal3/t3n-sdk 5.3.0 → 5.5.0

package/dist/index.d.ts

@@ -1327,6 +1327,15 @@ interface ListAgentsResponse {
     agents: AgentSummary[];
     /** Opaque cursor for the next page; absent on the last page. */
     next_cursor?: string;
+    /**
+     * Members on THIS page that carry no kind row, so they appear in neither
+     * `listAgents` nor `listHumanMembers`. Non-zero means the page is not the
+     * whole membership — surface it rather than showing a silently short list.
+     *
+     * Absent when the environment runs a contract that predates the field; that
+     * is "not reported", not "none".
+     */
+    unclassified?: number;
 }
 /** A human member's org role. The closed wire domain of {@link HumanMember}. */
 type MemberRole = "admin" | "member";
@@ -1359,6 +1368,15 @@ interface ListHumanMembersResponse {
     members: HumanMember[];
     /** Opaque cursor for the next page; absent on the last page. */
     next_cursor?: string;
+    /**
+     * Members on THIS page that carry no kind row, so they appear in neither
+     * `listAgents` nor `listHumanMembers`. Non-zero means the page is not the
+     * whole membership — surface it rather than showing a silently short list.
+     *
+     * Absent when the environment runs a contract that predates the field; that
+     * is "not reported", not "none".
+     */
+    unclassified?: number;
 }
 /** Shallow runtime guard for {@link ListHumanMembersResponse}. */
 declare function isListHumanMembersResponse(value: unknown): value is ListHumanMembersResponse;
@@ -5256,6 +5274,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