@opengeni/contracts 3.1.0-canary.1 → 3.1.2

package/dist/organization-model-usage.d.ts

@@ -0,0 +1,146 @@
+import { z } from "zod";
+/** Exact per-billing-path sums from per-call model facts; bigint sums stay strings. */
+export declare const OrganizationModelUsageTotals: z.ZodObject<{
+    billingPath: z.ZodEnum<{
+        external: "external";
+        opengeni_credits: "opengeni_credits";
+    }>;
+    calls: z.ZodString;
+    inputTokens: z.ZodString;
+    outputTokens: z.ZodString;
+    cachedTokens: z.ZodString;
+    cacheInputTokens: z.ZodString;
+    cacheWriteTokens: z.ZodString;
+    totalTokens: z.ZodString;
+    tokenKnownCalls: z.ZodString;
+    cacheKnownCalls: z.ZodString;
+    creditMicros: z.ZodString;
+    estimatedProviderMicros: z.ZodString;
+    estimatedProviderKnownCalls: z.ZodString;
+}, z.core.$strip>;
+export type OrganizationModelUsageTotals = z.infer<typeof OrganizationModelUsageTotals>;
+export declare const OrganizationModelUsageQuery: z.ZodObject<{
+    period: z.ZodDefault<z.ZodEnum<{
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>>;
+    afterWorkspaceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const OrganizationModelUsage: z.ZodObject<{
+    accountId: z.ZodString;
+    period: z.ZodEnum<{
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>;
+    since: z.ZodString;
+    until: z.ZodString;
+    billing: z.ZodArray<z.ZodObject<{
+        billingPath: z.ZodEnum<{
+            external: "external";
+            opengeni_credits: "opengeni_credits";
+        }>;
+        calls: z.ZodString;
+        inputTokens: z.ZodString;
+        outputTokens: z.ZodString;
+        cachedTokens: z.ZodString;
+        cacheInputTokens: z.ZodString;
+        cacheWriteTokens: z.ZodString;
+        totalTokens: z.ZodString;
+        tokenKnownCalls: z.ZodString;
+        cacheKnownCalls: z.ZodString;
+        creditMicros: z.ZodString;
+        estimatedProviderMicros: z.ZodString;
+        estimatedProviderKnownCalls: z.ZodString;
+    }, z.core.$strip>>;
+    payers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        calls: z.ZodString;
+        inputTokens: z.ZodString;
+        outputTokens: z.ZodString;
+        cachedTokens: z.ZodString;
+        cacheInputTokens: z.ZodString;
+        cacheWriteTokens: z.ZodString;
+        totalTokens: z.ZodString;
+        tokenKnownCalls: z.ZodString;
+        cacheKnownCalls: z.ZodString;
+        creditMicros: z.ZodString;
+        estimatedProviderMicros: z.ZodString;
+        estimatedProviderKnownCalls: z.ZodString;
+        payer: z.ZodEnum<{
+            opengeni_credits: "opengeni_credits";
+            own_key: "own_key";
+            subscription: "subscription";
+        }>;
+    }, z.core.$strip>>>;
+    models: z.ZodArray<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+        totals: z.ZodObject<{
+            billingPath: z.ZodEnum<{
+                external: "external";
+                opengeni_credits: "opengeni_credits";
+            }>;
+            calls: z.ZodString;
+            inputTokens: z.ZodString;
+            outputTokens: z.ZodString;
+            cachedTokens: z.ZodString;
+            cacheInputTokens: z.ZodString;
+            cacheWriteTokens: z.ZodString;
+            totalTokens: z.ZodString;
+            tokenKnownCalls: z.ZodString;
+            cacheKnownCalls: z.ZodString;
+            creditMicros: z.ZodString;
+            estimatedProviderMicros: z.ZodString;
+            estimatedProviderKnownCalls: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    modelsTruncated: z.ZodBoolean;
+    workspaces: z.ZodArray<z.ZodObject<{
+        workspaceId: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        billing: z.ZodArray<z.ZodObject<{
+            billingPath: z.ZodEnum<{
+                external: "external";
+                opengeni_credits: "opengeni_credits";
+            }>;
+            calls: z.ZodString;
+            inputTokens: z.ZodString;
+            outputTokens: z.ZodString;
+            cachedTokens: z.ZodString;
+            cacheInputTokens: z.ZodString;
+            cacheWriteTokens: z.ZodString;
+            totalTokens: z.ZodString;
+            tokenKnownCalls: z.ZodString;
+            cacheKnownCalls: z.ZodString;
+            creditMicros: z.ZodString;
+            estimatedProviderMicros: z.ZodString;
+            estimatedProviderKnownCalls: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    personal: z.ZodObject<{
+        workspacesWithUsage: z.ZodString;
+        billing: z.ZodArray<z.ZodObject<{
+            billingPath: z.ZodEnum<{
+                external: "external";
+                opengeni_credits: "opengeni_credits";
+            }>;
+            calls: z.ZodString;
+            inputTokens: z.ZodString;
+            outputTokens: z.ZodString;
+            cachedTokens: z.ZodString;
+            cacheInputTokens: z.ZodString;
+            cacheWriteTokens: z.ZodString;
+            totalTokens: z.ZodString;
+            tokenKnownCalls: z.ZodString;
+            cacheKnownCalls: z.ZodString;
+            creditMicros: z.ZodString;
+            estimatedProviderMicros: z.ZodString;
+            estimatedProviderKnownCalls: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    nextWorkspaceCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type OrganizationModelUsage = z.infer<typeof OrganizationModelUsage>;

package/dist/organization-model-usage.js

@@ -0,0 +1,78 @@
+import {
+  OrganizationUsagePeriod,
+  OrganizationUsageQuery
+} from "./chunk-J4HQ3UKY.js";
+import {
+  defineSchema
+} from "./chunk-56SNIMDO.js";
+
+// src/organization-model-usage.ts
+import { z } from "zod";
+var BigIntString = /* @__PURE__ */ defineSchema(() => z.string().regex(/^\d+$/));
+var OrganizationModelUsageBillingPath = /* @__PURE__ */ defineSchema(
+  () => z.enum(["opengeni_credits", "external"])
+);
+var OrganizationModelUsageTotals = /* @__PURE__ */ defineSchema(
+  () => z.object({
+    billingPath: OrganizationModelUsageBillingPath,
+    calls: BigIntString,
+    inputTokens: BigIntString,
+    outputTokens: BigIntString,
+    cachedTokens: BigIntString,
+    cacheInputTokens: BigIntString,
+    cacheWriteTokens: BigIntString,
+    totalTokens: BigIntString,
+    tokenKnownCalls: BigIntString,
+    cacheKnownCalls: BigIntString,
+    creditMicros: BigIntString,
+    estimatedProviderMicros: BigIntString,
+    estimatedProviderKnownCalls: BigIntString
+  })
+);
+var OrganizationModelUsageQuery = /* @__PURE__ */ defineSchema(
+  () => OrganizationUsageQuery.extend({
+    afterWorkspaceId: z.string().uuid().optional()
+  })
+);
+var OrganizationModelUsage = /* @__PURE__ */ defineSchema(
+  () => z.object({
+    accountId: z.string().uuid(),
+    period: OrganizationUsagePeriod,
+    since: z.string().datetime(),
+    until: z.string().datetime(),
+    billing: z.array(OrganizationModelUsageTotals).max(2),
+    /** Exact uncapped per-fact payer split; independent of the top-model list. */
+    payers: z.array(
+      OrganizationModelUsageTotals.omit({ billingPath: true }).extend({
+        payer: z.enum(["opengeni_credits", "subscription", "own_key"])
+      })
+    ).default([]),
+    models: z.array(
+      z.object({
+        provider: z.string(),
+        model: z.string(),
+        totals: OrganizationModelUsageTotals
+      })
+    ).max(50),
+    modelsTruncated: z.boolean(),
+    workspaces: z.array(
+      z.object({
+        workspaceId: z.string().uuid(),
+        name: z.string().nullable(),
+        billing: z.array(OrganizationModelUsageTotals).max(2)
+      })
+    ).max(50),
+    /** Every Personal workspace, aggregated; individual Personal workspaces are never named. */
+    personal: z.object({
+      workspacesWithUsage: BigIntString,
+      billing: z.array(OrganizationModelUsageTotals).max(2)
+    }),
+    nextWorkspaceCursor: z.string().uuid().nullable()
+  })
+);
+export {
+  OrganizationModelUsage,
+  OrganizationModelUsageQuery,
+  OrganizationModelUsageTotals
+};
+//# sourceMappingURL=organization-model-usage.js.map

package/dist/organization-model-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/organization-model-usage.ts"],"sourcesContent":["import { defineSchema } from \"./define-schema\";\n// Server-parsed only; kept off the root contracts index so browser bundles that\n// import the root never carry these schemas.\nimport { z } from \"zod\";\n\nimport { OrganizationUsagePeriod, OrganizationUsageQuery } from \"./organization-usage\";\n\nconst BigIntString = /* @__PURE__ */ defineSchema(() => z.string().regex(/^\\d+$/));\nconst OrganizationModelUsageBillingPath = /* @__PURE__ */ defineSchema(() =>\n  z.enum([\"opengeni_credits\", \"external\"]),\n);\n\n/** Exact per-billing-path sums from per-call model facts; bigint sums stay strings. */\nexport const OrganizationModelUsageTotals = /* @__PURE__ */ defineSchema(() =>\n  z.object({\n    billingPath: OrganizationModelUsageBillingPath,\n    calls: BigIntString,\n    inputTokens: BigIntString,\n    outputTokens: BigIntString,\n    cachedTokens: BigIntString,\n    cacheInputTokens: BigIntString,\n    cacheWriteTokens: BigIntString,\n    totalTokens: BigIntString,\n    tokenKnownCalls: BigIntString,\n    cacheKnownCalls: BigIntString,\n    creditMicros: BigIntString,\n    estimatedProviderMicros: BigIntString,\n    estimatedProviderKnownCalls: BigIntString,\n  }),\n);\nexport type OrganizationModelUsageTotals = z.infer<typeof OrganizationModelUsageTotals>;\n\nexport const OrganizationModelUsageQuery = /* @__PURE__ */ defineSchema(() =>\n  OrganizationUsageQuery.extend({\n    afterWorkspaceId: z.string().uuid().optional(),\n  }),\n);\n\nexport const OrganizationModelUsage = /* @__PURE__ */ defineSchema(() =>\n  z.object({\n    accountId: z.string().uuid(),\n    period: OrganizationUsagePeriod,\n    since: z.string().datetime(),\n    until: z.string().datetime(),\n    billing: z.array(OrganizationModelUsageTotals).max(2),\n    /** Exact uncapped per-fact payer split; independent of the top-model list. */\n    payers: z\n      .array(\n        OrganizationModelUsageTotals.omit({ billingPath: true }).extend({\n          payer: z.enum([\"opengeni_credits\", \"subscription\", \"own_key\"]),\n        }),\n      )\n      .default([]),\n    models: z\n      .array(\n        z.object({\n          provider: z.string(),\n          model: z.string(),\n          totals: OrganizationModelUsageTotals,\n        }),\n      )\n      .max(50),\n    modelsTruncated: z.boolean(),\n    workspaces: z\n      .array(\n        z.object({\n          workspaceId: z.string().uuid(),\n          name: z.string().nullable(),\n          billing: z.array(OrganizationModelUsageTotals).max(2),\n        }),\n      )\n      .max(50),\n    /** Every Personal workspace, aggregated; individual Personal workspaces are never named. */\n    personal: z.object({\n      workspacesWithUsage: BigIntString,\n      billing: z.array(OrganizationModelUsageTotals).max(2),\n    }),\n    nextWorkspaceCursor: z.string().uuid().nullable(),\n  }),\n);\nexport type OrganizationModelUsage = z.infer<typeof OrganizationModelUsage>;\n"],"mappings":";;;;;;;;;AAGA,SAAS,SAAS;AAIlB,IAAM,eAA+B,6BAAa,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACjF,IAAM,oCAAoD;AAAA,EAAa,MACrE,EAAE,KAAK,CAAC,oBAAoB,UAAU,CAAC;AACzC;AAGO,IAAM,+BAA+C;AAAA,EAAa,MACvE,EAAE,OAAO;AAAA,IACP,aAAa;AAAA,IACb,OAAO;AAAA,IACP,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc;AAAA,IACd,kBAAkB;AAAA,IAClB,kBAAkB;AAAA,IAClB,aAAa;AAAA,IACb,iBAAiB;AAAA,IACjB,iBAAiB;AAAA,IACjB,cAAc;AAAA,IACd,yBAAyB;AAAA,IACzB,6BAA6B;AAAA,EAC/B,CAAC;AACH;AAGO,IAAM,8BAA8C;AAAA,EAAa,MACtE,uBAAuB,OAAO;AAAA,IAC5B,kBAAkB,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS;AAAA,EAC/C,CAAC;AACH;AAEO,IAAM,yBAAyC;AAAA,EAAa,MACjE,EAAE,OAAO;AAAA,IACP,WAAW,EAAE,OAAO,EAAE,KAAK;AAAA,IAC3B,QAAQ;AAAA,IACR,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,IAC3B,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,IAC3B,SAAS,EAAE,MAAM,4BAA4B,EAAE,IAAI,CAAC;AAAA;AAAA,IAEpD,QAAQ,EACL;AAAA,MACC,6BAA6B,KAAK,EAAE,aAAa,KAAK,CAAC,EAAE,OAAO;AAAA,QAC9D,OAAO,EAAE,KAAK,CAAC,oBAAoB,gBAAgB,SAAS,CAAC;AAAA,MAC/D,CAAC;AAAA,IACH,EACC,QAAQ,CAAC,CAAC;AAAA,IACb,QAAQ,EACL;AAAA,MACC,EAAE,OAAO;AAAA,QACP,UAAU,EAAE,OAAO;AAAA,QACnB,OAAO,EAAE,OAAO;AAAA,QAChB,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,EACC,IAAI,EAAE;AAAA,IACT,iBAAiB,EAAE,QAAQ;AAAA,IAC3B,YAAY,EACT;AAAA,MACC,EAAE,OAAO;AAAA,QACP,aAAa,EAAE,OAAO,EAAE,KAAK;AAAA,QAC7B,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,QAC1B,SAAS,EAAE,MAAM,4BAA4B,EAAE,IAAI,CAAC;AAAA,MACtD,CAAC;AAAA,IACH,EACC,IAAI,EAAE;AAAA;AAAA,IAET,UAAU,EAAE,OAAO;AAAA,MACjB,qBAAqB;AAAA,MACrB,SAAS,EAAE,MAAM,4BAA4B,EAAE,IAAI,CAAC;AAAA,IACtD,CAAC;AAAA,IACD,qBAAqB,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS;AAAA,EAClD,CAAC;AACH;","names":[]}

package/dist/organization-recovery.js

@@ -15,7 +15,8 @@ import {
   OrganizationRecoveryPolicyState,
   OrganizationRecoveryUnavailableReason,
   StartOrganizationRecoveryOperationRequest
-} from "./chunk-BCS7WHCK.js";
+} from "./chunk-EKWNTOG3.js";
+import "./chunk-56SNIMDO.js";
 export {
   AcceptOrganizationRecoveryCustodyRequest,
   ConfigureOrganizationRecoveryPolicyRequest,

package/dist/organization-usage.d.ts

@@ -0,0 +1,138 @@
+import { z } from "zod";
+export declare const OrganizationUsagePeriod: z.ZodEnum<{
+    month: "month";
+    today: "today";
+    week: "week";
+    ytd: "ytd";
+}>;
+export type OrganizationUsagePeriod = z.infer<typeof OrganizationUsagePeriod>;
+export declare const OrganizationUsageQuery: z.ZodObject<{
+    period: z.ZodDefault<z.ZodEnum<{
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>>;
+}, z.core.$strip>;
+export declare const OrganizationUsageWorkspacePageQuery: z.ZodObject<{
+    period: z.ZodDefault<z.ZodEnum<{
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>>;
+    until: z.ZodString;
+    afterWorkspaceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const OrganizationUsageTotal: z.ZodObject<{
+    eventType: z.ZodString;
+    unit: z.ZodString;
+    quantity: z.ZodString;
+    eventCount: z.ZodString;
+}, z.core.$strip>;
+/** One member's Personal workspace, as usage only. */
+export declare const OrganizationUsagePersonalWorkspace: z.ZodObject<{
+    membershipId: z.ZodString;
+    totals: z.ZodArray<z.ZodObject<{
+        eventType: z.ZodString;
+        unit: z.ZodString;
+        quantity: z.ZodString;
+        eventCount: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type OrganizationUsagePersonalWorkspace = z.infer<typeof OrganizationUsagePersonalWorkspace>;
+export declare const OrganizationUsageSummary: z.ZodObject<{
+    accountId: z.ZodString;
+    period: z.ZodEnum<{
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>;
+    since: z.ZodString;
+    until: z.ZodString;
+    granularity: z.ZodEnum<{
+        day: "day";
+        hour: "hour";
+    }>;
+    totals: z.ZodArray<z.ZodObject<{
+        eventType: z.ZodString;
+        unit: z.ZodString;
+        quantity: z.ZodString;
+        eventCount: z.ZodString;
+    }, z.core.$strip>>;
+    buckets: z.ZodArray<z.ZodObject<{
+        bucket: z.ZodString;
+        totals: z.ZodArray<z.ZodObject<{
+            eventType: z.ZodString;
+            unit: z.ZodString;
+            quantity: z.ZodString;
+            eventCount: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    workspaces: z.ZodArray<z.ZodObject<{
+        workspaceId: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        totals: z.ZodArray<z.ZodObject<{
+            eventType: z.ZodString;
+            unit: z.ZodString;
+            quantity: z.ZodString;
+            eventCount: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    nextWorkspaceCursor: z.ZodNullable<z.ZodString>;
+    personalWorkspaces: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        membershipId: z.ZodString;
+        totals: z.ZodArray<z.ZodObject<{
+            eventType: z.ZodString;
+            unit: z.ZodString;
+            quantity: z.ZodString;
+            eventCount: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    personalWorkspaceCount: z.ZodDefault<z.ZodNumber>;
+    privateChats: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        workspaceId: z.ZodString;
+        membershipId: z.ZodNullable<z.ZodString>;
+        name: z.ZodNullable<z.ZodString>;
+        totals: z.ZodArray<z.ZodObject<{
+            eventType: z.ZodString;
+            unit: z.ZodString;
+            quantity: z.ZodString;
+            eventCount: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    privateChatsTruncated: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type OrganizationUsageSummary = z.infer<typeof OrganizationUsageSummary>;
+/**
+ * A page deliberately excludes totals, charts and Personal rows: those are not
+ * recomputed. Pages continue the shared workspaces only.
+ */
+export declare const OrganizationUsageWorkspacePage: z.ZodObject<{
+    accountId: z.ZodString;
+    period: z.ZodEnum<{
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>;
+    since: z.ZodString;
+    until: z.ZodString;
+    granularity: z.ZodEnum<{
+        day: "day";
+        hour: "hour";
+    }>;
+    workspaces: z.ZodArray<z.ZodObject<{
+        workspaceId: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        totals: z.ZodArray<z.ZodObject<{
+            eventType: z.ZodString;
+            unit: z.ZodString;
+            quantity: z.ZodString;
+            eventCount: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    nextWorkspaceCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type OrganizationUsageWorkspacePage = z.infer<typeof OrganizationUsageWorkspacePage>;

package/dist/permissions.d.ts

@@ -32,6 +32,7 @@ export declare const Permission: z.ZodEnum<{
     "scheduled_tasks:run": "scheduled_tasks:run";
     "secrets:list": "secrets:list";
     "secrets:read": "secrets:read";
+    "secrets:use": "secrets:use";
     "secrets:write": "secrets:write";
     "sessions:control": "sessions:control";
     "sessions:create": "sessions:create";
@@ -40,6 +41,7 @@ export declare const Permission: z.ZodEnum<{
     "stream:control": "stream:control";
     "stream:view": "stream:view";
     "terminal:attach": "terminal:attach";
+    "usage_allowances:manage": "usage_allowances:manage";
     "variable-sets:attach": "variable-sets:attach";
     "variable-sets:list": "variable-sets:list";
     "variable-sets:manage": "variable-sets:manage";
@@ -51,3 +53,19 @@ export declare const Permission: z.ZodEnum<{
     "workspace:read": "workspace:read";
 }>;
 export type Permission = z.infer<typeof Permission>;
+/**
+ * Legacy permission names and their secrets equivalents (Q-16). Stored role
+ * and API-key permission arrays are aliased at read time, never rewritten.
+ */
+export declare const SECRET_PERMISSION_ALIASES: {
+    readonly "variable-sets:list": "secrets:list";
+    readonly "variable-sets:read": "secrets:list";
+    readonly "variable-sets:write": "secrets:write";
+    readonly "variable-sets:manage": "secrets:write";
+    readonly "environments:manage": "secrets:write";
+    readonly "variable-sets:attach": "secrets:use";
+    readonly "variable-sets:use": "secrets:use";
+    readonly "environments:use": "secrets:use";
+};
+/** Canonical name for a permission: legacy variable-set names map to `secrets:*`. */
+export declare function normalizePermission(name: string): string;

package/dist/personal-github.d.ts

@@ -277,6 +277,7 @@ export declare const PersonalGitHubConnectionStatusResponse: z.ZodObject<{
     connection: z.ZodNullable<z.ZodObject<{
         id: z.ZodString;
         authorityId: z.ZodOptional<z.ZodString>;
+        connectionAuthorityGeneration: z.ZodOptional<z.ZodNumber>;
         accountId: z.ZodString;
         workspaceId: z.ZodString;
         subjectId: z.ZodNullable<z.ZodString>;