agent-sin 0.1.0

package/dist/core/config.d.ts

@@ -0,0 +1,127 @@
+import { type Locale } from "./i18n.js";
+export declare function agentSinInstallRoot(): string;
+export interface AppConfig {
+    version: number;
+    workspace: string;
+    notes_dir: string;
+    skills_dir: string;
+    memory_dir: string;
+    index_dir: string;
+    logs_dir: string;
+    log_retention_days: number;
+    event_log_retention_days: number;
+    defaults: {
+        note_format: string;
+        locale?: Locale;
+    };
+    chat_model_id: string;
+    builder_model_id: string;
+}
+export type ModelType = "api" | "ollama" | "cli";
+export interface ModelEntry {
+    type: ModelType;
+    model?: string;
+    provider?: string;
+    effort?: string;
+    enabled: boolean;
+}
+export interface ModelConfig {
+    roles?: {
+        chat?: string;
+        builder?: string;
+    };
+    models: Record<string, ModelEntry>;
+}
+export interface SetupWorkspaceOptions {
+    workspace?: string;
+    notesDir?: string;
+    skillsDir?: string;
+    memoryDir?: string;
+    indexDir?: string;
+    logsDir?: string;
+    chatModel?: string;
+    builder?: string;
+    enableModels?: string[];
+    forceReconfigure?: boolean;
+    initialModels?: {
+        chat: SetupModelChoice;
+        builder: SetupModelChoice;
+    };
+}
+export interface SetupModelChoice {
+    provider: string;
+    model?: string;
+    effort?: string;
+}
+export interface ProviderCatalogEntry {
+    id: string;
+    label: string;
+    type: ModelType;
+    binary?: string;
+    envKeys?: string[];
+    defaultModel?: string;
+    needsEffort?: boolean;
+    defaultChatEffort?: string;
+    defaultBuilderEffort?: string;
+}
+export declare const PROVIDER_CATALOG: ProviderCatalogEntry[];
+export declare class SetupRequiredError extends Error {
+    readonly configPath: string;
+    constructor(configPath: string);
+}
+export declare function defaultWorkspace(): string;
+export declare function configPath(workspace?: string): string;
+export declare function legacyConfigPath(workspace?: string): string;
+export declare function modelsPath(workspace?: string): string;
+export declare function schedulesPath(workspace?: string): string;
+export declare function legacySchedulesPath(workspace?: string): string;
+export declare function defaultConfig(workspace?: string): AppConfig;
+export declare function defaultModels(): ModelConfig;
+export declare const MODELS_YAML_TEMPLATE = "# agent-sin model registry\n#\n# `roles` maps logical roles (chat / builder) to concrete model entries.\n# `models` contains only concrete model definitions.\n#\n# Types:\n#   api    ... HTTP API (write API keys in ~/.agent-sin/.env)\n#   ollama ... local Ollama (defaults to localhost:11434 unless OLLAMA_HOST is set)\n#   cli    ... separately authenticated external CLI (codex / claude-code)\n#\n# Provider examples are commented out.\n# Uncomment only the providers you want to use and set `enabled: true`.\n\nroles:\n  chat: codex-low\n  builder: codex-xhigh\n\nmodels:\n  codex-low:\n    type: cli\n    provider: codex\n    model: gpt-5.5\n    effort: low\n    enabled: true\n\n  codex-xhigh:\n    type: cli\n    provider: codex\n    model: gpt-5.5\n    effort: xhigh\n    enabled: true\n\n  # --- Examples. Uncomment only the providers you use. ---\n\n  # OpenAI API (set OPENAI_API_KEY in .env)\n  # openai:\n  #   type: api\n  #   provider: openai\n  #   model: gpt-5.5\n  #   enabled: true\n\n  # Google Gemini API (set GEMINI_API_KEY in .env)\n  # gemini:\n  #   type: api\n  #   provider: gemini\n  #   model: gemini-2.5-flash\n  #   enabled: true\n\n  # Anthropic Claude API (set ANTHROPIC_API_KEY in .env)\n  # anthropic:\n  #   type: api\n  #   provider: anthropic\n  #   model: claude-opus-4-7\n  #   enabled: true\n\n  # Ollama (local LLM; run `ollama pull <model>` first)\n  # ollama-gemma:\n  #   type: ollama\n  #   model: gemma4:26b\n  #   enabled: true\n\n  # Claude Code CLI (already logged in with `claude`)\n  # claude-code:\n  #   type: cli\n  #   provider: claude-code\n  #   model: opus\n  #   effort: xhigh\n  #   enabled: true\n\n";
+export interface DetectedProvider {
+    id: string;
+    label: string;
+    hint: string;
+}
+export declare function detectAvailableProviders(workspaceForEnv?: string): Promise<DetectedProvider[]>;
+export declare function renderModelsYamlFromChoices(chat: SetupModelChoice, builder: SetupModelChoice): string;
+export declare function deriveSetupChoiceId(choice: SetupModelChoice, role: "chat" | "builder"): string;
+export declare function deriveSetupChoicePairIds(chat: SetupModelChoice, builder: SetupModelChoice): {
+    chat: string;
+    builder: string;
+};
+export declare function setupWorkspace(options?: SetupWorkspaceOptions): Promise<AppConfig>;
+export declare function ensureDailyMemoIndexSchedule(config: AppConfig): Promise<void>;
+export declare function ensureWorkspaceDirs(config: AppConfig): Promise<void>;
+export declare function loadConfig(): Promise<AppConfig>;
+export declare function loadModels(workspace?: string): Promise<ModelConfig>;
+export declare function normalizeModelConfig(input: ModelConfig): ModelConfig;
+export type ModelRole = "chat" | "builder";
+export declare function resolveRoleId(config: AppConfig, models: ModelConfig | null, role: ModelRole): string;
+export declare function setRoleModel(role: ModelRole, modelId: string): Promise<AppConfig>;
+export declare function setDefaultModel(modelId: string): Promise<AppConfig>;
+export declare function writeYaml(file: string, value: unknown): Promise<void>;
+export declare function writeModelsYaml(file: string, models: ModelConfig): Promise<void>;
+export interface ModelsYamlMigrationResult {
+    changed: boolean;
+    renamed: Record<string, string>;
+    notes: string[];
+}
+export interface MigrationOptions {
+    preferredRoles?: {
+        chat?: string;
+        builder?: string;
+    };
+}
+export declare function migrateModelsYamlIfLegacy(workspace?: string, options?: MigrationOptions): Promise<ModelsYamlMigrationResult>;
+export declare function writeConfig(file: string, config: AppConfig): Promise<void>;
+export declare function expandHome(value: string): string;
+export declare function normalizeConfig(config: AppConfig): AppConfig;
+export interface ParsedTomlConfig {
+    config: AppConfig;
+    legacy_role_ids?: {
+        chat?: string;
+        builder?: string;
+    };
+}
+export declare function parseTomlConfigWithLegacy(raw: string): ParsedTomlConfig;