terse-types 0.0.30 → 0.0.31

package/dist/ACL.d.ts

@@ -0,0 +1,375 @@
+import * as z from "zod";
+import { IntegrationType } from "./Integrations.js";
+export declare const slackACLResourceTypeSchema: z.ZodEnum<{
+    channel: "channel";
+    dm_user: "dm_user";
+}>;
+export type SlackACLResourceType = z.infer<typeof slackACLResourceTypeSchema>;
+export declare const notionACLResourceTypeSchema: z.ZodEnum<{
+    page: "page";
+    database: "database";
+}>;
+export type NotionACLResourceType = z.infer<typeof notionACLResourceTypeSchema>;
+export declare const githubACLResourceTypeSchema: z.ZodLiteral<"repository">;
+export type GitHubACLResourceType = z.infer<typeof githubACLResourceTypeSchema>;
+export declare const gmailACLResourceTypeSchema: z.ZodEnum<{
+    send: "send";
+    draft: "draft";
+}>;
+export type GmailACLResourceType = z.infer<typeof gmailACLResourceTypeSchema>;
+/** Built-in web / image capabilities use `IntegrationType.TERSE` in configs; resourceType distinguishes them. */
+export declare const terseACLResourceTypeSchema: z.ZodEnum<{
+    web_capability: "web_capability";
+    image_edit_capability: "image_edit_capability";
+}>;
+export type TerseACLResourceType = z.infer<typeof terseACLResourceTypeSchema>;
+export declare const linearACLResourceTypeSchema: z.ZodEnum<{
+    integration: "integration";
+    team: "team";
+    project: "project";
+}>;
+export type LinearACLResourceType = z.infer<typeof linearACLResourceTypeSchema>;
+export declare const posthogACLResourceTypeSchema: z.ZodLiteral<"project">;
+export type PosthogACLResourceType = z.infer<typeof posthogACLResourceTypeSchema>;
+export declare const datadogACLResourceTypeSchema: z.ZodEnum<{
+    integration: "integration";
+    index: "index";
+}>;
+export type DatadogACLResourceType = z.infer<typeof datadogACLResourceTypeSchema>;
+export declare const launchDarklyACLResourceTypeSchema: z.ZodEnum<{
+    environment: "environment";
+    project: "project";
+}>;
+export type LaunchDarklyACLResourceType = z.infer<typeof launchDarklyACLResourceTypeSchema>;
+export declare const attioACLResourceTypeSchema: z.ZodEnum<{
+    object: "object";
+    integration: "integration";
+}>;
+export type AttioACLResourceType = z.infer<typeof attioACLResourceTypeSchema>;
+export declare const workosACLResourceTypeSchema: z.ZodEnum<{
+    integration: "integration";
+    organization: "organization";
+}>;
+export type WorkOSACLResourceType = z.infer<typeof workosACLResourceTypeSchema>;
+export declare const snowflakeACLResourceTypeSchema: z.ZodLiteral<"integration">;
+export type SnowflakeACLResourceType = z.infer<typeof snowflakeACLResourceTypeSchema>;
+export declare const slackACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.SLACK>;
+    resourceType: z.ZodEnum<{
+        channel: "channel";
+        dm_user: "dm_user";
+    }>;
+}, z.core.$strip>;
+export declare const notionACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.NOTION>;
+    resourceType: z.ZodEnum<{
+        page: "page";
+        database: "database";
+    }>;
+}, z.core.$strip>;
+export declare const githubACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.GITHUB>;
+    resourceType: z.ZodLiteral<"repository">;
+}, z.core.$strip>;
+export declare const gmailACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.GMAIL>;
+    resourceType: z.ZodEnum<{
+        send: "send";
+        draft: "draft";
+    }>;
+}, z.core.$strip>;
+export declare const terseACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.TERSE>;
+    resourceType: z.ZodEnum<{
+        web_capability: "web_capability";
+        image_edit_capability: "image_edit_capability";
+    }>;
+}, z.core.$strip>;
+export declare const linearACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.LINEAR>;
+    resourceType: z.ZodEnum<{
+        integration: "integration";
+        team: "team";
+        project: "project";
+    }>;
+}, z.core.$strip>;
+export declare const posthogACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.POSTHOG>;
+    resourceType: z.ZodLiteral<"project">;
+}, z.core.$strip>;
+export declare const datadogACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.DATADOG>;
+    resourceType: z.ZodEnum<{
+        integration: "integration";
+        index: "index";
+    }>;
+}, z.core.$strip>;
+export declare const launchDarklyACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.LAUNCHDARKLY>;
+    resourceType: z.ZodEnum<{
+        environment: "environment";
+        project: "project";
+    }>;
+}, z.core.$strip>;
+export declare const attioACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.ATTIO>;
+    resourceType: z.ZodEnum<{
+        object: "object";
+        integration: "integration";
+    }>;
+}, z.core.$strip>;
+export declare const workosACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.WORKOS>;
+    resourceType: z.ZodEnum<{
+        integration: "integration";
+        organization: "organization";
+    }>;
+}, z.core.$strip>;
+export declare const snowflakeACLRuleSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.SNOWFLAKE>;
+    resourceType: z.ZodLiteral<"integration">;
+}, z.core.$strip>;
+export declare const aclRuleSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.SLACK>;
+    resourceType: z.ZodEnum<{
+        channel: "channel";
+        dm_user: "dm_user";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.NOTION>;
+    resourceType: z.ZodEnum<{
+        page: "page";
+        database: "database";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.GITHUB>;
+    resourceType: z.ZodLiteral<"repository">;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.GMAIL>;
+    resourceType: z.ZodEnum<{
+        send: "send";
+        draft: "draft";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.TERSE>;
+    resourceType: z.ZodEnum<{
+        web_capability: "web_capability";
+        image_edit_capability: "image_edit_capability";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.LINEAR>;
+    resourceType: z.ZodEnum<{
+        integration: "integration";
+        team: "team";
+        project: "project";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.POSTHOG>;
+    resourceType: z.ZodLiteral<"project">;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.DATADOG>;
+    resourceType: z.ZodEnum<{
+        integration: "integration";
+        index: "index";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.LAUNCHDARKLY>;
+    resourceType: z.ZodEnum<{
+        environment: "environment";
+        project: "project";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.ATTIO>;
+    resourceType: z.ZodEnum<{
+        object: "object";
+        integration: "integration";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.WORKOS>;
+    resourceType: z.ZodEnum<{
+        integration: "integration";
+        organization: "organization";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.SNOWFLAKE>;
+    resourceType: z.ZodLiteral<"integration">;
+}, z.core.$strip>], "integrationType">;
+export declare const aclRulesSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.SLACK>;
+    resourceType: z.ZodEnum<{
+        channel: "channel";
+        dm_user: "dm_user";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.NOTION>;
+    resourceType: z.ZodEnum<{
+        page: "page";
+        database: "database";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.GITHUB>;
+    resourceType: z.ZodLiteral<"repository">;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.GMAIL>;
+    resourceType: z.ZodEnum<{
+        send: "send";
+        draft: "draft";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.TERSE>;
+    resourceType: z.ZodEnum<{
+        web_capability: "web_capability";
+        image_edit_capability: "image_edit_capability";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.LINEAR>;
+    resourceType: z.ZodEnum<{
+        integration: "integration";
+        team: "team";
+        project: "project";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.POSTHOG>;
+    resourceType: z.ZodLiteral<"project">;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.DATADOG>;
+    resourceType: z.ZodEnum<{
+        integration: "integration";
+        index: "index";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.LAUNCHDARKLY>;
+    resourceType: z.ZodEnum<{
+        environment: "environment";
+        project: "project";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.ATTIO>;
+    resourceType: z.ZodEnum<{
+        object: "object";
+        integration: "integration";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.WORKOS>;
+    resourceType: z.ZodEnum<{
+        integration: "integration";
+        organization: "organization";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodString;
+    resourceId: z.ZodString;
+    integrationType: z.ZodLiteral<IntegrationType.SNOWFLAKE>;
+    resourceType: z.ZodLiteral<"integration">;
+}, z.core.$strip>], "integrationType">>;
+export type ACLRule = z.infer<typeof aclRuleSchema>;
+export type SlackACLRule = z.infer<typeof slackACLRuleSchema>;
+export type NotionACLRule = z.infer<typeof notionACLRuleSchema>;
+export type GitHubACLRule = z.infer<typeof githubACLRuleSchema>;
+export type GmailACLRule = z.infer<typeof gmailACLRuleSchema>;
+export type TerseACLRule = z.infer<typeof terseACLRuleSchema>;
+export type WebACLRule = TerseACLRule & {
+    resourceType: "web_capability";
+};
+export type ImageEditACLRule = TerseACLRule & {
+    resourceType: "image_edit_capability";
+};
+export type LinearACLRule = z.infer<typeof linearACLRuleSchema>;
+export type PosthogACLRule = z.infer<typeof posthogACLRuleSchema>;
+export type DatadogACLRule = z.infer<typeof datadogACLRuleSchema>;
+export type LaunchDarklyACLRule = z.infer<typeof launchDarklyACLRuleSchema>;
+export type AttioACLRule = z.infer<typeof attioACLRuleSchema>;
+export type WorkOSACLRule = z.infer<typeof workosACLRuleSchema>;
+export type SnowflakeACLRule = z.infer<typeof snowflakeACLRuleSchema>;
+export declare function findACLRule(rules: ACLRule[], rule: Pick<ACLRule, "integrationType" | "integrationId" | "resourceType" | "resourceId">): ACLRule | undefined;
+export declare function hasACLRule(rules: ACLRule[], rule: Pick<ACLRule, "integrationType" | "integrationId" | "resourceType" | "resourceId">): boolean;
+export declare function getACLRulesForResourceType(params: {
+    rules: ACLRule[];
+    integrationType: ACLRule["integrationType"];
+    integrationId: string;
+    resourceType: ACLRule["resourceType"];
+}): ACLRule[];
+export declare function hasAnyACLRuleForIntegration(params: {
+    rules: ACLRule[];
+    integrationType: ACLRule["integrationType"];
+    integrationId: string;
+}): boolean;
+/**
+ * ACL validators are colocated with the output/tool definitions they protect.
+ * Each validator receives model tool args, the flat per-run `ACLRule[]`, and run configs (`readOnly`, `integrationId`).
+ * Validators decide in-scope only; they must not persist ACL state, mutate configs, or affect deterministic developer-authored tool calls.
+ */
+export declare function getACLRulesForIntegration(params: {
+    rules: ACLRule[];
+    integrationType: ACLRule["integrationType"];
+    integrationId: string;
+}): ACLRule[];

package/dist/ACL.js

@@ -0,0 +1,105 @@
+import * as z from "zod";
+import { IntegrationType } from "./Integrations.js";
+const baseACLRuleSchema = z.object({
+    integrationId: z.string(),
+    resourceId: z.string()
+});
+export const slackACLResourceTypeSchema = z.enum(["channel", "dm_user"]);
+export const notionACLResourceTypeSchema = z.enum(["page", "database"]);
+export const githubACLResourceTypeSchema = z.literal("repository");
+export const gmailACLResourceTypeSchema = z.enum(["send", "draft"]);
+/** Built-in web / image capabilities use `IntegrationType.TERSE` in configs; resourceType distinguishes them. */
+export const terseACLResourceTypeSchema = z.enum(["web_capability", "image_edit_capability"]);
+export const linearACLResourceTypeSchema = z.enum(["integration", "team", "project"]);
+export const posthogACLResourceTypeSchema = z.literal("project");
+export const datadogACLResourceTypeSchema = z.enum(["integration", "index"]);
+export const launchDarklyACLResourceTypeSchema = z.enum(["project", "environment"]);
+export const attioACLResourceTypeSchema = z.enum(["integration", "object"]);
+export const workosACLResourceTypeSchema = z.enum(["integration", "organization"]);
+export const snowflakeACLResourceTypeSchema = z.literal("integration");
+export const slackACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.SLACK),
+    resourceType: slackACLResourceTypeSchema
+});
+export const notionACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.NOTION),
+    resourceType: notionACLResourceTypeSchema
+});
+export const githubACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.GITHUB),
+    resourceType: githubACLResourceTypeSchema
+});
+export const gmailACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.GMAIL),
+    resourceType: gmailACLResourceTypeSchema
+});
+export const terseACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.TERSE),
+    resourceType: terseACLResourceTypeSchema
+});
+export const linearACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.LINEAR),
+    resourceType: linearACLResourceTypeSchema
+});
+export const posthogACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.POSTHOG),
+    resourceType: posthogACLResourceTypeSchema
+});
+export const datadogACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.DATADOG),
+    resourceType: datadogACLResourceTypeSchema
+});
+export const launchDarklyACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.LAUNCHDARKLY),
+    resourceType: launchDarklyACLResourceTypeSchema
+});
+export const attioACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.ATTIO),
+    resourceType: attioACLResourceTypeSchema
+});
+export const workosACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.WORKOS),
+    resourceType: workosACLResourceTypeSchema
+});
+export const snowflakeACLRuleSchema = baseACLRuleSchema.extend({
+    integrationType: z.literal(IntegrationType.SNOWFLAKE),
+    resourceType: snowflakeACLResourceTypeSchema
+});
+export const aclRuleSchema = z.discriminatedUnion("integrationType", [
+    slackACLRuleSchema,
+    notionACLRuleSchema,
+    githubACLRuleSchema,
+    gmailACLRuleSchema,
+    terseACLRuleSchema,
+    linearACLRuleSchema,
+    posthogACLRuleSchema,
+    datadogACLRuleSchema,
+    launchDarklyACLRuleSchema,
+    attioACLRuleSchema,
+    workosACLRuleSchema,
+    snowflakeACLRuleSchema
+]);
+export const aclRulesSchema = z.array(aclRuleSchema);
+export function findACLRule(rules, rule) {
+    return rules.find(candidate => candidate.integrationType === rule.integrationType &&
+        candidate.integrationId === rule.integrationId &&
+        candidate.resourceType === rule.resourceType &&
+        candidate.resourceId === rule.resourceId);
+}
+export function hasACLRule(rules, rule) {
+    return !!findACLRule(rules, rule);
+}
+export function getACLRulesForResourceType(params) {
+    return params.rules.filter(rule => rule.integrationType === params.integrationType && rule.integrationId === params.integrationId && rule.resourceType === params.resourceType);
+}
+export function hasAnyACLRuleForIntegration(params) {
+    return params.rules.some(rule => rule.integrationType === params.integrationType && rule.integrationId === params.integrationId);
+}
+/**
+ * ACL validators are colocated with the output/tool definitions they protect.
+ * Each validator receives model tool args, the flat per-run `ACLRule[]`, and run configs (`readOnly`, `integrationId`).
+ * Validators decide in-scope only; they must not persist ACL state, mutate configs, or affect deterministic developer-authored tool calls.
+ */
+export function getACLRulesForIntegration(params) {
+    return params.rules.filter(rule => rule.integrationType === params.integrationType && rule.integrationId === params.integrationId);
+}

package/dist/ACLPolicy.d.ts

@@ -0,0 +1,17 @@
+export declare const integrationACLPolicy: {
+    readonly github: "scoped";
+    readonly gmail: "scoped";
+    readonly linear: "scoped";
+    readonly slack: "scoped";
+    readonly notion: "scoped";
+    readonly terse: "capability";
+    readonly posthog: "scoped";
+    readonly datadog: "scoped";
+    readonly cron_job: "none";
+    readonly launchdarkly: "scoped";
+    readonly workos: "integration";
+    readonly attio: "scoped";
+    readonly snowflake: "integration";
+    readonly webhook: "none";
+    readonly webmonitor: "none";
+};

package/dist/ACLPolicy.js

@@ -0,0 +1,18 @@
+import { IntegrationType } from "./Integrations.js";
+export const integrationACLPolicy = {
+    [IntegrationType.GITHUB]: "scoped",
+    [IntegrationType.GMAIL]: "scoped",
+    [IntegrationType.LINEAR]: "scoped",
+    [IntegrationType.SLACK]: "scoped",
+    [IntegrationType.NOTION]: "scoped",
+    [IntegrationType.TERSE]: "capability",
+    [IntegrationType.POSTHOG]: "scoped",
+    [IntegrationType.DATADOG]: "scoped",
+    [IntegrationType.CRON_JOB]: "none",
+    [IntegrationType.LAUNCHDARKLY]: "scoped",
+    [IntegrationType.WORKOS]: "integration",
+    [IntegrationType.ATTIO]: "scoped",
+    [IntegrationType.SNOWFLAKE]: "integration",
+    [IntegrationType.WEBHOOK]: "none",
+    [IntegrationType.WEBMONITOR]: "none"
+};

package/dist/ApiRouteBuilder.d.ts

@@ -183,7 +183,9 @@ export declare const ApiRoutes: {
     };
     BILLING: {
         CATALOG: string;
+        STATUS: string;
         CONTEXT: string;
+        USAGE_BUCKETS: string;
         CHECKOUT_SESSION: string;
         CHANGE: string;
         PORTAL_SESSION: string;

package/dist/ApiRoutes.json

@@ -183,7 +183,9 @@
     },
     "BILLING": {
         "CATALOG": "/billing/catalog",
+        "STATUS": "/billing/status",
         "CONTEXT": "/billing/context",
+        "USAGE_BUCKETS": "/billing/usage-buckets",
         "CHECKOUT_SESSION": "/billing/checkout-session",
         "CHANGE": "/billing/change",
         "PORTAL_SESSION": "/billing/portal-session",

package/dist/Billing.d.ts

@@ -91,18 +91,16 @@ export declare const billingContextResponseSchema: z.ZodObject<{
             period: z.ZodEnum<typeof TimePeriods>;
         }, z.core.$strip>], "kind">>;
     }, z.core.$strip>;
-    usage: z.ZodObject<{
-        buckets: z.ZodArray<z.ZodObject<{
-            startTimestamp: z.ZodNumber;
-            endTimestamp: z.ZodNumber;
-            inputTokenCredits: z.ZodNumber;
-            outputTokenCredits: z.ZodNumber;
-            cachedInputCredits: z.ZodNumber;
-            runCredits: z.ZodNumber;
-        }, z.core.$strip>>;
-    }, z.core.$strip>;
 }, z.core.$strip>;
 export type BillingContextResponse = z.infer<typeof billingContextResponseSchema>;
+export declare const billingStatusResponseSchema: z.ZodObject<{
+    billingEnabled: z.ZodBoolean;
+    hasStripeCustomer: z.ZodBoolean;
+    hasActivePaidSubscription: z.ZodBoolean;
+    canManageBilling: z.ZodBoolean;
+    planKey: z.ZodNullable<z.ZodEnum<typeof PlanKey>>;
+}, z.core.$strip>;
+export type BillingStatusResponse = z.infer<typeof billingStatusResponseSchema>;
 export declare const completedEventUsageSchema: z.ZodObject<{
     inputTokens: z.ZodNumber;
     outputTokens: z.ZodNumber;
@@ -156,14 +154,6 @@ export declare const billingRecordLlmResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type BillingRecordLlmResponse = z.infer<typeof billingRecordLlmResponseSchema>;
 export declare const billingRecordLlmPayloadSchema: z.ZodObject<{
-    usage: z.ZodObject<{
-        inputTokens: z.ZodNumber;
-        outputTokens: z.ZodNumber;
-        totalTokens: z.ZodNumber;
-        inputTokensDetails: z.ZodObject<{
-            cached_tokens: z.ZodNumber;
-        }, z.core.$strip>;
-    }, z.core.$strip>;
     model: z.ZodObject<{
         providerId: z.ZodEnum<{
             anthropic: "anthropic";
@@ -172,6 +162,14 @@ export declare const billingRecordLlmPayloadSchema: z.ZodObject<{
         modelId: z.ZodString;
         value: z.ZodString;
     }, z.core.$strip>;
+    usage: z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        totalTokens: z.ZodNumber;
+        inputTokensDetails: z.ZodObject<{
+            cached_tokens: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
     responseId: z.ZodString;
 }, z.core.$strip>;
 export type BillingRecordLlmPayload = z.infer<typeof billingRecordLlmPayloadSchema>;
@@ -224,8 +222,24 @@ export declare const billingContextQuerySchema: z.ZodObject<{
     timezone: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string | undefined>>;
 }, z.core.$strip>;
 export type BillingContextQuery = z.infer<typeof billingContextQuerySchema>;
-export declare const getOrCreateCustomerRequestBodySchema: z.ZodObject<{}, z.core.$strict>;
-export type GetOrCreateCustomerRequestBody = z.infer<typeof getOrCreateCustomerRequestBodySchema>;
+/** Query params for GET /billing/usage-buckets (same range semantics as the chart on the billing page). */
+export declare const billingUsageBucketsQuerySchema: z.ZodObject<{
+    start: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    end: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    timezone: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string | undefined>>;
+}, z.core.$strip>;
+export type BillingUsageBucketsQuery = z.infer<typeof billingUsageBucketsQuerySchema>;
+export declare const billingUsageBucketsResponseSchema: z.ZodObject<{
+    buckets: z.ZodArray<z.ZodObject<{
+        startTimestamp: z.ZodNumber;
+        endTimestamp: z.ZodNumber;
+        inputTokenCredits: z.ZodNumber;
+        outputTokenCredits: z.ZodNumber;
+        cachedInputCredits: z.ZodNumber;
+        runCredits: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BillingUsageBucketsResponse = z.infer<typeof billingUsageBucketsResponseSchema>;
 export declare const billingStripeRedirectResponseSchema: z.ZodObject<{
     url: z.ZodString;
 }, z.core.$strip>;
@@ -275,10 +289,6 @@ export declare const runGateDecisionSchema: z.ZodDiscriminatedUnion<[z.ZodObject
 }, z.core.$strip>], "allow">;
 export type RunGateDecision = z.infer<typeof runGateDecisionSchema>;
 export declare function parseRunGateDenyReason(raw: unknown): RunGateDenyReason;
-export declare const getOrCreateCustomerResponseSchema: z.ZodObject<{
-    customerId: z.ZodString;
-}, z.core.$strip>;
-export type GetOrCreateCustomerResponse = z.infer<typeof getOrCreateCustomerResponseSchema>;
 export declare const planSchema: z.ZodObject<{
     key: z.ZodEnum<typeof PlanKey>;
     name: z.ZodString;
@@ -337,11 +347,14 @@ export declare const BILLING_SERVICE_CALLBACK_JWT_ISSUER: "terse-billing";
 export declare const BILLING_SERVICE_CALLBACK_JWT_AUDIENCE: "terse-api";
 export declare const terseBillingJwtClaimsSchema: z.ZodObject<{
     organizationId: z.ZodString;
+    userId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type TerseBillingJwtClaims = z.infer<typeof terseBillingJwtClaimsSchema>;
 export declare const BillingRoutes: {
     CATALOG: string;
+    STATUS: string;
     CONTEXT: string;
+    USAGE_BUCKETS: string;
     CHECKOUT_SESSION: string;
     CHANGE: string;
     PORTAL_SESSION: string;