@struktoai/mirage-core/dist/accessor/github.js

A Unified Virtual Filesystem For AI Agents

// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
import { HttpGitHubTransport } from "../core/github/client.js";
import { API_BASE } from "../core/github/constants.js";
import { Accessor } from "./base.js";
/**
 * One GitHub account: token, API base and the transport its calls ride. A gh
 * install's accessor, and the account a github mount holds.
 */
export class GitHubAccount extends Accessor {
    config;
    transport;
    constructor(config, transport) {
        super();
        this.config = config;
        this.transport = transport ?? new HttpGitHubTransport(config);
    }
    /** The REST base its calls go to: github.com's when none is set. */
    get apiBase() {
        return (this.config.baseUrl ?? API_BASE).replace(/\/+$/, '');
    }
    /**
     * The account behind a peer (a gh install's, or a github mount's) on this
     * API base; null for any other.
     */
    peer(peer) {
        const account = peer instanceof GitHubAccessor ? peer.account : peer;
        return account instanceof GitHubAccount && account.apiBase === this.apiBase ? account : null;
    }
    /**
     * Ride the transport (and its write limiter) of a peer account, a gh
     * install's or a github mount's, on the same token and API base.
     */
    join(peers) {
        for (const peer of peers) {
            const account = this.peer(peer);
            if (account !== null && account !== this && account.config.token === this.config.token) {
                this.transport = account.transport;
                return;
            }
        }
    }
    /**
     * Whether a write through this account may change what `peer` reads: only a
     * GitHub account or repository on the same API base, whatever token it reads
     * with, since two tokens can reach one repository. Mirrors Python's
     * `GitHubAccount.reaches`.
     */
    reaches(peer) {
        return this.peer(peer) !== null;
    }
}
/** A github mount's repository, reached through the account it holds. */
export class GitHubAccessor extends Accessor {
    account;
    owner;
    repo;
    ref;
    defaultBranch;
    // The recursive git tree, which is this mount's whole listing. grep's
    // scope counter and code search read it straight. Reseated by every
    // listing, so it is as fresh as the last one.
    truncated;
    tree;
    // Bumped by forget, so a tree GitHub answered before the drop is handed
    // back to its caller but not reseated.
    generation = 0;
    constructor(opts) {
        super();
        this.account = opts.account;
        this.owner = opts.owner;
        this.repo = opts.repo;
        this.ref = opts.ref;
        this.defaultBranch = opts.defaultBranch;
        this.truncated = opts.truncated ?? false;
        this.tree = opts.tree ?? {};
    }
    get isDefaultBranch() {
        return this.ref === this.defaultBranch;
    }
    /** Drop the tree with the mount's caches, so the next listing fetches it again. */
    forget() {
        super.forget?.();
        this.generation += 1;
        this.tree = {};
        this.truncated = false;
    }
}
//# sourceMappingURL=github.js.map