oc2token 0.1.0

package/dist/src/opencode/client.js

@@ -0,0 +1,118 @@
+import { createHash } from "node:crypto";
+import { Service, headers as serviceHeaders, } from "@opencode-ai/client/service";
+import { OpenCode } from "@opencode-ai/client";
+import { DomainError, cancellationError } from "../domain/index.js";
+export const defaultService = {
+    discover: Service.discover,
+    ensure: Service.ensure,
+    headers: serviceHeaders,
+};
+/** Create the official promise client with the service's auth headers. */
+export function createOpenCodeClient(endpoint, service = defaultService, options = {}) {
+    return OpenCode.make({
+        baseUrl: endpoint.url,
+        headers: service.headers(endpoint),
+        fetch: options.fetch,
+    });
+}
+export const defaultClientFactory = (endpoint, options) => createOpenCodeClient(endpoint, defaultService, options);
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw cancellationError();
+    }
+}
+function assertEndpoint(endpoint) {
+    if (typeof endpoint.url !== "string" || endpoint.url.trim().length === 0) {
+        throw new DomainError("invalid-data", "OpenCode service returned an empty URL");
+    }
+    let url;
+    try {
+        url = new URL(endpoint.url);
+    }
+    catch (error) {
+        throw new DomainError("invalid-data", "OpenCode service returned an invalid URL", {
+            cause: error,
+        });
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new DomainError("invalid-data", `OpenCode service URL must use http or https, got ${url.protocol}`);
+    }
+    return { ...endpoint, url: url.toString() };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function readHealth(value, endpoint) {
+    if (!isRecord(value) || value.healthy !== true || typeof value.version !== "string") {
+        throw new DomainError("invalid-data", "OpenCode health response is missing healthy=true and a version");
+    }
+    const pid = value.pid;
+    if (pid !== undefined && pid !== null && (typeof pid !== "number" || !Number.isSafeInteger(pid) || pid < 0)) {
+        throw new DomainError("invalid-data", "OpenCode health response has an invalid pid");
+    }
+    // Never hash or report the basic-auth password.  The URL is the advertised
+    // endpoint, not the credential-bearing request header.
+    const fingerprintInput = `${endpoint.url}\u0000${value.version}\u0000${pid ?? ""}`;
+    const fingerprint = createHash("sha256").update(fingerprintInput).digest("hex").slice(0, 24);
+    return { version: value.version, fingerprint };
+}
+export function parseOpenCodeHealth(value, endpoint) {
+    return readHealth(value, endpoint);
+}
+function mergeDiscoveryOptions(options) {
+    return {
+        ...options.discovery,
+        ...(options.version === undefined ? {} : { version: options.version }),
+    };
+}
+function mergeEnsureOptions(options) {
+    return {
+        // The beta client's own default still says `opencode`; OC2Token targets
+        // the V2 executable explicitly unless the caller supplies a command.
+        command: ["opencode2", "serve", "--service"],
+        ...options.ensureOptions,
+        ...(options.version === undefined ? {} : { version: options.version }),
+    };
+}
+/** Discover a running service, optionally ensuring the V2 service exists. */
+export async function connectOpenCode(options = {}) {
+    const service = options.service ?? defaultService;
+    const signal = options.signal;
+    throwIfAborted(signal);
+    let endpoint = await service.discover(mergeDiscoveryOptions(options));
+    throwIfAborted(signal);
+    if (endpoint === undefined) {
+        if (options.ensure === false) {
+            throw new DomainError("transport", "No healthy OpenCode 2 service was discovered");
+        }
+        endpoint = await service.ensure(mergeEnsureOptions(options));
+        throwIfAborted(signal);
+    }
+    const normalizedEndpoint = assertEndpoint(endpoint);
+    const client = options.client ?? (options.clientFactory ?? ((target, factoryOptions) => createOpenCodeClient(target, service, factoryOptions)))(normalizedEndpoint, {
+        fetch: options.fetch,
+    });
+    if (client.health === undefined || typeof client.health.get !== "function") {
+        throw new DomainError("invalid-data", "OpenCode client does not expose health.get");
+    }
+    const health = parseOpenCodeHealth(await client.health.get({ signal }), normalizedEndpoint);
+    throwIfAborted(signal);
+    return { endpoint: normalizedEndpoint, client, health };
+}
+/** A class facade is convenient for callers that need to reconnect later. */
+export class OpenCodeConnectionManager {
+    options;
+    constructor(options = {}) {
+        this.options = { ...options };
+    }
+    discover() {
+        return (this.options.service ?? defaultService).discover(mergeDiscoveryOptions(this.options));
+    }
+    ensure() {
+        return (this.options.service ?? defaultService).ensure(mergeEnsureOptions(this.options));
+    }
+    connect() {
+        return connectOpenCode(this.options);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/opencode/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/opencode/client.ts"],"names":[],"mappings":"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"}

package/dist/src/opencode/doctor.d.ts

@@ -0,0 +1,28 @@
+import { type OpenCodeTransport, type UsageWindow } from "../domain/index.js";
+import { type ConnectionOptions, type OpenCodeConnection } from "./client.js";
+export type DoctorCheckName = "service" | "health" | "stats-range" | "opencode" | "codex" | "antigravity";
+export interface DoctorCheck {
+    readonly name: DoctorCheckName;
+    readonly ok: boolean;
+    readonly message: string;
+}
+export interface DoctorReport {
+    readonly ok: boolean;
+    readonly checks: ReadonlyArray<DoctorCheck>;
+    readonly endpoint?: string;
+    readonly version?: string;
+    readonly fingerprint?: string;
+}
+export interface DoctorOptions extends ConnectionOptions {
+    readonly connection?: OpenCodeConnection;
+    readonly transport?: OpenCodeTransport;
+    /** If supplied, doctor also verifies the filtered stats range. */
+    readonly window?: UsageWindow;
+    readonly project?: string;
+}
+/**
+ * Run non-mutating local diagnostics. By default it only discovers a running
+ * service; pass ensure:true when a caller explicitly wants service startup.
+ */
+export declare function runOpenCodeDoctor(options?: DoctorOptions): Promise<DoctorReport>;
+export declare const doctor: typeof runOpenCodeDoctor;

package/dist/src/opencode/doctor.js

@@ -0,0 +1,82 @@
+import { DomainError, } from "../domain/index.js";
+import { connectOpenCode, } from "./client.js";
+import { isStatsRangeMismatch, OpenCode2Transport } from "./transport.js";
+function publicError(error) {
+    if (error instanceof DomainError)
+        return error.message;
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+/**
+ * Run non-mutating local diagnostics. By default it only discovers a running
+ * service; pass ensure:true when a caller explicitly wants service startup.
+ */
+export async function runOpenCodeDoctor(options = {}) {
+    const checks = [];
+    let connection = options.connection;
+    let transport = options.transport;
+    if (connection === undefined && transport === undefined) {
+        try {
+            connection = await connectOpenCode({ ...options, ensure: options.ensure ?? false });
+            checks.push({ name: "service", ok: true, message: "OpenCode 2 service discovered" });
+            transport = new OpenCode2Transport({ client: connection.client });
+        }
+        catch (error) {
+            checks.push({ name: "service", ok: false, message: publicError(error) });
+            return { ok: false, checks };
+        }
+    }
+    else {
+        checks.push({ name: "service", ok: true, message: "Injected OpenCode transport is available" });
+    }
+    if (transport === undefined && connection !== undefined) {
+        transport = new OpenCode2Transport({ client: connection.client });
+    }
+    if (connection !== undefined) {
+        checks.push({
+            name: "health",
+            ok: true,
+            message: `healthy V2 service ${connection.health.version}`,
+        });
+    }
+    else if (transport !== undefined) {
+        try {
+            const health = await transport.getHealth({ signal: options.signal });
+            checks.push({ name: "health", ok: true, message: `healthy V2 service ${health.version}` });
+        }
+        catch (error) {
+            checks.push({ name: "health", ok: false, message: publicError(error) });
+        }
+    }
+    if (options.window !== undefined && transport !== undefined) {
+        try {
+            const statsOptions = {
+                project: options.project,
+                signal: options.signal,
+            };
+            await transport.getSessionStats(options.window, statsOptions);
+            checks.push({ name: "stats-range", ok: true, message: "filtered stats range is honored" });
+        }
+        catch (error) {
+            checks.push({
+                name: "stats-range",
+                ok: false,
+                message: isStatsRangeMismatch(error)
+                    ? "filtered stats range is not honored; use paginated message fallback"
+                    : publicError(error),
+            });
+        }
+    }
+    return {
+        ok: checks.every((check) => check.ok),
+        checks,
+        ...(connection === undefined ? {} : {
+            endpoint: connection.endpoint.url,
+            version: connection.health.version,
+            fingerprint: connection.health.fingerprint,
+        }),
+    };
+}
+export const doctor = runOpenCodeDoctor;
+//# sourceMappingURL=doctor.js.map

package/dist/src/opencode/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/opencode/doctor.ts"],"names":[],"mappings":"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"}

package/dist/src/opencode/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./adapter.js";
+export * from "./client.js";
+export * from "./doctor.js";
+export * from "./stats.js";
+export * from "./transport.js";

package/dist/src/opencode/index.js

@@ -0,0 +1,6 @@
+export * from "./adapter.js";
+export * from "./client.js";
+export * from "./doctor.js";
+export * from "./stats.js";
+export * from "./transport.js";
+//# sourceMappingURL=index.js.map

package/dist/src/opencode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/opencode/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/src/opencode/stats.d.ts

@@ -0,0 +1,8 @@
+import { type CollectionRequest, type CollectionResult, type OpenCodeTransport, type UsageSource } from "../domain/index.js";
+/** UsageSource implementation for a range-validated /api/session/stats path. */
+export declare class OpenCodeStatsSource implements UsageSource {
+    readonly transport: OpenCodeTransport;
+    constructor(transport: OpenCodeTransport);
+    collect(request: CollectionRequest): Promise<CollectionResult>;
+}
+export declare function createOpenCodeStatsSource(transport: OpenCodeTransport): OpenCodeStatsSource;

package/dist/src/opencode/stats.js

@@ -0,0 +1,174 @@
+import { DomainError, isCancellationError, createUsageTrendBuckets, } from "../domain/index.js";
+function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw new DomainError("cancelled", "The operation was cancelled");
+}
+const completeStatsCoverage = {
+    complete: true,
+    sessionsDiscovered: 0,
+    sessionsScanned: 0,
+    sessionsSkipped: 0,
+    pagesRead: 0,
+    jobsRetried: 0,
+    provisionalMessages: 0,
+    errors: [],
+};
+const TREND_WORKERS = 4;
+const PROJECT_WORKERS = 4;
+async function collectProjectBreakdowns(transport, window, projects, signal) {
+    if (projects.length === 0)
+        return [];
+    const results = new Array(projects.length);
+    let nextIndex = 0;
+    async function worker() {
+        for (;;) {
+            throwIfAborted(signal);
+            const index = nextIndex;
+            nextIndex += 1;
+            if (index >= projects.length)
+                return;
+            const project = projects[index];
+            try {
+                const result = await transport.getSessionStats(window, { project: project.id, signal });
+                if (result.totals.recorded_total > 0) {
+                    results[index] = { name: project.canonical, totals: result.totals };
+                }
+            }
+            catch (error) {
+                if (isCancellationError(error) || (error instanceof DomainError && error.code === "cancelled")) {
+                    throw error;
+                }
+                // Per-project failures are non-fatal; a single project's stats
+                // must not abort the whole refresh (range mismatch, 404, etc.)
+                results[index] = undefined;
+            }
+        }
+    }
+    const workers = Math.min(PROJECT_WORKERS, projects.length);
+    await Promise.all(Array.from({ length: workers }, () => worker()));
+    throwIfAborted(signal);
+    return results
+        .filter((value) => value !== undefined)
+        .sort((a, b) => b.totals.recorded_total - a.totals.recorded_total || a.name.localeCompare(b.name));
+}
+async function collectTrendBuckets(transport, window, options) {
+    const buckets = createUsageTrendBuckets(window);
+    const results = new Array(buckets.length);
+    let nextIndex = 0;
+    async function worker() {
+        for (;;) {
+            throwIfAborted(options.signal);
+            const index = nextIndex;
+            nextIndex += 1;
+            if (index >= buckets.length)
+                return;
+            const bucket = buckets[index];
+            // Retain the parent window metadata for fakes and diagnostics while
+            // sending the bucket's exact range to the transport.
+            const query = {
+                ...window,
+                from: new Date(bucket.from.getTime()),
+                to: new Date(bucket.to.getTime()),
+                label: bucket.label,
+            };
+            const result = await transport.getSessionStats(query, options);
+            results[index] = {
+                label: bucket.label,
+                from: new Date(bucket.from.getTime()),
+                to: new Date(bucket.to.getTime()),
+                totals: result.totals,
+            };
+        }
+    }
+    const workerCount = Math.min(TREND_WORKERS, buckets.length);
+    await Promise.all(Array.from({ length: workerCount }, () => worker()));
+    throwIfAborted(options.signal);
+    return results.filter((value) => value !== undefined);
+}
+/** UsageSource implementation for a range-validated /api/session/stats path. */
+export class OpenCodeStatsSource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async collect(request) {
+        throwIfAborted(request.signal);
+        const health = await this.transport.getHealth({ signal: request.signal });
+        const totalsByWindow = {};
+        const modelsByWindow = {};
+        const providersByWindow = {};
+        const projectsByWindow = {};
+        const trendsByWindow = {};
+        let models = undefined;
+        let providers = undefined;
+        let projects = undefined;
+        // Fetch project list once when not filtering to a single project.
+        // Failures are non-fatal: the stats total remains usable without per-project split.
+        let allProjects = [];
+        if (request.project === undefined && typeof this.transport.listProjects === "function") {
+            try {
+                const fetched = await this.transport.listProjects({ signal: request.signal });
+                // Filter obvious non-project entries (global root) and keep only git-backed projects with recent activity?
+                // We keep all and filter by recorded_total>0 later; but skip the global "/" which typically returns 0.
+                allProjects = fetched.filter((p) => p.canonical !== "/" && p.id !== "global");
+            }
+            catch (error) {
+                if (isCancellationError(error) || (error instanceof DomainError && error.code === "cancelled"))
+                    throw error;
+                allProjects = [];
+            }
+        }
+        // Keep each response associated with its immutable requested window. A
+        // stats total is never combined with a message-scan total by this source.
+        for (const window of request.windows) {
+            throwIfAborted(request.signal);
+            const options = {
+                project: request.project,
+                signal: request.signal,
+            };
+            const result = await this.transport.getSessionStats(window, options);
+            totalsByWindow[window.kind] = result.totals;
+            // Keep the widest requested window's breakdown for backwards-compatible
+            // global fields, while also retaining each response for the selected
+            // dashboard period.
+            if (result.models !== undefined) {
+                models = result.models;
+                modelsByWindow[window.kind] = result.models;
+            }
+            if (result.providers !== undefined) {
+                providers = result.providers;
+                providersByWindow[window.kind] = result.providers;
+            }
+            trendsByWindow[window.kind] = await collectTrendBuckets(this.transport, window, options);
+            if (allProjects.length > 0) {
+                const breakdowns = await collectProjectBreakdowns(this.transport, window, allProjects, request.signal);
+                if (breakdowns.length > 0) {
+                    projects = breakdowns;
+                    projectsByWindow[window.kind] = breakdowns;
+                }
+            }
+        }
+        throwIfAborted(request.signal);
+        return {
+            capturedAt: new Date(request.capturedAt.getTime()),
+            windows: request.windows,
+            source: "stats",
+            records: [],
+            totalsByWindow,
+            ...(models === undefined ? {} : { models }),
+            ...(providers === undefined ? {} : { providers }),
+            ...(projects === undefined ? {} : { projects }),
+            ...(Object.keys(modelsByWindow).length === 0 ? {} : { modelsByWindow: modelsByWindow }),
+            ...(Object.keys(providersByWindow).length === 0 ? {} : { providersByWindow: providersByWindow }),
+            ...(Object.keys(projectsByWindow).length === 0 ? {} : { projectsByWindow: projectsByWindow }),
+            ...(Object.keys(trendsByWindow).length === 0 ? {} : { trendsByWindow: trendsByWindow }),
+            coverage: completeStatsCoverage,
+            serverFingerprint: health.fingerprint,
+            serverVersion: health.version,
+        };
+    }
+}
+export function createOpenCodeStatsSource(transport) {
+    return new OpenCodeStatsSource(transport);
+}
+//# sourceMappingURL=stats.js.map

package/dist/src/opencode/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/opencode/stats.ts"],"names":[],"mappings":"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"}

package/dist/src/opencode/transport.d.ts

@@ -0,0 +1,54 @@
+import { DomainError, type MessageListRequest, type MessagePage, type OpenCodeAssistantMessage, type OpenCodeHealth, type OpenCodeProject, type OpenCodeRange, type OpenCodeSession, type OpenCodeSessionStats, type OpenCodeTransport, type SessionListRequest, type SessionPage, type TransportRequestOptions, type UsageStatsRange } from "../domain/index.js";
+import type { OpenCodeClientLike } from "./client.js";
+export interface RetryPolicy {
+    /** Maximum number of attempts, including the first request. */
+    readonly maxAttempts?: number;
+    readonly baseDelayMs?: number;
+    readonly maxDelayMs?: number;
+    /** Fractional jitter around the exponential delay. Set to zero in tests. */
+    readonly jitter?: number;
+    readonly random?: () => number;
+    readonly sleep?: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
+    /** Per-attempt request deadline. Set to zero to disable the deadline. */
+    readonly requestTimeoutMs?: number;
+}
+export interface StatsRequestOptions extends TransportRequestOptions {
+    readonly project?: string;
+}
+export interface OpenCodeTransportOptions extends RetryPolicy {
+    readonly client: OpenCodeClientLike;
+    readonly pageSize?: number;
+}
+export declare function retryingRead<T>(operation: (signal: AbortSignal) => Promise<T>, options?: RetryPolicy & TransportRequestOptions): Promise<T>;
+declare function parseStats(value: unknown, window: UsageStatsRange): OpenCodeSessionStats;
+export declare const parseOpenCodeSessionStats: typeof parseStats;
+export declare class StatsRangeMismatchError extends DomainError {
+    readonly requestedWindow: UsageStatsRange;
+    readonly reportedRange: OpenCodeRange;
+    readonly broader: boolean;
+    constructor(requestedWindow: UsageStatsRange, reportedRange: OpenCodeRange, broader: boolean);
+}
+export declare function isStatsRangeMismatch(error: unknown): error is StatsRangeMismatchError;
+/**
+ * Read-only V2 transport. Response parsing happens after the retry boundary so
+ * malformed data is never retried and never mistaken for a transient outage.
+ */
+export declare class OpenCode2Transport implements OpenCodeTransport {
+    readonly client: OpenCodeClientLike;
+    readonly pageSize: number;
+    readonly retryPolicy: RetryPolicy;
+    constructor(options: OpenCodeTransportOptions);
+    getHealth(options?: TransportRequestOptions): Promise<OpenCodeHealth>;
+    getSessionStats(window: UsageStatsRange, options?: StatsRequestOptions): Promise<OpenCodeSessionStats>;
+    listSessions(request?: SessionListRequest): Promise<SessionPage>;
+    listMessages(request: MessageListRequest): Promise<MessagePage>;
+    listAllSessions(options?: SessionListRequest & {
+        readonly maxPages?: number;
+    }): Promise<ReadonlyArray<OpenCodeSession>>;
+    listAllMessages(options: MessageListRequest & {
+        readonly maxPages?: number;
+    }): Promise<ReadonlyArray<OpenCodeAssistantMessage>>;
+    listProjects(options?: TransportRequestOptions): Promise<ReadonlyArray<OpenCodeProject>>;
+}
+export declare function createOpenCodeTransport(options: OpenCodeTransportOptions): OpenCode2Transport;
+export {};