@myagentroam/node 0.1.0

package/dist/runner-usage.js

@@ -0,0 +1,193 @@
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const CODEX_USAGE_URL = 'https://chatgpt.com/backend-api/wham/usage';
+const CLAUDE_USAGE_URL = 'https://api.anthropic.com/api/oauth/usage';
+const CREDENTIALS_MAX_BYTES = 256 * 1024;
+const RESPONSE_MAX_BYTES = 256 * 1024;
+const CODEX_CACHE_MS = 60_000;
+const CLAUDE_CACHE_MS = 5 * 60_000;
+export const USAGE_OAUTH_REQUIRED = 'OFFICIAL_OAUTH_REQUIRED';
+export class RunnerUsageReader {
+    fetcher;
+    homePath;
+    now;
+    cache = new Map();
+    constructor(fetcher = fetch, homePath = homedir(), now = Date.now) {
+        this.fetcher = fetcher;
+        this.homePath = homePath;
+        this.now = now;
+    }
+    async status(runner, runnerAvailable) {
+        if (!runnerAvailable)
+            return unavailable(runner, 'RUNNER_UNAVAILABLE');
+        return (await this.credentials(runner)) === undefined
+            ? unavailable(runner, USAGE_OAUTH_REQUIRED)
+            : { runner, available: true, reasonCode: null };
+    }
+    async read(runner, runnerAvailable) {
+        const status = await this.status(runner, runnerAvailable);
+        if (!status.available)
+            throw new Error(status.reasonCode ?? 'USAGE_UNAVAILABLE');
+        const cached = this.cache.get(runner);
+        const now = this.now();
+        if (cached !== undefined && now - cached.fetchedAt < cacheDuration(runner)) {
+            return { ...cached, cached: true };
+        }
+        const credentials = await this.credentials(runner);
+        if (credentials === undefined)
+            throw new Error(USAGE_OAUTH_REQUIRED);
+        const usage = runner === 'codex'
+            ? await this.readCodex(credentials, now)
+            : await this.readClaude(credentials, now);
+        this.cache.set(runner, usage);
+        return usage;
+    }
+    async credentials(runner) {
+        const path = runner === 'codex'
+            ? join(this.homePath, '.codex', 'auth.json')
+            : join(this.homePath, '.claude', '.credentials.json');
+        const value = await readJson(path);
+        return runner === 'codex' ? codexCredentials(value) : claudeCredentials(value);
+    }
+    async readCodex(credentials, fetchedAt) {
+        const headers = {
+            Authorization: `Bearer ${credentials.accessToken}`
+        };
+        if (credentials.accountId !== undefined)
+            headers['ChatGPT-Account-Id'] = credentials.accountId;
+        const value = await requestJson(this.fetcher, CODEX_USAGE_URL, headers);
+        const windows = [
+            codexUsageWindow(value, 'primary_window'),
+            codexUsageWindow(value, 'secondary_window')
+        ].filter((window) => window !== undefined);
+        if (windows.length === 0)
+            throw new Error('USAGE_RESPONSE_INVALID');
+        return { runner: 'codex', windows, fetchedAt, cached: false };
+    }
+    async readClaude(credentials, fetchedAt) {
+        const value = await requestJson(this.fetcher, CLAUDE_USAGE_URL, {
+            Authorization: `Bearer ${credentials.accessToken}`,
+            'anthropic-beta': 'oauth-2025-04-20',
+            'Content-Type': 'application/json'
+        });
+        const windows = [
+            usageWindow(value, 'five_hour', '5 小时额度'),
+            usageWindow(value, 'seven_day', '7 天额度'),
+            usageWindow(value, 'seven_day_sonnet', '7 天 Sonnet 额度')
+        ].filter((window) => window !== undefined);
+        if (windows.length === 0)
+            throw new Error('USAGE_RESPONSE_INVALID');
+        return { runner: 'claude-code', windows, fetchedAt, cached: false };
+    }
+}
+function unavailable(runner, reasonCode) {
+    return { runner, available: false, reasonCode };
+}
+function cacheDuration(runner) {
+    return runner === 'codex' ? CODEX_CACHE_MS : CLAUDE_CACHE_MS;
+}
+async function readJson(path) {
+    try {
+        const text = await readFile(path, 'utf8');
+        if (text.length > CREDENTIALS_MAX_BYTES)
+            return undefined;
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+function codexCredentials(value) {
+    const root = record(value);
+    const tokens = record(root?.tokens) ?? root;
+    const accessToken = string(tokens?.access_token) ?? string(tokens?.accessToken);
+    if (accessToken === undefined)
+        return undefined;
+    const accountId = string(tokens?.account_id) ?? string(tokens?.accountId) ?? string(root?.account_id);
+    return { accessToken, ...(accountId === undefined ? {} : { accountId }) };
+}
+function claudeCredentials(value) {
+    const credentials = record(record(value)?.claudeAiOauth);
+    const accessToken = string(credentials?.accessToken);
+    return accessToken === undefined ? undefined : { accessToken };
+}
+async function requestJson(fetcher, url, headers) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 5_000);
+    try {
+        const response = await fetcher(url, {
+            method: 'GET',
+            headers,
+            redirect: 'error',
+            signal: controller.signal
+        });
+        if (response.status === 401 || response.status === 403)
+            throw new Error('USAGE_AUTHENTICATION_FAILED');
+        if (response.status === 429)
+            throw new Error('USAGE_RATE_LIMITED');
+        if (!response.ok)
+            throw new Error('USAGE_REQUEST_FAILED');
+        const text = await response.text();
+        if (text.length > RESPONSE_MAX_BYTES)
+            throw new Error('USAGE_RESPONSE_INVALID');
+        return JSON.parse(text);
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError')
+            throw new Error('USAGE_REQUEST_TIMEOUT');
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function usageWindow(value, key, label) {
+    const window = record(record(value)?.rate_limit)?.[key] ?? record(value)?.[key];
+    const source = record(window);
+    const usedPercentage = number(source?.utilization) ?? number(source?.used_percentage) ?? number(source?.used_percent);
+    if (usedPercentage === undefined || usedPercentage < 0 || usedPercentage > 100)
+        return undefined;
+    const resetsAt = timestamp(source?.resets_at) ?? timestamp(source?.reset_at);
+    return { id: key, label, usedPercentage, resetsAt };
+}
+/**
+ * Codex backend window names are roles, not durations: depending on a plan,
+ * `primary_window` may itself be the weekly quota. Community clients classify
+ * them using the response's `limit_window_seconds`, never their position.
+ */
+function codexUsageWindow(value, key) {
+    const window = record(record(value)?.rate_limit)?.[key];
+    const duration = number(record(window)?.limit_window_seconds);
+    const label = duration !== undefined && approximately(duration, 5 * 60 * 60)
+        ? '5 小时额度'
+        : duration !== undefined && approximately(duration, 7 * 24 * 60 * 60)
+            ? '7 天额度'
+            : undefined;
+    return label === undefined ? undefined : usageWindow(value, key, label);
+}
+function approximately(value, expected) {
+    return Math.abs(value - expected) / expected <= 0.1;
+}
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function string(value) {
+    return typeof value === 'string' && value.length > 0 && value.length <= 20_000
+        ? value
+        : undefined;
+}
+function number(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function timestamp(value) {
+    if (typeof value === 'number' && Number.isFinite(value) && value >= 0)
+        return Math.floor(value < 10_000_000_000 ? value * 1_000 : value);
+    if (typeof value !== 'string')
+        return null;
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : null;
+}
+//# sourceMappingURL=runner-usage.js.map

package/dist/runner-usage.js.map

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

package/dist/runtime-state.d.ts

@@ -0,0 +1,174 @@
+import type { AgentRunStatus, RunnerName } from '@myagentroam/protocol';
+import type { ConversationItemPage, ConversationPage, NativeSessionControl, NodeAgentRun, NodeAgentSession, NodeApproval, NodeConversationTurn, NodeMessageAttachmentInput, NodeRunEvent, NodeWorkspace, WorkspaceActivityPage } from './database.js';
+/**
+ * Deliberately process-local runtime domain.  No method in this class writes
+ * into Node SQLite: a Node restart loses active runs, approvals, leases and
+ * managed-session aliases by design.  Durable conversation history belongs to
+ * the Runner/native transcript, never to MAR.
+ */
+export declare class NodeRuntimeState {
+    private readonly nodeId;
+    private readonly getWorkspace;
+    private readonly now;
+    private readonly sessions;
+    private readonly runs;
+    private readonly messageRuns;
+    private readonly events;
+    private readonly turns;
+    private readonly approvals;
+    private readonly workspaceEvents;
+    /** A Session owns at most one running turn; Workspace sessions may run concurrently. */
+    private readonly leases;
+    /** Session FIFO metadata is deliberately process-local with the rest of run state. */
+    private readonly queuedRuns;
+    private readonly queueVersions;
+    private readonly pausedQueues;
+    private readonly snapshots;
+    private nextEventId;
+    private nextWorkspaceEventId;
+    constructor(nodeId: () => string, getWorkspace: (id: string) => NodeWorkspace | undefined, now?: () => number);
+    activeWorkspaceLeaseCount(): number;
+    activeSessionRun(sessionId: string): NodeAgentRun | undefined;
+    hasActiveSessionLease(sessionId: string): boolean;
+    createAgentSession(input: {
+        readonly workspaceId: string;
+        readonly runner: RunnerName;
+        readonly externalSessionId?: string;
+        readonly nativeControl?: NativeSessionControl;
+        readonly cwd: string;
+        readonly title?: string;
+        readonly model?: string;
+        readonly effort?: string;
+        readonly access?: string;
+    }): NodeAgentSession;
+    /** Internal envelope compatibility for a Run already accepted in this process. */
+    adoptRun(input: {
+        readonly runId: string;
+        readonly sessionId: string;
+        readonly workspaceId?: string;
+        readonly runner: RunnerName;
+        readonly cwd: string;
+        readonly clientMessageId?: string;
+        readonly externalSessionId?: string;
+    }): NodeAgentRun;
+    getAgentSession(id: string): NodeAgentSession | undefined;
+    listAgentSessions(): readonly NodeAgentSession[];
+    findAgentSessionByExternalSession(runner: RunnerName, externalSessionId: string): NodeAgentSession | undefined;
+    updateAgentSessionConfiguration(input: {
+        readonly sessionId: string;
+        readonly model: string;
+        readonly effort: string;
+        readonly access: string;
+    }): NodeAgentSession;
+    setNativeControl(id: string, nativeControl: NativeSessionControl): void;
+    setExternalSessionId(id: string, externalSessionId: string): void;
+    /**
+     * Atomically replaces the bootstrap Session key with the Runner-native ID.
+     * No caller may migrate the individual runtime maps independently.
+     */
+    promoteSessionIdentity(id: string, nativeSessionId: string): NodeAgentSession;
+    setChannelToken(id: string, channelToken: string): void;
+    updateSessionMetadata(input: {
+        readonly sessionId: string;
+        readonly customTitle?: string | null;
+        readonly pinned?: boolean;
+    }): NodeAgentSession;
+    /**
+     * Give a just-created managed Session a readable local title before the
+     * Runner has written its own transcript title. This intentionally never
+     * replaces a user rename or a Runner-provided title.
+     */
+    setTemporaryTitleIfMissing(id: string, title: string): NodeAgentSession;
+    /**
+     * Runner/native discovery is authoritative for its own title. Keep it on
+     * the managed Session so later `session.get` polls cannot regress to an
+     * empty fallback after a discovery response has already shown the title.
+     */
+    setRunnerTitleFromNative(id: string, title: string): NodeAgentSession;
+    createMessageRun(input: {
+        readonly sessionId: string;
+        readonly clientMessageId: string;
+        readonly content: string;
+        readonly attachments?: readonly NodeMessageAttachmentInput[];
+    }): {
+        readonly run: NodeAgentRun;
+        readonly created: boolean;
+    };
+    sessionQueue(sessionId: string): {
+        readonly version: number;
+        readonly paused: boolean;
+        readonly runIds: readonly string[];
+    };
+    isQueuedRun(runId: string): boolean;
+    claimNextQueuedRun(sessionId: string): NodeAgentRun | undefined;
+    pauseSessionQueue(sessionId: string): void;
+    resumeSessionQueue(sessionId: string): void;
+    reorderSessionQueue(sessionId: string, expectedVersion: number, runIds: readonly string[]): void;
+    prioritizeQueuedRun(runId: string): NodeAgentRun;
+    updateQueuedMessage(runId: string, content: string): NodeAgentRun;
+    deleteQueuedRun(runId: string): void;
+    queuedMessageText(runId: string): string;
+    getRun(id: string): NodeAgentRun | undefined;
+    findMessageRun(sessionId: string, clientMessageId: string): NodeAgentRun | undefined;
+    listRunsForSession(sessionId: string): readonly NodeAgentRun[];
+    transitionRun(id: string, next: AgentRunStatus): NodeAgentRun;
+    appendRunEvent(input: {
+        readonly runId: string;
+        readonly sequence: number;
+        readonly eventType: string;
+        readonly payload: unknown;
+        readonly status?: AgentRunStatus;
+    }): NodeRunEvent | undefined;
+    listRunEvents(id: string, after?: number): readonly NodeRunEvent[];
+    listConversationTurns(input: {
+        readonly sessionId: string;
+        readonly cursor?: string;
+        readonly limit?: number;
+    }): ConversationPage;
+    conversationTurnForRun(runId: string): NodeConversationTurn | undefined;
+    listConversationItems(input: {
+        readonly sessionId: string;
+        readonly cursor?: string;
+        readonly limit?: number;
+    }): ConversationItemPage;
+    recordCommandExecution(input: {
+        readonly sessionId: string;
+        readonly command: string;
+        readonly cwd: string;
+        readonly outputPreview: string;
+        readonly failed?: boolean;
+    }): NodeConversationTurn;
+    listWorkspaceActivity(input: {
+        readonly workspaceId: string;
+        readonly cursor?: string;
+        readonly limit?: number;
+    }): WorkspaceActivityPage;
+    createApproval(input: {
+        readonly runId: string;
+        readonly approvalId: string;
+        readonly payload: unknown;
+        readonly expiresAt: number;
+    }): NodeApproval;
+    getApproval(id: string): NodeApproval | undefined;
+    listApprovals(runId: string): readonly NodeApproval[];
+    expireApproval(id: string): NodeApproval;
+    decideApproval(id: string, decision: 'APPROVED' | 'REJECTED'): NodeApproval;
+    expireDueApprovals(): readonly NodeApproval[];
+    listNonterminalRuns(): readonly NodeAgentRun[];
+    lastRunSequence(id: string): number;
+    saveSnapshot(id: string, value: unknown): void;
+    getSnapshot(id: string): unknown | undefined;
+    hasActiveWorkspaceLease(workspaceId: string): boolean;
+    /** Removes a terminal Session's process-local projection after its native history is deleted. */
+    removeAgentSession(sessionId: string): void;
+    removeWorkspace(workspaceId: string): void;
+    reconcileRun(id: string, active: boolean): void;
+    private replaceSession;
+    private bumpQueueVersion;
+    private requireSession;
+    private requireRun;
+    private requireApproval;
+    private recordWorkspaceActivity;
+    private updateTurnForRun;
+    private projectEvent;
+}