human-to-code 0.0.1 → 0.1.2

package/dist/config.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Strict, versioned configuration.
+ *
+ * Configuration is JSON and is never interpreted by a model. Unknown fields
+ * are rejected so misspellings and future/legacy semantics cannot silently
+ * weaken a run. Credentials are deliberately not part of the schema: provider
+ * adapters must read them from their provider-specific environment variables.
+ */
+import type { Config, ProviderConfig, ProviderName } from "./types.ts";
+export declare const CONFIG_FILENAME = "human-to-code.config.json";
+export declare const CONFIG_SCHEMA_VERSION: 1;
+export type DocumentationMode = "local-first" | "offline";
+export type SandboxEngine = "auto" | "docker" | "podman";
+export interface ProviderConfigV1 extends ProviderConfig {
+    /** Required acknowledgement whenever a non-default endpoint is configured. */
+    trustCustomEndpoint?: true;
+    /** Name of an environment variable; never the credential value itself. */
+    apiKeyEnv?: string;
+    /**
+     * Conservative model-specific API rates used to reserve a worst-case cost
+     * before every remote request. Remote adapters refuse to run without them.
+     */
+    pricing?: ProviderPricingV1;
+}
+export interface ProviderPricingV1 {
+    inputUsdPerMillionTokens: number;
+    outputUsdPerMillionTokens: number;
+    /** Required when both rates are intentionally zero. */
+    unmetered?: true;
+}
+export interface DocumentationConfigV1 {
+    mode: DocumentationMode;
+    /** Repository-relative paths containing project/private documentation. */
+    privatePaths: string[];
+    /** Extra official domains approved by the operator, without schemes/paths. */
+    officialDomains: string[];
+    /** Exact dependency/version URL mappings used only after local evidence. */
+    officialSources: OfficialDocumentationSourceV1[];
+}
+export interface OfficialDocumentationSourceV1 {
+    ecosystem: "react" | "nestjs" | "fastapi" | "rust";
+    dependency: string;
+    version: string;
+    url: string;
+}
+export interface PrivacyConfigV1 {
+    /** Remote providers remain disabled until project-level consent is explicit. */
+    remoteProviderConsent: boolean;
+    /** Telemetry is opt-in and is also disabled by DO_NOT_TRACK. */
+    telemetry: boolean;
+    /** Repository-relative paths that must not enter a context manifest. */
+    excludedPaths: string[];
+    maxFileBytes: number;
+    maxContextTokens: number;
+}
+export interface SandboxConfigV1 {
+    required: boolean;
+    engine: SandboxEngine;
+    /** v1 never permits validation commands to access the network. */
+    network: "none";
+}
+export interface BudgetConfigV1 {
+    maxCostUsd: number;
+    maxInputTokens: number;
+    maxOutputTokens: number;
+    maxRequests: number;
+    maxRepairs: number;
+    timeoutMs: number;
+}
+export interface WorkspaceOverrideV1 {
+    root: string;
+    provider?: ProviderConfigV1;
+    documentation?: Partial<DocumentationConfigV1>;
+    privacy?: Partial<PrivacyConfigV1>;
+    budgets?: Partial<BudgetConfigV1>;
+}
+/**
+ * ConfigV1 extends the alpha fields to avoid breaking programmatic callers
+ * while adding the production safety policy. Project analysis, rather than
+ * `language`, is authoritative for mixed-language workspaces.
+ */
+export interface ConfigV1 extends Omit<Config, "provider"> {
+    schemaVersion: typeof CONFIG_SCHEMA_VERSION;
+    provider: ProviderConfigV1;
+    workspaces: WorkspaceOverrideV1[];
+    documentation: DocumentationConfigV1;
+    privacy: PrivacyConfigV1;
+    sandbox: SandboxConfigV1;
+    budgets: BudgetConfigV1;
+}
+type DeepReadonly<T> = T extends (...args: never[]) => unknown ? T : T extends readonly (infer U)[] ? readonly DeepReadonly<U>[] : T extends object ? {
+    readonly [K in keyof T]: DeepReadonly<T[K]>;
+} : T;
+/** Frozen defaults. Callers receive a deep clone, never this object. */
+export declare const DEFAULT_CONFIG: DeepReadonly<ConfigV1>;
+/** Thrown for malformed or unsafe config; messages are safe to show users. */
+export declare class ConfigError extends Error {
+    readonly name = "ConfigError";
+}
+/** The configured default model id for a provider in this package release. */
+export declare function defaultModelFor(name: ProviderName): string;
+/** Validate a custom endpoint without performing any network access. */
+export declare function validateProviderBaseUrl(raw: string, provider: ProviderName, trusted: boolean): string;
+/** Validate an already-parsed schema-v1 object into a fully defaulted config. */
+export declare function validateConfig(raw: unknown): ConfigV1;
+/**
+ * Explicitly migrate the dependency-free 0.0.1 shape. It intentionally accepts
+ * only the four known legacy keys and then validates the resulting v1 object.
+ */
+export declare function migrateLegacyConfig(raw: unknown): ConfigV1;
+/**
+ * Load `<root>/human-to-code.config.json`. A missing file returns cloned
+ * defaults; unreadable, non-regular, symlinked, oversized, or legacy files fail.
+ */
+export declare function loadConfig(root: string): Promise<{
+    config: ConfigV1;
+    fromFile: boolean;
+}>;
+/** Serialize a fresh schema-v1 default config for initialization. */
+export declare function defaultConfigJson(): string;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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