codex-subagent-kit 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,218 @@
+export { buildProgram, main } from './cli.js';
+import 'commander';
+
+interface Category {
+    key: string;
+    title: string;
+    description: string;
+}
+interface AgentSpec {
+    key: string;
+    category: string;
+    name: string;
+    description: string;
+    model: string;
+    reasoningEffort: string;
+    sandboxMode: string;
+    developerInstructions: string;
+    source: string;
+    definitionPath?: string;
+}
+interface CatalogOptions {
+    projectRoot?: string;
+    homeDir?: string;
+    includeProject?: boolean;
+    includeGlobal?: boolean;
+    catalogRoots?: readonly string[];
+}
+interface InstallResult {
+    agentPaths: string[];
+    agentPreservedPaths: string[];
+}
+interface DoctorIssue {
+    path?: string;
+    message: string;
+}
+interface CatalogImportResult {
+    targetRoot: string;
+    importedCategoryKeys: string[];
+    importedAgentKeys: string[];
+    createdPaths: string[];
+    preservedPaths: string[];
+}
+interface DoctorReport {
+    scope: string;
+    targetDir: string;
+    catalogCounts: Array<[string, number]>;
+    installedCounts: Array<[string, number]>;
+    issues: DoctorIssue[];
+}
+
+declare const IMPORTED_AGENTS_CATEGORY: Category;
+declare function getAgentMap(options?: CatalogOptions): Map<string, AgentSpec>;
+declare function getCategories(options?: CatalogOptions): Category[];
+declare function getAgents(options?: CatalogOptions): AgentSpec[];
+declare function getAgentsByCategory(categoryKeys: Set<string> | undefined, options?: CatalogOptions): AgentSpec[];
+declare function renderCatalogOutput(options?: CatalogOptions): string;
+
+declare class CatalogImportError extends Error {
+}
+declare function importCatalog(options: {
+    projectRoot: string;
+    scope: "project" | "global";
+    homeDir?: string;
+    catalogRoots: readonly string[];
+    agentKeys: string[];
+    categoryKeys: string[];
+    overwrite?: boolean;
+}): CatalogImportResult;
+
+declare class CatalogSyncError extends Error {
+}
+interface CatalogSyncResult {
+    sourceName: string;
+    targetRoot: string;
+    sourceLabel: string;
+    copiedPaths: string[];
+}
+declare function syncCatalog(options: {
+    projectRoot: string;
+    scope: "project" | "global";
+    homeDir?: string;
+    sourceName?: string;
+    sourceRoot?: string;
+}): Promise<CatalogSyncResult>;
+
+declare function runDoctor(options: {
+    projectRoot: string;
+    scope: "project" | "global";
+    homeDir?: string;
+    catalogRoots?: readonly string[];
+}): DoctorReport;
+declare function renderDoctorReport(report: DoctorReport): string;
+
+declare class GenerationError extends Error {
+}
+declare const ORCHESTRATOR_CATEGORY = "meta-orchestration";
+declare const DEFAULT_ORCHESTRATOR_KEY = "multi-agent-coordinator";
+interface InstallAgentsOptions {
+    scope: "project" | "global";
+    projectRoot: string;
+    agentKeys: string[];
+    homeDir?: string;
+    catalogRoots?: readonly string[];
+    overwrite?: boolean;
+}
+interface RenderableAgentFile {
+    name: string;
+    description: string;
+    model: string;
+    reasoningEffort: string;
+    sandboxMode: string;
+    developerInstructions: string;
+    categoryOverride?: string;
+}
+declare function renderAgentFile(agent: RenderableAgentFile): string;
+declare function resolveTargetDir(scope: "project" | "global", projectRoot: string, homeDir?: string): string;
+declare function installAgents(options: InstallAgentsOptions): InstallResult;
+
+declare const STABLE_COMMANDS: readonly ["catalog", "catalog import", "catalog sync", "install", "doctor", "usage", "template init", "tui"];
+
+type SemverBump = "major" | "minor" | "patch";
+declare function parseSemver(value: string): [number, number, number];
+declare function bumpSemver(version: string, bump: SemverBump): string;
+declare function classifyBump(commitMessages: Iterable<string>): SemverBump;
+declare function computeNextVersion(baseVersion: string, commitMessages: Iterable<string>): string;
+
+declare const DEFAULT_MODEL = "gpt-5.4";
+declare const DEFAULT_REASONING_EFFORT = "medium";
+declare const DEFAULT_SANDBOX_MODE = "read-only";
+declare class TemplateError extends Error {
+}
+interface InitTemplateOptions {
+    projectRoot: string;
+    scope: "project" | "global";
+    categoryKey: string;
+    agentKey: string;
+    catalogRoot?: string;
+    categoryPrefix?: string;
+    categoryTitle?: string;
+    categoryDescription?: string;
+    agentName?: string;
+    agentDescription?: string;
+    model?: string;
+    reasoningEffort?: string;
+    sandboxMode?: string;
+    orchestrator?: boolean;
+    overwrite?: boolean;
+}
+interface TemplateInitResult {
+    targetRoot: string;
+    categoryDir: string;
+    readmePath: string;
+    agentPath: string;
+    createdPaths: string[];
+    preservedPaths: string[];
+}
+declare function renderCategoryReadme(options: {
+    categoryTitle: string;
+    categoryDescription: string;
+    categoryPrefix: string;
+}): string;
+declare function renderAgentTemplate(options: {
+    agentKey: string;
+    agentName: string;
+    agentDescription: string;
+    model: string;
+    reasoningEffort: string;
+    sandboxMode: string;
+    categoryOverride?: string;
+}): string;
+declare function initTemplate(options: InitTemplateOptions): TemplateInitResult;
+
+interface PromptChoice<T> {
+    value: T;
+    name: string;
+    checked?: boolean;
+}
+interface PromptAdapter {
+    select<T>(config: {
+        message: string;
+        choices: Array<PromptChoice<T>>;
+    }): Promise<T>;
+    checkbox<T>(config: {
+        message: string;
+        choices: Array<PromptChoice<T>>;
+    }): Promise<T[]>;
+    confirm(config: {
+        message: string;
+        default?: boolean;
+    }): Promise<boolean>;
+}
+interface TuiDeps {
+    installAgentsImpl(options: InstallAgentsOptions): InstallResult;
+    runDoctorImpl(options: {
+        projectRoot: string;
+        scope: "project" | "global";
+        catalogRoots?: readonly string[];
+    }): DoctorReport;
+}
+declare function defaultAgentSelection(scope: "project" | "global", agentSpecs: AgentSpec[]): Set<string>;
+declare function validateAgentSelection(scope: "project" | "global", agentSpecs: AgentSpec[], selectedAgents: Set<string>): string | undefined;
+declare function runTui(projectRoot: string, options?: {
+    catalogRoots?: readonly string[];
+    promptAdapter?: PromptAdapter;
+    deps?: Partial<TuiDeps>;
+}): Promise<number>;
+
+declare class UsageError extends Error {
+}
+interface RenderUsageGuideOptions {
+    projectRoot: string;
+    scope: "project" | "global";
+    task?: string;
+    homeDir?: string;
+}
+declare function renderUsageGuide(options: RenderUsageGuideOptions): string;
+
+export { type AgentSpec, CatalogImportError, type CatalogOptions, CatalogSyncError, type CatalogSyncResult, type Category, DEFAULT_MODEL, DEFAULT_ORCHESTRATOR_KEY, DEFAULT_REASONING_EFFORT, DEFAULT_SANDBOX_MODE, type DoctorIssue, type DoctorReport, GenerationError, IMPORTED_AGENTS_CATEGORY, type InstallResult, ORCHESTRATOR_CATEGORY, type PromptAdapter, type PromptChoice, STABLE_COMMANDS, type SemverBump, TemplateError, UsageError, bumpSemver, classifyBump, computeNextVersion, defaultAgentSelection, getAgentMap, getAgents, getAgentsByCategory, getCategories, importCatalog, initTemplate, installAgents, parseSemver, renderAgentFile, renderAgentTemplate, renderCatalogOutput, renderCategoryReadme, renderDoctorReport, renderUsageGuide, resolveTargetDir, runDoctor, runTui, syncCatalog, validateAgentSelection };