Skip to content

armgit / qm

Public Imported from GitHub
0

Multiplayer agent harness for work.

2.4 KB
Raw Blame
import type { ScopeId } from "../types.ts";
import { createTimestampedEventSink } from "./scoped-event-sink.ts";

export interface CredentialUsageSample {
  ts: number;
  slug: string;
  host: string;
  status: string;
  upstreamStatus?: number;
  scopeLabel: ScopeId;
  principalId: string;
}

interface CredentialUsageQuery {
  scopeId?: string;
  slug?: string;
  since?: number;
  limit?: number;
}

export const CREDENTIAL_USAGE_WINDOW = 5000;

interface CredentialUsageSummary {
  slug: string;
  usageCount: number;
  usageTruncated: boolean;
  usageSince: number | null;
  lastUsedAt: number | null;
  recentUsagePrincipals: string[];
}

export interface CredentialUsageSink {
  record(s: Omit<CredentialUsageSample, "ts">): void;
  list(opts?: CredentialUsageQuery): Promise<CredentialUsageSample[]>;
  summary(slugs: readonly string[]): Promise<CredentialUsageSummary[]>;
  admitDailyCall(slug: string, cap: number): Promise<boolean>;
}

export const utcDayStart = (ms: number): number => ms - (ms % 86_400_000);

export function createCredentialUsageSink(now: () => number = Date.now): CredentialUsageSink {
  const sink = createTimestampedEventSink<CredentialUsageSample>({
    max: 10000,
    defaultLimit: CREDENTIAL_USAGE_WINDOW,
    equalityFields: ["slug"],
  });
  const daily = new Map<string, { day: number; sent: number }>();
  return {
    ...sink,
    async admitDailyCall(slug, cap) {
      const day = utcDayStart(now());
      const tally = daily.get(slug)?.day === day ? daily.get(slug)! : { day, sent: 0 };
      daily.set(slug, tally);
      if (tally.sent >= cap) return false;
      tally.sent += 1;
      return true;
    },
    async summary(slugs) {
      return Promise.all(
        [...new Set(slugs)].map(async (slug) => {
          const recent = await sink.list({ slug, limit: CREDENTIAL_USAGE_WINDOW });
          const successful = recent.filter((event) => event.status === "ok");
          return {
            slug,
            usageCount: successful.length,
            usageTruncated: recent.length === CREDENTIAL_USAGE_WINDOW,
            usageSince: successful.length ? Math.min(...successful.map((event) => event.ts)) : null,
            lastUsedAt: successful.length ? Math.max(...successful.map((event) => event.ts)) : null,
            recentUsagePrincipals: [...new Set(successful.map((event) => event.principalId))].slice(0, 12),
          };
        }),
      );
    },
  };
}