@struktoai/mirage-core/dist/commands/cli/specs.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 { AIRTABLE } from "./builtin/airtable/index.js";
import { DISCORD } from "./builtin/discord/index.js";
import { GH } from "./builtin/gh/index.js";
import { GIT } from "./builtin/git/index.js";
import { GWS } from "./builtin/gws/index.js";
import { LINEAR } from "./builtin/linear/index.js";
import { NTN } from "./builtin/ntn/index.js";
import { SEARCH } from "./builtin/search/index.js";
import { SLACK } from "./builtin/slack/index.js";
import { TRELLO } from "./builtin/trello/index.js";
import { compareCodePoints } from "../../utils/sort.js";
import { NAME as MCP_CLI } from "./mcp/constants.js";
// Named CLI trees the YAML `clis:` section resolves against
// (`cli: slack` looks up "slack" here). The bundled programs are seeded
// here rather than self-registering from their own modules: a side
// effect only fires if something imported that module, so which CLIs
// existed depended on what the caller happened to pull in. Runtime
// packages add theirs through registerCliSpec from their entry point,
// and user programs do the same before the workspace loads.
const CLI_SPECS = new Map([AIRTABLE, DISCORD, GH, GIT, GWS, LINEAR, NTN, SEARCH, SLACK, TRELLO].map((spec) => [
    spec.spec.name,
    spec,
]));
/** Make a CLI resolvable by name from YAML; its root name is the key. */
export function registerCliSpec(spec) {
    if (spec.spec.name === MCP_CLI) {
        throw new Error(`CLI spec '${MCP_CLI}' is reserved for MCP servers; build one with mcpCli`);
    }
    if (CLI_SPECS.has(spec.spec.name)) {
        throw new Error(`CLI spec '${spec.spec.name}' is already registered`);
    }
    CLI_SPECS.set(spec.spec.name, spec);
}
/** Remove a named CLI from the YAML lookup. */
export function unregisterCliSpec(name) {
    if (!CLI_SPECS.has(name)) {
        throw new Error(`CLI spec '${name}' is not registered`);
    }
    CLI_SPECS.delete(name);
}
/** Resolve a YAML `cli:` key to its registered tree, fail loud. */
export function cliSpecFor(name) {
    if (name === MCP_CLI) {
        throw new Error(`cli '${MCP_CLI}' is built from its server: await mcpCli(config)`);
    }
    const spec = CLI_SPECS.get(name);
    if (spec === undefined) {
        const known = [...CLI_SPECS.keys()].sort(compareCodePoints).join(', ') || 'none registered';
        throw new Error(`unknown cli '${name}' (known: ${known})`);
    }
    return spec;
}
//# sourceMappingURL=specs.js.map